PDS_VERSION_ID = PDS3 RECORD_TYPE = STREAM OBJECT = TEXT INTERCHANGE_FORMAT = ASCII PUBLICATION_DATE = 2000-03-17 NOTE = "Explanation of labels for STARDUST Navcam Preflight Calibration PDS images labels." END_OBJECT = TEXT END Example label ============= PDS_VERSION_ID = PDS3 /*** FILE FORMAT ***/ RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 2092 FILE_RECORDS = 1034 /*** POINTERS TO OBJECTS IN FILE ***/ ^IMAGE_HISTOGRAM = 3 ^IMAGE = 11 /*** GENERAL DATA DESCRIPTION PARAMETERS ***/ MISSION_NAME = "STARDUST" SPACECRAFT_NAME = "STARDUST" DATA_SET_ID = "STARDUST-CAL-NC-2-PREFLIGHT-V1.0" OBSERVATION_NAME = "CALIBRATION AT MINUS 30 DEGRESS C" OBSERVATION_TYPE = "-30" PRODUCT_ID = "NC370034.IMG" ORIGINAL_PRODUCT_ID = "usd9898-144754.pds" PRODUCER_INSTITUTION_NAME = "JPL/ACT" PRODUCT_TYPE = "EDR" SOFTWARE_NAME = "ACT DMAPKTDECOM 1.0" MISSION_PHASE_NAME = "PREFLIGHT CALIBRATION" TARGET_NAME = "CALIMG" FRAME_SEQUENCE_NUMBER = 34 /*** TIME PARAMETERS ***/ START_TIME = 1998-04-08T14:47:54 STOP_TIME = "N/A" PRODUCT_CREATION_TIME = 2000-02-25T02:06:51 /*** CAMERA RELATED PARAMETERS ***/ INSTRUMENT_NAME = "NAVIGATION CAMERA" INSTRUMENT_ID = "NC" EXPOSURE_DURATION = 0.020 CAL_LAMP_MODE_ID = "OFF" QUANTIZATION_MODE_ID = "OFF" FILTER_NUMBER = "7" FILTER_NAME = "HiRes" CENTER_FILTER_WAVELENGTH = 596.4 FILTER_FWHM = 200.0 /*** CALIBRATION EQUIPMENT PARAMETERS ***/ MEASUREMENT_SOURCE_DESC = "KEITHLY 607 ELECTROMETER" RADIANCE = 0.981 /*** TEMPERATURE PARAMETERS IN ***/ INSTRUMENT_TEMPERATURE = 306.95 FOCAL_PLANE_TEMPERATURE = 243.15 /*** DESCRIPTION OF OBJECTS CONTAINED IN THE FILE ***/ OBJECT = IMAGE_HISTOGRAM ITEMS = 4096 DATA_TYPE = MSB_UNSIGNED_INTEGER ITEM_BITS = 32 END_OBJECT = IMAGE_HISTOGRAM OBJECT = IMAGE LINES = 1024 LINE_SAMPLES = 1024 SAMPLE_TYPE = MSB_UNSIGNED_INTEGER SAMPLE_BITS = 16 SAMPLE_BIT_MASK = 2#0000111111111111# MAXIMUM = 3063 MINIMUM = 603 LINE_PREFIX_BYTES = 20 LINE_SUFFIX_BYTES = 24 MEAN = 859.588 STANDARD_DEVIATION = 64.9859 SATURATED_PIXELS = 0 CHECKSUM = 50501490 END_OBJECT = IMAGE END General notes regarding label ============================= * Strings appear in quotes. * Integers and PDS Times do not take quotes. * Lists are enclosed within {} type brackets. * If a field is unknown, "UNK" may be entered. * If a field is not applicable, "N/A" may be entered. * Fields can spill freely, with or without white space, onto following lines. Definition of Keywords/Values from the PDS Data Dictionary: ====================================================================== PDS_VERSION_ID The pds_version_id Keywords indicates the version number of the PDS standards documents that is valid when a data product label is created. Values for the PDS_VERSION_ID are formed by appending the integer for the latest version number to the letters 'PDS'. Examples: PDS3, PDS4. RECORD_TYPE The record_type keyword indicates the record format of a file. Note: In the PDS, when record_type is used in a detached label file it always describes its corresponding detached data file, not the label file itself. The use of record_type along with other file-related data elements is fully described in the PDS Standards Reference. RECORD_BYTES The record_bytes keyword indicates the number of bytes in a physical file record, including record terminators and separators. FILE_RECORDS The file_records keyword indicates the number of physical file records, including both label records and data records. ^IMAGE_HISTOGRAM The image_histogram object represents a pointer to the image histogram. The value is in "RECORD_BYTE" units. This represents the record at which the histogram data begins. Because of this fact, account for one less than the number of records shown. As an example, if the pointer value is 4, and the bytes per record is 2092, the image histogram data starts at (4-1)*2092 = 6276 bytes. ^IMAGE The ^image pointer represents a byte offset to the image data. The value is in "RECORD_BYTE" units. This represents the record at which the image data begins. Because of this fact, account for one less than the number of records shown. As an example, if the pointer value is 11, and the bytes per record is 2092, the image histogram data starts at byte 29020. MISSION_NAME The mission_name element identifies a major planetary mission or project. A given planetary mission may be associated with one or more spacecraft. SPACECRAFT_NAME The spacecraft_name element provides the full, unabbreviated name of a spacecraft. DATA_SET_ID The data_set_id element is a unique alphanumeric identifier for a data set or a data product. The data_set_id value for a given data set or product is constructed according to flight project naming conventions. In most cases the data_set_id is an abbreviation of the data_set_name. Example value: STARDUST-CAL-NC-2-PREFLIGHT-V1.0. Note: In the PDS, the values for both data_set_id and data_set_name are constructed according to standards outlined in the Standards Reference. OBSERVATION_NAME The observation_name element provides the identifier for an observation or sequence of commands. For this dataset, this keyword has 3 possibilities, based on the day the calibration was completed: 4/08/98 "CALIBRATION AT MINUS 30 DEGRESS C" 4/09/98 "CALIBRATION AT MINUS 40 DEGRESS C" 4/10/98 "CALIBRATION AT MINUS 50 DEGRESS C" OBSERVATION_TYPE The observation_type element identifies the general type of an observation. This keyword has 3 possibilities, based on the day the calibration was completed: 4/08/98 "-30" 4/09/98 "-40" 4/10/98 "-50" PRODUCT_ID The product_id data element represents a permanent, unique identifier assigned to a data product by its producer. Note: In the PDS, the value assigned to product_id must be unique within its data set. This value represents the actual name of the image file on the archive. The output directory is also available. ORIGINAL_PRODUCT_ID The original_product_id element provides the temporary product identifier that was assigned to a product during active flight operations which was eventually replaced by a permanent id (see product_id). In this dataset, this value represents the original filename recorded by the calibration equipment. This name can be linked back to the original calibration log files. PRODUCER_INSTITUTION_NAME The producer_institution_name element identifies a university, research center, NASA center or other institution associated with the production of a data set. This would generally be an institution associated with the element producer_full_name. In this dataset, this field has the value "JPL/ACT", described as: JPL = Jet Propulsion Laboratory. ACT = Applied Coherent Technology Corp. PRODUCT_TYPE The product_type data element identifies the type or category of a data product within a data set. Examples: EDR, UDR. SOFTWARE_NAME The software_name element identifies data processing software such as a program or a program library. MISSION_PHASE_NAME The mission_phase_name element provides the commonly-used identifier of a mission phase. TARGET_NAME The target_name element identifies a target. The target may be a planet, satellite, ring, region, feature, asteroid or comet. See target_type. In this calibration dataset, the target is "CALIMG". FRAME_SEQUENCE_NUMBER The frame_sequence_number element indicates the location within a cycle at which a specific frame occurs. Frames are repeated in a specific order within each cycle. In this dataset, this value represents a uniquly sequential identifier assigned to each image of the archive. START_TIME The start_time element provides the date and time of the beginning of an event or observation (whether it be a spacecraft, ground-based, or system event) in UTC system format. Formation rule: YYYY-MM-DDThh:mm:ss. STOP_TIME The stop_time element provides the date and time of the end of an observation or event (whether it be a spacecraft, ground-based, or system event) in UTC system format. Formation rule: YYYY-MM-DDThh:mm:ss. PRODUCT_CREATION_TIME The product_creation_time element defines the UTC system format time when a product was created. Formation rule: YYYY-MM-DDThh:mm:ss. INSTRUMENT_NAME The instrument_name element provides the full name of an instrument. Note: that the associated instrument_id element provides an abbreviated name or acronym for the instrument. INSTRUMENT_HOST_NAME The instrument_host_name element provides the full name of the host on which an instrument is based. This host can be either a spacecraft or an earth base. Thus, the instrument_host_name element can contain values which are either spacecraft_name values or earth_base_name values. INSTRUMENT_ID The instrument_id element provides an abbreviated name or acronym which identifies an instrument. Note: The instrument_id is not a unique identifier for a given instrument. Note also that the associated instrument_name element provides the full name of the instrument. EXPOSURE_DURATION The exposure_duration element provides the value of the time interval between the opening and closing of an instrument aperture (such as a camera shutter). CAL_LAMP_MODE_ID The cal_lam_mode_id element provides the value of the calibration lamp mode at the time the image was acquired. This value indicates whether the calibration lamp was on or off at the time the image was acquired. QUANTIZATION_MODE_ID The quantization_mode_id element provides the identifier for the quantization mode used when the image was acquired. This value indicates if the original data was quantized at the time the data was acquired. A value of "off" indicates that the data was not quantized, while a value of "on" indicates that the data was quantized. In this dataset, this value indicates that the image was compressed with a hardware square-root compression technique prior to transmission. FILTER_NUMBER The filter_number element provides the number of an instrument filter through which an image or measurement was acquired or which is associated with a given instrument mode. Note: that the filter_number is unique, while the filter_name is not. FILTER_NAME The filter_name element provides the commonly- used name of the instrument filter through which an image or measurement was acquired or which is associated with a given instrument mode. Example values: RED, GREEN. See also filter_number. CENTER_FILTER_WAVELENGTH The center_filter_wavelength element provides the mid_point wavelength value between the minimum and maximum instrument filter wavelength values. FILTER_FWHM The filter_fwhm element provides the measurement for the Full-width, half-max value associated with the filter. This is the width of the filter transmission curve at the point of half of the maximum transmission value. MEASUREMENT_SOURCE_DESC The measurement_source_desc element describes the source of light used in a laboratory-generated data set, or the radar transmitter in the case of radar astronomy experiments. RADIANCE The radiance element describes the amount of current recorded from the photo-diode detector used to measure the radiance output from the source emitter. INSTRUMENT_TEMPERATURE The instrument_temperature element provides the temperature, in degrees Celcius, of an instrument or some part of an instrument. FOCAL_PLANE_TEMPERATURE The focal_plane_temperature element provides the temperature of the focal plane array in degrees kelvin at the time the observation was made. OBJECT = IMAGE_HISTOGRAM The histogram object is a sequence of numeric values that provides the number of occurrences of a data value or a range of data values in a data object. The number of items in a histogram will normally be equal to the number of distinct values allowed in a field of the data object. (For example, an 8-bit integer field can have 256 values. This would result in a 256-item histogram.) Histograms may be used to bin data, in which case an offset and scaling factor indicate the dynamic range of the data represented. The following equation allows the calculation of the range of each 'bin' in the histogram. 'bin lower boundary' = ('bin element' * scaling_factor) + offset. ITEMS The items element defines the number of multiple, identical occurrences of an single object, such as a column. See also: repetitions. Note: In the PDS, the data element ITEMS is used for multiple occurrences of a single object, such as a column. REPETITIONS is used for multiple occurrences of a repeating group of objects, such as a container. For a fuller description of the use of these data elements, please refer to the Standards Reference. DATA_TYPE The data_type element supplies the internal representation and/or mathematical properties of a value being stored. See also: bit_data_type, general_data_type. Note: In the PDS, users may find a bit-level description of each data type in the Standards Reference document. ITEM_BITS The item_bits element indicates the number of bits allocated for a particular bit data item. Note: In the PDS, the item_bits element is used when the items element specifies multiple occurrences of an implied item within a BIT_COLUMN object definition. END_OBJECT The end_object element terminates the object description. OBJECT = IMAGE A regular array of sample values. Image objects are normally processed with special display tools to produce a visual representation of the sample values. This is done by assigning brightness levels or display colors to the various sample values. Images are composed of LINES and SAMPLES. They may contain multiple bands, in one of several storage orders. Note: Additional engineering values may be prepended or appended to each LINE of an image, and are stored as concatenated TABLE objects, which must be named LINE_PREFIX and LINE_SUFFIX. IMAGE objects may be associated with other objects, including HISTOGRAMs, PALETTEs, HISTORY, and TABLEs which contain statistics, display parameters, engineering values, or other ancillary data. LINES The lines element indicates the total number of data instances along the vertical axis of an image. Note: In PDS label convention, the number of lines is stored in a 32-bit integer field. The minimum value of 0 indicates no data received. LINE_SAMPLES The line_samples element indicates the total number of data instances along the horizontal axis of an image. SAMPLE_TYPE The sample_type element indicates the data storage representation of sample value. SAMPLE_BITS The sample_bits element indicates the stored number of bits, or units of binary information, contained in a line_sample value. SAMPLE_BIT_MASK The sample_bit_mask element identifies the active bits in a sample. Note: In the PDS, the domain of sample_bit_mask is dependent upon the currently-described value in the sample_bits element and only applies to integer values. For an 8-bit sample where all bits are active the sample_bit_mask would be 2#11111111#. MAXIMUM The maximum element indicates the largest value occurring in a given instance of the data object. MINIMUM The minimum element indicates the smallest value occurring in a given instance of the data object. LINE_PREFIX_BYTES The line_prefix_bytes element indicates the number of non-image bytes at the beginning of each line. The value must represent an integral number of bytes. LINE_SUFFIX_BYTES The line_suffix_bytes element indicates the number of non-image bytes at the end of each line. This value must be an integral number of bytes. MEAN The mean element provides the average of the DN values in the image array. STANDARD_DEVIATION The standard_deviation element provides the standard deviation of the DN values in the image array. SATURATED_PIXELS The saturated_pixels element provides a count of the number of pixels in the array which at the maximum DN value. For this dataset, the non-quantized data has a maximum value of 4095, while the quantized data has a maximum value of 255. CHECKSUM The checksum element represents an unsigned 32-bit sum of all data values in a data object. END End of the PDS Label.