setenv  FILE1           <path name>
    setenv  FILE2           <path name>
    setenv GRID_REFINEMENT  <re-sampling factor along coordinate axes>
    setenv GRID_SCALE       <re-gridding scale factor>
        <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.


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



Up: Related Programs

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