McIDAS-X User's Guide
Version 2023.1

[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]


STNLIST

Lists weather stations.


Format

STNLIST id1 . . idN [keywords]


Parameters

id1 . . idN

3- to 5-character IDs or 5-digit ID numbers of stations to list


Search Keywords

CO=

list stations in this country; use the CCODE command to list valid 2-letter country codes

LAT=

slat nlat

list stations in this latitude range, where slat and nlat are the southern and northern latitude limits, respectively

LON=

elon wlon

list stations in this longitude range, where elon and wlon are the eastern and western longitude limits, respectively

MATch=

'string'

list stations with an exact match of the specified string, including any spaces

ST=

list stations in this state; use its 2-letter state P.O. abbreviation

USERid=

list stations matching the USERID field in the STNDB.USER and STNDB.SITE files; see the Remarks


Output Keywords

FORm=

ALL

list default information plus the full station name (default=list standard 1-line summary for each station)

 

USER

list all station information in the format of the STNDB.* files; use this option with DEV=T to create a template for your STNDB.USER or STNDB.SITE file; see the Remarks

NUM=

number of stations matching the criteria defined with the other keywords to list; e.g., NUM=50 lists the first 50 matching stations (default=ALL, meaning list all matching stations)

TYPe=

type1 . . typeN

station types to list; valid entries are the following single letters or their multi-letter versions:
M or METAR,
A or SAO,
S or SYNOPTIC,
R or RAOB,
T or TAF or TERMFCST,
W or WSFO,
N or NEXRAD,
C or CMAN,
V or VOR,
E or NAMMOS or ETAMOS,
F or NGMMOS or FOUS14,
G or GFSMOS;
see the Remarks for definitions of each of the types (default=ALL, meaning list all station types)


Interactive and Frame Navigation Keywords

MODe=

N

non-interactive "batch" mode; uses the specified search keywords and/or the cursor's position and size at the time the command is run to determine the stations to list (default)

 

I

interactive mode; you can select multiple regions using the right mouse button or Alt-G, then press the center and right buttons or Alt-Q to quit

RADius=

radius[unit]    

lists the stations within the radius distance from the cursor position; run CU LIST to list valid units and abbreviations; not valid with the SIZE keyword (no default for radius; default=KM for unit)

SIZe=

line ele

list stations within the region defined by the specified number of lines and elements centered at the cursor position; not valid with the RADIUS keyword (no default if id1..idN, CO, LAT, LON, MATCH, ST or USERID is specified and MODE=I is not specified; otherwise default=cursor size)


Dataset Search Keywords

DATaset=

point dataset name and position to search for stations; specify as group/descriptor.position or alias.position where position is a positive integer (absolute position), 0 or a negative integer (relative position), or ALL (no default for group/descriptor or alias; default=ALL for position)

DAY=

list only the stations in the specified DATASET that reported data at the specified DAY and TIME; valid formats include YYYYDDD, YYYY/MM/DD and DD/MON/YYYY, where YYYY, DDD, MM and DD are integers and MON is three or more letters, e.g., JAN or JANUARY (default=current day if DATASET keyword is specified; otherwise no default)

TIMe=

list only the stations in the specified DATASET that reported data at the specified DAY and TIME (default=current hour if DATASET keyword is specified; otherwise no default)


Remarks:

The frame navigation, cursor, and RADIUS and SIZE keywords are used to locate stations if MODE=I is specified or if none of the search keywords (CO, LAT, LON, MATCH, ST or USERID) or id1..idN are specified. MODE=I lets you select multiple geographic regions to list the stations within.

Station elevations are given in meters and all distance and radius values are great circle distances in kilometers, or the unit specified in the RADIUS keyword.

The following single-character codes are used to indicate station types in the Data Types columns of the STNLIST output:

