산란광(플레어) 관련 문서 페이지
소개: 산란광 테스트 및 정규화된 산란광 소개 |Imatest 산란광 분석 결과 | 역사
배경: 산란광 사례 |근본 원인 |테스트 개요 |테스트 요소 | 테스트 고려 사항 | 용어집
계산: 측정 이미지 |정규화 방법 |광원 마스크 방법 | 요약 측정 항목 | 분석 채널 | 채도
지침: 고급 Imatest 분석 지침(Master 및 IT) | Imatest를 이용한 정규화된 산란광 계산 | 전동 짐벌 사용 지침
설정: 설정 목록 및 INI 키/값 | 표준 및 권장 사항 |구성 파일 입력
This page provides a list and description of the settings for Imatest stray light source analysis, as well as corresponding INI field-value pairs.
Settings Table of Contents
Settings Sections
Stray Light Source
Stray Light Source
Description
Settings for analyzing image(s) of a stray light source.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Memory Usage | Option for how to prioritize memory or speed when performing an analysis. | Low Memory |
| [straylight]
memory_mode | |
Calculation
Calculation
Description
Calculation settings.
Sub-Sections
| Sub-Section | Description | Notes |
|---|
| Core Calculation | Core calculation settings. | |
| Saturation | Settings for how to calculate the saturation level. | |
| Channel | Settings for selecting which channels to analyze. | |
| Normalization | Settings for performing stray light normalization. | |
| Analysis Image Mask | Settings for creating a mask the analysis images(s). | |
| Spatial | Spatial stray light calculation settings. | |
| Metadata | Settings about metadata for the stray light run. | |
| Extra Calculation | Miscellaneous stray light calculation settings. | |
Core Calculation
Core Calculation
Description
Core calculation settings. See the metric image calculations documentation page for more details on these settings.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Calculation Type | The type of stray light calculation. | Transmission |
| [straylight]
calculation | |
| Data Transform | The transform applied to the data. | Linear |
| [straylight]
data_transform | |
| Dark Level | The dark level of the image(s) in digital numbers (DNs). | 0 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
dark_level_dn |
|
| Clip To One | Enable to clip image values to one (image values are clipped to zero if disabled). This prevents infinite stray light in attenuation calculations and logarithm-based data transforms. | false |
- Setting Type: Boolean
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
clip_to_one | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Calculation Type | Set To: Transmission | Set To: Transmission | Set To: Transmission | Set To: Transmission |
| Data Transform | Set To: Linear | Set To: Linear | Set To: dB (Voltage) | Set To: Linear |
| Dark Level | Set To: 0 | Test Parameter: Set based on camera dark noise. | Set To: 0
IEEE Std 2020-2024 does not specify subtracting off a dark level. | Set To: 0
IEEE Std 2020-2024 does not specify subtracting off a dark level. |
| Clip To One | Set To: false | Set To: false | Set To: true | Set To: false |
Saturation
Saturation
Description
Settings for how to calculate the saturation level.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Measurement Type | The type of saturation measurement to perform. | Container Max |
- Setting Type: Saturation Specification Enumeration (excluding: Classic, ITU-R BT.601)
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
saturation_method | |
| Value | The saturation value for the image(s) in digital numbers. | 65535 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
saturation_user_value |
- Units: DN
- The use of this field is contingent on the value of Measurement Type.
|
| Bit Depth | The saturation value for the image(s) as a bit depth. | 16 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
saturation_user_bit_depth |
- Units: bits
- The use of this field is contingent on the value of Measurement Type.
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Measurement Type | Set To: Image Max | Use Default: Container Max | Use Default: Container Max
IEEE Std 2020-2024 does not specify saturation calculations. | Use Default: Container Max
IEEE Std 2020-2024 does not specify saturation calculations. |
| Value | N/A | Test Parameter: If needed, set based on camera properties. | Test Parameter: If needed, set based on camera properties.
IEEE Std 2020-2024 does not specify saturation calculations. | Test Parameter: If needed, set based on camera properties.
IEEE Std 2020-2024 does not specify saturation calculations. |
| Bit Depth | N/A | Test Parameter: If needed, set based on camera properties. | Test Parameter: If needed, set based on camera properties.
IEEE Std 2020-2024 does not specify saturation calculations. | Test Parameter: If needed, set based on camera properties.
IEEE Std 2020-2024 does not specify saturation calculations. |
Channel
Channel
Description
Settings for selecting which channels to analyze. See the analysis channels documentation page for more details on these settings.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Analysis Channel(s) | Select the channels to analyze. | Automatic |
| [straylight]
channel_type | |
| Luminance Type | The luminance calculation to use. | IEC 61966-2-1 |
| [straylight]
channel_lum_type |
- The use of this field is contingent on the value of Analysis Channel(s).
|
| Custom RGB Weights | The luminance calculation to use. | [0.33333, 0.33333, 0.33333] |
- Setting Type: Number
- Setting Size: Fixed-Length Array (3 items)
- INI Type: Float
- INI Size: Array
| [straylight]
channel_lum_custom_rgb_weights |
- Order: Red, Green, Blue
- The use of this field is contingent on the value of Analysis Channel(s).
- The use of this field is contingent on the value of Luminance Type.
|
| RGB Order | The order of the channels. | Red, Green, Blue |
| [straylight]
channel_rgb_order |
- The use of this field is contingent on the value of Analysis Channel(s).
|
| Statistics | Select the statistic to use. | Mean |
| [straylight]
channel_stats_type |
- The use of this field is contingent on the value of Analysis Channel(s).
|
| Channel Index | Select the one-based index of the channel to analyze. | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
channel_index |
- The use of this field is contingent on the value of Analysis Channel(s).
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Analysis Channel(s) | Set To: Automatic | Set To: Each Channel | Set To: Luminance | Set To: Luminance |
| Luminance Type | N/A | N/A | Test Parameter: Set per §1.7.6.
IEEE Std 2020-2024 §2.7.1 does not specify which luminance weights to use. §1.7.6 recommends using the weights of the color space, if given, otherwise to use ITU-R BT.709-6 (sRGB) weights. | Test Parameter: Set per §1.7.6.
IEEE Std 2020-2024 §2.7.1 does not specify which luminance weights to use. §1.7.6 recommends using the weights of the color space, if given, otherwise to use ITU-R BT.709-6 (sRGB) weights. |
| Custom RGB Weights | N/A | N/A | Test Parameter: Set, if needed, per §1.7.6. | Test Parameter: Set, if needed, per §1.7.6. |
| RGB Order | N/A | N/A | Test Parameter: Set based on data type. | Test Parameter: Set based on data type. |
| Statistics | N/A | N/A | N/A | N/A |
| Channel Index | N/A | N/A | N/A | N/A |
Normalization
Normalization
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Normalization Type | The type of normalization to perform. | None |
| [straylight]
normalization | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Normalization Type | Set To: None | Set To: Direct Reference Image | Set To: Lambertian Reference Image | Set To: Direct Reference Image |
Level
Level
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Normalization Level | The normalization level in digital numbers (DNs). | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
norm_level_value | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Normalization Level | N/A | N/A | N/A | N/A |
Stray Light: Settings: Normalization: Direct Image
Stray Light: Settings: Normalization: Direct Image
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Reference Image File(s) | The fully-qualified path to the reference image file(s). | [] |
- Setting Type: String
- Setting Size: Variable-Length Array
- INI Type: String
- INI Size: Array
| [straylight]
norm_refim_files | |
| Normalization Aggregation | The methodology for aggregating the masked pixels into a normalization factor. | Median |
| [straylight]
norm_refim_aggregation | |
Sub-Sections
| Sub-Section | Description | Notes |
|---|
| Source Compensation | Settings for compensating for light source differences between the reference and test image. | |
| Camera Compensation | Settings for compensating for camera state differences between the reference and analysis images. | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Reference Image File(s) | N/A | Test Parameter: Select the reference image(s). | N/A | Test Parameter: Select the reference image(s).
IEEE Std 2020-2024 does not specify that more than one image can be combined. |
| Normalization Aggregation | N/A | Set To: Median | N/A | Set To: Mean
IEEE Std 2020-2024 §2.8.3.1 specifies the use of “the average linearized per-pixel gray level signal”. |
Source Compensation
Source Compensation
Description
Settings for compensating for light source differences between the reference and test image.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Light Level Ratio | The ratio of the reference light level divided by the test light level. | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
norm_refim_comp_light_level_ratio | |
Sub-Sections
| Sub-Section | Description | Notes |
|---|
| Neutral Density | Settings for quantifying a neutral density filter. | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Light Level Ratio | N/A | Test Parameter: Set based on test setup. | N/A | Test Parameter: Set based on test setup. |
Neutral Density
Neutral Density
Description
Settings for quantifying a neutral density filter.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| ND Type | The type of ND measurement. | None |
| [straylight]
norm_refim_comp_nd_type | |
| Transmission | The transmission (0-100) of the ND filter. | 100 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
norm_refim_comp_nd_transmission_value |
- Units: %
- The use of this field is contingent on the value of ND Type.
|
| Density | The density of the ND filter. | 0 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
norm_refim_comp_nd_density_value |
- The use of this field is contingent on the value of ND Type.
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| ND Type | N/A | Test Parameter: Set based on test setup. | N/A | Test Parameter: Set based on test setup. |
| Transmission | N/A | Test Parameter: Set, if needed, based on the test setup. | N/A | Test Parameter: Set, if needed, based on the test setup. |
| Density | N/A | Test Parameter: Set, if needed, based on the test setup. | N/A | Test Parameter: Set, if needed, based on the test setup. |
Camera Compensation
Camera Compensation
Description
Settings for compensating for camera state differences between the reference and analysis images.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Integration Time Ratio | The ratio of the reference integration time divided by the test integration time. | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
norm_refim_comp_int_time_ratio | |
| Gain Ratio | The ratio of the reference gain divided by the test gain. | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
norm_refim_comp_gain_ratio | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Integration Time Ratio | N/A | Test Parameter: Set based on test setup. | N/A | Test Parameter: Set based on test setup. |
| Gain Ratio | N/A | Test Parameter: Set based on test setup. | N/A | Test Parameter: Set based on test setup. |
Stray Light: Settings: Normalization: Lambertian Image
Stray Light: Settings: Normalization: Lambertian Image
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Reference Image File(s) | The fully-qualified path to the reference image file(s). | [] |
- Setting Type: String
- Setting Size: Variable-Length Array
- INI Type: String
- INI Size: Array
| [straylight]
norm_lrefim_files | |
| Normalization Aggregation | The methodology for aggregating the masked pixels into a normalization factor. | Mean |
| [straylight]
norm_lrefim_aggregation | |
Sub-Sections
| Sub-Section | Description | Notes |
|---|
| Light Source Measurements | Information about the light source measurements for Lambertian normalization. | |
| Camera Compensation | Settings for compensating for camera state differences between the reference and analysis images. | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Reference Image File(s) | N/A | N/A | Test Parameter: Select the reference image(s).
IEEE Std 2020-2024 does not specify that more than one image can be combined. | N/A |
| Normalization Aggregation | N/A | N/A | Set To: Mean
IEEE Std 2020-2024 Eq. 2-5 specifies the use of the average in the symbols. | N/A |
Light Source Measurements
Light Source Measurements
Description
Information about the light source measurements for Lambertian normalization.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Light Measurement Units | The type of measurement of the source. | Radiometric |
| [straylight]
norm_lrefim_source_meas_type | |
| Luminance From Lambertian Diffuser | The luminance [cd/m²] from the Lambertian diffuser in the reference image. | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
norm_lrefim_ref_luminance |
- Units: cd/m²
- The use of this field is contingent on the value of Light Measurement Units.
|
| Illuminance At The Camera Location | The illuminance [lux] at the location of the camera for the test image(s). | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
norm_lrefim_illuminance |
- Units: lux
- The use of this field is contingent on the value of Light Measurement Units.
|
| Radiance From Lambertian Diffuser | The measured radiance [W/m²/sr] from the Lambertian diffuser in the reference image. | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
norm_lrefim_ref_radiance |
- Units: W/m²/sr
- The use of this field is contingent on the value of Light Measurement Units.
|
| Irradiance At The Camera Location | The measured irradiance [W/m²] at the location of the camera for the test image(s). | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
norm_lrefim_irradiance |
- Units: W/m²
- The use of this field is contingent on the value of Light Measurement Units.
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Light Measurement Units | N/A | N/A | Test Parameter: Set based on test setup. | N/A |
| Luminance From Lambertian Diffuser | N/A | N/A | Test Parameter: Set, if needed, based on test setup. | N/A |
| Illuminance At The Camera Location | N/A | N/A | Test Parameter: Set, if needed, based on test setup. | N/A |
| Radiance From Lambertian Diffuser | N/A | N/A | Test Parameter: Set, if needed, based on test setup. | N/A |
| Irradiance At The Camera Location | N/A | N/A | Test Parameter: Set, if needed, based on test setup. | N/A |
Camera Compensation
Camera Compensation
Description
Settings for compensating for camera state differences between the reference and analysis images.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Integration Time Ratio | The ratio of the reference integration time divided by the test integration time. | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
norm_lrefim_comp_int_time_ratio | |
| Gain Ratio | The ratio of the reference gain divided by the test gain. | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
norm_lrefim_comp_gain_ratio | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Integration Time Ratio | N/A | N/A | Test Parameter: Set based on test setup. | N/A |
| Gain Ratio | N/A | N/A | Test Parameter: Set based on test setup. | N/A |
Reference Image Source Detection
Reference Image Source Detection
Description
Settings for detecting the light source for the reference image(s). See the stray light masking documentation page for more details on these settings.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Detection Method | The methodology for identifying where the light source is in the image. | Image Processing |
- Setting Type: Stray Light: Mask Method Enumeration (excluding: None, Geometric Camera Model + Circle)
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
refmask_method | |
Sub-Sections
| Sub-Section | Description | Notes |
|---|
| Image Processing | Settings for image-processing-based masking. |
- The use of this field is contingent on the value of Detection Method.
|
| Circle Center | Settings describing the center of a manually-placed circular mask. |
- The use of this field is contingent on the value of Detection Method.
|
| Circle Radius | The circular radius settings. |
- The use of this field is contingent on the value of Detection Method.
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Detection Method | N/A | Set To: Image Processing | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify separate settings for reference and test images. |
Image Processing
Image Processing
Description
Settings for image-processing-based masking. See the stray light masking documentation page for more details on these settings.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Level Threshold Type | How to threshold the image. | Percentage of Max |
| [straylight]
refmask_improc_level_thresh_type | |
| Level Threshold (Value) | The threshold above which is considered the image of the light source, in digital numbers. | 65535 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
refmask_improc_level_threshold |
- Units: DN
- The use of this field is contingent on the value of Level Threshold Type.
|
| Level Threshold (Percent) | The threshold above which is considered the image of the light source, as a percentage of the maximum value. | 50 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
refmask_improc_level_threshold_pct |
- Units: %
- The use of this field is contingent on the value of Level Threshold Type.
|
| Image Close Radius | The radius of an image close morphology step. This helps to remove holes in the mask. Set to 0 to skip this step. | 5 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
refmask_improc_image_close_radius |
|
| Multiple Connected Component Strategy | The strategy for how to deal with multiple connected components. | Pick Biggest |
| [straylight]
refmask_improc_multiple_cc_strategy | |
| Mask Area Threshold | The minimum number of pixels that the image of the light source should be. | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
refmask_improc_mask_area_threshold |
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Level Threshold Type | N/A | Set To: Percentage of Max | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
| Level Threshold (Value) | N/A | N/A | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
| Level Threshold (Percent) | N/A | Set To: 50 | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
| Image Close Radius | N/A | Set To: 5 | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
| Multiple Connected Component Strategy | N/A | Set To: Pick Biggest | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
| Mask Area Threshold | N/A | Set To: 1 | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
Circle Center
Circle Center
Description
Settings describing the center of a manually-placed circular mask. See the stray light masking documentation page for more details on these settings.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Method | The method for specifying the circle center. | Numeric Image Center |
| [straylight]
refmask_circle_center_type | |
| Image Coordinate System | The image coordinate system of the user-provided coordinate. | IEEE Std. 2020™ Type IV |
| [straylight]
refmask_circle_im_coord |
- The use of this field is contingent on the value of Method.
|
| Center Coordinate | The center of the circular region for the reference image. | [0, 0] |
- Setting Type: Number
- Setting Size: Fixed-Length Array (2 items)
- INI Type: Float
- INI Size: Array
| [straylight]
refmask_circle_custom_center |
- Order: x, y
- The use of this field is contingent on the value of Method.
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Method | N/A | N/A | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
| Image Coordinate System | N/A | N/A | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
| Center Coordinate | N/A | N/A | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
Circle Radius
Circle Radius
Description
The circular radius settings. See the stray light masking documentation page for more details on these settings.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Method | The method for determining the radius. | User-Specified |
| [straylight]
refmask_2pcr_radius_type | |
| Radius | The radius in pixels. | 10 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
refmask_2pcr_radius |
- Units: px
- The use of this field is contingent on the value of Method.
|
| Camera Pixel Pitch | The pixel pitch of the camera in μm. | 5 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
refmask_2pcr_radius_dut_pp |
- Units: μm
- The use of this field is contingent on the value of Method.
|
| Camera Focal Length | The focal length of the camera in mm. | 10 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
refmask_2pcr_radius_dut_fl |
- Units: mm
- The use of this field is contingent on the value of Method.
|
| Source Focal Length | The focal length of the light source in mm. | 100 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
refmask_2pcr_radius_col_fl |
- Units: mm
- The use of this field is contingent on the value of Method.
|
| Source Diameter | The diameter of the light source in mm. | 25 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
refmask_2pcr_radius_col_dia |
- Units: mm
- The use of this field is contingent on the value of Method.
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Method | N/A | N/A |
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
| Radius | N/A | N/A |
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
| Camera Pixel Pitch | N/A | N/A |
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
| Camera Focal Length | N/A | N/A |
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
| Source Focal Length | N/A | N/A |
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
| Source Diameter | N/A | N/A |
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not specify instructions for detecting the Lambertian reference source. |
Analysis Image Mask
Analysis Image Mask
Description
Settings for creating a mask the analysis images(s). See the stray light masking documentation page for more details on these settings.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Mask Method | The methodology for identifying where the light source is in the image. | None |
- Setting Type: Stray Light: Mask Method Enumeration (excluding: Manually-specified Circle, Same as Analysis Mask Settings)
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
mask_method | |
Sub-Sections
| Sub-Section | Description | Notes |
|---|
| Image Processing | Settings for image-processing-based masking. |
- The use of this field is contingent on the value of Mask Method.
|
| Geometric Calibration | Mask the source via a geometric camera calibration model. |
- The use of this field is contingent on the value of Mask Method.
|
| Circle Radius | The circular radius settings. |
- The use of this field is contingent on the value of Mask Method.
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Mask Method | Set To: None | Set To: Image Processing + Circle | Choose From:
- Image Processing
- Geometric Camera Model + Circle
Image Processing-based masking is specied in §2.7.2.1. Geometric Camera Model + Circle-based masking is specified in §2.7.2.2. | Choose From:
- Image Processing
- Geometric Camera Model + Circle
Image Processing-based masking is specied in §2.7.2.1. Geometric Camera Model + Circle-based masking is specified in §2.7.2.2. |
Image Processing
Image Processing
Description
Settings for image-processing-based masking. See the stray light masking documentation page for more details on these settings.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Level Threshold Type | How to threshold the image. | Percentage of Max |
| [straylight]
mask_improc_level_thresh_type | |
| Level Threshold (Value) | The threshold above which is considered the image of the light source, in digital numbers. | 65535 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
mask_improc_level_threshold |
- Units: DN
- The use of this field is contingent on the value of Level Threshold Type.
|
| Level Threshold (Percent) | The threshold above which is considered the image of the light source, as a percentage of the maximum value. | 95 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
mask_improc_level_threshold_pct |
- Units: %
- The use of this field is contingent on the value of Level Threshold Type.
|
| Minimum Source Level | The minimum value that can be considered a direct image of the light source. | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
mask_improc_minimum_source_level |
- Units: DN
- The use of this field is contingent on the value of Level Threshold Type.
|
| Image Close Radius | The radius of an image close morphology step. This helps to remove holes in the mask. Set to 0 to skip this step. | 5 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
mask_improc_image_close_radius |
|
| Multiple Connected Component Strategy | The strategy for how to deal with multiple connected components. | Pick Biggest |
| [straylight]
mask_improc_multiple_cc_strategy | |
| Mask Area Threshold | The minimum number of pixels that the image of the light source should be. | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
mask_improc_mask_area_threshold |
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Level Threshold Type | N/A | Set To: Percentage of Max | Set To: Percentage of Max
See IEEE Std 2020-2024 §2.7.2.1. The 95% threshold is allowed to be tuned. | Set To: Percentage of Max
See IEEE Std 2020-2024 §2.7.2.1. The 95% threshold is allowed to be tuned. |
| Level Threshold (Value) | N/A | N/A | N/A | N/A |
| Level Threshold (Percent) | N/A | Set To: 95 | Set To: 95 | Set To: 95 |
| Minimum Source Level | N/A | Test Parameter: Set to a value slightly less than the level of the direct image of the source in the image. | Test Parameter: Set to a value slightly less than the level of the direct image of the source in the image.
Although not explicitly part of IEEE Std 2020-2024 §2.7.2.1, the first paragraph of that clause assumes the source’s image is in the FOV. Setting this value helps validate that assumption. | Test Parameter: Set to a value slightly less than the level of the direct image of the source in the image.
Although not explicitly part of IEEE Std 2020-2024 §2.7.2.1, the first paragraph of that clause assumes the source’s image is in the FOV. Setting this value helps validate that assumption. |
| Image Close Radius | N/A | Set To: 5 | Test Parameter: Set based on test setup.
In IEEE Std 2020-2024 §2.7.2.1, it says to perform a closing, but does not specify a radius. | Test Parameter: Set based on test setup.
In IEEE Std 2020-2024 §2.7.2.1, it says to perform a closing, but does not specify a radius. |
| Multiple Connected Component Strategy | N/A | Set To: Pick Biggest | Set To: Pick Biggest | Set To: Pick Biggest |
| Mask Area Threshold | N/A | Test Parameter: Set to a value slightly larger than the pixel area of the well-exposed source. | Set To: 0
IEEE Std 2020-2024 §2.7.2.1 does not specify a mask area threshold. | Set To: 0
IEEE Std 2020-2024 §2.7.2.1 does not specify a mask area threshold. |
Geometric Calibration
Geometric Calibration
Description
Mask the source via a geometric camera calibration model. See the stray light masking documentation page for more details on these settings.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Negate Field Angle | Enable to negate the field angle. | false |
- Setting Type: Boolean
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
mask_geocal_negate_field | |
| Negate Azimuth Angle | Enable to negate the azimuth angle. | false |
- Setting Type: Boolean
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
mask_geocal_negate_azimuth | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Negate Field Angle | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
| Negate Azimuth Angle | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
Geometric Camera Model
Geometric Camera Model
Description
The settings for describing a geometric camera model.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Model Type | The type of camera model. | Simple Pinhole |
| [straylight]
geocal_model_type | |
Sub-Sections
| Sub-Section | Description | Notes |
|---|
| Image Coordinate System | Settings about the image coordinate system. | |
| Intrinsics | Settings about the intrinsic properties of the camera. | |
| OpenCV Distortion | Settings about the OpenCV distortion properties of the camera. |
- The use of this field is contingent on the value of Model Type.
|
| OpenCV Fisheye Distortion | Settings about the OpenCV Fisheye distortion properties of the camera. |
- The use of this field is contingent on the value of Model Type.
|
| Distortion | Settings about the distortion properties of the camera. |
- The use of this field is contingent on the value of Model Type.
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Model Type | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
Image Coordinate System
Image Coordinate System
Description
Settings for defining the image coordinate system.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Type | The type of image coordinate system to use. | IEEE Std. 2020™ Type IV |
| [straylight]
image_coord_type | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Type | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
Intrinsics
Intrinsics
Description
Settings for the camera intrinsics. See the geometric camera model documentation page for more details on these settings.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Focal Length | The focal length in pixels. | 1000 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
geocal_intrinsics_f |
|
| Principal Point Type | The method for providing the principal point. | Numeric Image Center |
| [straylight]
geocal_intrinsics_pp_type | |
| Principal Point | The principal point in the specified coordinate system. | [0, 0] |
- Setting Type: Number
- Setting Size: Fixed-Length Array (2 items)
- INI Type: Float
- INI Size: Array
| [straylight]
geocal_intrinsics_user_pp |
- Order: x, y
- The use of this field is contingent on the value of Principal Point Type.
|
| Alpha | The ratio of the y focal length to the x focal length. | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
geocal_intrinsics_alpha | |
| Skew | The skew. | 0 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
geocal_intrinsics_skew | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Focal Length | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
| Principal Point Type | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
| Principal Point | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
| Alpha | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
| Skew | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
OpenCV Distortion
OpenCV Distortion
Description
Settings for describing the OpenCV distortion model. See the geometric camera model documentation page for more details on these settings.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Radial Coefficients | The radial distortion coefficients. | [0, 0, 0, 0, 0, 0] |
- Setting Type: Number
- Setting Size: Fixed-Length Array (6 items)
- INI Type: Float
- INI Size: Array
| [straylight]
geocal_opencv_distortion_radial |
- Order: k₁, k₂, k₃, k₄, k₅, k₆
|
| Tangential Coefficients | The tangential distortion coefficients. | [0, 0] |
- Setting Type: Number
- Setting Size: Fixed-Length Array (2 items)
- INI Type: Float
- INI Size: Array
| [straylight]
geocal_opencv_distortion_tangential |
|
| Thin-Prism Coefficients | The thin-prism distortion coefficients. | [0, 0, 0, 0] |
- Setting Type: Number
- Setting Size: Fixed-Length Array (4 items)
- INI Type: Float
- INI Size: Array
| [straylight]
geocal_opencv_distortion_thin_prism |
|
| Tilt Coefficients | The tilt distortion coefficients. | [0, 0] |
- Setting Type: Number
- Setting Size: Fixed-Length Array (2 items)
- INI Type: Float
- INI Size: Array
| [straylight]
geocal_opencv_distortion_tilt |
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Radial Coefficients | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
| Tangential Coefficients | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
| Thin-Prism Coefficients | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
| Tilt Coefficients | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
Geometric Camera Model: OpenCV Fisheye Distortion
Geometric Camera Model: OpenCV Fisheye Distortion
Description
Settings for describing the OpenCV fisheye distortion model.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Coefficients | The fisheye distortion coefficients in increasing power order. | [0, 0, 0, 0] |
- Setting Type: Number
- Setting Size: Fixed-Length Array (4 items)
- INI Type: Float
- INI Size: Array
| [straylight]
geocal_opencv_fisheye_distortion |
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Coefficients | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
Distortion Model
Distortion Model
Description
Settings for describing the distortion model.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Distortion Type | The type of distortion model. | Radial |
| [straylight]
geocal_distortion_type | |
Sub-Sections
| Sub-Section | Description | Notes |
|---|
| Brown-Conrady Distortion | Brown-Conrady distortion settings. |
- The use of this field is contingent on the value of Distortion Type.
|
| Radial Distortion | Radial distortion settings. |
- The use of this field is contingent on the value of Distortion Type.
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Distortion Type | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
Brown Conrady Distortion
Brown Conrady Distortion
Description
Settings for describing the Brown-Conrady distortion model.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Center Of Distortion Type | The type of center of distortion. | Numeric Image Center |
| [straylight]
geocal_brown_conrady_cod_type | |
| Center Of Distortion | The center of distortion. | [0, 0] |
- Setting Type: Number
- Setting Size: Fixed-Length Array (2 items)
- INI Type: Float
- INI Size: Array
| [straylight]
geocal_brown_conrady_cod |
- Order: x, y
- The use of this field is contingent on the value of Center Of Distortion Type.
|
| Radial Coefficients | The radial distortion coefficients. | [] |
- Setting Type: Number
- Setting Size: Variable-Length Array
- INI Type: Float
- INI Size: Array
| [straylight]
geocal_brown_conrady_distortion_radial | |
| Tangential Coefficients | The tangential distortion coefficients. | [] |
- Setting Type: Number
- Setting Size: Variable-Length Array
- INI Type: Float
- INI Size: Array
| [straylight]
geocal_brown_conrady_distortion_tangential | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Center Of Distortion Type | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
| Center Of Distortion | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
| Radial Coefficients | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
| Tangential Coefficients | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
Radial Distortion
Radial Distortion
Description
Settings for describing the radial distortion model.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Radial Distortion Type | The type of radial distortion model. | Polynomial |
| [straylight]
geocal_radial_distortion_type | |
| Center Of Distortion Type | The type of center of distortion. | Numeric Image Center |
| [straylight]
geocal_brown_conrady_cod_type | |
| Center Of Distortion | The center of distortion. | [0, 0] |
- Setting Type: Number
- Setting Size: Fixed-Length Array (2 items)
- INI Type: Float
- INI Size: Array
| [straylight]
geocal_brown_conrady_cod |
- Order: x, y
- The use of this field is contingent on the value of Center Of Distortion Type.
|
Sub-Sections
| Sub-Section | Description | Notes |
|---|
| Polynomial Numerator | The polynomial coefficients of the numerator. |
- The use of this field is contingent on the value of Radial Distortion Type.
|
| Polynomial Denominator | The polynomial coefficients of the denominator. |
- The use of this field is contingent on the value of Radial Distortion Type.
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Radial Distortion Type | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
| Center Of Distortion Type | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
| Center Of Distortion | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
Numerator Radial Distortion Coefficients
Numerator Radial Distortion Coefficients
Description
The polynomial coefficients for the numerator of the radial distortion model.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Numerator Coefficients | The numerator radial distortion coefficients in increasing power order. | [] |
- Setting Type: Number
- Setting Size: Variable-Length Array
- INI Type: Float
- INI Size: Array
| [straylight]
geocal_numerator_radial_dist_coeffs | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Numerator Coefficients | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
Denominator Radial Distortion Coefficients
Denominator Radial Distortion Coefficients
Description
The polynomial coefficients for the denominator of the radial distortion model.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Denominator Coefficients | The denominator radial distortion coefficients in increasing power order. | [] |
- Setting Type: Number
- Setting Size: Variable-Length Array
- INI Type: Float
- INI Size: Array
| [straylight]
geocal_denominator_radial_dist_coeffs | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Denominator Coefficients | N/A | N/A | Test Parameter: Set based on test setup. | Test Parameter: Set based on test setup. |
Circle Radius
Circle Radius
Description
The circular radius settings. See the stray light masking documentation page for more details on these settings.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Method | The method for determining the radius. | User-Specified |
| [straylight]
mask_2pcr_radius_type | |
| Radius | The radius in pixels. | 10 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
mask_2pcr_radius |
- Units: px
- The use of this field is contingent on the value of Method.
|
| Camera Pixel Pitch | The pixel pitch of the camera in μm. | 5 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
mask_2pcr_radius_dut_pp |
- Units: μm
- The use of this field is contingent on the value of Method.
|
| Camera Focal Length | The focal length of the camera in mm. | 10 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
mask_2pcr_radius_dut_fl |
- Units: mm
- The use of this field is contingent on the value of Method.
|
| Source Focal Length | The focal length of the light source in mm. | 100 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
mask_2pcr_radius_col_fl |
- Units: mm
- The use of this field is contingent on the value of Method.
|
| Source Diameter | The diameter of the light source in mm. | 25 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
mask_2pcr_radius_col_dia |
- Units: mm
- The use of this field is contingent on the value of Method.
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Method | N/A | Set To: User-Specified | Set To: Focal Length Ratio | Set To: Focal Length Ratio |
| Radius | N/A | Test Parameter: Set via measurement of the on-axis image. | N/A | N/A |
| Camera Pixel Pitch | N/A | N/A | Test Parameter: Set based on test setup.
This is part of IEEE Std 2020-2024 eq 2-4. | Test Parameter: Set based on test setup.
This is part of IEEE Std 2020-2024 eq 2-4. |
| Camera Focal Length | N/A | N/A | Test Parameter: Set based on test setup.
This is part of IEEE Std 2020-2024 eq 2-4. | Test Parameter: Set based on test setup.
This is part of IEEE Std 2020-2024 eq 2-4. |
| Source Focal Length | N/A | N/A | Test Parameter: Set based on test setup.
This is part of IEEE Std 2020-2024 eq 2-4. | Test Parameter: Set based on test setup.
This is part of IEEE Std 2020-2024 eq 2-4. |
| Source Diameter | N/A | N/A | Test Parameter: Set based on test setup.
This is part of IEEE Std 2020-2024 eq 2-4. | Test Parameter: Set based on test setup.
This is part of IEEE Std 2020-2024 eq 2-4. |
Spatial
Spatial
Description
Spatial stray light calculation settings.
Sub-Sections
| Sub-Section | Description | Notes |
|---|
| Downsampling | Settings for downsampling an image for analysis. | |
| Crop | Settings for cropping an image. | |
Downsampling
Downsampling
Description
Settings for downsampling an image for analysis.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Size Measurement | The method for determining the size of the down-sampled image. | Full Resolution |
| [straylight]
downsample_size_type | |
| Factor | The factor by which the image will be downsampled. | 1 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
downsample_factor |
- The use of this field is contingent on the value of Size Measurement.
|
| Output Image Size | The desired output image size. | [1024, 1024] |
- Setting Type: Number
- Setting Size: Fixed-Length Array (2 items)
- INI Type: Integer
- INI Size: Array
| [straylight]
downsample_image_size |
- Order: # Cols, # Rows
- The use of this field is contingent on the value of Size Measurement.
|
| Row Count | The number of rows in the in downsampled image. | 1024 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
downsample_rows |
- The use of this field is contingent on the value of Size Measurement.
|
| Column Count | The number of columns in the output image. | 1024 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
downsample_cols |
- The use of this field is contingent on the value of Size Measurement.
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Size Measurement | Set To: Full Resolution | Set To: Full Resolution | Set To: Full Resolution
IEEE Std 2020-2024 does not mention the downsampling of analysis images. | Set To: Full Resolution
IEEE Std 2020-2024 does not mention the downsampling of analysis images. |
| Factor | N/A | N/A | N/A | N/A |
| Output Image Size | N/A | N/A | N/A | N/A |
| Row Count | N/A | N/A | N/A | N/A |
| Column Count | N/A | N/A | N/A | N/A |
Crop
Crop
Description
Settings for cropping an image.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Crop | The number of pixels to crop off the left, right, top, and bottom of the image. | [0, 0, 0, 0] |
- Setting Type: Number
- Setting Size: Fixed-Length Array (4 items)
- INI Type: Float
- INI Size: Array
| [straylight]
crop_lrtb |
- Order: Left, Right, Top, Bottom
- Units: px
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Crop | Set To: [0, 0, 0, 0] | Test Parameter: Set to exclude any non-imaging rows/columns. | Test Parameter: Set based on test setup.
IEEE Std 2020-2024 does not mention the cropping of non-imaging pixels; however, this is recommended if non-imaging data are present. | Test Parameter: Set based on test setup.
IEEE Std 2020-2024 does not mention the cropping of non-imaging pixels; however, this is recommended if non-imaging data are present. |
Metadata
Description
Settings about metadata for the stray light run. The following options provide an alternative to the stray light configuration file for defining capture metadata. The alternate approach uses regular expression to parse the image filename and extract metadata that would otherwise come from the config file. If enabled, the regular-expression-derived metadata will have precedence over metadata from a configuration file.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Filename Regular Expression Method | The regular expression method to apply to the filename. | None |
| [straylight]
file_regex_method | |
| Filename Regular Expression | A regular expression to apply to a filename and extract metadata. | |
- Setting Type: String
- Setting Size: Scalar
- INI Type: String
- INI Size: Scalar
| [straylight]
file_regex |
- The use of this field is contingent on the value of Filename Regular Expression Method.
|
| Decimal Point | A character representing the decimal place. | . |
- Setting Type: String
- Setting Size: Scalar
- INI Type: String
- INI Size: Scalar
| [straylight]
decimal_place |
- The use of this field is contingent on the value of Filename Regular Expression Method.
|
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Filename Regular Expression Method | Set To: None | Test Parameter: Set if needed to correlate images to capture information. | Test Parameter: Set if needed to correlate images to capture information. | Test Parameter: Set if needed to correlate images to capture information. |
| Filename Regular Expression | N/A | Test Parameter: Set if needed to correlate images to capture information. | Test Parameter: Set if needed to correlate images to capture information. | Test Parameter: Set if needed to correlate images to capture information. |
| Decimal Point | N/A | Test Parameter: Set if needed to correlate images to capture information. | Test Parameter: Set if needed to correlate images to capture information. | Test Parameter: Set if needed to correlate images to capture information. |
Example Numeric Regular Expressions
The following are example regular expressions for matching numbers. Note that named capture groups are required to associate the extracted string with a particular field. | Regular Expression | Description |
|---|
\d+ | Matches positive integers |
[0-9]+ | Matches positive integers |
-?\d+ | Matches positive or negative integers |
-?[0-9]+ | Matches positive or negative integers |
[+-]?\d+(?:\.\d+)? | Matches decimal numbers with at least one digit to the left of the decimal (i.e., will not match .1) |
[+-]?\d+(?:\.\d+)?(?:[Ee][+-]?\d+)? | Matches decimal numbers with at least one digit to the left of the decimal including those using “E” scientific notation (i.e., will not match .2E-7) |
Example Settings
The following are example settings and what values will be extracted from the filename. | Regular Expression | Decimal | C://path/to/az0.2_fa-4.6.png | \path\to\camera123\field20_azimuth32.tiff | C://path/to/camera123/az0p2_fa-4p6.png |
|---|
fa(?-?\d+(?:\.\d*)?) | . |
- Field Angle: -4.6
- Azimuth Angle: (no match)
- Comment: (no match)
|
- Field Angle: (no match)
- Azimuth Angle: (no match)
- Comment: (no match)
|
- Field Angle: (no match)
- Azimuth Angle: (no match)
- Comment: (no match)
|
field(?-?\d+)_azimuth(?-?\d+) | . |
- Field Angle: (no match)
- Azimuth Angle: (no match)
- Comment: (no match)
|
- Field Angle: 20
- Azimuth Angle: 32
- Comment: (no match)
|
- Field Angle: (no match)
- Azimuth Angle: (no match)
- Comment: (no match)
|
(?[A-Za-z0-9 ]+)\/az(?-?\d+(?:p\d*)?)_fa(?-?\d+(?:p\d*)?) | p |
- Field Angle: (no match)
- Azimuth Angle: (no match)
- Comment: (no match)
|
- Field Angle: (no match)
- Azimuth Angle: (no match)
- Comment: (no match)
|
- Field Angle: -4.6
- Azimuth Angle: 0.2
- Comment: camera123
|
Regular Expression Notes
Generic Regular Expression Notes
- AI utilities may help to construct a regular expression.
- Testing the regular expression with utilities such as regex101.com is recommended.
Metadata Extraction Regular Expression Notes
- Having a consistent filename format will help make a reusable regular expression.
- With the current architecture, the entire regex must match to extract any metadata (there is no partial extraction).
Extra Calculation
Description
Miscellaneous stray light calculation settings.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Percentile Ranks | The percentile ranks [0-100] (e.g., 95 = 95th percentile). | [95] |
- Setting Type: Number
- Setting Size: Variable-Length Array (0 or more items)
- INI Type: Float
- INI Size: Array
| [straylight]
percentile_ranks100 | |
| Count Type | The format of the level count-based summary metrics. | Percent of Pixels |
| [straylight]
count_type | |
| Level Count Thresholds | The thresholds of stray light level for producing results that show the number of pixels worse than said threshold. | [] |
- Setting Type: Number
- Setting Size: Variable-Length Array (0 or more items)
- INI Type: Float
- INI Size: Array
| [straylight]
level_count_thresh | |
Standards/Recommendations
| Setting | Imatest: New User | Imatest: Advanced User | IEEE Std 2020-2024: Flare Intensity | IEEE Std 2020-2024: Normalized Flare |
|---|
| Percentile Ranks | |
Set values as desired. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not mention percentiles as summary metrics. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not mention percentiles as summary metrics. |
| Count Type | Set To: Percent of Pixels | Set To: Percent of Pixels | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not mention count-based summary metrics. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not mention count-based summary metrics. |
| Level Count Thresholds | |
Set values as desired. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not mention count-based summary metrics. | Unspecified Parameter: This parameter is not specified in the standard.
IEEE Std 2020-2024 does not mention count-based summary metrics. |
Batch Outputs
Batch Outputs
Description
Settings for saving stray light batch outputs.
Image Outputs
Image Outputs
Description
What image outputs to save.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Save Mask | Enable to save out a FITS file containing the mask of the source for each image. | false |
- Setting Type: Boolean
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
save_mask | |
| Save Metric Image | Enable to save out a FITS file containing the metric image(s). | true |
- Setting Type: Boolean
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
save_metric_image | |
Plot Save/Display
Plot Save/Display
Description
Settings for the saving or displaying of plots.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Plot Type | The file format(s) to save the plots. | [PNG] |
- Setting Type: Plot Save Format Enumeration
- Setting Size: Variable-Length Array (1 or more items)
- INI Type: Integer
- INI Size: Array
| [straylight]
plot_save_types | |
Sub-Sections
| Sub-Section | Description | Notes |
|---|
| Level Plot | Options for creating plots based on the stray light level. | |
| Count Plot | Options for creating plots based on the number of pixels. | |
| Diagnostic Plots | Options for creating diagnostic plots. | |
Level Plot
Level Plot
Description
Options for creating plots based on the stray light level. Note: level plots require two or more test images.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Save/Display | Save or display the level plot(s). | [Save] |
- Setting Type: Save/Display Plot Enumeration
- Setting Size: Variable-Length Array
- INI Type: Integer
- INI Size: Array
| [straylight]
level_plot_save_display | |
| Channel Grouping | How to group the data within a plot. At least one is required to produce this plot. | [All Channels On The Same Plot] |
| [straylight]
level_plot_channel_grouping |
- The use of this field is contingent on the value of Save/Display.
|
| Named Data | The data to plot on level summary plot(s). | [Mean, Maximum] |
| [straylight]
level_plot_include_named_data |
- The use of this field is contingent on the value of Save/Display.
- The use of this field is contingent on the value of Include Percentiles.
|
| Include Percentiles | Enable to include percentiles on the level summary plot(s). | true |
- Setting Type: Boolean
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
level_plot_include_pctls |
- The use of this field is contingent on the value of Save/Display.
- The use of this field is contingent on the value of Named Data.
|
| Per Plot Scaling | The scaling of the y-axis of the level plots relative to each other. | Global |
| [straylight]
level_plot_per_plot_scaling |
- The use of this field is contingent on the value of Save/Display.
|
| Y-Axis Scale | The scaling of the y-axis of the plot. | Linear |
- Setting Type: Axis Scaling Enumeration
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
level_plot_y_axis_scale |
- The use of this field is contingent on the value of Save/Display.
|
Count Plot
Count Plot
Description
Options for creating plots based on the number of pixels. Note: count plots require two or more test images.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Save/Display | Save or display the count plot(s). | [Save] |
- Setting Type: Save/Display Plot Enumeration
- Setting Size: Variable-Length Array
- INI Type: Integer
- INI Size: Array
| [straylight]
count_plot_save_display | |
| Channel Grouping | How to group the data within a plot. At least one is required to produce this plot. | [All Channels On The Same Plot] |
| [straylight]
count_plot_channel_grouping |
- The use of this field is contingent on the value of Save/Display.
|
| Named Data | The data to plot on count summary plot(s). | [Source Count, Saturation Count] |
| [straylight]
count_plot_include_named_data |
- The use of this field is contingent on the value of Save/Display.
- The use of this field is contingent on the value of Include Level Counts.
|
| Include Level Counts | Enable to include the number of pixels worse than user-provided thresholds on the count plot(s).). | true |
- Setting Type: Boolean
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
count_plot_include_level_counts |
- The use of this field is contingent on the value of Save/Display.
- The use of this field is contingent on the value of Named Data.
|
| Per Plot Scaling | The scaling of the y-axis of the count plots relative to each other. | Global |
| [straylight]
count_plot_per_plot_scaling |
- The use of this field is contingent on the value of Save/Display.
|
| Y-Axis Scale | The scaling of the y-axis of the plot. | Log |
- Setting Type: Axis Scaling Enumeration
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
count_plot_y_axis_scale |
- The use of this field is contingent on the value of Save/Display.
|
Diagnostic Plots
Diagnostic Plots
Description
Options for creating diagnostic plots.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Save/Display Reference Image Detection Plot | Save or display the reference image detection diagnostic plot. | [Save] |
- Setting Type: Save/Display Plot Enumeration
- Setting Size: Variable-Length Array
- INI Type: Integer
- INI Size: Array
| [straylight]
reference_detection_diagnostic_plot | |
| Save/Display Analysis Image Mask Plot | Save or display the analysis image masking diagnostic plot(s). Display is not recommended. | [] |
- Setting Type: Save/Display Plot Enumeration
- Setting Size: Variable-Length Array
- INI Type: Integer
- INI Size: Array
| [straylight]
analysis_mask_diagnostic_plot | |
Video
Video
Description
Settings for saving videos/image sequences.
Colormapped Metric Image
Colormapped Metric Image
Description
Options for saving a colormapped metric image.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Video Formats | The format(s) to save the video as. | [] |
| [straylight]
metric_video_video_formats | |
| Image Formats | The image format(s) to save each frame of the video as. | [] |
| [straylight]
metric_video_image_formats | |
| Frame Rate | The framerate in frames per second. | 10 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
metric_video_frame_rate |
- Units: fps
- The use of this field is contingent on the value of Video Formats.
|
| Colormapped Image Transform | The transform applied to the data when saving a colormapped metric image. Note: This is only used when the data transform is linear. | Linear |
| [straylight]
metric_video_linear_output_scale |
- The use of this field is contingent on the value of Video Formats.
- The use of this field is contingent on the value of Image Formats.
|
| Colormap | The colormap to apply to the metric image. | MATLAB parula |
- Setting Type: Colormap Enumeration (excluding: MATLAB lines, MATLAB colorcube, MATLAB prism, MATLAB flag)
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
metric_video_colormap |
- The use of this field is contingent on the value of Video Formats.
- The use of this field is contingent on the value of Image Formats.
|
| Flip Colormap | Enable to flip the order of the colormap. | false |
- Setting Type: Boolean
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
metric_video_flip_colormap |
- The use of this field is contingent on the value of Video Formats.
- The use of this field is contingent on the value of Image Formats.
|
| Display Masked Pixels | Enable to display the masked pixels on the color mapped metric image. This significantly slows down the analysis. | false |
- Setting Type: Boolean
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
metric_video_display_mask |
- The use of this field is contingent on the value of Video Formats.
- The use of this field is contingent on the value of Image Formats.
|
Histogram
Histogram
Description
Options for saving histogram images/video(s).
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Video Formats | The format(s) to save the video as. | [] |
| [straylight]
hist_video_video_formats | |
| Image Formats | The image format(s) to save each frame of the video as. | [] |
| [straylight]
hist_video_image_formats | |
| Frame Rate | The framerate in frames per second. | 10 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
hist_video_frame_rate |
- Units: fps
- The use of this field is contingent on the value of Video Formats.
|
| Y-Axis Max Type | The method for determining the upper limit for the y-axis of the histogram plots. | Automatic |
| [straylight]
hist_video_ymax_type |
- The use of this field is contingent on the value of Video Formats.
- The use of this field is contingent on the value of Image Formats.
|
| Y-Axis Max | The user-defined maximum value for the y-axis of histograms. | 1000000 |
- Setting Type: Number
- Setting Size: Scalar
- INI Type: Float
- INI Size: Scalar
| [straylight]
hist_video_ymax_value |
- The use of this field is contingent on the value of Video Formats.
- The use of this field is contingent on the value of Image Formats.
- The use of this field is contingent on the value of Y-Axis Max Type.
|
Result Files
Result Files
Description
Select which result file(s) to save.
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Summary Results Types | The file type(s) to save summary results as. | [JSON] |
| [straylight]
result_save_types | |
Save Location
Save Location
Description
Select where to save the result file(s).
Settings
| Setting | Description | Default | Options/Value Type | INI Key | Notes |
|---|
| Save In Image Folder? | Save in the image folder or a custom folder. | true |
- Setting Type: Boolean
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
save_in_image_folder | |
| Save Subfolder | The sub-folder of the image folder to save the result(s) in. Leave empty to save in image folder. | Results |
- Setting Type: String
- Setting Size: Scalar
- INI Type: String
- INI Size: Scalar
| [straylight]
save_subfolder |
- The use of this field is contingent on the value of Save In Image Folder?.
|
| Custom Save Folder | The folder where to save the result(s). | |
- Setting Type: Folder Path
- Setting Size: Scalar
- INI Type: String
- INI Size: Scalar
| [straylight]
custom_save_folder |
- The use of this field is contingent on the value of Save In Image Folder?.
|
| Use image name as basename? | Enable to use the image filename as the root filename. | true |
- Setting Type: Boolean
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
use_image_as_root | |
| Custom Root Filename | The custom root name of the result file(s). | |
- Setting Type: String
- Setting Size: Scalar
- INI Type: String
- INI Size: Scalar
| [straylight]
custom_root_filename |
- The use of this field is contingent on the value of Use image name as basename?.
|
| Open Results Folder | Enable to open the save folder at the end of each analysis run. | true |
- Setting Type: Boolean
- Setting Size: Scalar
- INI Type: Integer
- INI Size: Scalar
| [straylight]
open_save_folder | |
Enumerations
Analysis Channel: Channel Selection Type Enumeration
Analysis Channel: Channel Selection Type Enumeration
Description
Common types of collections of analysis channels.
Options
| Option | Description | INI Value |
|---|
| Automatic | Automatically choose analysis channel(s). | 0 |
| Each Channel | Analyze each channel in the image. | 1 |
| RGB | Analyze each RGB channel. | 2 |
| Monochrome | Analyze a single channel as monochrome. | 3 |
| Statistics | Analyze a statistic of the provided channels. | 4 |
| Luminance | Analyze the computed luminance channel. | 5 |
| RGB + Luminance | Analyze each RGB channel and the computed luminance channel. | 6 |
| Single Channel | Analyze a single channel. | 7 |
Analysis Channel: Luminance Channel Standards
Analysis Channel: Luminance Channel Standards
Description
The standards for computing a luminance channel from RGB images. See the luminance documentation page for more details on these options.
Options
| Option | Description | INI Value |
|---|
| IEC 61966-2-1 | RGB Weights: 0.2126, 0.7152, 0.0722. These are the same weights as ITU-R BT.709-6. | 1 |
| ITU-R BT.601-7 | RGB Weights: 0.299, 0.587, 0.114. This is sometimes called 'NTSC' Luminance. | 2 |
| ITU-R BT.709-6 | RGB Weights: 0.2126, 0.7152, 0.0722. These are the same weights as IEC 61966-2-1. | 3 |
| ITU-R BT.2020-2 | RGB Weights: 0.2627, 0.678, 0.0593. | 4 |
| Display P3 (D65) | RGB Weights: 0.22897, 0.69174, 0.07929. | 10 |
| ITU-R BT.709-1 | RGB Weights: 0.2125, 0.7154, 0.0721. | 8 |
| NTSC (Rounded) | RGB Weights: 0.3, 0.59, 0.11. This is ITU-R BT.601-7 rounded to 2 significant digits. | 9 |
| MATLAB | RGB Weights: 0.298936, 0.587043, 0.114021. Use MATLAB's rgb2gray function. | 6 |
| Custom RGB Weights | Use custom RGB weights. | 7 |
Analysis Channel: RGB Order
Analysis Channel: RGB Order
Description
The order of RGB data.
Options
| Option | Description | INI Value |
|---|
| Red, Green, Blue | The image data are ordered red, green, blue. | 0 |
| Blue, Green, Red | The image data are ordered blue, green, red. | 1 |
Analysis Channel: Statistics Channels
Analysis Channel: Statistics Channels
Description
Types of statistics.
Options
| Option | Description | INI Value |
|---|
| Mean | Analyze the spectral mean of all channels. | 0 |
| Median | Analyze the spectral median of all channels. | 1 |
Axis Scaling
Axis Scaling
Description
The way to scale the plot axis.
Options
| Option | Description | INI Value |
|---|
| Linear | Use a linear scale on the axis. | 0 |
| Log | Use a logarithmic scale on the axis. | 1 |
Colormap
Colormap
Description
The choice of colormap. See the MATLAB colormap documentation page for more details on these options.
Options
| Option | Description | INI Value |
|---|
| MATLAB parula | The MATLAB parula colormap. | 1 |
| MATLAB turbo | The MATLAB turbo colormap. | 2 |
| MATLAB hsv | The MATLAB hsv colormap. | 3 |
| MATLAB hot | The MATLAB hot colormap. | 4 |
| MATLAB cool | The MATLAB cool colormap. | 5 |
| MATLAB spring | The MATLAB spring colormap. | 6 |
| MATLAB summer | The MATLAB summer colormap. | 7 |
| MATLAB autumn | The MATLAB autumn colormap. | 8 |
| MATLAB winter | The MATLAB winter colormap. | 9 |
| MATLAB gray | The MATLAB gray colormap. | 10 |
| MATLAB bone | The MATLAB bone colormap. | 11 |
| MATLAB copper | The MATLAB copper colormap. | 12 |
| MATLAB pink | The MATLAB pink colormap. | 13 |
| MATLAB sky | The MATLAB sky colormap. | 14 |
| MATLAB abyss | The MATLAB abyss colormap. | 15 |
| MATLAB jet | The MATLAB jet colormap. | 17 |
| MATLAB lines | The MATLAB lines colormap. | 18 |
| MATLAB colorcube | The MATLAB colorcube colormap. | 19 |
| MATLAB prism | The MATLAB prism colormap. | 20 |
| MATLAB flag | The MATLAB flag colormap. | 21 |
Downsample Scale Types
Downsample Scale Types
Description
The method for how to specify the size of the downsampled image.
Options
| Option | Description | INI Value |
|---|
| Full Resolution | Use the full resolution image. | 0 |
| Scale Factor | Select a downsampling factor. | 1 |
| Output Image Size | Select the size of the output image. | 2 |
| Output Image Rows | Select the number of rows of the output image. | 3 |
| Output Image Columns | Select the number of columns of the output image. | 4 |
Geometric Camera Model: Camera Model Type
Geometric Camera Model: Camera Model Type
Description
A description for the camera model.
Options
| Option | Description | INI Value |
|---|
| Simple Pinhole | Use a simple pinhole (no distortion) camera model. The forward (image formation) order of operations is: extrinsics, intrinsics. | 0 |
| Pinhole + Distortion | Use a classic camera model with distortion. The forward (image formation) order of operations is: extrinsics, intrinsics, distortion. | 1 |
| OpenCV | Use an OpenCV camera model. The forward (image formation) order of operations is: extrinsics, distortion, intrinsics. | 2 |
| OpenCV Fisheye | Use an OpenCV fisheye camera model. The forward (image formation) order of operations is: extrinsics, distortion, intrinsics. | 3 |
Geometric Camera Model: Distortion Model Type
Geometric Camera Model: Distortion Model Type
Description
A description for the distortion model.
Options
| Option | Description | INI Value |
|---|
| None | Use no distortion. | 0 |
| Brown-Conrady | Use the Brown-Conrady distortion model. | 1 |
| Radial | Use a radial-only distortion model. | 2 |
Geometric Camera Model: Image Center Type
Geometric Camera Model: Image Center Type
Description
How an image center is specified.
Options
| Option | Description | INI Value |
|---|
| Numeric Image Center | The numeric center of the image. | 0 |
| User-Specified | A user-specified coordinate. | 1 |
| Same as Principal Point | Use the same point as the principal point. | 2 |
Geometric Camera Model: Image Coordinate System
Geometric Camera Model: Image Coordinate System
Description
The description of the image coordinate system. See the image coordinate systems documentation page for more details on these options.
Options
| Option | Description | INI Value |
|---|
| IEEE Std. 2020™ Type I | 0-indexed, origin in lower left. | 1 |
| IEEE Std. 2020™ Type II | 0-indexed, origin in upper left. e.g., OpenCV. | 2 |
| IEEE Std. 2020™ Type III | 1-indexed, origin in lower left. | 3 |
| IEEE Std. 2020™ Type IV | 1-indexed, origin in upper left. e.g., MATLAB. | 4 |
Neutral Density Measurement Type
Neutral Density Measurement Type
Description
Methods of describing a neutral density (ND) measurement.
Options
| Option | Description | INI Value |
|---|
| None | No neutral density filter. | 0 |
| Density | Neutral density filter used, measured in density units. | 1 |
| Transmission | Neutral density filter used, measured in transmission units. | 2 |
Plot Save Format
Description
The format(s) to save a figure as.
Options
| Option | Description | INI Value |
|---|
| JPEG | Joint Photographic Experts Group | 1 |
| PNG | Portable Network Graphics | 2 |
| Compressed TIFF | Compressed Tagged Image File Format | 3 |
| Uncompressed TIFF | Uncompressed Tagged Image File Format | 4 |
| MATLAB Figure | MATLAB Figure | 5 |
| PDF | Portable Document Format | 6 |
| EPS Level 3 Black & White | Encapsulated PostScript Level 3 Black & White | 7 |
| EPS Level 3 Color | Encapsulated PostScript Level 3 Color | 8 |
| EPS Level 2 Black & White | Encapsulated PostScript Level 2 Black & White | 9 |
| EPS Level 2 Color | Encapsulated PostScript Level 2 Color | 10 |
| SVG | Scalable Vector Graphics | 11 |
Radial Distortion Type
Radial Distortion Type
Description
The type of camera radial distortion model.
Options
| Option | Description | INI Value |
|---|
| None | The radial distortion model is none. | 0 |
| Polynomial | The radial distortion model is a polynomial. | 1 |
| Division Polynomial | The radial distortion model is one divided by a polynomial. | 2 |
Saturation Specification
Saturation Specification
Description
The method for how to determine the saturation level.
Options
| Option | Description | INI Value |
|---|
| Container Max | Use the maximum size of the data container. | 0 |
| Image Max | Use the maximum value in the image(s). | 1 |
| Image Max (Power of Two) | Use the maximum value in the image, rounded up to 2ᴺ-1. | 2 |
| Image Max (Even Power of Two) | Use the maximum value in the image, rounded up to 2²ᴺ-1. | 3 |
| User-Specified Bit Depth | Specify the saturation level as a bit depth. | 4 |
| User-Specified Value | Specify the saturation level as a digital number value. | 5 |
| Classic | | 6 |
| ITU-R BT.601 | | 7 |
Save/Display Plot
Save/Display Plot
Description
The option(s) to save and/or display a plot.
Options
| Option | Description | INI Value |
|---|
| Save | Save the plot to disk. | 1 |
| Display | Display the plot on the screen. | 2 |
Stray Light: Calculation Method
Stray Light: Calculation Method
Description
The method for calculating stray light.
Options
| Option | Description | INI Value |
|---|
| Transmission | Calculation is image / normalization factor. | 0 |
| Attenuation | Calculation is normalization factor / image. | 1 |
Stray Light: Count Statistics
Stray Light: Count Statistics
Description
The named count-based stray light metrics.
Options
| Option | Description | INI Value |
|---|
| Total Count | The number of pixels in the image. | 1 |
| Source Count | The number of pixels identified as the light source. | 2 |
| Saturation Count | The number of pixels at or above the saturation level. | 4 |
Stray Light: Count Type
Stray Light: Count Type
Description
The method for reporting count-based stray light metrics.
Options
| Option | Description | INI Value |
|---|
| Number of Pixels | The number of pixels that meet the criteria. | 1 |
| Percent of Pixels | The percentage of the pixels in the focal plane that meet the criteria. | 2 |
Stray Light: Data Transforms
Description
Transforms that applied to the linear stray light measurements.
Options
| Option | Description | INI Value |
|---|
| Linear | Perform no transform. | 0 |
| Log10 | Transform data with a base 10 logarithm. | 1 |
| dB (Power) | Transform data into decibels (10 log10). | 2 |
| dB (Voltage) | Transform data into decibels (20 log10). | 3 |
| Log2 | Transform data with a base 2 logarithm. | 4 |
| Natural Log | Transform data with a natural logarithm. | 5 |
Stray Light: Histogram Y-Axis Maximum
Stray Light: Histogram Y-Axis Maximum
Description
The method for specifying the maximum y-value for histogram plots.
Options
| Option | Description | INI Value |
|---|
| Automatic | Automatically set the limit for each plot. | 1 |
| User-defined | Apply a fixed, user-specified limit for each plot. | 2 |
Stray Light: Level Statistics
Stray Light: Level Statistics
Description
The named level-based stray light metrics.
Options
| Option | Description | INI Value |
|---|
| Minimum | The minimum stray light value. | 1 |
| Minimum (Non-0) | The minimum stray light value corresponding to the image values greater than the dark level. | 2 |
| Maximum | The maximum stray light value. | 4 |
| Mean | The mean stray light value. | 8 |
| Median | The median stray light value. | 16 |
| RMS | The root mean square of the stray light values. | 32 |
| Standard Deviation | The standard deviation of the stray light values. | 64 |
Stray Light: Light Measurement
Stray Light: Light Measurement
Description
The method of light measurement.
Options
| Option | Description | INI Value |
|---|
| Radiometric | Use radiometric light measurements. | 0 |
| Photometric | Use photometric light measurements. | 1 |
Stray Light: Mask Method
Stray Light: Mask Method
Description
The method for masking the light source.
Options
| Option | Description | INI Value |
|---|
| None | Don't mask the source. | 0 |
| Image Processing | Use image processing to mask the source. | 10 |
| Image Processing + Circle | Find the center via Image Processing, then use a circle to mask. | 13 |
| Manually-specified Circle | Create a circular mask around a specified image point. | 2 |
| Geometric Camera Model + Circle | Use a geometric camera model to place the mask. | 4 |
| Same as Analysis Mask Settings | Use the same reference image detection settings as the analysis image mask. Cannot be used with 'None' masking. If the analysis mask is 'Geometric Camera Model + Circle', the source location is assumed to be on-axis. | 5 |
Stray Light: Mask Radius Type
Stray Light: Mask Radius Type
Description
Methods for setting the radius of a circular mask.
Options
| Option | Description | INI Value |
|---|
| User-Specified | The radius is specified in pixels. | 0 |
| Focal Length Ratio | The radius is specified via focal length ratios of the source and camera. | 1 |
Stray Light: Mask Threshold Type
Stray Light: Mask Threshold Type
Description
The method for selecting the mask threshold.
Options
| Option | Description | INI Value |
|---|
| Value | The threshold is in digital numbers. | 0 |
| Percentage of Max | The threshold is a percentage [0-100] of the maximum value. | 1 |
| Otsu's Method | Use Otsu's method to automatically determine a threshold. | 2 |
Stray Light: Masking Multiple Connected Component Strategy
Stray Light: Masking Multiple Connected Component Strategy
Description
The method for dealing with multiple connected components when performing image-processing masking.
Options
| Option | Description | INI Value |
|---|
| Don't Mask | If multiple CCs are found, assume the source is not in the image. | 1 |
| Pick Biggest | Pick the largest of the connected components.This is useful if the other bright image features are small bits of noise. | 2 |
| Pick Smallest | Pick the smallest of the connected components. This is useful if the direct image the source is well-focused relative to other bright image features. Note: this is used after filtering out small regions. | 3 |
| Keep All | Keep all connected components. This is intended to help with diagnosing upstream image processing masking issues. | 4 |
Stray Light: Memory Mode
Stray Light: Memory Mode
Description
The options for prioritizing memory use during a stray light analysis run.
Options
| Option | Description | INI Value |
|---|
| High Memory | Faster analysis that requires all images be stored in memory. | 1 |
| Low Memory | Slower analysis for use with lower memory machines or a large number of images. | 2 |
Stray Light: Metadata from Filename
Stray Light: Metadata from Filename
Description
The method for extracting metadata from a filename.
Options
| Option | Description | INI Value |
|---|
| None | Do not perform a regular expression search. The only way to provide metadata is via a stray light config file. | 0 |
| Regular Expression | Use a single regular expression extract metadata from the filename. The regular expression must contain one or more named capture groups: 'field', 'azimuth', and 'comment'. If enabled, this will overwrite any metadata provided in a stray light config file. | 1 |
Stray Light: Normalization Aggregation
Stray Light: Normalization Aggregation
Description
The method for aggregating the source pixels for image-based normalization.
Options
| Option | Description | INI Value |
|---|
| Mean | Use the arithmetic average (mean) of selected pixels. | 0 |
| Median | Use the median of the selected pixels. | 1 |
| Total | Use the total (sum) of the selected pixels. | 2 |
Stray Light: Normalization Type
Stray Light: Normalization Type
Description
The normalization method for stray light.
Options
| Option | Description | INI Value |
|---|
| None | Perform no normalization. Results will be in digital numbers. | 0 |
| Level | Normalize with a user-provided source level in digital numbers. | 1 |
| Direct Reference Image | Normalize with a reference image of the direct light source (light source is typically on-axis). | 3 |
| Lambertian Reference Image | Normalize with a reference image of the light source with a Lambertian diffuser (light source is typically on-axis). | 4 |
Stray Light: Plot Scaling
Stray Light: Plot Scaling
Description
The method for frame-to-frame scaling of stray light plots and colormapped images.
Options
| Option | Description | INI Value |
|---|
| Global | All frames have the same scaling. | 0 |
| Per Subset | All frames of the same subset (channel) have the same scaling. | 1 |
| Per Image | Each frame of the video will have its own scale. | 2 |
Stray Light: Plotting Channel Subset
Stray Light: Plotting Channel Subset
Description
The subsets of channel(s) to put on each plot.
Options
| Option | Description | INI Value |
|---|
| All Channels On The Same Plot | All channels are plotted on the same plot. | 1 |
| Each Channel On Separate Plots | Each channel is plotted on a separate plot. | 2 |
Summary Results Output Types
Summary Results Output Types
Description
The format(s) of summary results files.
Options
| Option | Description | INI Value |
|---|
| JSON | Save summary results as a JSON file. | 1 |
| CSV | Save summary results as a CSV file. | 2 |
| HDF5 | Save summary results as an HDF5 file. | 4 |
| XML | Save summary results as an XML file. | 3 |
Video Outputs: Image Formats
Description
The image formats for saving each frame of a video.
Options
| Option | Description | INI Value |
|---|
| png | Save as a PNG. | 1 |
| jpg | Save as a JPG. | 2 |
| tiff | Save as a TIFF. | 4 |
Video Outputs: Video Files
Description
The formats for saving a video as.
Options
| Option | Description | INI Value |
|---|
| mp4 | Save as a MP4. Not available on linux. | 1 |
| avi | Save as an AVI. | 2 |
| gif | Save as a GIF. | 4 |
INI Notes
Notes on the formatting of an INI file.
Array
Arrays are stored in the INI file as comma-separated values within square braces. For example, storing a four-element array of the digits 1-4 in the INI will look like: key=[1, 2, 3, 4]
Older modules may use legacy array syntax.
Legacy Array
Legacy arrays are stored in the INI file as space-separated values. For example, storing a four-element array of the digits 1-4 in the INI will look like: key=1 2 3 4
Newer modules (Concentric Rings FOV and Stray Light) may use array syntax.
Boolean
Booleans are stored in the INI file as 0's and 1's. | Value | Ini Syntax |
|---|
true | 1 |
false | 0 |
key=1
Storing false in the INI will look like: key=0
Older modules may use legacy boolean syntax.
Legacy Boolean
Legacy booleans are stored in the INI file as strings. | Value | Ini Syntax |
|---|
true | Max |
false | Min |
key=Max
Storing false in the INI will look like: key=Min
Newer modules (Concentric Rings FOV and Stray Light) may use boolean syntax.
String
Strings are stored in the INI file inside double quotes ("). For example, storing Hello World in the INI will look like: key="Hello World"
Older modules may use legacy string syntax.
Legacy String
Legacy string are stored in the INI file without any extra characters. For example, storing Hello World in the INI will look like: key=Hello World
Newer modules (Concentric Rings FOV and Stray Light) may use string syntax.