sfcgrid
Sections
NAME
sfcgrid - Surface data to grid file
SYNOPSIS
sfcgrid [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 |
| -gp=path | grid_path | the current directory | Specifies location of gridded output files from WXP. |
| -nc=name_conv | name_conv | name.cnv or name_conv file | This sets which name convention file to use. |
| -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 |
| -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. |
| -pd=domain | plot_domain | program dependent, mostly "us" | Sets the plotting domain |
| -gd=domain | grid_domain | Same as the plot domain | Specifies the output grid domain |
| -pr=prior | stat_prior | Plot size dependent | Specifies the station priority to use in filtering stations on the plot |
| -oa=filter[,radinf][,passes][,converg][,min_stats] | object_param | program dependent |
Specifies the objective analysis parameters |
| -fm=format | format | None | Specifies the output format of data. |
| -pa=param[,param...] | parameter | none | Specifies addition parameters to program. |
| filename (positional) | filename | none | Specify input filename |
DESCRIPTION
This program converts surface data to a grid.
input to the program is a raw file which can be produced by programs like sfcwx or upairwx programs. Then, based on a plot domain, a plot is generated.The programs starts off by prompting the user for input raw file name. The user may specify the input file either via the command line of through the current resource. The input naming convention is specified by the raw tag but this can be changed with the in_file resource.
In order to get specific information from a raw file, a field specifier can be appended to the filename.
filename[-field]
The field specification can be a column number or a field identifier. The field identifier is a string that accompanies a column header in the raw file or a string that precedes the data such as HGIRG=5.24
Next, the program prompts the user for the plot domain. This is done through a region menu which has predefined regions available. If needed a full plot domain can be specified to get a precise domain. The domain can be interactively changed using the mouse once the plot has been generated.
After the region has been set, the city database is read in and a cross-reference table is setup. Since some raw data is not saved with location information, the program will refer to this table to location each station in the input file.
The program will now open the graphics window and start processing the data. The user will be prompted for the output device. Then the converted file is opened and data read in. Any additional computations are performed to produce a derived variable and fit the data to a grid. The background map will plot first unless the output is a color fill contour in which the map plots last. The gridding process uses an objective analysis scheme to produce the grids. The parameters for this process are specified in the object_param resource. Once the grids have been created, the maximum and minimum of the grid are displayed for the user to pick an appropriate contour interval. Then, the contour or vector plot will display.
EXAMPLES
grid -re=mw -pl=cf -in=2 -de=d temp.raw This produces a color fill contour plot of temperature for the midwest region at an interval of 2.
grid -cu=la -re=mw -of=temp.grd -pl=none temp.raw
This will generate grid file temp.grd.
FILES
- sao.cty - the surface station location database file
SEE ALSO
Last updated November 2013