Program Reference




meteoplot - Surface and MOS meteogram plotting


meteoplot [parameters...] filename


Command Line Resource Default Description
-h help No Lists basic help information.
-df=filename default wxp.cfg Sets the name of the resource file.
-na=name name meteoplot Specifies the name used in resource file parsing.
-me=level message out2 Specifies level of messages to be displayed
-fp=path file_path the current directory Specifies location of database files.
-dp=path data_path the current directory Specifies the location of the input raw data files.
-cp=path con_path the current directory Specifies location of decoded/converted data files
-mp=path model_path the current directory Specifies location of raw model GRIB data
-ip=path image_path the current directory Specifies location of output image files (.gif/,png) from WXP.
-cf=filename city_file program specific Specifies the name of the city database file
-nc=name_conv name_conv name.cnv or name_conv file This sets which name convention file to use.
-if=in_file in_file sfc_cvt Specifies the input file name tag.
-ou=output output program specific Specifies the output of the program.
-cu=[hour] current none This specifies to use current data files.
-ho=hour hour none Specifies the exact hour that a data file is valid for.
-nh=hours[,skip] num_hour Value Generally 0 Specifies the number of hours worth of data to use in the program
-tz=zone_name timezone UTC Sets timezone used in date labels
-id=ident[,ident...] identifier None Specifies a station identifier to plot or parse for
-mo=model model None Specifies the model to use for the MOS meteograms. The default is none which uses observations. The possible values are "nam", "lamp" and "gfs".
-va=variable variable none Sets the parameter/variable to be displayed
-sc=type plot_scale 1.0 Specifies a scaling factor for all plotted text, symbols, vectors, etc.
-fm=format format None Specifies the output format of data.
-pa=param[,param...] parameter none Specifies addition parameters to program.
-dr=value[,value...] draw all Specifies which part of the plot is to be drawn.
-la=type label Program defaults Specifies the labels to be plotted around the plot. By default, labels are generated by the program and plotted above and below the plot. This resource overrides these labels.
-fl=font_file[,font_file...] font_list modern.fnt Specifies a list of fonts to use in the plots.
-ct=color_table color_table wxp.clr Specifies the color table to use in the plot. This maps color names to actual RGB color values.
-cod=color[:attribute...] color_data green (for most programs) Specifies the color for plotted data.
-cog=color[:attribute...] color_grid red (for most programs) Specifies the color and attributes for background grids
-col=color[:attribute...] color_label white (black on inverse plots) Specifies the text color for labels above and below the plot.
-de=device[,parameters] device d for display Specifies the output device.
-ge=widthxheight[+x+y] geometry 640x512 (for windowed plots) Specifies the window and paper geometry.
-ti=title title The name of the program or the value of the name resource Specifies the window title.
-ic icon off Specifies whether to open window in iconified mode.
-bg=color background black Specifies the background color of the window.
-iv inverse off Specifies an inverse window background (white)
-lo=type logo none Adds a logo to the image
filename (positional) filename none Specify input filename


This program plots a time series of surface data on a meteogram. The input to the program is either a surface converted file produced by either the prog:sfcdec program or MOS data. Then, based on a variable selected by the user, a plot is generated.

Surface Data Meteogram

The surface data meteogram will plot a time series of data. The number of hours is based on the resrc:num_hour resource. The default is 24 hours but up to 121 times (5 days hourly) can be specified.

The programs needs three pieces of information. First, it needs the input file. This is the latest surface converted file unless otherwise specified. The user may specify a different name using the resrc:current or resrc:filename resource. The input name convention is derived from the sfc_cvt in file tag but may be altered with the resrc:in_file resource.

Second, it needs the station to plot data for. This is done by specifying a ICAO station identifier with the resrc:identifier resource.

Finally, it needs to variable or set of variables to plot. If none is specified, a temperature plot will be displayede the resrc:variable to specify another variable. The program uses the meteoplot.var file to specify more complex plots. Here is a list of the base parameters that can be displayed:

