Combine Files


The Combine Files command combines any number of images residing in files. The files to combine are specified using a file list. In comparison, the Combine Images command combines images in an Image Set that have been displayed. The value of The Combine Files command is that it does not require all images to be loaded into memory; instead, this command can combine any number of images with each image file being up to 2 GB in length. Several statistical methods are available for combining the images and for adjusting ("normalizing") them to a common reference value (see Image Combining Methods). The set of preferences is saved as a Profile.

Combine Files uses a file list containing the names of files. The resulting combined image is displayed in a new window. The file list may already exist or you may create it from an Open dialog. Normalization is used to adjust the images to a common statistical value when using any combining method that rejects bad data such as the mean, rank, and alpha methods. Statistical methods for computing the normalization values are discussed in Image Region Statistics.

Preferences

These settings appear when the dialog is in the "dropped" position which is controlled by the Show / Hide button.

Profile

Selects a parameter collection for display in the dialog.

File List

The name of the Mira File List containing the names of files to combine. All images must be in FITS format.

Method

This list box selects the type of processing used to combine the image values. These are described in Image Combining Methods. Depending upon the method selected, extra fields may appear for method-specific parameters, like High sigma.

Normalization

This control group specifies whether the images are adjusted (normalized) to a common statistical value before being combined. If normalization is not set to "none", then the button opens the Region Statistics dialog. In this dialog you specify how the normalization is to be computed, including the target statistic and the region over which it is calculated. See the discussion below.

Data Type

Select the Data Type so that it can accommodate the increased signal or dynamic range of the combined images. For example, if combining a large number of 16-bit integer type images it is usually prudent to set the Data type of the output image to 32 bit real.

Other Options

These are miscellaneous settings grouped together to conserve screen space:

  • Adjust Exptime updates the exposure time in the output image so that it is characteristic of the exposure time of an equivalent single image. This can be used to maintain the image flux, or the value of signal per unit time. This option also updates the mid-time of the exposure based on the weighted combination of the mid-times of all the combined images. The mid-time is saved in the keywords DATE-MID and TIME-MID, which can be used by the photometry tools.

  • Verbose controls whether detailed messages are listed during the processing.

  • Scale Result to 1.0 normalizes the combined image to a reference value of 1.0. The Normalization settings are used to compute and apply the scaling. Use this setting when using the command to create a flat field correction frame (see the Apply Flat Field method).

Normalization

Normalization is used to adjust the images to a common statistical value when using any combining method that rejects bad data. This is essential when using a combining method that performs rejection of bad data, such as the Sigma Clipping, Min/Max or Median methods.

Choose the normalization operation, Scale, Offset, or None, according to the nature of the difference between the images being combined.

Results

The Mira Text Editor below shows the results for normalizing the 5 BL-CAM*.fts images supplied with Mira. This example used the "Offset" normalization method and the settings shown in the Region Statistics dialog below. For the present function, the Region Statistics dialog offers only a Relative Region option for computing the statistic. This happens because the images sizes are not generally know before running the command. In comparison, the general Region Statistics dialog allows both Relative and Absolute region options.

Related Topics

Math Commands, Combine Images, Image Set, Image Combining Methods, Image Region Statistics, Region Statistics, Register Images, Drop Dialogs, Profiles