Mars 2020 Mastcam-Z Release Notes Users are encouraged to provide comments to the PDS Imaging Node if errors are found either in data or in documentation in this archive. Please send comments by e-mail or U.S. mail to: PDS Cartography and Imaging Sciences Node U.S.G.S. Astrogeology Team 2255 North Gemini Drive Flagstaff, AZ 86001 U.S.A (928) 556-7126 Web: https://pds-imaging.jpl.nasa.gov/ Email: pds-img-usgs@usgs.gov This document, mastcamz_release_notes.txt, contains release notes and errata concerning the Mars 2020 Mastcam-Z Sci Calibrated bundle. It is updated with each release of Mastcam-Z data. Section A of this document contains an entry for each Mastcam-Z release with general information about the contents of the release, in order from newest to oldest. Updates to previously released files are reported in these entries, along with any known errata. Section B of this file contains general notes, if any, concerning the archive as a whole. ******** SECTION A: RELEASE-SPECIFIC INFORMATION ******** ------------------------------------------------------------------------------- Release Number:3 Release Date: 2022-03-22 Data Coverage: 2021-08-22 through 2021-12-22 (Sols 180 to 299) New products have been added to these collections: urn:nasa:pds:mars2020_mastcamz_sci_calibrated:data urn:nasa:pds:mars2020_mastcamz_sci_calibrated:browse urn:nasa:pds:mars2020_mastcamz_sci_calibrated:document Products have been revised in these collections: urn:nasa:pds:mars2020_mastcamz_sci_calibrated:document 1. General comments The Mastcam-Z release 1 filename matching document (mastcamz_release1_image_mapping.csv) has been revised and delivered with this release. This will serve as a guide from data downlaoded from the old bundle structure prior to the release 2 revision of sol 0-89 products. There are 3 sols(193, 208, 209) which have thumbnail products (instead of the full resolution image), where the image products were deleted from the camera DEA (memory) prior to downlinking. Mars solar conjunction occured over sols 216 to 235. During this time no seqeunces were executed due to DSN downlink availablility. Zstack merge products for sols 192(zcam00050), 196(zcam00056) & 297(zcam00060) were RAD calibrated but were not IOF calibrated. These products get merged onboard the rover in the DEA as a new product (EZS) from the associated EDRs and the non-merged products are available in both RAD and IOF. 2. Recovered products There are several sols with products which were recovered from the rover at different encoding (ex. JPEG 50 vs uncompressed) or were recovered tactically. Recovered products were downlinked for imaging and video seqeunces and are distinguishable through the label (Ex. a recovered right image will have MczRRecoveredProduct in the label where the original (non-recovered) image has MczRImage). Sols Sequences ----- --------- 181 zcam08199 156 zcam07221 193 zcam05085 207 zcam08236 208 zcam08237 208 zcam08238 208 zcam08240 209 zcam08242 For every recovered product there is a corresponding identical non-recovered product (Thumbnail or full resolution image). 3. Cloned products There are several sols with products which were cloned from the rover at different encoding (ex. JPEG 50 vs uncompressed) or were recovered tactically. Cloned products were downlinked for imaging and video seqeunces and are virtually indistinguishable through the label (Ex. a cloned right image will have MczRImage in the label where the original (non-cloned) image also has MczRImage). Sols Seqeunces ---- --------- 238 zcam08261 237 zcam05086 264 zcam01004 279 zcam01005 For every cloned product there is a corresponding identical non-cloned product (full resolution image). 4. Known label keyword issues Known label keyword issues are present for all sols in this release. The following ODL3 label keywords can report incorrect values when sequences are built using the first image to set up the commanding and indicate no change for the images that follow. ODL3 Keyword Description ------------------------------ --------------------------------- INSTRUMENT_ZOOM_POSITION_COUNT This can incorrectly report as "0" when commanded in a group of images where all products are using the same zoom position. The actual zoom position count value can be found in the ZOOM_POSITION_COUNT keyword or by looking in the label of the first image acquired in the sequence. COMMANDED_FOCAL_LENGTH This can incorrectly report as "26.0 " when commanded in a group of images where all products are using the same focal length. The actual focal length value can be found in the FOCAL_LENGTH keyword or by looking in the label of the first image acquired in the sequence. INSTRUMENT_FOCUS_MODE This keyword is unreliable. To determine if an image was commanded using manual or autofocus you should look to the INSTRUMENT_FOCUS_STEPS and INSTRUMENT_FOCUS_STEP_SIZE keywords. If “INSTRUMENT_FOCUS_STEPS = 1” and “INSTRUMENT_FOCUS_STEP_SIZE = 6” The image was commanded using manual focus, if “INSTRUMENT_FOCUS_STEPS = 0” and “INSTRUMENT_FOCUS_STEP_SIZE = 0” there is no change from the previous image in a sequence and you should look to the first image acquired in the sequence, otherwise it was commanded using autofocus. Four keywords in the ODL3 label and are not present in the PDS4 XML label. NONLINEAR_PIXEL_THRESH NONLINEAR_THRESH SATURATED_PIXEL_THRESH 5. Unexpected scene and image content Some images did not contain their intended target or the target was unobservable. The issues reported below are from error tracking during tactical shifts. sol Sequence Description ----- --------- ------------------------------------------------------------ 191 zcam01008 Sky surey images occluded by arm in 3 frames. 205 zcam08229 Saturated, as commanded, to image the shadowed textue. 239 zcam01004 Reached "keep out zone", was unable to aquire 1L 1R frame 251 zcam05065 This sequence did not execute due to arm fault 251 zcam05066 This sequence did not execute due to arm fault 251 zcam05067 This sequence did not execute due to arm fault 263 zcam03255 Arm hardware occlusion due to arm fault 263 zcam03256 Arm hardware occlusion due to arm fault 264 zcam03255 Saturated and mispointed due to arm fault 264 zcam03256 Saturated and mispointed due to arm fault 280 zcam05065 This sequence did not execute due to arm fault 280 zcam05066 This sequence did not execute due to arm fault 280 zcam05067 This sequence did not execute due to arm fault 283 zcam08305 Unexpected pointing due to drive fault 288 zcam05065 This sequence did not execute due to arm fault 288 zcam05066 This sequence did not execute due to arm fault 288 zcam05067 This sequence did not execute due to arm fault 6. Browse products The current browse_asu products use unbayered data to generate the png. Some artifacts due to wavelength response are to be expected. These will be addressed in future releases. -------------------------------------------------------------------------------- Release Number:2 Release Date: 2021-11-22 Data Coverage: 2021-05-22 through 2021-08-21 (Sols 90 to 179) The Mastcam-Z bundle structure has changed since release 1, read more in the general comments section below. New products have been added to these collections: urn:nasa:pds:mars2020_mastcamz_sci_calibrated:data urn:nasa:pds:mars2020_mastcamz_sci_calibrated:browse urn:nasa:pds:mars2020_mastcamz_sci_calibrated:document urn:nasa:pds:mars2020_mastcamz_sci_calibrated:miscellaeneous Products have been revised in these collections: None. 1. General comments This release has a new bundle structure to better accomadate all of the Mastcam-Z data products. The old bundle urn:nasa:pds:mars2020_mastcamz has been broken down into 6 bundles with all of Mastcam-Z ASU calibrated products in this bundle urn:nasa:pds:mars2020_mastcamz_sci_calibrated including associated documentation. The first release was entirely reprocessed at all levels (EDR, RAD etc..) due to a filename issue where the sclk was misreported in the filenames. Sols 9-55 were affected and release 2 includes all of the reprocessed release 1 data (sols 0-89). The RAD calibration process was also updated with; new shutter frame model coefficients, ODL header updates, improved sky flats, improved flat fileding for the solar filters. 2. Recovered products There are several sols with products which were recovered from the rover at different encoding (ex. JPEG 50 vs uncompressed) or were recovered tactically. Recovered products were downlinked for imaging and video seqeunces and are distinguishable through the label (Ex. a recovered right image will have MczRRecoveredProduct in the label where the original (non-recovered) image has MczRImage). Sols Sequences ----- --------- 0058 zcam05032 0061 zcam05036 0136 zcam08143 For every recovered product there is a corresponding identical non-recovered product (full resolution image). 3. Known label keyword issues Known label keyword issues are present for all sols in this release. The following ODL3 label keywords can report incorrect values when sequences are built using the first image to set up the commanding and indicate no change for the images that follow. ODL3 Keyword Description ------------------------------ --------------------------------- INSTRUMENT_ZOOM_POSITION_COUNT This can incorrectly report as "0" when commanded in a group of images where all products are using the same zoom position. The actual zoom position count value can be found in the ZOOM_POSITION_COUNT keyword or by looking in the label of the first image acquired in the sequence. COMMANDED_FOCAL_LENGTH This can incorrectly report as "26.0 " when commanded in a group of images where all products are using the same focal length. The actual focal length value can be found in the FOCAL_LENGTH keyword or by looking in the label of the first image acquired in the sequence. INSTRUMENT_FOCUS_MODE This keyword is unreliable. To determine if an image was commanded using manual or autofocus you should look to the INSTRUMENT_FOCUS_STEPS and INSTRUMENT_FOCUS_STEP_SIZE keywords. If “INSTRUMENT_FOCUS_STEPS = 1” and “INSTRUMENT_FOCUS_STEP_SIZE = 6” The image was commanded using manual focus, if “INSTRUMENT_FOCUS_STEPS = 0” and “INSTRUMENT_FOCUS_STEP_SIZE = 0” there is no change from the previous image in a sequence and you should look to the first image acquired in the sequence, otherwise it was commanded using autofocus. Four keywords in the ODL3 label and are not present in the PDS4 XML label. NONLINEAR_PIXEL_THRESH NONLINEAR_THRESH SATURATED_PIXEL_THRESH SATURATED_THRESH 4. Known product issues There are two different products (Video vs Recovered Video) with a matching filename. The A06 version is a video product and the A05 is a recovered video product. The recovered products listed below are not in the archive since PDS archives the highest version available. This is a JPL pipeline issue and will be fixed in a future release. The Video product does have the same scene and same compression as the Recovered Video. File CDPID Product Type ---------------------------------------------------------- ----- ------------- ZR0_0058_0672089454_625RAD_N0032046ZCAM05032_034050A05.IMG 3219 MczRRecovered ZR0_0058_0672089454_625RAD_N0032046ZCAM05032_034050A06.IMG 3219 MczRVideo ZR0_0058_0672089461_625RAD_N0032046ZCAM05032_034050A05.IMG 3222 MczRRecovered ZR0_0058_0672089461_625RAD_N0032046ZCAM05032_034050A06.IMG 3222 MczRVideo ZR0_0058_0672089468_625RAD_N0032046ZCAM05032_034050A05.IMG 3225 MczRRecovered ZR0_0058_0672089468_625RAD_N0032046ZCAM05032_034050A06.IMG 3225 MczRVideo ZR0_0058_0672089478_500RAD_N0032046ZCAM05032_034050A05.IMG 3229 MczRRecovered ZR0_0058_0672089478_500RAD_N0032046ZCAM05032_034050A06.IMG 3229 MczRVideo ZR0_0058_0672089454_625IOF_N0032046ZCAM05032_034050A05.IMG 3219 MczRRecovered ZR0_0058_0672089454_625IOF_N0032046ZCAM05032_034050A06.IMG 3219 MczRVideo ZR0_0058_0672089461_625IOF_N0032046ZCAM05032_034050A05.IMG 3222 MczRRecovered ZR0_0058_0672089461_625IOF_N0032046ZCAM05032_034050A06.IMG 3222 MczRVideo ZR0_0058_0672089468_625IOF_N0032046ZCAM05032_034050A05.IMG 3225 MczRRecovered ZR0_0058_0672089468_625IOF_N0032046ZCAM05032_034050A06.IMG 3225 MczRVideo ZR0_0058_0672089478_500IOF_N0032046ZCAM05032_034050A05.IMG 3229 MczRRecovered ZR0_0058_0672089478_500IOF_N0032046ZCAM05032_034050A06.IMG 3229 MczRVideo 5. Unexpected scene and image content Some images did not contain their intended target or the target was unobservable The issues reported below are from error tracking during tactical shifts. sol Sequence Description ----- --------- ------------------------------------------------------------ 0090 zcam08051 Autofocus failure 0092 zcam00033 Autofocus failure 0093 zcam00034 Autofocus failure 0135 zcam08140 Autofocus failure, mispointed showing more hardware than expected 0142 zcam05065 This seqeunce was unable to execute due to a thermal fault 0142 zcam05066 This seqeunce was unable to execute due to a thermal fault 0142 zcam05073 This seqeunce was unable to execute due to a thermal fault 0143 zcam05065 This seqeunce was unable to execute due to post-turret cleaning 0143 zcam05066 This seqeunce was unable to execute due to post-turret cleaning 0143 zcam05073 This seqeunce was unable to execute due to post-turret cleaning 0145 zcam05065 This seqeunce was unable to execute due to an arm fault 0145 zcam05066 This seqeunce was unable to execute due to an arm fault 0145 zcam05073 This seqeunce was unable to execute due to an arm fault 0148 zcam01010 Mispointed, still met science intent 0153 zcam07221 Images are out of focus 0163 zcam08171 Target in shadow, still met science intent 0170 zcam08183 Mispointed, still met science intent 6. Missing ZCAM products Some products were missed in the preparation of this release and therfore were not ASU calibrated. These will be included in a future release. sol Seqeunce Quantity ----- ---------- ----------------- 0047 zcam05001 1 video product 0048 zcam05008 2 video products 0050 zcam05022 1 video product 0072 zcam08032 2 image products 7. Browse products The current browse_asu products use unbayered data to generate the png. Some artifacts due to wavelength response are to be expected. These will be addressed in future releases. -------------------------------------------------------------------------------- Release Number:1 Release Date: 2021-08-20 Data Coverage: 2021-02-18 through 2021-05-21 (Sols 0 to 89) New products have been added to these collections: urn:nasa:pds:mars2020_mastcamz:data_asu urn:nasa:pds:mars2020_mastcamz:browse_asu urn:nasa:pds:mars2020_mastcamz:document Products have been revised in these collections: None. 1. General comments Only RAD calibrated products have been included in this release, IOF calibrated products will be available in the second release. There are 9 sols(49,50,55,58,61,64,68,69,76) which have thumbnail products (instead of the full resolution image), where the video image products were deleted from the camera DEA (memory) prior to downlinking. Some image filenames in sols 1,2,3,and 4 have 'AUT' in place of 'ZCAM'. This is a known idio of cruise flight software. To determine the sequence, see the filename and label of the first image acquired. These products also have 'Scidata' in place of 'Image; in the labels. 2. Recovered products There are several sols with products which were recovered from the rover at different encoding (JPEG 50 vs uncompressed) or were recovered tactically. Recovered products were downlinked for imaging and video seqeunces and are distinguishable through the label (Ex. a recovered right image will have MczRRecoveredProduct in the label where the image has MczRImage). Sols Sequences ----- --------- 0011 zcam00015 0015 zcam07000 0047 zcam05001 0048 zcam05008 0049 zcam05009 0050 zcam05022 0055 zcam05009 0058 zcam05032 0061 zcam05036 0064 zcam05042 0067 zcam05050 0068 zcam05053 0069 zcam05053 0076 zcam05060 For every recovered product there is a corresponding identical non-recovered product (thumbnail or full resolution image). 3. Known label keyword issues Known label keyword issues are present for all sols in this release. The following ODL3 label keywords can report incorrect values when sequences are built using the first image to set up the commanding and indicate no change for the images that follow. ODL3 Keyword Description ------------------------------ --------------------------------- INSTRUMENT_ZOOM_POSITION_COUNT This can incorrectly report as "0" when commanded in a group of images where all products are using the same zoom position. The actual zoom position count value can be found in the ZOOM_POSITION_COUNT keyword or by looking in the label of the first image acquired in the sequence. COMMANDED_FOCAL_LENGTH This can incorrectly report as "26.0 " when commanded in a group of images where all products are using the same focal length. The actual focal length value can be found in the FOCAL_LENGTH keyword or by looking in the label of the first image acquired in the sequence. INSTRUMENT_FOCUS_MODE This keyword is unreliable. To determine if an image was commanded using manual or autofocus you should look to the INSTRUMENT_FOCUS_STEPS and INSTRUMENT_FOCUS_STEP_SIZE keywords. If “INSTRUMENT_FOCUS_STEPS = 1” and “INSTRUMENT_FOCUS_STEP_SIZE = 6” The image was commanded using manual focus, if “INSTRUMENT_FOCUS_STEPS = 0” and “INSTRUMENT_FOCUS_STEP_SIZE = 0” there is no change from the previous image in a sequence and you should look to the first image acquired in the sequence, otherwise it was commanded using autofocus. Four keywords in the ODL3 label and are not present in the PDS4 XML label. NONLINEAR_PIXEL_THRESH NONLINEAR_THRESH SATURATED_PIXEL_THRESH SATURATED_THRESH 4. Known product issues There are two different products with a matching filename. The A02 version is a video product and the A03 is a recovered video product. The recovered product does not correspond to the video product as shown below by their CDPIDs. File CDPID Product Type ------------------------------------------------------ ----- -------------------- ZR0_0047_0671111038_503RAD_N0031416ZCAM05001_048050A02 1957 MczRVideo ZR0_0047_0671111038_503RAD_N0031416ZCAM05001_048050A03 1956 MczRRecoveredProduct 5. Unexpected scene and image content Some images did not contain their intended target or the target was unobservable The issues reported below are from error tracking during tactical shifts. sol Sequence Description ----- --------- ------------------------------------------------------------ 0023 zcam03003 Autofocus failure 0024 zcam08001 Autofocus failure 0026 zcam03004 Exposure commanding mistake for Z34 & Z79 L0 R0 subframes 0031 zcam05001 Video sequence was cutoff, 123/286 GOPs(group of pictures) acquired 0033 zcam08006 Mispointed 0041 zcam01504 Autofocus failure 0047 zcam05007 Autofocus failure 0054 zcam00901 Recover sequence was cutoff, 150/154 frames acquired 0055 zcam05016 Autofocus failure 0056 zcam05020 Autofocus failure 0057 zcam05030 Autofocus failure 0058 zcam05030 Autofocus failure 0063 zcam05037 Autofocus failure 0063 zcam05038 Autofocus failure 0063 zcam05039 Autofocus failure 0064 zcam05040 Autofocus failure 0066 zcam05045 Minor artifacts in the top few rows of the left frames 0067 zcam05050 Minor artifacts in the top few rows of the left frames 0070 zcam03121 Mispointed due to RSM motion fault, autofocus failure 0070 zcam03014 Mispointed due to RSM motion fault, autofocus failure 0070 zcam03122 Mispointed due to RSM motion fault, autofocus failure 0074 zcam05057 Ghosted residual charge, images look doubled. Minor artifacts in the top few rows of the left frames 0076 zcam05060 Minor artifacts in the top few rows of the left frames 0088 zcam08047 More hardware in frame than intended 6. Missing ZCAM products Some products were missed in the preparation of this release and therfore were not ASU calibrated. These will be included in a future release. sol Seqeunce Quantity ----- ---------- ----------------- 0031 zcam05001 1 video product 0048 zcam05008 3 video products 7. Browse products The current browse_asu products use unbayered data to generate the png. Some artifacts due to wavelength response are to be expected. These will be addressed in future releases. -------------------------------------------------------------------------------- ******** SECTION B: GENERAL INFORMATION FOR ALL RELEASES ******** 1. General comments There is visible charge buildup in the first few frames of a video sequence. This is understood and expected behavior. There are sols which have thumbnail products (instead of the full resolution image), where the image products were deleted from the camera DEA (memory) prior to downlinking. These sols are noted in the corresponding release section for affected sol. Some image filenames in sols 1,2,3,and 4 have 'AUT' in place of 'ZCAM'. This is a known idio of cruise flight software. To determine the sequence, see the filename and label of the first image acquired. These products also have 'Scidata' in place of 'Image' in the labels. Some IOF calibrated products appear to be more yellow. This is a known issue from the caltarget used for calibration. This does not affect the validity of the product and will be corrected in a future release.