AXFORM
Generates multiple files from an area.
Format
AXFORM area file [keywords]
Parameters
|
area
|
area number
|
|
file
|
output file; maximum of 100 characters; specify as a file name or a fully qualified path (directory and file name); do not include an extension with the file name; see the Remarks
|
Keywords
|
BANd=
|
band numbers for a multibanded area (default=first band)
|
|
|
ALL
|
all bands of area
|
|
FLIp=
|
YES
|
flip bytes; specify this keyword when the byte order on the destination system is the reverse of the source system, e.g., from a PC to a Unix workstation
|
|
|
NO
|
do not flip bytes (default)
|
|
FORmat=
|
I1
|
output elements are 1-byte integers
|
|
|
I2
|
output elements are 2-byte integers
|
|
|
I4
|
output elements are 4-byte integers
|
|
|
(default=see the Remarks)
|
|
FTYpe=
|
ASC
|
ASCII text files with 25I10 format
|
|
|
BIN
|
binary files, as specified in keyword FORMAT (default)
|
|
|
BOTH
|
both ASCII and binary file types
|
|
MISs=
|
missing data value for .LAT/.LON extension files (default=65535 Hex FFFF)
|
|
NAV=
|
YES inc
|
produces .LAT/.LON data files with an element increment; these files contain LAT/LON stored as degrees*100 (2 bytes per element; the increment is the number of data elements associated with each LAT/LON element (default=NO 1)
|
|
UNIt=
|
physical quantity of the output files; see the Remarks (default=calibration units of area )
|
|
|
ALL
|
all calibration units defined by area
|
Remarks
AXFORM creates a set of files containing data from area . These files can be ported to other non-McIDAS systems. Data is represented as 2-dimensional arrays of binary or ASCII fields with the same dimensions as the original area lines/elements.
An ASCII output text file documents the format of the output data files, and contains a listing for each data file generated. Output files are assigned the extensions below. The definitions for .LAT, .LON, .ALT, and .ALN assume keyword NAV=YES.
|
Extension
|
Meaning
|
|
.HDR
|
header file containing ASCII text describing area and the contents of the output data files
|
|
.nnn
|
data file containing binary data for a single calibration of a specific band; the range for nnn is 001 to 999
|
|
.Ann
|
data file containing ASCII data for a single calibration of a specific band; the range for nn is 01 to 99
|
|
.LAT
|
binary file containing a 2-dimensional array of latitudes corresponding to the elements in the output data files
|
|
.LON
|
binary file containing a 2-dimensional array of longitudes corresponding to the elements in the output data files
|
|
.ALT
|
ASCII file containing a 2-dimensional array of latitudes corresponding to the elements in the output data files
|
|
.ALN
|
ASCII file containing a 2-dimensional array of longitudes corresponding to the elements in the output data files
|
The defaults for keyword FORMAT are shown below. They assume FTYPE=BIN or BOTH.
|
If UNIT=
|
Then FORMAT=
|
|
BRIT
|
I1 (1-byte integer)
|
|
TEMP
|
I2 (2-byte integer)
|
|
RAD
|
I4 (4-byte integer)
|
|
ALB
|
I2 (2-byte integer)
|
|
RAW
|
number of bytes/element from area directory
|
|
other
|
I1 (1-byte integer)
|
Examples
AXFORM 12 GOES_VIS
This entry creates a binary file of brightness values from area 12 and places the information in GOES_VIS.001 .
AXFORM 12 GOES_VIS FTYPE=BOTH
This entry creates binary and ASCII files of the brightness values from area 12. The data is placed in GOES_VIS.001 and GOES_VIS.A01 .
AXFORM 43 MULTBAND BAND=2 3 5 UNIT=TEMP
NAV=YES 45
This entry creates binary files for the TEMP values from bands 2, 3 and 5 of area 43. The information is placed in MULTBAND.001 , MULTBAND.002 and MULTBAND.003 , respectively. Latitude and longitude grid files are also created and placed in MULTBAND.LAT and MULTBAND.LON . The lat/lon resolution is 1 lat/lon point for every 45 image elements.
