Lucy L'LORRI Data Dinkinesh Partially Processed Collection

Data Set Overview
===============================================================================
This collection contains partially processed panchromatic (350 - 850 nm) images
acquired by the L'LORRI instrument during the Lucy Mission Dinkinesh Encounter.
Data acquisition is described in Levison, H.F., Marchi, S., Noll, K.S. et al. A
contact binary satellite of the asteroid (152830) Dinkinesh. Nature 629,
1015–1020 (2024). doi:10.1038/s41586-024-07378-0.

Closest Approach occurred at 17:51:16 UT April 20, 2025 at a distance of 962 km. All tCA 
calculations (time of closest approach) are calculated from this date.

Version 1.0 of this collection was produced in July, 2023, which was before the 
final L'LORRI data processing pipeline was completed, as such version 1.0 products
should be used carefully. Data processing for these products is described in the
Lucy L'LORRI DART Observation Archive User’s Guide V2.0 found in the L'LORRI 
document collection. Caveats and limitations are given in this document.

Version 2.0 of this collection was produced in August 2025 with the production 
version of the L'LORRI data processing pipeline. This is the same pipeline that
produced the L'LORRI Dinkinesh data products. Data processing for these products
is described in the L'LORRI Software Interface Specification (lorri_sis) found
in the L'LORRI document collection. 

Difference between V1.0 and V2.0:

Raw file changes:
1) File-naming convention: e.g., lor_0717462911_02260_eng_01.fit ----> lor_0717462911_02260_00001_4x4_eng_03.fit
    - ObsID Count field has been added after the ObsID field
    - Image format field ("1x1", "4x4") has been added after the ObsID Count field

2) The keyword content of the primary FITS headers (and the PDS4 labels) has been significantly changed/expanded:
    - some formatting has changed, e.g., section separators have been added to improve readability
    - some of the names have been changed, e.g. "INSTRU" ----> "INSTRUME"
    - a lot of new keywords have been added, e.g.:
        - various flavors of exposure start/stop/mid times
        - product description keywords, e.g., processing location, software used, etc.
        - uplink planning information, e.g., command load, mission segment, SAP and visit names, etc.
        - greatly expanded set of geometrical information, states, pointings, rates, targets in FOV, etc.
        - full listing of the SPICE kernels used in the processing
        - expanded WCS section, with inclusion of SIP distortion model coefficients
        - full listings of the image header contents, both raw and converted values
        - section added for S/C-recorded HK, primarily temperature information
        
 3) The "IMAGE HEADER" and "IMAGE DESCRIPTOR" extensions have been modified to give a true apples-to-apples
   comparison of the raw image header contents.  Before, the contents of the image descriptor packet had
   been broken out separately, which made the data arguably more user-friendly but less easy to compare to
   the actual image header.
   
Partially Processed file changes:
Since the partially processed (CDP) pipeline shares similar file-naming to the raw (UDP) pipline, and since
it inherits the contents of the UDP primary header, the changes described in #1 and #2 above for the raw
also apply to the partially processed. In addition to those, there is the following:

1) A new CDP-specific section has been added at the bottom of the primary FITS headers, with the following keyword types:
    - the CDP flag settings used to process the data, e.g., which corrections/calibrations were applied
    - reference files used in the processing (debias image, flat, exposure time offsets)
    - other miscellaneous calibration factors
    The FITS header changes are propogated to the PDS4 .xml label files.


Data Products
===============================================================================
Products contained within this collection are .FITS images described in the
L'LORRI SIS document. Partially processed images are not radiometrically
calibrated, but they are corrected by removing instrument artifacts. See the
documentation for how to radiometrically calibrate these products.

Last Revision
2025-03-18