Internal Variables
Variable Description and units Plots
temp Temperature (F) value
dewp Dewpoint (F) value
dewd Dewpoint depression (F) value
wdir Wind direction (deg) value
wspd Wind speed (knt) value
wgst Wind gust (knt) (not in MOS) value
Wind speed and direction (knt) value0=dir,
uwnd U wind component - EW relative (m/s) value
vwnd V wind component - NS relative (m/s) value
alt Altimeter setting (in_Hg) (not in MOS) value
pres Sea level pressure (mb) use level parameter to get station/surface pressure value
pralt Sea level pressure or altimeter setting if sea level pressure is missing (mb) value
elev Station elevation (m) value
wx Present weather (METAR code) string
sawx Present weather (SAO code) string
vis Visibility (mi) value, formatted string
clds Cloud data (ceiling and coverage for each layer) value, string for coverage
cldcl Cloud ceiling (100 ft) value, formatted string
cldclc Cloud ceiling code (from synoptic code 0-9) value
cldcv Cloud cover (cloud string) value=%, string
ptend Pressure tendency (mb, trend is a string) (not in MOS) value, string=trend code
prec Precipitation (in) use time parameter to specify which type (3,6,12,24 hour) value
prec3, prec6, prec12, prec24 Precipitation (in) for 3,6,12, and 24 hours value
extt Extreme temperature (F) uses maximum if available, else minimum.
Use time parameter to specify which type (6,24 hour)
maxt Maxmium temperature (F) use time parameter to specify which type (6,24 hour) value
maxt6, maxt24 Maxmium temperature (F) for 6, 24 hours value
mint Minimum temperature (F) use time parameter to specify which type (6,24 hour) value
mint6, mint24 Minimum temperature (F) for 6,24 hours value
snwdp Snow depth (in) value
nlcld Amount of low clouds (code string) value=%, string=code
lcld Low cloud type (not in MOS) string
mcld Middle cloud type (not in MOS) string
hcld High cloud type (not in MOS) string
solar Equivalent solar radiation (min) (not in MOS) value
sst Sea surface temperature (C) (not in MOS) value
wavper Wave period (sec) (not in MOS) value
wavhgt Wave height (m) (not in MOS) value
vpres Vapor pressure (mb) (not in MOS) value
svpres Saturation vapor pressure (mb) (not in MOS) value
wchilt Wind chill temperature (K) - legacy value
wchilt2 Wind chill temperature (K) - new value
wchilf Wind chill factor (W/m^2) value
heat Heat index (K) value
humit Humiture (F) value
mrat Mixing ratio (g/kg) value
smrat Saturation mixing ration (g/kg) value
shum Specific humidity (g/kg) value
rhum Relative humidity (%) value
wetblb Wetbulb temperature (K) value
thetaw Wetbulb potential temperature (K) value
thetae Equivalent potential temperature (K) value
thetav Virtual potential temperature (K) value
theta Potential temperature (K) value
vtemp Virtual temperature (K) value
fr Flight rules (number and string: 0=VFR, 1=MVFR, 2=IFR, 3=LIFR) value=0, string=VFR
value=1, string=MVFR
value=2, string=IFR
value=3, string=LIFR

These parameters can be accessed by name if they have not been redefined in the meteoplot.var file. Otherwise, prepending a "+" to the variable name will guarantee these variables will appear.

The are two composite plots defined in the meteoplot.var file.

Composite Variables
Variable Description Plots
all All data, a composite plot of temperature, dewpoint, sea level pressure, cloud cover, winds and present weather. comp
allc Same as all except values in metric. comp

Multiple parameters can be plotted in the same window. To do this, specify variables separated by commas. The plots are stacked from top to bottom in the window. If a variable is a group "{var1,var2}", both variables will plot in the same graph. The vertical size of the plot in a standard window is about 0.65. Value output is allotted .02 and plot are .15. The "sz=" parameter can be used to size a plot.

Standard variable processing is done. So a variable can be formatted using parameters in brackets []. The first parameter in the brackets is the output unit. The following parameters are formatting parameters. Here are some possible parameters:

Formatting Parameters
Parameter Description
value Plot raw data values as text (default)
plot Plot data values on a graph
wx Plot weather symbol (needs "wx" variable)
cloud Plot cloud cover symbol (needs "cldcv" variable)
barb Plot wind barb (needs "wind" variable). Use "cbarb" if plotting with a cloud cover symbol.
cplot Plot a cloud graph with logarithmic altitude from 100 to 50,000 feet. Each cloud layer is plotted at its altitude with clear skies plotted as a "C", scattered clouds as a single dash, broken as two dashes, overcast as a single long dash and obscured as an "X". This needs the "clds" variable.
size=## Specified vertical size of graph. The vertical size of the default window is about 0.65.
%.2f Specified format of output text (value plot type). This is a C style format.
co=/b>color Specified color of plotted data. See resrc:color_table resource.

For the "all" data plot, here are the various plots:

These types of composite plots are specified in the "meteoplot.var" file. For example, the "all" variable is:

all    All_Data              1 temp {temp,dewp[,co=cyan]} [F  ,plot,sz=.20],\
	                       maxt             [F],\
                               mint             [F],\
                               wx               [   ,wx,co=yellow],\
                               snwdp            [in],\
                               prec             [in,%.2f],\
                               vis              [mi],\
                               wgst             [knt],\
                               wind { \
                                 wind           [knt,cbarb],\
                                 cldcv          [%  ,cloud]}[,sz=.05,co=white],\
                               clds             [,cplot,sz=.14],\
                               cldcl            [],\
                               pralt            [mb ,plot,sz=.14]

