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
bufr.pm:bufrdump.pl_help [2012-02-15 13:33:36]
pals 		bufr.pm:bufrdump.pl_help [2022-05-31 09:29:31] (current)
Line 2: Line 2:
 Usage: Usage:
       bufrdump.pl <bufr file(s)>       bufrdump.pl <bufr file(s)>
-          [--filter <filter file>] +          [--filter <filter file | filter list>] 
-          [--param <parameter file | parameter list> [--csv]]+          [--param <parameter file | parameter list> [--csv [--delimiter <del>]]
           [--sort]           [--sort]
           [--sort_on <parameter>[-]]           [--sort_on <parameter>[-]]
           [--station <station list>]           [--station <station list>]
           [--transform <transformation file>]           [--transform <transformation file>]
-          [--lon1 x1] +          [--lon1 <x1>] 
-          [--lat1 y1] +          [--lat1 <y1>] 
-          [--lon2 x2] +          [--lon2 <x2>] 
-          [--lat2 x2]+          [--lat2 <y2>]
           [--obstype <amdar|ocea|surface|sounding|sounding->]           [--obstype <amdar|ocea|surface|sounding|sounding->]
           [--tablepath <path to BUFR tables>]           [--tablepath <path to BUFR tables>]
Line 17: Line 17:
  
 Options: Options:
-      --filter <filter file> +      --filter <filter file | filter list> 
-                      Decode observations meeting criteria in <filter file> only +                      Decode observations meeting criteria in filter file or 
-      --param <parameter file | parameter list> [--csv] +                      filter list only 
-                      Print parameters in parameter file or comma separated +      --param <parameter file | parameter list> [--csv [--delimiter <del>]] 
-                      list (e.g. wmonr,TA) only, in same order as they occur +                      Print parameters in parameter file or comma 
-                      there. If --csv, the parameters vill be printed using +                      separated list (e.g. wmonr,TA) only, in same order 
-                      the CSV (comma separated values) format+                      as they occur there. If using --csv possibly 
 +                      followed by --delimiter <del>, the parameters vill 
 +                      be printed using the CSV (comma-separated values) 
 +                      format, with the delimiter del (default is ';')
       --sort          Sort the decoded observations on station identification;       --sort          Sort the decoded observations on station identification;
                       first stations with wmonr, then stations with nationalnr,                       first stations with wmonr, then stations with nationalnr,
                       call sign, 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 '-'
                       follows the parameter name. E.g. --sort_on TA- will                       follows the parameter name. E.g. --sort_on TA- will
                       sort on decreasing temperatures. Observations not                       sort on decreasing temperatures. Observations not
Line 34: Line 37:
                       except when --sort_on is combined with --sort (in which                       except when --sort_on is combined with --sort (in which
                       case sorting is done firstly on station identification,                       case sorting is done firstly on station identification,
-                      secondly on <parameter> with missing values printed first)+                      secondly on parameter with missing values printed first)
       --station <station list>       --station <station list>
                       Print observations for stations in station list only,                       Print observations for stations in station list only,
Line 40: Line 43:
       --transform <transformation file>       --transform <transformation file>
                       Do the transformations of parameter values listed in                       Do the transformations of parameter values listed in
-                      <transformation file> +                      transformation file 
-      --lon1 x1       Decode observations with longitude >= x1 only +      --lon1 <x1>     Decode observations with longitude >= x1 only 
-      --lat1 y1       Decode observations with latitude >= y1 only +      --lat1 <y1>     Decode observations with latitude >= y1 only 
-      --lon2 x2       Decode observations with longitude <= x2 only +      --lon2 <x2>     Decode observations with longitude <= x2 only 
-      --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|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                       will make an educated guess of observation type
-                      based on metadata in section 1 of each BUFR +                      based on metadata in section 1 of each BUFR message
-                      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 59: Line 61:
  
     To avoid having to use the "--tablepath" option, you are adviced to set     To avoid having to use the "--tablepath" option, you are adviced to set
-    the invironment variable BUFR_TABLES to the directory where your BUFR+    the environment variable BUFR_TABLES to the directory where your BUFR
     tables are located (unless the default path provided by bufrdump.pl     tables are located (unless the default path provided by bufrdump.pl
     works for you).     works for you).
Line 68: Line 70:
     temperature to be printed for a BUFR SYNOP file, either supply     temperature to be printed for a BUFR SYNOP file, either supply
  
-      wmonr,call_sign,TA+      wmonr,nationalnr,call_sign,TA
  
     as argument to --params, or supply a <parameter file> which should look     as argument to --params, or supply a <parameter file> which should look
Line 74: Line 76:
  
       wmonr       wmonr
 +      nationalnr
       call_sign       call_sign
       TA       TA
Line 94: Line 97:
     for example start like     for example start like
  
-      wmonr,call_sign,TA +      wmonr;nationalnr;call_sign;TA 
-      01001,,-1.5 +      01001;;;-1.5 
-      ,LF5U,9.0+      ;;LF5U;9.0 
 + 
 +    You can choose another delimiter than semicolon by use of option 
 +    --delimiter <del>, e.g. --csv --delimiter ','
  
     Using --filter will decode only those observations that meet at least     Using --filter will decode only those observations that meet at least
Line 102: Line 108:
     <filter file>, where the BUFR descriptor criteria should come first in     <filter file>, where the BUFR descriptor criteria should come first in
     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> or <param> <operator> <value> 
-    is one of =, !=, <, <=, > and >=. The parameter criteria may be phrased +    where operator is one of =, !=, =~, !~, <, <=, > and >=. What follows =~ 
-    as alternatives by separating them with '|' on a single line. An example +    and !~ should be a Perl match regular expression. The parameter criteria 
-    filter file is+    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 122: Line 129:
  
     which decodes all observations with block number 01, two other specific     which decodes all observations with block number 01, two other specific
-    wmo stations and one specific ship, being manned stations and having +    wmo stations and one specific ship, where stations should be manned and 
-    cloud cover different from 8 (but NN must be part of the message) and +    have cloud cover with a value different from 8, and have temperature 
-    temperature between 5 and 9.5 degrees Celsius and containing +    between 5 and 9.5 degrees Celsius, and contain precipitation for last 24 
-    precipitation for last 24 hours. Comment lines starting with # will be +    hours. Comment lines starting with # will be ignored.
-    ignored.+
  
     Another example: the filter file (starting with a blank line!)     Another example: the filter file (starting with a blank line!)
  
-      wmonr+      call_sign =~ /^L[A-N]..$/
       obstime >= '2012-02-10 06:00:00'       obstime >= '2012-02-10 06:00:00'
-      RR_1 | RR_12 | RR_24 +      HW | HWA | PW | PWA 
-      TA < -30 | TA > 30+      FF > 10 | FG_010 > 10 
 + 
 +    will print only those ship observations for which the 4 character 
 +    call_sign starts with 2 letters in the interval LA-LN, and having 
 +    obstime larger or equal to the datetime given, and containing wave data 
 +    (specifically: height or period of waves, manually or automatically 
 +    measured), and with wind or 10 minutes gust more than 10 m/s. 
 + 
 +    For convenience, when there are no BUFR descriptor criteria, you might 
 +    provide the filter criteria on the command line. Example: 
 + 
 +    --filter 'wmonr,TA > 0,RR_12 | RR_24, !FF'
  
-    will print only those observations containing a wmonr (skipping ships, +    will decode only observations with wmonr, having positive temperature 
-    and having obstime larger or equal to the datetime given, and containing +    and containing precipitation for 12 or 24 hours and not reporting wind. 
-    precipitation for 1, 12 or 24 hours, and having temperature below minus +    If (like for --param) the filter list consists of one criterium only, a 
-    30 or above plus 30 degrees Celsius.+    comma must be appended.
  
     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
  • bufr.pm/bufrdump.pl_help.1329312816.txt.gz
  • Last modified: 2022-05-31 09:23:11
  • (external edit)