CImCombine:Class Definition
The CImCombine class contains methods for combining images in various ways. The processing methods take their images from a CImageSet collection of images. This class uses the same statistical algorithms as the CStats class.
Construction |
Object = CImCombine:new() Object = CImCombine:new( CImCombine ) |
Destruction |
Object:delete() |
This class has no public data members.
Creates a new instance of the CImCombine class. A default constructor and a copy constructor are available. |
|
Deletes the instance of the CImCombine object. |
|
Copies the CImCombine to a new CImCombine |
|
Saves the current class member data so they can be restored later. |
|
Restores all class members to their last saved state. |
The methods in this class combine the images of a CImageSet collection into a single image. See Combining Images using Criteria for an example showing how to use criteria to select and combine images.
The combining methods operate in the "depth" direction through the image set. Each pixel location is considered in turn, and all values in the images at that single location are combining using the specified method. This procedure is repeated for each pixel location in the image.
The available combining methods fall into 2 groups: The first group of methods merge individual images into a single, higher quality image according to the mean, median, or other statistical averaging process applied at each pixel location. The second group produces an image showing the properties of the image collection at each location, such as the range of pixel values or the standard deviation among the images. Methods in the first group are further split into two subgroups: those that compute means and weighted means and those that perform some type of bad data rejection, or "clipping".
These methods combine all pixels of all images using some form of weighting scheme.
Merges images using contra-harmonic mean weighting at each location. The exponent is a required parameter. |
|
Merges images by the geometric mean at each pixel location. |
|
Merges images by the mean value using equal weight at each pixel location. |
|
Merges images using the median value at each pixel location. |
|
Merges images by choosing the pixel at a given rank at each location. The rank percentile is a parameter. |
|
Merges images using the sum of values at each pixel location. |
|
Merges images using power law weighting at each location. The exponent, Yp, is a required parameter. |
These methods discard the pixels from some of the images if they do not meet some criterion for inclusion. These methods differ on the type of criterion they use. All use parameters to control the rejection criterion, although the parameters may be "hard-wired", such as the min/max clipping which always rejects both the highest and the lowest pixel values from the mean.
Merges images after clipping a selected number high and low outlying pixel values at each pixel location. |
|
Merge images using a weighted mean based on the value of a header keyword. |
|
Merges images by the mean value after excluding 0-value pixels at each location. |
|
Merges images after clipping the maximum pixel value at each location. |
|
Merges images after excluding the minimum and maximum values at each location. |
|
Merges images using a modified trimmed mean by clipping high and low outlying values based on the standard deviation at each location. |
|
Merges images by the mean value after excluding values outside upper and lower rank percentiles at each location. |
|
Merges images using the mean value after clipping high and low outlying values based on the standard deviation at each location. |
|
Merge images using a weighted mean based on an array of weight values. |
Merges images using the maximum value at each pixel location. |
|
Merges images using the minimum value at each pixel location. |
|
Creates an image showing the range of pixel values excluding the highest and lowest values at each location. |
|
Creates an image consisting of the range of values within the image set. |
|
Creates an image consisting of the standard deviation among pixels at each location. |
These methods control the image normalization procedure
Sets the arithmetic method used to correct images to common statistical level. The options are scale, offset, and none. |
|
Sets the normalization statistic used for adjusting images to similar signal levels before combining. |
|
Sets the rectangle used for computing the normalization statistic. |
|
Sets a fractional rectangle for computing the normalization statistic. |
Returns the error message when combining fails. |
|
Sets verbose method on or off. |
|
Sets the index of the reference image in the image set. |
|
Sets the title of the message window used in verbose mode. |
|
Sets the state of the exposure time adjustment flag. |
Merge color channel images into an RGB image. |