McIDAS-X User's Guide
Version 2023.1

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


SFCLIST

Lists surface hourly data from point files.


Format

SFCLIST id1 . . idn nhours [keywords]


Parameters

id1 . . idn

station IDs or states to list; use the two-character state P.O. abbreviations for states; specify either IDs or states, but not a combination; see the Remarks

nhours

number of hours to search for observations starting from the current time and going backwards; use the TIME keyword to specify a range of times; see the Remarks (default=1)


Search Keywords

CO=

co1 . . con

lists observations for all stations in these countries; use CCODE command to list valid country codes; see the Remarks

DATaset=

ADDE point dataset name and position; 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 (default=RTPTSRC/SFCHOURLY.ALL)

DAY=

bday eday

range of days to list; uses the TIME keyword, not nhours parameter to list times (default=current bday)

SELect=

'clause1; clause2; . . ; clausen'
finds only the data matching the values in the select clauses; single quotes are mandatory; separate select clauses with semicolons; specify clause as a range or a list using one of the following formats:

 

 

range:
list:

parameter [unit] bval eval
parameter
[unit] val1,val2, . . ,valn

 

 

parameter

point file parameter; you cannot use ID, ST, CO, TIME or DAY in a clause

 

 

[unit]

units for the parameter values; units are optional but must be in square brackets if specified (default=from point dataset)

 

 

bval eval

range of parameter values

 

 

val1, . ., valn

list of parameter values

SPAn=

TIME

lists all data in the TIME keyword range, btime to etime, for each day of the DAY keyword range, bday to eday (default)

 

DAY

lists all data from btime on bday through etime on eday

TIMe=

btime etime

range of times to list; overrides nhours parameter (default=current btime)


Output Keywords

OPTion=

o1 . . on

optional output fields to display; choose from the following options

 

NONE

doesn't display any optional fields (default)

 

ALL

displays all optional fields listed below

 

CHILL

displays the derived wind chill index, WCI

 

CLOUD

displays the first and second non-ceiling cloud parameters, Cld1 and Cld2

 

HEAT

displays the derived heat index, HI

 

HUMID

displays the relative humidity, RH, and mixing ratio, MIX

 

PRECIP

displays liquid precipitation, Pcp, snow depth, Sno, and 24-hour precipitation, P24

 

SLP

displays the sea-level pressure, SLP

 

STP

displays derived station pressure, STP

 

THETA

displays derived potential temperature, Th, equivalent potential temperature, ThE, and wetbulb potential temperature, ThW; displayed in Kelvin regardless of value specified with the UNIT keyword

 

VAPOR

displays derived vapor pressure, e, and saturation vapor pressure, es

 

VIRTUAL

displays derived virtual temperature, Tv

 

WETBULB

displays derived lifted condensation level, LCL, and wet bulb temperature, Tw

CHIlltype=

CURRENT

compute the wind chill values listed with OPT=CHILL using the formula implemented by the National Weather Service in November 2001 (default)

 

OLD

compute the wind chill values using the pre-2001 formula

PTYpe=

ALT

use altimeter setting in computations of derived parameters listed in OPT=HUMID, STP, THETA, VIRTUAL and WETBULB options; see the Remarks

 

PMSL

use sea-level pressure in computations of derived parameters listed in OPT=HUMID, STP, THETA, VIRTUAL and WETBULB options (default)

SORt=

TIME

sorts output by nominal hour, HH; for each hour, stations are listed alphabetically, regardless of the actual reporting time (default)

 

OBTIME

sorts output by the exact time of observation, HHMM; for each time, stations are listed alphabetically

 

STN

sorts output alphabetically by station; for each station, observations are listed chronologically

UNIt=

A

lists output in American units: temperatures in Fahrenheit, wind speed and gusts in knots, visibility in miles, cloud heights in 100s of feet, precipitation and snow depth in inches (default)

 

M

lists output in metric units: temperatures in Celsius, wind speed and gusts in meters/second, visibility in kilometers, cloud heights in hectometers, precipitation and snow depth in millimeters


Remarks

