setenv <infile> <path name>
setenv <outfile> <path name>
m3tshift [<infile> <outfile>]
<and respond to the prompts>
where infile and outfile are the
logical names of the input and
output files. If they are not present, the program will prompt
the user for both input file and output file logical names.
M3TSHIFT program copies selected time period from one
Models-3 file to a different time period in a different Models-3 file.
Before you run the program, you need to assign
logical names to the physical file
names of both files, according to Models-3 conventions, using the
operation
"setenv <lname> <pname>"
The program will prompt you for the logical names you
have chosen for the input files, and then extensively for the options
to choose; the prompts will have default responses which can be accepted
by hitting <RETURN>. The specification of starting date and time,
target date and time, and duration for the run follow Models-3
date and time conventions.
If you want to run this program in batch mode
(from a script), the recommended way to develop the script is to
run the program once interactively noting the pattern of responses
to prompts which generate the particular analysis you want. The
pattern of responses then becomes either a command-input file which
is redirected into the program in the script, or becomes a
"here-document" fed into the execution. The following
is an excerpt of a script which does the default analysis on
/tmp/myfile.A and /tmp/myfile.B, using
the here-document approach:
...
setenv FOO /tmp/myfile.A
setenv BAR /tmp/myfile.B
m3tshift << !DONE
FOO
BAR
# use default starting date (obtained from the file header)
# use default starting time (obtained from the file header)
2005200 # target date
0 # target time
# use the default run length: entire duration of FOO
!DONE
...
Source code for program m3tshiftis available
under the GNU GPL License, Version 2,
and can be downloaded here from CMAS or
here from GitHub.
To: Models-3/EDSS I/O API: The Help Pages