Program M3MERGE

Usage

    setenv  <infile 1>   <path name>
    setenv  <infile 2>   <path name>
    ...
    setenv  <outfile>   <path name>

    m3merge <and respond to the prompts>

where infile 1, infile 2, ... are the logical names of the input files.

Summary

The M3MERGE program creates a single output file from selected sets of variables from a set of I/O API input files over a commmon grid and time period. The input variables must be of basic data type M3REAL; all of the files must have the same grid, layer-structure, and the same file-type, which must be one of the following:

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, for the set of variables to include from each file, and for the time step sequence to process. The prompts have default responses indicated in square brackets [LIKE THIS], which can be accepted by hitting <RETURN>. The specification of starting date and time, target date and time, and number of time step records 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 you may redirect into the program in the script, or may become a "here-document" fed into the execution by the script.

Versions of the program are available for each supported architecture (workstation versions are currently in the directories /env/proj/ppar/(SunOS5f90 | IRIX6n32f90 | IRIX64f90)/bin.

Requires Fortran-90 for compilation. Source code for program m3merge is available under the GNU GPL License, Version 2, and can be downloaded here.

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

See Also:

M3COMBO: computes linear combinations of sets of variables and write them to an I/O API file.
M3DIFF: compute statistics for pairs of variables and for the results of applying various comparison ("differencing") operations to those variables in a pair of files, with optional I/O API file output of the results.
SELMRG2D: merge selected layers of variables from 2D or 3D I/O API files, and write them to a 2-D I/O API file.

Previous: M3MASK

Next: M3PAIR

Up: Related Programs

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