Syntax
Application.CreateCalibrationGroups ( FilePaths, CombineMethod, DarkScaling, Boxcar )
Parameters
String FilePaths - a string specifying one or more folders containing the images to be scanned for building calibration groups. If more than one folder is specified, separate their paths with semicolons (;).
CombineType CombineMethod - specifies how the calibration frames are to be combined
mxSumCombine (0) : take sum of corresponding pixels in all images
mxAvgCombine (1) : take average of corresponding pixels in all images
mxMedianCombine (2) : take median of corresponding pixels in all images
mxSigmaClipCombine (3) : combine images using sigma-clip algorithm
mxSDMaskCombine (4) : combine images using standard-deviation masking algorithm
DarkFrameScalingType DarkScaling - specify the dark frame scaling method to be used with any dark groups created
dfsNone (0) : do not scale dark frames
dfsAutoScale (1) : adjust the master dark frame by the ratio of the desired exposure time to the actual exposure time for this group
dfsAutoOptimize (2) : adjust the master dark frame using linear regression to minimize the RMS noise in the final image
dfsManual (3) : use manual dark frame scaling (NB. the scale factor cannot currently be set using the automation interface)
Boolean Boxcar - if true, apply a boxcar kernel filter to any master flats generated by this command. This is useful for one-shot color cameras
Returns
Integer - The number of calibration groups created
Remarks
This method is equivalent to the Set Calibration command's "Auto-Generate (Clear Old)" operation. It removes all existing calibration groups (but not their consitutent files), then scans through the folder or folders specified by FilePaths for full-frame FITS and TIFF images marked as calibration images, i.e., their IMAGETYP keys indicate they are darks, biases, or flats. Then it creates groups for each unique combination of image type, image pixel size, binning, temperature or ISO setting, etc.