ARPA-SIMC / wreport

C++ library and applications to work with weather reports. The library provides featureful BUFR and CREX encoding and decoding.
Other
9 stars 9 forks source link
bufr crex decoding meteorology weather-report

Build Status Build Status Build Status Build Status Build Status

WREPORT

Introduction

wreport is a C++ library for working with weather reports.

wreport is a powerful decoder and encoder for the BUFR and CREX formats.

It also provides a useful abstraction to handle values found in weather reports, with awareness of significant digits, measurement units, variable descriptions, unit conversion and attributes on variables.

Features provided:

C++ and Python API documentation.

Installing wreport

wreport is already packaged in both .rpm and .deb formats, and that provides easy installation for most Linux distributions.

For CentOS and Fedora, rpm files are hosted in a copr repo: https://copr.fedorainfracloud.org/coprs/simc/stable/

For Debian, wreport is available in the testing distribution: https://packages.debian.org/testing/libwreport3

Using docker images with wreport preinstalled is also possible:

docker run -it arpaesimc/fedora:36 /bin/bash
docker run -it arpaesimc/centos:8 /bin/bash

If you want to build and install wreport yourself, you'll need to install Meson and run the following commands:

meson setup builddir && cd builddir
meson compile
meson test
meson install

For more details about Meson see the official documentation https://mesonbuild.com/.

If you want to build the package yourself:

AFL instrumentation

To run wreport using American Fuzzy Lop:

CXX=/usr/bin/afl-g++ meson --default-library=static builddir && cd builddir
AFL_HARDEN=1 meson compile
afl-cmin  -i testdata/bufr/ -o afl-bufr -- src/afl-test @@
afl-fuzz -t 100 -i afl-bufr -o afl-bufr-out src/afl-test @@

Contact and copyright information

The author of wreport is Enrico Zini enrico@enricozini.com

wreport is Copyright (C) 2005-2024 ARPAE-SIMC urpsim@arpae.it

wreport is licensed under the terms of the GNU General Public License version 2.