AXFORM

Converts a McIDAS Area file to ASCII or binary flat files.

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.

[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]