setenv FILE1 <path name>
setenv FILE2 <path name>
setenv GRID_REFINEMENT <re-sampling factor along coordinate axes>
setenv GRID_SCALE <re-gridding scale factor>
insertgrid
<and respond to the prompts>
where FILE1 and FILE2 are the
logical names of the input
and output files. The assumption is that FILE1
has the coarser resolution and larger coverage; FILE2
has finer resolution and smaller coverage that is contained
within the coverage of FILE1 (though it should
work in any case, and that the files have a common set of
variables.
INSERTGRID program takes two GRIDDED files,
FILE1 and FILE2 and for a specified time step
sequence, for each REAL variable in FILE1, and for each
FILE1 grid-cell completely contained within the coverage
of FILE2, the program replaces the original value with a
value averaged and rescaled from the values in FILE2,
using a sub-sampling algorithm using sampling ratio governed by
environment variable GRID_REFINEMENT (default 3). The
default re-scaling is for emissions variables, which use a
non-standard implicitly per-grid-cell units specification (SMOKE
will claim units like "tons per second" when actually the
units are grid-dependent "tons per second per grid cell").
For "proper" MKS-standard units (e.g., energy fluxes in
Watts per square meter), the user needs to set the
GRID_SCALE environment variable to 1.0.
The program supports grid-to-grid/map-projection transformations for all the standard I/O API map projections.
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 iinsertgrid is available
under the GNU GPL License, Version 2,
and can be downloaded here.
To: Models-3/EDSS I/O API: The Help Pages