Program M4FILTER
Usage
setenv <infile> <path name>
m4filter
where infile is the logical name
of the input file.
Summary
The program m4filter can be used to convert files from
the previous version of the I/O API to the new version. It has a
in it both a copy of the old version and a new version ("m4io")
with the names of the routines changed so that the linker doesn't
get confused. To run it, you need to have assigned
logical names to the physical
file names of both the input and output files, according to
Models-3 conventions. You
will be prompted for those attributes of the new (output) file
which are not found in the header of the input file. All of these
attributes have to do either with the
horizontal or the
vertical grid and
coordinate system description. They are the following:
- P_ALPHA First horizontal coordinate
system (map projection) descriptive angle parameter
- P_BETA Second horizontal coordinate
system (map projection) descriptive angle parameter
- P_GAMMA Third horizontal coordinate
system (map projection) descriptive angle parameter
- XCENT Longitude for the origin of the
Cartesian (X-Y) coordinate system (except for UTM, where
it is the standard-UTM location for the origin of
offset-UTM coordinate systems (in meters)).
- YCENT Latitude (or UTM) for the origin
of the Cartesian (X-Y) coordinate system (At latitude YCENT,
longitude XCENT (or standard-UTM coordinates (XCENT,YCENT)),
the Cartesian (X,Y) is (0,0).
- VGTYPE Vertical coordinate system type
- VGTOP Top of the model
(sigma-coordinates only)
- VGLVS(0:NLAYS) Array of level values
defining the full-levels.
Before you run the program, you need to assign a
logical name to the physical file
name of the input file, according to Models-3 conventions, using
the operation
"setenv <lname> <pname>"
The program will prompt you for the logical name you
have chosen for the input file, and then extensively for the options
to choose; the prompts will have default responses which can be
accepted by hitting <RETURN>.
Note that the set of conversions which can be performed by one
execution of M4FILTER is quite complex, being dependent upon the
type of file being converted. If you want to run this program in
batch mode (i.e., from a script), the recommended
way to develop the script is to run the program once interactively
while noting your pattern of responses to the prompts. The pattern
of responses then becomes either a command-input file which is
redirected into the program's execution by the script, or becomes
a "here-document" fed into the execution.
Previous: M3FAKE
Next: MTXBUILD
Up: Related Programs
To: Models-3/EDSS I/O API: The Help Pages