BUFR keys

Note

This page describes the BUFR keys that can be used in the various keyword arguments of read_bufr().

The actual keyword arguments that support these keys depend on the reader:

  • generic: columns, filters and required_columns support all keys

  • flat: filters and required_columns support all keys

  • synop and temp: filters support all keys. Please note that columns are limited to the pre-defined parameters for these readers.

ecCodes BUFR keys

ALl the ecCodes keys from both the BUFR header and data sections are supported in the read_bufr() kwargs mentioned above. However, there are some limitations:

  • keys containing the rank e.g. “#1#latitude” cannot be used

  • key attributes e.g. “latitude->code” cannot be used

Note

The “count” key is generated by ecCodes and it refers to the message index. It is also supported but please note that message indexing starts at 1 and not at 0!

Computed BUFR keys

These keys are not present in the BUFR data but are generated by pdbufr from existing BUFR keys.

data_datetime

Generated from the “year”, “month”, “day”, “hour”, “minute”, “second” keys in the BUFR data section. The values are converted to a datetime.datetime object.

typical_datetime

Generated from the “typicalYear”, “typicalMonth”, “typicalDay”, “typicalHour”, “typicalMinute”, “typicalSecond” keys in the BUFR header section. The values are converted to a datetime.datetime object.

WMO_station_id

Generated from the “blockNumber” and “stationNumber” keys as:

blockNumber*1000+stationNumber

WIGOS_station_id

New in version 0.12.0

Generated from the “wigosIdentifierSeries”, “wigosIssuerOfIdentifier”, “wigosIssueNumber” and “wigosLocalIdentifierCharacter” keys as a str in the following format:

"{wigosIdentifierSeries}-{wigosIssuerOfIdentifier}-{wigosIssueNumber}-{wigosLocalIdentifierCharacter}

For example: “0-705-0-1931”.

When using “WIGOS_station_id” in filters the value can be given as a str or as a tuple/list of 4 values. See: Filters for details.

Details about the WIGOS identifiers can be found here.

geometry

Values extracted as a list of:

[longitude,latitude,heightOfStationGroundAboveMeanSeaLevel]

as required for geopandas.

CRS

Generated from the “coordinateReferenceSystem” key using the following mapping:

coordinateReferenceSystem

CRS

0

EPSG:4326

1

EPSG:4258

2

EPSG:4269

3

EPSG:4314

4 or 5

not supported

missing

EPSG:4326

Note

Computed keys do not preserve their position in columns but are placed to the end of the resulting DataFrame.