Skip to content

StateDMI / Command / ReadClimateStationsFromList

Overview

The ReadClimateStationsFromList command reads a list of climate stations from a delimited list file and defines climate stations in memory. The climate stations can then be manipulated and output with other commands.

Command Editor

The following dialog is used to edit the command and illustrates the command syntax.

ReadClimateStationsFromList

ReadClimateStationsFromList Command Editor (see also the full-size image)

Command Syntax

The command syntax is as follows:

ReadClimateStationsFromList(Parameter="Value",...)

Command Parameters

Parameter             Description Default          
ListFile The name of the list file to be read. None – must be specified.
IDCol The column number (1+) containing the climate station identifiers. None – must be specified.
NameCol The column number (1+) containing the climate station name. None – optional (name will be initialized to blank).
LatitudeCol The column number (1+) containing the climate station latitude. None – optional (latitude will be initialized to missing data).
ElevationCol The column number (1+) containing the climate station elevation. None – optional (elevation will be initialized to missing data).
Region1Col The column number (1+) containing the climate station Region1. None – optional (Region1 will be initialized to blank).
Region2Col The column number (1+) containing the climate station Region2. None – optional (Region2 will be initialized to blank).

Examples

See the automated tests.

At a minimum, the list file must contain a column with station identifiers. Lines starting with the # character are treated as comments. Column names can be specified in the first non-comment line by enclosing each column name in quotes.

An example list file is shown below, for example created from CDSS TSTool software:

# Climate stations
“ID”,”Name”
0130,” ALAMOSA SAN LUIS VALLEY RGNL”
0776,”BLANCA”
1458,” CENTER 4 SSW”
2184,” DEL NORTE 2 E”
3541,” GREAT SAND DUNES N M”
3951,” HERMIT 7 ESE”
5322,” MANASSA”
5706,” MONTE VISTA 2 W”
7337,” SAGUACHE”

The following example command file illustrates how climate stations can be defined from a list and written to a StateCU file:

ReadClimateStationsFromList(ListFile="climsta.lst",IDCol=1)
FillClimateStationsFromHydroBase(ID="*")
SetClimateStation(ID="3016",Region2="14080106",IfNotFound=Warn)
SetClimateStation(ID="1018",Region2="14040106",IfNotFound=Warn)
SetClimateStation(ID="1928",Elevation=6440,IfNotFound=Warn)
SetClimateStation(ID="0484",Region1="MOFFAT",IfNotFound=Add)
WriteClimateStationsToStateCU(OutputFile="COclim2006.cli")

Troubleshooting

See Also