PDS_VERSION_ID = PDS3 RECORD_TYPE = STREAM SPACECRAFT_NAME = "DAWN" OBJECT = TEXT INTERCHANGE_FORMAT = ASCII PUBLICATION_DATE = 2015-02-17 NOTE = "VICAR header description" END_OBJECT = TEXT END INTRODUCTION This file describes the organization and content of the label of the Dawn Framing Camera 2 global mosaic images. This label is based on the Video Image Communication and Retrieval (VICAR) image processing label standard. Label items, their meaning and values, are described in this document. VICAR LABEL STRUCTURE The VICAR label consists of one or more records of ASCII text. It is comprised of three groups of descriptive information. Each is detailed in the three sections below. SECTION 1: The System Label The VICAR label is a string of American Standard Code for Information Interchange (ASCII) characters consisting of free-field items of the form "keyword = value" separated by spaces. It contains data set description system information regarding the dimensions, organization and data format. This information is written to the label with the following keywords: LBLSIZE Size of the label in bytes FORMAT Data format (byte, halfword, real, fullword, etc.) TYPE Data set type (image, parameter, histogram, etc.) BUFSIZ Internal blocksize VICAR will use during input/output DIM Data set dimension EOL End-of-dataset label flag RECSIZE Data set record size ORG Data set organization: BSQ - Band Sequential BIL - Band Interleaved by Line BIP - Band Interleaved by Pixel NL Number of lines or records NS Number of samples or record length NB Number of bands or number of data planes NBB Number of binary prefix bytes NLB Number of binary header records N1 Equal to NS N2 Equal to NL for BSQ, NB for BIL and NS for BIP N3 Equal to NB for BSQ, or NL for BIL and BIP N4 Not used HOST Type of computer used to generate the pixel data. INTFMT The format used to represent integers in the file. REALFMT The format used to represent floating numbers. BHOST The type of computer used to generate the binary labels. BINTFMT The integer format used in the binary labels. BREALFMT The floating point format used in the binary labels. BLTYPE The name of the binary label structure. The values of 'HOST' and 'BHOST' are critical to proper interpretation of the file. All 16-bit image data must be byte-swapped if the 'HOST' listed does not use the same 16-bit data representation as the user's computer. The same applies for the 'BHOST' keyword. Note that the binary label structure changed during the Cruise phase when the ISS flight software was upgraded from version 1.2 to 1.3. The value of BLTYPE indicates which binary label structure applies to the given file. SECTION 2: Property Labels All digital images stored in standard VICAR format are preceded by a property label. The label consists of image descriptors stored in ASCII. Flight projects have traditionally designed special label formats to identify the mission, spacecraft, instrument, target, and frame, and to include various camera and image geometry information pertinent to the interpretation of the image. The property labels are attached to each image as it is built from telemetry. For Dawn FC2, the product labels associated with the global mosaics do not follow the same structure of the raw and calibrated image labels which are not archived in VICAR2 format. The labels for these products contain the following keywords: LABEL ITEM DESCRIPTION ---------- -------------- ---- Property: IDENTIFICATION DATA ELEMENTS ---- FILE_NAME=string name of the image file DATA_SET_ID=string PDS supplied identifier for this data set PRODUCT_ID=string unique identifier for this image PRODUCER_INSTITUTION_NAME=string name of the data producing institution INSTRUMENT_HOST_ID=string identifier for the spacecraft INSTRUMENT_HOST_NAME=string name of spacecraft INSTRUMENT_ID=string camera identifier INSTRUMENT_NAME=string name of camera ---- Property: TIME DATA ELEMENTS ---- SPACECRAFT_CLOCK_START_COUNT=string spacecraft clock at the start of the image (N/A) SPACECRAFT_CLOCK_STOP_COUNT=string spacecraft clock at the end of the image (N/A) IMAGE_TIME=date time of shutter close (N/A) START_TIME=date time of shutter close less exposure duration (N/A) STOP_TIME=date time of shutter close (N/A) ---- Property: MAP PROJECTION ELEMENTS ---- A_AXIS_RADIUS=real largest equatorial radius in km B_AXIS_RADIUS=real largest equatorial radius in km C_AXIS_RADIUS=real polar radius in km CENTER_LATITUDE=real latitude value at the center of the image in degrees CENTER_LONGITUDE=real longitude value at the center of the image in degrees COORDINATE_SYSTEM_NAME=string name of the coordinate system used in the image projection COORDINATE_SYSTEM_TYPE=string type of the coordinate system used in the image projection EASTERNMOST_LONGITUDE=real easternmost longitude value of the image in degrees FIRST_STANDARD_PARALLEL=real the first_standard_parallel element is used in conic projections (N/A) LINE_FIRST_PIXEL=int provides the line index for the first pixel that was physically recorded at the beginning of the image array. LINE_LAST_PIXEL=int provides the line index for the last pixel that was physically recorded at the beginning of the image array. LINE_PROJECTION_OFFSET=real provides the line offset value of the map projection origin position from the line and sample 1,1 (line and sample 1,1 is considered the upper left corner of the digital array). Note: that the positive direction is to the right and down. MAP_PROJECTION_ROTATION=real the map_projection_rotation element provides the clockwise rotation, in degrees, of the line and sample coordinates with respect to the map projection origin (line_projection_offset, line_projection_offset) This parameter is used to indicate where 'up' is in the projection. In a polar stereographic projection does the zero meridian go center to bottom, center to top, center to left, or center to right? The polar projection is defined such that the zero meridian goes center to bottom. However, by rotating the map projection, the zero meridian can go in any direction. Note: 180 degrees is at the top of the North Pole and 0 degrees is at the top of the South Pole. For example, if 0 degrees is at the top of the North Pole than the map_projection_rotation would be 180 degrees. MAP_PROJECTION_TYPE=string type of map project (values used are CYLINDRICAL and STEREOGRAPHIC) MAP_RESOLUTION=real map resolution in pixel/degree MAP_SCALE=real map scale in km/pixel MAXIMUM_LATITUDE=real maximum latitude value in degrees MINIMUM_LATITUDE=real minimum latitude value in degrees POSITIVE_LONGITUDE_DIRECTION=string positive longitude direction (EAST or WEST) REFERENCE_LATITUDE=real provides the new zero latitude in a rotated spherical coordinate system that was used in a given map_projection_type. REFERENCE_LONGITUDE=real provides the new zero longitude in a rotated spherical coordinate system that was used in a given map_projection_type. SAMPLE_FIRST_PIXEL=int provides the sample index for the first pixel that was physically recorded at the beginning of the image array. SAMPLE_LAST_PIXEL=int provides the sample index for the last pixel that was physically recorded at the beginning of the image array SAMPLE_PROJECTION_OFFSET=real provides the sample offset value of the map projection origin position from line and sample 1,1 (line and sample 1,1 is considered the upper left corner of the digital array). Note: that the positive direction is to the right and down SECOND_STANDARD_PARALLEL=real the second_standard_parallel element is used in conic projections (N/A) WESTERNMOST_LONGITUDE=real westernmost longitude value of the image in degrees ---- Property: MISCELLANEOUS ELEMENTS ---- TARGET_NAME=string target being imaged FILTER_NUMBER=int number of the filter on the filter wheel CENTER_FILTER_WAVELENGTH=int wavelength at the center of the filter in nm Sample of a Dawn FC2 VICAR global mosaic label for an image using a cylindrical projection ************ VE_HAMO_00N_330E_CYL_CLEAR.IMG ************ PDS_VERSION_ID = PDS3 /* FILE DATA ELEMENTS */ RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 26703 FILE_RECORDS = 13354 LABEL_RECORDS = 2 /* POINTERS TO DATA OBJECTS */ ^IMAGE_HEADER = 3 ^IMAGE = 4 OBJECT = IMAGE INTERCHANGE_FORMAT = BINARY LINES = 13351 LINE_SAMPLES = 26703 SAMPLE_TYPE = UNSIGNED_INTEGER SAMPLE_BITS = 8 BANDS = 1 BAND_STORAGE_TYPE = BAND_SEQUENTIAL END_OBJECT = IMAGE /* IDENTIFICATION DATA ELEMENTS */ FILE_NAME = "VE_HAMO_00N_330E_CYL_CLEAR.IMG" DATA_SET_ID = "DAWN-A-FC2-5-MOSAIC-V1.0" PRODUCT_ID = "VE_HAMO_00N_330E_CYL_CLEAR.IMG" PRODUCT_CREATION_TIME = 2014-11-04T07:55:37 PRODUCER_INSTITUTION_NAME = "GERMAN AEROSPACE CENTER (DLR)" INSTRUMENT_HOST_ID = DAWN INSTRUMENT_HOST_NAME = DAWN INSTRUMENT_ID = FC2 INSTRUMENT_NAME = "FRAMING CAMERA 2" /* TIME DATA ELEMENTS */ SPACECRAFT_CLOCK_START_COUNT = "N/A" SPACECRAFT_CLOCK_STOP_COUNT = "N/A" IMAGE_TIME = "N/A" START_TIME = "N/A" STOP_TIME = "N/A" /* MAP OBJECT DEFINITIONS */ OBJECT = IMAGE_MAP_PROJECTION ^DATA_SET_MAP_PROJECTION_CATALOG= "DSMAP.CAT" A_AXIS_RADIUS = 255.0 B_AXIS_RADIUS = 255.0 C_AXIS_RADIUS = 255.0 CENTER_LATITUDE = 0.0 CENTER_LONGITUDE = 330 COORDINATE_SYSTEM_NAME = PLANETOCENTRIC COORDINATE_SYSTEM_TYPE = "BODY-FIXED ROTATING" EASTERNMOST_LONGITUDE = 150 FIRST_STANDARD_PARALLEL = "N/A" LINE_FIRST_PIXEL = 1 LINE_LAST_PIXEL = 13351 LINE_PROJECTION_OFFSET = 6675.0 MAP_PROJECTION_ROTATION = 0.0 MAP_PROJECTION_TYPE = "SIMPLE CYLINDRICAL" MAP_RESOLUTION = 74.17649312499999 MAP_SCALE = 0.06 MAXIMUM_LATITUDE = 90 MINIMUM_LATITUDE = -90 POSITIVE_LONGITUDE_DIRECTION = EAST REFERENCE_LATITUDE = "N/A" REFERENCE_LONGITUDE = "N/A" SAMPLE_FIRST_PIXEL = 1 SAMPLE_LAST_PIXEL = 26703 SAMPLE_PROJECTION_OFFSET = 13351.0 SECOND_STANDARD_PARALLEL = "N/A" WESTERNMOST_LONGITUDE = -210 END_OBJECT = IMAGE_MAP_PROJECTION /* MISCELLANEOUS */ TARGET_NAME = "4 VESTA" FILTER_NUMBER = "1" CENTER_FILTER_WAVELENGTH = 732 REFERENCE_KEY_ID = ROATSCHETAL2012 DESCRIPTION = "Mosaic from HAMO Clear Filter images in the IAU-approved Claudia Double-Prime longitude system. See the Vesta Coordinate System Document in the document directory of this volume for more information." /* IMAGE HEADER DATA ELEMENTS */ OBJECT = IMAGE_HEADER HEADER_TYPE = VICAR2 INTERCHANGE_FORMAT = ASCII BYTES = 26703 ^DESCRIPTION = "VICAR2.TXT" END_OBJECT = IMAGE_HEADER END Sample of a Dawn FC2 VICAR global mosaic label for an image using a stereographic projection ************ VE_HAMO_90N_150E_STE_CLEAR.IMG ************ PDS_VERSION_ID = PDS3 /* FILE DATA ELEMENTS */ RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 17001 FILE_RECORDS = 17004 LABEL_RECORDS = 2 /* POINTERS TO DATA OBJECTS */ ^IMAGE_HEADER = 3 ^IMAGE = 4 OBJECT = IMAGE INTERCHANGE_FORMAT = BINARY LINES = 17001 LINE_SAMPLES = 17001 SAMPLE_TYPE = UNSIGNED_INTEGER SAMPLE_BITS = 8 BANDS = 1 BAND_STORAGE_TYPE = BAND_SEQUENTIAL END_OBJECT = IMAGE /* IDENTIFICATION DATA ELEMENTS */ FILE_NAME = "VE_HAMO_90N_150E_STE_CLEAR.IMG" DATA_SET_ID = "DAWN-A-FC2-5-MOSAIC-V1.0" PRODUCT_ID = "VE_HAMO_90N_150E_STE_CLEAR.IMG" PRODUCT_CREATION_TIME = 2014-11-03T08:36:46 PRODUCER_INSTITUTION_NAME = "GERMAN AEROSPACE CENTER (DLR)" INSTRUMENT_HOST_ID = DAWN INSTRUMENT_HOST_NAME = DAWN INSTRUMENT_ID = FC2 INSTRUMENT_NAME = "FRAMING CAMERA 2" /* TIME DATA ELEMENTS */ SPACECRAFT_CLOCK_START_COUNT = "N/A" SPACECRAFT_CLOCK_STOP_COUNT = "N/A" IMAGE_TIME = "N/A" START_TIME = "N/A" STOP_TIME = "N/A" /* MAP OBJECT DEFINITIONS */ OBJECT = IMAGE_MAP_PROJECTION ^DATA_SET_MAP_PROJECTION_CATALOG= "DSMAP.CAT" A_AXIS_RADIUS = 255.0 B_AXIS_RADIUS = 255.0 C_AXIS_RADIUS = 255.0 CENTER_LATITUDE = 90.0 CENTER_LONGITUDE = 150 COORDINATE_SYSTEM_NAME = PLANETOCENTRIC COORDINATE_SYSTEM_TYPE = "BODY-FIXED ROTATING" EASTERNMOST_LONGITUDE = 360 FIRST_STANDARD_PARALLEL = "N/A" LINE_FIRST_PIXEL = 1 LINE_LAST_PIXEL = 17001 LINE_PROJECTION_OFFSET = 8500.0 MAP_PROJECTION_ROTATION = 0.0 MAP_PROJECTION_TYPE = STEREOGRAPHIC MAP_RESOLUTION = 74.17649312499999 MAP_SCALE = 0.06 MAXIMUM_LATITUDE = 90 MINIMUM_LATITUDE = 0 POSITIVE_LONGITUDE_DIRECTION = EAST REFERENCE_LATITUDE = "N/A" REFERENCE_LONGITUDE = "N/A" SAMPLE_FIRST_PIXEL = 1 SAMPLE_LAST_PIXEL = 17001 SAMPLE_PROJECTION_OFFSET = 8500.0 SECOND_STANDARD_PARALLEL = "N/A" WESTERNMOST_LONGITUDE = 0 END_OBJECT = IMAGE_MAP_PROJECTION /* MISCELLANEOUS */ TARGET_NAME = "4 VESTA" FILTER_NUMBER = "1" CENTER_FILTER_WAVELENGTH = 732 REFERENCE_KEY_ID = ROATSCHETAL2012 DESCRIPTION = "Mosaic from HAMO Clear Filter images in the IAU-approved Claudia Double-Prime longitude system. See the Vesta Coordinate System Document in the document directory of this volume for more information." /* IMAGE HEADER DATA ELEMENTS */ OBJECT = IMAGE_HEADER HEADER_TYPE = VICAR2 INTERCHANGE_FORMAT = ASCII BYTES = 17001 ^DESCRIPTION = "VICAR2.TXT" END_OBJECT = IMAGE_HEADER END