Select Source Images


Source images are the "input" images used by a parent command, such as images being rotated by Rotate Images or calibrated using Express Image Calibration. This topic describes the options for source image selection provided through the Select Source Images dialog. This dialog does not actually collect the images but sets the properties used for subsequent image collection by the parent command. Each parent command has an independent set of image selection properties.

For collecting source images, Mira commands use a common interface, the Source Images Control Group shown below. This group accesses the Select Source Images dialog for configuring how the command will collect its source images. This group is shown below as it appears on a generic command dialog. Use the [Select] button to open the Select Source Images dialog for setting source image selection properties. Later, when the command is executed, images are collected and processed according to the properties configured in the Select Source Images dialog.

Here is the Source Images Control Group appearing in the command dialog:

The Select Source Images dialog includes 6 pages: the Select Method page for choosing the source image selection method, and 5 pages for configuring each of the selection methods. Commands remember their source image selection properties, and these properties are initialized the next time Select Source Images is used by the command.

NOTE

Selecting the source images from a window or one of the file options may also change properties appearing in the parent command dialog.

Specifying the Source Images

Specifying how source images are collected is a two-step process. Usually, it is not necessary to complete both steps each time for a given command as the parameters are saved specifically for the command (for example, source image properties for Image Arithmetic and Rotate Image are saved independently). The properties for a given command do not usually need changing unless the image selection is volatile by using different file names, a different folder, different image window, and so on.

The source selection properties are configured in a two-step process using the pages listed in the left panel of the Select Source Images dialog. The top page, named Select Method..., is used to choose the source, while the 5 pages underneath are used to configure the source. This two-step process is outlined below. The order they are completed is not important:

Each of the 6 pages in the Select Source Images dialog is described below.

Select Method... Page

The Select Method... page selects the method from the 5 options described below. The method is passed back to the calling command along with all the properties for the selected method. The bullet list selects the method to be used by the calling command. The properties to be used by the selected method are configured by selecting the method page from the list in the left-hand panel.

Underneath Select Method... are shown the various method pages. Click on the name to configure the properties of the selected method. The selected method shows a reminder with the word [Selected] appearing at the upper right. For example, the picture below shows the "Folder" method selected, and the description of the Folder Page, further below, shows [Selected] in its upper right corner.

Image Window Page

The Image Window page selects images displayed in an Image Window. The list box contains the name of the current image for each Image Window on the Mira desktop. The window list is created when this dialog is opened, and it will be empty if no Image Windows are open.

Current image in current window:

Use the button to select the target Image Window from among all open image windows. This field lists the name of the image displayed in the selected Image Window. If an Image Set is displayed, only the name of the currently displayed member of the image set is listed.

 Save Undo Copy

Check this box to instruct Mira to save an Undo copy of each image before it performs processing. Saving an undo copy increases the memory used by each image in the Image Window.

Folder Page

The Folder page selects images from files in a folder. Optionally, several file selection rules may be used to filter which images will be selected from the folder. If no rules are used, then all files in the folder will be selected. This page remembers its settings between sessions, however it is possible that the listed folder may not exist in a new session.

Select Files from a Folder using Criteria

Use the [...] button to open a browser for selecting the folder containing the images.

File Selection Rules

This group provides optional ways to filter files from among those in the selected folder.

 Use File Template

To use a file name template, check this box and specify the file name template in the list box to the right. The template may be as simple as a file extension or may be a more elaborate file name pattern using * and ? wildcard characters. Use the [+] and [x] buttons to add or delete the currently displayed entry.

 Use Keyword

For images in FITS format, check this box to select only image files that have the specified header keyword and Keyword Value. For example, using IMAGETYP as the keyword and Light as the keyword value selects only files containing FITS format images with the header entry IMAGETYP = 'Light'. Use the [+] and [x] buttons to add or delete the currently displayed entry.

Checking the Use Keyword box activates two fields, one for the keyword name and the other for the keyword value.

Keyword Value

Enter the value of the selection keyword. For example to select files that have an exposure time of 60 seconds, set the keyword as EXPTIME and the Keyword Value as 60. Use the [+] and [x] buttons to add or delete the currently displayed entry.

Drag from Explorer Page

The Drag from Explorer page provided a drop box where files can be dropped using the drag & drop protocol. Files are selected by marking them in Windows Explorer (the file manager), then dragged onto the box and dropped there by releasing the mouse button. The drop box is empty until files are dropped into it.

Select Files by Dragging form Explorer

The large box is a "file drop target" that uses the Windows drag & drop protocol. You can mark more files than will be selected by filtering the files using a file Extension,

[Clear List]

Click this button to empty the list of files in the drop box.

 All Files

Bullet this option to select all files from among those dragged from Explorer.

 Extension:

Bullet this option to select files matching a specified file name extension. Starting with those files dragged from Explorer, only files with the specified file extension will be dropped into the box. The above example shows that files matching the extension *.fts will be selected.

Mira File List Page

The Mira File List page is used for selecting a Mira File List containing the selected files. The Mira File List is a single text file containing the full path specification for 1 or more files. File lists have a .axf file extension. This page remembers the file list between sessions, however it is possible that the file list may not exist in a new session.

File list name:

Use the [...] button to open a browser for selecting the Mira File List.

Browse Files Page

The Browse Files page opens a Windows Open dialog for selecting files. A powerful feature of this page is the Append option. This causes new files to be added to the list of files already in the box. The[Browse...] button activates the standard Windows Open dialog for selecting files. A limitation of the Open dialog is that it can only select files from a single folder at one time. Checking append allows you to browse for files multiple times, each time adding files from a new folder to the growing list in the box.

[Browse]

Click this button to open a standard Windows Open dialog for choosing files.

Clear List

Click this button to clear the entire contents of the file listing.

 Append

Check this box to allow new files to append the list of files already in the box.

 Save List

Check this box to save the file list for loading the next time this page is used for this command.

Related Topics

User Interface