SNDLIST -- Lists radiosonde and other sounding data at selected point(s)
   SNDLIST dataset <keywords>
Parameters:
   dataset | ADDE dataset name and absolute position; specify as
             group/descriptor.position or alias.position; only
             positive integers or ALL (all positions) are valid
             for position (def=ALL for position), however there
             is no default for group/descriptor or alias, which
             must be specified.  Dataset schemas currently handled
             are RAOB, IRAB, GRET, RAWI, IHGT, RSIG, and IRSG.
Keywords:
   FORM=   (selects a type of screen output, given a dataset)
         ANL             | Lists sounding levels, plus potential temp,
                            mixing ratio, and stability indices in
                            units specified by UNIT= keyword
                                (parcel analysis done for OPT=0,7 only)
         ANLONLY         | Lists parcel analysis without sounding levels
                                (parcel analysis done for OPT=0,7 only)
         AVA             | Lists available soundings in a specific
                            dataset position (use the ST= and CO=
                            keywords to select on a given two letter
                            state or country symbol and limit the
                            amount of output returned)
         FILE            | Lists files available in the dataset with
                            day and time of included sounding records
         RAW             | Lists raw mandatory data from the dataset
                            in a format like that of PTLIST
                                (dataset position must be specified)
         SOUND           | Lists returned sounding levels only (default)
                                (data is returned in OPT= processed form)
         PARAM           | Lists valid dataset parameter names for
                                the indicated position number
                                (handy when setting up SELECT= values)
   NUM=  number   | Sets a limit on the number of soundings listed
                                              to the screen (default=1)
         ALL      | Returns all soundings satisfying SELECT= conditions
                    NOTE: Until all records are collected and ordered,
                          the number of returned soundings cannot be
                          determined, so this number represents the
                          limit on soundings output, not the actual
                          number found satisfying the SELECT= conditions.
   SELECT= 'param val1 val2; param val1,val2,val3'
            Values separated by a space denote a range of values (low to
            high). Values separated by commas denote a list of specific
            values.  Returned units are always defaulted, as they must
            be converted to uniform dimensions internally for processing
            into a self-consistent sounding.  Use the FORM=PARAM option
            to identify the names of parameters you can select on, and
            the UNIT= keyword to change dimensions of the parameters in
            the text display.  Individual selection conditions inside the
            quotes must be separated by a semi-colon.
            Entire select clause must be enclosed in single quotes so
            the command line parser treats it as a single token and will
            not break it into pieces before it is sent to the server.
            Semi-colons outside the quotes indicate the end of a command.
            Note that station, day, and time are now specified in the
            SELECT= parameters and are no longer positional parameters.
            Defaults for day and time are whatever station, day, or time
            are first encountered in the specified dataset that match
            the SELECT= conditions.  Use the MSL command to find the
            IDN number for stations known by a 3 or 4 letter symbol or by
            a name or name fragment.
            Example:
              SELECT= 'IDN 72645 72660; TIME 0; DAY 97220'
              SELECT= 'IDN 72645, 72649, 72660; DAY 97220'
              SELECT= 'TIME 12; DAY 96037; IDN 72645'
              SELECT= 'TIME 0; LAT=40 50; LON=80 100'
            Every atmospheric level satisfying the SELECT= parameters
            will be returned by the server.  The client then groups the
            levels by STATION, DAY, and TIME and assembles them into
            a list of raw sounding data.  Each sounding in that list
            is edited, smoothed, and interpolated, using OPT=, before
            being returned.
            NOTE: Selecting on other parameters, e.g. state or latitude,
                  may acquire mandatory records, but may not pick up
                  significant records which are identified by station,
                  day, and time only.  Two passes with different SELECT=
                  parameter values would be required in such cases:
                  a search on state or latitude to pick up the idn
                  numbers, followed by a search on idn number to get
                  the final mandatory plus significant data to list.
   DEPTH = pressure_interval  | depth of boundary layer (0-400 mb)
                                used in the parcel analysis (def=100 mb)
                                (The parcel analysis always uses the
                                 lowest DEPTH interval available in the
                                 returned sounding, which may not be at
                                 the surface if lowest levels are missing)
   ANAlysis = YES  | do parcel analysis if consistent with FORM= (def)
              NO   | skip the parcel analysis
   NOMESG = 0   | Provides information about server operation, returned
                  soundings, and station ID (def)
            1   | Minimal text output for use in macros  --  no information
                  is returned from server and client regarding the amount
                  and order of data found and delivered to the application
   OPT=    (Processing options available for soundings from server)
        0     | Return mandatory levels only - no interpolation
                and no MAXW or TRO levels included
        1     | Return significant temperature and mandatory levels
        3     | Mandatory, significant temperature and significant wind
                levels; recomputes geopotential heights; computes wind
                pressure
        5     | Significant temperature and mandatory levels; interpolates
                wind at significant temperature levels
        7     | Mandatory, significant temperature and significant wind
                levels; recomputes geopotential heights; fully interpolates
                for missing data (default)
   PARameters = temp    dewpoint  pressure  height  station_id_number
                day     time      lat       lon     level
                speed   direction
                  (tells sounding server to override its default
                   parameter names from the mandatory dataset's schema
                   in favor of these twelve or less user defined
                   parameter names, which must have the same dimensions
                   and scale factors as the names they replace, e.g.
                   substituting GT and GTD for T and TD in the
                   GRET schema: "PAR=GT GTD")
                Use of the keyword FORM=PARAM will tell you what
                parameter names are available in the dataset.
                Unset positions for this keyword are ignored, and the
                server's default parameter names will be used instead.
   SIG=  NO       | Do not search for any related significant datasets
         YES      | Search for any related significant datasets to add
                      to the mandatory sounding data returned (def)
         sdataset | Use indicated significant dataset name if the
                      dataset in the first positional parameter is
                      type POINT instead of type VPROF.  This is handy
                      for access to local datasets at the user's
                      workstation without the need to run DSSERVE or
                      manage remote server nodes.
   UNIT= temperature  speed  height  pressure   | sets display units for
                                                   the FORM=ANL and the
                                                   FORM=ANLONLY options
       temperature   |  K    (degrees Kelvin)  (def)
       speed         |  MPS  (meters per second) (def)
       height        |  M    (meters above sea level)  (def)
       pressure      |  MB   (millibars)   (def)
           (Run the CU LIST command to see all of the valid
            unit options -- there are quite many available)
