home *** CD-ROM | disk | FTP | other *** search
/ Space Science Sampler 2 / NASASpaceScienceSamplerV2.cdr / planet / saturn / vgrform.txt < prev    next >
Encoding:
Text File  |  1987-04-09  |  39.2 KB  |  888 lines

  1. NJPL1I00PDS000000000
  2. FILE_TYPE                      = TEXT
  3. RECORD_TYPE                    = STREAM
  4. END
  5.  
  6. EEliason/USGS/Flagstaff, Az.                             1987/Mar/01
  7.   
  8.  
  9.  
  10.                    VOYAGER IMAGE FILE ORGANIZATION
  11.                    -------------------------------
  12.  
  13.  
  14. INTRODUCTION
  15. ------------
  16.  
  17.      This compact read-only disc (CDROM) contains digital images 
  18. acquired by the Voyager 1 and 2 spacecraft.  The image collection
  19. contains scenes of the planets Jupiter and Saturn, including
  20. images of their rings and satellites.  The image data are raw; 
  21. no radiometric, geometric, or data clean-up procedures have been 
  22. applied to the images.  
  23.  
  24.      Digital images and their associated supplementary information 
  25. are organized as direct-access files with fixed-length records.  
  26. Image files are made up of three components; a label section, an 
  27. image array, and a trailer section.  The label section contains ASCII 
  28. keyword entries which describe file attributes, camera conditions, 
  29. target, time of observation, and other parameters.  The image array
  30. contains the image data and supplemental line information. The 
  31. trailer section contains supplemental engineering data.  
  32.  
  33.      The disc volume and directory structure conforms to level-1 
  34. of the NISO Standard for Read-Only Optical Media (formerly the 
  35. High-Sierra format).
  36.  
  37.  
  38. CDROM Volume and Directory Structure
  39. ------------------------------------------
  40.  
  41.      The volume and directory structure on this CDROM conforms to the 
  42. proposed American National Standard for Information Sciences--Volume
  43. and File Structure of CDROM for Information Interchange as of August
  44. 27, 1986.  This standard is informally known as the High-Sierra 
  45. format.
  46.  
  47.      This disc conforms to level-1 of the High-Sierra.  For computer 
  48. operating systems which support the High-Sierra standard, access to 
  49. the CDROM volume will be simple; all of the operating system 
  50. capabilites which handle files and directories will work on the disc. 
  51. Thus, directory listings and file copy functions can be performed, 
  52. and high-level language input/output system-interface routines can be 
  53. utilized.  For computer systems which do not support the High-Sierra 
  54. standard, access to the image files will be more difficult; special 
  55. operating system input/output routines will need to be developed in 
  56. order to access the files. For more information on the NISO
  57. volume and directory structure, consult the document shown below:
  58.  
  59.    "Proposed American National Standard for Information Sciences--
  60.    Volume and File Structure of CDROM for Information Interchange",
  61.    Document DL 87-47, Developed in coordination with the National 
  62.    Information Standards Organization, National Bureau of Standards, 
  63.    Administration 101, Library E-106, Gaithersburg, MD 20899
  64.  
  65.  
  66. IMAGE FILES AND DIRECTORY STRUCTURE
  67. -----------------------------------
  68.  
  69.      Each digital image and its associated supplementary information 
  70. (image identification, location, and characteristics) are stored in 
  71. a single file. The name of the file is constructed from the clock 
  72. count of Voyager's Flight Data Sub-system (FDS) at the time the image 
  73. was acquired. The FDS count is a unique identification associated 
  74. with an image frame. The general form of an image file name is 
  75. Cxxxxxxx.IMG.  The character "C" at the begining of the file name 
  76. designates the xxxxxxx as a clock count.  The xxxxxxx is the seven 
  77. digit FDS count associated with the image frame.  The .IMG file 
  78. extension specifies the file as an uncompressed image file.
  79.  
  80.  
  81.  
  82. IMAGE FILE ORGANIZATION
  83. -----------------------
  84.  
  85.  
  86.      The image files conform to NASA's Planetary Data System (PDS)
  87. format guidelines for the archival of digital planetary images.  PDS 
  88. image files are organized as direct-access files containing 
  89. contiguously positioned fixed-length records. This organization was 
  90. adopted to provide file access for programs written in a wide variety 
  91. of high-level languages. Many high-level input/output routines 
  92. support direct-access with fixed-length records. For computer 
  93. operating systems which support the High-Sierra volume and directory 
  94. standard, programmers will not need to develop their own low-level 
  95. routines for accessing the files. In addition, direct-access files 
  96. allow any part of a file to be accessed directly without the need to 
  97. sequentially pass through a file. PDS image files are a subset of a
  98. multi-dimensional file structure being defined by PDS.
  99.  
  100.      Direct-access files with fixed-length records have implied 
  101. records; there is no information in the file designating the start 
  102. or end of a record.  Rather, the first byte of a record within a 
  103. file starts at a fixed offset byte position from the start of the 
  104. file.  To determine the record byte-offset position, the following 
  105. calculation can be made:
  106.  
  107.  
  108.                  OFF = (REC-1)*LEN
  109.  
  110.           where: OFF = offset byte of record from start of file
  111.                  REC = desired record to access (REC=1,2,3,...805)
  112.                  LEN = length of record in bytes
  113.  
  114.  
  115.  
  116.      A PDS image file is divided into three areas: a label area 
  117. found at the start of file, an image area immediately following the 
  118. label area, and a trailer area found at the end of the file.  Each 
  119. of these areas is constructed from an integral number of fixed-length 
  120. records.  The label area is constructed in an ASCII keyword format 
  121. and contains information defining file characteristics, identifying 
  122. the image frame, defining the state of the camera, and other 
  123. parameters.  The image section consists of line records; each 
  124. fixed-length record in this area contains an image scan-line and its 
  125. line engineering data.  The trailer section contains detailed 
  126. supplemental engineering data for the image frame. 
  127.  
  128.      Voyager image files on this CDROM volume contain records of 
  129. length 836 bytes with 805 records in the file. Records 1 and 2 
  130. contain the label area; records 3 through 802, for a total of 800 
  131. records, contain the image area; and records 803 through 805 
  132. contain the trailer area.
  133.  
  134.  
  135.  
  136. IMAGE LABEL AREA AND KEYWORD ENTRIES
  137. ------------------------------------
  138.  
  139.      The first two fixed-length records in an image file contain the 
  140. keyword label area with information about the file organization, 
  141. image identification, image target, and camera instrument 
  142. characteristics at the time the image frame was recorded.  The two 
  143. records, when concatenated together, consist of a contiguous string 
  144. of 1672 ASCII characters which can be extracted and typed to a
  145. terminal or printed in normal fashion. The label area contains a 
  146. series of keyword entries of the form;
  147.  
  148.               parameter_name = value   /* comment
  149.  
  150.    The keyword label area conforms to the PDS label standard as of 
  151. January 1, 1987.  The PDS label standard was considered preliminary 
  152. at this time, and subject to future changes.  For a detailed 
  153. description of the PDS syntactic rules, consult the PDS Labels 
  154. Standards Document. A brief description of the image label syntactic 
  155. rules is given in Appendix 1. An example of the keyword entries for 
  156. a Voyager image file follows; a description of each keyword entry is 
  157. provided in Appendix 2.
  158.     
  159.            Keyword entries found on an image file
  160.            --------------------------------------
  161.  
  162.      NJPL1I00PDS000672960          = PDS_SFDU_LABEL
  163.      /*    FILE CHARACTERISTICS
  164.      FILE_TYPE                     = IMAGE
  165.      RECORD_TYPE                   = FIXED_LENGTH           
  166.      RECORD_BYTES                  = 836                    
  167.      FILE_RECORDS                  = 805                    
  168.      LABEL_RECORDS                 = 2
  169.      IMAGE_RECORDS                 = 800 
  170.      TRAILER_RECORDS               = 3
  171.      /*    IMAGE ARRAY CHARACTERISTICS
  172.      IMAGE_LINES                   = 800
  173.      LINE_SAMPLES                  = 800                    
  174.      LINE_SUFFIX_BYTES             = 36                     
  175.      SAMPLE_BITS                   = 8                      
  176.      SAMPLE_BIT_MASK               = 2#11111111#
  177.      /*    IMAGE DESCRIPTION
  178.      SPACECRAFT_NAME               = VOYAGER_2
  179.      MISSION_PHASE                 = URANUS_ENCOUNTER
  180.      TARGET_BODY                   = MIRANDA
  181.      FRAME_ID                      = '1699U2-001'
  182.      SPACECRAFT_CLOCK_COUNT        = 26846.11 /*FLIGHT DATA SUBSYSTEM
  183.      SPACECRAFT_EVENT_TIME         = 1986/01/24-16:39:09 <UTC>
  184.      EARTH_RECEIVED_TIME           = 1986/01/25-22:18:04 <UTC>
  185.      INSTRUMENT_NAME               = NARROW_ANGLE_CAMERA
  186.      INSTRUMENT_SCAN_RATE          = '1:1'
  187.      INSTRUMENT_SHUTTER_MODE       = NAONLY  
  188.      INSTRUMENT_GAIN_STATE         = LOW
  189.      INSTRUMENT_EDIT_MODE          = '1:1'   /*FULL RESOLUTION
  190.      INSTRUMENT_FILTER_NAME        = CLEAR
  191.      INSTRUMENT_FILTER_NUMBER      = 0
  192.      INSTRUMENT_EXPOSURE_DURATION  = 1.92000 <SECONDS>
  193.      END
  194.  
  195.  
  196.  
  197. IMAGE AREA
  198. -----------
  199.  
  200.    The image area is located in records 3 through 802 for a total 
  201. of 800 records. Each record in this area is a line record consisting 
  202. of an image scan-line and the engineering data for the scan-line.  
  203. The IMAGE_RECORDS keyword in the label defines the total number of 
  204. records in the image area, always 800 for Voyager frames. The 
  205. IMAGE_LINES keyword, also 800, indicates the total number of 
  206. scan-lines in the image array. The IMAGE_RECORDS and the IMAGE_LINES 
  207. keywords are required in PDS labels because there may be multiple 
  208. records per image line for other instruments. The LINE_SAMPLES 
  209. keyword, always 800, indicates the number of samples in a single line 
  210. of the image array. Byte positions 1 through 800 of a record contain 
  211. the image line data. The LINE_SUFFIX_BYTES keyword, always 36, 
  212. specifies the number of bytes of engineering data which follows the 
  213. image line data. The line engineering data is located in byte 
  214. positions 801 through 836. A description of the line engineering 
  215. data can be found in Appendix 3. 
  216.  
  217.  
  218. IMAGE TRAILER AREA
  219. ------------------
  220.  
  221.      The image trailer area is located in records 803 through 805 for 
  222. a total of 3 records.  The 3 records, when concatentated together, 
  223. consist of a contiguous string of 2508 bytes.  The data in the 
  224. trailer contains supplemental engineering data which typically will 
  225. not be used by most image processing users.  Information in this area 
  226. includes the image histogram, FDS counts at start and end of image 
  227. acquisition, system noise levels, synchronization error counts, 
  228. engineering status, subcommand loads, and other engineering 
  229. information.  A description of  the image trailer area can be found 
  230. in Appendix 4.
  231.  
  232.  
  233.  
  234.  
  235.                             APPENDIX 1    
  236.                             ----------
  237.  
  238.  
  239. SYNTACTIC RULES OF KEYWORD ENTRIES IN LABEL AREA
  240. ------------------------------------------------
  241.  
  242.      The first two fixed-length records of an image file contain the 
  243. label area.  These two records, when concatentated together, consist 
  244. of a continuous string of 1672 ASCII characters.  The label area 
  245. contains a series of keyword entries containing the names of 
  246. parameters and their associated values.  Each keyword entry is 
  247. contained on a line separated from the next keyword entry by an ASCII 
  248. carriage-return control character followed by a line-feed character. 
  249. The keyword entries terminate with a line that contains only the 
  250. keyword END. The remaining label area, after the END keyword entry, 
  251. is padded with ASCII space characters.
  252.  
  253.      A keyword/value entry contains the name of one parameter and the 
  254. value of that parameter.  A keyword entry has the general form;
  255.  
  256.                parameter_name  = value  /* comment
  257.  
  258.      The layout of each keyword entry is essentially free-form; 
  259. blanks and tabs are typically ignored by a parsing routine.  A 
  260. keyword parameter name is separated from the keyword value by the 
  261. equal symbol (=).  Each keyword entry may optionally be followed by a 
  262. comment that more completely describes the entry.  The comment begins 
  263. with a slash character followed by an asterisk character (/*), and 
  264. terminates with the end of the line on which it appears.  Comments 
  265. may exist on a line without a keyword entry.
  266.  
  267.      Values associated with a keyword name contain ASCII characters 
  268. which represent integers, real numbers, unitized real numbers, 
  269. literals, time, or character text strings. 
  270.  
  271. INTEGER NUMBERS
  272. ---------------
  273.  
  274.      An integer value consists of a string of decimal digits preceded 
  275. optionally by a sign (+ or -).  Non-decimal based integers are 
  276. expressed according to the ADA language convention: b#nnnnnnn#, where 
  277. 'b' represents the base of the number, and '#' delimits the number 
  278. 'nnnnnnnn'. As an example, the number expressed as 2#111# represents 
  279. the binary number 111 (7 in base 10).
  280.  
  281.  
  282. REAL NUMBERS
  283. ------------
  284.  
  285.      A real number has the form: [s]f.d[En] 
  286. where: s = optional sign (+ or -)
  287.        f = one or more decimal digits that specify the integral
  288.            portion of the number.
  289.        d = one or more decimal digits that specify the fraction 
  290.            portion of the number.
  291.        n = an optional exponent expressed as a power of 10. 
  292.  
  293.      A unitized real number is a real number with a unit of 
  294. measurement associated with the number. The units are enclosed in 
  295. angle brackets (< >). As an example, 1.234 <SECONDS> indicates the 
  296. measurement 1.234 seconds.
  297.  
  298. TIME 
  299. ----
  300.  
  301.      A special form of a numeric field is the TIME value, the 
  302. following format of date/time representation is used:
  303.         yyyy/mm/dd-hh:mm:ss.fff <units>
  304. where:  yyyy    = year
  305.         mm      = month
  306.         dd      = day of month
  307.         hh      = hour
  308.         mm      = minute
  309.         ss      = seconds
  310.         fff     = fraction of seconds
  311.         <units> = unit of time, example <UTC> for universal time 
  312.                   corrected
  313.  
  314. LITERAL VALUES
  315. ---------------
  316.  
  317.      A literal value is typically a member of a set of finite values. 
  318. It is a string constructed from letters (A-Z), decimal digits (0-9),
  319. and the underscore character (_). The first character must be a 
  320. letter. Optionally, a literal value may be delimited by single-quote 
  321. (') characters.  If a literal appears within single-quotes, the 
  322. literal may contain any printable ASCII character. For example, the 
  323. literal value '1:1' is legal as long as the single-quoted format is 
  324. used.  By example, the keyword/value entry of INSTRUMENT_FILTER_NAME 
  325. = BLUE contains the literal value BLUE. There are a finite number of 
  326. filter wheel positions of the camera, and the BLUE position is one 
  327. of the positions.
  328.  
  329. TEXT CHARACTER STRINGS
  330. -----------------------
  331.  
  332.      Text strings can be any length and can consist of any sequence 
  333. of printable ASCII characters, tabs, blanks, carriage-control,
  334. or line-feed characters enclosed in double-quote characters. A 
  335. String continues until a double-quote character is encountered.  
  336.  
  337.  
  338.  
  339.                               APPENDIX 2
  340.                               ----------
  341.  
  342.  
  343. KEYWORD PARAMETERS FOR VOYAGER IMAGES
  344. -------------------------------------
  345.  
  346. NJPL1I00PDS000672960 = PDS_SFDU_LABEL
  347. This keyword provides a mechanism for PDS image files to conform to 
  348. the SFDU (Standard Format Data Unit) convention. The first 20 bytes 
  349. of a file are to contain a SFUD. The SFDU label associated with a PDS 
  350. image file consists of the control authority identifier (characters 
  351. 1-4), the version identifier (character 5), the class identifier 
  352. (character 6), a spare field (characters 7-8), a format identifier 
  353. (characters 9-12), and a length field indicator (characters 13-20).
  354. The keyword conforms to standard PDS keyword syntax and the value 
  355. associated with this keyword will always be PDS_SFDU_LABEL.
  356.  
  357. FILE_TYPE = IMAGE
  358. Defines the file type.  For image files on this volume the value 
  359. associated with the keyword will always be IMAGE. 
  360.  
  361. RECORD_TYPE = FIXED_LENGTH           
  362. Defines the organization of records within the file. For image files
  363. on this volume, the records will always be fixed-length records.
  364.  
  365. RECORD_BYTES = 836                    
  366. Defines the number of bytes contained in a record, always 836 bytes.
  367.  
  368. FILE_RECORDS = 805                    
  369. Defines the total number of records contained in the file, always 805
  370. records.
  371.  
  372. LABEL_RECORDS = 2
  373. Defines the number of records in the label area of the image file, 
  374. always 2 records.
  375.  
  376. IMAGE_RECORDS = 800 
  377. Defines the number of records in the image area of the file, always
  378. 800 records.
  379.  
  380. TRAILER_RECORDS = 3
  381. Defines the number of records in the trailer area of the file, always
  382. 3 records.
  383.  
  384. IMAGE_LINES   = 800
  385. Defines the number of lines in an image, always 800. The first
  386. image line in the file is the top line of an image.
  387.  
  388. LINE_SAMPLES  = 800                    
  389. Defines the number of samples contained in an image line, always
  390. 800. There are no prefix bytes in an image line and the first 
  391. byte of an image record is the first sample (left-most sample) of 
  392. an image line.
  393.  
  394. LINE_SUFFIX_BYTES = 36
  395. Defines the number of suffix bytes in an image line, always 36 bytes.
  396. The line suffix bytes contain supplementary line engineering data
  397. described in Appendix 3.
  398.  
  399. SAMPLE_BITS = 8                      
  400. Defines the number of bits per sample, always 8-bits per sample.
  401. The byte is an unsigned integer in the range 0 to 255. The
  402. 0 value indicates a null data value, and the 255 value indicates
  403. the sample is saturated.
  404.  
  405.  
  406. SAMPLE_BIT_MASK  = 2#11111111# or 2#11111110#
  407. Defines the active bits of an image sample. The number is expressed
  408. as a base 2 value in the ADA language number base convention.
  409. The value for this keyword consists of a string of 1's and 0's.   
  410. The value 1 indicates a bit is active and a 0 indicates a bit is not 
  411. in use. For  example,  SAMPLE_BIT_MASK = 2#11111110# would indicate 
  412. all bits are active except for the least significant bit and all 
  413. samples should be an even number. The SAMPLE_BIT_MASK is dependent on 
  414. the state of the camera.
  415.  
  416. SPACECRAFT_NAME = VOYAGER_x
  417. Defines the spacecraft associated with the image, either VOYAGER_1 
  418. or VOYAGER_2.
  419.  
  420. MISSION_PHASE = xxxxxxxxxxx
  421. Defines the central body of the mission encounter for this image.
  422. This literal value is either JUPITER_ENCOUNTER or SATURN_ENCOUNTER.
  423.  
  424. TARGET_BODY = xxxxxx
  425. Defines the target body of the image. Literal value will contain
  426. the name of the planet, satellite or eithe J_RINGS or S_RINGS
  427. for ring system images.
  428.  
  429. FRAME_ID  = 'NNNNES+DDD'
  430. Defines the unique frame identification. For image data the value
  431. associated with this keyword is the picture identification. For
  432. Voyager data, it is of the form: NNNNES+DDD, where NNNN = picture
  433. sequence number for a given day, E = planet of encounter (J=Jupiter,
  434. S=Saturn, U=Uranus), S = the voyager spacecraft (1 or 2), a
  435. - sign indicates before and a + sign indicates after closest 
  436. planetary approach. DDD = number of days from closest approach.
  437.  
  438. SPACECRAFT_CLOCK_COUNT = xxxxx.xx
  439. Flight Data Subsystem (FDS) clock count at time of frame aquisition.  
  440. The clock count is always a seven digit value, 5 digits to left
  441. of the decimal point and 2 digits to the right of the decimal point.
  442.  
  443. SPACECRAFT_EVENT_TIME = yyyy/mm/dd-hh:mm:ss <UTC>
  444. Time at which image was aquired, the time system is Universal Time 
  445. Corrected. yyyy=year, mm=month, dd=day of month, hh=hour, mm=minute, 
  446. ss=second
  447.  
  448. EARTH_RECEIVED_TIME = yyyy/mm/dd-hh:mm:ss <UTC>
  449. Time at which image was received on earth. 
  450.  
  451. INSTRUMENT_NAME = NARROW_ANGLE_CAMERA or WIDE_ANGLE_CAMERA
  452. Defines the instrument which acquired the data. For image data, the
  453. keyword value contains the camera used to acquire the data. Literal
  454. value will contain NARROW_ANGLE_CAMERA or WIDE_ANGLE_CAMERA.
  455.  
  456. INSTRUMENT_SCAN_RATE = 'n:1'
  457. Scan rate of vidicon read out, values can be '1:1', '2:1', '3:1', 
  458. '5:1', and '10:1'. The instrument scan rate effects the radiometric 
  459. properties of the camera and effects the dark current build up on
  460. the vidicon.
  461.  
  462. INSTRUMENT_SHUTTER_MODE = xxxxxx
  463. Literal value defining instrument shutter mode. Permitted values are;
  464.  NAONLY - narrow angle camera shuttered only
  465.  WAONLY - wide angle camera shuttered only
  466.  BOTSIM - both cameras shuttered simultaneously
  467.  BSIMAN - BOTSIM mode followed by NAONLY
  468.  BODARK - shutter remained closed for narrow and wide angle camera
  469.  NADARK - narrow angle read out without shuttering
  470.  WADARK - wide angle read out without shuttering
  471.  
  472. INSTRUMENT_GAIN_STATE = LOW or HIGH
  473. Literal value expressing the gain state of the camera.  The gain
  474. state can be HIGH or LOW. 
  475.  
  476. INSTRUMENT_EDIT_MODE  = xxxx
  477. Literal value expressing the edit mode of the camera. This keyword
  478. indicates amount of data read from the vidicon. '1:1' indicates the
  479. full resolution of the vidicon. Other values include '3:4', '1:2',
  480. '1:3', 1:5', and '1:10'
  481.  
  482. INSTRUMENT_FILTER_NAME = xxxxxx
  483. Literal value expressing the optical filter used in the image frame.
  484. For Voyager images, permitted values are CLEAR, CH4_U, CH4_JS, UV,
  485. VIOLET, BLUE, GREEN, ORANGE, and NAD.
  486.  
  487. INSTRUMENT_FILTER_NUMBER = x
  488. Optical filter identification number.  This value contains the unique
  489. number associated with the optical filter used in the image frame.
  490.  
  491. INSTRUMENT_EXPOSURE_DURATION  = x.xxxxx <SECONDS>
  492. Unitized real number expressing the exposure duration of frame in 
  493. seconds. 
  494.  
  495. DATA_ANOMALIES = xxxxxxxxxx
  496. Defines any data recording anomalies in the image frame.  If this 
  497. keyword is missing, no anomalies were detected. DATA_ANOMALIES = 
  498. RAM_DATA_CORRUPTION indicates that spurious values exist in the 
  499. image data due to corruption of the random access memory onboard 
  500. the spacecraft.
  501.  
  502. END
  503. The keyword entries terminate with a line that contains only the word 
  504. END.  Bytes in the label area after the END line are ignored.
  505.  
  506.  
  507.  
  508.  
  509.                             APPENDIX 3
  510.                             ----------
  511.  
  512.  
  513. SUPPLEMENTAL LINE ENGINEERING DATA
  514. ----------------------------------
  515.  
  516.      The table shown below describes the information contained in an 
  517. image line record. The supplemental line engineering data is found 
  518. in byte positions 801 through 836 of the record.
  519.  
  520.      All integer values are stored in "least significant byte first" 
  521. order. This is the order for integer values used by VAX and IBM PC 
  522. computer systems.  Users of other computer architectures (IBM 
  523. Mainframes, Macintosh, Sun, and Apollo) will need to swap the high 
  524. and low byte positions for 16-bit integer data.  For 32-bit integer 
  525. data, swap byte pairs 1 and 4, and 2 and 3. (Example, hex value AA BB 
  526. CC DD becomes DD CC BB AA)
  527.  
  528.  
  529.  BYTE       DATA
  530.  POSITION   TYPE             DATA DESCRIPTION
  531. ---------------------------------------------------
  532.    1-800  BYTE      - Image scan line data
  533.  801-802  INTEGER*2 - FDS clock count, Mod 16 count
  534.  803-804  INTEGER*2 - FDS clock count, Mod 60 count
  535.  805-806  INTEGER*2 - FDS Mod line count
  536.  807-808  INTEGER*2 - Image line number
  537.  809-810  INTEGER*2 - Number of missing minor frames not present in 
  538.                       line
  539.  811-830  INTEGER*2 - Number of telemetry frame bits retained for 
  540.                       processing
  541.      831  BYTE      - Bits 0-7 indentify input type as follows:
  542.                       0 - S/C flight 2 data MOS
  543.                       1 - S/C flight 1 data MOS
  544.                       2 - PTM data
  545.                       3 - Not used
  546.                       4 - Extermanl simulation (SC41)
  547.                       5 - Extermanl simulation (SC42)
  548.                       6 - S/C flight 2 data test
  549.                       7 - S/C flight 1 data test
  550.      832  BYTE      - Input Source/Input type, bits 1-7 shown below
  551.                       0 - Not used
  552.                       1 - R/T data
  553.                       2 - SDR tape data
  554.                       3 - IDR tape data
  555.                       4 - EDR (reprocessed data)
  556.                       5 - Not used
  557.                       6 - Not used
  558.                       7 - fill data
  559.  833-834  INTEGER*2 - First valid pixel ID, element position (1-800)
  560.                       of the first pixel in this line not artificially
  561.                       set to zeros by MIPL processing.
  562.  835-836  INTEGER*2 - Element position of the last pixel in this line
  563.                       not artificially set to zeros by MIPL 
  564.                       processing.
  565.  
  566.  
  567.  
  568.                        APPENDIX 4
  569.                        ----------
  570.  
  571.  
  572.  
  573. SUPPLEMENTAL ENGINEERING DATA IN TRAILER AREA
  574. ----------------------------------------------
  575.  
  576.      The table shown below describes the information contained in the 
  577. trailer area of an image file.  The trailer area is found in records 
  578. 803-805. The three records, when concatenated together, consist of a 
  579. continuous string of 2508 bytes.
  580.  
  581.      All integer values are stored in "least significant byte first" 
  582. order. This is the order for integer values used by VAX and IBM PC 
  583. computer systems.  Users of other computer architectures (IBM 
  584. Mainframes, Macintosh, Sun, and Apollo) will need to swap the high 
  585. and low byte positions for 16-bit integer data.  For 32-bit integer 
  586. data, swap byte pairs 1 and 4, and 2 and 3. (Example, hex value AA BB 
  587. CC DD becomes DD CC BB AA)
  588.  
  589. BYTE            ITEM            
  590. POSITION                                  DATA DESCRIPTION
  591. --------  -------------------   ----------------------------------
  592.  
  593.  
  594. 7-12      Earth Received Time     Time of first line record of the
  595.                                   file containing valid data.
  596.                                   Bytes  7, 8 - year (7 bits),
  597.                                                 day of year (9 bits)
  598.                                   Bytes  9,10 - minute (11 bits)
  599.                                   Bytes 11,12 - milliseconds 
  600.  
  601. 13-18     Earth Received Time     Time of last line record of the
  602.                                   file containing valid data.
  603.                                   (see format above)
  604.  
  605. 19-24     FDS Count               Count of the first line record of 
  606.                                   the file containing valid data.  
  607.                                   Note that this may not correspond 
  608.                                   to the FDS Count for line record #1.
  609.  
  610. 25-30     FDS Count               Count of the last line record of the
  611.                                   file containing valid data.
  612.  
  613. 31-36     Spacecraft Event Time   Four binary fields corresponding to 
  614.                                   the (predicted) shutter-close time 
  615.                                   for this image. (see format for 
  616.                                   earth received time above)
  617.  
  618. 37-68     IPL Physical            IPL Data for first line record of 
  619.                                   Recording Data file (ASCII text).
  620.  
  621.  
  622. 69-88     GCF Data                GCF for the first line record of the
  623.                                   file containing valid data.
  624.                                   Bytes 69-70 - GCF sync code (MSB)
  625.                                   Byte  71    - GCF sync code (LSB)
  626.                                   Byte  72    - Source code
  627.                                   Byte  73    - Destination code
  628.                                   Byte  74    - Block format code
  629.                                   Bytes 75-76 - GDD(3-bits),UDT code 
  630.                                                 (7-bits), DDT code 
  631.                                                 (6-bits)
  632.                                   Bytes 77-78 - Spacecraft number 
  633.                                                 (7-bits) time (MSB)
  634.                                   Byte  79-80 - time (LSB)
  635.                                   Bytes 81-82 - Unused (2-bits), day 
  636.                                                 of year (12-bits), 
  637.                                                 block serial number 
  638.                                                 MSB (2 bits)
  639.                                   Byte  83    - LSB of block serial 
  640.                                                 number
  641.                                   Byte  84    - Millisecond clock
  642.                                   Byte  85    - Serial number
  643.                                   Byte  86    - GCF configuration 
  644.                                                 status
  645.                                   Bytes 87-88 - Unused (13-bits), 
  646.                                                 esc (2-bits)
  647.                                                 Unused (1 bit).
  648. 89-108    GCF Data                GCF for of the last line record of 
  649.                                   the file containing valid data.
  650.                                   (see format above)
  651.  
  652. 109-114   Internal                Four binary fields representing 
  653.           Received Time           approximate time of data receipt 
  654.                                   from the DACS:
  655.                                   year of century = byte 109
  656.                                   day of year = byte 110
  657.                                   minute of day = bytes 111,112
  658.                                   millisecs in minute = bytes 113,114
  659.  
  660. 115-118   Unused                  Unused
  661.  
  662. 119-120   Format ID               Telemetry format ID for this image.
  663.                                   bytes 119-120 represent a word with
  664.                                   Bits 8-15 = unused
  665.                                   Bits 6-7 = format (=2 for imaging)
  666.                                   Bits 1-5 = image format code.  Note 
  667.                                   that the code used by the GDS may 
  668.                                   differ from the code down-linked by 
  669.                                   the spacecraft:
  670.                                   0=I3G4   12=IM2c    24=IM15
  671.                                   2=IMS    15=GS4     26=IM6
  672.                                   4=IMO    17=GS2     27=IM5
  673.                                   6=IMG    18=IM14    28=IM4
  674.                                   8=IMK    20=IM12    29=IM3
  675.                                   9=IM7    21=IM11    30=IM2
  676.                                   11=IM9   22=IM10    31=IM13
  677.                                   Bit 0 = S/C ID (0=VGR-2, 1=VGR-1)
  678.  
  679. 121-122   System Noise            The minimum noise level found for
  680.           Temperature (Min)       the scan-lines
  681.  
  682. 123-124   System Noise            The maximum noise level found for
  683.           Temperature (Max)       the scan-lines
  684.  
  685. 125-126   Symbol SNR (Min)        Minimum signal/noise ratio found 
  686.                                   for the scan-lines
  687.  
  688. 127-128   Symbol SNR (Max)        Maximum signal/noise ratio found 
  689.                                   for the scan-lines
  690.  
  691. 129-130   AGC (Min)               The minimum automatic gain control 
  692.                                   value used for the scan-lines
  693.  
  694. 131-132   AGC (Max)               The maximum automatic gain control 
  695.                                   value used for the scan-lines
  696.  
  697. 133-134   Sync Code Errors        Sum of the line sync. code errors 
  698.                                   for the scan lines
  699.  
  700. 135-136   FDS Count Errors        The sum of the FDS count errors for 
  701.                                   the scan lines which contain valid 
  702.                                   data
  703.  
  704. 137-138   Sync Parameters         Bits 8-15 contain the sync 
  705.                                   parameter I as described in the 
  706.                                   MTIS SRD.  Bits 0-7 contain the 
  707.                                   sync parameter P as described in 
  708.                                   the MTIS SRD.
  709.  
  710. 139-140   Sync Parameters         3 five-bit values representing the 
  711.                                   sync parameters J, K, and L as 
  712.                                   described in the MTIS SDR.
  713.                                         J = bits 10-14 (bit 15=zero)
  714.                                         K = bits 5-9
  715.                                         L = bits 0-4
  716.  
  717. 141-142   Sync Parameters         3 five-bit values representing the 
  718.                                   sync parameters M, N, and R as 
  719.                                   described in the MTIS SDR.
  720.                                         M = bits 10-14 (bit 15=zero)
  721.                                         N = bits 5-9
  722.                                         R = bits 0-4
  723.  
  724. 143-144   Number of Lines         Total number of line records in the 
  725.                                   file which contain some valid data.
  726.  
  727. 145-146   Number of Full Lines    Number of line records in the file 
  728.                                   which are composed entirely of full 
  729.                                   minor frames.
  730.  
  731. 147-148   Number of Partial       Total number of line records in the 
  732.           Lines                   file which contain some valid data 
  733.                                   but are not composed entirely of 
  734.                                   full minor frames.
  735.  
  736. 149-150   Number of Unreadable    Total number of records from the IDR
  737.           Records                 and/or SDR which were unreadable and
  738.                                   which fell within a time period for 
  739.                                   which data was required for this 
  740.                                   file. Note:  For SDR input this 
  741.                                   does not necessarily result in 
  742.                                   data loss.
  743.  
  744. 151-152   Number of Logical       Total number of gaps on the IDR 
  745.           Breaks                  and/or SDR as indicated by a 
  746.                                   discontinuity in the logical record 
  747.                                   numbers which fell within a time 
  748.                                   period for which data was required 
  749.                                   for this file.
  750.  
  751. 153-154   Sort Parameters         TBD catalog information.  Will 
  752.                                   include target info from PIG file.
  753.  
  754. 161-162   Number of Minor         Total number of minor frames in this
  755.           Frames from IDR         file which were derived from IDR 
  756.                                   input.
  757.  
  758. 163-164   Number of Minor         Total number of minor frames in this
  759.           Frames from WBDL        file derived from WBDL input.
  760.  
  761. 165-166   Number of Minor         Total number of minor frames in this
  762.           Frames from SDR         file which were derived from SDR 
  763.                                   input.
  764.  
  765. 167-168   Number of Missing       Total number of frames which were 
  766.           Minor Frames            missing from this file.
  767.  
  768. 169-170   Not Used
  769.  
  770. 171-179   Pic. No.                Ten ASCII characters of the form:
  771.                                   NNNNES+DD, where:
  772.                                   NNNN = picture number within day.
  773.                                   E    = planet of encounter (J=Jupiter,
  774.                                          S=Saturn,....)
  775.                                   - =    indicates before closest 
  776.                                          planetary approach
  777.                                   + =    indicates after closest
  778.                                          planetary approach.
  779.                                   DDD =  Number of days from closest 
  780.                                          approach.
  781.  
  782. 181-189   Target Body             Ten ASCII characters (e.g. MIRANDA).
  783.  
  784. 191-192   Input Source/Input      Logical sum (result of successive 
  785.           Type                    inclusive or operations) of word 
  786.                                   95 of all line records in the file.
  787.  
  788.  
  789. ISS STATUS/ENGINEERING SUBCOM DATA
  790. ----------------------------------
  791.  
  792. 193-194   Shuttered Picture       Subcom position 1:
  793.           Indicator               Bit 15 = Camera ID (O=WA, 1=NA)
  794.                                   Bits 0-14 = shuttered picture 
  795.                                               indicator
  796.                                             = all ones for a 
  797.                                               shuttered image
  798.                                             = zeroes for unshuttered 
  799.                                               images.
  800.  
  801. 195-196   Slow Scan Status        Subcom position 2:
  802.                                   Bits 15-6 = Actual picture line 
  803.                                   number being read out.
  804.                                   Bits 5-0 = Actual segment number 
  805.                                   being read out.
  806.                                   Note:  the slow scan status is 
  807.                                   meaningless here since it 
  808.                                   increments with line count.
  809.  
  810. 197-198   Exp. Mode/Time/         Subcom position 3:
  811.           Filter/Elec. Cal        Bits 11-15 = spares
  812.                                   Bit 10 = NA electronics cal status
  813.                                   (1=on, 0=off)
  814.                                   Bit  9 = WA electronics cal status
  815.                                   (1=on, 0=off)
  816.                                   Bits 4-8 = 5-bit exposure code. To 
  817.                                   convert to exp time, see MJS 
  818.                                   77-4-2036. 
  819.                                   Bits 0-3 = Filter wheel position.
  820.                                   Bits 1-3 give the position and
  821.                                   Bit 0 is an odd parity bit.
  822.  
  823. 199-200   Picture Count           Subcom position 4.
  824.  
  825. 201-202   Parameter A Word        Subcom position 5.
  826.           Present Value
  827.  
  828. 203-204   Parameter A Word        Subcom position 6.
  829.           Indicator
  830.  
  831. 205-206   Parameter A Word        Subcom position 7.
  832.           Pointer
  833.  
  834. 207-208   Parameter B Word        Subcom position 8.
  835.           Present Value
  836.  
  837. 209-210   Parameter B Word        Subcom position 9.
  838.           Pointer
  839.  
  840. 211-212   Parameter C word        Subcom position 10.
  841.           Present Value
  842.  
  843. 213-214   Parameter C word        Subcom position 11.
  844.           Pointer
  845.  
  846. 215-216   Parameter D word        Subcom position 12.
  847.           Present Value
  848.  
  849. 217-218   Parameter D word        Subcom position 13.
  850.           Indicator
  851.  
  852. 219-220   Parameter D Word        Subcom position 14.
  853.           Pointer
  854.  
  855. 221-220   Ten 8-bit Analogue      Subcom positions 15-19.
  856.           Samples
  857.  
  858. 231-232   Pixel Average/          Subcom position 20.
  859.           Command Status          Bits 14-15 = spares
  860.                                   Bits 13 = Pixel Average Status
  861.                                   Bits 8-12 = Pixel Average is based 
  862.                                   on the MSBs of all pixels exceeding
  863.                                   the programmed threshold of the
  864.                                   camera read-out in the previous
  865.                                   frame.
  866.                                   For data compression formats (IMO, 
  867.                                   IMQ, IMK, and IM2c) this field is 
  868.                                   replaced by Command Status Word 
  869.                                   SC06QT:
  870.                                   Bits 15-3 = unused
  871.                                   Bit 2 = WA LSB Truncation FLag 
  872.                                   (0=truncation)
  873.                                   Bit 1 = NA LSB Truncation Flag 
  874.                                   (0=truncation)
  875.                                   Bit 0 = Secondary Memory Readout 
  876.                                   (1=readout)
  877.  
  878. 233-242   ISS Engineering         9 ISS engineering measurements from
  879.                                   ETAP. 
  880.  
  881. 243-1024  Unused                  Unused
  882.  
  883. 1025-2048 Source data             256 32-bit binary valued histogram 
  884.           Histogram               of the Histogram pixels for this 
  885.                                   file, including fill data.
  886.  
  887. 2049-2508 Unused                  Unsused
  888.