SFCLIST displays point file data in an easy-to-read format that includes columns for temperature, dewpoint temperature, wind direction and speeds, pressure, visibility, current weather, and cloud ceiling. Special (i.e., nonhourly) observations are indicated by an S in the first column of the output. This data is obtained from the same raw observational text reports displayed by the command SFCRPT, but formatted in columns.

The cloud ceiling (Ceil) field on the right side of the output is displayed as coverage/height. Coverage is listed in eighths; height is listed in hundreds of feet if UNIT=A, or in hectometers if UNIT=M. For example, 3/111 represents 3/8ths cloud coverage at a height of 11,100 feet if UNIT=A, or 11,100 meters if UNIT=M. If OPTION=CLOUD or ALL is specified, the coverage and height values for the first and second non-ceiling levels (Cld1 and Cld2) are also listed.

You must specify at least one station ID, state, or country. Normally, you should not specify a combination of station IDs, states or countries. Because SFCLIST uses a logical AND between different search conditions, only data that satisfies all of the specified conditions is listed. For example, the command SFCLIST KBOS FL will not find any data because Boston (KBOS) is not in the state of Florida; SFCLIST NY CO=AU will not find any data because there is no Australian state with the abbreviation NY. If you specify multiple values for a single search condition however, SFCLIST uses a logical OR to list all data. For example, the command SFCLIST KBOS KMIA lists all data for both Boston and Miami.

When using the nhours parameter, the current time determines which data is listed. For example, if you run the command SFCLIST KMSN 1 between 11:00 and 11:59 UTC, Madison's 11 UTC data is listed. If you run it between 12:00 and 12:59 UTC, the 12 UTC data is listed. If the current time is before 13 UTC (12:55, for example) but the 13 UTC data is available, you cannot list it using nhours; you must specify TIME=13.

In the PTYPE keyword, specify either PMSL or SLP for sea-level pressure pressure, and ALT, ALTM or ALTIM for altimeter setting. The keyword is valid only with the calculated options that contain a pressure value in their equations (OPT=HUMID, STP, THETA, VIRTUAL and WETBULB). Sea-level pressure is the default because it's the correct pressure type for those equations. However, since altimeter setting is usually much more common (than sea-level pressure) in surface hourly reports, you can use it by specifying PTYPE=ALT. But if you do so, be aware that the values of the calculated parameters won't be correct. The amount of error depends on the equation (e.g., mixing ratio values are usually about the same whether using sea-level pressure or altimeter setting) and the station elevation (higher elevations usually result in larger differences).


See Also

See the PTLIST command for additional information about select clauses.


Examples

SFCLIST TX

This entry lists all surface data for Texas from the past hour.

SFCLIST TX OK KS 2

This entry lists all surface data for Texas, Oklahoma, and Kansas from the past two hours.

SFCLIST KMIA KLAX TIME=6 12

This entry lists all surface data for Miami and Los Angeles from 6 to 12 UTC today.

SFCLIST KMSN TIME=0 12 DAY=96100 96105 SPAN=DAY DATASET=CLIMATE/1996

This entry lists all archived surface data for Madison from 0 UTC on day 96100 to 12 UTC on day 96105.

SFCLIST KMSN TIME=0 12 DAY=96100 96105 DATASET=CLIMATE/1996

This entry lists all archived surface data for Madison from 0 UTC to 12 UTC on each day in the range 96100 through 96105.

SFCLIST X 6 CO=IT ES FR

This entry lists all surface data for Italy, Spain, and France from the past six hours.

SFCLIST MS 3 CO=US

This entry is an exception to the rule stated in the Remarks above. It lists all surface data for Mississippi from the past three hours. The CO=US keyword eliminates data from stations in other countries that use MS as the state/province/territory abbreviation. It is rarely necessary to specify the CO keyword when listing data for a U.S. state because very few stations outside the United States use an abbreviation that matches a U.S. state abbreviation.

SFCLIST CO=US SELECT='T[F] -100 -5 ; SPD[KTS] 20 40' OPTION=CHILL

This entry lists surface data, including the wind chill index, for all stations in the United States reporting a temperature below -5°F and wind speed between 20 and 40 knots from the past hour.


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