Code Station Type Code Station Type
3 3-Hourly Synoptic 6 6-Hourly Synoptic
A SAO C CMAN Coastal Marine
E NAM MOS (formerly called ETA MOS) F NGM MOS (formerly called FOUS14)
G GFS MOS M METAR
N NEXRAD Doppler Radar R RAOB
T Terminal Aerodrome Forecast (TAF) V VOR Site
W Weather Service Forecast Office (WSFO)    

If the DATASET keyword is not specified, STNLIST lists stations in the station database files STNDB.CORE, STNDB.SITE and STNDB.USER. The .CORE file is supplied with McIDAS-X and should not be modified. The .USER file overrides the .SITE file, which overrides the .CORE file. This order of precedence allows you or your site to change existing stations and/or add new stations in your .USER or .SITE file.

To create a .USER or .SITE file, first run a command similar to the following to create the file in the first writable MCPATH directory.

STNLIST KMSN FORM=USER DEV=T STNDB.USER A

The file contains one long line that defines the data for station KMSN. An equal sign (=) denotes the value of each of the 10 fields (IDN, ID, LATLON, ULATLON, ELE, UELE, ST, CO, NAME, and DATATYPE). Replace the values in the KMSN entry with those for your station and add lines as needed for additional stations. Entries do not have to include all ten fields. The required fields are LATLON and at least one of the following: ID, IDN, USERID. Other fields like CO, ST and NAME are useful but not required. Note that you must follow the one-entry-per-line format for all stations in your .USER and .SITE files. Line breaks are not permitted.

Three additional fields, USERID, COMMENT and VALID, may be optionally added to any station in your .USER and .SITE files. The USERID field is used to assign a unique identifier to your local stations. The COMMENT='comment1' . . 'commentN' field values are listed with the FORM=ALL keyword. The VALID field is used to enter a date range for which the station is valid. If you specify a date range that has passed (e.g., VALID=2000001 2000111), the station is no longer considered valid so will not be listed or plotted with commands S, STNLIST or STNPLOT. The VALID field is useful for leaving station information in your local file and thus providing an audit trail of changes and storing the information in case the station needs to be re-entered at a later date.


Examples

STNLIST EIDW YSSY

This entry lists station information for Dublin, Ireland and Sydney, Australia.

STNLIST ST=TX TYPE=NEXRAD WSFO

This entry lists all NEXRAD Doppler Radar and Weather Service Forecast Offices in Texas.

STNLIST CO=ES MATCH='AEROPUERTO'

This entry lists all airport stations in Spain.

STNLIST LAT=-90 -60 FORM=ALL

This entry lists all stations, and their full station names, between 60 and 90 degrees South latitude (the Antarctic region). The LAT keyword was used instead of CO=AQ because some stations are listed under other country codes, e.g., AR, RU and US.

STNLIST

This entry lists all stations located within the region defined by the current cursor location on the frame. The stations are listed from closest to farthest from the center of the cursor.

STNLIST NUM=5

This entry lists the five stations closest to the center of the cursor.

STNLIST MODE=I RADIUS=50[KM] ST=IL TYPE=METAR

This entry uses the interactive mode to list stations in muliple regions on the frame. For each region selected by pressing the right mouse button or Alt G, the METAR stations in Illinois within 50 km of the cursor center are listed.

STNLIST DATASET=RTPTSRC/SFCHOURLY MODE=I

This entry uses the interactive mode to list stations in muliple regions on the frame. For each region selected by pressing the right mouse button or Alt G, the stations in dataset RTPTSRC/SFCHOURLY that reported data for the current hour are listed. Entries like this one are useful for quickly finding stations with surface hourly data in the vicinity of a feature observed on a satellite or radar image.

STNLIST DATASET=RTPTSRC/UPPERMAND ST=FL TIME=0 TYPE=RAOB

This entry lists the Florida stations in dataset RTPTSRC/UPPERMAND that reported RAOB data at 0 UTC today. Entries like this one are useful for quickly finding RAOB stations with data that can be used in commands like UALIST, UAPLOT and UACROSS.


[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]