McIDAS User's Guide
Version 2017.2

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


SFCCON

Contours surface hourly data from ISFC-schema point files.


Formats

SFCCON param map time day [keywords]
SFCCON par1-par2 map time1-time2 day1-day2 [keywords]


Parameters

param

parameter to contour; valid parameters are those defined in the SFCCON.CORE, SFCCON.SITE and SFCCON.USER files; see the Remarks for more information and a list of the parameters in SFCCON.CORE (default=T)

par1-par2

parameter difference to contour, e.g., T-TD for dewpoint depression; see the Remarks

map

map for the contour; see the MAP command for a list of valid predefined maps, for example, FL, MID, USA, WORL (default=do not draw a map; use the navigation of the frame specified with NAV keyword)

time

observation time; see the Remarks (default=current or most recent reporting hour)

time1-time2

time difference to contour, e.g., 12-6 to subtract 6 UTC data from 12 UTC data; see the Remarks

day

observation date; 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, for example, JAN or JANUARY (default=current)

day1-day2

day difference to contour, e.g., 2000110-2000109 to subtract day 2000109 data from day 2000110 data; see the Remarks


Keywords

CHIlltype=

CURRENT

compute the wind chill values for the CHILL option using the formula implemented by the National Weather Service in November 2001 (default)

 

OLD

compute the wind chill values using the pre-2001 formula

CINt=

num

contour interval; specify 0 to let SFCCON compute a reasonable interval; specify your own interval as an integer or decimal value greater than zero (default=from the CONTOUR.DEF text file; if no file entry matches the parameter and units, default=0)

 

string

contour values; specify the name of a string that contains up to 64 values; e.g., CINT=SNOWDEPTH will draw contours at the values specified in the string named SNOWDEPTH

COLor=

graphics color level for the display (default=2)

DASh=

ALL

dash all contours

 

NEG

dash negative contours only

 

POS

dash positive contours only

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)

GRA=

graphic frame number for the display (default=current)

LSIze=

contour label height, in pixels (default=8)

NAV=

num

frame to use for navigation

 

C

use the current frame's navigation (default)

 

you cannot use the NAV keyword if you specify a map with the map parameter

PTYpe=

ALT

use altimeter setting when computing station pressure for use in the equations that generate the contoured values if the PSTN, MIX, THA or THAE option is specified (default); see the Remarks

 

PMSL

use sea-level pressure when computing station pressure for use in the equations that generate the contoured values if the PSTN, MIX, THA or THAE option is specified

UNIt=

units for the specified parameter; see the Remarks for defaults; run the CU LIST command to list the valid units and abbreviations for the parameters that can be changed


Remarks

SFCCON builds and runs a PTCON command to display surface hourly data from ISFC-schema point files. SFCCON accepts all the keywords in the PTCON command except LAT, LON, MAP, PRO, SLAT, SLON and PARAM because they may conflict with SFCCON's parameters or keywords. You can use the PTCON SELECT keyword to limit the analysis to a specified list or range of values, but you cannot specify a different parameter, time, day or unit than those defined by the SFCCON parameters or keywords.

The table below lists the parameter name, default units and a description of each parameter defined in the SFCCON.CORE file. Default units enclosed in parenthesis cannot be changed. 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 parameters and/or add new parameters in your .USER or .SITE file. To create a .USER or .SITE file, copy the .CORE file from ~mcidas/data to your $HOME/mcidas/data directory (or another MCPATH directory), rename it, then edit the existing predefined parameters and/or add new ones.

param Default Units Description
ELEV FT station elevation
T F temperature
CHILL (F) wind chill index
HEAT (F) heat index
TD F dew point temperature
MIX (G/KG) mixing ratio
THA (K) potential temperature
THAE (K) equivalent potential temperature
DIR (degrees) wind direction
SPD KTS wind speed
GUS KTS wind gusts
STREAML   streamlines
ALTIM MB altimeter setting
PMSL MB sea-level pressure
PSTN (MB) station pressure
VIS MI visibility
PCP IN three- or six-hour precipitation total; three-hour total reported only at 3, 9, 15, 21 UTC; six-hour total reported only at 0, 6, 12, 18 UTC; see the Remarks
PCP3 IN three-hour PCP total; reported only at 3, 9, 15, 21 UTC; see the Remarks
PCP6 IN six-hour PCP total; reported only at 0, 6, 12, 18 UTC; see the Remarks
PCP24 IN 24-hour precipitation total; reported at 12 UTC; see the Remarks
SNO IN snow depth; reported only at 0, 6, 12, 18 UTC; see the Remarks
CAC (code) ceiling cloud amount; 0=clear, 5=few, 1=scattered, 2=broken, 3=overcast
CA1 (code) first non-ceiling cloud amount; 0=clear, 5=few, 1=scattered, 2=broken, 3=overcast
CA2 (code) second non-ceiling cloud amount; 0=clear, 5=few, 1=scattered, 2=broken, 3=overcast
CZC FT height of cloud ceiling
CZ1 FT height of first non-ceiling cloud layer
CZ2 FT height of second non-ceiling cloud layer
ABV (sec-1) absolute vorticity
VOR (sec-1)   vorticity
DVG (sec-1)   divergence

