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.
M3TSHIFTprogram 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
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
under the GNU GPL License, Version 2,
and can be downloaded here from CMAS or
here from GitHub.
Up: Related Programs
To: Models-3/EDSS I/O API: The Help Pages