WXP version 5
Program Reference

WXPFILE

Sections

NAME

wxpfile - WXP file query program

SYNOPSIS

wxpfile [parameters] [value]

PARAMETERS

Command Line Resource Default Description
-h help No Lists basic help information.
-df=filename default .wxpdef Sets the name of the resource file.
-na=name name wxpfile Specifies the name used in resource file parsing.
-ba batch No Run program in batch mode
-me=level message out2 Specifies level of messages to be displayed
  • output values - print (default if resource specified on command line)
  • additional information - out2
-cu=[hour|la] current None This specifies to use current data files. The current filename is based on the name convention. An optional hour can be specified for older data. If la is specified, the program will search back to find the most recent available file.
-ho=hour hour None This resource specifies the exact hour that a data file is valid for. This locks in the start hour for a multi-file sequence.
-nh=num_hour num_hour 0 (no loop) This specifies the number of hours that will be used in the plot. If this is not specified, a single hourly plot will appear. If this is specified, a loop of plots over this time will be generated.
-mo=model model None Specifies the model to use as input data. These are defined in the model.lup file. This file can define how model grids are pieced together. Some samples are:
  • ngm -- Nested Grid Model
  • eta -- ETA model
  • avn -- Aviation model
  • mrf -- Medium Range Forecast model
-ft=time time None This specifies the forecast time to use.
-le=level level None This specifies the vertical level to use. See the level resource for more information on what can be specified.
-va=variable variable None This specifies the variable to use.
-ou=output output none Specifies type of output.
  • file - filename (default)
  • hdrfile -- ingest header filename
  • date -- date based on filename (hhZ dd mmm yyyy)
  • valid -- valid time label based on filename and forecast hour (hhZ dd mmm yyyy)
  • label -- label based on model, forecast time and filename
  • year -- the year based on filename (yyyy)
  • mon -- the month based on filename (mm)
  • month -- the month based on filename (mmm as in DEC)
  • day -- the day based on filename (dd)
  • hour -- the hour based on filename (hh)
  • seq -- the sequence number (yyyymmddhhMM) based on filename.
  • del -- removes the file
  • rm -- removes the file
  • exist -- tests for file existence
  • size -- size of file
  • next -- the next file in the sequence
  • prev -- the previous file in the sequence
  • label -- a date/time label appropriate for use with plots.  If the model and forecast time are specified, it will incorporate this into the label.
  • time -- the Unix time of the file (seconds since 1/1/1970)
  • diff -- the number of hours between file time and current.
  • sdiff -- the number of seconds between file time and current.
  • mdiff -- the number of minutes between file time and current.
  • hdiff -- the number of hours between file time and current.
  • ddiff -- the number of days between file time and current.
filename ... filename None
User Pompt
Batch: current=la
The name of the input data file to be used.

DESCRIPTION

This program displays and lists WXP file names.

EXAMPLES

This prints file name plus path of the current converted surface file.

   wxpfile -cu -if=sfc_cvt
   /home/wxp/convert/17100197.cvt

This prints a date string for the current converted surface file.

   wxpfile -cu -if=sfc_cvt -ou=date
   17Z  1 OCT 1997

This determines whether the current converted surface file exists.

   wxpfile -cu -if=sfc_cvt -ou=exist
   exist

This prints the converted surface file name which corresponds to the sequence number 1991120617.

   wxpfile -if=sfc_cvt #1997100117
   /home/wxp/convert/17100197.cvt

This prints the number of hours between this file and current time.

   wxpfile -if=sfc_cvt 12100197.cvt -ou=diff
   5

This prints the current raw upper air file.

   wxpfile -cu -if=upa_dat
   /home/wxp/data/12100197.upa

This prints the next raw upper air file.

   wxpfile -cu -if=upa_dat -ou=next
   /home/wxp/data/00100297.upa

With the use of the num_hour resource, several files can be checked.

   wxpfile -cu -nh=-5 -if=rad_cvt -ou=exist -me=out2
   /home/wxp/convert/13100197.sdc: exist
   /home/wxp/convert/14100197.sdc: not found
   /home/wxp/convert/15100197.sdc: exist
   /home/wxp/convert/16100197.sdc: exist
   /home/wxp/convert/17100197.sdc: exist

This prints the current NGM GRIB file.

   wxpfile -cu -if=grib_ngm -na=grbcalc
   /home/wxp/hds/12100197.gbn

This prints a date/time label for the current surface converted file.

   wxpfile -cu -if=sfc_cvt -ou=label
   Analysis for 17Z  1 OCT 97

This prints a date/time label for the MRF 7 day grid file.

   wxpfile -cu -if=grib_eta -mo=eta -ft=h24 -ou=label
   24 hour ETA valid 12Z FRI  3 OCT 97 

FILES

SEE ALSO


Last updated July 28, 1998