Tenmon help

Tenmon is intended primarily for viewing astro photos and images. It supports the following formats:

Main windows

The main window shows the currently loaded image. On the left is the Image info panel which displays details about the loaded image. The File system panel shows other images in the same directory as the loaded image. At the top is the main menu and below that is the Stretch panel containing various options for auto-stretching linear image data.

All panels in the interface can be moved around and/or closed. Any closed or non-visible panel can be re-opened through the Docks menu at the top.

At bottom there is status bar that show current lightness or red, green, blue pixel value under mouse cursor then X and Y coordinates and if image contain World Coordinate System metadata it show celestial coordinates.

Opening and saving images

To load an image select File->Open and choose the file. After a file is loaded, it becomes visible in the main image panel, and the File system panel will show the other images in the same directory.

The loaded image can be exported to a different format with File->Save as. Any of the formats JPEG, PNG FITS and XISF can be selected. In the case of saving JPEG or PNG, the stretch function is applied to the saved image. FITS and XISF are saved/converted without applying the stretch. To open an image, you can also drag and drop it to main window.

View

The View menu has options to control the size and scale of displayed images:

Stretch toolbar

This panel changes how images are displayed.

Starting on the left, there is slider scale with three adjustable points to manually control the stretch.

Following the slider are 5 buttons for automatic stretching:

Marking images

Images can be marked in the Select menu. To show a list of only the marked images, use Select->Show marked. This dialog can be useful to clear marks from images. Marked images show a * character in the title bar of the main window. Marked images can be copied or moved to a selected directory with File->Copy/Move marked files. After copying or moving, the list of marked files is cleared. The list of marked files will be remembered after quitting the program.

Another way to mark images is in database view where you can select rows and then select mark or unmark action in context menu. Marked files will be shown with bold text. Third way to mark files is from thumbnails view where you can press press Shift and click with left mouse button and drag across thumbnails to mark them. Holding Ctrl will unmark files.

File system and tree

File system panel contain list of images in current opened directory. You can select file from this list and it will be displayed. It is also possible to use arrow keys to go back (left and up) and forth (right and down) between images.

File tree show file system structure. You can right click to show context menu to perform various actions from File menu. There are also few others

Database of FITS/XISF files

Tenmon can scan a directory of FITS/XISF files and index metadata from FITS headers into it's internal database. This allows searching and sorting images based on that metadata.

To populate the database, select a directory of FITS/XISF files with File->Index directory. After the selected directory is searched, metadata parsed from the images will be stored in the database. To refresh the database, run File->Reindex. This will update any changed metadata and remove any record of deleted files. To index new files, simply run Index directory again.

The database is viewed through a panel which is not visible in the default layout. To add the database panel to the view, toggle Docks->FITS/XISF database. Once visible, database panel shows the database as a table with a column for each property. Below the table is button to select which columns/properties are displayed.

Also at the bottom of the database panel are three combo boxes and text inputs used for filtering. Select the property to filter on with the combo box and in the adjacent text box enter a string to search for in that property. These three combo box contain list of all properties that are found during indexing except first five. First one set searching in file name. Next two "RA pos" and "DEC pos" allow to filter out indexed images that contain point with entered RA/DEC coordinate. Expected format is three number separated by space. In case of "DEC pos" it also accept +- sign. Omitting one or two last number is also valid. Some examples "02 12 32" "-12 43 12" "+45 32" "13". So for RA it means hour, minutes and seconds while for DEC it is degrees, minutes and seconds. Setting both "RA pos" and "DEC pos" can return images that doesn't contain entered point as it search against minimum and maximum RA/DEC coordinates that images contain. "RA range" and "DEC range" filter out images which center coordinate is within entered range. Pressing Enter or clicking on Filter button will filter out database record according to search parameter.

Wildcards:



This example filters for files where: "Bias" is in the file name, the OBJECT property is "M_42" (where the underscore can be any single character), and the DATE property begins with "2022".

PS: Kanji in icon means astronomy in Japanese