meteoplot
Sections
NAME
meteoplot - Surface and MOS meteogram plotting
SYNOPSIS
meteoplot [parameters...] filename
PARAMETERS
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 |
DESCRIPTION
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:
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 |
wbrbc wbrb wind |
Wind speed and direction (knt) | value0=dir, value1=spd |
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) |
value |
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.
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:
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:
- temp - temperature and dewpoint chart. This shows temperature as the top line and dewpoint as the bottom line in blue.
- maxt - maximum temperature. The maximum temperatures are plotted below the chart at specific reporting times. These are typically 6 hour values but can be 24 hour values depending on local time.
- mint - minimum temperature. The minimum temperatures are plotted below the chart at specific reporting times. These are typically 6 hour values but can be 24 hour values depending on local time.
- wx - present weather data. This shows the present weather plotted as a weather symbol.
- snwdp - snow depth. This shows reported snow depth in inches.
- prec - precipitation. This shows precipitation totals in inches. The values are 24 hour totals generally at 12Z, 6 hour totals at 0Z, 6Z and 18Z, 3 hour totals elsewhere.
- vis - visibility. This shows the horizontal visibility in miles.
- wgst - wind gusts. This reports wind gusts in knots if reported.
- wind - winds and cloud cover. This plots the standard wind barb and cloud cover symbol. Up is north.
- clds - Cloud chart showing each cloud layer on a logarithmic height scales. See the "cplot" type above for more information.
- cldcl - cloud ceiling. Cloud ceiling in 100s of feet.
- pralt - pressure chart. This chart plots sea level pressure (or altimeter setting if pressure not reported) in millibars.
- time: This is the report hour in universal time. The actual time range is displayed above the plot.
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 ID TIME T TD RH DIR SPD GST ALT SLP VIS CIL COV WX MAX MIN PR6 PR24 SC 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:
- nam - MOS data from the NAM model. This provides data every 3 hour out to 72.
- lamp - LAMP MOS data from the GFS model. This provides hourly data out to 24 hours.
- gfs - MOS data from the GFS model. This provides data every 3 hour out to 72 hours.
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 ID TIME T TD RH DIR SPD GST ALT SLP VIS CIL COV WX MAX MIN PR6 PR24 SC 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.
EXAMPLES
meteoplot -id=KMCI -va=all
This plots a composite 24 hour meteogram for KMCI.meteoplot -id=KMCI -nh=-361,3 -va=all
This creates a 15 day meteogram with data every 3 hours.meteoplot -mo=nam -id=KMCI -va=all
This plots a 72 hour NAM MOS forecast meteogram for KMCI.meteoplot -id=KMCI -va=Temp{temp,dewp}[,plot],temp,rhum[,plot],wspd[,plot]
This plots temperature, dewpoint on the same chart, text temperature below that, a plot of relative humidity and a plot of wind speed.
FILES
- meteoplot.var - variable menu and definitions
SEE ALSO
Last updated November 2013