vaster 0.1.0

Raster grid logic: geotransforms, cell indexing, extent-dimension arithmetic. No data, no dependencies.
Documentation
  • Coverage
  • 100%
    31 out of 31 items documented27 out of 27 items with examples
  • Size
  • Source code size: 43.29 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 2.54 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 12s Average build duration of successful builds.
  • all releases: 12s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • hypertidy/vaster-rs
    1 0 1
  • crates.io
  • Dependencies
    • —
  • Versions
  • Owners
  • mdsumner

vaster

CI docs.rs crates.io

Raster grid logic, without any pesky data.

Raster grids are defined by dimension (ncol, nrow) and extent (xmin, xmax, ymin, ymax). Everything else — resolution, cell centres, geotransforms, cell indexing — derives from those six numbers.

Quick start

use vaster::*;

let extent = [-180.0, 180.0, -90.0, 90.0];
let dim = [360, 180];

// Build a  geotransform
let gt = extent_dim_to_gt(&extent, &dim);
assert_eq!(gt[1], 1.0); // 1 degree per pixel

// Cell centre of the top-left pixel
let (x, y) = xy_from_cell(&dim, &extent, 0);
assert!((x - (-179.5)).abs() < 1e-10);
assert!((y - 89.5).abs() < 1e-10);

// Which cell contains a point?
let cell = cell_from_xy(&dim, &extent, 145.5, -43.5);
assert!(cell.is_some());

// Snap a bounding box to grid alignment
let target = [10.3, 20.7, -5.2, 8.9];
let (aligned_ext, aligned_dim) = vcrop(&target, &dim, &extent);
// aligned_ext snaps outward to cell boundaries

What's in the box

Module Functions Purpose
geotransform extent_dim_to_gt, gt_to_extent, inv_geotransform, x_from_col, y_from_row, col_from_x, row_from_y, xy_from_col_row, col_row_from_xy, x_res, y_res GDAL geotransform construction, inversion, coordinate ↔ pixel mapping
cell ncell, cell_from_row_col, row_from_cell, col_from_cell, xy_from_cell, cell_from_xy, x_centre, y_centre, x_corner, y_corner Cell index arithmetic, centre/corner coordinates
crop vcrop, crop_offset Snap-to-grid alignment
world world_to_geotransform, geotransform_to_world ESRI world file interop

Conventions

  • Extent is [xmin, xmax, ymin, ymax]
  • Dimension is [ncol, nrow]
  • Cell indices are 0-based, traversing left-to-right then top-to-bottom
  • Geotransform follows GDAL convention: [origin_x, pixel_width, row_rotation, origin_y, col_rotation, pixel_height]

What's NOT in this crate

  • No CRS / projection handling
  • No I/O, no file formats, no deps
  • No image data, no pixel buffers

Relationship to the R package

This is the Rust equivalent of hypertidy/vaster, an R package for raster grid logic. The API follows the same conventions with one difference: cell indices are 0-based in Rust (1-based in R).

License

Licensed under either of

at your option.