rust-grib-decoder 0.1.0

Utilities to decode GRIB2 CCSDS/AEC (template 5.0=42) payloads and extract Section 7 payloads per message.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

# rust-grib-decoder


[![crates.io](https://img.shields.io/crates/v/rust-grib-decoder.svg)](https://crates.io/crates/rust-grib-decoder) [![docs.rs](https://img.shields.io/docsrs/rust-grib-decoder)](https://docs.rs/rust-grib-decoder) [![license](https://img.shields.io/crates/l/rust-grib-decoder.svg)](LICENSE)

Utilities to decode GRIB2 CCSDS/AEC (template 5.0=42) payloads and to extract Section 7 payloads on a per-message basis.

This crate provides a small, focused set of helpers useful for tooling and CLI utilities:

- `read_grib2_section7_payloads_by_message(path: &Path) -> Result<Vec<Vec<u8>>, String>`
- `read_first_grib2_section7_payload(path: &Path) -> Result<Vec<u8>, String>`
- `read_grib2_section5_template42_params_by_message(path: &Path) -> Result<Vec<Option<Template42Params>>, String>`
- `decode_template42_rust_from_params_with_payload(...)` (pure-Rust `rust-aec` decoder)
- `probe_all_fields_at_lat_lon(path, lat, lon)` — convenience probe helper
- `summarize_file(path) -> FileSummary` and `find_candidates_for_param(path, param)` — CLI diagnostics helpers

## Quickstart ✨


Add to your `Cargo.toml` (crates.io):

```toml
rust-grib-decoder = "0.1"
```

For local/workspace development use the path override:

```toml
# Local development

# rust-grib-decoder = { path = "crates/rust-grib-decoder", default-features = true }

```

## Usage example


```rust
use std::path::Path;
use rust_grib_decoder::{read_first_grib2_latlon_grid, decode_template42_first_message};

let path = Path::new("data.grib2");
let grid = read_first_grib2_latlon_grid(path)?;
if let Ok(Some(values)) = decode_template42_first_message(path, grid.ni, grid.nj) {
    println!("Decoded {} samples ({}x{})", values.len(), grid.ni, grid.nj);
}
```

## Documentation & publishing


- Docs: https://docs.rs/rust-grib-decoder
- Crates.io: https://crates.io/crates/rust-grib-decoder

Before publishing, ensure `repository` and `authors` in `Cargo.toml` are set and a LICENSE file is present.

---

(See `examples/` for runnable examples. This crate includes an `extract_param` example that shows how to summarize a file, find candidate messages for a parameter like `msl` or `2t`, and decode an interpolated value at a lon/lat: `cargo run -p rust-grib-decoder --example extract_param -- file.grib2 msl 113.363 22.962`.)