Enter a ZIP code to get a forecast:
Setup Location

WRN Logo




wxpfile - WXP file query program


wxpfile [parameters] [value]


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.


This program displays and lists WXP file names.


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

   wxpfile -cu -if=sfc_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

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

   wxpfile -if=sfc_cvt #1997100117

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

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

This prints the current raw upper air file.

   wxpfile -cu -if=upa_dat

This prints the next raw upper air file.

   wxpfile -cu -if=upa_dat -ou=next

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

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 



For further information about WXP, email technical-support@weather.unisys.com
Last updated by Dan Vietor on July 28, 1998