The 371 processing options of AutoIntegrate v1.87 test1, grouped by processing step.
Every option is listed with the name that is shown in the dialog, the internal parameter name used in JSON setup files, the value type and the default value. The name that is used in saved setups and process icons is shown as the setting name when it is different. For options whose dialog label is short or is used by several options in the same group, like High, the setting name is shown instead because it tells better which option it is. Descriptions are the tooltip texts from the script itself. Each option is tagged so you can tell at a glance whether it changes the processed image or only the way the script works.
Use the search box to find an option by name or by words in its description, and the buttons to show only the options of a certain kind. Selecting several buttons shows the options that have all of the selected tags.
320 options change processing, 51 options affect only the interface, files or logging. 47 options apply to color images and 46 options are specific to narrowband data.
How light and calibration files are found, identified and added.
| Option | Type / default | Description |
|---|---|---|
Do not use FILTER keywordProcessingskip_autodetect_filterSetting name: Do not autodetect FILTER keyword | checkboxunchecked | If selected do not try to autodetect light and flat files based on FILTER keyword. Selecting this enables manual adding of filter files for lights and flats. |
Do not use IMAGETYP keywordProcessingskip_autodetect_imagetypSetting name: Do not autodetect IMAGETYP keyword | checkboxunchecked | If selected do not try to autodetect calibration files based on IMAGETYP keyword. |
Use file name for filtersProcessingforce_file_name_filter | checkboxunchecked | Use file name for recognizing filters and ignore FILTER keyword. |
Add lights manuallyInterfacelights_add_manuallyShown in the dialog as: Add manually | checkboxunchecked | Add light files manually by selecting files for each filter. |
Integrated lightsInterfaceintegrated_lights | checkboxunchecked | If checked consider light files to be integrated files for AutoContinue. It is useful for example when using integrated lights from WBPP as there is no need to rename images. |
Add flats manuallyInterfaceflats_add_manuallyShown in the dialog as: Add manually | checkboxunchecked | Add flat files manually by selecting files for each filter. |
Add flat darks manuallyInterfaceflatdarks_add_manuallyShown in the dialog as: Add manually | checkboxunchecked | Add flat dark files manually by selecting files for each filter. |
How calibration frames are used and how master calibration files are built.
| Option | Type / default | Description |
|---|---|---|
DebayerProcessingColor imageOSC / RAWdebayer_pattern | text or listAuto | Select bayer pattern for debayering color/OSC/RAW/DSLR files. Auto option tries to recognize debayer pattern from image metadata. If images are already debayered choose none which does not do debayering. Values: |
Extract channel mappingProcessingColor imageOSC / RAWextract_channel_mapping | text or listNone | Extract channels from color/OSC/RAW/DSLR files. Channel extraction is done right after debayering. After channels are extracted processing continues as mono processing with separate filter files. Option LRGB extract lightness channels as L and color channels as separate R, G and B files. Option HOS extract channels as RGB=HOS and option HSO extract channels RGB=HSO. Resulting channels can then be mixed as needed using PixMath expressions in Settings / Narrowband processing section. Channel files have a channel name (_L, _R, etc.) at the end of the file name. Script can then automatically recognize files as filter files. Values: |
SuperBiasProcessingcreate_superbiasSetting name: Superbias | checkboxunchecked | Create SuperBias from bias files. For modern CMOS sensors you should not use superbias. For CCD sensors you can use superbias. |
Use on lightsProcessingbias_use_on_lightsSetting name: Bias use on lights | checkboxunchecked | Use bias files on light frames. If there are master dark files, bias files are ignored on light frames unless explicitly enabled. |
Use on darksProcessingbias_use_on_darksSetting name: Bias use on darks | checkboxunchecked | Use bias files on dark frames. For modern CMOS sensors you should not use bias files on dark frames. For CCD sensors you can use bias files on dark frames. |
Bias master filesProcessingbias_master_filesShown in the dialog as: Master files | checkboxunchecked | Files are master files. When there are multiple master files, they are matched by resolution. |
Pre-calibrateProcessingpre_calibrate_darksSetting name: Pre-calibrate darks | checkboxunchecked | If checked darks are pre-calibrated with bias and not during ImageCalibration. |
OptimizeProcessingoptimize_darksSetting name: Optimize darks | checkboxunchecked | If checked darks are optimized when calibrating lights. For modern CMOS cameras optimization should not be used. For CCD cameras it can be used. |
Dark master filesProcessingdark_master_filesShown in the dialog as: Master files | checkboxunchecked | Files are master files. When there are multiple master files in a group, they are matched by resolution. |
Flat dark master filesProcessingflat_dark_master_filesShown in the dialog as: Master files | checkboxunchecked | Files are master files. When there are multiple master files in a group, they are matched by resolution. |
Flat master filesProcessingflat_master_filesShown in the dialog as: Master files | checkboxunchecked | Files are master files. When there are multiple master files in a group, they are matched by resolution. |
Stars in flatsProcessingstars_in_flats | checkboxunchecked | If you have stars in your flats then checking this option will lower percentile clip values and should help remove the stars. |
Use darksProcessinguse_darks_on_flat_calibrateSetting name: Use darks on flats | checkboxunchecked | If selected then darks are used for flat calibration. |
Auto output pedestalProcessingauto_output_pedestal | checkboxchecked | Use automatic output pedestal when calibrating lights. |
Output pedestalProcessingoutput_pedestal | checkbox0 | Pedestal value added when calibrating lights if auto output pedestal is not checked. Value is from range 0 to 65535. |
Hot and cold pixels, linear column and row defects, and banding.
| Option | Type / default | Description |
|---|---|---|
Fix column defectsProcessingfix_column_defects | checkboxunchecked | If checked, fix linear column defects by using linear defect detection algorithm from LinearDefectDetection.js script. Defect information is used by CosmeticCorrection to fix the defects. |
Fix row defectsProcessingfix_row_defects | checkboxunchecked | If checked, fix linear row defects by using linear defect detection algorithm from LinearDefectDetection.js script. Defect information is used by CosmeticCorrection to fix the defects. |
No CosmeticCorrectionProcessingskip_cosmeticcorrectionSetting name: No Cosmetic correction | checkboxunchecked | Do not run CosmeticCorrection on image files. Can be useful when doing Comet align. |
CosmeticCorrection hot sigmaProcessingcosmetic_correction_hot_sigma | integer3 | Hot Sigma and Cold Sigma values for CosmeticCorrection |
CosmeticCorrection cold sigmaProcessingcosmetic_correction_cold_sigma | integer3 | Hot Sigma and Cold Sigma values for CosmeticCorrection |
Banding reductionProcessingColor imageOSC / RAWbanding_reduction | checkboxunchecked | Do Canon banding reduction using the method in CanonBandingReduction script. Banding reduction is run for each light file separately after cosmetic correction and possible debayering. |
Protect highlightsProcessingColor imageOSC / RAWbanding_reduction_protect_highlightsSetting name: Banding reduction protect highlights | checkboxunchecked | Protection for highlights. |
AmountProcessingColor imageOSC / RAWbanding_reduction_amountSetting name: Banding reduction amount | number1 | Reduction amount. An amount less than 1.0 is often necessary with fainter banding. |
SubframeSelector measurements, image weights, filter limits and outlier rejection.
| Option | Type / default | Description |
|---|---|---|
No SubframeSelectorProcessingskip_subframeselector | checkboxunchecked | Do not run SubframeSelector to get image weights. When this option is used then the first image in the list is used as a reference image unless reference image is selected manually. |
ImageIntegration use ssweightProcessinguse_imageintegration_ssweightSetting name: ImageIntegration use SSWEIGHT | checkboxunchecked | Use SSWEIGHT weight keyword during ImageIntegration. |
Weight calculationProcessinguse_weight | text or listPSF Signal | Generic - Use both noise and stars for the weight calculation. Noise - More weight on image noise. Stars - More weight on stars. PSF Signal - Use PSF Signal value as is. PSF Signal scaled - PSF Signal value scaled by AutoIntegrate to 1-100. FWHM scaled - FWHM value scaled by AutoIntegrate to 1-100. Eccentricity scaled - Eccentricity value scaled by AutoIntegrate to 1-100. SNR scaled - SNR value scaled by AutoIntegrate to 1-100. Star count - Star count value. All values are scaled so that bigger value is better. Values: |
SSWEIGHT limitProcessingssweight_limitShown in the dialog as: Limit | number1e-10 | Limit value for SSWEIGHT. If value for SSWEIGHT is below the limit it is not included in the set of processed images. Note that the value is written to the FITS header using 10 digits. Smaller than 10 digit limit values should not be used if using the SSWEIGHT value that is written to FITS header. |
Filtering sort orderProcessingsort_order_type | text or listSSWEIGHT | Sort order for the filter and sort button. Values: |
Filter limit 1 typeProcessingfilter_limit1_type | text or listPSFSignal | Choose filter measure and value. FWHM and Eccentricity are filtered for too high values (min), and all others are filtered for too low values (max). Limit value zero (0.0000) means that there is no filtering. Values: |
Filter limit 1 valueProcessingfilter_limit1_valShown in the dialog as: Limit | number0 | Choose filter measure and value. FWHM and Eccentricity are filtered for too high values (min), and all others are filtered for too low values (max). Limit value zero (0.0000) means that there is no filtering. |
Filter limit 2 typeProcessingfilter_limit2_type | text or listFWHM | Choose filter measure and value. FWHM and Eccentricity are filtered for too high values (min), and all others are filtered for too low values (max). Limit value zero (0.0000) means that there is no filtering. Values: |
Filter limit 2 valueProcessingfilter_limit2_valShown in the dialog as: Limit | number0 | Choose filter measure and value. FWHM and Eccentricity are filtered for too high values (min), and all others are filtered for too low values (max). Limit value zero (0.0000) means that there is no filtering. |
Filter limit 3 typeProcessingfilter_limit3_type | text or listEccentricity | Choose filter measure and value. FWHM and Eccentricity are filtered for too high values (min), and all others are filtered for too low values (max). Limit value zero (0.0000) means that there is no filtering. Values: |
Filter limit 3 valueProcessingfilter_limit3_valShown in the dialog as: Limit | number0 | Choose filter measure and value. FWHM and Eccentricity are filtered for too high values (min), and all others are filtered for too low values (max). Limit value zero (0.0000) means that there is no filtering. |
Filter limit 4 typeProcessingfilter_limit4_type | text or listStars | Choose filter measure and value. FWHM and Eccentricity are filtered for too high values (min), and all others are filtered for too low values (max). Limit value zero (0.0000) means that there is no filtering. Values: |
Filter limit 4 valueProcessingfilter_limit4_valShown in the dialog as: Limit | number0 | Choose filter measure and value. FWHM and Eccentricity are filtered for too high values (min), and all others are filtered for too low values (max). Limit value zero (0.0000) means that there is no filtering. |
SSWEIGHTProcessingoutliers_ssweightSetting name: Outliers SSWEIGHT | checkboxunchecked | Skipping outliers can be useful when processing very large data sets and manual filtering gets too complicated Option 'SSWEIGHT' will filter out outliers based on the calculated SSWEIGHT value. It is an alternative to using a fixed Limit value. All other options will filter out outliers based on individual values. |
FWHMProcessingoutliers_fwhmSetting name: Outliers FWHM | checkboxunchecked | Skipping outliers can be useful when processing very large data sets and manual filtering gets too complicated Option 'SSWEIGHT' will filter out outliers based on the calculated SSWEIGHT value. It is an alternative to using a fixed Limit value. All other options will filter out outliers based on individual values. |
EccProcessingoutliers_eccSetting name: Outliers eccentricity | checkboxunchecked | Skipping outliers can be useful when processing very large data sets and manual filtering gets too complicated Option 'SSWEIGHT' will filter out outliers based on the calculated SSWEIGHT value. It is an alternative to using a fixed Limit value. All other options will filter out outliers based on individual values. |
SNRProcessingoutliers_snrSetting name: Outliers SNR | checkboxunchecked | Skipping outliers can be useful when processing very large data sets and manual filtering gets too complicated Option 'SSWEIGHT' will filter out outliers based on the calculated SSWEIGHT value. It is an alternative to using a fixed Limit value. All other options will filter out outliers based on individual values. |
PSF SignalProcessingoutliers_psfsignalSetting name: Outliers PSF Signal | checkboxunchecked | Skipping outliers can be useful when processing very large data sets and manual filtering gets too complicated Option 'SSWEIGHT' will filter out outliers based on the calculated SSWEIGHT value. It is an alternative to using a fixed Limit value. All other options will filter out outliers based on individual values. |
PSF PowerProcessingoutliers_psfpowerSetting name: Outliers PSF Power | checkboxunchecked | Skipping outliers can be useful when processing very large data sets and manual filtering gets too complicated Option 'SSWEIGHT' will filter out outliers based on the calculated SSWEIGHT value. It is an alternative to using a fixed Limit value. All other options will filter out outliers based on individual values. |
StarsProcessingoutliers_starsSetting name: Outliers Stars | checkboxunchecked | Skipping outliers can be useful when processing very large data sets and manual filtering gets too complicated Option 'SSWEIGHT' will filter out outliers based on the calculated SSWEIGHT value. It is an alternative to using a fixed Limit value. All other options will filter out outliers based on individual values. |
Outlier methodProcessingoutliers_method | text or listTwo sigma | Different methods are available for detecting outliers.Two sigma filters out outliers that are two sigmas away from mean value. One sigma filters out outliers that are one sigmas away from mean value. This option filters more outliers than the two other options. Interquartile range (IQR) measurement is based on median calculations. It should be relatively close to two sigma method. Values: |
Min MaxProcessingoutliers_minmaxSetting name: Outlier min max | checkboxunchecked | If checked outliers are filtered using both min and max outlier threshold values. By default FWHM and Eccentricity are filtered for too high values, and SNR and SSWEIGHT are filtered for too low values. |
StarAlignment, comet alignment, binning, drizzle and cropping to the common area.
| Option | Type / default | Description |
|---|---|---|
SensitivityProcessingstaralignment_sensitivitySetting name: StarAlignment sensitivity | number0.5 | Sensitivity setting. Bigger value will detect fainter stars.
If the star aligment fails you can try to change values. Here is one suggestion of values that might help: If you have very bad distortion then also increasing maximum distortion can help. |
Maximum distortionProcessingstaralignment_maxstarsdistortionSetting name: StarAlignment distortion | number0.6 | Maximum star distortion setting. Bigger value will detect more irregular stars.
If the star aligment fails you can try to change values. Here is one suggestion of values that might help: If you have very bad distortion then also increasing maximum distortion can help. |
StarAlignment layersProcessingstaralignment_structurelayers | integer5 | Structure layers setting. Bigger value will detect more stars.
If the star aligment fails you can try to change values. Here is one suggestion of values that might help: If you have very bad distortion then also increasing maximum distortion can help. |
StarAlignment noise reductionProcessingstaralignment_noisereductionfilterradius | integer0 | Noise reduction filter radius layers setting. Bigger value can help with very noisy images.
If the star aligment fails you can try to change values. Here is one suggestion of values that might help: If you have very bad distortion then also increasing maximum distortion can help. |
Comet alignProcessingcomet_align | checkboxunchecked | If checked, run CometAlign process using settings in the Preprocessing / CometAlignment settings section. For more details see the help icon in CometAlignment settings section. |
Comet align first XYProcessingcomet_first_xy | text or list— | Coordinates for the first comet image. Below is the suggested workflow with comet processing in AutoIntegrate:
Note that using starless images may cause problems for example with ImageIntegration or BlurXTerminator. With missing PSF error in ImageIntegration you can use an option ImageIntegration use ssweight. Sometimes on starless images PSF value can not be calculated. Then a manual value should be given or BlurXTerminator should not be used. It is also possible to manually run the CometAlignment process. Below are the steps to use AutoIntegrate with manual comet alignment:
|
Comet align last XYProcessingcomet_last_xy | text or list— | Coordinates for the last comet image. Below is the suggested workflow with comet processing in AutoIntegrate:
Note that using starless images may cause problems for example with ImageIntegration or BlurXTerminator. With missing PSF error in ImageIntegration you can use an option ImageIntegration use ssweight. Sometimes on starless images PSF value can not be calculated. Then a manual value should be given or BlurXTerminator should not be used. It is also possible to manually run the CometAlignment process. Below are the steps to use AutoIntegrate with manual comet alignment:
|
BinningProcessingbinning | integer0 | Do binning for each light file. Binning is done first on calibrated light files before any other operations.With Color option binning is done only for color channel files.With L and Color option binning is done for both luminance and color channel files.Binning uses IntegerResample process and should help to reduce noise at the cost of decreased resolution. Values: |
Binning resample factorProcessingbinning_resample | integer2 | Resample factor for binning. Do binning for each light file. Binning is done first on calibrated light files before any other operations.With Color option binning is done only for color channel files.With L and Color option binning is done for both luminance and color channel files.Binning uses IntegerResample process and should help to reduce noise at the cost of decreased resolution. |
Crop to common areaProcessingcrop_to_common_area | checkboxunchecked | Crop all channels to area covered by all images |
Drizzle, scaleProcessinguse_drizzleSetting name: Drizzle | checkboxunchecked | Use Drizzle integration Drizzle scale 1 does not change the image size but may help with fine details like stars in the image. Drizzle scale 2 doubles the image resolution and may help with small details in the image. Consider using drizzle when selecting SPCC for color calibration. For Drizzle settings see Integration / Drizzle section. |
Drizzle scaleProcessingdrizzle_scale | integer2 | Use Drizzle integration Drizzle scale 1 does not change the image size but may help with fine details like stars in the image. Drizzle scale 2 doubles the image resolution and may help with small details in the image. Consider using drizzle when selecting SPCC for color calibration. For Drizzle settings see Integration / Drizzle section. |
Drop shrinkProcessingdrizzle_drop_shrinkSetting name: Drizzle drop shrink | number0.9 | Drop shrink value for drizzle. |
Crop toleranceProcessingcrop_tolerance | integer2 | Number of consecutive bad pixels allowed before detecting crop edge. |
Use rejection lowProcessingcrop_use_rejection_lowSetting name: Crop use rejection low | checkboxchecked | Use rejection_low from ImageIntegration instead of integrated data to calculate crop amount. |
LimitProcessingcrop_rejection_low_limitSetting name: Crop rejection low limit | number0.2 | Limit value for detecting crop edges. Values below the limit are considered to be inside the cropped area. This value is used only if rejection low is selected. |
Warning limitProcessingcrop_check_limitSetting name: Crop check limit | number5 | Warning limit value in percentages. If image is cropped more than the warning limit percentage a warning message is printed at the end of processing. After a warning you should manually check the cropping area. |
Drizzle functionProcessingdrizzle_function | text or listSquare | Drizzle drop kernel function. Values: |
Fast mode,Processingdrizzle_fast_modeSetting name: Drizzle fast mode | checkboxchecked | Use fast mode for drizzle integration. |
ImageIntegration, normalization, rejection algorithms and FastIntegration.
| Option | Type / default | Description |
|---|---|---|
Local NormalizationProcessinglocal_normalizationSetting name: Local normalization | checkboxunchecked | Use local normalization data for ImageIntegration For local normalization settings see section Integration / LocalNormalization |
Fast integrationProcessinguse_fastintegrationSetting name: Use FastIntegration | checkboxunchecked | If checked, use FastIntegration process instead of ImageIntegration process when integrating light images. In Integration tab there are some settings for FastIntegration. |
No ImageIntegration clippingProcessingskip_imageintegration_clipping | checkboxunchecked | Do not use clipping in ImageIntegration |
ImageIntegration NormalizationProcessingimageintegration_normalization | text or listAdditive | Rejection normalization. This is value is ignored if local normalization is used. Values: |
ImageIntegration CombinationProcessingintegration_combination | text or listAverage | Pixel combination operation Values: |
ImageIntegration rejectionProcessinguse_clipping | text or listAuto2 | Auto1
Auto2
Percentile - Percentile clip Sigma - Sigma clipping. If you are not happy with the rejection result you can lower the High sigma for example to 2.8. Winsorised - Winsorised sigma clipping. To remove satellite trails with Winsorised sigma use lower high sigma value like 2.2 or even 1.8. Averaged - Averaged sigma clipping. If you are not happy with the rejection result you can lower the High sigma for example to 2.8. Linear - Linear fit clipping ESD - Extreme Studentized Deviate clipping. If you are not happy with the rejection result you can try higher ESD Significance like 0.2 and lower Low relaxation like 1.0. None - No rejection. Useful for example with a blown out comet core. Values: |
Percentile LowProcessingpercentile_lowSetting name: Percentile low | number0.2 | Percentile low clipping factor. |
Percentile highProcessingpercentile_highShown in the dialog as: High | number0.1 | Percentile high clipping factor. |
Sigma LowProcessingsigma_lowSetting name: Sigma low | number4 | Sigma low clipping factor. |
Sigma highProcessingsigma_highShown in the dialog as: High | number3 | Sigma high clipping factor. If you are not happy with the rejection result you can lower the High sigma for example to 2.8. To remove satellite trails with Winsorised sigma use lower high sigma value like 2.2 or even 1.8. |
Winsorization cutoffProcessingwinsorised_cutoffSetting name: Winsorised cutoff | number5 | Cutoff point for Winsorised sigma clipping. |
Linear fit LowProcessinglinearfit_lowSetting name: Linear fit low | number5 | Tolerance of low values for linear fit low clipping. |
Linear fit highProcessinglinearfit_highShown in the dialog as: High | number4 | Tolerance of high values for linear fit low clipping. |
ESD OutliersProcessingESD_outliersSetting name: ESD outliers | number0.3 | ESD outliers. |
SignificanceProcessingESD_significanceSetting name: ESD significance | number0.05 | ESD significance. If you are not happy with the rejection result you can try higher ESD Significance like 0.2 and lower Low relaxation like 1.0. |
Large scale pixel rejection highProcessinglarge_scale_pixel_rejection_highShown in the dialog as: High | checkboxunchecked | Enable large scale rejection of high pixels. Large scale rejection of high pixels may help for example with satellite trails. |
LowProcessinglarge_scale_pixel_rejection_lowSetting name: Large scale pixel rejection low | checkboxunchecked | Enable large scale rejection of low pixels. |
Use multiscale analysisProcessinguse_localnormalization_multiscaleSetting name: Use LocalNormalization Multiscale | checkboxunchecked | During local normalization use multiscale analysis instead of PSF flux evaluation. Using multiscale analysis may help if you get errors like PSFScaleEstimator::EstimateScale(): Internal error: No reference image has been defined. |
FastIntegration iterationsProcessingfastintegration_iterations | integer2 | Increase the value if you have a lot of drift between images. |
Max relative fluxProcessingfastintegration_max_fluxSetting name: FastIntegration max flux | number0.5 | Increase the value if you have a dense starfield. Smaller values can be used for sparse starfields. |
Error toleranceProcessingfastintegration_errortoleranceSetting name: FastIntegration error tolerance | number1.5 | Alignment error tolerance. You can try increasing the value if alignment fails. |
Fast SubframeSelectorProcessingfastintegration_fast_subframeselectorSetting name: FastIntegration fast SubframeSelector | checkboxchecked | Run SubframeSelector only to a subset of images when using FastIntegration. SubframeSelector is used only to find the reference image. When this option is used then the first 32 images in the list are used to find the reference image unless reference image is selected manually. |
Skip CosmeticCorrectionProcessingfastintegration_skip_cosmeticcorrectionSetting name: FastIntegration skip CosmeticCorrection | checkboxchecked | Do not run CosmeticCorrection when using FastIntegration. With a very large number of files it usually should not be necessary. |
When gradient correction is run, and the settings for GC, ABE, DBE, MGC and GraXpert.
| Option | Type / default | Description |
|---|---|---|
Gradient correction on channel imagesProcessingMono / LRGBGC_before_channel_combinationSetting name: GC before channel combination | checkboxunchecked | Use gradient correction on channel images (L,R,G,B,H,S,O) separately before channels are combined. With color/OSC images this does the same thing as Gradient correction on combined images. |
Gradient correction on light imagesProcessingGC_on_lightsSetting name: GC on light images | checkboxunchecked | Use gradient correction on all light images. It is run very early in the processing before cosmetic correction. |
Gradient correction on combined imagesProcessinguse_GC_on_L_RGBSetting name: Use GC on L, RGB | checkboxunchecked | Use gradient correction on L and combined RGB images while image is still in linear mode. |
Gradient correction on stretched imagesProcessinguse_GC_on_L_RGB_stretchedSetting name: Use GC on L, RGB stretched | checkboxunchecked | Use gradient correction on L and RGB images after they have been stretched to non-linear mode. Note that this option should not be used with GradientCorrection process. |
GraXpert gradientProcessingExternal tooluse_graxpertSetting name: Use GraXpert | checkboxunchecked | Use GraXpert instead of GradientCorrection process to correct gradients in images.By default no gradient correction is done. To use GraXpert for gradient correction you need to also check one of the gradient correction options in the Settings / Image processing parameters section. GraXpert always uses the AI background model. In the Tools / GraXpert section it is possible to set some settings. NOTE! A path to GraXpert file must be set in the Tools / GraXpert section before it can be used. NOTE2! You need to manually start GraXpert once to ensure that the correct AI model is loaded into your computer. |
Use AutomaticBackgroundExtractorProcessinguse_abeShown in the dialog as: ABE | checkboxunchecked | Run AutomaticBackgroundExtractor (ABE) to correct gradients in images.By default no gradient correction is done. To use ABE for gradient correction you need to also check one of the gradient correction options in the Settings / Image processing parameters section. Settings for ABE are in Postprocessing / ABE settings section. |
DBEProcessinguse_dbeSetting name: Use DynamicBackgroundExtractor | checkboxunchecked | Use DynamicBackgroundExtraction (DBE) to correct gradients in images.By default no gradient correction is done. To use DBE for gradient correction you need to also check one of the gradient correction options in the Settings / Image processing parameters section. Sample points are automatically generated for DBE. Settings for DBE are in Postprocessing / DBE settings section. |
MultiscaleGradientCorrectionProcessinguse_multiscalegradientcorrectionSetting name: Use MultiscaleGradientCorrection | checkboxunchecked | Use MultiscaleGradientCorrection instead of GradientCorrection process to correct gradients in images.By default no gradient correction is done. To use MultiscaleGradientCorrection for gradient correction you need to also check one of the gradient correction options in the Settings / Image processing parameters section. Settings for MultiscaleGradientCorrection are in Postprocessing / Gradient correction section. Note that you need to set up MARS database settings using the PixInsight MultiscaleGradientCorrection process before using this option. When MultiscaleGradientCorrection is selected, image solving and SpectrophotometricFluxCalibration are run automatically for the image. MultiscaleGradientCorrection may fail if the image is not part of the sky area in the MARS database. In that case the script reverts to another gradient correction method. If other gradient correction methods are checked then they are selected in the following order: GraXpert, ABE, DBE, GradientCorrection. |
Output background modelProcessingGC_output_background_modelSetting name: GC output background model | checkboxunchecked | If checked the background model is created. |
GC scaleProcessinggc_scaleShown in the dialog as: Scale | number5 | Model scale. Higher values generate smoother models. |
SmoothnessProcessinggc_smoothnessSetting name: GC smoothness | number0.4 | Model smoothness. |
Automatic convergenceProcessinggc_automatic_convergenceSetting name: GC automatic convergence | checkboxunchecked | Run multiple iterations until difference between two models is small enough. |
Structure ProtectionProcessinggc_structure_protectionSetting name: GC structure protection | checkboxchecked | Prevent overcorrecting on image structures. |
Protection thresholdProcessinggc_protection_thresholdSetting name: GC protection threshold | number0.1 | Decreasing this value prevents overcorrecting dimmer structures. |
Protection amountProcessinggc_protection_amountSetting name: GC protection amount | number0.5 | Increasing this value prevents overcorrecting significant structures. |
Simplified ModelProcessinggc_simplified_modelSetting name: GC simplified model | checkboxunchecked | If checked use a simplified model that is extracted before multiscale model. |
GC simplified model degreeProcessinggc_simplified_model_degree | integer1 | Model degree for simplified model. |
MGC scaleProcessingmgc_scale | text or list1024 | Gradient model scale. Values: |
MGC scale factorProcessingmgc_scale_factorShown in the dialog as: Scale | number1 | Scale factor for all channels. |
MGC structure separationProcessingmgc_structure_separation | integer3 | Structure separation for MultiscaleGradientCorrection. |
ABE degreeProcessingABE_degree | integer4 | Function degree can be changed if ABE results are not good enough. |
ABE correctionProcessingABE_correction | text or listSubtraction | Correction method for ABE. Values: |
ABE normalizeProcessingABE_normalizeShown in the dialog as: Normalize | checkboxunchecked | If checked sets the normalize flag. Normalizing is more likely to keep the original color balance. |
Background neutralizationProcessingdbe_use_background_neutralizationSetting name: DBE use background neutralization | checkboxchecked | If checked background neutralization is run before DBE on color images. |
DBE use ABEProcessingdbe_use_abeShown in the dialog as: ABE | checkboxchecked | If checked ABE with degree one is run before DBE. |
DBE samples per rowProcessingdbe_samples_per_row | integer10 | Number of sample points placed for each row and column. |
DBE normalizeProcessingdbe_normalizeShown in the dialog as: Normalize | checkboxchecked | If checked sets the normalize flag. Normalizing is more likely to keep the original color balance. |
Min weightProcessingdbe_min_weightSetting name: DBE min weight | number0.75 | Minimum sample weight to be included in the samples. |
DBE weight modeProcessingdbe_weight_mode | text or listBalanced | Selects how the sample weight is calculated from the sample region statistics. Strict penalizes the sample using the full noise ratio of the region. Only very flat regions get a high weight. Balanced penalizes only the noise that exceeds the noise level of the image. A region that is pure background noise gets full weight. This is the default. Background noise works like Balanced but uses the measured noise level of the selected sample regions as a reference instead of the whole image noise level. It also uses the image noise level when detecting samples that are brighter than the background. Values: |
DBE edge weightProcessingdbe_edge_weight | text or listNeutral | Selects how the distance of the sample from the image edge affects the sample weight. Neutral does not change the weight based on the distance from the edge. This is the default. Favor center reduces the weight of samples close to the edge. This helps to prevent edge artifacts from affecting the background model. Favor edges increases the weight of samples close to the edge. This helps the background model to better fit edge vignetting. Values: |
GraXpert pathProcessingExternal toolgraxpert_path | text or list— | Path to GraXpert executable. NOTE! Parameter is automatically saved the persistent module settings. The value is automatically restored when the script starts. Note that this parameter is not reset or saved to Json file. |
GraXpert correctionProcessingExternal toolgraxpert_correction | text or listSubtraction | Correction method for GraXpert. Values: |
SmoothingProcessingExternal toolgraxpert_smoothingSetting name: GraXpert smoothing | number0.5 | Smoothing for GraXpert gradient correction. |
| Smoothen background %ProcessingsmoothbackgroundSetting name: Smooth background | number0 | Gives the limit value as percentage of shadows that is used for shadow smoothing. Smoothing is done before gradient correction. Usually values below 50 work best. Possible values are between 0 and 100. Zero values does not do smoothing. Smoothening should be used only in extreme cases with very uneven background because a lot of shadow detail may get lost. |
ColorCalibration, SPCC, and the image solver and target metadata they use.
| Option | Type / default | Description |
|---|---|---|
No color calibrationProcessingColor imageskip_color_calibration | checkboxunchecked | Do not run color calibration. Color calibration is run by default on RGB data. |
No auto backgroundProcessingColor imageskip_auto_background | checkboxunchecked | Do not try to find background area. |
Color calibration using SPCCProcessingColor imageuse_spccSetting name: Use SPCC for color calibration | checkboxunchecked | Run color calibration using SpectrophotometricColorCalibration (SPCC). This requires image solving which is done automatically on Integration_RGB image if it is not already done. If image does not have correct coordinates or focal length embedded they can be given in Postprocessing / Image solving section. SPCC settings can be updated at Postprocessing / Color calibration section. |
Solve imageProcessingsolve_image | checkboxunchecked | Solve image by running ImageSolver script. Note that if Color calibration using SPCC is selected image is solved automatically with checking this box. If the image does not have correct coordinates or focal length embedded they can be given in Postprocessing / Image solving section. Consider also using Drizzle with scale 1 or 2 when using SPCC. |
Use BackgroundNeutralizationProcessingColor imageuse_background_neutralizationSetting name: Background neutralization | checkboxunchecked | Run BackgroundNeutralization before ColorCalibration. By default the script tries to automatically detect an area with a true background. If it finds one, an image with name AutoBackgroundModel is created. AutoBackgroundModel image has a preview that shows the background area.If AutoBackgroundModel image already exists then the background preview coordinates from there are used. The preview in AutoBackgroundModel image can be edited to use a different area as a background reference. Automatic background detect can be turned off using option No auto background in Other tab. |
Target typeProcessingtarget_type | text or listDefault | Give target type. If target type is given then image stretching settings are selected automatically. If no target type is given then current settings are used. They should work reasonably fine in many cases. Galaxy works well when target is a lot brighter than the background. Nebula works well when target fills the whole image or is not much brighter than the background. When non-default target type is selected then stretching option is disabled. Values: |
Target nameProcessingtarget_name | text or list— | Target name (optional). |
Target RA/DECProcessingtarget_radec | text or list— | Target RA DEC in decimal hours and degrees. Should be given if target image does not contain coordinates. Search button can be used to search coordinates. |
Target focal lengthProcessingtarget_focal | text or list— | Focal length in millimeters. Empty value uses image metadata. |
Target pixel sizeProcessingtarget_pixel_size | text or list— | Pixel size in μm. Empty value uses image metadata. |
Target binningProcessingtarget_binning | text or listAuto | Target binning. Binning multiplies the pixel size by the binning value.
Values: |
Target drizzleProcessingtarget_drizzle | text or listAuto | Target drizzle. Drizzle divides the pixel size by the drizzle value.
Values: |
Force solveProcessingtarget_forcesolveSetting name: Target force solve | checkboxunchecked | Force solving images even if it already solved. Can be useful for example when using old data with a newer SPCC version. |
Interactive solveProcessingtarget_interactivesolveSetting name: Target interactive solve | checkboxunchecked | Try solving the image interactively using image solver dialog. |
SPCC detection scalesProcessingColor imagespcc_detection_scales | integer5 | Number of layers used for structure detection. Larger value detects larger stars for signal evaluation. If SPCC fails you can try increasing the value. |
SPCC noise scalesProcessingColor imagespcc_noise_scales | integer1 | Number of layers used for noise reduction. If SPCC fails you can try increasing the value. |
SPCC min struct sizeProcessingColor imagespcc_min_struct_size | integer0 | Minimum size for a detectable star structure. Can be increased to avoid detecting image artifacts as real stars. |
Narrowband Red WavelengthProcessingColor imagespcc_red_wavelengthSetting name: SPCC red wavelength | number671.6 | Wavelength and bandwidths for Red, Green and Blue filters with narrowband processing. Default values are for Astrodon LRGB 2GEN filters using SHO palette. |
SPCC red bandwidthProcessingColor imagespcc_red_bandwidthShown in the dialog as: Bandwidth | number3 | Wavelength and bandwidths for Red, Green and Blue filters with narrowband processing. Default values are for Astrodon LRGB 2GEN filters using SHO palette. |
Narrowband Green WavelengthProcessingColor imagespcc_green_wavelengthSetting name: SPCC green wavelength | number656.3 | Wavelength and bandwidths for Red, Green and Blue filters with narrowband processing. Default values are for Astrodon LRGB 2GEN filters using SHO palette. |
SPCC green bandwidthProcessingColor imagespcc_green_bandwidthShown in the dialog as: Bandwidth | number3 | Wavelength and bandwidths for Red, Green and Blue filters with narrowband processing. Default values are for Astrodon LRGB 2GEN filters using SHO palette. |
Narrowband Blue WavelengthProcessingColor imagespcc_blue_wavelengthSetting name: SPCC blue wavelength | number500.7 | Wavelength and bandwidths for Red, Green and Blue filters with narrowband processing. Default values are for Astrodon LRGB 2GEN filters using SHO palette. |
SSPCC blue bandwidthProcessingColor imagespcc_blue_bandwidthShown in the dialog as: Bandwidth | number3 | Wavelength and bandwidths for Red, Green and Blue filters with narrowband processing. Default values are for Astrodon LRGB 2GEN filters using SHO palette. |
Narrowband modeProcessingColor imageNarrowbandspcc_narrowband_modeSetting name: SPCC narrowband mode | checkboxunchecked | Enable SPCC for narrowband images and use narrowband filter values. |
Background neutralizationProcessingColor imagespcc_background_neutralizationSetting name: SPCC background neutralization | checkboxchecked | Do background neutralization during SPCC. |
Narrowband auto modeProcessingColor imageNarrowbandspcc_auto_narrowbandSetting name: SPCC narrowband auto mode | checkboxchecked | Automatically update narrowband mode, white reference and filters. Filters are selected automatically when a single filter is used. |
SPCC white referenceProcessingColor imagespcc_white_reference | text or listAverage Spiral Galaxy | Select white reference for SPCC. Usually Average Spiral Galaxy is the best choice but for narrowband images Photon Flux should be used. Values: |
SPCC limit magnitudeProcessingColor imagespcc_limit_magnitude | text or listAuto | Limit magnitude for catalog search. Can be changed from Auto to something like 20 or larger if SPCC fails. Maximum value is 30. |
Saturation thresholdProcessingColor imagespcc_saturation_thresholdSetting name: SPCC saturation threshold | number0.75 | If SPCC fails you can try increasing this to for example 0.90. |
Min SNRProcessingColor imagespcc_min_SNRSetting name: SPCC min SNR | number40 | If SPCC fails you can try decreasing this value. You can for example try value 0. |
Use for narrowbandProcessingColor imageNarrowbandcolor_calibration_narrowbandSetting name: ColorCalibration narrowband | checkboxunchecked | Enable ColorCalibration for narrowband images. |
ColorCalibration timeProcessingColor imagecolor_calibration_time | text or listauto | When to run ColorCalibration process
Note that when using narrowband data color calibration is not run by default and must be enabled separately. Values: |
The stretching algorithm and the settings of each stretching method.
| Option | Type / default | Description |
|---|---|---|
Image stretchingProcessingimage_stretching | text or listAuto STF |
Select how image is stretched from linear to non-linear. For galaxies and other small but bright objects you should adjust targetBackground in Postprocessing / AutoSTF settings section to a smaller value, like 0.10 Parameters are set in Postprocessing / AutoSTF settings section. You can adjust settings in Postprocessing / MultiscaleAdaptiveStretch section. Useful when AutoSTF generates too bright images, like on some galaxies. Parameters are set in Postprocessing / Masked stretch settings section VeraLuxHMS can work well on many targets and can create saturated results. Parameters are set in Postprocessing / VeraLux HMS Stretch section Prestretch help with stars that can be too pointlike with Masked Stretch. Parameters are set in Postprocessing / Masked stretch settings and Postprocessing / Histogram stretching settings sections Parameters are set in Postprocessing / Histogram stretching settings section Can be useful when stretching stars to keep good star color. Parameters are set in Postprocessing / Arcsinh stretch settings sectionThere are also some experimental stretches.
Note that when non-default Target type is selected then this option is disabled. Values: |
STF targetBackgroundProcessingSTF_targetBackgroundShown in the dialog as: Target Background | number0.25 | STF targetBackground value. If you get too bright image lowering this value can help. Usually values between 0.1 and 0.250 work best. Possible values are between 0 and 1. |
Masked Stretch targetBackgroundProcessingMaskedStretch_targetBackgroundShown in the dialog as: Target Background | number0.125 | Masked Stretch targetBackground value. Usually values between 0.05 and 0.2 work best. Possible values are between 0 and 1. |
Prestretch targetProcessingMaskedStretch_prestretch_targetSetting name: Masked Stretch prestretch target | number0.1 | Masked Stretch prestretch target value if Masked+Histogram Stretch is used. Target value is a target median value. Using a prestretch can help with too pointlike stars. |
Stretch FactorProcessingArcsinh_stretch_factorSetting name: Arcsinh Stretch Factor | number50 | Arcsinh Stretch Factor value. Smaller values are usually better than really big ones. For some smaller but bright targets like galaxies it may be useful to increase stretch factor and iterations. A good starting point could be 100 and 5. Useful for stretching stars to keep star colors. Depending on the star combine method you may need to use different values. For less stars you can use a smaller value. |
Black point value %ProcessingArcsinh_black_pointSetting name: Arcsinh Stretch black point | number0.01 | Arcsinh Stretch black point value. The value is given as percentage of shadow pixels, that is, how many pixels are on the left side of the histogram. |
Arcsinh Stretch iterationsProcessingArcsinh_iterations | integer3 | Number of iterations used to get the requested stretch factor. |
MAS targetBackgroundProcessingMAS_targetBackgroundShown in the dialog as: Target Background | number0.15 | MAS targetBackground value. Usually values between 0.1 and 0.250 work best. Possible values are between 0 and 0.50. |
AggressivenessProcessingMAS_aggressivenessSetting name: MAS aggressiveness | number0.7 | Controls the black point clipping. Higher values produce Better background but may loose some details.Possible values are between 0 and 1. |
Dynamic Range CompressionProcessingMAS_dynamicRangeCompressionSetting name: MAS dynamic range compression | number0.4 | MAS dynamic range compression value. Higher values produce softer contrast in highlights. Possible values are between 0 and 1. |
Contrast RecoveryProcessingMAS_contrastRecoverySetting name: MAS contrast recovery | checkboxchecked | Enable or disable MAS contrast recovery. Contrast recovery can help to recover some contrast lost during stretching. |
Background ReferenceProcessingMAS_backgroundReferenceSetting name: MAS background reference | checkboxunchecked | If checked automatically finds and uses a background reference. |
MAS scale separationProcessingMAS_scaleSeparation | text or list1024 | MAS scale separation value. Smaller value protects smaller elements from local local contrast enhancements. Values: |
IntensityProcessingMAS_contrastRecoveryIntensitySetting name: MAS contrast recovery intensity | number1 | MAS contrast recovery intensity. |
Color SaturationProcessingColor imageMAS_colorSaturationSetting name: MAS color saturation | checkboxchecked | Enable or disable MAS color saturation. Color saturation can help to improve color saturation lost during stretching. |
AmountProcessingColor imageMAS_colorSaturation_amountSetting name: MAS color saturation amount | number0.75 | MAS color saturation amount. Controls the intensity of the saturation enhancements. Higher values produce stronger color saturation. |
BoostProcessingColor imageMAS_colorSaturation_boostSetting name: MAS color saturation boost | number0.5 | MAS color saturation boost. Higher values target more on lower saturation levels. |
Lightness maskProcessingColor imageMAS_colorSaturation_lightnessSetting name: MAS color saturation lightness | checkboxchecked | Enable or disable MAS color saturation affecting lightness. If enabled color saturation affects are masked using a lightness mask. |
VeraLux processing modeProcessingveralux_processing_mode | text or listReady-to-Use | VeraLux processing mode selection. Ready-to-Use (Aesthetic) Produces an aesthetic, export-ready image with adaptive expansion and soft-clipping. Scientific (Preserve) Produces 100% mathematically consistent output. Ideal for manual tone mapping. Values: |
VeraLux sensor profileProcessingveralux_sensor_profile | text or listDefault | VeraLux sensor profile selection. Defines the Luminance coefficients (Weights) used for the stretch. Values: |
Target Bg:Processingveralux_target_bgSetting name: VeraLux target background | number0.2 | Target background median (0.05-0.50). Standard is 0.20. |
Adaptive AnchorProcessingveralux_adaptive_anchorSetting name: VeraLux adaptive anchors | checkboxchecked | Analyzes histogram shape to find true signal start. Recommended for images with gradients. |
Auto-Calc Log DProcessingveralux_auto_calc_DSetting name: VeraLux auto calculate D | checkboxunchecked | Analyzes image to find optimal Stretch Factor (Log D). |
Log D:Processingveralux_D_valueSetting name: VeraLux D value | number2 | Hyperbolic Intensity (Log D, 0.1-15). Controls the strength of the stretch. |
Protect b:Processingveralux_b_valueSetting name: VeraLux b value | number6 | Highlight Protection. Controls the 'knee of the hyperbolic curve. |
Star Core Recovery:Processingveralux_convergence_powerSetting name: VeraLux convergence power | number3.5 | Controls how quickly saturated colors transition to white (1-10). |
Color Strategy:ProcessingColor imageveralux_color_strategySetting name: VeraLux color strategy | integer0 | Negative: Clean Noise | Center: Balanced | Positive: Soften Highlights. Only for Ready-to-Use mode. Value can be between -100 and 100. |
Color Grip:ProcessingColor imageveralux_color_gripSetting name: VeraLux color grip | number1 | Controls vector color preservation. 1.0 = Pure VeraLux (0-1). Only for Scientific mode. |
Shadow Convergence (Noise) :Processingveralux_shadow_convergenceSetting name: VeraLux shadow convergence | number1 | Damps vector preservation in shadows to prevent color noise (0-3). Only for Scientific mode. |
Stretch adjust shadowsProcessingstretch_adjust_shadows | text or listnone | Select if shadows are adjusted before, after or before and after stretch. Value zero just moves the histogram to the left without clipping any pixels. Values: |
Stretch adjust shadows percProcessingstretch_adjust_shadows_percShown in the dialog as: % | number0 | Percentage of shadows adjustment. Value zero just moves the histogram to the left without clipping any pixels. |
Histogram stretch typeProcessinghistogram_stretch_type | text or listMedian | Target type specifies what value calculated from histogram is tried to get close to Target value. Values: |
Histogram stretch targetProcessinghistogram_stretch_targetShown in the dialog as: Target value | integer0.25 | Target value specifies where we try to get the the value calculated using Target type. Usually values between 0.1 and 0.250 work best. Possible values are between 0 and 1. For very bright objects like galaxies you should try with 0.1 while more uniform objects like large nebulas or dust you should try with 0.25. |
Logarithmic stretch targetProcessingother_stretch_targetShown in the dialog as: Target value | integer0.25 | Target value specifies where we try to get the the histogram median value. Usually values between 0.1 and 0.250 work best. Possible values are between 0 and 1. For very bright objects like galaxies you should try with 0.1 while more uniform objects like large nebulas or dust you should try with 0.25. |
When noise reduction is applied and the settings of each noise reduction tool.
| Option | Type / default | Description |
|---|---|---|
GraXpert denoiseProcessingExternal tooluse_graxpert_denoiseSetting name: Use GraXpert denoise | checkboxunchecked | Use GraXpert for noise reduction. In the Tools / GraXpert section it is possible to set some settings. NOTE! A path to GraXpert file must be set in the Tools / GraXpert section before it can be used. NOTE2! You need to manually start GraXpert once to ensure that the correct AI model is loaded into your computer. |
No noise reductionProcessingskip_noise_reduction | checkboxunchecked | Do not use noise reduction. This option disables all noise reduction regardless of what other noise reduction settings are selected. More fine grained noise reduction settings can be found in the Postprocessing / Noise reduction section. |
No star noise reductionProcessingskip_star_noise_reduction | checkboxunchecked | Do not use star noise reduction. Star noise reduction is used when stars are removed from image. |
DenoiseProcessingExternal toolnxt_denoiseSetting name: NoiseXTerminator denoise | number0.9 | Amount of noise reduction. |
IterationsProcessingExternal toolnxt_iterationsSetting name: NoiseXTerminator iterations | integer2 | Number of iterations for noise reduction. |
Intensity/color separationProcessingExternal toolnxt_enable_color_separationSetting name: NoiseXTerminator enable color separation | checkboxunchecked | Enable separate intensity and color noise reduction. |
IntensityProcessingExternal toolnxt_denoise_intensitySetting name: NoiseXTerminator denoise intensity | number0.9 | Amount of high frequency intensity noise to remove. |
ColorProcessingExternal toolnxt_denoise_colorSetting name: NoiseXTerminator denoise color | number0.9 | Amount of color noise to remove. |
Frequency separationProcessingExternal toolnxt_enable_frequency_separationSetting name: NoiseXTerminator enable frequency separation | checkboxunchecked | Enable separate low and high frequency noise reduction. |
NoiseXTerminator denoise LFProcessingExternal toolnxt_denoise_lfShown in the dialog as: LF | number0.9 | Amount of low frequency noise to remove. |
NoiseXTerminator denoise HFProcessingExternal toolnxt_denoise_hfShown in the dialog as: HF | number0.9 | Amount of high frequency noise to remove. |
HF/LF Scale (pixels)ProcessingExternal toolnxt_frequency_scaleSetting name: NoiseXTerminator frequency scale | number5 | Pixel scale for transition between HF and LF noise reduction. |
Tile OverlapProcessingExternal toolnxt_tile_overlapSetting name: NoiseXTerminator tile overlap | number0.2 | Amount of tile overlap for noise reduction. |
AmountProcessingExternal tooldeepsnr_amountSetting name: DeepSNR amount | number0.8 | Amount of noise reduction. |
NoiseXTerminatorProcessingExternal tooluse_noisexterminatorSetting name: Use NoiseXTerminator | checkboxunchecked | Use NoiseXTerminator for noise reduction. You can change noise reduction settings in the Postprocessing / Noise reduction section. |
DeepSNRProcessingExternal tooluse_deepsnrSetting name: Use DeepSNR | checkboxunchecked | Use DeepSNR for noise reduction. Note that with DeepSNR increasing the noise reduction strength value will decrease the noise reduction. |
AutoProcessingauto_noise_reductionSetting name: Auto noise reduction | checkboxchecked | Select automatically correct time for noise reduction. If BlurXTerminator is used, then processed linear image noise reduction is used. Otherwise channel noise reduction is used except for OSC/color images where processed linear image is used. |
Channel imageProcessingMono / LRGBchannel_noise_reductionSetting name: Channel noise reduction | checkboxunchecked | Do noise reduction on each color channels and luminance image separately. This option does nothing with color/OSC images. |
Non-linear imageProcessingnon_linear_noise_reductionSetting name: Non-linear noise reduction | checkboxunchecked | Do noise reduction in non-linear state after stretching on combined and luminance images. |
Noise reduction strengthProcessingnoise_reduction_strength | integer3 | Noise reduction strength for color channel (R,G,B,H,S,O) or color images. With MultiscaleLinerTransform the strength between 3 and 5 is the number of layers used to reduce noise. Strength values 1 and 2 are very mild three layer noise reductions and strength 6 is very aggressive five layer noise reduction. Values: |
Noise reduction strength on luminance imageProcessingMono / LRGBluminance_noise_reduction_strength | integer3 | Noise reduction strength for luminance image. With MultiscaleLinerTransform the strength between 3 and 5 is the number of layers used to reduce noise. Strength values 1 and 2 are very mild three layer noise reductions and strength 6 is very aggressive five layer noise reduction. Values: |
Combined imageProcessingcombined_image_noise_reductionSetting name: Do noise reduction on integrated image | checkboxunchecked | Do noise reduction on combined image. Image can be from channel combination or from integrated color/OSC image. On L image noise reduction is done before processing which is the same as channel noise reduction. |
Processed linear imageProcessingprocessed_image_noise_reductionSetting name: Do noise reduction on processed image | checkboxunchecked | Do noise reduction on processed RGB image and possible luminance image in linear stage. |
Color noise reductionProcessingColor imageuse_color_noise_reduction | checkboxunchecked | Do color noise reduction using TGVDenoise. |
ACDNR noise reduction,Processinguse_ACDNR_noise_reductionSetting name: Use ACDNR noise reduction | checkboxchecked | Runs ACDNR noise reduction. |
StdDevProcessingACDNR_noise_reductionSetting name: ACDNR noise reduction | number1 | If non-zero, sets StdDev value and runs ACDNR noise reduction. A mild ACDNR noise reduction with StdDev value between 1.0 and 2.0 can be useful to smooth image and reduce black spots left from previous noise reduction. |
Denoise smoothingProcessingExternal toolgraxpert_denoise_strengthSetting name: GraXpert denoise strength | number0.5 | Strength for GraXpert denoise. |
GraXpert denoise batch sizeProcessingExternal toolgraxpert_denoise_batch_size | text or list4 | Batch size for GraXpert denoise. Values: |
BlurXTerminator, GraXpert deconvolution and generic sharpening.
| Option | Type / default | Description |
|---|---|---|
GraXpert deconvolutionProcessingExternal tooluse_graxpert_deconvolutionSetting name: Use GraXpert deconvolution | checkboxunchecked | Use GraXpert deconvolution for stellar and non-stellar sharpening. In the Tools / GraXpert section it is possible to set some settings. NOTE! A path to GraXpert file must be set in the Tools / GraXpert section before it can be used. NOTE2! You need to manually start GraXpert once to ensure that the correct AI model is loaded into your computer. |
No sharpeningProcessingskip_sharpening | checkboxunchecked | Do not use sharpening on the image. Sharpening uses a luminance and star mask to target light parts of the image. |
BlurXTerminatorProcessingExternal tooluse_blurxterminatorSetting name: Use BlurXTerminator | checkboxunchecked | Use BlurXTerminator for sharpening and deconvolution. BlurXTerminator is applied on the linear image just before it is stretched to non-linear. Enhancements option for sharpening can be used to apply BlurXTerminator on non-linear image. Some options for BlurXTerminator can be adjusted in the Tools / BlurXTerminator section. When using BlurXTerminator it is recommended to do noise reduction after BluxXTerminator by checking option Combined image noise reduction or Non-linear noise reduction. But it is always good to experiment what is best for your own data. Sometimes on starless images PSF value can not be calculated. Then a manual value should be given or BlurXTerminator should not be used. |
Sharpen starsProcessingExternal toolbxt_sharpen_starsSetting name: BlurXTerminator sharpen stars | number0.25 | Amount to reduce the diameter of stars. Use a value between 0.00 and 0.50. |
Adjust star halosProcessingExternal toolbxt_adjust_haloSetting name: BlurXTerminator adjust halos | number0 | Amount to adjust star halos. Use a value between -0.50 and 0.50. |
Sharpen nonstellarProcessingExternal toolbxt_sharpen_nonstellarSetting name: BlurXTerminator sharpen nonstellar | number0.9 | The amount to sharpen non-stellar image features. Use a value between 0.00 and 1.00. |
PSFProcessingExternal toolbxt_psfSetting name: BlurXTerminator PSF | number0 | Manual PSF value if a non-zero value is given. |
Get PSF from imageProcessingExternal toolbxt_image_psfSetting name: BlurXTerminator image PSF | checkboxunchecked | Get PSF value from image using FWHM. Sometimes on starless images PSF value can not be calculated. Then a manual value should be given or BlurXTerminator should not be used. |
Use median PSFProcessingExternal toolbxt_median_psfSetting name: BlurXTerminator median PSF | checkboxunchecked | Use median FWHM from subframe selector as PSF value. It can be useful when PSF cannot be calculated from the image. Value is saved to the FITS header and used if available. Value is also printed to the AutoIntegrate.log file with a name AutoIntegrateMEDFWHM. Sometimes on starless images PSF value can not be calculated. Then a manual value should be given or BlurXTerminator should not be used. |
Correct only before CCProcessingExternal toolbxt_correct_only_before_ccSetting name: BlurXTerminator correct only before CC | checkboxunchecked | Run BlurXTerminator in correct only mode before color calibration. |
Correct only on channel imagesProcessingMono / LRGBExternal toolbxt_correct_channelsSetting name: BlurXTerminator correct only channels | checkboxunchecked | Run BlurXTerminator in correct only mode on channel images. |
Deconvolution stars strengthProcessingExternal toolgraxpert_deconvolution_stellar_strengthSetting name: GraXpert deconvolution stellar strength | number0.5 | Strength for GraXpert stars deconvolution. GraXpert deconvolution is used for stellar and non-stellar sharpening. |
Stars FWHMProcessingExternal toolgraxpert_deconvolution_stellar_psfSetting name: GraXpert deconvolution stellar PSF | number2 | FWHM in pixels for GraXpert stars deconvolution. GraXpert deconvolution is used for stellar and non-stellar sharpening. |
Deconvolution object strengthProcessingExternal toolgraxpert_deconvolution_nonstellar_strengthSetting name: GraXpert deconvolution nonstellar strength | number0.5 | Strength for GraXpert object deconvolution. GraXpert deconvolution is used for stellar and non-stellar sharpening. |
Object FWHMProcessingExternal toolgraxpert_deconvolution_nonstellar_psfSetting name: GraXpert deconvolution nonstellar PSF | number2 | FWHM in pixels for GraXpert object deconvolution. GraXpert deconvolution is used for stellar and non-stellar sharpening. |
Use median FWHMProcessingExternal toolgraxpert_median_psfSetting name: GraXpert median PSF | checkboxchecked | Use median FWHM from subframe selector as FWHM value. Value is saved to the FITS header and used if available. Value is also printed to the AutoIntegrate.log file with a name AutoIntegrateMEDFWHM. |
Removing stars, creating separate star images and the masks used in processing.
| Option | Type / default | Description |
|---|---|---|
No added contrast on maskProcessingskip_mask_contrastSetting name: No mask contrast | checkboxunchecked | Do not add contrast on automatically created luminance mask. |
New maskProcessingforce_new_maskSetting name: Force new mask | checkboxunchecked | Do not use an existing mask but always create a new mask. |
Unscreen starsProcessingunscreen_stars | checkboxchecked | Use unscreen method to get stars image as described by Russell Croman. Unscreen method usually keeps star colors more correct than simple star removal. It is recommended to use Screen method when combining star and starless images back together. |
StarXTerminatorProcessingExternal tooluse_starxterminatorSetting name: Use StarXTerminator | checkboxunchecked | Use StarXTerminator to remove stars from an image. You can change some StarXTerminator settings in the Tools / StarXTerminator section. |
StarNet2ProcessingExternal tooluse_starnet2Setting name: Use StarNet2 | checkboxunchecked | Use StarNet2 to remove stars from an image. |
Remove stars before stretchProcessingremove_stars_before_stretchSetting name: Remove stars early | checkboxunchecked | Remove stars from combined RGB or narrowband images just before stretching while it still is in the linear stage. Stars are used only from RGB image, stars from L image are not used. This needs StarXTerminator. When stars are removed before stretching then a different stretching can be used for the stars and potentially get better star colors. For OSC data this may not work well. Separating channels might help. Choose star image stretching and combining settings from Postprocessing / Star stretching and removing section. |
Remove stars from lightsProcessingremove_stars_lightSetting name: Remove stars light | checkboxunchecked | Remove stars from light image. Stars are removed after after star alignment. If comet alignment is chosen then stars are removed before comet align. |
Remove stars from channelsProcessingMono / LRGBremove_stars_channelSetting name: Remove stars channel | checkboxunchecked | With LRGB or narrowband images remove stars from L, R, G, B, H, S and O channel images separately after image integration. while images are still in the linear stage. Star images are then combined to create a RGB star image. This needs StarXTerminator. With color images (DSLR/OSC) remove stars after image integration while image is still in linear stage. This needs StarXTerminator. Choose star image stretching and combining settings from Postprocessing / Star stretching and removing section. |
Remove stars after stretchProcessingremove_stars_stretchedSetting name: Remove stars stretched | checkboxunchecked | Remove stars after the image has been stretched to a non-linear state. Start from RGB image are saved and they can be later added back to the image. This needs StarXTerminator. Choose star image stretching and combining settings from Postprocessing / Star stretching and removing section. |
RGB starsProcessingColor imagecreate_RGB_stars | checkboxunchecked | When both RGB and narrowband data is available, process stars image from RGB channels and process background image from the narrowband data. In the end of processing starless and stars images are combined to create a narrowband image with RGB stars. This option can be used for RGB only processing but the end result is basically the same as using separate remove stars options.To use this option RGB channels must be available. If no option to remove stars is selected, stars are removed before streching. |
StarXTerminator AI modelProcessingExternal toolstarxterminator_ai_model | text or list— | Select AI model for AI model Use the selected AI model. Default AI model is undefined AI models are stored in the PixInsight installation directory and have a .pb extension. At least in Windows they are in PixInsight/library directory. |
Large overlapProcessingExternal toolstarxterminator_large_overlapSetting name: StarXTerminator large overlap | checkboxunchecked | Uses large overlap on tiles to avoid tiling artifacts |
Stars stretchingProcessingstars_stretching | text or listArcsinh Stretch |
Select how image is stretched from linear to non-linear. For galaxies and other small but bright objects you should adjust targetBackground in Postprocessing / AutoSTF settings section to a smaller value, like 0.10 Parameters are set in Postprocessing / AutoSTF settings section. You can adjust settings in Postprocessing / MultiscaleAdaptiveStretch section. Useful when AutoSTF generates too bright images, like on some galaxies. Parameters are set in Postprocessing / Masked stretch settings section VeraLuxHMS can work well on many targets and can create saturated results. Parameters are set in Postprocessing / VeraLux HMS Stretch section Prestretch help with stars that can be too pointlike with Masked Stretch. Parameters are set in Postprocessing / Masked stretch settings and Postprocessing / Histogram stretching settings sections Parameters are set in Postprocessing / Histogram stretching settings section Can be useful when stretching stars to keep good star color. Parameters are set in Postprocessing / Arcsinh stretch settings sectionThere are also some experimental stretches.
Note that when non-default Target type is selected then this option is disabled. Values: |
Stars combineProcessingstars_combine | text or listScreen | Select how to combine star and starless image. Possible combine operations are:
Values: |
Narrowband channel mapping, palettes and multiple mappings.
| Option | Type / default | Description |
|---|---|---|
Narrowband mappingProcessingNarrowbandnarrowband_mapping | text or listAuto | List of predefined color palettes. You can also edit mapping input boxes to create your own mapping. Dynamic palettes are the same as Foraxx options in Enhancements / Narrowband enhancements section. With Dynamic palettes the script automatically uses non-linear data>. |
Narrowband R mappingProcessingNarrowbandcustom_R_mapping | text or listAuto | Mapping for R channel. Use one of the predefined mappings or edit and create your own mapping. Color palette used to map SII, Ha and OIII to R, G and B There is a list of predefined mapping that can be used, some examples are below. For more details see the tooltip for palette combo box. SHO - SII=R, Ha=G, OIII=B (Hubble) HOS - Ha=R, OIII=G, SII=B (CFHT) HOO - Ha=R, OIII=G, OIII=B (if there is SII it is ignored) Mapping formulas are editable and other palettes can use any combination of channel images. Special keywords H, S, O, R, G and B are recognized and replaced with corresponding channel image names. Otherwise these formulas are passed directly to the PixelMath process. Option All runs all narrowband palettes in a batch mode and creates images with names Auto_+palette-name. You can use enhancements options, then also images with name Auto_+palette-name+_enh are created. Images are saved as .xisf files. Use Save batch result files buttons to save them all in a different format. To use All option all HSO filters must be available. Values: |
Narrowband G mappingProcessingNarrowbandcustom_G_mapping | text or listAuto | Mapping for G channel. Use one of the predefined mappings or edit and create your own mapping. Color palette used to map SII, Ha and OIII to R, G and B There is a list of predefined mapping that can be used, some examples are below. For more details see the tooltip for palette combo box. SHO - SII=R, Ha=G, OIII=B (Hubble) HOS - Ha=R, OIII=G, SII=B (CFHT) HOO - Ha=R, OIII=G, OIII=B (if there is SII it is ignored) Mapping formulas are editable and other palettes can use any combination of channel images. Special keywords H, S, O, R, G and B are recognized and replaced with corresponding channel image names. Otherwise these formulas are passed directly to the PixelMath process. Option All runs all narrowband palettes in a batch mode and creates images with names Auto_+palette-name. You can use enhancements options, then also images with name Auto_+palette-name+_enh are created. Images are saved as .xisf files. Use Save batch result files buttons to save them all in a different format. To use All option all HSO filters must be available. Values: |
Narrowband B mappingProcessingNarrowbandcustom_B_mapping | text or listAuto | Mapping for B channel. Use one of the predefined mappings or edit and create your own mapping. Color palette used to map SII, Ha and OIII to R, G and B There is a list of predefined mapping that can be used, some examples are below. For more details see the tooltip for palette combo box. SHO - SII=R, Ha=G, OIII=B (Hubble) HOS - Ha=R, OIII=G, SII=B (CFHT) HOO - Ha=R, OIII=G, OIII=B (if there is SII it is ignored) Mapping formulas are editable and other palettes can use any combination of channel images. Special keywords H, S, O, R, G and B are recognized and replaced with corresponding channel image names. Otherwise these formulas are passed directly to the PixelMath process. Option All runs all narrowband palettes in a batch mode and creates images with names Auto_+palette-name. You can use enhancements options, then also images with name Auto_+palette-name+_enh are created. Images are saved as .xisf files. Use Save batch result files buttons to save them all in a different format. To use All option all HSO filters must be available. Values: |
Narrowband L mappingProcessingNarrowbandMono / LRGBcustom_L_mapping | text or listAuto | Mapping of Luminance channel with narrowband data if both RGB and narrowband data are available. With empty text no mapping is done. Values: |
Narrowband linear fitProcessingNarrowbandnarrowband_linear_fit | text or listAuto | Linear fit setting before running PixelMath to combine narrowband channel. Auto does not use linear if Auto STF or Histogram stretch is used for stretching. Otherwise it uses Min. Min does linear fit using the channel with minimum median value as the reference image. Max does linear fit using the channel with maximum median value as the reference image. When a channel is selected it uses that channel as the the reference image.Other selections use linear fit with that channel image as the reference image. Values: |
Narrowband mapping using non-linear dataProcessingNarrowbandmapping_on_nonlinear_dataSetting name: Narrowband mapping on non-linear data | checkboxunchecked | Do narrowband mapping using non-linear data. Before running PixelMath, images are stretched to non-linear state. |
Force narrowband mappingProcessingNarrowbandforce_narrowband_mapping | checkboxunchecked | Force narrowband mapping using formulas given in Settings / Narrowband processing section. |
Use multiple mappingsProcessingNarrowbanduse_narrowband_multiple_mappingsSetting name: Use narrowband multiple mappings | checkboxunchecked | Use multiple narrowband mappings. |
Narrowband multiple mappings listProcessingNarrowbandnarrowband_multiple_mappings_list | text or list— | List of narrowband palettes that are processed when the multiple mappings option is used. The list is filled from the palette selection dialog. |
Adding narrowband Ha data into an RGB or OSC image.
| Option | Type / default | Description |
|---|---|---|
Use Ha RGB mappingProcessingNarrowbanduse_RGBHa_MappingSetting name: Ha RGB mapping | checkboxunchecked | A special processing is used to add Ha to the RGB image. If Ha to RGB mapping is used then a narrowband color palette is not used. Some good combinations are:
|
Ha RGB mapping presetProcessingNarrowbandRGBHa_preset | text or listCombine Continuum Subtract | Some useful combinations to try. A special processing is used to add Ha to the RGB image. If Ha to RGB mapping is used then a narrowband color palette is not used. Some good combinations are:
Values: |
Ha RGB mapping prepare methodProcessingNarrowbandRGBHa_prepare_method | text or listContinuum Subtract | A special processing is used to add Ha to the RGB image. If Ha to RGB mapping is used then a narrowband color palette is not used. Some good combinations are:
Values: |
Ha RGB mapping combine timeProcessingNarrowbandRGBHa_combine_time | text or listStretched | A special processing is used to add Ha to the RGB image. If Ha to RGB mapping is used then a narrowband color palette is not used. Some good combinations are:
Values: |
Ha RGB mapping combine methodProcessingNarrowbandRGBHa_combine_method | text or listBright structure add | A special processing is used to add Ha to the RGB image. If Ha to RGB mapping is used then a narrowband color palette is not used. Some good combinations are:
Values: |
Noise reduction,ProcessingNarrowbandRGBHa_noise_reductionSetting name: Ha RGB mapping noise reduction | checkboxchecked | Do noise reduction on Ha image after mapping. |
Continuum boostProcessingNarrowbandRGBHa_boostSetting name: Ha RGB boost | number1 | Boost value for continuum subtracted image using ExponentialTransformation. |
Gradient correctionProcessingNarrowbandRGBHa_gradient_correctionSetting name: Ha RGB mapping gradient correction | checkboxunchecked | Do gradient correction on Ha image before mapping. |
SmoothenProcessingNarrowbandRGBHa_smoothen_backgroundSetting name: Ha RGB mapping smoothen background | checkboxunchecked | Smoothen background which may help with gradient correction. It may sometimes help with extreme cases for example when using ABE. Select a percentage value below which smoothing is done. Usually values below 50 work best. Possible values are between 0 and 100. |
valueProcessingNarrowbandRGBHa_smoothen_background_valueSetting name: Ha RGB mapping smoothen background value | number25 | Smoothen background which may help with gradient correction. It may sometimes help with extreme cases for example when using ABE. Select a percentage value below which smoothing is done. Usually values below 50 work best. Possible values are between 0 and 100. |
Remove starsProcessingNarrowbandRGBHa_remove_starsSetting name: Ha RGB mapping remove stars | checkboxunchecked | Remove stars before combining Ha to RGB. |
CombineProcessingNarrowbandRGBHa_Combine_BoostFactorSetting name: Ha RGB mapping combine boost factor | number1 | Boost, or multiplication factor, for combining R and Ha. A bigger value will make the mapping more visible by increasing the amount of Ha. This value is used with all other methods except Add. |
AddProcessingNarrowbandRGBHa_Add_BoostFactorSetting name: Ha RGB mapping SPCC boost factor | number0.5 | Boost, or multiplication factor, for Ha channel with Add method. For R channel a value 1-Boost will be used. Note that Add method really works well only with SPCC color calibration. |
Boosting an RGB image with narrowband channels using filter bandwidths.
| Option | Type / default | Description |
|---|---|---|
Use Narrowband RGB mappingProcessingNarrowbanduse_RGBNB_MappingSetting name: Narrowband RGB mapping | checkboxunchecked | A special processing is used for narrowband to (L)RGB image mapping. It is used to enhance (L)RGB channels with narrowband data. This mapping cannot be used without RGB filters. This mapping is similar to NBRGBCombination script in PixInsight or as described in Light Vortex Astronomy tutorial Combining LRGB with Narrowband. You can find more details on parameters from those sources. If narrowband RGB mapping is used then narrowband Color palette is not used. With narrowband RGB mapping you can choose:
If there is no Luminance channel available then selections for L channel are ignored. The following steps are done:
|
Use RGB imageProcessingNarrowbandRGBNB_use_RGB_imageSetting name: Narrowband RGB mapping use RGB | checkboxunchecked | Use RGB image for bandwidth mapping instead of separate R, G and B channel images. R channel bandwidth is then used for the RGB image. |
Gradient correctionProcessingNarrowbandRGBNB_gradient_correctionSetting name: Narrowband RGB mapping gradient correction | checkboxunchecked | Do gradient correction on narrowband image before mapping. |
Linear fitProcessingNarrowbandRGBNB_linear_fitSetting name: Narrowband RGB mapping linear fit | checkboxunchecked | Do linear fit on narrowband image before mapping. Not used with Add option. |
Narrowband RGB mapping for LProcessingNarrowbandRGBNB_L_mapping | text or list— | Mapping of narrowband channel to L channel. If there is no L channel available then this setting is ignored. Values: |
Narrowband RGB mapping for RProcessingNarrowbandRGBNB_R_mapping | text or listH | Mapping of narrowband channel to R channel. If no mapping is selected then channel is left unchanged. Values: |
Narrowband RGB mapping for GProcessingNarrowbandRGBNB_G_mapping | text or list— | Mapping of narrowband channel to G channel. If no mapping is selected then channel is left unchanged. Values: |
Narrowband RGB mapping for BProcessingNarrowbandRGBNB_B_mapping | text or list— | Mapping of narrowband channel to G channel. If no mapping is selected then channel is left unchanged. Values: |
Narrowband RGB mapping L boost factorProcessingNarrowbandRGBNB_L_BoostFactorShown in the dialog as: L | number1.2 | Boost, or multiplication factor, for the L channel. A bigger value will make the mapping more visible. |
Narrowband RGB mapping R boost factorProcessingNarrowbandRGBNB_R_BoostFactorShown in the dialog as: R | number1.2 | Boost, or multiplication factor, for the R channel. A bigger value will make the mapping more visible. |
Narrowband RGB mapping G boost factorProcessingNarrowbandRGBNB_G_BoostFactorShown in the dialog as: G | number1.2 | Boost, or multiplication factor, for the G channel. A bigger value will make the mapping more visible. |
Narrowband RGB mapping B boost factorProcessingNarrowbandRGBNB_B_BoostFactorShown in the dialog as: B | number1.2 | Boost, or multiplication factor, for the B channel. A bigger value will make the mapping more visible. |
Narrowband RGB mapping L bandwidthProcessingNarrowbandRGBNB_L_bandwidthShown in the dialog as: L | number300 | Bandwidth (nm) for the L filter. To make changes more visible you can lower the RGB bandwidths to something like 40 or 60. |
Narrowband RGB mapping R bandwidthProcessingNarrowbandRGBNB_R_bandwidthShown in the dialog as: R | number100 | Bandwidth (nm) for the R filter. To make changes more visible you can lower the RGB bandwidths to something like 40 or 60. |
Narrowband RGB mapping G bandwidthProcessingNarrowbandRGBNB_G_bandwidthShown in the dialog as: G | number100 | Bandwidth (nm) for the G filter. To make changes more visible you can lower the RGB bandwidths to something like 40 or 60. |
Narrowband RGB mapping B bandwidthProcessingNarrowbandRGBNB_B_bandwidthShown in the dialog as: B | number100 | Bandwidth (nm) for the B filter. To make changes more visible you can lower the RGB bandwidths to something like 40 or 60. |
Narrowband RGB mapping H bandwidthProcessingNarrowbandRGBNB_H_bandwidthShown in the dialog as: H | number3 | Bandwidth (nm) for the H filter. Typical values could be 7 nm or 3 nm. To make changes more visible you can lower the RGB bandwidths to something like 40 or 60. |
Narrowband RGB mapping S bandwidthProcessingNarrowbandRGBNB_S_bandwidthShown in the dialog as: S | number3 | Bandwidth (nm) for the S filter. Typical values could be 8.5 nm or 3 nm. To make changes more visible you can lower the RGB bandwidths to something like 40 or 60. |
Narrowband RGB mapping O bandwidthProcessingNarrowbandRGBNB_O_bandwidthShown in the dialog as: O | number3 | Bandwidth (nm) for the O filter. Typical values could be 8.5 nm or 3 nm. To make changes more visible you can lower the RGB bandwidths to something like 40 or 60. |
Combining luminance with color and adjusting color during the main workflow.
| Option | Type / default | Description |
|---|---|---|
No SCNRProcessingColor imageskip_SCNR | checkboxunchecked | Do not use SCNR to remove green cast. SCNR is automatically skipped when processing narrowband images. Skipping SCNR can be useful when processing for example comet images. |
Linear fitProcessingColor imageuse_linear_fit | text or listAuto | Choose how to do linear fit of RGB images. Linear fit is done only on RGB channels. For narrowband images linear fit settings are in the Settings / Narrowband processing section.
Values: |
RGB channel linkingProcessingColor imageSTF_linking | text or listAuto | RGB channel linking in image stretching. Auto option uses the following defaults:
Values: |
LightnessProcessingColor imageMono / LRGBLRGBCombination_lightnessSetting name: LRGBCombination lightness | number0.5 | LRGBCombination lightness setting. A smaller value gives a brighter image. Usually should be left to the default value. |
SaturationProcessingColor imageMono / LRGBLRGBCombination_saturationSetting name: LRGBCombination saturation | number0.5 | LRGBCombination saturation setting. A smaller value gives a more saturated image. Usually should be left to the default value. |
Linear fitProcessingColor imageMono / LRGBLRGBCombination_linearfitSetting name: LRGBCombination linear fit | checkboxunchecked | Do linear fit on luminance using RGB as a reference before LRGBCombination process. |
Linear saturation increaseProcessingColor imagelinear_increase_saturation | integer1 | Saturation increase in linear state using a mask. |
Non-linear saturation increaseProcessingColor imagenon_linear_increase_saturation | integer1 | Saturation increase in non-linear state using a mask. |
Use chrominanceProcessingColor imageMono / LRGBuse_chrominance | checkboxunchecked | Use chrominance instead of saturation to boost colors. |
Which images are saved, in what format, and where they are written.
| Option | Type / default | Description |
|---|---|---|
TIFFInterfacesave_final_image_tiffSetting name: Save final image as TIFF | checkboxunchecked | Automatically save the final image also as a 16-bit TIFF image. By default the final image is automatically saved only in XISF format. |
JPGInterfacesave_final_image_jpgSetting name: Save final image as JPG | checkboxunchecked | Automatically save the final image also as a JPG image. By default the final image is automatically saved only in XISF format. |
qualityInterfacesave_final_image_jpg_qualitySetting name: Save final image as JPG quality | integer80 | Quality of the JPG image. |
Save all filesInterfacesave_all_files | checkboxunchecked | If selected save buttons will save all processed and iconized files and not just final image files. |
Save processed channel imagesInterfaceMono / LRGBsave_processed_channel_images | checkboxunchecked | For mono RGB images, channel images are saved before channel combination. For mono narrowband images, channel images are saved before RGB mapping. |
Save stretched starless channel imagesInterfaceMono / LRGBsave_stretched_starless_channel_imagesSetting name: Save starless channel images | checkboxunchecked | Save stretched starless channel images. Images are saved as .xisf and .tif files. These can be used for example for narrowband color mapping in Photoshop. For a great example see Utah Desert Remote Observatories YouTube channel. For mono RGB images, channel images are saved before channel combination. For mono narrowband images, channel images are saved before RGB mapping. For OSC/color images, channel images are extracted and saved before stretching. When using this options is is often useful to select Gradient correction on channel images in Settings tab, Noise reduction on Channel image in Postprocessing tab and BlurXTerminator option Correct only on channel images in Postprocessing tab. |
Auto contrast on channel imagesProcessingMono / LRGBstretched_channel_auto_contrastSetting name: Stretched channel auto contrast | checkboxunchecked | Run auto contrast on stretched channel images. |
No subdirectoriesInterfaceno_subdirs | checkboxunchecked | If selected output files are not written into subdirectories |
Keep integrated imagesInterfacekeep_integrated_images | checkboxunchecked | Keep integrated images when closing all windows |
Keep temporary imagesInterfacekeep_temporary_images | checkboxunchecked | Keep temporary images created while processing and do not close them. They will have tmp_ prefix. |
Keep processed imagesInterfacekeep_processed_images | checkboxunchecked | Keep processed images after every step a PixInsight process is applied to them. They will have process name prefix. Only images after image integration are kept. Images are not saved to disk. |
Use unique file namesInterfaceunique_file_namesSetting name: Unique file names | checkboxunchecked | Use unique file names by adding a timestamp when saving to disk. |
Add window prefix to log filesInterfacewin_prefix_to_log_files | checkboxunchecked | Add window prefix to AutoIntegrate.log and AutoContinue.log files. |
Generate .xdrz filesInterfacegenerate_xdrz | checkboxunchecked | Generate .xdrz files even if Drizzle integration is not used. It is useful if you want to try Drizzle integration later with Start from ImageIntegration option. |
Save cropped imagesInterfacesave_cropped_images | checkboxunchecked | Save cropped image files with _crop postfix. |
Running only a part of the workflow, and batch, fast and substack modes.
| Option | Type / default | Description |
|---|---|---|
Calibrate onlyProcessingcalibrate_only | checkboxunchecked | Stop after image calibration step. Stopping after calibration could be useful if you for example want to check the quality of calibrated light files and maybe set some filtering rules. |
Generate masters onlyProcessinggenerate_masters_onlySetting name: Generate master calibration files only | checkboxunchecked | Generate master calibration files (bias, dark, flat dark, flat) from calibration files without requiring light files. This is useful for remote telescopes where calibration files do not change often. Generated master files can later be reused with the Master files option to speed up light file processing. |
Early PSF checkProcessingearly_PSF_check | checkboxunchecked | Checking this box will enable early PSF signal test. Then light files are filtered for PSF signal values below weight limit before any processing. Weight limit is set in Preprocessing / Filtering section. |
Debayer onlyProcessingColor imageOSC / RAWdebayer_only | checkboxunchecked | Stop after Debayering step. Later it is possible to continue by selecting Debayered files and choosing None for Debayer. |
Binning onlyProcessingbinning_only | checkboxunchecked | Run only binning to create smaller files. |
Extract channels onlyProcessingColor imageOSC / RAWextract_channels_only | checkboxunchecked | Stop after Extract channels step. Later it is possible to continue by selecting extracted files and run a normal mono camera (LRGB/HSO) workflow. |
Integrate onlyProcessingintegrate_only | checkboxunchecked | Run only image integration to create integrated channel images or RGB image. Stopping after integration could be useful is you for example want to set some exclusions areas for DBE or for finding the true background. |
ChannelCombination onlyProcessingMono / LRGBchannelcombination_only | checkboxunchecked | Run only channel combination to linear RGB file. No auto stretch or color calibration. |
Crop info onlyProcessingcropinfo_only | checkboxunchecked | Run only image integration on *_r.xisf files to create automatic cropping info. Light file list should include all registered *_r.xisf files. The result will be LowRejectionMap_ALL.xisf file that can be used to crop files to common area during AutoContinue. |
RRGB imageProcessingColor imageMono / LRGBRRGB_imageSetting name: RRGB | checkboxunchecked | RRGB image using R as Luminance. |
Batch/mosaic modeProcessingbatch_modeSetting name: Batch mode | checkboxunchecked | Run in batch mode, continue until all selected files are processed. In batch mode, just click the Run button and the script will ask for files to process before starting. Batch mode is intended for processing mosaic panels. When batch mode completes only final image windows are left visible. Final images are renamed using the subdirectory name. It is recommended that each part of the batch is stored in a separate directory (like for example P1, P2, etc.). Batch mode works only with calibrated light images. |
Fast modeProcessingfast_mode | checkboxunchecked | Run in fast mode where images are downsampled to a smaller size and only 10% or minimum of 3 images are used. With full processing, all light and possibly calibration images are downsampled. With AutoContinue, all integrated images (Integration_[LRGBHSO]) are downsampled. For other AutoContinue starting points the fast mode is ignored. Fast mode can be useful to do a quick overview of processing before committing to full processing. |
Fast mode optProcessingfast_mode_opt | text or listS | S uses smaller images, M uses bigger images. Values: |
Substack,Processingsubstack_modeSetting name: Substack mode | checkboxunchecked | Divide light files into Number of substacks substacks and stack them separately. Stacked files are named as Stack_num_Integration_RGB. When this option is enabled only image integration is done and final images are not generated. The idea is to use substacks to generate the final image. Note that this works only with color (OSC) files but no checks for that are done. |
Substack countProcessingsubstack_count | integer10 | Number of substacks. |
Force monochromeProcessingMono / LRGBmonochrome_imageSetting name: Monochrome | checkboxunchecked | Force creation of a monochrome image. All images are treated as Luminance files and stacked together. Quite a few processing steps are skipped with this option. |
Synthetic L imageProcessingMono / LRGBsynthetic_l_imageSetting name: Synthetic L | checkboxunchecked | Create synthetic L image from all light images. |
Synthetic missing imageProcessingMono / LRGBsynthetic_missing_images | checkboxunchecked | Create synthetic image for any missing image. |
Start from ImageIntegrationProcessingstart_from_imageintegration | checkboxunchecked | Start processing from ImageIntegration. File list should include star aligned files (*_r.xisf). This option can be useful for testing different processing like Local Normalization or Drizzle (if Generate .xdrz files is selected). This is also useful if there is a need to manually remove bad files after alignment. This option is also useful when doing comet alignment. Then input files should be comet aligned *_ca.xisf files. If filter type is not included in the file keywords it cannot be detected from the file name. In that case filter files must be added manually to the file list. |
Use processed filesProcessinguse_processed_files | checkboxunchecked | When possible use already processed files. This option can be useful when adding files to an already processed set of files. Only files generated before image integration are reused. Option works best with a Json setup file that is saved after processing or with Autosave generated AutosaveSetup.json file because then star alignment reference image and possible defect info is saved. With image calibration it is possible to use previously generated master files by adding already processed master files into calibration file lists. If only one calibration file is present then the script automatically uses it as a master file. |
Options that change only what the script shows or remembers, not the processed image.
| Option | Type / default | Description |
|---|---|---|
Select all filesInterfaceselect_all_files | checkboxunchecked | If selected default file select pattern is all files (*.*) and not image files. |
Create process iconsInterfacecreate_process_icons | checkboxchecked | If selected process icons will be created for all processing steps. |
Windows at end of processingInterfacewindows_at_end | text or listDefault | Select which windows are left on the desktop at the end of processing. Default, info windows and intermediate images are iconized and left on the desktop. Close info windows, close info windows that are only helper images and not part of the actual processing result:
Note that info windows and intermediate images are not always generated. Note also that closed images cannot be reused in AutoContinue. If images are saved on disk they can be opened again before running AutoContinue. Values: |
ResetInterfacereset_on_setup_loadSetting name: Reset on setup load | checkboxchecked | Reset parameters to default values before loading a setup. This ensures that only parameters from the setup file are set and user saved default parameters are not set. Uncheck this option if you want just add parameters from the setup file to the current parameters. |
Get flowchart data before processingInterfacerun_get_flowchart_dataSetting name: Run get flowchart data | checkboxunchecked | Get the full flowchart data before processing when a normal processing is done using the Run button. This makes it possible to follow progress in the complete flowchart if Show Flowchart is checked. If this option is not checked or AutoContinue or batch processing is done, flowchart data is generated during processing. Note that this parameter is not reset or saved to Json file. |
Flowchart show processed imageInterfaceflowchart_background_imageSetting name: Flowchart background image | checkboxchecked | If checked then the current processed image is shown in the flowchart background. Note that this parameter is not reset or saved to Json file. |
Flowchart show processing timeInterfaceflowchart_timeSetting name: Flowchart time | checkboxchecked | If checked then the operation processing time is shown in the flowchart. Note that this parameter is not reset or saved to Json file. |
Flowchart save imageInterfaceflowchart_saveimage | checkboxunchecked | If checked then the flowchart image is saved into AutoProcessed directory after processing is complete. Note that this parameter is not reset or saved to Json file. |
Autosave setupInterfaceautosave_setup | checkboxchecked | Save setup after successful processing into AutosaveSetup.json file. Autosave is done only after the Run command, it is not done after the AutoContinue command. File is saved to the lights file directory, or to the user given output directory. Setup can be later loaded into AutoIntegrate to see the settings or run the setup again possibly with different options. |
DirectoryInterfaceopen_directorySetting name: Open directory | checkboxunchecked | Open directory dialog instead of files dialog. All files that match the file pattern on the right will be added as image files. Files are searched recursively from the selected directory and all subdirectories. Selected directory is used as the default output directory. File pattern can have multiple file types separated by space. |
Directory filesInterfacedirectory_files | text or list*.fits *.fit | File pattern for files that will be added as image files. File pattern can have multiple file types separated by space. |
No blinkInterfaceskip_blink | checkboxunchecked | Disable blinking of files. |
Show FlowchartInterfaceshow_flowchartSetting name: Show flowchart | checkboxchecked | Switch between flowchart and image view if flowchart is available. Can be checked during processing. In that case live updates to the flowchart are shown. If Flowchart setting Get flowchart data before processing is checked then the live flowchart view uses full processing flowchart. Note that this parameter is not reset or saved to Json file. |
AutoSTFInterfacepreview_autostfSetting name: Preview AutoSTF | checkboxchecked | When checked, a preview image during the processing is always shown in a stretched (non-linear) format. Image name on top of the preview window has text AutoSTF when image is stretched for preview. When unchecked preview image is shown in original format. Stretched format can be useful for visualizing the current processed image. |
ResampleInterfacepreview_resampleSetting name: Preview resample | checkboxunchecked | Use Resample process to reduce the size of preview images. The target image size can be changed in the Interface tab. Resample will make it faster to blink through images. Only the preview image is resample, original image is not modified. Note that resample may alter how preview image and histogram are shown during the preview. |
Preview resample targetInterfacepreview_resample_target | integer2000 | Target size for preview image resample. Note that resample may alter how preview image and histogram are shown during the preview. |
Start with empty window prefixInterfacestart_with_empty_window_prefixSetting name: startWithEmptyPrefixName | checkboxunchecked | Start the script with empty window prefix |
Manual icon column controlInterfaceuse_manual_icon_columnSetting name: manualIconColumn | checkboxunchecked | Enable manual control of icon columns. Useful for example when using multiple Workspaces. When this option is enabled the control for icon column is in the Interface / Interface settings section. This setting is effective only after restart of the script. |
Logging, process values and other troubleshooting helpers.
| Option | Type / default | Description |
|---|---|---|
Image weight testingInterfaceimage_weight_testing | checkboxunchecked | Run only SubframeSelector to output image weight information and outlier filtering into AutoIntegrate.log AutoWeights.json. Json file can be loaded as input file list. With this option no output image files are written. |
DebugInterfacedebug | checkboxunchecked | Print some additional debug information to the log output files. |
Null processingInterfacenull_processing | checkboxunchecked | Do not perform any actual processing. This is useful for testing and debugging. |
Flowchart debugInterfaceflowchart_debug | checkboxunchecked | Print some additional debug information when generating flowchart. |
Print process valuesInterfaceprint_process_values | checkboxunchecked | Print PixInsight process values to the console and to the AutoIntegrate log file. |
Create ExecutedProcesses.js fileInterfacecreate_executed_processes_js | checkboxunchecked | Create a JavaScript file with executed processes. It is a runnable script that can be executed in PixInsight. |
Narrowband RGB mapping O bandwidthInterfaceNarrowbandRGBHa_test_value | numberMapping | Test Ha RGB mapping. This requires that you have opened:
To get required Integration_[R|G|B] and Integration_H files you can run a full workflow first. Values: |
Values written into metadata files. They do not change the images.
| Option | Type / default | Description |
|---|---|---|
AstroBin LInterfaceastrobin_L | text or list— | Astrobin filter configuration for L filter. Give Astrobin filter number to be used in AstrobinInfo.csv file. |
AstroBin RInterfaceastrobin_R | text or list— | Astrobin filter configuration for R filter. Give Astrobin filter number to be used in AstrobinInfo.csv file. |
AstroBin GInterfaceastrobin_G | text or list— | Astrobin filter configuration for G filter. Give Astrobin filter number to be used in AstrobinInfo.csv file. |
AstroBin BInterfaceastrobin_B | text or list— | Astrobin filter configuration for B filter. Give Astrobin filter number to be used in AstrobinInfo.csv file. |
AstroBin HInterfaceastrobin_H | text or list— | Astrobin filter configuration for H filter. Give Astrobin filter number to be used in AstrobinInfo.csv file. |
AstroBin SInterfaceastrobin_S | text or list— | Astrobin filter configuration for S filter. Give Astrobin filter number to be used in AstrobinInfo.csv file. |
AstroBin OInterfaceastrobin_O | text or list— | Astrobin filter configuration for O filter. Give Astrobin filter number to be used in AstrobinInfo.csv file. |
AstroBin CInterfaceastrobin_C | text or list— | Astrobin filter configuration for C filter. Give Astrobin filter number to be used in AstrobinInfo.csv file. |