Once the variable is selected, the program will open and search through the set of hourly files to get all the data for the time series plot. A table of information for the station over the requested hours will print:

Plotting for: 05Z 19 NOV 2013
Surface data for: KMCI
KMCI   0453   7   0  60 290   6     006 178  10      CLR
KMCI   0553   7   1  65 310   6     008 184  10      CLR      19   7
KMCI   0653   6   1  70 310   5     008 185  10      CLR
KMCI   0753   4   0  73 300   6     009 188  10      CLR
KMCI   0853   3  -1  78 320   5     010 192  10      CLR
KMCI   0953   3  -1  78 340   5     009 189  10      CLR
KMCI   1053   2  -1  81 260   4     011 199  10      CLR
KMCI   1153   2  -1  84 260   8     017 219  10      CLR       7  -1
KMCI   1253   1  -1  85 250   8     021 234  10      CLR
KMCI   1353   2  -1  84 240   5     024 244  10      CLR
KMCI   1453   5   0  70 270   6     027 253  10      CLR
KMCI   1553   7   0  60 290   5     029 260  10      CLR
KMCI   1653   9  -1  48 270   3     029 259  10      CLR
KMCI   1753  11  -2  39 310   8     028 254  10      CLR      11   1
KMCI   1853  13  -3  33 280   7     026 248  10 250  FEW
KMCI   1953  13  -5  28 270   8  14 025 244  10 250  FEW
KMCI   2053  14  -6  25 270   5     023 238  10 250  FEW
KMCI   2153  13  -5  28 280   3     022 236  10 250  FEW
KMCI   2253  11  -4  33   0   0     023 240  10 250  FEW
KMCI   2353   9  -6  35   0   0     023 242  10 250  FEW      14   9
KMCI   0053   8  -5  40 170   6     024 244  10      CLR
KMCI   0153   4  -4  55 170   6     024 247  10      CLR
KMCI   0253   4  -4  53 140   6     025 247  10      CLR
KMCI   0353   3  -4  57 150   6     025 245  10      CLR
KMCI   0453   2  -4  64 160   7     025 245  10      CLR

The program will open the graphics window and plot the meteogram. Each plot will have a label to the left of the data. If the plot has a plot type of "plot", the label will be rotated counterclockwise. The times for each report will be on the horizontal axis and the overall time range will be at the top right.

MOS Data Meteogram

The MOS data meteogram will plot a time series of forecast data. To turn on the MOS feature, use the resrc:model resource. There are three possible MOS models that can be used:

The processing proceeds much like the surface meteogram. A file, identifier and a variable must be specified. The program then searches the MOS data for the requested stations data and parses it into data that resembles surface data. The processing then is identical to surface data. The table output is similar:

NAM MOS MOS data for: KMCI
KMCI   0600   6   3  86 120   6               7 100  OVC
KMCI   0900   6   4  89 130   5               7  50  OVC
KMCI   1200   5   4  93 110   5               7 100  OVC
KMCI   1500   8   4  79 360   5               5  25  OVC -RA
KMCI   1800   9   3  66 360  10               5   7  OVC -RA              1
KMCI   2100   8   2  65  10  11               3   3  OVC -RA
KMCI   0000   4  -1  70 360  14               3   3  OVC -RA    10        4
KMCI   0300   1  -3  72 360  15               5   7  OVC BR
KMCI   0600   0  -4  72 350  14               5   3  OVC BR
KMCI   0900  -1  -5  75 350  14               5   7  OVC -SN
KMCI   1200  -2  -6  75 360  11               5  15  OVC -SN        -3    1
KMCI   1500  -3  -7  75 360  12               3   7  OVC -SN
KMCI   1800  -1  -6  66 360  11               5   7  OVC -SN              1
KMCI   2100   1  -6  61  10  11               7  50  OVC
KMCI   0000  -1  -7  66 350   7               7 250  BKN         2
KMCI   0300  -2  -7  69 350   6               7      CLR
KMCI   0600  -4  -8  74  10   5               7      CLR
KMCI   0900  -5  -9  74 340   6               7 250  SCT
KMCI   1200  -6 -10  74 360   8               7 250  SCT            -7
KMCI   1800  -2 -10  53  10  11               7 100  OVC
KMCI   0000  -3 -12  52 360   9               7 250  OVC         0

The plot is then produced based on the variable specified.




Last updated November 2013