Program M3XTRACT


    setenv  <infile>    <path name>
    setenv  <outfile>   <path name>
    m3xtract [<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.


The M3XTRACT program extracts a selected subset of variables and/or layer or layers from the input file for a specified time period from one Models-3 file and writes them to a different Models-3 file, with optional renaming of the variables during the process. 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.

Source code for program m3xtract is available under the GNU GPL License, Version 2, and can be downloaded here from CMAS or here from GitHub.

Previous: M3WNDW

Next: M3FAKE

Up: Related Programs

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