L'LORRI Liens ============= These liens are for the entire bundle and all collections therein. Liens may not apply or be relevant in all places. SPECIAL_NOTE ============ The final reconstructed Lucy-target ephemeris (SPK) for the Dinkinesh flyby was generated using data dependent on an SCLK kernel (version 29) that had been frozen by the project before the encounter for uplink planning purposes. Compared to later SCLK kernel versions, the version used in processing did not properly account for the drift in the spacecraft clock that occurred during the freeze period. This resulted in an ephemeris timing error of a few tenths of a second. The instrument data products included in this submission were processed using the final SPK noted above, but with a later version of the SCLK kernel (version 33) and with attitude kernels (CKs) whose pointing timings were derived directly from this later SCLK version. The net effect of all this is that there are small errors in the geometry as calculated using NAIF SPICE, and these errors are most significant, small as they are, at the time of encounter close approach. Product labels are affected to the extent they inherit geometric quantities from the data above. The instrument data product portions affected are as follows: (1) header data (keyword/value pairs) related to geometry (ALL products) (2) L’Ralph LEISA "backplane" FITS extension that contains geometry information for each frame (UDP and CDP products) (3) L’TES geometry arrays in CDP products. To mitigate the effect of the geometry timing error, the user may choose to re-calculate the SPICE information using the latest kernel set published in the Lucy SPICE archive. Note that the erroneous SPK was not published to the archive, although SCLK versions 29 and 33 were. During lien resolution, all data will be reprocessed using an updated SPK that corrects the aforementioned timing issue. The geometric reprocessing will use SPK lcy_230815_240201_240101_dinkinesh_reconstruction_final_v2.bsp, which has been delivered to NAIF and appears in the Lucy SPICE archive. Documentation ============= --> Why are the calibration data different compared to the last batch (LUCY DART observation)? --> “The calibration products fall into one of three categories, Flat Field files, Bias files, and T Offset files.” It’s not clear: A. What is the Mottola technique? Where is the description? This should be added to sis.pdf B. Did the calibration include using previously reviewed calibration files, T offsets and superbias? C. Dinky flat over llorri flat, both or one? --> Many documents' labels contain a description of the mission and instrument that needs to be updated with appropriate tense and necessary details. "will be located" >> "is located", "images will" >> "images", "will also be used for" >> "is used for" etc. --> Change "calibrated" to "partially processed" to be consistent. --> In the PDS4 XML label the exposure time is 30 s. And in the files llorri_toffsets_1x1.txt and llorri_toffsets_4x4.txt the exposure time is in ms with a max exposure of 999ms. Difference needs to be explained in SIS if not done so. --> The Texp is an array and should be Texp(i) or Texp(j) in the equation. However, in the equation it looks like a single value. file: calibration/collection_overview.txt --> The collection overview of the calibration is not consistent with the content. file: data_dinkinesh_partially_processed/collection_overview.txt --> Collection_overview.txt copied the raw overview, and needs to be changed accordingly. file: document/leisa_sis.pdf --> the calibrated data processing level is marked as N/A, will this level be available for the main mission phase? file: collection_overview.txt --> Please add the name of the files or the date of observations that correspond to this statement: "Prior to the Encounter phase, L'LORRI Optical Navigation images were taken from tCA = -59 to -5 days. Between tCA = -59 to -45 days, both 1x1 and 4x4 OpNav images are obtained every other day. Between tCA = -44 to -5 days 1x1 OpNav images are obtained at a daily cadence." file: 'document/collection_overview.txt' --> The Documents section mentions that documents are named in one of two ways, the first descriptive, the second being based on Open Access DOI. This second is not the case for filename, nor document title. It then starts to describe what a descriptive case might be, but ends up describing a single case in detail. Please clarify or correct this whole paragraph. Labels ====== --> Add the target NAIF ID if applicable. For (152830) Dinkinesh it is 920152830 (TARGETID in the FITS header). // --> Delete one of this block that you have twice in the raw data Lucy Data Processing Pipeline Lucy Science Operations Center Southwest Research Institute --> The Space Science Reviews paper is part of the document collection. I would remove the citation or add a comment explaining that it is the external source of this document's paper or change it from to --> In partially processed data, use Array_2D_Image for Error Image and Quality Flag Image if it is useful to display these arrays as images (with Display_Settings). --> References to calibration files should be LIDVIDs. --> There is much more information (description, comment, history) and values (current, voltage, temperature, exposure time) for “Raw pixel header values” and “Converted analog values” in the FITS header that would be valuable in the PDS4 XML label. Is this information somewhere else? --> Fix start_date_time and stop_date_time (2021-10Z) for calibration files. If no time is applicable, make N/A. files: Default_config.xml, llorri_flat_plasma_quartz_weighted_Mottola.xml, llorri_flat_plasma_quartz_weighted_rebin_4x4_Mottola.xml --> The Space Science Reviews paper is part of the document collection. Remove the citation or add a comment explaining that it is the external source of this document's paper. --> Make more descriptive. file: dinky_flat_1x1.xml, dinky_flat_4x4.xml --> Missing reference to SSR paper or SIS. file: collection_overview.xml --> Update the date <publication_date>2024-08</publication_date> file: Default_config.xml --> Add <Internal_reference> to the entire document collection instead of putting it in the <description>. file: collection.xml --> I would suggest the <title> to be Lucy LOng Range Reconnaissance Imager (L'LORRI) or to at least add “Lucy” to be consistent with the collection_overview.xml file --> Bundle lucy.mission is not archived yet. Be sure to archive these products and confirm LID reference. I also didn’t see it in the Lucy Mission Document collection <lid_reference>urn:nasa:pds:lucy.mission:document:lucy_mission_info</lid_reference> --> <Reference_List> < Internal_Reference >. Add LIDs and comments for the raw and partially processed data, calibration collection, document collection, overview document. --> <Primary_Result_Summary> Add <Science_Facets> for searchability. --> You have the purpose <purpose>Science</purpose> but Navigation in the PDS4 XML data labels. Multiple purposes can be added if applicable. file: 'bundle.xml' --> Need to add back the Modification_History for Version 1.0. --> For the v1.0 files, it is recommended to update the labels from IM 1.18.0.0 to 1.20.0.0 to match the rest of the collection. In theses cases the label version would change to v1.1 from v1.0. files: 'calibration/*.xml' (data products) --> Should any of these data objects have units? I don't see any specified. EN Review ========= lucy.llorri:calibration *.xml (many, not all) - Suggestion: to match the context products, change <name>Lucy Mission</name> <name>Lucy Spacecraft</name> <name>L'LORRI</name> to <name>Lucy</name> <name>Lucy</name> <name>Lucy Long Range Reconnaissance Imager (L'LORRI)</name> lucy.llorri:data_dinkinesh_partially_processed *.xml - Suggestion: to match the context products, change <name>DINKINESH</name> to <name>(152830) Dinkinesh</name> collection*.xml - Suggestion: to match the context products, change <name>Lucy Mission</name> <name>Lucy Spacecraft</name> to <name>Lucy</name> <name>Lucy</name> collection.xml - The product in this lid_reference isn't given here. Verify the LID is correct urn:nasa:pds:lucy.mission:document:lucy_mission_info In the 2023.05 review, many collection.xml had a lid_reference to urn:nasa:pds:lucy.mission:document:lucymissioninfo lucy.llorri:data_dinkinesh_raw *.xml - Suggestion: to match the context products, change <name>DINKINESH</name> to <name>(152830) Dinkinesh</name> collection*.xml - Suggestion: to match the context products, change <name>Lucy Mission</name> <name>Lucy Spacecraft</name> to <name>Lucy</name> <name>Lucy</name> collection.xml - The product in this lid_reference isn't given here. Verify the LID is correct urn:nasa:pds:lucy.mission:document:lucy_mission_info In the 2023.05 review, many collection.xml had a lid_reference to urn:nasa:pds:lucy.mission:document:lucymissioninfo lucy.llorri:document *.xml - Suggestion: to match the context products, change <name>Lucy Mission</name> <name>Lucy Spacecraft</name> <name>L'LORRI</name> to <name>Lucy</name> <name>Lucy</name> <name>Lucy Long Range Reconnaissance Imager (L'LORRI)</name> - Suggestion: add lid_reference to target collection.xml - The product in this lid_reference isn't given here. Verify the LID is correct urn:nasa:pds:lucy.mission:document:lucy_mission_info In the 2023.05 review, many collection.xml had a lid_reference to urn:nasa:pds:lucy.mission:document:lucymissioninfo Global Liens ============ issue: There are no subdirectory structure, with all products placed at the root of the collection directories. --> TB: Strongly suggest adding some structure for the user that may browse the collection, so as to not overwhelm them with number of files, perhaps unrelated, mixed together. issue: Label Context Reference Mismatch --> The 'name' values associated with internal references to context objects do not match the Context_Area.*.name values as found in the context object file referenced. For targets, it is probably fine to be different if it conforms to SBN formatting. Many of these context files were provided by the Lucy mission, and so it is expected to match. Note, usages are not consistent across all bundles or even files within a bundle or collection (correct in some labels, not in others). Those unique to a particular bundle will be mentioned with that bundle. Lastly, please note that the PDS validate tool will identify all instances of these if you need a complete list of what and where. Examples common across all bundles: --> --> "Lucy Mission" vs "Lucy" (urn:nasa:pds:context:investigation:mission.lucy) --> --> "Lucy Spacecraft" vs "Lucy" (urn:nasa:pds:context:instrument_host:spacecraft.lucy) --> --> "Dinkinesh" or "DINKINESH" vs "(152830) Dinkinesh" (urn:nasa:pds:context:target:asteroid.152830_dinkinesh) issue: Copies of published papers in PDS --> Identification_Area.Citation_Information.doi should not be for the published paper. PDS should never produce a DOI for a paper primarly published elsewhere. --> Add to the Identification_Area.Citation_Information.description the fact these papers of exact copy of open access documents. --> Add to the <Reference_List> an <external_reference> to the published paper and add a description mentioning the relation between the PDS copy and the publish copy. Ex: "Original published source of this Open Access document." --> For any other label referencing these PDS copies in their Reference_List, we should include the external paper doi reference along side the internal reference to the internal copy. issue: Reference_List references missing <comment> or <description>, or not being necessary. --> Whenever you reference a paper in a data product, please add a <description> (for external_reference) or <comment> (for internal_reference) stating very briefly why this paper is being referenced. This can be as simple as saying it is the "SSR paper" or "description of the mission". An example is where the Calibration paper is being referenced; we should add a <description>Calibration paper</description>. For internal references to data products, usually the <reference_type> is clear enough, but this is not the case when referencing documents. If the referenced paper is not considered essential to either understanding or using the product, it should not be referenced. --> --> Example: lucy.leisa/data_dinkinesh_calibrated/lei_0752129330_02298_sci_04.xml (lines 1042-1049, two references) issue: Mission Phase --> Is the mission_phase_name keyword going to be in any of the labels? Suggest adding this to the Lucy LDD, with a standard list of values to validate against. You can use the New Horizons LDD (nh:mission_phase_name) as an example. issue: Adding sb:Calibration_Information --> For the calibrated products, I see that the Reference_List includes the data_to_raw/calibration_product. You can also add this information, plus additional information for the user to the "sb:Calibration_Information". I would highly highly encourage this. files: '*/bundle.xml' --> Suggest removing PDS4 jargon, "Bundle", from Identification_Area.title and replace with "Archive" or something similar. --> Suggest clarifying in the Identification_Area.Citation_Information.description that there are more than just "data products" in these bundles. There are also document products for instance; also Calibration products, though this is a usually a data product of one sort or another. --> Why does each bundle (except mission and rss) have a Reference_List that includes the mission:document, [instrument]:document (which is found within the bundle), and [instrument] SSR paper (found within the bundle)? Are these necessary for the generation of the bundle? If so, why are they not included in the collection.xml files? files: '*/*/collection.xml' --> For the Identification_Area and Citation_Information sub-area, we take these values as what we would want to use for reference and citation information for the PDS product (collection in this case), like titles, authors, editors, and abstract (pds:description). We use these to populate DOI meta data, for assigned DOIs. Please have these values reflect what you would want to see in the DOI meta data, and by consequence at the ADS. --> --> Note that first occurrences of acronyms will be spelled out with the acronym being in parentheses. Ex: "L'LORRI" => "Lucy LOng Range Reconnaissance Imager (L'LORRI)". I would recommend doing this in your bundle/collection labels, in the abstract (pds:description) and/or title. --> Suggest removing PDS4 jargon, "Collection", from Identification_Area.title --> Strongly (on verge of requiring for active missions) suggest adding Funding_Acknowledgement to Identification_Area.Citation_Information. --> <Reference_List> entries are not consistent. Please confirm these are correct. In general there is an internal reference to a copy of Levison et al. (2021) paper and an internal reference to the instrument SIS. Exceptions noted below: --> --> urn:nasa:pds:lucy.llorri:calibration::1.0 (only lists SIS) --> --> urn:nasa:pds:lucy.ltes:document::1.0 lists the instrument SSR paper as well --> --> urn:nasa:pds:lucy.mvic:document::1.0 lists the instrument SSR paper as well --> --> urn:nasa:pds:lucy.mission:document::1.0 lists no references (probably correct) --> Please add to the Reference_List an internal link to the collection_overview product. files: '*/readme.txt' --> At the end of this file it suggests questions can go to "https://pds-smallbodies.astro.umd.edu/about/contact_info.shtml or pds-operator@jpl.nasa.gov". Using this url and/or email sounds like a bad idea. SBN website may move, or the pds-operator may change address. Remove contact info.