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 />

descriptive text can be inserted within the control file to make it self-documenting. For example, the<br />

definition, allowed values, units, and default value <strong>of</strong> each input variable can be included within the<br />

control file.<br />

<strong>The</strong> control file processor searches for pairs <strong>of</strong> special delimiter characters (!). All text outside the<br />

delimiters is assumed to be user comment inform<strong>at</strong>ion and is echoed back but otherwise ignored by the<br />

input module. Only d<strong>at</strong>a within the delimiter characters are processed. <strong>The</strong> input d<strong>at</strong>a consist <strong>of</strong> a<br />

leading delimiter followed by the variable name, equals sign, input value or values, and a termin<strong>at</strong>ing<br />

delimiter (e.g., !XX = 12.5 !). <strong>The</strong> variable name can be lower or upper case, or a mixture <strong>of</strong> both (i.e.,<br />

XX, xx, Xx are all equivalent). <strong>The</strong> variable can be a real, integer or logical array or scalar. <strong>The</strong> use <strong>of</strong><br />

repetition factors for arrays is allowed (e.g., ! XARRAY = 3 * 1.5 ! instead <strong>of</strong> ! XARRAY = 1.5, 1.5, 1.5<br />

!). Different values must be separ<strong>at</strong>ed by commas. Spaces within the delimiter pair are ignored.<br />

Exponential not<strong>at</strong>ion (E form<strong>at</strong>) for real numbers is allowed. However, the optional plus sign should be<br />

omitted (e.g., enter +1.5E+10 as 1.5E10). <strong>The</strong> d<strong>at</strong>a may be extended over more than one line. <strong>The</strong> line<br />

being continued must end with a comma. Each leading delimiter must be paired with a termin<strong>at</strong>ing<br />

delimiter. All text between the delimiters is assumed to be d<strong>at</strong>a, so no user comment inform<strong>at</strong>ion is<br />

allowed to appear within the delimiters. <strong>The</strong> inclusion in the control file <strong>of</strong> any variable th<strong>at</strong> is being<br />

assigned its default value is optional.<br />

<strong>The</strong> control file reader expects th<strong>at</strong> logical variables will be assigned using only a one character<br />

represent<strong>at</strong>ion (i.e., 'T' or 'F'). Input <strong>Group</strong>s 7-9 are handled differently (making use <strong>of</strong> FORTRAN free<br />

reads), because they contain Character*4 input d<strong>at</strong>a. <strong>The</strong> d<strong>at</strong>a portion <strong>of</strong> each record in Input <strong>Group</strong>s 7-9<br />

must start in Column 9 or gre<strong>at</strong>er <strong>of</strong> the record.<br />

Each CALMET control file input variable is described in <strong>Table</strong> 8-4. <strong>The</strong> control file module has a list <strong>of</strong><br />

the variable names and array dimensions for each Input <strong>Group</strong>. Checks are performed to ensure th<strong>at</strong> the<br />

proper variable names are entered by the user, and th<strong>at</strong> no array dimensions are exceeded. Error<br />

messages result if an unrecognized variable name is encountered or too many values are entered for a<br />

variable.<br />

Note th<strong>at</strong> if LLCONF=T, then all x,y coordin<strong>at</strong>es in the CALMET.INP file must be specified on the<br />

chosen Lambert Conformal projection grid, r<strong>at</strong>her than in UTM coordin<strong>at</strong>es.<br />

A standard control file is provided along with the CALMET test case run. It is recommended th<strong>at</strong> a copy<br />

<strong>of</strong> the standard control file be permanently stored as a backup. Working copies <strong>of</strong> the control file may be<br />

made and then edited and customized by the user for a particular applic<strong>at</strong>ion.<br />

8-6

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

Saved successfully!

Ooh no, something went wrong!