Crate mesh_data_tile

Source

Expand description

§mesh-data-tile-rs (reference)

Minimal Rust reference implementation for Mesh Tile Format v1 (MTI1).

Scope:

Encode tile bytes from metadata + uncompressed payload bytes.
Decode tile bytes into metadata + uncompressed payload bytes.
Validate fixed header fields, CRC32 checksums, and payload length.
Support compression=none and compression=deflate-raw.
Provide typed payload helpers (f64 values <-> payload bytes) for all dtypes.

Out of scope:

GeoJSON/vector conversion.
Map rendering integrations.

JIS root-tile recommendation:

For mesh_kind=JisX0410, tile_id=0 is a recommended convention for a root tile representing the full JIS mesh scope (west=122, south=20, east=154, north=46).
This crate treats tile_id as metadata for JIS tiles and accepts 0 as a valid value.

§Run tests

From repository root:

cargo test -p mesh-data-tile-rs

From references/rust:

cargo test

§Release flow (crates.io with cargo-release)

Pre-requisites:

A crates.io token with publish permission.
cargo-release installed (cargo install cargo-release --locked).

One-time auth:

cargo login <CRATES_IO_TOKEN>

Preflight checks (from repository root):

cargo test -p mesh-data-tile-rs
cargo package -p mesh-data-tile-rs

Dry-run a release (from references/rust):

cargo release patch --dry-run

Publish a release (from references/rust):

cargo release patch --execute

Use minor or major instead of patch when needed:

cargo release minor --dry-run
cargo release major --dry-run

Current release config in Cargo.toml:

Releases are allowed only from main.
Tag format is mesh-data-tile-rs-v<version>.
Release commit message format is chore(release): mesh-data-tile-rs v<version>.

§Example

use mesh_data_tile::{
    decode_payload_values, decode_tile_minimal, encode_payload_values, encode_tile,
    CompressionMode, DType, Endianness, MeshKind, TileDimensions, TileEncodeInput,
};

let dims = TileDimensions { rows: 2, cols: 2, bands: 1 };
let payload = encode_payload_values(DType::Uint16, Endianness::Little, &[10.0, 20.0, 30.0, 40.0])?;

let encoded = encode_tile(TileEncodeInput {
    tile_id: 42,
    mesh_kind: MeshKind::JisX0410,
    dtype: DType::Uint16,
    endianness: Endianness::Little,
    compression: CompressionMode::None,
    dimensions: dims,
    no_data: None,
    payload: &payload,
})?;

let decoded = decode_tile_minimal(&encoded.bytes)?;
let values = decode_payload_values(
    decoded.header.dtype,
    decoded.header.endianness,
    &decoded.payload,
    decoded.header.no_data,
)?;
assert_eq!(
    values,
    vec![Some(10.0), Some(20.0), Some(30.0), Some(40.0)]
);