This is a Python parser to read Object Description Language labels from NASA PDS3 archives. The full standards reference
There are already numerous readers to parse PDS ODL labels . This is a simple, no bloat, no dependency but fault intolerant reader. To read LBL files or the ODL header in an IMG file, use odl.ODL().
import odl, json
# Class to read
label_parser = odl.ODL()
# Parse into a dictionary with group elements separated by /'s.
with open('samples/3039ML0158730000507144C00_DRXX.IMG', 'r' ) as infile:
label = label_parser.parse(infile)
print( json.dumps(label,indent=2) )Sample parse to JSON
PDS_VERSION_ID = PDS3
/* FILE DATA ELEMENTS */
RECORD_TYPE = FIXED_LENGTH
RECORD_BYTES = 2656
FILE_RECORDS = 3563
LABEL_RECORDS = 11
/* Pointers to Data Objects */
^IMAGE = 12
/* Identification Data Elements */
MSL:ACTIVE_FLIGHT_STRING_ID = "B"
DATA_SET_ID = "MSL-M-MASTCAM-4-RDR-IMG-V1.0"
DATA_SET_NAME = "MSL MARS MAST CAMERA 4 RDR IMAGE V1.0"
COMMAND_SEQUENCE_NUMBER = 0
GEOMETRY_PROJECTION_TYPE = RAW
IMAGE_ID = "3039ML0158730000507144C00"
IMAGE_TYPE = REGULAR
MSL:IMAGE_ACQUIRE_MODE = IMAGE
INSTRUMENT_HOST_ID = MSL
INSTRUMENT_HOST_NAME = "MARS SCIENCE LABORATORY"
INSTRUMENT_ID = MAST_LEFT
INSTRUMENT_NAME = "MAST CAMERA LEFT"
INSTRUMENT_SERIAL_NUMBER = "3003"
FLIGHT_SOFTWARE_VERSION_ID = "1105031458"
INSTRUMENT_TYPE = "IMAGING CAMERA"
INSTRUMENT_VERSION_ID = FM
MSL:LOCAL_MEAN_SOLAR_TIME = "Sol-03039M14:00:29.161"
LOCAL_TRUE_SOLAR_TIME = "13:23:54"
MISSION_NAME = "MARS SCIENCE LABORATORY"
MISSION_PHASE_NAME = "EXTENDED SURFACE MISSION"
OBSERVATION_ID = "NULL"
PLANET_DAY_NUMBER = 3039
INSTITUTION_NAME = "MALIN SPACE SCIENCE SYSTEMS"
PRODUCT_CREATION_TIME = 2021-02-22T20:41:55.833
PRODUCT_VERSION_ID = "V1.0"
PRODUCT_ID = "3039ML0158730000507144C00_DRXX"
SOURCE_PRODUCT_ID = "McamLImage_0667283696-56760-1"
MSL:INPUT_PRODUCT_ID = "1"
...
/* IMAGE DATA ELEMENTS */
OBJECT = IMAGE
INTERCHANGE_FORMAT = BINARY
LINES = 1184
LINE_SAMPLES = 1328
SAMPLE_TYPE = MSB_UNSIGNED_INTEGER
SAMPLE_BITS = 16
BANDS = 3
BAND_STORAGE_TYPE = BAND_SEQUENTIAL
FIRST_LINE = 17
FIRST_LINE_SAMPLE = 161
INVALID_CONSTANT = "NULL"
MINIMUM = "NULL"
MAXIMUM = "NULL"
MEAN = "NULL"
MEDIAN = "NULL"
STANDARD_DEVIATION = "NULL"
MISSING_CONSTANT = "NULL"
SAMPLE_BIT_MASK = 2#0000111111111111#
SAMPLE_BIT_MODE_ID = MMM_LUT0
SAMPLE_BIT_METHOD = "HARDWARE"
END_OBJECT = IMAGE
END
{
"PDS_VERSION_ID": "PDS3",
"RECORD_TYPE": "FIXED_LENGTH",
"RECORD_BYTES": "2656",
"FILE_RECORDS": "3563",
"LABEL_RECORDS": "11",
"^IMAGE": "12",
"MSL:ACTIVE_FLIGHT_STRING_ID": "\"B\"",
"DATA_SET_ID": "\"MSL-M-MASTCAM-4-RDR-IMG-V1.0\"",
"DATA_SET_NAME": "\"MSL MARS MAST CAMERA 4 RDR IMAGE V1.0\"",
"COMMAND_SEQUENCE_NUMBER": "0",
"GEOMETRY_PROJECTION_TYPE": "RAW",
"IMAGE_ID": "\"3039ML0158730000507144C00\"",
"IMAGE_TYPE": "REGULAR",
"MSL:IMAGE_ACQUIRE_MODE": "IMAGE",
"INSTRUMENT_HOST_ID": "MSL",
"INSTRUMENT_HOST_NAME": "\"MARS SCIENCE LABORATORY\"",
"INSTRUMENT_ID": "MAST_LEFT",
"INSTRUMENT_NAME": "\"MAST CAMERA LEFT\"",
"INSTRUMENT_SERIAL_NUMBER": "\"3003\"",
"FLIGHT_SOFTWARE_VERSION_ID": "\"1105031458\"",
"INSTRUMENT_TYPE": "\"IMAGING CAMERA\"",
"INSTRUMENT_VERSION_ID": "FM",
"MSL:LOCAL_MEAN_SOLAR_TIME": "\"Sol-03039M14:00:29.161\"",
"LOCAL_TRUE_SOLAR_TIME": "\"13:23:54\"",
"MISSION_NAME": "\"MARS SCIENCE LABORATORY\"",
"MISSION_PHASE_NAME": "\"EXTENDED SURFACE MISSION\"",
"OBSERVATION_ID": "\"NULL\"",
"PLANET_DAY_NUMBER": "3039",
"INSTITUTION_NAME": "\"MALIN SPACE SCIENCE SYSTEMS\"",
"PRODUCT_CREATION_TIME": "2021-02-22T20:41:55.833",
"PRODUCT_VERSION_ID": "\"V1.0\"",
"PRODUCT_ID": "\"3039ML0158730000507144C00_DRXX\"",
"SOURCE_PRODUCT_ID": "\"McamLImage_0667283696-56760-1\"",
"MSL:INPUT_PRODUCT_ID": "\"1\"",
"IMAGE/INTERCHANGE_FORMAT": "BINARY",
"IMAGE/LINES": "1184",
"IMAGE/LINE_SAMPLES": "1328",
"IMAGE/SAMPLE_TYPE": "MSB_UNSIGNED_INTEGER",
"IMAGE/SAMPLE_BITS": "16",
"IMAGE/BANDS": "3",
"IMAGE/BAND_STORAGE_TYPE": "BAND_SEQUENTIAL",
"IMAGE/FIRST_LINE": "17",
"IMAGE/FIRST_LINE_SAMPLE": "161",
"IMAGE/INVALID_CONSTANT": "\"NULL\"",
"IMAGE/MINIMUM": "\"NULL\"",
"IMAGE/MAXIMUM": "\"NULL\"",
"IMAGE/MEAN": "\"NULL\"",
"IMAGE/MEDIAN": "\"NULL\"",
"IMAGE/STANDARD_DEVIATION": "\"NULL\"",
"IMAGE/MISSING_CONSTANT": "\"NULL\"",
"IMAGE/SAMPLE_BIT_MASK": "2#0000111111111111#",
"IMAGE/SAMPLE_BIT_MODE_ID": "MMM_LUT0",
"IMAGE/SAMPLE_BIT_METHOD": "\"HARDWARE\""
}record_type = label.get( 'RECORD_TYPE' ) # returns "FIXED_LENGTH"
num_lines = label.get( 'IMAGES/LINES') # returns 1184 as a stringrecord_type = label.get( 'RECORD_TYPE' ) # returns "FIXED_LENGTH"
num_lines = label.get( 'IMAGES/LINES', cast=int ) # returns 1184 as an integerWhile the return of parse() is a dictionary, it might be useful to fetch the values with a cast on retrieval. This is especially useful if the values are an array. All elements are converted. Use the parser instead of the dictionary.
label_parser.get_array( 'PROCESSING_PARMS/RADIANCE_SCALING_FACTOR', cast=float )
[0.0001693, 0.0001568, 0.0001463]
There are two functions that will convert ISO 8660 time strings (common in PDS3 archive labels).
- odl.ISOC converts times in calendar format like 2021-02-22T20:41:55.833
- odl.ISOD converts times in day of year format like Sol-03039M14:00:29.161
label_parser.get( 'START_TIME', cast=odl.ISOC )
datetime.datetime(2021, 2, 22, 17, 19, 39, 36000)
label_parser.get( 'MSL:LOCAL_MEAN_SOLAR_TIME', cast=odl.ISOD )
(3039, datetime.time(14, 0, 29, 161000))You can use samples/get_samples.sh or by hand with
curl -O 'https://planetarydata.jpl.nasa.gov/img/data/msl/MSLMST_0031/DATA/RDR/SURFACE/3531/3531ML1023500011404703C00_DRXX.LBL
curl -O 'https://planetarydata.jpl.nasa.gov/img/data/msl/MSLMST_0031/DATA/RDR/SURFACE/3531/3531ML1023500011404703C00_DRXX.IMG