29.01.2015 Views

Table of Contents - The Atmospheric Studies Group at TRC

Table of Contents - The Atmospheric Studies Group at TRC

Table of Contents - The Atmospheric Studies Group at TRC

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Section 8: CALMET Model Files<br />

8.1 User Control File (CALMET.INP)<br />

<strong>The</strong> selection and control <strong>of</strong> CALMET options are determined by user-specified inputs contained in a file<br />

called the control file. This file, CALMET.INP, contains all the inform<strong>at</strong>ion necessary to define a model<br />

run (e.g., beginning and ending d<strong>at</strong>e and time, grid specific<strong>at</strong>ions, technical options, output options, etc.).<br />

CALMET.inp may be cre<strong>at</strong>ed/edited directly using a conventional editor, or it may be cre<strong>at</strong>ed/edited<br />

indirectly by means <strong>of</strong> the PC-based, Windows-comp<strong>at</strong>ible Graphical User Interface (GUI) developed for<br />

CALMET.<br />

<strong>The</strong> CALMET GUI not only prepares the control file, it also executes the model and facilit<strong>at</strong>es file<br />

management functions; and it contains an extensive help system th<strong>at</strong> makes much <strong>of</strong> the inform<strong>at</strong>ion in<br />

this manual available to the user on-line. Although the model can be set up and run entirely within the<br />

GUI system, the interface is designed to always cre<strong>at</strong>e the ASCII CALMET.INP file. This allows runs to<br />

be set up on PC-based systems and the control file transferred to a workst<strong>at</strong>ion or a mainframe computer<br />

for comput<strong>at</strong>ionally intensive applic<strong>at</strong>ions. <strong>The</strong> ASCII CALMET.INP file should be directly<br />

transportable to virtually any non-PC system.<br />

When CALMET is setup and run entirely on a non-PC system, or if the GUI is not used on a PC, the<br />

control file CALMET.INP may be configured by using a conventional editor. This is facilit<strong>at</strong>ed by the<br />

extensive self-documenting st<strong>at</strong>ements contained in the standard file. As explained further below, more<br />

comments can be readily added by the user to document specific parameter choices used in the run.<br />

<strong>The</strong>se comments remain in the file, and are reported to the CALMET list file when CALMET is executed<br />

from the command line. Note, however, th<strong>at</strong> the GUI always writes the standard comments to<br />

CALMET.INP, and ignores any additional text. Furthermore, the control file is always upd<strong>at</strong>ed by the<br />

GUI, even if the GUI is only used to run CALMET without altering the technical content <strong>of</strong> the control<br />

file. Thus, the user must save the control file to another filename prior to using the GUI if non-standard<br />

comments are to be saved. This fe<strong>at</strong>ure <strong>of</strong> the GUI can be used to cre<strong>at</strong>e a new copy <strong>of</strong> the standard<br />

control file by merely saving a “new file” to disk, so a fresh version <strong>of</strong> the control file is always available.<br />

<strong>The</strong> control file is organized into 10 major Input <strong>Group</strong>s preceded by a three line run title (see <strong>Table</strong> 8-2).<br />

<strong>The</strong> Input <strong>Group</strong>s must appear in order, i.e., Input <strong>Group</strong> 0 followed by Input <strong>Group</strong> 1, etc. However, the<br />

variables within an Input <strong>Group</strong> may appear in any order. Each Input <strong>Group</strong> must end with an Input<br />

<strong>Group</strong> termin<strong>at</strong>or consisting <strong>of</strong> the word END between two delimiters (i.e., !END!). Even a blank Input<br />

<strong>Group</strong> (i.e., one in which no variables are included) must end with an Input <strong>Group</strong> termin<strong>at</strong>or in order to<br />

signal the end <strong>of</strong> th<strong>at</strong> Input <strong>Group</strong> and the beginning <strong>of</strong> another. Note th<strong>at</strong> Input <strong>Group</strong> 0 consists <strong>of</strong> four<br />

subgroups.<br />

A sample control file is shown in <strong>Table</strong> 8-3. It is designed to be flexible and easy to use. <strong>The</strong> control file<br />

is read by a set <strong>of</strong> FORTRAN text processing routines contained within CALMET which allow the user<br />

considerable flexibility in designing and customizing the input file. An unlimited amount <strong>of</strong> optional<br />

8-5

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!