Installation • Usage • Documentation

[!IMPORTANT] This software is Emerging and subject to ECMWF's guidelines on Software Maturity.

Support level: None. The project is made available as-is, with no guarantee of support. However, bug reports and community contributions are encouraged and appreciated.

GribCheck is a Python tool that validates project-specific conventions of GRIB files. It performs a limited set of checks on GRIB messages to ensure they comply with the project's internal standards and expectations.

Please note that GribCheck is not a general-purpose GRIB validator. For instance, it does not verify whether a file fully complies with the WMO GRIB standard or whether it is a technically valid GRIB file.

Installation

pip install grib-check

Usage

To use GribCheck, you need to specify the GRIB convention you want to check. The library currently supports the following conventions:

• tigge : The International Grand Global Ensemble (TIGGE)
• tigge_cr : The International Grand Global Ensemble (TIGGE) - common resolution version
• lam : TIGGE Limited-Area Model (TIGGE LAM)
• s2s : Subseasonal to Seasonal (S2S)
• s2s_refcst : S2S Reforecasts
• uerra : Uncertainties in Ensembles of Regional ReAnalysis (UERRA)
• crra : Copernicus Regional Reanalysis (CERRA)
• lcgcr : WMO Lead Centre for Global Climate Reanalyses (LC-GCR)

Experimental conventions that are under development include:

• wpmip : Weather Prediction Model Intercomparison Project (WP-MIP)

You can specify the convention using the -C or --convention command-line argument. For example, to check a GRIB file of type "tigge", you would run the following command:

grib-check -C tigge /path/to/file.grib2

The output provides the result of each check performed on the GRIB messages in the file. Each check may be annotated with an additional context or information of the check performed which may be useful for diagnostics. Checks typically have the status FAIL or PASS. Sometimes, however, a status cannot be assigned - for example if a test is skipped or message is purely informational - in which case the status "----" is used.

The report follows a hierarchical structure, where checks can contain sub-checks and assertions, forming branches. If an assertion fails, the failure propagates upward, and the entire branch is marked as failed.

The following command demonstrates a check on a file of convention "s2s". For demonstration purposes, we'll change the convention to "uerra" to intentionally trigger check failures and showcase the output.

Documentation

• Components
• Parameters
• Checks
• Adding new GRIB conventions

License

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.