grib-rust

Pure-Rust, read-only GRIB decoder for weather and climate data. No C libraries, no build scripts, and no unsafe beyond memmap2.

Crates

Usage

use grib_reader::GribFile;

let file = GribFile::open("gfs.grib2")?;
println!("messages: {}", file.message_count());

for msg in file.messages() {
    println!(
        "  {} {:?} {:04}-{:02}-{:02}T{:02}:{:02}:{:02}Z",
        msg.parameter_name(),
        msg.grid_shape(),
        msg.reference_time().year,
        msg.reference_time().month,
        msg.reference_time().day,
        msg.reference_time().hour,
        msg.reference_time().minute,
        msg.reference_time().second,
    );
}

let data = file.message(0)?.read_data_as_f64()?;
println!("shape: {:?}", data.shape());

let tolerant = GribFile::from_bytes_with_options(
    std::fs::read("mixed.bin")?,
    grib_reader::OpenOptions { strict: false },
)?;
println!("recoverable messages: {}", tolerant.message_count());

Supported Now

• GRIB1 and GRIB2 message scanning with "GRIB"/"7777" boundary detection
• Logical field indexing for multi-field GRIB2 messages
• Regular latitude/longitude grids for GRIB1 and GRIB2
• Simple packing for GRIB1 and GRIB2
• WMO parameter table lookups (Code Table 4.2)
• Typed metadata access for reference time, parameter identity, product metadata, grid geometry, and lat/lon coordinates
• OpenOptions for strict or tolerant scanning
• Bitmap application with missing values surfaced as NaN
• Parallel field decoding via Rayon
• Output: ndarray::ArrayD<f64>
• Memory-mapped I/O or owned byte buffers

Not Yet Supported

• Non-lat/lon grid templates
• Complex packing and more advanced multi-packing templates
• JPEG2000 and PNG-packed GRIB2 fields
• GRIB1 predefined bitmaps

Unsupported cases fail explicitly with typed errors.

Feature flags

Testing

cargo fmt --all --check
cargo clippy --all-targets --all-features -- -D warnings
cargo run -p grib-reader --example sync_corpus
git diff --exit-code
cargo test --all-features
cargo test --no-default-features
cargo check --manifest-path grib-reader/fuzz/Cargo.toml --bins
cargo clippy --manifest-path grib-reader/fuzz/Cargo.toml --bins -- -D warnings

Release Checklist

cargo publish -p grib-reader --dry-run
cargo publish -p grib-reader
git tag v0.1.0
git push origin v0.1.0

Corpus And Fuzzing

• Bootstrap corpus samples live in grib-reader/tests/corpus/bootstrap/
• Real interoperability samples belong in grib-reader/tests/corpus/interop/samples/
• Regenerate the bootstrap and fuzz seed corpora with cargo run -p grib-reader --example sync_corpus
• Fuzzer entry points and usage notes live in grib-reader/fuzz/README.md

License

MIT OR Apache-2.0