CDSH -- CD Source Header Listing

Reads a LGSOWG source header on CD and generates a report.

See Also: MSH

PARAMETERS

CDSH is controlled by the following global parameters: 

Name     Prompt                                  Count     Type
VOLFILE  Volume File Name                        64-1      Char
IMGFILE  Imagery File Name                       64-1      Char
REPORT   Report mode: TERM/OFF/filename          0-64      Char

The following parameter receive output:

MTCH     Mag Tape Characteristics                3         Int

VOLFILE

Specifies the path and name of the file which contains the volume descriptor. 

 EASI>VOLFILE="filespec"

IMGFILE

Specifies the path and name of the file which contains the image data. 

 EASI>IMGFILE="filespec"

REPORT

Specifies the file to which the generated report is appended. 

 EASI>REPORT="filename"
 EASI>REPORT=           | defaults to terminal output
The following names have special meaning: 

 EASI>REPORT="TERM"     | generates reports on your terminal
 EASI>REPORT="DISK"     | generates reports on file "IMPRPT.LST"
 EASI>REPORT="OFF"      | usually cancels report generation, but
                        | CDSH forces REPORT to terminal output

MTCH

CDSH sets the first three values of the CD characteristics parameter (MTCH) to the number of pixels per line, number of lines per band, and number of bands on the CD. The values put in MTCH can be used by automated CD reading procedures.

DETAILS

CDSH reads the CD LGSOWG source header and prints out a report. Currently, only LGSOWG CD format is supported.

The user needs to specify the path and names of the files which contains the volume descriptor and image data.

CDSH also saves the number of pixels, number of lines, and number of bands on the CD in the output parameter MTCH.

EXAMPLE

Run CDSH to determine the information of a LGSOWG CD 

 EASI>VOLFILE="/cdrom/scene1/vol.dat"
 EASI>IMGFILE="/cdrom/scene1/img.dat"
 EASI>REPORT=
 EASI>RUN CDSH
The following is a sample output 

 CDSH     V6.0 EASI/PACE  15:53 30-Nov-95
   
 LGSOWG Volume Descriptor
 
 Control Document Number      CCB-CCT-0002 E A
 Software Release Number      GICSCVF01   
 Physical Volume ID           G0001700        
 Logical Volume ID            416815074700    
 Volume Set ID                LANDSAT 5 TM    
  
 Number of Tapes in Set          1
 Start of Logical Volume         1      End of Logical Volume          1
 Current Tape Volume             1      First File on Volume           1
 Logical Volume in Set           1      Logical Volume in Tape         1
  
 Creation Date-Time           19951021-13052760
 Generating Country           CANADA      
 Generating Agency            CCRS    
 Generating Facility          RSI         
  
  
 LGSOWG Imagery File Descriptor
 
 Number of image records                                    5728
 Image record length                                        7020
 Number of bits per pixel                                      8
 Number of pixels per data group                               1
 Number of bytes per data group                                1
 Justification and order of pixels in data group                
 Number of images                                              1
 Number of lines per image (one band)                       5728
 Number of left border pixels per line                         0
 Number of image pixels allocated per line per band         6920
 Number of right border pixels per line                        0
 Number of top border lines                                    0
 Number of bottom border lines                                 0
 Interleaving indicator                                     BSQ 
 Number of physical records per line                           1
 Number of physical records per multispectral line             1
 Number of bytes of prefix data                               20
 Number of bytes of image data per record                   6920
 Number of bytes of suffix data per record                    68
 Prefix/Suffix repeat flag                                      
 
 Overall imagery size :  6920 Pixels   5728 Lines   7 Bands   8 Bits
About PCI Help Gateway