Examples:
   SNDLIST  GROUP/DESCR  FORM=FILE
                (describes files available in dataset at each position)
   SNDLIST  GROUP/DESCR.3  FORM=AVA  ST=MN
                (lists soundings available in the dataset
                  at position 3 for the state of Minnesota)
   SNDLIST  GROUP/DESCR  SELECT='IDN 72269;DAY 97233'
                (displays first sounding at station 72269 on Aug. 21, 1997)
   SNDLIST  GROUP/DESCR  SELECT='TIME 12'
                (displays first sounding from dataset at 12Z )
   SNDLIST  GROUP/DESCR  SELECT='TIME 12'  NUM=50
                (displays up to 50 soundings from dataset at 12Z )
   SNDLIST  GROUP/DESCR.3  SELECT='IDN 72269' FORM=RAW NUM=8
                (displays up to 8 mandatory records in PTLIST format
                  for station 72269 at dataset file position 3)
   SNDLIST  GROUP/DESCR  SELECT='IDN 72269;DAY 97233' FORM=ANL OPT=0
                (displays soundings and parcel analysis at station
                  72269 on Aug. 21, 1997 for mandatory levels only,
                  but only for the first time encountered on Aug 21
                  since NUM= defaults to 1)
   SNDLIST  GROUP/DESCR  SELECT='IDN 72269;DAY 97233' FORM=ANL
                (displays sounding and parcel analysis at
                  station 72269 on Aug. 21, 1997 for all levels
                  in the first sounding encountered)
   SNDLIST  GROUP/DESCR  SELECT='IDN 72269;DAY 97233' FORM=ANLONLY
                (displays parcel analysis only at
                  station 72269 on Aug. 21, 1997 for all levels
                  in the first sounding encountered)
Remarks:
   Since each dataset file may contain thousands of records, you
   may get too many records if you don't narrow the search criteria
   enough with the SELECT keyword.  The server client will present a
   running count of records returned.  The "?" and "KILL" commands can
   be used to stop a search which is "running away" with NUM=ALL.
   If NUM= is set relatively low, or defaults to 1, the program will
   stop after that number has been output.

   The program first searches for a mandatory dataset which matches
   the SELECT= criteria.  If data is found, and the SIG=NO option
   isn't chosen, and the dataset is the VPROF datatype, the INFO
   field in the server mapping table (managed by command DSSERVE) then
   is searched for the significant dataset name corresponding to the
   mandatory dataset.  The significant dataset is then searched for
   data matching the time, day, and location of all data returned from
   the mandatory dataset.  This may be done in small chunks for large
   numbers of soundings so as not to overrun real memory in the client
   and slow down the system with memory thrashing during sorting and
   editing of sounding levels.

   If the input dataset is a POINT datatype, or SIG=NO, it is assumed
   that no associated significant data exists, and only the input
   dataset on the command line will be searched.  Only VPROF datasets
   remap to other dataset names, using the information in the INFO
   field of the server's mapping table.

   See the DATALOC, DSINFO, and DSSERVE commands for more information
   to direct McIDAS ADDE commands to the desired servers and data files
   using dataset names.
   Note that the parcel analysis requires complete data at every level,
   so only OPT=0 or OPT=7 will guarantee a correct parcel analysis, i.e.
   data at every level within the sounding must be present or interpolated.
   Be aware that calculation of geopotential heights with any value except
   OPT=0 or 1 may change the the z-coordinate by as much as 1-2% in the
   worst cases.  To be consistent with z values in the source dataset or
   those returned by PTLIST, you should always use OPT=0 or 1 which
   accepts the data returned from the server without modifying it.

----------
