imageplot
Sections
NAME
imageplot - Raw image plotting (GIF, PNG, WXP images)
SYNOPSIS
imageplot [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 |
-ip=path | image_path | the current directory | Specifies location of output image files (.gif/,png) from WXP. |
-sp=path | sat_path | the current directory | Specifies location of satellite images. |
-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. |
-if=in_file | in_file | program specific | Specifies the input file name tag. |
-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 |
-ca=calibration | calibration | none | Specifies the mapping from image index to value |
-mm=model,field,offset | model_mask | None or "ruc,init:2m_ag:temp:C,-10 if specified with no parameters | Sets model data to mask a satellite image |
-pd=domain | plot_domain | program dependent, mostly "us" | Sets the plotting domain |
-sc=type | plot_scale | 1.0 | Specifies a scaling factor for all plotted text, symbols, vectors, etc. |
-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. |
-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. |
-com=color[:attribute...] | color_map | red (for most programs) | Specifies the color for background maps. |
-coll=color[:attribute...] | color_latlon | magenta:st=dsh | Specifies the color for lat/lon lines. |
-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 displays imagery. It's prime purpose to display naviagted imagery such as those created by WXP. Possible inputs are:
- img - Uncompressed WXP images
- imgz - Compressed WXP images
- gif - GIF images
- png - PNG images
- tiff - TIFF images
The program expects either a filename or a name convention specified with the resrc:in_file resource. The filename will have the value of the resrc:image_path resource prepended to the filename if it's a relative path.
The image is then displayed using the resrc:plot_domain resource. If the image contains navigation, the program will remap the image to the proper domain.
If the image is a raw pixel image (WXP image only), it can be colored using the resrc:color_fill resource. This will map colors to a scale of 0 to 255. Also, a calibration can be added to the image with the resrc:calibration resource. This will map the values 0 to 255 to a value, usually IR temperature. Then the color fill will use those temperature values.
If the image is a IR satellite image, the resrc:model_mask resource can be used to make transparent parts of the image that are perceived to be at the ground. The model mask specifies a grid and an offset value. The grid is typically the 2m above ground temperature. The offset is typically 10C. This allows the image to be overlaid on to other data or some background image like a LandSat image.
EXAMPLES
imageplot globe_light.gif -pd=us
Remaps the global background image to display over the US.
FILES
SEE ALSO
Last updated October 2013