The time default is the current hour for all parameters except PCP, PCP3, PCP6, PCP24 and SNO. Because PCP and SNO are not reported every hour in METAR reports, the default for these parameters is the most recent hour storing the data. PCP is reported every three hours starting at 0 UTC. PCP3 represents the three-hour totals in PCP; it is reported at 3, 9, 15, and 21 UTC. PCP6 represents the six-hour totals in PCP; it is reported at 0, 6, 12, and 18 UTC. PCP24 represents the 24-hour precipitation totals and is reported at 12 UTC only. SNO is reported every six hours at 0, 6, 12, and 18 UTC.

This means, for example, that the time default for PCP is 0 if the current time is between 0:00 and 2:59 UTC; the time default for PCP3 is 3 if the current time is between 3:00 and 8:59 UTC; the time default for SNO and PCP6 is 6 if the current time is between 6:00 and 11:59 UTC. The time default for PCP24 is 12 UTC today if the current time is between 12:00 and 23:59 UTC, and is 12 UTC yesterday if the current time is between 0:00 and 11:59 UTC.

Parameter advection or divergence is done by appending ADV or DVG to the parameter name, e.g., TADV and SPDDVG. Parameters with their default units enclosed in parenthesis in the table above (e.g., CHILL, MIX and THA) and advected or diverged parameters cannot be used with the differencing options (par1-par2, time1-time2 and day1-day2).

If you specify both a time difference (time1-time2) and a day difference (day1-day2), SFCCON contours the values equal to the parameter at time1,day1 minus the parameter at time2,day2. If you specify a parameter difference (par1-par2) with a time difference and day difference, SFCCON contours the values equal to the parameter difference at time1,day1 minus the parameter difference at time2,day2. For example,
SFCCON T-TD MID 0-12 2000123-2000122 contours the values equal to the dewpoint depression at 0UTC,day2000123 minus the dewpoint depression at 12UTC,day2000122.

In the PTYPE keyword, specify either PMSL or SLP for sea-level pressure, and ALT, ALTM or ALTIM for altimeter setting. The keyword is valid only with the calculated options that contain station pressure in their equations (PSTN, MIX, THA and THAE). Altimeter setting is the default because it's correct to use it (rather than sea-level pressure) when computing station pressure for use in the equations.


Examples

SFCCON

This entry contours the temperature for the current day and time using the navigation of the current frame.

SFCCON PCP3 UNIT=MM

This entry contours the most recent three-hour precipitation totals in millimeters using the navigation of the current frame. For example, if the current time is 19 UTC, the 15 UTC data is plotted since three-hour precipitation totals are reported only at 3, 9, 15 and 21 UTC.

SFCCON SNO MID 12 UNIT=CM COLOR=7 LABEL='12 UTC Midwest snow depth, in centimeters' 7 420 150

This entry contours snow depth in centimeters at 12 UTC over a map of the Midwest. The contours are drawn in graphics color level 7. The default label below the plot is replaced with the text 12 UTC Midwest snow depth, in centimeters near the center of the frame in graphics color level 7. LABEL is a PTCON keyword.

TE COLD "-20 -10 0 10 20 25 30 32 35

SFCCON T CINT=COLD DASH=NEG

The TE command creates a string called COLD containing contour values for the SFCCON entry. The SFCCON entry draws the -20, -10, 0, 10, 20, 25, 30, 32 and 35° Fahrenheit temperature contours for the current day and time using the navigation of the current frame. The -20° and -10° contours are dashed; the others are solid. Do not specify a pound sign (#) before the string name in the CINT keyword.

SFCCON PMSL NA 6 12/JAN/1996 DATASET=CLIMATE/1996

This entry contours sea-level pressure over a map of North America at 6 UTC on 12 January 1996 using the data in the dataset CLIMATE/1996.

SFCCON TDADV KY

This entry contours dewpoint temperature advection over a map of Kentucky.

SFCCON VIS MID 12-0 2000131-2000130

This entry contours the 36-hour visibility change from 0 UTC, day 2000130 to 12 UTC, day 2000131 over a map of the Midwest.

SFCCON THA USA PTYPE=PMSL

This entry calculates and contours potential temperature over a map of the United States for the current day and hour. Mean sea-level pressure is used when computing station pressure for use in the potential temperature calculation. This may yield some error in the values, with higher station elevations usually having larger errors.


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