Appendix 1 – The Radiometric Coefficient files
The Radiometric Coefficient files (or RC-files) are second-order
products obtained from the elaboration of Mastcam-Z radiance-calibrated
cal-target images (see section 3.3). Here we present an example of a
Radiometric Coefficient file. The following RC-file was extracted from a
Mastcam-Z cal-target image in filter L1 (800 nm) on sol 349. In this
example, each line of the RC file, denoted by the initial ‘#’, is
followed by a brief explanation in brackets.
# responsivity constants file:
rc_ZL1__0697919834_0092982ZCAM03014_1.txt
(full-path filename of this file when it was created)
# associated selection filename:
Z00349_0092982ZCAM03014_048018831_FO1.sel
(full-path filename of selection file used to generate these
responsivity constants)
# dust correction: none
(Dust correction model used when generating responsivity constants)
# outliers excluded from selections: Yes
(are ”outliers” excluded from selection regions when generating the
responsivity constants…
There is currently a very strict algorithm defining outliers to be
excluded. It is designed
to exclude hot pixels and the like that may be included in a selection.
It is NOT meant to
be used to ignore inadvertently selected shadows or otherwise bad
selections. The algorithm
operates as follows: Exclusion is determined on a per-channel basis.
Histogram the pixel values
into 11 bins of equal value range from the minimum value to the maximum
value. Find any outlier
bins (bins that are separated from the main cluster of values by one or
more empty bins). Any
values in these outlier bins are considered to be outlier values. If the
total number of
outlier values is <= 10, the mean selection value will be
computed excluding these outlier
values. NOTE: If the number of outlier values is > 10, the
values will not be excluded, instead
the user will be warned of this condition (which usually indicates a
faulty selection), and
prompted to correct it before saving the responsivity constants.)
# force fit to intercept origin: Yes
(fit line is forced to go through the point [0,0])
# RC file creation time: 2022-02-12T18:26:52Z
(timestamp of when this file was created)
# RC file format version: 1.1 2021-12-03
(file format version)
#
# cal-target file:
ZL1_0349_0697919834_098RAD_N0092982ZCAM03014_048085A01.IMG
(full-path or relative-path filename of the RAD-calibrated cal-target
file used
to generate these responsivity constants)
# unique sequence identifier: 00349_zcam03014_01883_001
(unique identifier of the cal-target sequence from which these
responsivity
constants were generated)
# local true solar time: 12:22:03
(LTST of the cal-target image)
# solar azimuth (rover frame): 16.5834
(solar azimuth in rover frame at time of cal-target acquisition)
# solar elevation (rover frame): 64.5552
(solar elevation in rover frame at time of cal-target acquisition)
# fit method: use_only_chip_centers
(method used to fit a line to the selection values. Possibilities are:
use_only_chip_centers
use_all_sunlit_regions: chip centers + sunlit rings
use_only_sunlit_rings
use_all_rings: sunlit rings + ring shadows
use_all_regions: chip centers + sunlit rings + ring shadows)
# ROI names: ”Blue Chip Center” ”Green Chip Center” ”Yellow Chip
Center” ”Red Chip Center” ”Black Chip Center” ”Dark Gray Chip Center”
”Light Gray Chip Center” ”White Chip Center” ”Black Ring” ”Dark Gray
Ring” ”Light Gray Ring” ”White Ring” ”Black Ring Shadow” ”Dark Gray Ring
Shadow” ”Light Gray Ring Shadow” ”White Ring Shadow” ”Black Secondary
Horizontal” ”Dark Gray Secondary Horizontal” ”Light Gray Secondary
Horizontal” ”White Secondary Horizontal” ”Red Secondary Horizontal”
”Green Secondary Horizontal” ”Blue Secondary Horizontal” ”Black
Secondary Vertical” ”Dark Gray Secondary Vertical” ”Light Gray Secondary
Vertical” ”White Secondary Vertical” ”Red Secondary Vertical” ”Green
Secondary Vertical” ”Blue Secondary Vertical” ”Blue Chip Outer” ”Green
Chip Outer” ”Yellow Chip Outer” ”Red Chip Outer” ”Black Chip Outer”
”Dark Gray Chip Outer” ”Light Gray Chip Outer” ”White Chip Outer”
”Gnomon” ”Gold” ”Deck”
(names of all regions)
# ROI is selected: 1 1 1 1 1 1 1 1 1 1 1 1 1 0 0 1 1 1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
(1 if a selection exists for the corresponding named region, else 0)
# ROI marked bad: 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 1
0 0 0 0 0 0 0 0 0 0 1 0 0 0
(1 if a selection for the corresponding named region has been marked bad
and is
not used in the fit, else 0: the selection is allowed to be used in the
fit)
# ROI used in fit: 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
(1 if a selection for the corresponding named region IS used in the fit,
else 0: the selection for this region is not used in the fit. Will be 0
if there is no selection for the corresponding region)
# ROI radiances: 0.034506816 0.039897159 0.10376279 0.10554330
0.022406472 0.056729008 0.092273153 0.12006555 0.025852364 0.056776047
0.088735089 0.12321232 0.014249836 NaN NaN 0.044461299 0.025365373
0.058788035 0.096467562 0.12703149 0.10993537 0.042618129 0.039442647
0.014147431 0.039987970 0.069789968 0.095307037 0.079999320 0.027067456
0.024401680 0.030651826 0.030116336 0.031713024 0.032213278 0.030008674
0.031119999 0.030178478 0.033819154 0.014333907 0.058045797 0.10957697
(mean of USED values in each selected region - regions with no selection
will have NaN)
# ROI uncertainty: 0.0011226007 0.0011313090 0.0022528207 0.0015802836
0.0012730183 0.0015016926 0.0018925177 0.0026042091 0.0012016993
0.0013950781 0.0029164302 0.0034273181 0.0010719281 NaN NaN 0.0017609603
0.0010725553 0.0020828459 0.0047955393 0.0069235163 0.0071730291
0.0012393190 0.0010976408 0.00051002479 0.0011881783 0.0020589134
0.0032437530 0.0027616147 0.00083441847 0.00063337773 0.0025638362
0.0025350361 0.0040774076 0.0044082675 0.0027280322 0.0040012537
0.0036807128 0.0043153809 0.0029024197 0.0022435802 0.0033396325
(standard deviation of USED values in each selected region - will be NaN
if no selection)
# ROI count: 73 65 74 70 64 61 63 66 1517 3239 799 2239 56 0 0 100 906
882 870 872 872 870 859 1270 503 1236 1250 1250 430 1199 463 446 461 434
409 391 399 414 459 522 1732
(number of USED pixels in each selected region)
# ROI incidence angle: 25.444830 25.444830 25.444830 25.444830
25.444830 25.444830 25.444830 25.444830 25.444830 25.444830 25.444830
25.444830 25.444830 25.444830 25.444830 25.444830 25.444830 25.444830
25.444830 25.444830 25.444830 25.444830 25.444830 65.683873 65.683873
65.683873 65.683873 65.683873 65.683873 65.683873 25.444830 25.444830
25.444830 25.444830 25.444830 25.444830 25.444830 25.444830 25.444830
25.444830 25.444830
(Angle between the vector from the region to the sun and region surface
normal for each region)
# ROI emission angle: 58.310048 58.310048 58.310048 58.310048 58.310048
58.310048 58.310048 58.310048 58.310048 58.310048 58.310048 58.310048
58.310048 58.310048 58.310048 58.310048 55.257824 55.257824 55.257824
55.257824 55.257824 55.257824 55.257824 37.229207 37.229207 37.229207
37.229207 37.229207 37.229207 37.229207 58.310048 58.310048 58.310048
58.310048 58.310048 58.310048 58.310048 58.310048 58.310048 58.310048
58.310048
(Angle between the vector from the region to the detector and the region
surface normal for each region)
# ROI azimuth angle: 30.933419 30.933419 30.933419 30.933419 30.933419
30.933419 30.933419 30.933419 30.933419 30.933419 30.933419 30.933419
30.933419 30.933419 30.933419 30.933419 31.807842 31.807842 31.807842
31.807842 31.807842 31.807842 31.807842 28.666222 28.666222 28.666222
28.666222 28.666222 28.666222 28.666222 30.933419 30.933419 30.933419
30.933419 30.933419 30.933419 30.933419 30.933419 30.933419 30.933419
30.933419
(Angle in the plane of the region surface between the vector from the
region to the sun
and the vector from the region to the detector)
# reflectances: 0.19100898 0.20369039 0.78817137 0.77029269 0.077399921
0.35798268 0.66099199 0.96044053 0.077399921 0.35798268 0.66099199
0.96044053 0.096936364 NaN NaN 0.95641705 0.077704355 0.35960730
0.66544664 0.96462831 0.77566164 0.20423820 0.19140617 0.075323097
0.33880119 0.62680637 0.92161635 0.70466609 0.19663292 0.18165617
0.19100898 0.20369039 0.78817137 0.77029269 0.077399921 0.35798268
0.66099199 0.96044053 NaN NaN NaN
(Calculated reflectance for each region. Nan if there is no selection or
no lab reflectance model for the region)
# camera id, filter number, rad-to-iof scaling factor, uncertainty
4007 1 6.9130400 0.39587878
(camera id, filter number, calculated rad-to-iof scaling factor,
uncertainty in the scaling factor)