Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
bufr.pm:bufrresolve_source [2014-05-28 14:17:57] pals |
bufr.pm:bufrresolve_source [2023-02-05 10:15:44] (current) pals |
||
---|---|---|---|
Line 1: | Line 1: | ||
<code perl> | <code perl> | ||
- | # | + | # |
- | # (C) Copyright 2010, met.no | + | # (C) Copyright 2010-2023 MET Norway |
# | # | ||
# This program is free software; you can redistribute it and/or modify | # This program is free software; you can redistribute it and/or modify | ||
Line 22: | Line 22: | ||
use strict; | use strict; | ||
+ | use warnings; | ||
use Getopt:: | use Getopt:: | ||
use Pod::Usage qw(pod2usage); | use Pod::Usage qw(pod2usage); | ||
use Geo::BUFR; | use Geo::BUFR; | ||
+ | |||
+ | # This is actually default in BUFR.pm, but provided here to make it | ||
+ | # easier for users to change to ' | ||
+ | use constant DEFAULT_TABLE_FORMAT => ' | ||
# Will be used if neither --tablepath nor $ENV{BUFR_TABLES} is set | # Will be used if neither --tablepath nor $ENV{BUFR_TABLES} is set | ||
- | use constant | + | use constant |
+ | use constant DEFAULT_TABLE_PATH_ECCODES => '/ | ||
# Ought to be your most up-to-date B table | # Ought to be your most up-to-date B table | ||
- | use constant | + | use constant |
+ | use constant DEFAULT_TABLE_ECCODES => ' | ||
# Parse command line options | # Parse command line options | ||
Line 36: | Line 43: | ||
GetOptions( | GetOptions( | ||
| | ||
- | ' | + | ' |
- | ' | + | ' |
' | ' | ||
' | ' | ||
Line 45: | Line 52: | ||
' | ' | ||
# descriptors on one line | # descriptors on one line | ||
- | ' | + | ' |
+ | ' | ||
' | ' | ||
) or pod2usage(-verbose => 0); | ) or pod2usage(-verbose => 0); | ||
Line 78: | Line 86: | ||
my $verbose = $option{verbose} ? 1 : 0; | my $verbose = $option{verbose} ? 1 : 0; | ||
Geo:: | Geo:: | ||
+ | |||
+ | # From version 1.32 a descriptor sequence ending in e.g. 106000 031001 | ||
+ | # will be allowed unless strict checking is set, and we really want | ||
+ | # bufrresolve.pl to complain in this case | ||
+ | Geo:: | ||
+ | |||
+ | # Set BUFR table format | ||
+ | my $tableformat = (defined $option{tableformat}) ? uc $option{tableformat} : DEFAULT_TABLE_FORMAT; | ||
+ | Geo:: | ||
# Set BUFR table path | # Set BUFR table path | ||
Line 87: | Line 104: | ||
Geo:: | Geo:: | ||
} else { | } else { | ||
- | # If all else fails, use the libbufr bufrtables | + | # If all else fails, use the default tablepath in BUFRDC/ |
- | Geo:: | + | |
+ | | ||
+ | } elsif ($tableformat eq ' | ||
+ | Geo:: | ||
+ | } | ||
} | } | ||
# BUFR table file to use | # BUFR table file to use | ||
- | my $table = $option{bufrtable} || DEFAULT_TABLE; | + | my $table = $option{bufrtable} || |
+ | ($tableformat eq ' | ||
my $bufr = Geo:: | my $bufr = Geo:: | ||
Line 123: | Line 145: | ||
=pod | =pod | ||
+ | |||
+ | =encoding utf8 | ||
=head1 SYNOPSIS | =head1 SYNOPSIS | ||
Line 130: | Line 154: | ||
| | ||
| | ||
- | | + | |
+ | | ||
| | ||
| | ||
Line 136: | Line 161: | ||
2) bufrresolve.pl --code <code or flag table> | 2) bufrresolve.pl --code <code or flag table> | ||
- | | + | |
+ | | ||
| | ||
| | ||
3) bufrresolve.pl --flag < | 3) bufrresolve.pl --flag < | ||
- | | + | |
+ | | ||
| | ||
| | ||
Line 150: | Line 177: | ||
Execute without arguments for Usage, with option C< | Execute without arguments for Usage, with option C< | ||
- | additional info. See also L</https:// | + | additional info. See also L< |
examples of use. | examples of use. | ||
- | It is supposed that the code and flag tables are contained in a file | + | The tables used can be selected |
- | with same name as corresponding B table except for having prefix C | + | C< |
- | instead of B. The tables used can be chosen | + | tableformat |
- | C< | + | bufrresolve.pl will be overridden |
- | DEFAULT_TABLE | + | BUFR_TABLES is set. You should consider edit the source code of |
- | be overriden | + | bufrresolve.pl |
- | should consider edit the source code if you are not satisfied with the | + | tablepath and bufrtable (search for ' |
- | defaults chosen. | + | |
+ | For tableformat ECCODES, see | ||
+ | L< | ||
+ | for more info on how to set C< | ||
+ | |||
+ | For the table name in C< | ||
+ | table, e.g. B0000000000098013001.TXT. Replacing B with D or C, or | ||
+ | omitting this prefix altogether, or even omitting the trailing ' | ||
+ | (i.e. 0000000000098013001) will also work. | ||
+ | |||
+ | For the table name in C< | ||
+ | of table location, e.g. ' | ||
+ | ' | ||
+ | up local sequence descriptors, | ||
+ | and the local table to get the full expansion, e.g. | ||
+ | ' | ||
+ | |||
+ | See also L</" | ||
=head1 OPTIONS | =head1 OPTIONS | ||
Line 168: | Line 212: | ||
descriptors on one line | descriptors on one line | ||
| | ||
- | |||
| | ||
+ | | ||
| | ||
| | ||
- | |||
| | ||
the same as consulting perldoc bufrresolve.pl | the same as consulting perldoc bufrresolve.pl | ||
Line 189: | Line 232: | ||
Options may be abbreviated, | Options may be abbreviated, | ||
- | =head1 | + | =head1 |
- | n > 1 in C<--verbose n> does not provide any more output than n=1, so | + | The C<--bufrtable> option could be considered mandatory, since there |
- | demanding an argument to C< | + | is no guarantee that the same BUFR descriptor resolves the same way |
- | or later someone would type C<bufrresolve.pl | + | for different BUFR tables. However, as soon as a new BUFR descriptor |
- | by Perl would be interpreted as if the arguments were C<307080 000001 | + | is introduced in a BUFR table, it is extremely rare that the |
- | --verbose>, which probably is not what the user intended. | + | descriptor is redefined in later versions. So for convenience, |
+ | bufrresolve.pl | ||
+ | show you the tables used). If this is the wrong table for your purpose | ||
+ | (most common case will be if the descriptor was added in a higher | ||
+ | version than that of the default table), you should definitely use | ||
+ | C<--bufrtable> with the appropriate table. | ||
=head1 AUTHOR | =head1 AUTHOR | ||
Line 203: | Line 251: | ||
=head1 COPYRIGHT | =head1 COPYRIGHT | ||
- | Copyright (C) 2010 met.no | + | Copyright (C) 2010-2023 MET Norway |
=cut | =cut | ||
- | |||
</ | </ |