m3tools Programs WNDWPOINTS and WNDWPTDATA

Usage

For WNDWPOINTS:
    setenv  GRIDDESC    <path name>
    setenv  OUTGRID     <GRIDDESC name of the output-window grid>
    setenv  POINTS      <path name for  input SMOKE POINTS file>
    setenv  PTFLAGS     <path name for output window-flags file>
    setenv  OUTFILE     <path name for output SMOKE POINTS file>
and for WNDWPTDATA
    setenv  GRIDDESC    <path name>
    setenv  OUTGRID     <GRIDDESC grid name>
    setenv  PTFLAGS     <path name for  input window-flags file>
    setenv  INDATA      <path name for output SMOKE POINT-data file>
    setenv  OUTDATA     <path name for output SMOKE POINT-data file>

Summary

The WNDWPOINTS program reads an input SMOKE I/O API format file and an output "window" OUTGRID, extracts all the data that lies within the coverage of OUTGRID, and writes it to a new SMOKE I/O API format file OUTFILE, together with a "flags-file" PTFLAGS for use by program WNDWPTDATA. This file has one variable OUTFILE such that If there are no points in the requested output window, the program returns EXITSTATUS = 3 to the operating system, and does not create PTFLAGS and OUTFILE.

The WNDWPTDATA program reads an input window-flags file from WNDWPOINTS and uses it to window all the (source-subscripted) variables from an input SMOKE point-data file (such as PTMP or PLAY) to the coverage of the indicated OUTGRID, and writes the result to a new SMOKE point-data file.

If you want to run these programs 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.

Requires Fortran-90 for compilation. Source code for program m3cpleis available under the GNU GPL License, Version 2, and can be downloaded here from CMAS or here from GitHub.

See Also:


Up: Related Programs

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