figure
Sections
NAME
figure - Data overlay program with interactivity
SYNOPSIS
figure [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 | the program name | 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 |
| -sp=path | sat_path | the current directory | Specifies location of satellite images. |
| -mp=path | model_path | the current directory | Specifies location of raw model GRIB data |
| -rp=path | raw_path | the current directory | Specifies location of output raw files generated by WXP. |
| -ip=path | image_path | the current directory | Specifies location of output image files (.gif/,png) from WXP. |
| -nc=name_conv | name_conv | name.cnv or name_conv file | This sets which name convention file to use. |
| -in=input | input | program specific | Specifies the type of the input data. |
| -ou=output | output | program specific | Specifies the output of the program. |
| -if=in_file | in_file | program specific | Specifies the input file name tag. |
| -of=out_file | out_file | program specific | Specifies the output file name tag. |
| -cf=filename | city_file | program specific | Specifies the name of the city database file |
| -mf=filename... | map_file | wxp.map | Specifies the name of the map database file. Multiple maps can be specified along with attributes to describe how to draw the map. |
| -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 |
| -pd=domain | plot_domain | program dependent, mostly "us" | Sets the plotting domain |
| -pr=prior | stat_prior | Plot size dependent | Specifies the station priority to use in filtering stations on the plot |
| -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. |
| -ci=value | con_interval | 0 | Specifies the contour interval to use in contouring grids. This can also be used to color code plotted data and vectors. |
| -cb=value | con_base | lowest contour value, max wind speed or 0 depending on application | Specifies the base value for color fill contours, and wind speed per grid distance. |
| -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. |
| -col=color[:attribute...] | color_label | white (black on inverse plots) | Specifies the text color for labels above and below the plot. |
| -cod=color[:attribute...] | color_data | green (for most programs) | Specifies the color for plotted data. |
| -com=color[:attribute...] | color_map | red (for most programs) | Specifies the color for background maps. |
| -cofm=color[:attribute...] | color_fmap | black | Specfies the map color for color fill plots. |
| -coll=color[:attribute...] | color_latlon | magenta:st=dsh | Specifies the color for lat/lon lines. |
| -coco=color[:attribute...] | color_cont | white (black on inverse plots) | Specifies color for line contours |
| -cof=[value:]color[:attribute...],[value:]color[:attribute...],... -cof=filename |
color_fill | magenta, lmagenta, blue, lblue, cyan, lcyan, green, lgreen, brown, yellow, red, lred, dgray, lgray, white | Specifies the colors in the color fill contours. |
| -cocl=color[:attribute...] | color_clabel | white (black on inverse plots) | Specifies color for line contour labels. |
| -cofl=color[:attribute...] | color_flabel | black | Specifies color for color fill contour labels |
| -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. |
| plots | none | Specifies a list of plots to render. |
DESCRIPTION
This program combines the functionality of all of the plot programs. Each plot is specified by a shorthand which represents the API class being called. The name of the plot is then followed by all parameters for that plot:
plot:param plot:param ...
The list of plots includes:
- front - Plot fronts
- grid - Plot grids
- image - Plot images
- map - Plot a map
- meta - Plot a metafile
- misc - Plot miscellaneous data
- rad - Plot radar data
- raw - Plot raw data
- rcm - Plot RCM data
- sat - Plot satellite images
- sfc - Plot surface data
- sound - Plot upper air soundings
- therm - Plot thermodynmic diagram
- upa - Plot upper air data
- watch - Plot watch boxes
- warn - Plot warning polygons
- xsect - Plot upper air cross sections
- panel - Specifies panel parameters
The parameters to the plot objects are roughly the same as the resources that would be passed via the command line. For example, use "if=" for in_file and "cod=" for color_data.
With just one plot specified, the program behaves just like its similar program. For example:
figure map sfc -va=all -pd=ne
is the same as:
sfcplot -va=all -pd=ne
except for the background map. The program turns off the automatic map plotting that is in the regular program. Since the program is aimed at overlay plots, this gives more flexibility as to when the map is drawn. So, the "map" plot has to be specified.
Overlay plots
Since each of these are self contained plotting objects, multiple plots can be specified. Once overlays are involved, standard parameter on the command line no longer are appropriate since they'll be applied to all plots. Use the parameters with each plot:
figure rad:ct=radar.clr,bar map front sfc:va=all
This will create an overlay plot of RCM radar data (default for rad object), with a map, fronts and a surface plot of all data. In this case, two parameters are specified. First the color table is specified for the rad object. This makes sure the radar color table is installed for the plot. The second is the variable specified for "sfc". The map is drawn second so it overlays the radar plot.
The figure program acts just like any plot program so plots can be zoomed and panned from the interactive interface. The plots can also be looped by using resrc:num_hour and resrc:time resources. The increment between frames is based on the first plot listed. If its RCM data, the frames will be 30 minutes apart. The valid time for each frame will be based on the valid time of the ploti, for example: 2115Z, 2145Z and 2215Z. All other plots will be synchronized to that time.
EXAMPLES
FILES
SEE ALSO
Last updated December 2013