Program M3TSHIFT

Usage

    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.

Summary

The 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.


Previous: M3TPROC

Next: M3WNDW

Up: Related Programs

To: Models-3/EDSS I/O API: The Help Pages