CDCBERS

Description

CDCBERS reads CBERS TIFF file format data for orthorectification. CDCBERS automatically creates a PCIDSK file, reads all the requested imagery channels from CD, and saves the satellite path information in a segment. Output from CDCBERS is used in CATALYST Professional OrthoEngine.

Parameters

Name	Type	Caption	Length	Value range
FILI*	String	Input file name	1 - 192
FILO*	String	Output file name	1 - 192
LINKFILE	String	Create linked file (NO/YES)	0 - 3	YES, NO Default: NO
CDIC*	Integer	CD Input channels or layers	1 - 9	1 - 32
TEX1	String	File description	0 - 192
REPORT	String	Report mode	0 - 192	Quick links
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILI

Specifies the path and file name of the input TIFF or XML file.

Note: If FILI is a TIFF file, the corresponding metadata (.xml) file must exist in the same directory as the imagery file and must have the same file name prefix as the imagery file; for example, the metadata file corresponding to "CBERS_1.tif" must be named "CBERS_1.xml". Output from CDCBERS is used in CATALYST Professional OrthoEngine.

FILO

Specifies the name of the PCIDSK file that will receive the processed data. This file will be created automatically and must not already exist.

LINKFILE

Instead of creating a new PCIDSK FILO to read the data from FILI, this parameter will create an output file in which the image channel is linked to the original imagery channel. The orbital segment will still be created in FILO. The default value is NO. Because CBERS data is stored separately, this option can only be used if only one file is being read.

CDIC

Specifies the list of channels or layers to read from the CD.

For each channel, a corresponding channel is created in the output PCIDSK file.

Up to 9 channels can be specified. Duplicate channels are NOT allowed.

VNIR 1, 2, 3N are 15m resolution with file size of 4100 x 4200
VNIR 3B is 15m resolution with file size of 5000 x 4600
SWIR data is 30m with file size of 2048 x 2100
TIR data is 90 with file size of 700 x 700
Store images of different resolutions and file size into separate files.
For VNIR 3N data, specify CDIC = 31
For VNIR 3B data specify CDIC = 32

Ranges of channels or segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}. When you are not specifying a range in this way, only 48 numbers can be specified explicitly.

TEX1

Optionally specifies a line of text that describes the file. Typically, this contains information that identifies the location of the data and the CD reference number.

If TEX1 (File Description) is not specified, the File Header fields in the generated output PCIDSK image database hold the following information:

FH5 receives the tape ID, satellite sensor, and satellite track
FH7.1 receives the acquisition date and scene center (longitude and latitude, in decimal degrees)
FH7.2 is empty

REPORT

Specifies where to direct the generated report.

Available options are:

TERM: generates a report on the terminal (default)
DISK: generates a report on file "IMPRPT.LST"
OFF: turns off report generation
<filename>: appends a report to the specified file

MONITOR

The program progress can be monitored by printing the percentage of processing completed. A system parameter, MONITOR, controls this activity.

Available options are:

ON: Turns the monitor ON (default)
OFF: Turns the monitor OFF (recommended if running in batch or background mode)

Details

CDCBERS reads CBERS TIFF file format data when satellite orthorectification is required. CDCBERS automatically creates a PCIDSK file, reads all the requested imagery channels from CD, and saves the satellite path information in a segment. Output from CDCBERS is used in OrthoEngine.

The following format is supported:

CBERS 1A

CDCBERS extracts from the CD the geographic coordinates of the scene center and the four corner points. The values are stored in the output orbit segment. These points can be used as ground control point (GCP) input for an approximate correction, which is useful when GCPs are unavailable for an area. Note, however, that using geographic coordinates may not produce very accurate results.

If the LINKFILE (Create Linked File) parameter is set to NO, the output file is automatically created with the dimensions required to hold all of the requested data. Ensure that sufficient disk space is available before running CDCBERS. If LINKFILE is set to YES, the image channel is not created; instead, it is linked to the image channel of FILI, and only one band can be linked.

Example

The user has received a CBERS 1A product in GeoTiff format CD and wishes to perform orthorectification on the data. The user wishes to extract channel 1 and store the data in the file cbers.pix.

EASI>FILI="/cdrom/CBERS_2_CCD1XS_20040616_156_119_BAND2.tif"	 ! for linux/unix
EASI>FILI="D:\CBERS_2_CCD1XS_20040616_156_119_BAND2.tif"            ! for Windows
EASI>FILO="cbers.pix"
EASI>LINKFILE="NO"
EASI>CDIC=1
EASI>TEX1="Richmond Hill, Canada"
EASI>REPORT="cbers.txt"

EASI>R CDCBERS

The file cbersr.pix can now be used as input, along with the collected Ground Control Points, in OrthoEngine.

Acknowledgements

PCI Geomatics wishes to acknowledge the assistance of Dr. Thierry Toutin for this software.

References

Toutin, Th. "Analyse math\u00c3\u00a9matique des possibilit\u00c3\u00a9s cartographiques du syst\u00c3\u00a8me SPOT". Th\u00c3\u00a8se de Docteur-Ing\u00c3\u00a9nieur en Sciences G\u00c3\u00a9od\u00c3\u00a9siques, ENSG, Paris, France, 1985: 1-163.

Toutin, Th. and Carbonneau Y. "La multi-st\u00c3\u00a9r\u00c3\u00a9oscopie pour les corrections d'images SPOT-HRV", Canadian Journal of Remote Sensing, Vol. 15, No. 2 (September 1989): 110. (Also available in English from the Canada Centre for Remote Sensing.)

Environments	PYTHON :: EASI :: MODELER
Quick links	Description :: Parameters :: Parameter descriptions :: Details :: Example :: Acknowledgements :: References