Project SIR-C
CEOS Tape Reader
User's Guide
Revision 1.1
JPL D-11427
27 June, 1994
National Aeronautics and Space Administration
Jet Propulsion Laboratory
California Institute of Technology
Pasadena, California
SIR-C CEOS Tape Reader
User's Guide
Revision 1.1
27 June, 1994
JPL D-11427
Prepared by:
Christina Vuu
Cynthia Wong
Patti Barrett
Approved by:
_______________________ ____________________
Ellen O'Leary CY. Chang
SIR-C Science Data Manager SIR-C PGS Manager
__________________
Kon Leung
SIR-C RDC Manager
Copyright (c)1993, California Institute of Technology U. S. Government Sponsorship Under NASA Contract NAS7-918 is Acknowledged.
"This software is provided to you "as is" and without warranty of any kind, expressed or implied, including but not limited to, warranties of performance, merchantability, or fitness for a particular purpose. User bears all risk as to the quality and performance of the software."
TABLE OF CONTENTS
Document Change Log iv
1 Introduction
1.1 Purpose 1
1.2 Scope 1
1.3 Applicable Documents 1
2 Minimum Requirement of Hardware and Software Configuration
2.1 Minimum Requirement of Hardware and Software Configuration 2
3 Installing Software
3.1 Installing SIR-C CEOS Tape Reader Software On UNIX System 3
3.2 Installing SIR-C CEOS Tape Reader Software On VAX/VMS System 3
4 Building Executable
4.1 Building 'ceos_reader' Executable On UNIX System 4
4.2 Building 'ceos_reader' Executable On VAX/VMS System 4
5 Running Program
5.1 Running 'ceos_reader' Program For Data On Exabyte Tape 5
5.2 Running 'ceos_reader' Program For Data On Disk 5
6 Display Menu On The Screen
Overview 6
6.1 Welcome Menu 7
6.2 Main Menu 8
6.2.1 Product Menu 9
6.2.1.1 Product Menu - Option 'Summary' 10
6.2.1.2 Product Menu - Option 'Select' 11
6.2.1.3 Product Menu - Option 'Copy 11
6.2.1.4 Product Menu - Option 'Decode/Save' 13
6.2.1.5 Product Menu - Option 'File Menu' 15
6.2.1.6 Product Menu - Option 'Main Menu' 16
6.2.1.7 Product Menu - Option 'Exit' 16
6.2.2 File Menu 17
6.2.2.1 File Menu - Option 'Select' 18
6.2.2.2 File Menu - Option 'Copy' 19
6.2.2.3 File Menu - Option 'Decode/Save' 20
6.2.2.4 File Menu - Option 'Decode/Display' 21
6.2.2.5 File Menu - Option 'Product Menu' 22
6.2.2.6 File Menu - Option 'Main Menu' 23
6.2.2.7 File Menu - Option 'Exit' 23
7 Output Files On Disk
7.1 Output Files on Disk 24
8 Extract SAR Image Data File
8.1 Extract SAR Image Data File 26
APPENDIX
A SIR-C CEOS Tape Layout A-1
B Description of SIR-C CEOS Files and Output Files B-1
C SIR-C CEOS Data File Definitions C-1
D Samples of Output File in ASCII Format D-1
E Acronyms and Abbreviations E-1
FIGURES
Figure Title Page
A Summary Tree of The 'Ceos_Reader' Program 6
B SIR-C CEOS Tape Layout and Volume Directory File (VDF) Layout A1
6.1 Welcome Menu 7
6.2 Main Menu 8
6.2.1 Product Menu 9
6.2.1.1 Product Menu - Option 'Summary' 10
6.2.1.2 Product Menu - Option 'Select' 11
Figure Title Page
6.2.1.3 Product Menu - Option 'Copy' 11
6.2.1.3a Product Menu - Option 'Copy'-A 12
6.2.1.3b Product Menu - Option 'Copy'-B 12
6.2.1.4 Product Menu - Option 'Decode/Save' 13
6.2.1.4a Product Menu - Option 'Decode/Save'-A 13
6.2.1.4b Product Menu - Option 'Decode/Save'-B 14
6.2.1.5 Product Menu - Option 'File Menu' 15
6.2.1.6 Product Menu - Option 'Main Menu'' 16
6.2.2 File Menu 17
6.2.2.1 File Menu - Option 'Select' 18
6.2.2.2 File Menu - Option 'copy' 19
6.2.2.2a File Menu - Option 'copy'-A 19
6.2.2.2b File Menu - Option 'copy'-B 19
6.2.2.3 File Menu - Option 'Decode/Save' 20
6.2.2.3a File Menu - Option 'Decode/Save'-A 20
6.2.2.3b File Menu - Option 'Decode/Save'-B 20
6.2.2.4 File Menu - Option 'Decode/Display' For SAR Leader file 21
6.2.2.5 File Menu - Option 'Product Menu' 22
6.2.2.6 File Menu - Option 'Main Menu' 23
DOCUMENT CHANGE LOG
Revision Date Affected Portions
1.0 February 22, 1994 Original
1.1 March 10, 1994 * Section 1.1: delete 'Release Version 1.0 of'
* Section 7.1: rename the text file of volume directory file to be 'prXXXXX_vdf_ceos_ascii'
* Section 8.1: add one more step to show how to decode the image file.
March 16, 1994 * Section 3.2: Change the command on how to install Ceos Reader S/W tape on VAX/VMS System
1 INTRODUCTION
1.1 Purpose
The SIR-C CEOS Tape Reader software is designed specifically for reading SIR-C CEOS tape, accessing its individual image and data files, and converting data file contents into readable text format. This document accompanies the SIR-C CEOS Tape Reader software which is able to run on UNIX and VAX/VMS operating systems.
1.2 Scope
This document describes the steps necessary to install the CEOS Tape Reader software provided on high density 8mm Exabyte tape onto disk, build the executable, and run the program. This document also describes the function of each option in the menu items and expected outputs from CEOS Reader program. The last section which is section 8 shows how to extract the SAR Image Data File only from tape to disk. The layout of SIR-C CEOS Exabyte tape is shown in Appendix A. Appendix B contains the description of SIR-C CEOS file and the output files in ASCII format. Appendix C contains the SIR-C CEOS data file definition. Finally, Appendix D includes a sample of output files in text format.
1.3 Applicable Documents
[1] SIR-C Functional Requirements & Subsystem Interface Specification - Radar Data Center (SIR-C FRD & SIS - RDC), JPL D-10692, Revision 1.0, June 9,1993
[2] SIR-C CEOS Tape Reader Software Requirements & Design Document - Radar Data Center (SIR-C SRD & SDD), JPL D-10990, Revision 1.0, July 28, 1993
[3] Synthetic Aperture Radar Computer Compatible Tape Format Specifications (CEOS-SAR-CCT Iss/Rev:2/1), CEOS WGD on SAR Data Standards, Revision 1, January 1992
2 MINIMUM REQUIREMENT ON HARDWARE AND SOFTWARE CONFIGURATION
2.1 Minimum Requirement On Hardware And Software Configuration
The minimum hardware and software configuration required to install the CEOS Tape Reader software, compile, execute the program, and store output data on disk are:
* Minimum memory size of 2 MB.
* A high density, 8mm tape device (e.g. Exabyte drive model EXB-8500 or compatible).
* A minimal disk space of 6 MB is required to store the CEOS Reader software and to transfer CEOS files from tape to disk. For operational use, the additional disk space needed depends on the image file size. Average image file sizes are: 200 MB for multi-look detected, 400 MB for multi-look complex, and 600 MB for single-look complex.
* ANSI C compiler.
3 INSTALLING SOFTWARE
This section describes the procedures on how to install SIR-C CEOS Tape Reader software on UNIX and VAX/VMS systems. The following files should appear in the sub-directory called 'ceos_reader' after installing the software onto the disk:
Source files : ceos_reader.c
ceos_rd.c
ceos_rd_vdf.c
menu.c
ceos_util.c
rd_ceos_tape.c
Header files: ceos_reader.h
oceos.h
ceos_rd.h
rd_VDF.h
Makefile: ceos_reader.make
Readmefile: README
Com. file: ceos_reader.com (for VAX/VMS)
3.1 Installing SIR-C CEOS Tape Reader Software On UNIX System
* Load the 8mm tape "SIR-C CEOS Tape Reader S/W" into the tape drive.
* Go to the main directory where this software is to be installed.
* Use UNIX tar command to restore the software from tape onto disk.
tar xvf tape_device_name
(Example : tar xvf /dev/exa1)
mt -f tape_device_name rewind
(Example: mt -f /dev/exa1 rewind)
3.2 Installing SIR-C CEOS Reader Software On VAX/VMS System
* Load the 8mm tape "SIR-C CEOS Tape Reader S/W" into the tape drive.
* Go to the main directory where this software is to be installed.
* Use VAX/VMS backup command to restore the software from tape onto disk.
mount/for tape_device_name
backup tape_device_name:sw.save [...]
dismount tape_device_name
(Example: mount/for mua1:
backup mua1:sw.save [...]
dismount mua1: )
4 BUILDING EXECUTABLE
4.1 Building 'ceos_reader' Executable On UNIX System
Go to sub-directory called ceos_reader. There is a make file called ceos_reader.make used for compiling the source files and creating the executable file. An ANSI C compatible compiler is required for compilation.
To build the executable ceos_reader on a UNIX compatible system, type:
make -f ceos_reader.make
The make file uses "acc" command to compile source files. If a different C compiling command is used, then specify according to the following example:
make -f ceos_reader.make CC=cc
Note: Ignore the warning messages.
4.2 Building 'ceos_reader' Executable On VAX/VMS System
Go to sub-directory called ceos_reader. There is a command file ceos_reader.com used for compiling the source files and creating the executable file. ANSI C compatible compiler is required for compilation.
To build the executable ceos_reader on VAX/VMS system, type:
@ceos_reader
5 RUNNING PROGRAM
There are two ways to run the ceos_reader program; either with data on Exabyte tape or with data on disk.
Note: For the VAX/VMS system, it is necessary to create a symbol for the 'ceos_reader' program as below:
ceos_reader :== $disk:[directory_path_of_executable]ceos_reader.exe
5.1 Running 'ceos_reader' Program For Data On Exabyte Tape
* Load the SIR-C CEOS-formatted Exabyte tape into the tape drive.
* Run 'ceos_reader' program by typing:
ceos_reader tape=tape_device_name
(Examples: ceos_reader tape=/dev/exa0 (on UNIX)
or ceos_reader tape=mua1 (on VAX/VMS) )
5.2 Running 'ceos_reader' Program For Data On Disk
* To run the 'ceos_reader' program with data already on the disk, type:
ceos_reader disk=SAR Leader file
to decode CEOS SAR Leader File or
or
ceos_reader disk=SAR Imagery Options Record
to decode file descriptor record of SAR Data file
or
ceos_reader disk=SAR Trailer file name
to decode CEOS SAR Trailer File
(Examples: ceos_reader disk=pr01351_ldr_ceos
or ceos_reader disk=pr01351_img_ceos
or ceos_reader disk=pr01351_tlr_ceos )
6 DISPLAY MENU ON THE SCREEN
SIR-C CEOS Tape Reader software version 1.0 contains four main menus: Welcome Menu, Main Menu, Product Menu and File Menu. In each main menu, there are additional options for users to select. This section describes the function of each option in each menu. The figure A below shows the summary of the four main menus and options of the 'ceos_reader' program.
Figure A: Summary tree of the 'ceos_reader' program
6.1 Welcome Menu
This menu welcomes users to the CEOS Tape Reader software. It displays CEOS tape information such as: tape ID, date, time and location where the tape was created and the number of products on the tape. To continue the program, select (1). To exit the program, select (0). An example of the Welcome Menu (figure 6.1) is shown below:
Figure 6.1 : WELCOM MENU
6.2 Main Menu
The Main Menu will be displayed on the screen if (1) was selected from the Welcome Menu. The Main Menu (figure 6.2) is shown below:
Figure 6.2 : MAIN MENU
In the Main Menu, there are four options for users to select. Option (1), 'Product Menu', allows users to work with data on tape. Option (2), 'File Menu', allows users to work with individual file either on tape or disk. Option (3) re-display 'Welcome Menu' on the screen. Option (4) allows users to exit the program.
6.2.1 PRODUCT MENU
If option (1), 'Product Menu', was selected from the Main Menu, the following Product Menu will be displayed on the screen (figure 6.2.1)
Figure 6.2.1: PRODUCT MENU
This menu provides seven options for users to select. Option (1), 'Summary', displays the summary of product on the tape. Option (2), 'Select', allows users to select a different product on tape. Option (3), 'Copy', allows users to copy product which includes SAR Leader file, SAR Data file and SAR Trailer file, from tape onto the disk. Option (4), 'Decode/Save', allows users to decode product on the disk and output files onto disk in ASCII format. Option (5), 'File Menu', allow users to work with an individual file on the tape. Option (6) allows users to go back to the 'Main Menu'. The users will be able to exit the program by selecting option (0).
6.2.1.1 PRODUCT MENU - Option 'Summary'
If option (1), 'Summary', was selected from the Product Menu, the following screen will be displayed on the terminal (figure 6.2.1.1):
Figure 6.2.1.1 : Product Menu - Option 'Summary'
This option displays the summary of the product such as the number of records and record lengths of each CEOS files on the tape, the product type, the scene ID and frame center of the product.
6.2.1.2 PRODUCT MENU - Option 'Select'
If option (2), 'select', was selected from the Product Menu, the following screen will be displayed on the terminal (figure 6.2.1.2):
Figure 6.2.1.2 : Product Menu - Option 'Select'
This option allows users to select different product on the tape if there are multiple products on tape. To select a different product, type in the number for the desired product. To go back to the previous menu, hit RETURN key.
6.2.1.3 PRODUCT MENU - Option 'Copy'
If option (3), 'copy', was selected from the Product Menu, the following screen will be displayed on the terminal (figure 6.2.1.3) :
Figure 6.2.1.3 : Product Menu - Option 'Copy'
This option allows users to transfer a data product, which includes the SAR Leader file, SAR Data file and SAR Trailer file, from tape onto disk. The SAR Data File will split into two files: one is the File Descriptor Record of SAR Data File (SAR Imagery Options Record). The other is the SAR Image Data File or SAR Reformatted Signal Data File which excludes the 12 bytes preamble. The users will be able to continue with this option or exit this option. To continue with this option, press RETURN key. The following screen will be displayed on the terminal (figure 6.2.1.3a). To exit this option, press any other key on the keyboard.
Figure 6.2.1.3a: Product Menu - Option 'Copy'-A
This screen shows the output file names (in the bracket []) before transfering CEOS files from tape to disk. If users decide to default with the output file names, then hit RETURN. Otherwise, hit any other key on the keyboard. The following screen will be displayed on the terminal (figure 6.2.1.3b):
Figure 6.2.1.3b: Product Menu - Option 'Copy'-B
From this screen, type in the new output file names.
6.2.1.4 PRODUCT MENU - Option 'Decode/Save'
If option (4), 'Decode/Save', was selected from the Product Menu, the following screen will be displayed on the terminal (figure 6.2.1.4) :
Figure 6.2.1.4 : Product Menu - Option 'Decode/Save'
This option allows users to decode product on disk, which includes SAR Leader file, SAR Data file and SAR Trailer file, and output files in ASCII format onto disk. In addtion, this option also creates the plot data files in (x,y) format for each polarization of Radiometric Compensation record, Data Histogram record, and Range Spectra record. These records are from SAR Leader File. The users will be able to continue with this option or exit this option. To continue with this option, press RETURN key. The following screen will be displayed on the terminal (figure 6.2.1.4a). To exit this option, press any other key on the keyboard.
Figure 6.2.1.4 a: Product Menu - Option 'Decode/Save'-A
This screen shows the output file names (in the bracket []) before decoding CEOS files on disk. If users decide to default with the output file names, then hit RETURN. Otherwise hit any other key on the keyboard. The following screen will be displayed on the terminal (figure 6.2.1.4b):
Figure 6.2.1.4 b: Product Menu - Option 'Decode/Save'-B
From this screen, type in the new output file names.
6.2.1.5 PRODUCT MENU - Option 'File Menu'
If option (5), 'File Menu', was selected from the Product Menu, the following screen will be displayed on the terminal (figure 6.2.1.5) :
Figure 6.2.1.5 : Product Menu - Option 'File Menu'
This option allows users to work with individual file either on the tape or on the disk (refer to section 6.2.2).
6.2.1.6 PRODUCT MENU - Option 'Main Menu'
If option (6), 'Main Menu', was selected from the Product Menu, the following screen will be displayed on the terminal (figure 6.2.1.6) :
Figure 6.2.1.6 : Product Menu - Option 'Main Menu'
This option will bring the Main Menu back on the terminal which includes Product Menu, File Menu, Welcome Main, and Exit (refer to section 6.2).
6.2.1.7 PRODUCT MENU - Option 'Exit'
This option allows users to exit the program by pressing zero (0).
6.2.2 FILE MENU
If 'File Menu' is selected from the Main Menu', the following screen will be displayed on the terminal (figure 6.2.2)
Figure 6.2.2 : FILE MENU
This menu provides seven options. Option (1), 'Select', allows users to select a different CEOS file (either SAR Leader file, SAR Data file or SAR Trailer file) on tape or disk. Option (2), 'Copy', allows users to copy individual CEOS file from tape onto disk. Option (3), 'Decode/Save', allows users to decode an individual CEOS file on the disk and output file onto disk in ASCII format. Option (4), 'Decode/Display', displays the text file of the SAR Leader file, SAR Data file or SAR Trailer file on screen. Option (5), 'Product Menu', allows users to work with each product on the tape. Option (6) allows users to go back to the previous menu which is 'Main Menu'. To exit the program, select the option zero, (0).
6.2.2.1 FILE MENU - Option 'Select'
If option (1), 'select', was selected from the File Menu, the following screen will be displayed on the terminal (figure 6.2.2.1):
Figure 6.2.2.1 : File Menu - Option 'Select'
This option allows users to select a different CEOS file on tape or disk. The users either hit RETURN to go back to the previous screen or type in the selected file number.
6.2.2.2 FILE MENU - Option 'Copy'
If option(2), 'copy', was selected from the File Menu, the following screen will be displayed on the terminal (figure 6.2.2.2) :
figure 6.2.2.2 : File Menu - Option 'Copy'
This option allows users to transfer individual file from tape onto disk. If users select SAR Data File to copy from tape to disk, the SAR Data File will split into two files on disk: one is the File Descriptor Record of SAR Data File (SAR Imagery Options Record). The other is the SAR Image Data File or SAR Reformatted Signal Data File which excludes the 12 bytes preamble. The users are able to continue or exit this option. To continue with this option, press RETURN key. The following screen will be displayed on the terminal (figure 6.2.2.2a). To exit this option, press any other key on the keyboard.
figure 6.2.2.2a : File Menu - Option 'Copy'-A
This screen shows the output file names (in the bracket []) before transfering CEOS file from tape to disk. If users decide to default with the output file names, then hit RETURN. Otherwise, type in any other key on the keyboard. The following message will be displayed on the terminal (figure 6.2.2.2b) promting for a new output file name.
Figure 6.2.2.2b : File Menu - Option 'Copy'-B
6.2.2.3 FILE MENU - Option 'Decode/Save'
If option (3), 'Decode/Save', was selected from the File Menu, the following screen will be displayed on the terminal (figure 6.2.2.3) :
Figure 6.2.2.3 : File Menu - Option 'Decode/Save'
This option allows the users to decode an individual CEOS file on disk and output files in ASCII format onto disk. For SAR Leader File, the additional plot data files in (x,y) format for each polarization of Radiometric Compensation record, Data Histogram record, and Range Spectra record will be created on disk. To continue with this option, press RETURN key. The following screen will be displayed on the terminal (figure 6.2.2.3a). To exit this option, press any other key on the keyboard.
Figure 6.2.2.3a : File Menu - Option 'Decode/Save'-A
This screen shows the output file name (in the bracket []) before decoding a CEOS file from disk. If users decide to default with the output file name, then hit RETURN. Otherwise, type in any other key on the keyboard. The following message will be displayed on the terminal (figure 6.2.2.3b) prompting for a new output file name.
Figure 6.2.2.3b : File Menu - Option 'Decode/Save'-B
6.2.2.4 FILE MENU - Option 'Decode/Display'
This option displays the text format of the SAR Leader file, file descriptor record of SAR Data file or SAR Trailer file on the screen. For the SAR Leader file, it is divided into 32 different records. The following screen (figure 6.2.24) will be displayed on the terminal if this option was selected to display the text format of the SAR Leader file.
Figure 6.2.2.4 : File Menu - Option 'Decode/Display' for SAR Leader file
From this screen, enter the number of the desired record to display on the screen. If Radiometric Compensation records, Data Histogram records, or Range Spectra records was selected to display, the plot data files in (x,y) format for each polarization of these records will be created on the disk.
If this option was selected to decode and display the SAR Data file or SAR Trailer file, the text format of file descriptor record of SAR Data file or SAR Trailer file will be displayed on the screen, respectively.
6.2.2.5 FILE MENU - Option 'Product Menu'
If option (5), 'Product Menu', was selected from the File Menu, the following screen will be displayed on the terminal (figure 6.2.2.5) :
Figure 6.2.2.5 : File Menu - Option 'Product Menu'
This option allows users to go back to the Product Menu to work with the whole product on tape instead of individual files (refer to section 6.2.1).
6.2.2.6 FILE MENU - Option 'Main Menu'
If option (6), 'Main Menu', was selected from the File Menu, the following screen will be displayed on the terminal (figure 6.2.2.6) :
Figure 6.2.2.6 : File Menu - Option 'Main Menu'
This option allows users to go back to the Main Menu (refer to section 6.2)
6.2.2.7 FILE MENU - Option 'Exit'
This option allows users to exit the program by pressing zero (0) key.
7 OUTPUT FILES ON DISK
7.1 Output Files On Disk
If the 'ceos_reader' program was run with data on Exabyte tape, the following output files will be produced on disk:
* Volume Directory File in text format (prXXXXX_vdf_ceos_ascii).
* Three CEOS files and one SAR data file (either Image data or Reformatted Signal data) if option "COPY" was selected to copy CEOS files from tape to disk.
1. SAR Leader File
2. SAR Imagery Options Record
3. SAR Data File (either Image data or Reformatted Signal data)
4. SAR Trailer File
(eg. Image data OR Reformatted Signal data
pr01351_ldr_ceos, pr01351_ldr_ceos
pr01351_img_ceos, pr01351_img_ceos
pr01351_img_ceos_image pr01351_img_ceos_HH
pr01351_tlr_ceos pr01351_img_ceos_HV
pr01351_img_ceos_VV pr01351_img_ceso_VH pr01351_tlr_ceos)
* Three decoded CEOS files in text format and the plot data files in (x,y) format for each polarization of Data Histogram record, Radiometric Compensation record and Range Spectra record if option "DECODE/SAVE" was selected
Three decoded CEOS files:
* SAR Leader file_ascii (ASCII format)
* SAR Imagery Options Record_ascii (ASCII format)
* SAR Trailer file_ascii (ASCII format)
(eg. 1. pr01351_ldr_ceos_ascii,
2. pr01351_img_ceos_ascii
3. pr01351_tlr_ceos_ascii )
Plot data files of :
* Radiometric Compensation record (prXXXXX_radioplot_ZWW)
* Data Histogram record (prXXXXX_histoplot_YYY_ZWW)
* Range Spectra record (prXXXXX_spectraplot_ZWW)
(where: XXXXX : processing run number
YYY : image or raw data (IMA or RAW)
Z : L or C band
WW : HH, HV, VH, or/and VV polarization)
(eg: 1 pr01351_histoplot_IMA_LVV
2. pr01351_histoplot_RAW_LVV
3. pr01351_spectaplot_LVV
4. pr01351_radioplot_LVV )
If the 'ceos_reader' program was run with data already on the disk, then the following output files will be produced on disk:
* Three decoded CEOS files in text format and the plotting data files in (x,y) format for each polarization of Data Histogram record, Radiometric Compensation record and Range Spectra record if option "DECODE/SAVE" was selected
Three decoded CEOS files:
* SAR Leader file_ascii (ASCII format)
* SAR Imagery Options Record_ascii (ASCII format)
* SAR Trailer file_ascii (ASCII format)
(eg. 1. pr01351_ldr_ceos_ascii,
2. pr01351_img_ceos_ascii
3. pr01351_tlr_ceos_ascii )
Plot data files of :
* Radiometric Compensation record (prXXXXX_radioplot_ZWW)
* Data Histogram record (prXXXXX_histoplot_YYY_ZWW)
* Range Spectra record (prXXXXX_spectraplot_ZWW)
(where: XXXXX : processing run number
YYY : image or raw data (IMA or RAW)
Z : L or C band
WW : HH, HV, VH, or VV polarization)
1 pr01351_histoplot_IMA_LVV
2. pr01351_histoplot_RAW_LVV
3. pr01351_spectaplot_LVV
4. pr01351_radioplot_LVV
(For description of each output file, refer to Appendix A)
8 EXTRACT SAR IMAGE DATA FILE
8.1 Extract SAR Image Data File
The users are able to extract the SAR Image Data File which excludes the 12 bytes preamble by doing the following:
* Run 'ceos_reader' program (see section 5.1 on how to run this program)
* First, choose the FILE MENU option from the Main Menu
* Second, choose 'Select' option from the FILE MENU. From 'Select' option, choose (2) which is SAR Imagery Options Record 'prXXXXX_img_ceos' (where XXXX X is the processing run number).
* Third, choose option 'Copy' from the FILE MENU. This 'Copy' option will copy the SAR Data File from tape to two different files on disk: One is the File Descriptor Record of SAR Data File. The other is the SAR Image Data file which excludes the 12 bytes preamble (prXXXXX_img_ceos_image').
* Finally, choose option 'Decode/Save' from the FILE MENU to decode the File Descriptor Record of SAR Data File in text format ('prXXXXX_img_ceos_ascii').
APPENDIX-A SIR-C CEOS Exabyte Tape Layout
Each SIR-C CEOS Exabyte tape contains five type of files: The Volume Directory File (VDF), SAR Leader File (ldr), SAR Data File (img), SAR Trailer File (tlr) and Null Volume Directory File (NVDF). Each Exabyte tape contains one Volume Directory File at the beginning of the tape, then three SAR files : ldr, img and tlr for each product. Finally is the Null Volume Directory File at the end of the tape.
The Volume Directory File contains one Volume Descriptor Record and three File Pointer Records (LDR, IMG, TLR) for each product. Finally is the text record of each product. Figure B below shows the table of tape layout and Volume Directory File layout.
Tape Layout Volume Directory File (VDF) layout
Figure B : SIR-C CEOS Tape Layout and Volume Directory File (VDF) layout
APPENDIX-B Description of SIR-C CEOS Files and Output Files
The description of SIR-C CEOS files:
1. Volume Directory File: This is the first file of data volume and consists of a volume descriptor record, file pointer records and text records. This file is to identify and specify the structure related to the data volume.
2. SAR Leader File: This file contains auxiliary information corresponding to the SAR data contained in the data file.
3. SAR Data File: This file contains the SAR data. It consists of one file descriptor record and either Image data records or Reformatted Signal data records.
4. SAR Trailer File: For SIR-C, this file contains simply the file descriptor record because all the information are stored in SAR Leader file.
5. Null Volume Directory File: This file contains only the null volume descriptor record to indicate the end of the data volume.
Below is the description of SIR-C CEOS output files in ASCII format and plot data files:
1. SAR Leader File_ascii: This file contains the text format of File Descriptor Record, Data Set Summary Record, Map Projection Data Record, Platform Position Record, Attitude Data Record, Radiometric Data Record, Radiometric Compensation Record, Data Quality Summary Record, Data Histograms Record, Range Spectra Record, Radar Parameter Update Data Record, Detailed Processing Parameter Record, and Calibration Data Record of SAR Leader File.
2. SAR Imagery Options Record_ascii: This file contains the text format of file descriptor record of SAR Data File.
3. SAR Data File_image: This file contains compressed Image data OR SAR Data File_HH/_HV/_VV/_VH: These four files contains raw data of Reformatted Signal Data Records
4. SAR Trailer File_ascii: This file contains the text format of file descriptor record of SAR Trailer File.
56. Radiometric Compensation plot data files (prXXXXX_radioplot_ZWW) : These files contain data of Radiometric Compensation record in (x,y) format. The (x,y) pairs are tab-delimited
6. Data Histogram plot data files (prXXXXX_histoplot_YYY_ZWW) : These files contain data of Data Histogram record in (x,y) format. The (x,y) pairs are tab-delimited
7. Range Spectra plot data files (prXXXXX_spectraplot_ZWW) : These files contain data of Range Spectra record in (x,y) format. The (x,y) pairs are tab-delimited
(Where XXXXX : Processing run number
YYY : Image or Raw (IMA or RAW)
Z : L or C band
WW : HH, HV, VH, or/and VV polarization)
APPENDIX-E Acronyms and Abbreviations
CEOS -- Committee on Earth Observation Satellites
JPL -- Jet Propulsion Laboratory
IMG -- SAR Image File
LDR -- SAR Leader File
NVDF -- Null Volume Directory File
PGS -- Product Generation System
RDC -- Radar Data Center
SARL -- Synthetic Aperture Radar Leader File
SIR-C -- Spaceborne Imaging Radar-C
SIS -- Software Interface Specification
TAR -- Tape Archive
TBD -- To Be Determined
TLR -- SAR Trailer File
VDF -- Volume Directory File