bufr.pm:bufrdump.pl_help

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
Next revision Both sides next revision
bufr.pm:bufrdump.pl_help [2011-09-16 08:24:49]
pals 		bufr.pm:bufrdump.pl_help [2012-02-15 13:33:36]
pals
Line 12: Line 12:
           [--lon2 x2]           [--lon2 x2]
           [--lat2 x2]           [--lat2 x2]
-          [--obstype <amdar|ocea|surface|sounding>]+          [--obstype <amdar|ocea|surface|sounding|sounding->]
           [--tablepath <path to BUFR tables>]           [--tablepath <path to BUFR tables>]
           [--help]           [--help]
Line 25: Line 25:
                       the CSV (comma separated values) format                       the CSV (comma separated values) format
       --sort          Sort the decoded observations on station identification;       --sort          Sort the decoded observations on station identification;
-                      first stations with wmonr, then stations with call sign, +                      first stations with wmonr, then stations with nationalnr, 
-                      buoy_id or aircraft (others left out)+                      call sign, buoy_id or aircraft (others left out)
       --sort_on <parameter>[-] Sort the decoded observations on increasing       --sort_on <parameter>[-] Sort the decoded observations on increasing
                       values of <parameter>, or decreasing values if a '-'                       values of <parameter>, or decreasing values if a '-'
Line 46: Line 46:
       --lat2 y2       Decode observations with latitude <= y2 only       --lat2 y2       Decode observations with latitude <= y2 only
                       x1,y1,x2,y2 should be decimal degrees                       x1,y1,x2,y2 should be decimal degrees
-      --obstype <amdar|ocea|surface|sounding>]+      --obstype <amdar|ocea|surface|sounding|sounding->]
                       Force observation type. If this option is not set,                       Force observation type. If this option is not set,
-                      will make an educated guess of observation type based +                      will make an educated guess of observation type 
-                      on metadata in section 1 of each BUFR message+                      based on metadata in section 1 of each BUFR 
 +                      message.
       --tablepath <path to BUFR tables>       --tablepath <path to BUFR tables>
                       Set path to BUFR tables (overrides ENV{BUFR_TABLES})                       Set path to BUFR tables (overrides ENV{BUFR_TABLES})
Line 102: Line 103:
     filter file followed by a blank line, then comes the parameter criteria     filter file followed by a blank line, then comes the parameter criteria
     which should match <param> or <param> <operator> <value> where operator     which should match <param> or <param> <operator> <value> where operator
-    is one of =, !=, <, <=, > and >=. An example filter file is+    is one of =, !=, <, <=, > and >=. The parameter criteria may be phrased 
 +    as alternatives by separating them with '|' on a single line. An example 
 +    filter file is
  
       D: 001001 I2.2       D: 001001 I2.2
Line 125: Line 128:
     ignored.     ignored.
  
-    Another example: the simple filter file (starting with a blank line!)+    Another example: the filter file (starting with a blank line!)
  
       wmonr       wmonr
 +      obstime >= '2012-02-10 06:00:00'
 +      RR_1 | RR_12 | RR_24
 +      TA < -30 | TA > 30
  
-    will print only those observations containing a wmonr (skipping ships).+    will print only those observations containing a wmonr (skipping ships, 
 +    and having obstime larger or equal to the datetime given, and containing 
 +    precipitation for 1, 12 or 24 hours, and having temperature below minus 
 +    30 or above plus 30 degrees Celsius.
  
     To avoid the need of creating a filter file when observations for some     To avoid the need of creating a filter file when observations for some
     few stations are requested, you can provide the stations in a comma     few stations are requested, you can provide the stations in a comma
-    separated list after option --station. Four examples:+    separated list after option --station. Some examples:
  
       --station wmonr=01001,01152,01492       --station wmonr=01001,01152,01492
 +      --station nationalnr=614_0050410003,637_108
       --station call_sign=LF5U       --station call_sign=LF5U
       --station buoyid=64607,64609       --station buoyid=64607,64609
Line 141: Line 151:
  
     You cannot mix different kinds of stations this way (before '=' you must     You cannot mix different kinds of stations this way (before '=' you must
-    choose either wmonr, call_sign, buoy_id or aircraft). Note also that +    choose either wmonr, nationalnr, call_sign, buoy_id or aircraft). Note 
-    providing the stations in the BUFR descriptor part (first part) of the +    also that providing the stations in the BUFR descriptor part (first 
-    filter file will speed up execution time considerably, compared to using +    part) of the filter file will speed up execution time considerably, 
-    option --station. It is possible to combine --filter with --station if +    compared to using option --station. It is possible to combine --filter 
-    done with some care, e.g, specifying WMO block 01 and the required +    with --station if done with some care, e.g. specifying WMO block 01 and 
-    parameters in filter file, then the requested stations in station list.+    the required parameters in filter file, then the requested stations in 
 +    station list.
  
     The --transform option is provided mainly to be able to use other units     The --transform option is provided mainly to be able to use other units
Line 169: Line 180:
     to be applied for sky not all covered by clouds, you should use NN !=     to be applied for sky not all covered by clouds, you should use NN !=
     100 instead of NN != 8 in filter file.     100 instead of NN != 8 in filter file.
 +
 +    The --obstype option might be handy in some special cases, like when you
 +    are interested only in the surface part of oceanographic data (then use
 +    '--obstype surface'), or when you want to see only levels with vss>0 in
 +    high resolution radiosonde data (then use '--obstype sounding-'), or
 +    when data category and/or data sub-category in the BUFR messages have
 +    unusual values.
  
 </code> </code>
  • bufr.pm/bufrdump.pl_help.txt
  • Last modified: 2022-05-31 09:29:31
  • (external edit)