Struct Raster

pub struct Raster { /* private fields */ }

A Raster image.

Implementations

impl Raster

pub fn new(path: PathBuf) -> Result<Self, MapEngineError>

Crete a new Raster.

This will open a Dataset and store some metadata into the Raster struct. This serves as a cache to avoid constantly reading from the file.

pub fn from_src(path: PathBuf, src: &Dataset) -> Result<Self, MapEngineError>

Create a new Raster from an open Dataset.

Usually, you would want to use Raster::new but this method is available in case you already opened a Dataset.

pub fn read_tile<P>( &self, tile: &Tile, bands: Option<&[isize]>, e_resample_alg: Option<ResampleAlg>, ) -> Result<RawPixels<P>, MapEngineError>

where P: GdalType + Copy + Num + NumCast + ScalarOperand,

Read a tile from raster file.

Arguments

• tile - Tile to read.
• bands - Bands to read (1-indexed).
• e_resample_alg - Resample algorith to use in case interpolations are needed.

Examples

use gdal::raster::ResampleAlg;
use map_engine::{errors::MapEngineError, raster::{Raster, RawPixels}, tiles::Tile};
use std::path::PathBuf;

fn main() -> Result<(), MapEngineError> {
    let path = PathBuf::from("src/tests/data/chile_optimised.tif");
    let raster = Raster::new(path)?;
    let tile = Tile::new(304, 624, 10);

    let arr: RawPixels<f64> = raster.read_tile(&tile, Some(&[1]), Some(ResampleAlg::Average))?;
    assert_eq!(arr.as_array().shape(), &[1, 256, 256]);
    Ok(())
}

pub fn geo(&self) -> &GeoTransform

pub fn spatial_ref(&self) -> Result<SpatialRef, MapEngineError>

pub fn driver_name(&self) -> &str

pub fn raster_count(&self) -> isize

Get number of bands available in the file.

pub fn raster_size(&self) -> (usize, usize)

pub fn intersects(&self, tile: &Tile) -> Result<bool, MapEngineError>

Trait Implementations

impl Clone for Raster

fn clone(&self) -> Raster

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Raster

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.