wbraster/

raster.rs

//! Core `Raster` type — the central data structure for all raster GIS data.

use rayon::prelude::*;
use std::path::Path;
use std::sync::atomic::{AtomicUsize, Ordering};
use wbprojection::{from_proj_string, Crs, CrsTransformPolicy, EpochPolicy, EpochTransformOptions};
use wide::{f64x4, CmpNe};

use crate::crs_info::CrsInfo;
use crate::error::{RasterError, Result};
use crate::formats::RasterFormat;

// ─── Data type enum ───────────────────────────────────────────────────────────

/// The underlying numeric data type of raster cells.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum DataType {
    /// Unsigned 8-bit integer (byte).
    U8,
    /// Signed 8-bit integer.
    I8,
    /// Unsigned 16-bit integer.
    U16,
    /// Signed 16-bit integer.
    I16,
    /// Unsigned 32-bit integer.
    U32,
    /// Signed 32-bit integer.
    I32,
    /// Unsigned 64-bit integer.
    U64,
    /// Signed 64-bit integer.
    I64,
    /// 32-bit IEEE 754 floating point.
    #[default]
    F32,
    /// 64-bit IEEE 754 floating point.
    F64,
}

impl DataType {
    /// Number of bytes per cell value.
    pub fn size_bytes(self) -> usize {
        match self {
            DataType::U8 | DataType::I8 => 1,
            DataType::U16 | DataType::I16 => 2,
            DataType::U32 | DataType::I32 | DataType::F32 => 4,
            DataType::U64 | DataType::I64 | DataType::F64 => 8,
        }
    }

    /// Human-readable name used in header files.
    pub fn as_str(self) -> &'static str {
        match self {
            DataType::U8 => "uint8",
            DataType::I8 => "int8",
            DataType::U16 => "uint16",
            DataType::I16 => "int16",
            DataType::U32 => "uint32",
            DataType::I32 => "int32",
            DataType::U64 => "uint64",
            DataType::I64 => "int64",
            DataType::F32 => "float32",
            DataType::F64 => "float64",
        }
    }

    /// Parse from a format string (case-insensitive).
    #[allow(clippy::should_implement_trait)]
    pub fn from_str(s: &str) -> Option<Self> {
        match s.trim().to_ascii_lowercase().as_str() {
            "uint8" | "u8" | "byte" => Some(DataType::U8),
            "int8" | "i8" => Some(DataType::I8),
            "uint16" | "u16" => Some(DataType::U16),
            "int16" | "i16" | "integer" | "short" => Some(DataType::I16),
            "uint32" | "u32" => Some(DataType::U32),
            "int32" | "i32" | "long" => Some(DataType::I32),
            "uint64" | "u64" => Some(DataType::U64),
            "int64" | "i64" | "longlong" => Some(DataType::I64),
            "float32" | "f32" | "float" | "real" => Some(DataType::F32),
            "float64" | "f64" | "double" => Some(DataType::F64),
            _ => None,
        }
    }
}

impl std::fmt::Display for DataType {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(self.as_str())
    }
}

/// A lightweight read-only view of a single raster band materialized as `f64`.
///
/// Provides a bounds-safe [`BandView::get`] that returns the raster's `nodata`
/// sentinel for out-of-bounds coordinates — the same contract as the legacy
/// `get_value` accessor, but with a single integer bounds check and a direct
/// array index instead of per-call type-dispatch overhead.
///
/// Obtain via [`Raster::band_view`]. The type is `Send + Sync` and is designed
/// to be wrapped in `Arc` for sharing across worker threads.
///
/// # Hot-loop pattern
/// ```rust
/// let view = Arc::new(dem.band_view(0));
/// // clone the Arc into each worker thread, then in the kernel:
/// let z  = view.get(row, col);           // center cell
/// let zn = view.get(row + dy, col + dx); // neighbour – nodata returned for OOB
/// ```
#[derive(Debug, Clone)]
pub struct BandView {
    data: Vec<f64>,
    /// Number of rows in the source band.
    pub rows: isize,
    /// Number of columns in the source band.
    pub cols: isize,
    /// No-data sentinel value.
    pub nodata: f64,
}

impl BandView {
    /// Read the value at signed `(row, col)` coordinates.
    ///
    /// Returns `self.nodata` when coordinates are outside the band extents.
    #[inline]
    pub fn get(&self, row: isize, col: isize) -> f64 {
        if row < 0 || col < 0 || row >= self.rows || col >= self.cols {
            return self.nodata;
        }
        self.data[row as usize * self.cols as usize + col as usize]
    }

    /// Returns `true` if `v` equals the band's nodata sentinel.
    #[inline]
    pub fn is_nodata(&self, v: f64) -> bool {
        if self.nodata.is_nan() {
            v.is_nan()
        } else {
            v == self.nodata
        }
    }

    /// Direct reference to the underlying flat buffer (`row * cols + col` indexing).
    /// Length is `rows as usize * cols as usize`.
    #[inline]
    pub fn as_slice(&self) -> &[f64] {
        &self.data
    }
}

// SAFETY: BandView contains only Vec<f64>, isize, and f64 — all Send and Sync.
unsafe impl Send for BandView {}
unsafe impl Sync for BandView {}

/// Typed in-memory pixel buffer.
#[derive(Debug, Clone)]
pub enum RasterData {
    /// Unsigned 8-bit storage.
    U8(Vec<u8>),
    /// Signed 8-bit storage.
    I8(Vec<i8>),
    /// Unsigned 16-bit storage.
    U16(Vec<u16>),
    /// Signed 16-bit storage.
    I16(Vec<i16>),
    /// Unsigned 32-bit storage.
    U32(Vec<u32>),
    /// Signed 32-bit storage.
    I32(Vec<i32>),
    /// Unsigned 64-bit storage.
    U64(Vec<u64>),
    /// Signed 64-bit storage.
    I64(Vec<i64>),
    /// 32-bit float storage.
    F32(Vec<f32>),
    /// 64-bit float storage.
    F64(Vec<f64>),
}

/// A mutable typed view of one raster row.
pub enum RasterRowMut<'a> {
    /// Unsigned 8-bit row.
    U8(&'a mut [u8]),
    /// Signed 8-bit row.
    I8(&'a mut [i8]),
    /// Unsigned 16-bit row.
    U16(&'a mut [u16]),
    /// Signed 16-bit row.
    I16(&'a mut [i16]),
    /// Unsigned 32-bit row.
    U32(&'a mut [u32]),
    /// Signed 32-bit row.
    I32(&'a mut [i32]),
    /// Unsigned 64-bit row.
    U64(&'a mut [u64]),
    /// Signed 64-bit row.
    I64(&'a mut [i64]),
    /// 32-bit float row.
    F32(&'a mut [f32]),
    /// 64-bit float row.
    F64(&'a mut [f64]),
}

/// An immutable typed view of one raster row.
pub enum RasterRowRef<'a> {
    /// Unsigned 8-bit row.
    U8(&'a [u8]),
    /// Signed 8-bit row.
    I8(&'a [i8]),
    /// Unsigned 16-bit row.
    U16(&'a [u16]),
    /// Signed 16-bit row.
    I16(&'a [i16]),
    /// Unsigned 32-bit row.
    U32(&'a [u32]),
    /// Signed 32-bit row.
    I32(&'a [i32]),
    /// Unsigned 64-bit row.
    U64(&'a [u64]),
    /// Signed 64-bit row.
    I64(&'a [i64]),
    /// 32-bit float row.
    F32(&'a [f32]),
    /// 64-bit float row.
    F64(&'a [f64]),
}

impl RasterData {
    /// Create a typed data buffer of length `len`, filled with `value` converted
    /// to the specified data type.
    pub fn new_filled(data_type: DataType, len: usize, value: f64) -> Self {
        match data_type {
            DataType::U8 => Self::U8(vec![value as u8; len]),
            DataType::I8 => Self::I8(vec![value as i8; len]),
            DataType::U16 => Self::U16(vec![value as u16; len]),
            DataType::I16 => Self::I16(vec![value as i16; len]),
            DataType::U32 => Self::U32(vec![value as u32; len]),
            DataType::I32 => Self::I32(vec![value as i32; len]),
            DataType::U64 => Self::U64(vec![value as u64; len]),
            DataType::I64 => Self::I64(vec![value as i64; len]),
            DataType::F32 => Self::F32(vec![value as f32; len]),
            DataType::F64 => Self::F64(vec![value; len]),
        }
    }

    /// Create a typed data buffer of length `len` with **uninitialized** contents.
    ///
    /// # Safety
    /// Every element must be written before any read. This is intended as a
    /// performance fast-path for callers that immediately overwrite every cell
    /// (e.g. `par_fill_with`), avoiding the redundant nodata-fill of `new_filled`.
    pub fn new_uninit(data_type: DataType, len: usize) -> Self {
        fn uninit_vec<T>(len: usize) -> Vec<T> {
            let mut v = Vec::with_capacity(len);
            // SAFETY: capacity == len, all elements are written by the caller
            // before any read occurs.
            unsafe { v.set_len(len) };
            v
        }
        match data_type {
            DataType::U8 => Self::U8(uninit_vec(len)),
            DataType::I8 => Self::I8(uninit_vec(len)),
            DataType::U16 => Self::U16(uninit_vec(len)),
            DataType::I16 => Self::I16(uninit_vec(len)),
            DataType::U32 => Self::U32(uninit_vec(len)),
            DataType::I32 => Self::I32(uninit_vec(len)),
            DataType::U64 => Self::U64(uninit_vec(len)),
            DataType::I64 => Self::I64(uninit_vec(len)),
            DataType::F32 => Self::F32(uninit_vec(len)),
            DataType::F64 => Self::F64(uninit_vec(len)),
        }
    }

    /// Convert an `f64` vector into typed storage.
    pub fn from_f64_vec(data_type: DataType, data: Vec<f64>) -> Self {
        match data_type {
            DataType::U8 => Self::U8(data.into_iter().map(|v| v as u8).collect()),
            DataType::I8 => Self::I8(data.into_iter().map(|v| v as i8).collect()),
            DataType::U16 => Self::U16(data.into_iter().map(|v| v as u16).collect()),
            DataType::I16 => Self::I16(data.into_iter().map(|v| v as i16).collect()),
            DataType::U32 => Self::U32(data.into_iter().map(|v| v as u32).collect()),
            DataType::I32 => Self::I32(data.into_iter().map(|v| v as i32).collect()),
            DataType::U64 => Self::U64(data.into_iter().map(|v| v as u64).collect()),
            DataType::I64 => Self::I64(data.into_iter().map(|v| v as i64).collect()),
            DataType::F32 => Self::F32(data.into_iter().map(|v| v as f32).collect()),
            DataType::F64 => Self::F64(data),
        }
    }

    /// Number of stored cells.
    pub fn len(&self) -> usize {
        match self {
            Self::U8(v) => v.len(),
            Self::I8(v) => v.len(),
            Self::U16(v) => v.len(),
            Self::I16(v) => v.len(),
            Self::U32(v) => v.len(),
            Self::I32(v) => v.len(),
            Self::U64(v) => v.len(),
            Self::I64(v) => v.len(),
            Self::F32(v) => v.len(),
            Self::F64(v) => v.len(),
        }
    }

    /// Returns `true` if no cells are stored.
    pub fn is_empty(&self) -> bool {
        self.len() == 0
    }

    /// Native stored data type.
    pub fn data_type(&self) -> DataType {
        match self {
            Self::U8(_) => DataType::U8,
            Self::I8(_) => DataType::I8,
            Self::U16(_) => DataType::U16,
            Self::I16(_) => DataType::I16,
            Self::U32(_) => DataType::U32,
            Self::I32(_) => DataType::I32,
            Self::U64(_) => DataType::U64,
            Self::I64(_) => DataType::I64,
            Self::F32(_) => DataType::F32,
            Self::F64(_) => DataType::F64,
        }
    }

    /// Read one cell as `f64`.
    pub fn get_f64(&self, idx: usize) -> f64 {
        match self {
            Self::U8(v) => v[idx] as f64,
            Self::I8(v) => v[idx] as f64,
            Self::U16(v) => v[idx] as f64,
            Self::I16(v) => v[idx] as f64,
            Self::U32(v) => v[idx] as f64,
            Self::I32(v) => v[idx] as f64,
            Self::U64(v) => v[idx] as f64,
            Self::I64(v) => v[idx] as f64,
            Self::F32(v) => v[idx] as f64,
            Self::F64(v) => v[idx],
        }
    }

    /// Set one cell from an `f64` value using native-type conversion.
    pub fn set_f64(&mut self, idx: usize, value: f64) {
        match self {
            Self::U8(v) => v[idx] = value as u8,
            Self::I8(v) => v[idx] = value as i8,
            Self::U16(v) => v[idx] = value as u16,
            Self::I16(v) => v[idx] = value as i16,
            Self::U32(v) => v[idx] = value as u32,
            Self::I32(v) => v[idx] = value as i32,
            Self::U64(v) => v[idx] = value as u64,
            Self::I64(v) => v[idx] = value as i64,
            Self::F32(v) => v[idx] = value as f32,
            Self::F64(v) => v[idx] = value,
        }
    }

    /// Iterate over all cells as `f64`.
    pub fn iter_f64(&self) -> Box<dyn Iterator<Item = f64> + '_> {
        match self {
            Self::U8(v) => Box::new(v.iter().copied().map(|x| x as f64)),
            Self::I8(v) => Box::new(v.iter().copied().map(|x| x as f64)),
            Self::U16(v) => Box::new(v.iter().copied().map(|x| x as f64)),
            Self::I16(v) => Box::new(v.iter().copied().map(|x| x as f64)),
            Self::U32(v) => Box::new(v.iter().copied().map(|x| x as f64)),
            Self::I32(v) => Box::new(v.iter().copied().map(|x| x as f64)),
            Self::U64(v) => Box::new(v.iter().copied().map(|x| x as f64)),
            Self::I64(v) => Box::new(v.iter().copied().map(|x| x as f64)),
            Self::F32(v) => Box::new(v.iter().copied().map(|x| x as f64)),
            Self::F64(v) => Box::new(v.iter().copied()),
        }
    }

    /// Materialize all cells as `Vec<f64>`.
    pub fn to_f64_vec(&self) -> Vec<f64> {
        self.iter_f64().collect()
    }

    /// Returns data as `u8` slice when storage is `U8`.
    pub fn as_u8_slice(&self) -> Option<&[u8]> {
        match self {
            Self::U8(v) => Some(v.as_slice()),
            _ => None,
        }
    }

    /// Returns data as mutable `u8` slice when storage is `U8`.
    pub fn as_u8_slice_mut(&mut self) -> Option<&mut [u8]> {
        match self {
            Self::U8(v) => Some(v.as_mut_slice()),
            _ => None,
        }
    }

    /// Returns data as `i8` slice when storage is `I8`.
    pub fn as_i8_slice(&self) -> Option<&[i8]> {
        match self {
            Self::I8(v) => Some(v.as_slice()),
            _ => None,
        }
    }

    /// Returns data as mutable `i8` slice when storage is `I8`.
    pub fn as_i8_slice_mut(&mut self) -> Option<&mut [i8]> {
        match self {
            Self::I8(v) => Some(v.as_mut_slice()),
            _ => None,
        }
    }

    /// Returns data as `u16` slice when storage is `U16`.
    pub fn as_u16_slice(&self) -> Option<&[u16]> {
        match self {
            Self::U16(v) => Some(v.as_slice()),
            _ => None,
        }
    }

    /// Returns data as mutable `u16` slice when storage is `U16`.
    pub fn as_u16_slice_mut(&mut self) -> Option<&mut [u16]> {
        match self {
            Self::U16(v) => Some(v.as_mut_slice()),
            _ => None,
        }
    }

    /// Returns data as `i16` slice when storage is `I16`.
    pub fn as_i16_slice(&self) -> Option<&[i16]> {
        match self {
            Self::I16(v) => Some(v.as_slice()),
            _ => None,
        }
    }

    /// Returns data as mutable `i16` slice when storage is `I16`.
    pub fn as_i16_slice_mut(&mut self) -> Option<&mut [i16]> {
        match self {
            Self::I16(v) => Some(v.as_mut_slice()),
            _ => None,
        }
    }

    /// Returns data as `u32` slice when storage is `U32`.
    pub fn as_u32_slice(&self) -> Option<&[u32]> {
        match self {
            Self::U32(v) => Some(v.as_slice()),
            _ => None,
        }
    }

    /// Returns data as mutable `u32` slice when storage is `U32`.
    pub fn as_u32_slice_mut(&mut self) -> Option<&mut [u32]> {
        match self {
            Self::U32(v) => Some(v.as_mut_slice()),
            _ => None,
        }
    }

    /// Returns data as `i32` slice when storage is `I32`.
    pub fn as_i32_slice(&self) -> Option<&[i32]> {
        match self {
            Self::I32(v) => Some(v.as_slice()),
            _ => None,
        }
    }

    /// Returns data as mutable `i32` slice when storage is `I32`.
    pub fn as_i32_slice_mut(&mut self) -> Option<&mut [i32]> {
        match self {
            Self::I32(v) => Some(v.as_mut_slice()),
            _ => None,
        }
    }

    /// Returns data as `u64` slice when storage is `U64`.
    pub fn as_u64_slice(&self) -> Option<&[u64]> {
        match self {
            Self::U64(v) => Some(v.as_slice()),
            _ => None,
        }
    }

    /// Returns data as mutable `u64` slice when storage is `U64`.
    pub fn as_u64_slice_mut(&mut self) -> Option<&mut [u64]> {
        match self {
            Self::U64(v) => Some(v.as_mut_slice()),
            _ => None,
        }
    }

    /// Returns data as `i64` slice when storage is `I64`.
    pub fn as_i64_slice(&self) -> Option<&[i64]> {
        match self {
            Self::I64(v) => Some(v.as_slice()),
            _ => None,
        }
    }

    /// Returns data as mutable `i64` slice when storage is `I64`.
    pub fn as_i64_slice_mut(&mut self) -> Option<&mut [i64]> {
        match self {
            Self::I64(v) => Some(v.as_mut_slice()),
            _ => None,
        }
    }

    /// Returns data as `f32` slice when storage is `F32`.
    pub fn as_f32_slice(&self) -> Option<&[f32]> {
        match self {
            Self::F32(v) => Some(v.as_slice()),
            _ => None,
        }
    }

    /// Returns data as mutable `f32` slice when storage is `F32`.
    pub fn as_f32_slice_mut(&mut self) -> Option<&mut [f32]> {
        match self {
            Self::F32(v) => Some(v.as_mut_slice()),
            _ => None,
        }
    }

    /// Returns data as `f64` slice when storage is `F64`.
    pub fn as_f64_slice(&self) -> Option<&[f64]> {
        match self {
            Self::F64(v) => Some(v.as_slice()),
            _ => None,
        }
    }

    /// Returns data as mutable `f64` slice when storage is `F64`.
    pub fn as_f64_slice_mut(&mut self) -> Option<&mut [f64]> {
        match self {
            Self::F64(v) => Some(v.as_mut_slice()),
            _ => None,
        }
    }

    /// Fill all cells in-place using a parallel closure `f(index) -> f64`.
    ///
    /// The index is the flat band-major, row-major cell index. For typed
    /// storage other than `F64`, the returned `f64` is converted to the
    /// native stored type before writing. The closure must be `Send + Sync`
    /// so that Rayon can dispatch it across threads.
    pub fn par_fill_with<F>(&mut self, f: F)
    where
        F: Fn(usize) -> f64 + Send + Sync,
    {
        match self {
            Self::U8(v) => v
                .par_iter_mut()
                .enumerate()
                .for_each(|(i, c)| *c = f(i) as u8),
            Self::I8(v) => v
                .par_iter_mut()
                .enumerate()
                .for_each(|(i, c)| *c = f(i) as i8),
            Self::U16(v) => v
                .par_iter_mut()
                .enumerate()
                .for_each(|(i, c)| *c = f(i) as u16),
            Self::I16(v) => v
                .par_iter_mut()
                .enumerate()
                .for_each(|(i, c)| *c = f(i) as i16),
            Self::U32(v) => v
                .par_iter_mut()
                .enumerate()
                .for_each(|(i, c)| *c = f(i) as u32),
            Self::I32(v) => v
                .par_iter_mut()
                .enumerate()
                .for_each(|(i, c)| *c = f(i) as i32),
            Self::U64(v) => v
                .par_iter_mut()
                .enumerate()
                .for_each(|(i, c)| *c = f(i) as u64),
            Self::I64(v) => v
                .par_iter_mut()
                .enumerate()
                .for_each(|(i, c)| *c = f(i) as i64),
            Self::F32(v) => v
                .par_iter_mut()
                .enumerate()
                .for_each(|(i, c)| *c = f(i) as f32),
            Self::F64(v) => v.par_iter_mut().enumerate().for_each(|(i, c)| *c = f(i)),
        }
    }
}

// ─── NoData sentinel ─────────────────────────────────────────────────────────

/// Represents the "no data" sentinel value for a raster layer.
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct NoData(pub f64);

impl NoData {
    /// Common GIS nodata default.
    pub const COMMON: NoData = NoData(-9999.0);
    /// IEEE NaN-based nodata (compare with `is_nan()`).
    pub const NAN: NoData = NoData(f64::NAN);

    /// Returns `true` if `v` represents this nodata value.
    #[inline]
    pub fn matches(self, v: f64) -> bool {
        if self.0.is_nan() {
            v.is_nan()
        } else {
            (v - self.0).abs() < f64::EPSILON * self.0.abs().max(1.0)
        }
    }
}

impl Default for NoData {
    fn default() -> Self {
        Self::COMMON
    }
}

// ─── Spatial extent ───────────────────────────────────────────────────────────

/// Axis-aligned bounding box for a raster.
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct Extent {
    /// West edge (minimum X / longitude).
    pub x_min: f64,
    /// South edge (minimum Y / latitude).
    pub y_min: f64,
    /// East edge (maximum X / longitude).
    pub x_max: f64,
    /// North edge (maximum Y / latitude).
    pub y_max: f64,
}

impl Extent {
    /// Compute the extent from origin + grid dimensions.
    pub fn from_origin(x_min: f64, y_min: f64, cols: usize, rows: usize, cell_size: f64) -> Self {
        Self {
            x_min,
            y_min,
            x_max: x_min + cols as f64 * cell_size,
            y_max: y_min + rows as f64 * cell_size,
        }
    }

    /// Width in spatial units.
    pub fn width(&self) -> f64 {
        self.x_max - self.x_min
    }

    /// Height in spatial units.
    pub fn height(&self) -> f64 {
        self.y_max - self.y_min
    }
}

// ─── Statistics ───────────────────────────────────────────────────────────────

/// Basic raster statistics.
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct Statistics {
    /// Minimum data value (excluding nodata).
    pub min: f64,
    /// Maximum data value (excluding nodata).
    pub max: f64,
    /// Mean of data values (excluding nodata).
    pub mean: f64,
    /// Standard deviation of data values (excluding nodata).
    pub std_dev: f64,
    /// Number of valid (non-nodata) cells.
    pub valid_count: usize,
    /// Number of nodata cells.
    pub nodata_count: usize,
}

/// Selects the computation path used for raster statistics.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum StatisticsComputationMode {
    /// Use the crate's default optimized path.
    Auto,
    /// Force the scalar accumulation path.
    Scalar,
    /// Force the SIMD accumulation path.
    Simd,
}

#[derive(Debug, Clone, Copy)]
struct StatsAccumulator {
    min: f64,
    max: f64,
    sum: f64,
    sum_sq: f64,
    valid_count: usize,
    nodata_count: usize,
}

impl Default for StatsAccumulator {
    fn default() -> Self {
        Self {
            min: f64::INFINITY,
            max: f64::NEG_INFINITY,
            sum: 0.0,
            sum_sq: 0.0,
            valid_count: 0,
            nodata_count: 0,
        }
    }
}

impl StatsAccumulator {
    fn merge(&mut self, other: Self) {
        self.min = self.min.min(other.min);
        self.max = self.max.max(other.max);
        self.sum += other.sum;
        self.sum_sq += other.sum_sq;
        self.valid_count += other.valid_count;
        self.nodata_count += other.nodata_count;
    }

    fn to_statistics(self) -> Statistics {
        let (mean, std_dev) = if self.valid_count == 0 {
            (0.0, 0.0)
        } else {
            let n = self.valid_count as f64;
            let mean = self.sum / n;
            let variance = (self.sum_sq / n - mean * mean).max(0.0);
            (mean, variance.sqrt())
        };

        Statistics {
            min: if self.valid_count == 0 { 0.0 } else { self.min },
            max: if self.valid_count == 0 { 0.0 } else { self.max },
            mean,
            std_dev,
            valid_count: self.valid_count,
            nodata_count: self.nodata_count,
        }
    }
}

/// Resampling method used during raster reprojection.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ResampleMethod {
    /// Nearest-neighbor sampling (fast, category-safe).
    Nearest,
    /// Bilinear interpolation (continuous surfaces).
    Bilinear,
    /// Bicubic interpolation (Catmull-Rom cubic convolution).
    Cubic,
    /// Lanczos interpolation (windowed sinc, radius 3).
    Lanczos,
    /// 3x3 mean filter around nearest source pixel center.
    Average,
    /// 3x3 minimum filter around nearest source pixel center.
    Min,
    /// 3x3 maximum filter around nearest source pixel center.
    Max,
    /// 3x3 mode filter around nearest source pixel center.
    Mode,
    /// 3x3 median filter around nearest source pixel center.
    Median,
    /// 3x3 standard-deviation filter around nearest source pixel center.
    StdDev,
}

/// Nodata handling policy for interpolation-based reprojection.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum NodataPolicy {
    /// Require full valid kernel support; otherwise output nodata.
    Strict,
    /// Use available valid kernel samples and renormalize interpolation weights.
    PartialKernel,
    /// Try strict interpolation first, then fall back to nearest-neighbor sampling.
    Fill,
}

/// Policy controlling longitude bound handling when antimeridian crossing is possible.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum AntimeridianPolicy {
    /// Use linear bounds unless wrapped bounds are strictly narrower.
    Auto,
    /// Always use linear min/max longitude bounds.
    Linear,
    /// Always use wrapped minimal-arc longitude bounds.
    Wrap,
}

/// Policy for converting resolution + extent to integer output dimensions.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum GridSizePolicy {
    /// Expand outward to fully cover requested extent (uses ceil sizing).
    Expand,
    /// Keep grid within requested extent (uses floor sizing, min 1 cell).
    FitInside,
}

/// Destination-footprint handling mode during reprojection.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum DestinationFootprint {
    /// Do not apply a transformed-source footprint mask.
    None,
    /// Mask destination cells outside transformed source boundary ring.
    SourceBoundary,
}

/// Options for raster reprojection.
#[derive(Debug, Clone, Copy)]
pub struct ReprojectOptions {
    /// Destination CRS EPSG code.
    pub dst_epsg: u32,
    /// Resampling method.
    pub resample: ResampleMethod,
    /// Optional output column count (defaults to source `cols`).
    pub cols: Option<usize>,
    /// Optional output row count (defaults to source `rows`).
    pub rows: Option<usize>,
    /// Optional output extent in destination CRS.
    ///
    /// Defaults to transformed bounds of source extent corners.
    pub extent: Option<Extent>,
    /// Optional output X resolution in destination CRS units/pixel.
    ///
    /// Used to derive output `cols` when `cols` is not provided.
    pub x_res: Option<f64>,
    /// Optional output Y resolution in destination CRS units/pixel.
    ///
    /// Used to derive output `rows` when `rows` is not provided.
    pub y_res: Option<f64>,
    /// Optional snap origin X for resolution-derived output grid alignment.
    ///
    /// Used only when `x_res` is provided and `cols` is not explicitly set.
    pub snap_x: Option<f64>,
    /// Optional snap origin Y for resolution-derived output grid alignment.
    ///
    /// Used only when `y_res` is provided and `rows` is not explicitly set.
    pub snap_y: Option<f64>,
    /// Nodata policy used by interpolation methods.
    pub nodata_policy: NodataPolicy,
    /// Policy controlling antimeridian handling for geographic output bounds.
    pub antimeridian_policy: AntimeridianPolicy,
    /// Policy used when deriving integer output size from resolution controls.
    pub grid_size_policy: GridSizePolicy,
    /// Destination-footprint handling policy during reprojection.
    pub destination_footprint: DestinationFootprint,
    /// Emit non-fatal warnings when sampled source raster points appear outside
    /// the declared area of use of source and/or destination CRS definitions.
    pub warn_on_area_of_use_mismatch: bool,
    /// Optional epoch-aware transform routing options.
    pub epoch_transform: EpochTransformOptions,
}

impl ReprojectOptions {
    /// Create options with required destination EPSG and resampling method.
    pub fn new(dst_epsg: u32, resample: ResampleMethod) -> Self {
        Self {
            dst_epsg,
            resample,
            cols: None,
            rows: None,
            extent: None,
            x_res: None,
            y_res: None,
            snap_x: None,
            snap_y: None,
            nodata_policy: NodataPolicy::PartialKernel,
            antimeridian_policy: AntimeridianPolicy::Auto,
            grid_size_policy: GridSizePolicy::Expand,
            destination_footprint: DestinationFootprint::None,
            warn_on_area_of_use_mismatch: false,
            epoch_transform: EpochTransformOptions::default(),
        }
    }

    /// Set nodata handling policy for interpolation and return updated options.
    pub fn with_nodata_policy(mut self, nodata_policy: NodataPolicy) -> Self {
        self.nodata_policy = nodata_policy;
        self
    }

    /// Set output raster size (columns, rows) and return updated options.
    pub fn with_size(mut self, cols: usize, rows: usize) -> Self {
        self.cols = Some(cols);
        self.rows = Some(rows);
        self
    }

    /// Set output raster extent and return updated options.
    pub fn with_extent(mut self, extent: Extent) -> Self {
        self.extent = Some(extent);
        self
    }

    /// Set output resolution (`x_res`, `y_res`) and return updated options.
    ///
    /// Positive finite values are required and interpreted as destination CRS
    /// units per pixel.
    pub fn with_resolution(mut self, x_res: f64, y_res: f64) -> Self {
        self.x_res = Some(x_res);
        self.y_res = Some(y_res);
        self
    }

    /// Set isotropic output resolution and return updated options.
    pub fn with_square_resolution(mut self, res: f64) -> Self {
        self.x_res = Some(res);
        self.y_res = Some(res);
        self
    }

    /// Set snap origin for aligning resolution-derived output grids.
    ///
    /// Snap alignment is applied per axis only when that axis uses
    /// resolution-derived sizing (i.e., no explicit `cols`/`rows`).
    pub fn with_snap_origin(mut self, snap_x: f64, snap_y: f64) -> Self {
        self.snap_x = Some(snap_x);
        self.snap_y = Some(snap_y);
        self
    }

    /// Set antimeridian handling policy for geographic output bounds.
    pub fn with_antimeridian_policy(mut self, policy: AntimeridianPolicy) -> Self {
        self.antimeridian_policy = policy;
        self
    }

    /// Set sizing policy used for resolution-derived output dimensions.
    pub fn with_grid_size_policy(mut self, policy: GridSizePolicy) -> Self {
        self.grid_size_policy = policy;
        self
    }

    /// Set destination-footprint handling policy for reprojection output.
    pub fn with_destination_footprint(mut self, footprint: DestinationFootprint) -> Self {
        self.destination_footprint = footprint;
        self
    }

    /// Enable/disable non-fatal area-of-use mismatch warnings.
    pub fn with_area_of_use_warning(mut self, enabled: bool) -> Self {
        self.warn_on_area_of_use_mismatch = enabled;
        self
    }

    /// Set epoch-aware transform routing options.
    pub fn with_epoch_transform_options(mut self, epoch_transform: EpochTransformOptions) -> Self {
        self.epoch_transform = epoch_transform;
        self
    }
}

// ─── Configuration / builder ──────────────────────────────────────────────────

/// Parameters used to construct a new `Raster`.
#[derive(Debug, Clone)]
pub struct RasterConfig {
    /// Number of columns (samples).
    pub cols: usize,
    /// Number of rows (lines).
    pub rows: usize,
    /// Number of bands.
    pub bands: usize,
    /// X coordinate of the west edge (left).
    pub x_min: f64,
    /// Y coordinate of the south edge (bottom).
    pub y_min: f64,
    /// Cell size (assumed square unless `cell_size_y` is set).
    pub cell_size: f64,
    /// Optional distinct Y cell size (negative = top-down raster).
    /// If `None`, `cell_size` is used (positive, bottom-up convention).
    pub cell_size_y: Option<f64>,
    /// No-data sentinel value.
    pub nodata: f64,
    /// Underlying storage type.
    pub data_type: DataType,
    /// Spatial reference system.
    pub crs: CrsInfo,
    /// Free-form metadata key/value pairs.
    pub metadata: Vec<(String, String)>,
}

impl Default for RasterConfig {
    fn default() -> Self {
        Self {
            cols: 0,
            rows: 0,
            bands: 1,
            x_min: 0.0,
            y_min: 0.0,
            cell_size: 1.0,
            cell_size_y: None,
            nodata: -9999.0,
            data_type: DataType::F32,
            crs: CrsInfo::default(),
            metadata: Vec::new(),
        }
    }
}

// ─── Main Raster struct ───────────────────────────────────────────────────────

/// A raster grid with one or more bands.
///
/// Data is stored in a typed contiguous buffer matching `data_type`.
/// Conversion to `f64` happens only through accessor helpers when needed.
///
/// Layout: band-major, then row-major top-down within each band
/// (`index = band * rows * cols + row * cols + col`).
#[derive(Debug, Clone)]
pub struct Raster {
    /// Number of columns.
    pub cols: usize,
    /// Number of rows.
    pub rows: usize,
    /// Number of bands.
    pub bands: usize,
    /// West edge X coordinate.
    pub x_min: f64,
    /// South edge Y coordinate.
    pub y_min: f64,
    /// Cell width in map units (always positive).
    pub cell_size_x: f64,
    /// Cell height in map units (always positive, stored as absolute value).
    pub cell_size_y: f64,
    /// No-data value.
    pub nodata: f64,
    /// On-disk data type (used for writing).
    pub data_type: DataType,
    /// Spatial reference.
    pub crs: CrsInfo,
    /// Free-form key/value metadata.
    pub metadata: Vec<(String, String)>,
    /// Raw data buffer, band-major then row-major top-down. Length = `bands * cols * rows`.
    pub data: RasterData,
}

impl Raster {
    // ─── Construction ──────────────────────────────────────────────────────

    /// Create a new raster from a `RasterConfig`, filling all cells with `nodata`.
    pub fn new(cfg: RasterConfig) -> Self {
        let bands = cfg.bands.max(1);
        let n = cfg.cols * cfg.rows * bands;
        let cell_size_y = cfg.cell_size_y.map(|v| v.abs()).unwrap_or(cfg.cell_size);
        Self {
            cols: cfg.cols,
            rows: cfg.rows,
            bands,
            x_min: cfg.x_min,
            y_min: cfg.y_min,
            cell_size_x: cfg.cell_size,
            cell_size_y,
            nodata: cfg.nodata,
            data_type: cfg.data_type,
            crs: cfg.crs,
            metadata: cfg.metadata,
            data: RasterData::new_filled(cfg.data_type, n, cfg.nodata),
        }
    }

    /// Create a raster from a raw `f64` data buffer.
    ///
    /// # Errors
    /// Returns [`RasterError::InvalidDimensions`] if `data.len() != cols * rows * bands`.
    pub fn from_data(cfg: RasterConfig, data: Vec<f64>) -> Result<Self> {
        let bands = cfg.bands.max(1);
        if data.len() != cfg.cols * cfg.rows * bands {
            return Err(RasterError::InvalidDimensions {
                cols: cfg.cols,
                rows: cfg.rows,
            });
        }
        let dt = cfg.data_type;
        let mut r = Self::new(cfg);
        r.data = RasterData::from_f64_vec(dt, data);
        Ok(r)
    }

    /// Create a raster from a typed data buffer.
    ///
    /// # Errors
    /// Returns [`RasterError::InvalidDimensions`] if `data.len() != cols * rows * bands`.
    /// Returns [`RasterError::Other`] if `cfg.data_type != data.data_type()`.
    pub fn from_data_native(cfg: RasterConfig, data: RasterData) -> Result<Self> {
        let bands = cfg.bands.max(1);
        if data.len() != cfg.cols * cfg.rows * bands {
            return Err(RasterError::InvalidDimensions {
                cols: cfg.cols,
                rows: cfg.rows,
            });
        }
        if cfg.data_type != data.data_type() {
            return Err(RasterError::Other(format!(
                "data_type mismatch: config={}, data={}",
                cfg.data_type,
                data.data_type()
            )));
        }
        let mut r = Self::new(cfg);
        r.data = data;
        Ok(r)
    }

    /// Create a new raster that reuses spatial metadata and layout from `template`.
    ///
    /// Cell values are initialized to the template's nodata value.
    pub fn new_like(template: &Raster) -> Self {
        Self::new(RasterConfig {
            cols: template.cols,
            rows: template.rows,
            bands: template.bands,
            x_min: template.x_min,
            y_min: template.y_min,
            cell_size: template.cell_size_x,
            cell_size_y: Some(template.cell_size_y),
            nodata: template.nodata,
            data_type: template.data_type,
            crs: template.crs.clone(),
            metadata: template.metadata.clone(),
        })
    }

    /// Like [`new_like`] but skips initializing the data buffer.
    ///
    /// Use this when every cell will be written before any read (e.g. immediately
    /// followed by `par_fill_with`). Avoids a redundant full-buffer nodata write.
    pub fn new_like_uninit(template: &Raster) -> Self {
        let bands = template.bands.max(1);
        let n = template.cols * template.rows * bands;
        let cell_size_y = template.cell_size_y;
        Self {
            cols: template.cols,
            rows: template.rows,
            bands,
            x_min: template.x_min,
            y_min: template.y_min,
            cell_size_x: template.cell_size_x,
            cell_size_y,
            nodata: template.nodata,
            data_type: template.data_type,
            crs: template.crs.clone(),
            metadata: template.metadata.clone(),
            data: RasterData::new_uninit(template.data_type, n),
        }
    }

    /// Typed fast-path access to `u8` storage.
    pub fn data_u8(&self) -> Option<&[u8]> {
        self.data.as_u8_slice()
    }
    /// Typed fast-path mutable access to `u8` storage.
    pub fn data_u8_mut(&mut self) -> Option<&mut [u8]> {
        self.data.as_u8_slice_mut()
    }

    /// Typed fast-path access to `i8` storage.
    pub fn data_i8(&self) -> Option<&[i8]> {
        self.data.as_i8_slice()
    }
    /// Typed fast-path mutable access to `i8` storage.
    pub fn data_i8_mut(&mut self) -> Option<&mut [i8]> {
        self.data.as_i8_slice_mut()
    }

    /// Typed fast-path access to `u16` storage.
    pub fn data_u16(&self) -> Option<&[u16]> {
        self.data.as_u16_slice()
    }
    /// Typed fast-path mutable access to `u16` storage.
    pub fn data_u16_mut(&mut self) -> Option<&mut [u16]> {
        self.data.as_u16_slice_mut()
    }

    /// Typed fast-path access to `i16` storage.
    pub fn data_i16(&self) -> Option<&[i16]> {
        self.data.as_i16_slice()
    }
    /// Typed fast-path mutable access to `i16` storage.
    pub fn data_i16_mut(&mut self) -> Option<&mut [i16]> {
        self.data.as_i16_slice_mut()
    }

    /// Typed fast-path access to `u32` storage.
    pub fn data_u32(&self) -> Option<&[u32]> {
        self.data.as_u32_slice()
    }
    /// Typed fast-path mutable access to `u32` storage.
    pub fn data_u32_mut(&mut self) -> Option<&mut [u32]> {
        self.data.as_u32_slice_mut()
    }

    /// Typed fast-path access to `i32` storage.
    pub fn data_i32(&self) -> Option<&[i32]> {
        self.data.as_i32_slice()
    }
    /// Typed fast-path mutable access to `i32` storage.
    pub fn data_i32_mut(&mut self) -> Option<&mut [i32]> {
        self.data.as_i32_slice_mut()
    }

    /// Typed fast-path access to `u64` storage.
    pub fn data_u64(&self) -> Option<&[u64]> {
        self.data.as_u64_slice()
    }
    /// Typed fast-path mutable access to `u64` storage.
    pub fn data_u64_mut(&mut self) -> Option<&mut [u64]> {
        self.data.as_u64_slice_mut()
    }

    /// Typed fast-path access to `i64` storage.
    pub fn data_i64(&self) -> Option<&[i64]> {
        self.data.as_i64_slice()
    }
    /// Typed fast-path mutable access to `i64` storage.
    pub fn data_i64_mut(&mut self) -> Option<&mut [i64]> {
        self.data.as_i64_slice_mut()
    }

    /// Typed fast-path access to `f32` storage.
    pub fn data_f32(&self) -> Option<&[f32]> {
        self.data.as_f32_slice()
    }
    /// Typed fast-path mutable access to `f32` storage.
    pub fn data_f32_mut(&mut self) -> Option<&mut [f32]> {
        self.data.as_f32_slice_mut()
    }

    /// Typed fast-path access to `f64` storage.
    pub fn data_f64(&self) -> Option<&[f64]> {
        self.data.as_f64_slice()
    }
    /// Typed fast-path mutable access to `f64` storage.
    pub fn data_f64_mut(&mut self) -> Option<&mut [f64]> {
        self.data.as_f64_slice_mut()
    }

    /// Materialize one band (zero-based) as a [`BandView`].
    ///
    /// This is the canonical input path for tool kernels that need per-cell read
    /// access without explicit bounds checks or type dispatch at every call site.
    /// Call once at tool entry, wrap in `Arc`, share across worker threads, and
    /// call `view.get(row, col)` in the hot loop.
    ///
    /// For `F64` rasters the internal buffer is a direct subslice clone (one
    /// allocation). For all other storage types each cell is converted once.
    pub fn band_view(&self, band: usize) -> BandView {
        BandView {
            data: self.band_to_vec_f64(band),
            rows: self.rows as isize,
            cols: self.cols as isize,
            nodata: self.nodata,
        }
    }

    /// Returns a direct reference to the raw `f64` storage for a single band (zero-based)
    /// when the raster's native storage type is `F64`, otherwise returns `None`.
    ///
    /// The slice has length `rows * cols` and is indexed as `row * cols + col`.
    ///
    /// Use this as a zero-copy fast path before spawning worker threads on `F64` rasters
    /// (e.g. DEMs). For non-`F64` rasters, call [`band_to_vec_f64`] instead to get a
    /// converted, owned buffer with the same indexing convention.
    #[inline]
    pub fn band_as_f64_slice(&self, band: usize) -> Option<&[f64]> {
        let stride = self.rows * self.cols;
        let start = band * stride;
        self.data.as_f64_slice()?.get(start..start + stride)
    }

    /// Materializes one band (zero-based) as a flat, row-major `Vec<f64>`.
    ///
    /// For `F64` rasters this clones the band's subslice directly (one allocation,
    /// no per-cell conversion). For all other storage types each cell is converted
    /// from the native type in a single pass.
    ///
    /// The returned buffer has length `rows * cols` and is indexed as
    /// `row * cols + col`. Out-of-bounds values are the caller's responsibility;
    /// respect `raster.rows` and `raster.cols`.
    ///
    /// **Use this once before spawning worker threads** so that hot kernels can index
    /// a plain `Vec` directly rather than going through the generic [`get`] accessor
    /// on every cell access.
    ///
    /// ```rust
    /// let buf = raster.band_to_vec_f64(0);
    /// let z = buf[row * cols + col];  // no per-cell dispatch overhead
    /// ```
    pub fn band_to_vec_f64(&self, band: usize) -> Vec<f64> {
        let stride = self.rows * self.cols;
        let start = band * stride;
        let end = start + stride;
        match &self.data {
            RasterData::F64(v) => v[start..end].to_vec(),
            RasterData::F32(v) => v[start..end].iter().map(|&x| x as f64).collect(),
            RasterData::U8(v) => v[start..end].iter().map(|&x| x as f64).collect(),
            RasterData::I8(v) => v[start..end].iter().map(|&x| x as f64).collect(),
            RasterData::U16(v) => v[start..end].iter().map(|&x| x as f64).collect(),
            RasterData::I16(v) => v[start..end].iter().map(|&x| x as f64).collect(),
            RasterData::U32(v) => v[start..end].iter().map(|&x| x as f64).collect(),
            RasterData::I32(v) => v[start..end].iter().map(|&x| x as f64).collect(),
            RasterData::U64(v) => v[start..end].iter().map(|&x| x as f64).collect(),
            RasterData::I64(v) => v[start..end].iter().map(|&x| x as f64).collect(),
        }
    }

    /// Fill all cells in-place using a parallel closure `f(index) -> f64`.
    ///
    /// The index is the flat band-major, row-major cell index. For typed
    /// storage other than `F64`, the returned `f64` is down-cast to the
    /// native stored type before writing.
    pub fn par_fill_with<F>(&mut self, f: F)
    where
        F: Fn(usize) -> f64 + Send + Sync,
    {
        self.data.par_fill_with(f);
    }

    /// Apply a unary math operation to selected bands (or all bands if `target_bands` is `None`).
    ///
    /// Operates **in-place** on `self`. For floating-point rasters (F32/F64), uses direct typed
    /// slice access + SIMD-friendly iteration. For integer rasters, falls back to per-band copy-loop.
    ///
    /// If `target_bands` is `None`, operates on the entire flat buffer with fast F32/F64 paths.
    /// If `target_bands` is `Some(vec)`, operates only on those band indices via per-band slicing.
    ///
    /// # Errors
    /// Returns an error if a band index is out of bounds (only when `target_bands` is `Some`).
    pub fn apply_unary_math<F>(&mut self, f: F, target_bands: Option<Vec<usize>>) -> Result<()>
    where
        F: Fn(f64) -> f64 + Send + Sync,
    {
        let nodata = self.nodata;
        let nodata_is_nan = nodata.is_nan();

        match target_bands {
            None => {
                // Fast path: operate on all data via flat buffer (most common for tools).
                // F32 direct access with no enum dispatch.
                if let Some(data) = self.data.as_f32_slice_mut() {
                    let nodata_f32 = nodata as f32;
                    data.par_iter_mut().for_each(|v| {
                        let zf = *v as f64;
                        let is_nd = if nodata_is_nan {
                            zf.is_nan()
                        } else {
                            *v == nodata_f32
                        };
                        if !is_nd {
                            *v = f(zf) as f32;
                        }
                    });
                // F64 direct access.
                } else if let Some(data) = self.data.as_f64_slice_mut() {
                    data.par_iter_mut().for_each(|v| {
                        let is_nd = if nodata_is_nan {
                            v.is_nan()
                        } else {
                            *v == nodata
                        };
                        if !is_nd {
                            *v = f(*v);
                        }
                    });
                // Generic fallback for integer types.
                } else {
                    let len = self.data.len();
                    for i in 0..len {
                        let z = self.data.get_f64(i);
                        if nodata_is_nan {
                            if !z.is_nan() {
                                self.data.set_f64(i, f(z));
                            }
                        } else if z != nodata {
                            self.data.set_f64(i, f(z));
                        }
                    }
                }
            }
            Some(bands) => {
                // Per-band operation for selective application.
                for band in bands {
                    if band >= self.bands {
                        return Err(RasterError::OutOfBounds {
                            band: band as isize,
                            row: 0,
                            col: 0,
                            bands: self.bands,
                            cols: self.cols,
                            rows: self.rows,
                        });
                    }
                    let mut vals = self.band_slice(band as isize);
                    vals.par_iter_mut().for_each(|v| {
                        let is_nd = if nodata_is_nan {
                            v.is_nan()
                        } else {
                            *v == nodata
                        };
                        if !is_nd {
                            *v = f(*v);
                        }
                    });
                    self.set_band_slice(band as isize, &vals)?;
                }
            }
        }

        Ok(())
    }

    /// Apply a unary math operation reading from `src` and writing to `self`.
    ///
    /// Copies each cell value from `src`, applies the operation, and stores in `self`.
    /// Uses direct typed slice access (F32/F64) for performance.
    ///
    /// # Errors
    /// Returns an error if rasters have different dimensions.
    pub fn apply_unary_math_from<F>(&mut self, f: F, src: &Raster) -> Result<()>
    where
        F: Fn(f64) -> f64 + Send + Sync,
    {
        if self.rows != src.rows || self.cols != src.cols || self.bands != src.bands {
            return Err(RasterError::Other(format!(
                "raster dimension mismatch: self {}×{}×{} != src {}×{}×{}",
                self.bands, self.rows, self.cols, src.bands, src.rows, src.cols
            )));
        }

        let nodata = src.nodata;
        let nodata_is_nan = nodata.is_nan();

        // Fast path: F32 input/output.
        if let (Some(src_data), Some(dst_data)) =
            (src.data.as_f32_slice(), self.data.as_f32_slice_mut())
        {
            let nodata_f32 = nodata as f32;
            dst_data
                .par_iter_mut()
                .zip(src_data.par_iter())
                .for_each(|(out, &z)| {
                    let zf = z as f64;
                    let is_nd = if nodata_is_nan {
                        zf.is_nan()
                    } else {
                        z == nodata_f32
                    };
                    *out = if is_nd { nodata_f32 } else { f(zf) as f32 };
                });
        // Fast path: F64 input/output.
        } else if let (Some(src_data), Some(dst_data)) =
            (src.data.as_f64_slice(), self.data.as_f64_slice_mut())
        {
            dst_data
                .par_iter_mut()
                .zip(src_data.par_iter())
                .for_each(|(out, &z)| {
                    let is_nd = if nodata_is_nan {
                        z.is_nan()
                    } else {
                        z == nodata
                    };
                    *out = if is_nd { nodata } else { f(z) };
                });
        // Generic fallback for mixed or integer types.
        } else {
            let len = self.data.len();
            for i in 0..len {
                let z = src.data.get_f64(i);
                let result = if nodata_is_nan {
                    if z.is_nan() {
                        nodata
                    } else {
                        f(z)
                    }
                } else if z == nodata {
                    nodata
                } else {
                    f(z)
                };
                self.data.set_f64(i, result);
            }
        }

        Ok(())
    }

    /// Apply a binary math operation from two source rasters, writing results into `self`.
    ///
    /// `self` must be a freshly-allocated output (e.g. from `Raster::new_like`). The closure
    /// `f(z1, z2) -> f64` is called only for cell pairs where neither source is nodata.
    /// When either source is nodata the output cell is set to `self.nodata`.
    ///
    /// Fast paths: when `self`, `src1`, and `src2` are all F32 or all F64 the typed slices
    /// are zipped in parallel without any enum dispatch per cell.
    ///
    /// # Errors
    /// Returns an error if the raster dimensions do not all match.
    pub fn apply_binary_math_from<F>(&mut self, f: F, src1: &Raster, src2: &Raster) -> Result<()>
    where
        F: Fn(f64, f64) -> f64 + Send + Sync,
    {
        if self.rows != src1.rows
            || self.cols != src1.cols
            || self.bands != src1.bands
            || src1.rows != src2.rows
            || src1.cols != src2.cols
            || src1.bands != src2.bands
        {
            return Err(RasterError::Other(format!(
                "raster dimension mismatch: self {}×{}×{}, src1 {}×{}×{}, src2 {}×{}×{}",
                self.bands,
                self.rows,
                self.cols,
                src1.bands,
                src1.rows,
                src1.cols,
                src2.bands,
                src2.rows,
                src2.cols,
            )));
        }

        let nd1 = src1.nodata;
        let nd1_is_nan = nd1.is_nan();
        let nd2 = src2.nodata;
        let nd2_is_nan = nd2.is_nan();
        let nd_out = self.nodata;

        let is_nd1 = |v: f32| -> bool {
            if nd1_is_nan {
                (v as f64).is_nan()
            } else {
                v == nd1 as f32
            }
        };
        let is_nd2 = |v: f32| -> bool {
            if nd2_is_nan {
                (v as f64).is_nan()
            } else {
                v == nd2 as f32
            }
        };
        let is_nd1_f64 = |v: f64| -> bool {
            if nd1_is_nan {
                v.is_nan()
            } else {
                v == nd1
            }
        };
        let is_nd2_f64 = |v: f64| -> bool {
            if nd2_is_nan {
                v.is_nan()
            } else {
                v == nd2
            }
        };

        // Fast path family: destination + src1 are F32, src2 may be any native storage.
        if let (Some(d1), Some(dst)) = (src1.data.as_f32_slice(), self.data.as_f32_slice_mut()) {
            let nd_out_f32 = nd_out as f32;

            if let Some(d2) = src2.data.as_f32_slice() {
                dst.par_iter_mut()
                    .zip(d1.par_iter())
                    .zip(d2.par_iter())
                    .for_each(|((out, &z1), &z2)| {
                        if is_nd1(z1) || is_nd2(z2) {
                            *out = nd_out_f32;
                        } else {
                            *out = f(z1 as f64, z2 as f64) as f32;
                        }
                    });
                return Ok(());
            }

            macro_rules! run_f32_rhs_typed {
                ($rhs:expr) => {{
                    dst.par_iter_mut()
                        .zip(d1.par_iter())
                        .zip($rhs.par_iter())
                        .for_each(|((out, &z1), &z2)| {
                            let z2f = z2 as f64;
                            let z2_is_nd = if nd2_is_nan { z2f.is_nan() } else { z2f == nd2 };
                            if is_nd1(z1) || z2_is_nd {
                                *out = nd_out_f32;
                            } else {
                                *out = f(z1 as f64, z2f) as f32;
                            }
                        });
                    return Ok(());
                }};
            }

            if let Some(d2) = src2.data.as_f64_slice() {
                dst.par_iter_mut()
                    .zip(d1.par_iter())
                    .zip(d2.par_iter())
                    .for_each(|((out, &z1), &z2)| {
                        if is_nd1(z1) || is_nd2_f64(z2) {
                            *out = nd_out_f32;
                        } else {
                            *out = f(z1 as f64, z2) as f32;
                        }
                    });
                return Ok(());
            }
            if let Some(d2) = src2.data.as_u8_slice() {
                run_f32_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i8_slice() {
                run_f32_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_u16_slice() {
                run_f32_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i16_slice() {
                run_f32_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_u32_slice() {
                run_f32_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i32_slice() {
                run_f32_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_u64_slice() {
                run_f32_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i64_slice() {
                run_f32_rhs_typed!(d2);
            }
        }

        // Fast path family: destination + src1 are F64, src2 may be any native storage.
        if let (Some(d1), Some(dst)) = (src1.data.as_f64_slice(), self.data.as_f64_slice_mut()) {
            if let Some(d2) = src2.data.as_f64_slice() {
                dst.par_iter_mut()
                    .zip(d1.par_iter())
                    .zip(d2.par_iter())
                    .for_each(|((out, &z1), &z2)| {
                        if is_nd1_f64(z1) || is_nd2_f64(z2) {
                            *out = nd_out;
                        } else {
                            *out = f(z1, z2);
                        }
                    });
                return Ok(());
            }

            macro_rules! run_f64_rhs_typed {
                ($rhs:expr) => {{
                    dst.par_iter_mut()
                        .zip(d1.par_iter())
                        .zip($rhs.par_iter())
                        .for_each(|((out, &z1), &z2)| {
                            let z2f = z2 as f64;
                            let z2_is_nd = if nd2_is_nan { z2f.is_nan() } else { z2f == nd2 };
                            if is_nd1_f64(z1) || z2_is_nd {
                                *out = nd_out;
                            } else {
                                *out = f(z1, z2f);
                            }
                        });
                    return Ok(());
                }};
            }

            if let Some(d2) = src2.data.as_f32_slice() {
                dst.par_iter_mut()
                    .zip(d1.par_iter())
                    .zip(d2.par_iter())
                    .for_each(|((out, &z1), &z2)| {
                        if is_nd1_f64(z1) || is_nd2(z2) {
                            *out = nd_out;
                        } else {
                            *out = f(z1, z2 as f64);
                        }
                    });
                return Ok(());
            }
            if let Some(d2) = src2.data.as_u8_slice() {
                run_f64_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i8_slice() {
                run_f64_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_u16_slice() {
                run_f64_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i16_slice() {
                run_f64_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_u32_slice() {
                run_f64_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i32_slice() {
                run_f64_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_u64_slice() {
                run_f64_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i64_slice() {
                run_f64_rhs_typed!(d2);
            }
        }

        // Fast path family: destination + src1 are I16, src2 may be any native storage.
        // Covers D8 flow-pointer rasters and other signed-16-bit outputs.
        if let (Some(d1), Some(dst)) = (src1.data.as_i16_slice(), self.data.as_i16_slice_mut()) {
            let nd1_i16 = nd1 as i16;
            let nd_out_i16 = nd_out as i16;
            let chk1_i16 = |v: i16| v == nd1_i16;

            macro_rules! run_i16_rhs_typed {
                ($rhs:expr) => {{
                    dst.par_iter_mut()
                        .zip(d1.par_iter())
                        .zip($rhs.par_iter())
                        .for_each(|((out, &z1), &z2)| {
                            let z2f = z2 as f64;
                            let z2_is_nd = if nd2_is_nan { z2f.is_nan() } else { z2f == nd2 };
                            *out = if chk1_i16(z1) || z2_is_nd {
                                nd_out_i16
                            } else {
                                f(z1 as f64, z2f) as i16
                            };
                        });
                    return Ok(());
                }};
            }

            if let Some(d2) = src2.data.as_f32_slice() {
                dst.par_iter_mut()
                    .zip(d1.par_iter())
                    .zip(d2.par_iter())
                    .for_each(|((out, &z1), &z2)| {
                        *out = if chk1_i16(z1) || is_nd2(z2) {
                            nd_out_i16
                        } else {
                            f(z1 as f64, z2 as f64) as i16
                        };
                    });
                return Ok(());
            }
            if let Some(d2) = src2.data.as_f64_slice() {
                run_i16_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_u8_slice() {
                run_i16_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i8_slice() {
                run_i16_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_u16_slice() {
                run_i16_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i16_slice() {
                run_i16_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_u32_slice() {
                run_i16_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i32_slice() {
                run_i16_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_u64_slice() {
                run_i16_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i64_slice() {
                run_i16_rhs_typed!(d2);
            }
        }

        // Fast path family: destination + src1 are U8, src2 may be any native storage.
        // Covers binary classification masks and other unsigned-8-bit outputs.
        if let (Some(d1), Some(dst)) = (src1.data.as_u8_slice(), self.data.as_u8_slice_mut()) {
            let nd1_u8 = nd1 as u8;
            let nd_out_u8 = nd_out as u8;
            let chk1_u8 = |v: u8| v == nd1_u8;

            macro_rules! run_u8_rhs_typed {
                ($rhs:expr) => {{
                    dst.par_iter_mut()
                        .zip(d1.par_iter())
                        .zip($rhs.par_iter())
                        .for_each(|((out, &z1), &z2)| {
                            let z2f = z2 as f64;
                            let z2_is_nd = if nd2_is_nan { z2f.is_nan() } else { z2f == nd2 };
                            *out = if chk1_u8(z1) || z2_is_nd {
                                nd_out_u8
                            } else {
                                f(z1 as f64, z2f) as u8
                            };
                        });
                    return Ok(());
                }};
            }

            if let Some(d2) = src2.data.as_f32_slice() {
                dst.par_iter_mut()
                    .zip(d1.par_iter())
                    .zip(d2.par_iter())
                    .for_each(|((out, &z1), &z2)| {
                        *out = if chk1_u8(z1) || is_nd2(z2) {
                            nd_out_u8
                        } else {
                            f(z1 as f64, z2 as f64) as u8
                        };
                    });
                return Ok(());
            }
            if let Some(d2) = src2.data.as_f64_slice() {
                run_u8_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_u8_slice() {
                run_u8_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i8_slice() {
                run_u8_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_u16_slice() {
                run_u8_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i16_slice() {
                run_u8_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_u32_slice() {
                run_u8_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i32_slice() {
                run_u8_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_u64_slice() {
                run_u8_rhs_typed!(d2);
            }
            if let Some(d2) = src2.data.as_i64_slice() {
                run_u8_rhs_typed!(d2);
            }
        }

        // Generic parallel fallback for any remaining type combinations
        // (e.g. I32/U16/U32/I64/U64 as dst+src1, or cross-typed mixed pairs).
        // Uses par_fill_with for parallelism; get_f64 dispatch is slightly
        // heavier than the typed fast paths but still fully parallel.
        self.data.par_fill_with(|i| {
            let z1 = src1.data.get_f64(i);
            let z2 = src2.data.get_f64(i);
            if is_nd1_f64(z1) || is_nd2_f64(z2) {
                nd_out
            } else {
                f(z1, z2)
            }
        });

        Ok(())
    }

    /// Add a scalar constant to every non-nodata cell, reading from `src`, writing to `self`.
    ///
    /// Equivalent to `apply_unary_math_from(|z| z + scalar, src)` but expresses intent clearly
    /// and is the canonical kernel shared by the `increment` tool.
    ///
    /// # Errors
    /// Returns an error if raster dimensions do not match.
    pub fn apply_scalar_add(&mut self, src: &Raster, scalar: f64) -> Result<()> {
        self.apply_unary_math_from(|z| z + scalar, src)
    }

    /// Subtract a scalar constant from every non-nodata cell, reading from `src`, writing to `self`.
    ///
    /// Equivalent to `apply_unary_math_from(|z| z - scalar, src)` but expresses intent clearly
    /// and is the canonical kernel shared by the `decrement` tool.
    ///
    /// # Errors
    /// Returns an error if raster dimensions do not match.
    pub fn apply_scalar_sub(&mut self, src: &Raster, scalar: f64) -> Result<()> {
        self.apply_unary_math_from(|z| z - scalar, src)
    }

    // ─── Pixel access ──────────────────────────────────────────────────────

    /// Return the flat buffer index for signed band, row, and column coordinates.
    /// Returns `None` when coordinates are outside the raster bounds.
    #[inline]
    pub fn index(&self, band: isize, row: isize, col: isize) -> Option<usize> {
        if band < 0
            || row < 0
            || col < 0
            || band >= self.bands as isize
            || row >= self.rows as isize
            || col >= self.cols as isize
        {
            return None;
        }
        let band = band as usize;
        let row = row as usize;
        let col = col as usize;
        let band_stride = self.rows * self.cols;
        Some(band * band_stride + row * self.cols + col)
    }

    /// Get the value at signed pixel coordinates `(band, row, col)`.
    ///
    /// Returns the raster's numeric `nodata` sentinel when coordinates are
    /// out-of-bounds or the stored value is nodata.
    #[inline]
    pub fn get(&self, band: isize, row: isize, col: isize) -> f64 {
        self.get_raw(band, row, col).unwrap_or(self.nodata)
    }

    /// Get the value at signed pixel coordinates `(band, row, col)` as
    /// `Option<f64>`.
    ///
    /// Returns `None` if coordinates are out-of-bounds or the value is nodata.
    #[inline]
    pub fn get_opt(&self, band: isize, row: isize, col: isize) -> Option<f64> {
        let idx = self.index(band, row, col)?;
        let v = self.data.get_f64(idx);
        if self.is_nodata(v) {
            None
        } else {
            Some(v)
        }
    }

    /// Get the raw value (including nodata) at signed pixel coordinates `(band, row, col)`.
    /// Returns `None` only on out-of-bounds.
    #[inline]
    pub fn get_raw(&self, band: isize, row: isize, col: isize) -> Option<f64> {
        let idx = self.index(band, row, col)?;
        Some(self.data.get_f64(idx))
    }

    /// Set the value at signed pixel coordinates `(band, row, col)`.
    ///
    /// # Errors
    /// Returns [`RasterError::OutOfBounds`] if coordinates are outside the grid.
    #[inline]
    pub fn set(&mut self, band: isize, row: isize, col: isize, value: f64) -> Result<()> {
        if band < 0
            || row < 0
            || col < 0
            || band >= self.bands as isize
            || row >= self.rows as isize
            || col >= self.cols as isize
        {
            return Err(RasterError::OutOfBounds {
                band,
                col,
                row,
                bands: self.bands,
                cols: self.cols,
                rows: self.rows,
            });
        }
        let idx = self.index(band, row, col).expect("set bounds prechecked");
        self.data.set_f64(idx, value);
        Ok(())
    }

    /// Set a value at signed pixel coordinates, panicking on out-of-bounds. Convenience alias.
    #[inline]
    pub fn set_unchecked(&mut self, band: isize, row: isize, col: isize, value: f64) {
        let idx = self
            .index(band, row, col)
            .expect("set_unchecked requires in-bounds coordinates");
        self.data.set_f64(idx, value);
    }

    /// Returns `true` if `v` equals this raster's nodata sentinel.
    #[inline]
    pub fn is_nodata(&self, v: f64) -> bool {
        if self.nodata.is_nan() {
            v.is_nan()
        } else {
            (v - self.nodata).abs() < 1e-10 * self.nodata.abs().max(1.0)
        }
    }

    // ─── Geometry helpers ─────────────────────────────────────────────────

    /// Northern extent (Y max) — top of the grid.
    #[inline]
    pub fn y_max(&self) -> f64 {
        self.y_min + self.rows as f64 * self.cell_size_y
    }

    /// Eastern extent (X max) — right edge of the grid.
    #[inline]
    pub fn x_max(&self) -> f64 {
        self.x_min + self.cols as f64 * self.cell_size_x
    }

    /// The geographic extent of the raster.
    pub fn extent(&self) -> Extent {
        Extent {
            x_min: self.x_min,
            y_min: self.y_min,
            x_max: self.x_max(),
            y_max: self.y_max(),
        }
    }

    /// Cell-center X coordinate for signed column index `col`.
    #[inline]
    pub fn col_center_x(&self, col: isize) -> f64 {
        self.x_min + (col as f64 + 0.5) * self.cell_size_x
    }

    /// Cell-center Y coordinate for signed row index `row` (row 0 = north).
    #[inline]
    pub fn row_center_y(&self, row: isize) -> f64 {
        self.y_max() - (row as f64 + 0.5) * self.cell_size_y
    }

    /// Convert geographic coordinates `(x, y)` to signed pixel indices `(col, row)`.
    /// Returns `None` if the point lies outside the raster extent.
    pub fn world_to_pixel(&self, x: f64, y: f64) -> Option<(isize, isize)> {
        if x < self.x_min || x >= self.x_max() || y < self.y_min || y >= self.y_max() {
            return None;
        }
        let col = ((x - self.x_min) / self.cell_size_x).floor() as isize;
        let row = ((self.y_max() - y) / self.cell_size_y).floor() as isize;
        let col = col.min(self.cols as isize - 1);
        let row = row.min(self.rows as isize - 1);
        Some((col, row))
    }

    /// Assign a CRS to this raster using an EPSG code.
    ///
    /// Replaces the entire `crs` struct with a new `CrsInfo` containing only the EPSG code.
    /// Any existing `wkt` or `proj4` fields are cleared to ensure CRS consistency.
    pub fn assign_crs_epsg(&mut self, epsg: u32) {
        self.crs = CrsInfo {
            epsg: Some(epsg),
            wkt: None,
            proj4: None,
        };
    }

    /// Assign a CRS to this raster using WKT text.
    ///
    /// Replaces the entire `crs` struct with a new `CrsInfo` containing only the WKT definition.
    /// Any existing `epsg` or `proj4` fields are cleared to ensure CRS consistency.
    pub fn assign_crs_wkt(&mut self, wkt: &str) {
        self.crs = CrsInfo {
            epsg: None,
            wkt: Some(wkt.to_string()),
            proj4: None,
        };
    }

    /// Reproject this raster to another EPSG CRS.
    ///
    /// This MVP implementation uses an auto-derived output extent from transformed
    /// sampled source-boundary points (corners + edge densification) and supports
    /// nearest, bilinear, cubic, and Lanczos sampling.
    ///
    /// For explicit output grid controls (`cols`, `rows`, `extent`), use
    /// [`Raster::reproject_with_options`].
    ///
    /// # Errors
    /// Returns an error when source/destination EPSG codes are unsupported,
    /// source CRS metadata (EPSG/WKT/PROJ) is missing or invalid, or transformed
    /// extents are invalid.
    pub fn reproject_to_epsg(&self, dst_epsg: u32, resample: ResampleMethod) -> Result<Raster> {
        self.reproject_with_options(&ReprojectOptions::new(dst_epsg, resample))
    }

    /// Reproject this raster using detailed output-grid options.
    pub fn reproject_with_options(&self, options: &ReprojectOptions) -> Result<Raster> {
        let src_crs = self.source_crs_for_reprojection()?;
        let dst_crs = Crs::from_epsg(options.dst_epsg).map_err(|e| {
            RasterError::Other(format!(
                "destination EPSG {} is not supported: {e}",
                options.dst_epsg
            ))
        })?;

        self.reproject_internal(&src_crs, &dst_crs, options, None)
    }

    /// Reproject this raster using detailed output-grid options and emit
    /// progress updates in the range [0, 1] as destination rows are completed.
    pub fn reproject_with_options_and_progress<F>(
        &self,
        options: &ReprojectOptions,
        progress: F,
    ) -> Result<Raster>
    where
        F: Fn(f64) + Send + Sync,
    {
        let src_crs = self.source_crs_for_reprojection()?;
        let dst_crs = Crs::from_epsg(options.dst_epsg).map_err(|e| {
            RasterError::Other(format!(
                "destination EPSG {} is not supported: {e}",
                options.dst_epsg
            ))
        })?;

        self.reproject_internal(&src_crs, &dst_crs, options, Some(&progress))
    }

    /// Reproject this raster using caller-supplied source/destination CRS objects.
    ///
    /// This advanced path bypasses source CRS metadata parsing, enabling
    /// workflows where CRS definitions are managed externally.
    ///
    /// Note: `options.dst_epsg` is still used for output `CrsInfo` metadata and
    /// EPSG-specific extent behavior (e.g., antimeridian handling for EPSG:4326).
    pub fn reproject_with_crs(
        &self,
        src_crs: &Crs,
        dst_crs: &Crs,
        options: &ReprojectOptions,
    ) -> Result<Raster> {
        self.reproject_internal(src_crs, dst_crs, options, None)
    }

    /// Reproject this raster with caller-supplied CRS objects and emit progress
    /// updates in the range [0, 1] as destination rows are completed.
    pub fn reproject_with_crs_and_progress<F>(
        &self,
        src_crs: &Crs,
        dst_crs: &Crs,
        options: &ReprojectOptions,
        progress: F,
    ) -> Result<Raster>
    where
        F: Fn(f64) + Send + Sync,
    {
        self.reproject_internal(src_crs, dst_crs, options, Some(&progress))
    }

    /// Convenience helper for nearest-neighbor reprojection.
    pub fn reproject_to_epsg_nearest(&self, dst_epsg: u32) -> Result<Raster> {
        self.reproject_to_epsg(dst_epsg, ResampleMethod::Nearest)
    }

    /// Convenience helper for bilinear reprojection.
    pub fn reproject_to_epsg_bilinear(&self, dst_epsg: u32) -> Result<Raster> {
        self.reproject_to_epsg(dst_epsg, ResampleMethod::Bilinear)
    }

    /// Convenience helper for cubic reprojection.
    pub fn reproject_to_epsg_cubic(&self, dst_epsg: u32) -> Result<Raster> {
        self.reproject_to_epsg(dst_epsg, ResampleMethod::Cubic)
    }

    /// Reproject to destination EPSG using Lanczos interpolation.
    pub fn reproject_to_epsg_lanczos(&self, dst_epsg: u32) -> Result<Raster> {
        self.reproject_to_epsg(dst_epsg, ResampleMethod::Lanczos)
    }

    /// Reproject to destination EPSG using 3x3 mean resampling.
    pub fn reproject_to_epsg_average(&self, dst_epsg: u32) -> Result<Raster> {
        self.reproject_to_epsg(dst_epsg, ResampleMethod::Average)
    }

    /// Reproject to destination EPSG using 3x3 minimum resampling.
    pub fn reproject_to_epsg_min(&self, dst_epsg: u32) -> Result<Raster> {
        self.reproject_to_epsg(dst_epsg, ResampleMethod::Min)
    }

    /// Reproject to destination EPSG using 3x3 maximum resampling.
    pub fn reproject_to_epsg_max(&self, dst_epsg: u32) -> Result<Raster> {
        self.reproject_to_epsg(dst_epsg, ResampleMethod::Max)
    }

    /// Reproject to destination EPSG using 3x3 modal resampling.
    pub fn reproject_to_epsg_mode(&self, dst_epsg: u32) -> Result<Raster> {
        self.reproject_to_epsg(dst_epsg, ResampleMethod::Mode)
    }

    /// Reproject to destination EPSG using 3x3 median resampling.
    pub fn reproject_to_epsg_median(&self, dst_epsg: u32) -> Result<Raster> {
        self.reproject_to_epsg(dst_epsg, ResampleMethod::Median)
    }

    /// Reproject to destination EPSG using 3x3 standard-deviation resampling.
    pub fn reproject_to_epsg_stddev(&self, dst_epsg: u32) -> Result<Raster> {
        self.reproject_to_epsg(dst_epsg, ResampleMethod::StdDev)
    }

    /// Reproject this raster to match another raster's grid (CRS, extent, rows, cols).
    ///
    /// The `target_grid` provides destination EPSG, output extent, and output
    /// dimensions. This is useful when aligning products from multiple sources
    /// onto a shared reference grid.
    ///
    /// # Errors
    /// Returns an error if `target_grid.crs.epsg` is missing or unsupported.
    pub fn reproject_to_match_grid(
        &self,
        target_grid: &Raster,
        resample: ResampleMethod,
    ) -> Result<Raster> {
        let dst_epsg = target_grid.crs.epsg.ok_or_else(|| {
            RasterError::Other(
                "reproject_to_match_grid requires target grid CRS EPSG in target_grid.crs.epsg"
                    .to_string(),
            )
        })?;

        let opts = ReprojectOptions::new(dst_epsg, resample)
            .with_size(target_grid.cols, target_grid.rows)
            .with_extent(target_grid.extent());

        self.reproject_with_options(&opts)
    }

    /// Reproject this raster to match another raster's grid while emitting
    /// progress updates in the range [0, 1] as destination rows are completed.
    pub fn reproject_to_match_grid_and_progress<F>(
        &self,
        target_grid: &Raster,
        resample: ResampleMethod,
        progress: F,
    ) -> Result<Raster>
    where
        F: Fn(f64) + Send + Sync,
    {
        let dst_epsg = target_grid.crs.epsg.ok_or_else(|| {
            RasterError::Other(
                "reproject_to_match_grid requires target grid CRS EPSG in target_grid.crs.epsg"
                    .to_string(),
            )
        })?;

        let opts = ReprojectOptions::new(dst_epsg, resample)
            .with_size(target_grid.cols, target_grid.rows)
            .with_extent(target_grid.extent());

        self.reproject_with_options_and_progress(&opts, progress)
    }

    /// Reproject this raster using another raster's CRS, resolution, and snap origin.
    ///
    /// Unlike [`Raster::reproject_to_match_grid`], this keeps the destination
    /// extent auto-derived from the transformed source footprint, while aligning
    /// that extent to the reference grid's origin and pixel size.
    ///
    /// # Errors
    /// Returns an error if `reference_grid.crs.epsg` is missing or unsupported.
    pub fn reproject_to_match_resolution(
        &self,
        reference_grid: &Raster,
        resample: ResampleMethod,
    ) -> Result<Raster> {
        let dst_epsg = reference_grid.crs.epsg.ok_or_else(|| {
            RasterError::Other(
                "reproject_to_match_resolution requires reference grid CRS EPSG in reference_grid.crs.epsg"
                    .to_string(),
            )
        })?;

        let opts = ReprojectOptions::new(dst_epsg, resample)
            .with_resolution(reference_grid.cell_size_x, reference_grid.cell_size_y)
            .with_snap_origin(reference_grid.x_min, reference_grid.y_min);

        self.reproject_with_options(&opts)
    }

    /// Reproject this raster while matching a reference raster's resolution
    /// and snap origin, emitting progress updates in [0, 1].
    pub fn reproject_to_match_resolution_and_progress<F>(
        &self,
        reference_grid: &Raster,
        resample: ResampleMethod,
        progress: F,
    ) -> Result<Raster>
    where
        F: Fn(f64) + Send + Sync,
    {
        let dst_epsg = reference_grid.crs.epsg.ok_or_else(|| {
            RasterError::Other(
                "reproject_to_match_resolution requires reference grid CRS EPSG in reference_grid.crs.epsg"
                    .to_string(),
            )
        })?;

        let opts = ReprojectOptions::new(dst_epsg, resample)
            .with_resolution(reference_grid.cell_size_x, reference_grid.cell_size_y)
            .with_snap_origin(reference_grid.x_min, reference_grid.y_min);

        self.reproject_with_options_and_progress(&opts, progress)
    }

    /// Reproject this raster to an explicit destination EPSG while matching a
    /// reference raster's resolution and snap origin.
    ///
    /// If `reference_grid` is in a different CRS than `dst_epsg`, the
    /// reference snap origin and per-axis cell sizes are transformed to
    /// destination CRS using local axis steps at the reference origin.
    ///
    /// # Errors
    /// Returns an error if reference/destination EPSG values are missing or
    /// unsupported, or if transformed reference resolution is invalid.
    pub fn reproject_to_match_resolution_in_epsg(
        &self,
        dst_epsg: u32,
        reference_grid: &Raster,
        resample: ResampleMethod,
    ) -> Result<Raster> {
        let reference_epsg = reference_grid.crs.epsg.ok_or_else(|| {
            RasterError::Other(
                "reproject_to_match_resolution_in_epsg requires reference grid CRS EPSG in reference_grid.crs.epsg"
                    .to_string(),
            )
        })?;

        let (snap_x, snap_y, x_res, y_res) = if reference_epsg == dst_epsg {
            (
                reference_grid.x_min,
                reference_grid.y_min,
                reference_grid.cell_size_x,
                reference_grid.cell_size_y,
            )
        } else {
            let ref_crs = Crs::from_epsg(reference_epsg).map_err(|e| {
                RasterError::Other(format!(
                    "reference EPSG {reference_epsg} is not supported: {e}"
                ))
            })?;
            let dst_crs = Crs::from_epsg(dst_epsg).map_err(|e| {
                RasterError::Other(format!("destination EPSG {dst_epsg} is not supported: {e}"))
            })?;

            let ox = reference_grid.x_min;
            let oy = reference_grid.y_min;
            let (sx, sy) = ref_crs.transform_to(ox, oy, &dst_crs).map_err(|e| {
                RasterError::Other(format!(
                    "failed to transform reference snap origin to EPSG:{dst_epsg}: {e}"
                ))
            })?;
            let (sx_dx, sy_dx) = ref_crs
                .transform_to(ox + reference_grid.cell_size_x, oy, &dst_crs)
                .map_err(|e| {
                    RasterError::Other(format!(
                        "failed to transform reference X-step to EPSG:{dst_epsg}: {e}"
                    ))
                })?;
            let (sx_dy, sy_dy) = ref_crs
                .transform_to(ox, oy + reference_grid.cell_size_y, &dst_crs)
                .map_err(|e| {
                    RasterError::Other(format!(
                        "failed to transform reference Y-step to EPSG:{dst_epsg}: {e}"
                    ))
                })?;

            let rx = (sx_dx - sx).hypot(sy_dx - sy);
            let ry = (sx_dy - sx).hypot(sy_dy - sy);
            if !rx.is_finite() || !ry.is_finite() || rx <= 0.0 || ry <= 0.0 {
                return Err(RasterError::Other(
                    "invalid transformed reference resolution while matching destination EPSG"
                        .to_string(),
                ));
            }
            (sx, sy, rx, ry)
        };

        let opts = ReprojectOptions::new(dst_epsg, resample)
            .with_resolution(x_res, y_res)
            .with_snap_origin(snap_x, snap_y);

        self.reproject_with_options(&opts)
    }

    /// Reproject this raster to an explicit destination EPSG while matching a
    /// reference raster's transformed resolution/snap, emitting progress in [0, 1].
    pub fn reproject_to_match_resolution_in_epsg_and_progress<F>(
        &self,
        dst_epsg: u32,
        reference_grid: &Raster,
        resample: ResampleMethod,
        progress: F,
    ) -> Result<Raster>
    where
        F: Fn(f64) + Send + Sync,
    {
        let reference_epsg = reference_grid.crs.epsg.ok_or_else(|| {
            RasterError::Other(
                "reproject_to_match_resolution_in_epsg requires reference grid CRS EPSG in reference_grid.crs.epsg"
                    .to_string(),
            )
        })?;

        let (snap_x, snap_y, x_res, y_res) = if reference_epsg == dst_epsg {
            (
                reference_grid.x_min,
                reference_grid.y_min,
                reference_grid.cell_size_x,
                reference_grid.cell_size_y,
            )
        } else {
            let ref_crs = Crs::from_epsg(reference_epsg).map_err(|e| {
                RasterError::Other(format!(
                    "reference EPSG {reference_epsg} is not supported: {e}"
                ))
            })?;
            let dst_crs = Crs::from_epsg(dst_epsg).map_err(|e| {
                RasterError::Other(format!("destination EPSG {dst_epsg} is not supported: {e}"))
            })?;

            let ox = reference_grid.x_min;
            let oy = reference_grid.y_min;
            let (sx, sy) = ref_crs.transform_to(ox, oy, &dst_crs).map_err(|e| {
                RasterError::Other(format!(
                    "failed to transform reference snap origin to EPSG:{dst_epsg}: {e}"
                ))
            })?;
            let (sx_dx, sy_dx) = ref_crs
                .transform_to(ox + reference_grid.cell_size_x, oy, &dst_crs)
                .map_err(|e| {
                    RasterError::Other(format!(
                        "failed to transform reference X-step to EPSG:{dst_epsg}: {e}"
                    ))
                })?;
            let (sx_dy, sy_dy) = ref_crs
                .transform_to(ox, oy + reference_grid.cell_size_y, &dst_crs)
                .map_err(|e| {
                    RasterError::Other(format!(
                        "failed to transform reference Y-step to EPSG:{dst_epsg}: {e}"
                    ))
                })?;

            let rx = (sx_dx - sx).hypot(sy_dx - sy);
            let ry = (sx_dy - sx).hypot(sy_dy - sy);
            if !rx.is_finite() || !ry.is_finite() || rx <= 0.0 || ry <= 0.0 {
                return Err(RasterError::Other(
                    "invalid transformed reference resolution while matching destination EPSG"
                        .to_string(),
                ));
            }
            (sx, sy, rx, ry)
        };

        let opts = ReprojectOptions::new(dst_epsg, resample)
            .with_resolution(x_res, y_res)
            .with_snap_origin(snap_x, snap_y);

        self.reproject_with_options_and_progress(&opts, progress)
    }

    fn reproject_internal(
        &self,
        src_crs: &Crs,
        dst_crs: &Crs,
        options: &ReprojectOptions,
        progress: Option<&(dyn Fn(f64) + Send + Sync)>,
    ) -> Result<Raster> {
        maybe_warn_area_of_use_mismatch(
            src_crs,
            dst_crs,
            self.extent(),
            options.warn_on_area_of_use_mismatch,
        );

        let src_extent = self.extent();
        let samples_per_edge = (self.cols.max(self.rows) / 32).clamp(8, 128);
        let base_extent = transformed_extent_from_boundary_samples(
            src_crs,
            dst_crs,
            src_extent,
            samples_per_edge,
            options.dst_epsg,
            options.antimeridian_policy,
            &options.epoch_transform,
        )?;
        let out_extent = options.extent.unwrap_or(base_extent);
        let width = out_extent.x_max - out_extent.x_min;
        let height = out_extent.y_max - out_extent.y_min;

        if !out_extent.x_min.is_finite()
            || !out_extent.x_max.is_finite()
            || !out_extent.y_min.is_finite()
            || !out_extent.y_max.is_finite()
            || width <= 0.0
            || height <= 0.0
        {
            return Err(RasterError::CorruptData(
                "invalid transformed extent produced during reprojection".to_string(),
            ));
        }

        let x_res = options.x_res.map(f64::abs);
        let y_res = options.y_res.map(f64::abs);
        if x_res.is_some_and(|v| !v.is_finite() || v <= 0.0)
            || y_res.is_some_and(|v| !v.is_finite() || v <= 0.0)
        {
            return Err(RasterError::CorruptData(
                "invalid reprojection resolution (x_res/y_res must be positive finite values)"
                    .to_string(),
            ));
        }

        let mut x_min = out_extent.x_min;
        let mut x_max = out_extent.x_max;
        let mut y_min = out_extent.y_min;
        let mut y_max = out_extent.y_max;

        let out_cols = match options.cols {
            Some(cols) => cols,
            None => match x_res {
                Some(rx) => {
                    if let Some(sx) = options.snap_x {
                        match options.grid_size_policy {
                            GridSizePolicy::Expand => {
                                x_min = snap_down_to_origin(x_min, sx, rx);
                                x_max = snap_up_to_origin(x_max, sx, rx);
                            }
                            GridSizePolicy::FitInside => {
                                x_min = snap_up_to_origin(x_min, sx, rx);
                                x_max = snap_down_to_origin(x_max, sx, rx);
                            }
                        }
                    }
                    let span = (x_max - x_min).max(0.0);
                    let cols = match options.grid_size_policy {
                        GridSizePolicy::Expand => (span / rx).ceil().max(1.0) as usize,
                        GridSizePolicy::FitInside => (span / rx).floor().max(1.0) as usize,
                    };
                    x_max = x_min + cols as f64 * rx;
                    cols
                }
                None => self.cols,
            },
        };
        let out_rows = match options.rows {
            Some(rows) => rows,
            None => match y_res {
                Some(ry) => {
                    if let Some(sy) = options.snap_y {
                        match options.grid_size_policy {
                            GridSizePolicy::Expand => {
                                y_min = snap_down_to_origin(y_min, sy, ry);
                                y_max = snap_up_to_origin(y_max, sy, ry);
                            }
                            GridSizePolicy::FitInside => {
                                y_min = snap_up_to_origin(y_min, sy, ry);
                                y_max = snap_down_to_origin(y_max, sy, ry);
                            }
                        }
                    }
                    let span = (y_max - y_min).max(0.0);
                    let rows = match options.grid_size_policy {
                        GridSizePolicy::Expand => (span / ry).ceil().max(1.0) as usize,
                        GridSizePolicy::FitInside => (span / ry).floor().max(1.0) as usize,
                    };
                    y_max = y_min + rows as f64 * ry;
                    rows
                }
                None => self.rows,
            },
        };

        let out_extent = Extent {
            x_min,
            y_min,
            x_max,
            y_max,
        };

        if out_cols == 0 || out_rows == 0 {
            return Err(RasterError::InvalidDimensions {
                cols: out_cols,
                rows: out_rows,
            });
        }

        let cfg = RasterConfig {
            cols: out_cols,
            rows: out_rows,
            bands: self.bands,
            x_min: out_extent.x_min,
            y_min: out_extent.y_min,
            cell_size: (out_extent.x_max - out_extent.x_min) / out_cols as f64,
            cell_size_y: Some((out_extent.y_max - out_extent.y_min) / out_rows as f64),
            nodata: self.nodata,
            data_type: self.data_type,
            crs: CrsInfo::from_epsg(options.dst_epsg),
            metadata: self.metadata.clone(),
        };
        let mut out = Raster::new(cfg);

        let out_y_max = out.y_max();
        let footprint_ring =
            if options.destination_footprint == DestinationFootprint::SourceBoundary {
                let ring = transformed_boundary_ring_samples(
                    src_crs,
                    dst_crs,
                    src_extent,
                    samples_per_edge,
                    options.dst_epsg,
                    options.antimeridian_policy,
                    &options.epoch_transform,
                )?;
                if ring.len() >= 3 {
                    Some(ring)
                } else {
                    None
                }
            } else {
                None
            };

        let total_rows = out.rows;
        let completed_rows = AtomicUsize::new(0);
        let rows_data: Vec<Vec<Option<f64>>> = (0..out.rows as isize)
            .into_par_iter()
            .map(|row| {
                let mut row_values = vec![None; out.cols * out.bands];
                let y = out_y_max - (row as f64 + 0.5) * out.cell_size_y;

                // Collect per-row coordinates that pass the footprint check, then
                // transform them all in one batch call so the SIMD fast paths in
                // transform_to_batch can vectorize across the full row width.
                let mut batch_coords: Vec<(f64, f64)> = Vec::with_capacity(out.cols);
                let mut batch_cols: Vec<usize> = Vec::with_capacity(out.cols);
                for col in 0..out.cols as isize {
                    let x = out.x_min + (col as f64 + 0.5) * out.cell_size_x;
                    if let Some(ring) = &footprint_ring {
                        if !point_in_polygon(x, y, ring) {
                            continue;
                        }
                    }
                    batch_coords.push((x, y));
                    batch_cols.push(col as usize);
                }

                let epoch_routing_requested = options
                    .epoch_transform
                    .coordinate_epoch_decimal_year
                    .is_some()
                    || options
                        .epoch_transform
                        .source_reference_epoch_decimal_year
                        .is_some()
                    || options
                        .epoch_transform
                        .target_reference_epoch_decimal_year
                        .is_some()
                    || options.epoch_transform.operation_code.is_some()
                    || !options.epoch_transform.prefer_official_operation
                    || matches!(
                        options.epoch_transform.epoch_policy,
                        EpochPolicy::AllowStaticFallback
                    );

                if !epoch_routing_requested {
                    // Single batch CRS transform for all eligible pixels in this row.
                    // Successful transforms overwrite batch_coords in-place; errors are
                    // returned as Some(Err(_)) at the corresponding index.
                    let errors = dst_crs.transform_to_batch(&mut batch_coords, src_crs);

                    for (i, &col) in batch_cols.iter().enumerate() {
                        if errors[i].is_some() {
                            continue;
                        }
                        let (sx, sy) = batch_coords[i];
                        for band in 0..out.bands as isize {
                            if let Some(v) = self.sample_world(
                                band,
                                sx,
                                sy,
                                options.resample,
                                options.nodata_policy,
                            ) {
                                row_values[band as usize * out.cols + col] = Some(v);
                            }
                        }
                    }
                } else {
                    for (i, &col) in batch_cols.iter().enumerate() {
                        let Ok((sx, sy)) = transform_xy_with_epoch_options(
                            src_crs,
                            dst_crs,
                            batch_coords[i].0,
                            batch_coords[i].1,
                            &options.epoch_transform,
                        ) else {
                            continue;
                        };
                        for band in 0..out.bands as isize {
                            if let Some(v) = self.sample_world(
                                band,
                                sx,
                                sy,
                                options.resample,
                                options.nodata_policy,
                            ) {
                                row_values[band as usize * out.cols + col] = Some(v);
                            }
                        }
                    }
                }

                if let Some(progress_cb) = progress {
                    let done = completed_rows.fetch_add(1, Ordering::Relaxed) + 1;
                    progress_cb(done as f64 / total_rows as f64);
                }

                row_values
            })
            .collect();

        for (row, row_values) in rows_data.into_iter().enumerate() {
            let row = row as isize;
            for band in 0..out.bands {
                for col in 0..out.cols {
                    if let Some(v) = row_values[band * out.cols + col] {
                        out.set_unchecked(band as isize, row, col as isize, v);
                    }
                }
            }
        }

        if let Some(progress_cb) = progress {
            progress_cb(1.0);
        }

        Ok(out)
    }

    fn source_crs_for_reprojection(&self) -> Result<Crs> {
        if let Some(src_epsg) = self.crs.epsg {
            return Crs::from_epsg(src_epsg).map_err(|e| {
                RasterError::Other(format!("source EPSG {src_epsg} is not supported: {e}"))
            });
        }

        if let Some(wkt) = self.crs.wkt.as_deref() {
            let trimmed = wkt.trim();
            if !trimmed.is_empty() {
                return wbprojection::from_wkt(trimmed).map_err(|e| {
                    RasterError::Other(format!("source CRS WKT is not supported: {e}"))
                });
            }
        }

        if let Some(proj) = self.crs.proj4.as_deref() {
            let trimmed = proj.trim();
            if !trimmed.is_empty() {
                return from_proj_string(trimmed).map_err(|e| {
                    RasterError::Other(format!("source CRS PROJ string is not supported: {e}"))
                });
            }
        }

        Err(RasterError::Other(
            "reproject_to_epsg requires source CRS metadata (EPSG, WKT, or PROJ string)"
                .to_string(),
        ))
    }

    /// Sample a raster value at world coordinates using the selected resampling method.
    pub fn sample_world(
        &self,
        band: isize,
        x: f64,
        y: f64,
        method: ResampleMethod,
        nodata_policy: NodataPolicy,
    ) -> Option<f64> {
        let col_f = (x - self.x_min) / self.cell_size_x - 0.5;
        let row_f = (self.y_max() - y) / self.cell_size_y - 0.5;
        match method {
            ResampleMethod::Nearest => self.sample_nearest_pixel(band, col_f, row_f),
            ResampleMethod::Bilinear => match nodata_policy {
                NodataPolicy::Strict => self.sample_bilinear_strict_pixel(band, col_f, row_f),
                NodataPolicy::PartialKernel => {
                    self.sample_bilinear_partial_pixel(band, col_f, row_f)
                }
                NodataPolicy::Fill => self
                    .sample_bilinear_strict_pixel(band, col_f, row_f)
                    .or_else(|| self.sample_nearest_pixel(band, col_f, row_f)),
            },
            ResampleMethod::Cubic => match nodata_policy {
                NodataPolicy::Strict => self.sample_cubic_strict_pixel(band, col_f, row_f),
                NodataPolicy::PartialKernel => self.sample_cubic_partial_pixel(band, col_f, row_f),
                NodataPolicy::Fill => self
                    .sample_cubic_strict_pixel(band, col_f, row_f)
                    .or_else(|| self.sample_nearest_pixel(band, col_f, row_f)),
            },
            ResampleMethod::Lanczos => match nodata_policy {
                NodataPolicy::Strict => self.sample_lanczos_strict_pixel(band, col_f, row_f),
                NodataPolicy::PartialKernel => {
                    self.sample_lanczos_partial_pixel(band, col_f, row_f)
                }
                NodataPolicy::Fill => self
                    .sample_lanczos_strict_pixel(band, col_f, row_f)
                    .or_else(|| self.sample_nearest_pixel(band, col_f, row_f)),
            },
            ResampleMethod::Average => {
                self.sample_window_stat_pixel(band, col_f, row_f, WindowStat::Mean, nodata_policy)
            }
            ResampleMethod::Min => {
                self.sample_window_stat_pixel(band, col_f, row_f, WindowStat::Min, nodata_policy)
            }
            ResampleMethod::Max => {
                self.sample_window_stat_pixel(band, col_f, row_f, WindowStat::Max, nodata_policy)
            }
            ResampleMethod::Mode => {
                self.sample_window_stat_pixel(band, col_f, row_f, WindowStat::Mode, nodata_policy)
            }
            ResampleMethod::Median => {
                self.sample_window_stat_pixel(band, col_f, row_f, WindowStat::Median, nodata_policy)
            }
            ResampleMethod::StdDev => {
                self.sample_window_stat_pixel(band, col_f, row_f, WindowStat::StdDev, nodata_policy)
            }
        }
    }

    fn sample_window_stat_pixel(
        &self,
        band: isize,
        col_f: f64,
        row_f: f64,
        stat: WindowStat,
        nodata_policy: NodataPolicy,
    ) -> Option<f64> {
        if !col_f.is_finite() || !row_f.is_finite() {
            return None;
        }

        let center_col = col_f.round() as isize;
        let center_row = row_f.round() as isize;
        let mut values = Vec::with_capacity(9);
        let mut valid_count = 0usize;

        for dy in -1..=1 {
            for dx in -1..=1 {
                let c = center_col + dx;
                let r = center_row + dy;
                if c < 0 || r < 0 || c >= self.cols as isize || r >= self.rows as isize {
                    continue;
                }
                if let Some(v) = self.get_opt(band, r, c) {
                    values.push(v);
                    valid_count += 1;
                }
            }
        }

        match nodata_policy {
            NodataPolicy::Strict if valid_count < 9 => None,
            NodataPolicy::PartialKernel | NodataPolicy::Strict => {
                reduce_window_values(&values, stat)
            }
            NodataPolicy::Fill => reduce_window_values(&values, stat)
                .or_else(|| self.sample_nearest_pixel(band, col_f, row_f)),
        }
    }

    fn sample_nearest_pixel(&self, band: isize, col_f: f64, row_f: f64) -> Option<f64> {
        if !col_f.is_finite() || !row_f.is_finite() {
            return None;
        }
        let col = col_f.round() as isize;
        let row = row_f.round() as isize;
        self.get_opt(band, row, col)
    }

    fn sample_bilinear_strict_pixel(&self, band: isize, col_f: f64, row_f: f64) -> Option<f64> {
        if !col_f.is_finite() || !row_f.is_finite() {
            return None;
        }
        let c0 = col_f.floor() as isize;
        let r0 = row_f.floor() as isize;
        let c1 = c0 + 1;
        let r1 = r0 + 1;
        if c0 < 0 || r0 < 0 || c1 >= self.cols as isize || r1 >= self.rows as isize {
            return None;
        }

        let tx = col_f - c0 as f64;
        let ty = row_f - r0 as f64;

        if let Some(values) = self.data_f64() {
            return self.sample_bilinear_strict_simd_f64(values, band, r0, c0, tx, ty);
        }
        if let Some(values) = self.data_f32() {
            return self.sample_bilinear_strict_simd_f32(values, band, r0, c0, tx, ty);
        }

        let q00 = self.get_opt(band, r0, c0)?;
        let q10 = self.get_opt(band, r0, c1)?;
        let q01 = self.get_opt(band, r1, c0)?;
        let q11 = self.get_opt(band, r1, c1)?;

        let a = q00 * (1.0 - tx) + q10 * tx;
        let b = q01 * (1.0 - tx) + q11 * tx;
        Some(a * (1.0 - ty) + b * ty)
    }

    #[inline]
    fn sample_bilinear_strict_simd_f64(
        &self,
        values: &[f64],
        band: isize,
        r0: isize,
        c0: isize,
        tx: f64,
        ty: f64,
    ) -> Option<f64> {
        let band_stride = self.rows * self.cols;
        let base = band as usize * band_stride + r0 as usize * self.cols + c0 as usize;
        let q00 = values[base];
        let q10 = values[base + 1];
        let q01 = values[base + self.cols];
        let q11 = values[base + self.cols + 1];

        if self.is_nodata(q00) || self.is_nodata(q10) || self.is_nodata(q01) || self.is_nodata(q11)
        {
            return None;
        }

        let weights = f64x4::new([
            (1.0 - tx) * (1.0 - ty),
            tx * (1.0 - ty),
            (1.0 - tx) * ty,
            tx * ty,
        ]);
        let vals = f64x4::new([q00, q10, q01, q11]);
        let weighted = <[f64; 4]>::from(vals * weights);
        Some(weighted.into_iter().sum())
    }

    #[inline]
    fn sample_bilinear_strict_simd_f32(
        &self,
        values: &[f32],
        band: isize,
        r0: isize,
        c0: isize,
        tx: f64,
        ty: f64,
    ) -> Option<f64> {
        let band_stride = self.rows * self.cols;
        let base = band as usize * band_stride + r0 as usize * self.cols + c0 as usize;
        let q00 = values[base] as f64;
        let q10 = values[base + 1] as f64;
        let q01 = values[base + self.cols] as f64;
        let q11 = values[base + self.cols + 1] as f64;

        if self.is_nodata(q00) || self.is_nodata(q10) || self.is_nodata(q01) || self.is_nodata(q11)
        {
            return None;
        }

        let weights = f64x4::new([
            (1.0 - tx) * (1.0 - ty),
            tx * (1.0 - ty),
            (1.0 - tx) * ty,
            tx * ty,
        ]);
        let vals = f64x4::new([q00, q10, q01, q11]);
        let weighted = <[f64; 4]>::from(vals * weights);
        Some(weighted.into_iter().sum())
    }

    fn sample_bilinear_partial_pixel(&self, band: isize, col_f: f64, row_f: f64) -> Option<f64> {
        if !col_f.is_finite() || !row_f.is_finite() {
            return None;
        }
        let c0 = col_f.floor() as isize;
        let r0 = row_f.floor() as isize;
        let c1 = c0 + 1;
        let r1 = r0 + 1;

        let tx = col_f - c0 as f64;
        let ty = row_f - r0 as f64;

        let neighbors = [
            (c0, r0, (1.0 - tx) * (1.0 - ty)),
            (c1, r0, tx * (1.0 - ty)),
            (c0, r1, (1.0 - tx) * ty),
            (c1, r1, tx * ty),
        ];

        let mut sum = 0.0;
        let mut wsum = 0.0;
        for (c, r, w) in neighbors {
            if w <= 0.0 || c < 0 || r < 0 || c >= self.cols as isize || r >= self.rows as isize {
                continue;
            }
            if let Some(v) = self.get_opt(band, r, c) {
                sum += v * w;
                wsum += w;
            }
        }

        if wsum > 0.0 {
            Some(sum / wsum)
        } else {
            None
        }
    }

    fn sample_cubic_strict_pixel(&self, band: isize, col_f: f64, row_f: f64) -> Option<f64> {
        if !col_f.is_finite() || !row_f.is_finite() {
            return None;
        }
        let c1 = col_f.floor() as isize;
        let r1 = row_f.floor() as isize;
        if c1 - 1 < 0 || r1 - 1 < 0 || c1 + 2 >= self.cols as isize || r1 + 2 >= self.rows as isize
        {
            return None;
        }

        let tx = col_f - c1 as f64;
        let ty = row_f - r1 as f64;
        let wx = cubic_bspline_weights(tx);
        let wy = cubic_bspline_weights(ty);

        // Use SIMD-accelerated 4×4 dot product
        self.sample_cubic_simd_kernel(&wx, &wy, band, c1 - 1, r1 - 1)
    }

    /// SIMD-accelerated 4×4 kernel dot product for bicubic resampling.
    /// Assumes all 16 pixels are in-bounds and valid.
    #[inline]
    fn sample_cubic_simd_kernel(
        &self,
        wx: &[f64; 4],
        wy: &[f64; 4],
        band: isize,
        c_start: isize,
        r_start: isize,
    ) -> Option<f64> {
        // Process 4 rows, 4 pixels per row, computing weighted sum using SIMD for horizontal accumulation.
        // Load row-wise and multiply by row weights.
        let mut row_sums = [0.0_f64; 4];

        for (j, _wyj) in wy.iter().enumerate() {
            let rr = r_start + j as isize;
            let mut row_sum = 0.0;

            // Load 4 pixels in row and compute weighted sum
            for (i, wxi) in wx.iter().enumerate() {
                let cc = c_start + i as isize;
                let v = self.get_opt(band, rr, cc)?;
                row_sum += v * *wxi;
            }

            row_sums[j] = row_sum;
        }

        // Horizontal reduction: multiply by row weights and sum
        let mut sum = 0.0;
        for (j, wyj) in wy.iter().enumerate() {
            sum += row_sums[j] * *wyj;
        }

        Some(sum)
    }

    fn sample_cubic_partial_pixel(&self, band: isize, col_f: f64, row_f: f64) -> Option<f64> {
        if !col_f.is_finite() || !row_f.is_finite() {
            return None;
        }
        let c1 = col_f.floor() as isize;
        let r1 = row_f.floor() as isize;
        let tx = col_f - c1 as f64;
        let ty = row_f - r1 as f64;
        let wx = cubic_bspline_weights(tx);
        let wy = cubic_bspline_weights(ty);

        let mut sum = 0.0;
        let mut wsum = 0.0;

        for (j, wyj) in wy.iter().enumerate() {
            let rr = clamp_isize(r1 + j as isize - 1, 0, self.rows as isize - 1);
            if *wyj <= 0.0 {
                continue;
            }
            for (i, wxi) in wx.iter().enumerate() {
                let cc = clamp_isize(c1 + i as isize - 1, 0, self.cols as isize - 1);
                let w = *wxi * *wyj;
                if w <= 0.0 {
                    continue;
                }
                if let Some(v) = self.get_opt(band, rr, cc) {
                    sum += v * w;
                    wsum += w;
                }
            }
        }

        if wsum > 0.0 {
            Some(sum / wsum)
        } else {
            None
        }
    }

    fn sample_lanczos_strict_pixel(&self, band: isize, col_f: f64, row_f: f64) -> Option<f64> {
        if !col_f.is_finite() || !row_f.is_finite() {
            return None;
        }

        let c0 = col_f.floor() as isize;
        let r0 = row_f.floor() as isize;
        if c0 - 2 < 0 || r0 - 2 < 0 || c0 + 3 >= self.cols as isize || r0 + 3 >= self.rows as isize
        {
            return None;
        }

        let wx = lanczos3_weights(col_f, c0);
        let wy = lanczos3_weights(row_f, r0);

        if let Some(values) = self.data_f64() {
            return self.sample_lanczos_strict_simd_f64(values, band, c0, r0, &wx, &wy);
        }
        if let Some(values) = self.data_f32() {
            return self.sample_lanczos_strict_simd_f32(values, band, c0, r0, &wx, &wy);
        }

        let mut sum = 0.0;
        let mut wsum = 0.0;
        for (j, wyj) in wy.iter().enumerate() {
            let rr = r0 + j as isize - 2;
            for (i, wxi) in wx.iter().enumerate() {
                let cc = c0 + i as isize - 2;
                let v = self.get_opt(band, rr, cc)?;
                let w = *wxi * *wyj;
                sum += v * w;
                wsum += w;
            }
        }

        if wsum.abs() > 1e-12 {
            Some(sum / wsum)
        } else {
            None
        }
    }

    #[inline]
    fn sample_lanczos_strict_simd_f64(
        &self,
        values: &[f64],
        band: isize,
        c0: isize,
        r0: isize,
        wx: &[f64; 6],
        wy: &[f64; 6],
    ) -> Option<f64> {
        let band_stride = self.rows * self.cols;
        let base = band as usize * band_stride;

        let wx0 = f64x4::new([wx[0], wx[1], wx[2], wx[3]]);
        let wx1 = f64x4::new([wx[4], wx[5], 0.0, 0.0]);
        let wx_sum: f64 = wx.iter().copied().sum();

        let mut sum = 0.0;
        let mut wsum = 0.0;
        for (j, wyj) in wy.iter().enumerate() {
            let rr = (r0 + j as isize - 2) as usize;
            let cc = (c0 - 2) as usize;
            let row_offset = base + rr * self.cols + cc;

            let v = [
                values[row_offset],
                values[row_offset + 1],
                values[row_offset + 2],
                values[row_offset + 3],
                values[row_offset + 4],
                values[row_offset + 5],
            ];
            if v.into_iter().any(|cell| self.is_nodata(cell)) {
                return None;
            }

            let v0 = f64x4::new([v[0], v[1], v[2], v[3]]);
            let v1 = f64x4::new([v[4], v[5], 0.0, 0.0]);
            let d0 = <[f64; 4]>::from(v0 * wx0);
            let d1 = <[f64; 4]>::from(v1 * wx1);
            let row_sum = d0.into_iter().sum::<f64>() + d1.into_iter().sum::<f64>();
            sum += row_sum * *wyj;
            wsum += wx_sum * *wyj;
        }

        if wsum.abs() > 1e-12 {
            Some(sum / wsum)
        } else {
            None
        }
    }

    #[inline]
    fn sample_lanczos_strict_simd_f32(
        &self,
        values: &[f32],
        band: isize,
        c0: isize,
        r0: isize,
        wx: &[f64; 6],
        wy: &[f64; 6],
    ) -> Option<f64> {
        let band_stride = self.rows * self.cols;
        let base = band as usize * band_stride;

        let wx0 = f64x4::new([wx[0], wx[1], wx[2], wx[3]]);
        let wx1 = f64x4::new([wx[4], wx[5], 0.0, 0.0]);
        let wx_sum: f64 = wx.iter().copied().sum();

        let mut sum = 0.0;
        let mut wsum = 0.0;
        for (j, wyj) in wy.iter().enumerate() {
            let rr = (r0 + j as isize - 2) as usize;
            let cc = (c0 - 2) as usize;
            let row_offset = base + rr * self.cols + cc;

            let v = [
                values[row_offset] as f64,
                values[row_offset + 1] as f64,
                values[row_offset + 2] as f64,
                values[row_offset + 3] as f64,
                values[row_offset + 4] as f64,
                values[row_offset + 5] as f64,
            ];
            if v.into_iter().any(|cell| self.is_nodata(cell)) {
                return None;
            }

            let v0 = f64x4::new([v[0], v[1], v[2], v[3]]);
            let v1 = f64x4::new([v[4], v[5], 0.0, 0.0]);
            let d0 = <[f64; 4]>::from(v0 * wx0);
            let d1 = <[f64; 4]>::from(v1 * wx1);
            let row_sum = d0.into_iter().sum::<f64>() + d1.into_iter().sum::<f64>();
            sum += row_sum * *wyj;
            wsum += wx_sum * *wyj;
        }

        if wsum.abs() > 1e-12 {
            Some(sum / wsum)
        } else {
            None
        }
    }

    fn sample_lanczos_partial_pixel(&self, band: isize, col_f: f64, row_f: f64) -> Option<f64> {
        if !col_f.is_finite() || !row_f.is_finite() {
            return None;
        }

        let c0 = col_f.floor() as isize;
        let r0 = row_f.floor() as isize;
        let wx = lanczos3_weights(col_f, c0);
        let wy = lanczos3_weights(row_f, r0);

        let mut sum = 0.0;
        let mut wsum = 0.0;

        for (j, wyj) in wy.iter().enumerate() {
            let rr = clamp_isize(r0 + j as isize - 2, 0, self.rows as isize - 1);
            for (i, wxi) in wx.iter().enumerate() {
                let cc = clamp_isize(c0 + i as isize - 2, 0, self.cols as isize - 1);
                let w = *wxi * *wyj;
                if w == 0.0 {
                    continue;
                }
                if let Some(v) = self.get_opt(band, rr, cc) {
                    sum += v * w;
                    wsum += w;
                }
            }
        }

        if wsum.abs() > 1e-12 {
            Some(sum / wsum)
        } else {
            None
        }
    }

    // ─── Statistics ───────────────────────────────────────────────────────

    fn stats_accumulator_range_with_mode(
        &self,
        start: usize,
        end: usize,
        mode: StatisticsComputationMode,
    ) -> StatsAccumulator {
        match mode {
            StatisticsComputationMode::Auto | StatisticsComputationMode::Simd => {
                self.stats_accumulator_range_simd(start, end)
            }
            StatisticsComputationMode::Scalar => self.stats_accumulator_range_scalar(start, end),
        }
    }

    fn stats_accumulator_range_scalar(&self, start: usize, end: usize) -> StatsAccumulator {
        let mut accumulator = StatsAccumulator::default();

        for idx in start..end {
            let value = self.data.get_f64(idx);
            if self.is_nodata(value) {
                accumulator.nodata_count += 1;
            } else {
                accumulator.min = accumulator.min.min(value);
                accumulator.max = accumulator.max.max(value);
                accumulator.sum += value;
                accumulator.sum_sq += value * value;
                accumulator.valid_count += 1;
            }
        }

        accumulator
    }

    /// SIMD-accelerated stats accumulation for a range of indices.
    /// Processes groups of 4 values in parallel where possible, falling back to scalar for remainder.
    /// This is automatically used by the statistics pipeline for better performance.
    fn stats_accumulator_range_simd(&self, start: usize, end: usize) -> StatsAccumulator {
        if let Some(values) = self.data_f64() {
            return self.stats_accumulator_range_simd_f64(values, start, end);
        }
        if let Some(values) = self.data_f32() {
            return self.stats_accumulator_range_simd_f32(values, start, end);
        }

        self.stats_accumulator_range_scalar(start, end)
    }

    fn stats_accumulator_range_simd_f64(
        &self,
        values: &[f64],
        start: usize,
        end: usize,
    ) -> StatsAccumulator {
        let mut accumulator = StatsAccumulator::default();
        let nd = self.nodata;

        let simd_end = start + ((end - start) / 4) * 4;
        let mut simd_min = f64x4::splat(f64::INFINITY);
        let mut simd_max = f64x4::splat(f64::NEG_INFINITY);
        let mut simd_sum = f64x4::splat(0.0);
        let mut simd_sum_sq = f64x4::splat(0.0);
        let zero_v = f64x4::splat(0.0);
        let nd_v = f64x4::splat(nd);
        let inf_v = f64x4::splat(f64::INFINITY);
        let neg_inf_v = f64x4::splat(f64::NEG_INFINITY);

        let mut idx = start;
        while idx < simd_end {
            let chunk = &values[idx..idx + 4];
            let values = f64x4::new([chunk[0], chunk[1], chunk[2], chunk[3]]);

            let not_nodata = values.simd_ne(nd_v);

            let values_for_min = not_nodata.blend(values, inf_v);
            let values_for_max = not_nodata.blend(values, neg_inf_v);
            simd_min = simd_min.min(values_for_min);
            simd_max = simd_max.max(values_for_max);

            let masked_values = not_nodata.blend(values, zero_v);
            simd_sum = simd_sum + masked_values;
            simd_sum_sq = simd_sum_sq + masked_values * masked_values;

            for &val in chunk {
                if val == nd {
                    accumulator.nodata_count += 1;
                } else {
                    accumulator.valid_count += 1;
                }
            }

            idx += 4;
        }

        let sum_arr = <[f64; 4]>::from(simd_sum);
        let sum_sq_arr = <[f64; 4]>::from(simd_sum_sq);
        let min_arr = <[f64; 4]>::from(simd_min);
        let max_arr = <[f64; 4]>::from(simd_max);

        for i in 0..4 {
            accumulator.sum += sum_arr[i];
            accumulator.sum_sq += sum_sq_arr[i];
            accumulator.min = accumulator.min.min(min_arr[i]);
            accumulator.max = accumulator.max.max(max_arr[i]);
        }

        for &value in &values[simd_end..end] {
            if value == nd {
                accumulator.nodata_count += 1;
            } else {
                accumulator.min = accumulator.min.min(value);
                accumulator.max = accumulator.max.max(value);
                accumulator.sum += value;
                accumulator.sum_sq += value * value;
                accumulator.valid_count += 1;
            }
        }

        accumulator
    }

    fn stats_accumulator_range_simd_f32(
        &self,
        values: &[f32],
        start: usize,
        end: usize,
    ) -> StatsAccumulator {
        let mut accumulator = StatsAccumulator::default();
        let nd = self.nodata as f32;

        let simd_end = start + ((end - start) / 4) * 4;
        let mut simd_min = f64x4::splat(f64::INFINITY);
        let mut simd_max = f64x4::splat(f64::NEG_INFINITY);
        let mut simd_sum = f64x4::splat(0.0);
        let mut simd_sum_sq = f64x4::splat(0.0);
        let zero_v = f64x4::splat(0.0);
        let nd_v = f64x4::splat(nd as f64);
        let inf_v = f64x4::splat(f64::INFINITY);
        let neg_inf_v = f64x4::splat(f64::NEG_INFINITY);

        let mut idx = start;
        while idx < simd_end {
            let chunk = &values[idx..idx + 4];
            let values = f64x4::new([
                chunk[0] as f64,
                chunk[1] as f64,
                chunk[2] as f64,
                chunk[3] as f64,
            ]);

            let not_nodata = values.simd_ne(nd_v);
            let values_for_min = not_nodata.blend(values, inf_v);
            let values_for_max = not_nodata.blend(values, neg_inf_v);
            simd_min = simd_min.min(values_for_min);
            simd_max = simd_max.max(values_for_max);

            let masked_values = not_nodata.blend(values, zero_v);
            simd_sum = simd_sum + masked_values;
            simd_sum_sq = simd_sum_sq + masked_values * masked_values;

            for &val in chunk {
                if val == nd {
                    accumulator.nodata_count += 1;
                } else {
                    accumulator.valid_count += 1;
                }
            }

            idx += 4;
        }

        let sum_arr = <[f64; 4]>::from(simd_sum);
        let sum_sq_arr = <[f64; 4]>::from(simd_sum_sq);
        let min_arr = <[f64; 4]>::from(simd_min);
        let max_arr = <[f64; 4]>::from(simd_max);

        for i in 0..4 {
            accumulator.sum += sum_arr[i];
            accumulator.sum_sq += sum_sq_arr[i];
            accumulator.min = accumulator.min.min(min_arr[i]);
            accumulator.max = accumulator.max.max(max_arr[i]);
        }

        for &value in &values[simd_end..end] {
            if value == nd {
                accumulator.nodata_count += 1;
            } else {
                let value = value as f64;
                accumulator.min = accumulator.min.min(value);
                accumulator.max = accumulator.max.max(value);
                accumulator.sum += value;
                accumulator.sum_sq += value * value;
                accumulator.valid_count += 1;
            }
        }

        accumulator
    }

    fn statistics_for_index_range_with_mode(
        &self,
        start: usize,
        end: usize,
        mode: StatisticsComputationMode,
    ) -> Statistics {
        const PARALLEL_THRESHOLD: usize = 65_536;
        const CHUNK_SIZE: usize = 16_384;

        let span = end.saturating_sub(start);
        if span == 0 {
            return Statistics {
                min: 0.0,
                max: 0.0,
                mean: 0.0,
                std_dev: 0.0,
                valid_count: 0,
                nodata_count: 0,
            };
        }

        let total = if span < PARALLEL_THRESHOLD {
            self.stats_accumulator_range_with_mode(start, end, mode)
        } else {
            let chunk_starts: Vec<usize> = (start..end).step_by(CHUNK_SIZE).collect();
            let partials: Vec<StatsAccumulator> = chunk_starts
                .into_par_iter()
                .map(|chunk_start| {
                    let chunk_end = (chunk_start + CHUNK_SIZE).min(end);
                    self.stats_accumulator_range_with_mode(chunk_start, chunk_end, mode)
                })
                .collect();

            partials
                .into_iter()
                .fold(StatsAccumulator::default(), |mut lhs, rhs| {
                    lhs.merge(rhs);
                    lhs
                })
        };

        total.to_statistics()
    }

    /// Compute basic statistics over all valid (non-nodata) cells.
    pub fn statistics(&self) -> Statistics {
        self.statistics_with_mode(StatisticsComputationMode::Auto)
    }

    /// Compute basic statistics over all valid (non-nodata) cells using a selected computation path.
    pub fn statistics_with_mode(&self, mode: StatisticsComputationMode) -> Statistics {
        self.statistics_for_index_range_with_mode(0, self.data.len(), mode)
    }

    /// Compute basic statistics over all valid (non-nodata) cells in one band.
    pub fn statistics_band(&self, band: isize) -> Result<Statistics> {
        self.statistics_band_with_mode(band, StatisticsComputationMode::Auto)
    }

    /// Compute basic statistics over one band using a selected computation path.
    pub fn statistics_band_with_mode(
        &self,
        band: isize,
        mode: StatisticsComputationMode,
    ) -> Result<Statistics> {
        if band < 0 || band >= self.bands as isize {
            return Err(RasterError::OutOfBounds {
                band,
                col: 0,
                row: 0,
                bands: self.bands,
                cols: self.cols,
                rows: self.rows,
            });
        }

        let band = band as usize;
        let band_stride = self.rows * self.cols;
        let start = band * band_stride;
        let end = start + band_stride;

        Ok(self.statistics_for_index_range_with_mode(start, end, mode))
    }

    // ─── Row iteration ────────────────────────────────────────────────────

    /// Return a copy of one full band as row-major values.
    #[inline]
    pub fn band_slice(&self, band: isize) -> Vec<f64> {
        if band < 0 || band >= self.bands as isize {
            return Vec::new();
        }
        let band_stride = self.rows * self.cols;
        let start = band as usize * band_stride;
        (start..start + band_stride)
            .map(|i| self.data.get_f64(i))
            .collect()
    }

    /// Set one full band from row-major values.
    pub fn set_band_slice(&mut self, band: isize, values: &[f64]) -> Result<()> {
        let expected = self.rows * self.cols;
        if values.len() != expected {
            return Err(RasterError::InvalidDimensions {
                cols: self.cols,
                rows: values.len(),
            });
        }
        if band < 0 || band >= self.bands as isize {
            return Err(RasterError::OutOfBounds {
                band,
                col: 0,
                row: 0,
                bands: self.bands,
                cols: self.cols,
                rows: self.rows,
            });
        }
        let band_stride = self.rows * self.cols;
        let start = band as usize * band_stride;
        for (i, v) in values.iter().copied().enumerate() {
            self.data.set_f64(start + i, v);
        }
        Ok(())
    }

    /// Return a slice of the raw data for signed `(band, row)`.
    #[inline]
    pub fn row_slice(&self, band: isize, row: isize) -> Vec<f64> {
        if band < 0 || band >= self.bands as isize || row < 0 || row >= self.rows as isize {
            return Vec::new();
        }
        let band_stride = self.rows * self.cols;
        let start = band as usize * band_stride + row as usize * self.cols;
        (start..start + self.cols)
            .map(|i| self.data.get_f64(i))
            .collect()
    }

    /// Set all values in signed `(band, row)` from an `f64` slice.
    pub fn set_row_slice(&mut self, band: isize, row: isize, values: &[f64]) -> Result<()> {
        if values.len() != self.cols {
            return Err(RasterError::InvalidDimensions {
                cols: values.len(),
                rows: self.rows,
            });
        }
        if band < 0 || band >= self.bands as isize || row < 0 || row >= self.rows as isize {
            return Err(RasterError::OutOfBounds {
                band,
                col: 0,
                row,
                bands: self.bands,
                cols: self.cols,
                rows: self.rows,
            });
        }
        let band_stride = self.rows * self.cols;
        let start = band as usize * band_stride + row as usize * self.cols;
        for (i, v) in values.iter().copied().enumerate() {
            self.data.set_f64(start + i, v);
        }
        Ok(())
    }

    /// Iterate over signed `(band, row, col, value)` for all valid cells.
    pub fn iter_valid(&self) -> impl Iterator<Item = (isize, isize, isize, f64)> + '_ {
        self.data
            .iter_f64()
            .enumerate()
            .filter_map(move |(idx, v)| {
                if self.is_nodata(v) {
                    None
                } else {
                    let band_stride = self.rows * self.cols;
                    let band = idx / band_stride;
                    let rem = idx % band_stride;
                    let row = rem / self.cols;
                    let col = rem % self.cols;
                    Some((band as isize, row as isize, col as isize, v))
                }
            })
    }

    /// Iterate over signed `(row, col, value)` for all valid cells in one band.
    pub fn iter_valid_band(
        &self,
        band: isize,
    ) -> Result<Box<dyn Iterator<Item = (isize, isize, f64)> + '_>> {
        if band < 0 || band >= self.bands as isize {
            return Err(RasterError::OutOfBounds {
                band,
                col: 0,
                row: 0,
                bands: self.bands,
                cols: self.cols,
                rows: self.rows,
            });
        }

        let b = band as usize;
        let band_stride = self.rows * self.cols;
        let start = b * band_stride;
        Ok(Box::new((0..band_stride).filter_map(move |i| {
            let v = self.data.get_f64(start + i);
            if self.is_nodata(v) {
                None
            } else {
                let row = i / self.cols;
                let col = i % self.cols;
                Some((row as isize, col as isize, v))
            }
        })))
    }

    /// Iterate over row vectors (`Vec<f64>`) for one band from north to south.
    pub fn iter_band_rows(&self, band: isize) -> Result<Box<dyn Iterator<Item = Vec<f64>> + '_>> {
        if band < 0 || band >= self.bands as isize {
            return Err(RasterError::OutOfBounds {
                band,
                col: 0,
                row: 0,
                bands: self.bands,
                cols: self.cols,
                rows: self.rows,
            });
        }

        Ok(Box::new(
            (0..self.rows).map(move |row| self.row_slice(band, row as isize)),
        ))
    }

    /// Traverse mutable native row slices for one band from north to south.
    ///
    /// This is a zero-allocation fast path for in-place row-wise processing.
    /// The callback receives `(row_index, typed_row_slice)`.
    pub fn for_each_band_row_mut<F>(&mut self, band: isize, mut f: F) -> Result<()>
    where
        F: FnMut(isize, RasterRowMut<'_>),
    {
        if band < 0 || band >= self.bands as isize {
            return Err(RasterError::OutOfBounds {
                band,
                col: 0,
                row: 0,
                bands: self.bands,
                cols: self.cols,
                rows: self.rows,
            });
        }

        let b = band as usize;
        let band_stride = self.rows * self.cols;
        let start = b * band_stride;
        let end = start + band_stride;

        match &mut self.data {
            RasterData::U8(v) => {
                for (row, chunk) in v[start..end].chunks_mut(self.cols).enumerate() {
                    f(row as isize, RasterRowMut::U8(chunk));
                }
            }
            RasterData::I8(v) => {
                for (row, chunk) in v[start..end].chunks_mut(self.cols).enumerate() {
                    f(row as isize, RasterRowMut::I8(chunk));
                }
            }
            RasterData::U16(v) => {
                for (row, chunk) in v[start..end].chunks_mut(self.cols).enumerate() {
                    f(row as isize, RasterRowMut::U16(chunk));
                }
            }
            RasterData::I16(v) => {
                for (row, chunk) in v[start..end].chunks_mut(self.cols).enumerate() {
                    f(row as isize, RasterRowMut::I16(chunk));
                }
            }
            RasterData::U32(v) => {
                for (row, chunk) in v[start..end].chunks_mut(self.cols).enumerate() {
                    f(row as isize, RasterRowMut::U32(chunk));
                }
            }
            RasterData::I32(v) => {
                for (row, chunk) in v[start..end].chunks_mut(self.cols).enumerate() {
                    f(row as isize, RasterRowMut::I32(chunk));
                }
            }
            RasterData::U64(v) => {
                for (row, chunk) in v[start..end].chunks_mut(self.cols).enumerate() {
                    f(row as isize, RasterRowMut::U64(chunk));
                }
            }
            RasterData::I64(v) => {
                for (row, chunk) in v[start..end].chunks_mut(self.cols).enumerate() {
                    f(row as isize, RasterRowMut::I64(chunk));
                }
            }
            RasterData::F32(v) => {
                for (row, chunk) in v[start..end].chunks_mut(self.cols).enumerate() {
                    f(row as isize, RasterRowMut::F32(chunk));
                }
            }
            RasterData::F64(v) => {
                for (row, chunk) in v[start..end].chunks_mut(self.cols).enumerate() {
                    f(row as isize, RasterRowMut::F64(chunk));
                }
            }
        }

        Ok(())
    }

    /// Traverse immutable native row slices for one band from north to south.
    ///
    /// This is a zero-allocation fast path for read-only row-wise processing.
    /// The callback receives `(row_index, typed_row_slice)`.
    pub fn for_each_band_row<F>(&self, band: isize, mut f: F) -> Result<()>
    where
        F: FnMut(isize, RasterRowRef<'_>),
    {
        if band < 0 || band >= self.bands as isize {
            return Err(RasterError::OutOfBounds {
                band,
                col: 0,
                row: 0,
                bands: self.bands,
                cols: self.cols,
                rows: self.rows,
            });
        }

        let b = band as usize;
        let band_stride = self.rows * self.cols;
        let start = b * band_stride;
        let end = start + band_stride;

        match &self.data {
            RasterData::U8(v) => {
                for (row, chunk) in v[start..end].chunks(self.cols).enumerate() {
                    f(row as isize, RasterRowRef::U8(chunk));
                }
            }
            RasterData::I8(v) => {
                for (row, chunk) in v[start..end].chunks(self.cols).enumerate() {
                    f(row as isize, RasterRowRef::I8(chunk));
                }
            }
            RasterData::U16(v) => {
                for (row, chunk) in v[start..end].chunks(self.cols).enumerate() {
                    f(row as isize, RasterRowRef::U16(chunk));
                }
            }
            RasterData::I16(v) => {
                for (row, chunk) in v[start..end].chunks(self.cols).enumerate() {
                    f(row as isize, RasterRowRef::I16(chunk));
                }
            }
            RasterData::U32(v) => {
                for (row, chunk) in v[start..end].chunks(self.cols).enumerate() {
                    f(row as isize, RasterRowRef::U32(chunk));
                }
            }
            RasterData::I32(v) => {
                for (row, chunk) in v[start..end].chunks(self.cols).enumerate() {
                    f(row as isize, RasterRowRef::I32(chunk));
                }
            }
            RasterData::U64(v) => {
                for (row, chunk) in v[start..end].chunks(self.cols).enumerate() {
                    f(row as isize, RasterRowRef::U64(chunk));
                }
            }
            RasterData::I64(v) => {
                for (row, chunk) in v[start..end].chunks(self.cols).enumerate() {
                    f(row as isize, RasterRowRef::I64(chunk));
                }
            }
            RasterData::F32(v) => {
                for (row, chunk) in v[start..end].chunks(self.cols).enumerate() {
                    f(row as isize, RasterRowRef::F32(chunk));
                }
            }
            RasterData::F64(v) => {
                for (row, chunk) in v[start..end].chunks(self.cols).enumerate() {
                    f(row as isize, RasterRowRef::F64(chunk));
                }
            }
        }

        Ok(())
    }

    // ─── Transformation ───────────────────────────────────────────────────

    /// Fill all cells with `value`.
    pub fn fill(&mut self, value: f64) {
        for i in 0..self.data.len() {
            self.data.set_f64(i, value);
        }
    }

    /// Fill all cells with the nodata value.
    pub fn fill_nodata(&mut self) {
        let nd = self.nodata;
        self.fill(nd);
    }

    /// Apply a function to every valid (non-nodata) cell value in-place.
    pub fn map_valid<F: Fn(f64) -> f64>(&mut self, f: F) {
        let nd = self.nodata;
        let nodata_nan = nd.is_nan();
        for i in 0..self.data.len() {
            let v = self.data.get_f64(i);
            let is_nd = if nodata_nan {
                v.is_nan()
            } else {
                (v - nd).abs() < 1e-10 * nd.abs().max(1.0)
            };
            if !is_nd {
                self.data.set_f64(i, f(v));
            }
        }
    }

    /// Apply a function to every valid (non-nodata) cell value in one band in-place.
    pub fn map_valid_band<F: Fn(f64) -> f64>(&mut self, band: isize, f: F) -> Result<()> {
        if band < 0 || band >= self.bands as isize {
            return Err(RasterError::OutOfBounds {
                band,
                col: 0,
                row: 0,
                bands: self.bands,
                cols: self.cols,
                rows: self.rows,
            });
        }

        let nd = self.nodata;
        let nodata_nan = nd.is_nan();
        let band_stride = self.rows * self.cols;
        let start = band as usize * band_stride;
        let end = start + band_stride;

        for i in start..end {
            let v = self.data.get_f64(i);
            let is_nd = if nodata_nan {
                v.is_nan()
            } else {
                (v - nd).abs() < 1e-10 * nd.abs().max(1.0)
            };
            if !is_nd {
                self.data.set_f64(i, f(v));
            }
        }
        Ok(())
    }

    /// Replace all occurrences of `from` with `to` in the data buffer.
    pub fn replace(&mut self, from: f64, to: f64) {
        for i in 0..self.data.len() {
            let v = self.data.get_f64(i);
            if (v - from).abs() < f64::EPSILON {
                self.data.set_f64(i, to);
            }
        }
    }

    /// Replace all occurrences of `from` with `to` in one band.
    pub fn replace_band(&mut self, band: isize, from: f64, to: f64) -> Result<()> {
        if band < 0 || band >= self.bands as isize {
            return Err(RasterError::OutOfBounds {
                band,
                col: 0,
                row: 0,
                bands: self.bands,
                cols: self.cols,
                rows: self.rows,
            });
        }

        let band_stride = self.rows * self.cols;
        let start = band as usize * band_stride;
        let end = start + band_stride;
        for i in start..end {
            let v = self.data.get_f64(i);
            if (v - from).abs() < f64::EPSILON {
                self.data.set_f64(i, to);
            }
        }
        Ok(())
    }

    // ─── I/O ──────────────────────────────────────────────────────────────

    /// Read a raster from `path`, detecting the format automatically.
    pub fn read<P: AsRef<Path>>(path: P) -> Result<Self> {
        let path = path.as_ref().to_string_lossy().to_string();
        if crate::formats::is_hdf_dataset_uri(&path) {
            return crate::formats::read_hdf_dataset_uri(&path);
        }
        let fmt = RasterFormat::detect(&path)?;
        fmt.read(&path)
    }

    /// Read a raster from `path` using the specified format.
    pub fn read_with_format<P: AsRef<Path>>(path: P, fmt: RasterFormat) -> Result<Self> {
        let path = path.as_ref().to_string_lossy().to_string();
        fmt.read(&path)
    }

    /// Write this raster to `path`, detecting the format from the extension.
    pub fn write<P: AsRef<Path>>(&self, path: P, fmt: RasterFormat) -> Result<()> {
        let path = path.as_ref().to_string_lossy().to_string();
        fmt.write(self, &path)
    }

    /// Write this raster, auto-detecting the format from the file extension.
    pub fn write_auto<P: AsRef<Path>>(&self, path: P) -> Result<()> {
        let path = path.as_ref().to_string_lossy().to_string();
        let fmt = RasterFormat::detect(&path)?;
        fmt.write(self, &path)
    }

    /// Write this raster as GeoTIFF/BigTIFF/COG using typed options.
    pub fn write_geotiff_with_options<P: AsRef<Path>>(
        &self,
        path: P,
        opts: &crate::formats::geotiff::GeoTiffWriteOptions,
    ) -> Result<()> {
        let path = path.as_ref().to_string_lossy().to_string();
        crate::formats::geotiff::write_with_options(self, &path, opts)
    }

    /// Write this raster as a Cloud-Optimized GeoTIFF (COG) using
    /// convenience defaults.
    ///
    /// Defaults:
    /// - compression: Deflate
    /// - BigTIFF: false
    /// - COG tile size: 512
    pub fn write_cog<P: AsRef<Path>>(&self, path: P) -> Result<()> {
        let opts = crate::formats::geotiff::GeoTiffWriteOptions {
            compression: Some(crate::formats::geotiff::GeoTiffCompression::Deflate),
            bigtiff: Some(false),
            layout: Some(crate::formats::geotiff::GeoTiffLayout::Cog { tile_size: 512 }),
        };
        self.write_geotiff_with_options(path, &opts)
    }

    /// Write this raster as a Cloud-Optimized GeoTIFF (COG) using
    /// convenience defaults and a custom tile size.
    ///
    /// Defaults:
    /// - compression: Deflate
    /// - BigTIFF: false
    /// - COG tile size: `tile_size`
    pub fn write_cog_with_tile_size<P: AsRef<Path>>(&self, path: P, tile_size: u32) -> Result<()> {
        let opts = crate::formats::geotiff::GeoTiffWriteOptions {
            compression: Some(crate::formats::geotiff::GeoTiffCompression::Deflate),
            bigtiff: Some(false),
            layout: Some(crate::formats::geotiff::GeoTiffLayout::Cog { tile_size }),
        };
        self.write_geotiff_with_options(path, &opts)
    }

    /// Write this raster as a Cloud-Optimized GeoTIFF (COG) using COG-focused
    /// typed options.
    ///
    /// Any option set to `None` uses convenience defaults:
    /// - compression: Deflate
    /// - BigTIFF: false
    /// - COG tile size: 512
    pub fn write_cog_with_options<P: AsRef<Path>>(
        &self,
        path: P,
        opts: &crate::formats::geotiff::CogWriteOptions,
    ) -> Result<()> {
        let geotiff_opts = crate::formats::geotiff::GeoTiffWriteOptions {
            compression: Some(
                opts.compression
                    .unwrap_or(crate::formats::geotiff::GeoTiffCompression::Deflate),
            ),
            bigtiff: Some(opts.bigtiff.unwrap_or(false)),
            layout: Some(crate::formats::geotiff::GeoTiffLayout::Cog {
                tile_size: opts.tile_size.unwrap_or(512),
            }),
        };
        self.write_geotiff_with_options(path, &geotiff_opts)
    }

    /// Write this raster as JPEG2000/GeoJP2 using typed options.
    pub fn write_jpeg2000_with_options<P: AsRef<Path>>(
        &self,
        path: P,
        opts: &crate::formats::jpeg2000::Jpeg2000WriteOptions,
    ) -> Result<()> {
        let path = path.as_ref().to_string_lossy().to_string();
        crate::formats::jpeg2000::write_with_options(self, &path, opts)
    }
}

fn maybe_warn_area_of_use_mismatch(src: &Crs, dst: &Crs, src_extent: Extent, enabled: bool) {
    if !enabled {
        return;
    }

    let src_area = src.area_of_use();
    let dst_area = dst.area_of_use();
    if src_area.is_none() && dst_area.is_none() {
        return;
    }

    let Ok(wgs84) = Crs::from_epsg(4326) else {
        return;
    };

    let sample_points = [
        (src_extent.x_min, src_extent.y_min),
        (src_extent.x_min, src_extent.y_max),
        (src_extent.x_max, src_extent.y_min),
        (src_extent.x_max, src_extent.y_max),
        (
            0.5 * (src_extent.x_min + src_extent.x_max),
            0.5 * (src_extent.y_min + src_extent.y_max),
        ),
    ];

    let mut src_outside = 0usize;
    let mut dst_outside = 0usize;
    let mut checked = 0usize;

    for (x, y) in sample_points {
        let Ok((lon, lat)) = src.transform_to(x, y, &wgs84) else {
            continue;
        };
        checked += 1;

        if let Some(bb) = &src_area {
            if !bb.contains_geographic(lon, lat) {
                src_outside += 1;
            }
        }
        if let Some(bb) = &dst_area {
            if !bb.contains_geographic(lon, lat) {
                dst_outside += 1;
            }
        }
    }

    if checked == 0 {
        return;
    }

    if src_outside > 0 || dst_outside > 0 {
        eprintln!(
            "wbraster reprojection warning: sampled source extent appears outside CRS area of use (src outside: {src_outside}/{checked}, dst outside: {dst_outside}/{checked})"
        );
    }
}

fn cubic_bspline_weights(t: f64) -> [f64; 4] {
    let t = t.clamp(0.0, 1.0);
    let t2 = t * t;
    let t3 = t2 * t;
    [
        ((1.0 - t) * (1.0 - t) * (1.0 - t)) / 6.0,
        (3.0 * t3 - 6.0 * t2 + 4.0) / 6.0,
        (-3.0 * t3 + 3.0 * t2 + 3.0 * t + 1.0) / 6.0,
        t3 / 6.0,
    ]
}

fn lanczos_kernel(x: f64, a: f64) -> f64 {
    if x.abs() < 1e-12 {
        return 1.0;
    }
    if x.abs() >= a {
        return 0.0;
    }
    let pix = std::f64::consts::PI * x;
    let pix_over_a = pix / a;
    (pix.sin() / pix) * (pix_over_a.sin() / pix_over_a)
}

fn lanczos3_weights(sample_f: f64, floor_idx: isize) -> [f64; 6] {
    let mut w = [0.0_f64; 6];
    for (i, wi) in w.iter_mut().enumerate() {
        let idx = floor_idx + i as isize - 2;
        let dx = sample_f - idx as f64;
        *wi = lanczos_kernel(dx, 3.0);
    }
    w
}

fn sample_extent_boundary_points(extent: Extent, samples_per_edge: usize) -> Vec<(f64, f64)> {
    let n = samples_per_edge.max(1);
    let mut pts = Vec::with_capacity(4 * n);

    // Bottom and top edges include corners.
    for i in 0..=n {
        let t = i as f64 / n as f64;
        let x = extent.x_min + t * (extent.x_max - extent.x_min);
        pts.push((x, extent.y_min));
        pts.push((x, extent.y_max));
    }

    // Left and right edges exclude corners to avoid duplicate corner points.
    for j in 1..n {
        let t = j as f64 / n as f64;
        let y = extent.y_min + t * (extent.y_max - extent.y_min);
        pts.push((extent.x_min, y));
        pts.push((extent.x_max, y));
    }

    pts
}

fn sample_extent_boundary_ring(extent: Extent, samples_per_edge: usize) -> Vec<(f64, f64)> {
    let n = samples_per_edge.max(1);
    let mut ring = Vec::with_capacity(n * 4);

    for i in 0..n {
        let t = if n == 1 {
            0.0
        } else {
            i as f64 / (n - 1) as f64
        };
        let x = extent.x_min + t * (extent.x_max - extent.x_min);
        ring.push((x, extent.y_min));
    }

    for i in 0..n {
        let t = if n == 1 {
            0.0
        } else {
            i as f64 / (n - 1) as f64
        };
        let y = extent.y_min + t * (extent.y_max - extent.y_min);
        ring.push((extent.x_max, y));
    }

    for i in 0..n {
        let t = if n == 1 {
            0.0
        } else {
            i as f64 / (n - 1) as f64
        };
        let x = extent.x_max - t * (extent.x_max - extent.x_min);
        ring.push((x, extent.y_max));
    }

    for i in 0..n {
        let t = if n == 1 {
            0.0
        } else {
            i as f64 / (n - 1) as f64
        };
        let y = extent.y_max - t * (extent.y_max - extent.y_min);
        ring.push((extent.x_min, y));
    }

    ring
}

fn transformed_extent_from_boundary_samples(
    src_crs: &Crs,
    dst_crs: &Crs,
    src_extent: Extent,
    samples_per_edge: usize,
    dst_epsg: u32,
    antimeridian_policy: AntimeridianPolicy,
    epoch_transform: &EpochTransformOptions,
) -> Result<Extent> {
    let points = sample_extent_boundary_points(src_extent, samples_per_edge);

    let mut tx_min = f64::INFINITY;
    let mut tx_max = f64::NEG_INFINITY;
    let mut ty_min = f64::INFINITY;
    let mut ty_max = f64::NEG_INFINITY;
    let mut tx_values = Vec::new();
    let mut valid = 0usize;

    for (x, y) in points {
        let Ok((tx, ty)) = transform_xy_with_epoch_options(src_crs, dst_crs, x, y, epoch_transform)
        else {
            continue;
        };
        if !tx.is_finite() || !ty.is_finite() {
            continue;
        }
        tx_min = tx_min.min(tx);
        tx_max = tx_max.max(tx);
        ty_min = ty_min.min(ty);
        ty_max = ty_max.max(ty);
        tx_values.push(tx);
        valid += 1;
    }

    if valid == 0 {
        return Err(RasterError::Other(format!(
            "failed to transform source extent boundary samples to EPSG:{}",
            dst_epsg
        )));
    }

    if dst_epsg == 4326 {
        if let Some((x0, x1)) = antimeridian_aware_longitude_bounds(&tx_values, antimeridian_policy)
        {
            tx_min = x0;
            tx_max = x1;
        }
    }

    Ok(Extent {
        x_min: tx_min,
        y_min: ty_min,
        x_max: tx_max,
        y_max: ty_max,
    })
}

fn transformed_boundary_ring_samples(
    src_crs: &Crs,
    dst_crs: &Crs,
    src_extent: Extent,
    samples_per_edge: usize,
    dst_epsg: u32,
    antimeridian_policy: AntimeridianPolicy,
    epoch_transform: &EpochTransformOptions,
) -> Result<Vec<(f64, f64)>> {
    let ring = sample_extent_boundary_ring(src_extent, samples_per_edge);
    let mut transformed = Vec::with_capacity(ring.len());

    for (x, y) in ring {
        let Ok((tx, ty)) = transform_xy_with_epoch_options(src_crs, dst_crs, x, y, epoch_transform)
        else {
            continue;
        };
        if tx.is_finite() && ty.is_finite() {
            transformed.push((tx, ty));
        }
    }

    if transformed.len() < 3 {
        return Err(RasterError::Other(format!(
            "failed to build transformed boundary ring for EPSG:{}",
            dst_epsg
        )));
    }

    if dst_epsg == 4326 && antimeridian_policy != AntimeridianPolicy::Linear {
        let lons: Vec<f64> = transformed.iter().map(|(x, _)| *x).collect();
        if let Some((base, _)) = minimal_wrapped_longitude_bounds(&lons) {
            for (x, _) in &mut transformed {
                let mut w = wrap_lon_360(*x);
                if w < base {
                    w += 360.0;
                }
                *x = w;
            }
        }
    }

    Ok(transformed)
}

fn snap_down_to_origin(value: f64, origin: f64, step: f64) -> f64 {
    origin + ((value - origin) / step).floor() * step
}

fn snap_up_to_origin(value: f64, origin: f64, step: f64) -> f64 {
    origin + ((value - origin) / step).ceil() * step
}

fn transform_xy_with_epoch_options(
    src: &Crs,
    dst: &Crs,
    x: f64,
    y: f64,
    options: &EpochTransformOptions,
) -> Result<(f64, f64)> {
    options
        .validate()
        .map_err(|e| RasterError::Other(format!("invalid epoch transform options: {e}")))?;
    let ctx = options
        .build_context()
        .map_err(|e| RasterError::Other(format!("invalid epoch transform options: {e}")))?;
    let epoch_routing_requested = options.coordinate_epoch_decimal_year.is_some()
        || options.source_reference_epoch_decimal_year.is_some()
        || options.target_reference_epoch_decimal_year.is_some()
        || options.operation_code.is_some()
        || !options.prefer_official_operation
        || matches!(options.epoch_policy, EpochPolicy::AllowStaticFallback);

    if !epoch_routing_requested {
        return src
            .transform_to(x, y, dst)
            .map_err(|err| RasterError::Other(format!("epoch-aware transform failed: {err}")));
    }

    let result = if let Some(operation_code) = options.operation_code {
        src.transform_to_with_operation(x, y, dst, operation_code, ctx)
    } else if options.prefer_official_operation {
        src.transform_to_with_preferred_operation(x, y, dst, ctx)
    } else if let Some(epoch_ctx) = ctx {
        src.transform_to_with_context(x, y, dst, epoch_ctx)
    } else {
        src.transform_to_with_policy(x, y, dst, CrsTransformPolicy::Auto)
    };

    match result {
        Ok(v) => Ok(v),
        Err(err) if matches!(options.epoch_policy, EpochPolicy::AllowStaticFallback) => src
            .transform_to_with_policy(x, y, dst, CrsTransformPolicy::Auto)
            .map_err(|fallback_err| {
                RasterError::Other(format!(
                    "epoch-aware transform failed ({err}); static fallback failed ({fallback_err})"
                ))
            }),
        Err(err) => Err(RasterError::Other(format!(
            "epoch-aware transform failed: {err}"
        ))),
    }
}

fn wrap_lon_360(lon: f64) -> f64 {
    let mut v = lon % 360.0;
    if v < 0.0 {
        v += 360.0;
    }
    v
}

fn minimal_wrapped_longitude_bounds(longitudes: &[f64]) -> Option<(f64, f64)> {
    if longitudes.is_empty() {
        return None;
    }

    if longitudes.len() == 1 {
        let v = wrap_lon_360(longitudes[0]);
        return Some((v, v));
    }

    let mut values: Vec<f64> = longitudes.iter().map(|v| wrap_lon_360(*v)).collect();
    values.sort_by(f64::total_cmp);

    let n = values.len();
    let mut max_gap = f64::NEG_INFINITY;
    let mut max_gap_idx = 0usize;
    for i in 0..n {
        let next = if i + 1 < n {
            values[i + 1]
        } else {
            values[0] + 360.0
        };
        let gap = next - values[i];
        if gap > max_gap {
            max_gap = gap;
            max_gap_idx = i;
        }
    }

    let start = values[(max_gap_idx + 1) % n];
    let mut end = values[max_gap_idx];
    if end < start {
        end += 360.0;
    }

    Some((start, end))
}

fn antimeridian_aware_longitude_bounds(
    longitudes: &[f64],
    policy: AntimeridianPolicy,
) -> Option<(f64, f64)> {
    if longitudes.is_empty() {
        return None;
    }

    let mut lin_min = f64::INFINITY;
    let mut lin_max = f64::NEG_INFINITY;
    for lon in longitudes {
        if !lon.is_finite() {
            continue;
        }
        lin_min = lin_min.min(*lon);
        lin_max = lin_max.max(*lon);
    }
    if !lin_min.is_finite() || !lin_max.is_finite() {
        return None;
    }

    if policy == AntimeridianPolicy::Linear {
        return Some((lin_min, lin_max));
    }

    let Some((wrap_min, wrap_max)) = minimal_wrapped_longitude_bounds(longitudes) else {
        return Some((lin_min, lin_max));
    };
    if policy == AntimeridianPolicy::Wrap {
        return Some((wrap_min, wrap_max));
    }

    let linear_width = lin_max - lin_min;
    let wrapped_width = wrap_max - wrap_min;

    if wrapped_width + 1e-9 < linear_width {
        Some((wrap_min, wrap_max))
    } else {
        Some((lin_min, lin_max))
    }
}

fn clamp_isize(v: isize, min_v: isize, max_v: isize) -> isize {
    v.max(min_v).min(max_v)
}

fn point_in_polygon(x: f64, y: f64, polygon: &[(f64, f64)]) -> bool {
    if polygon.len() < 3 {
        return false;
    }
    let mut inside = false;
    let mut j = polygon.len() - 1;
    for i in 0..polygon.len() {
        let (xi, yi) = polygon[i];
        let (xj, yj) = polygon[j];
        let intersects =
            (yi > y) != (yj > y) && x < (xj - xi) * (y - yi) / ((yj - yi) + 1e-30) + xi;
        if intersects {
            inside = !inside;
        }
        j = i;
    }
    inside
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
enum WindowStat {
    Mean,
    Min,
    Max,
    Mode,
    Median,
    StdDev,
}

fn reduce_window_values(values: &[f64], stat: WindowStat) -> Option<f64> {
    if values.is_empty() {
        return None;
    }

    match stat {
        WindowStat::Mean => Some(values.iter().sum::<f64>() / values.len() as f64),
        WindowStat::Min => values.iter().copied().reduce(f64::min),
        WindowStat::Max => values.iter().copied().reduce(f64::max),
        WindowStat::Mode => {
            let mut pairs: Vec<(f64, usize)> = Vec::new();
            for v in values {
                if let Some((_, count)) = pairs.iter_mut().find(|(u, _)| *u == *v) {
                    *count += 1;
                } else {
                    pairs.push((*v, 1));
                }
            }
            pairs.sort_by(|a, b| b.1.cmp(&a.1).then_with(|| a.0.total_cmp(&b.0)));
            pairs.first().map(|(v, _)| *v)
        }
        WindowStat::Median => {
            let mut sorted = values.to_vec();
            sorted.sort_by(f64::total_cmp);
            let n = sorted.len();
            if n % 2 == 1 {
                Some(sorted[n / 2])
            } else {
                Some((sorted[n / 2 - 1] + sorted[n / 2]) / 2.0)
            }
        }
        WindowStat::StdDev => {
            let n = values.len() as f64;
            let mean = values.iter().sum::<f64>() / n;
            let variance = values
                .iter()
                .map(|v| {
                    let d = *v - mean;
                    d * d
                })
                .sum::<f64>()
                / n;
            Some(variance.max(0.0).sqrt())
        }
    }
}

impl std::fmt::Display for Raster {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(
            f,
            "Raster({}×{}×{}, cell={:.6}, x=[{:.4},{:.4}], y=[{:.4},{:.4}], type={}, nodata={})",
            self.bands,
            self.cols,
            self.rows,
            self.cell_size_x,
            self.x_min,
            self.x_max(),
            self.y_min,
            self.y_max(),
            self.data_type,
            self.nodata,
        )
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use flate2::{write::ZlibEncoder, Compression};
    use std::io::Write;
    use std::sync::{Arc, Mutex};

    fn make_raster() -> Raster {
        let cfg = RasterConfig {
            cols: 4,
            rows: 3,
            cell_size: 10.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut r = Raster::new(cfg);
        for row in 0..3 {
            for col in 0..4 {
                let _ = r.set(0, row, col, (row * 4 + col) as f64);
            }
        }
        r
    }

    fn write_synthetic_hdf4_i16_fixture(file: &mut tempfile::NamedTempFile) {
        let mut bytes = vec![0x0E, 0x03, 0x13, 0x01];
        bytes.extend_from_slice(&[0x00, 0x01]);
        bytes.extend_from_slice(&[0x00, 0x00, 0x00, 0x00]);
        bytes.extend_from_slice(&[
            0x02, 0xBE, 0x00, 0x03, 0x00, 0x00, 0x00, 0x80, 0x00, 0x00, 0x00, 0x10,
        ]);
        bytes.resize(0x90, 0);
        bytes[0x80..0x90].copy_from_slice(&[
            0x01, 0x00, 0x02, 0x00, 0x03, 0x00, 0x04, 0x00, 0x05, 0x00, 0x06, 0x00, 0x07, 0x00,
            0x08, 0x00,
        ]);
        bytes.extend_from_slice(
            b"\nStructMetadata.0\nGridName=\"GridA\"\nXDim=4\nYDim=2\nUpperLeftPointMtrs=(0,10)\nLowerRightMtrs=(20,0)\nDataFieldName=\"FieldA\"\nDataType=DFNT_INT16\nDimList=(\"YDim\",\"XDim\")\n",
        );
        file.write_all(&bytes)
            .expect("synthetic HDF4 fixture should be writable");
    }

    fn write_synthetic_hdf5_contiguous_fixture_header(
        bytes: &mut [u8],
        dataset_path: &str,
        payload_offset: usize,
        element_count: usize,
        bytes_per_value: usize,
    ) {
        const HEADER_OFFSET: usize = 256;
        const CONTINUATION_OFFSET: usize = 512;
        const CONTINUATION_SIZE: usize = 26;

        let marker = dataset_path.as_bytes();
        bytes[64..64 + marker.len()].copy_from_slice(marker);

        let payload_size = element_count * bytes_per_value;

        let mut cursor = HEADER_OFFSET;
        bytes[cursor..cursor + 4].copy_from_slice(b"OHDR");
        cursor += 4;
        bytes[cursor] = 2;
        cursor += 1;
        bytes[cursor] = 0;
        cursor += 1;
        bytes[cursor] = 0x34;
        cursor += 1;

        bytes[cursor..cursor + 4].copy_from_slice(&[0x01, 0x10, 0x00, 0x00]);
        cursor += 4;
        bytes[cursor..cursor + 8].copy_from_slice(&[0x02, 0x01, 0x00, 0x00, 0, 0, 0, 0]);
        cursor += 8;
        bytes[cursor..cursor + 8].copy_from_slice(&(element_count as u64).to_le_bytes());
        cursor += 8;

        bytes[cursor..cursor + 4].copy_from_slice(&[0x03, 0x08, 0x00, 0x00]);
        cursor += 4;
        bytes[cursor] = 0x13;
        bytes[cursor + 1] = 0x00;
        bytes[cursor + 2] = 0x00;
        bytes[cursor + 3] = 0x00;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&(bytes_per_value as u32).to_le_bytes());
        cursor += 8;

        bytes[cursor..cursor + 4].copy_from_slice(&[0x10, 0x10, 0x00, 0x00]);
        cursor += 4;
        bytes[cursor..cursor + 8].copy_from_slice(&(CONTINUATION_OFFSET as u64).to_le_bytes());
        cursor += 8;
        bytes[cursor..cursor + 8].copy_from_slice(&(CONTINUATION_SIZE as u64).to_le_bytes());

        let mut continuation_cursor = CONTINUATION_OFFSET;
        bytes[continuation_cursor..continuation_cursor + 4].copy_from_slice(b"OCHK");
        continuation_cursor += 4;
        bytes[continuation_cursor..continuation_cursor + 4]
            .copy_from_slice(&[0x08, 0x12, 0x00, 0x00]);
        continuation_cursor += 4;
        bytes[continuation_cursor] = 0x03;
        bytes[continuation_cursor + 1] = 0x01;
        continuation_cursor += 2;
        bytes[continuation_cursor..continuation_cursor + 8]
            .copy_from_slice(&(payload_offset as u64).to_le_bytes());
        continuation_cursor += 8;
        bytes[continuation_cursor..continuation_cursor + 8]
            .copy_from_slice(&(payload_size as u64).to_le_bytes());
    }

    fn write_synthetic_hdf5_gedi_contiguous_fixture(file: &mut tempfile::NamedTempFile) {
        const OFFSET: usize = 321_111;
        const ELEMENTS: usize = 89_634;

        let mut bytes = vec![0u8; OFFSET + ELEMENTS * 4];
        write_synthetic_hdf5_contiguous_fixture_header(
            &mut bytes,
            "/BEAM0000/elev_lowestmode",
            OFFSET,
            ELEMENTS,
            4,
        );

        for i in 0..ELEMENTS {
            let v = i as f32;
            let start = OFFSET + i * 4;
            bytes[start..start + 4].copy_from_slice(&v.to_le_bytes());
        }
        file.write_all(&bytes)
            .expect("synthetic HDF5 fixture should be writable");
    }

    fn write_synthetic_hdf5_viirs_xdim_fixture(file: &mut tempfile::NamedTempFile) {
        const OFFSET: usize = 45_321;
        const ELEMENTS: usize = 2_400;

        let mut bytes = vec![0u8; OFFSET + ELEMENTS * 8];
        write_synthetic_hdf5_contiguous_fixture_header(
            &mut bytes,
            "/HDFEOS/GRIDS/VIIRS_Grid_8Day_VI_500m/XDim",
            OFFSET,
            ELEMENTS,
            8,
        );

        for i in 0..ELEMENTS {
            let v = i as f64 + 0.5;
            let start = OFFSET + i * 8;
            bytes[start..start + 8].copy_from_slice(&v.to_le_bytes());
        }
        file.write_all(&bytes)
            .expect("synthetic HDF5 VIIRS fixture should be writable");
    }

    fn write_synthetic_hdf5_generic_contiguous_f32_fixture(file: &mut tempfile::NamedTempFile) {
        const OFFSET: usize = 62_222;
        const ELEMENTS: usize = 12;
        const DATASET_PATH: &str = "/ScienceData/NDVI";

        let mut bytes = vec![0u8; OFFSET + ELEMENTS * 4];
        write_synthetic_hdf5_contiguous_fixture_header(
            &mut bytes,
            DATASET_PATH,
            OFFSET,
            ELEMENTS,
            4,
        );

        for i in 0..ELEMENTS {
            let v = (i as f32) * 0.25;
            let start = OFFSET + i * 4;
            bytes[start..start + 4].copy_from_slice(&v.to_le_bytes());
        }
        file.write_all(&bytes)
            .expect("synthetic HDF5 generic fixture should be writable");
    }

    fn write_synthetic_hdf5_chunked_single_chunk_f32_fixture(file: &mut tempfile::NamedTempFile) {
        const DATASET_PATH: &str = "/ScienceData/NDVI_Chunked";
        const HEADER_OFFSET: usize = 1024;
        const CHUNK_INDEX_OFFSET: usize = 4096;
        const PAYLOAD_OFFSET: usize = 8192;
        const ROWS: usize = 2;
        const COLS: usize = 3;

        let values = [0.5f32, 1.5, 2.5, 3.5, 4.5, 5.5];
        let mut raw_payload = Vec::<u8>::new();
        for value in values {
            raw_payload.extend_from_slice(&value.to_le_bytes());
        }

        let total_len = PAYLOAD_OFFSET + raw_payload.len();
        let mut bytes = vec![0u8; total_len];

        let marker = DATASET_PATH.as_bytes();
        bytes[64..64 + marker.len()].copy_from_slice(marker);

        // v1 object header prefix.
        let mut cursor = HEADER_OFFSET;
        bytes[cursor] = 1;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(3u16).to_le_bytes());
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 12].copy_from_slice(&(95u32).to_le_bytes());
        bytes[cursor + 12..cursor + 16].copy_from_slice(&0u32.to_le_bytes());
        cursor += 16;

        // Dataspace message (rank=2, dims=2x3).
        bytes[cursor..cursor + 2].copy_from_slice(&(0x0001u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(24u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 2;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 16].copy_from_slice(&(ROWS as u64).to_le_bytes());
        bytes[cursor + 16..cursor + 24].copy_from_slice(&(COLS as u64).to_le_bytes());
        cursor += 24;

        // Datatype message (size=4).
        bytes[cursor..cursor + 2].copy_from_slice(&(0x0003u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(8u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 0x13;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&(4u32).to_le_bytes());
        cursor += 8;

        // Chunked layout message (num_dimensions=2, chunk dims=2x3).
        bytes[cursor..cursor + 2].copy_from_slice(&(0x0008u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(19u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 3;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 2;
        bytes[cursor + 3..cursor + 11].copy_from_slice(&(CHUNK_INDEX_OFFSET as u64).to_le_bytes());
        bytes[cursor + 11..cursor + 15].copy_from_slice(&(ROWS as u32).to_le_bytes());
        bytes[cursor + 15..cursor + 19].copy_from_slice(&(COLS as u32).to_le_bytes());

        // Chunk index node (first leaf record only, little-endian fields per current bounded parser).
        let mut node_cursor = CHUNK_INDEX_OFFSET;
        bytes[node_cursor..node_cursor + 4].copy_from_slice(b"TREE");
        bytes[node_cursor + 4] = 1;
        bytes[node_cursor + 5] = 0;
        bytes[node_cursor + 6..node_cursor + 8].copy_from_slice(&(1u16).to_le_bytes());
        node_cursor += 24;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(raw_payload.len() as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(PAYLOAD_OFFSET as u64).to_le_bytes());

        // Chunk payload bytes.
        bytes[PAYLOAD_OFFSET..PAYLOAD_OFFSET + raw_payload.len()].copy_from_slice(&raw_payload);

        file.write_all(&bytes)
            .expect("synthetic HDF5 chunked fixture should be writable");
    }

    fn write_synthetic_hdf5_chunked_two_chunk_f32_fixture(file: &mut tempfile::NamedTempFile) {
        const DATASET_PATH: &str = "/ScienceData/NDVI_Chunked_Two";
        const HEADER_OFFSET: usize = 1024;
        const CHUNK_INDEX_OFFSET: usize = 4096;
        const PAYLOAD_A_OFFSET: usize = 8192;
        const PAYLOAD_B_OFFSET: usize = 8208;
        const ROWS: usize = 2;
        const COLS: usize = 4;
        const CHUNK_ROWS: usize = 2;
        const CHUNK_COLS: usize = 2;

        let values_a = [0.5f32, 1.5, 4.5, 5.5];
        let values_b = [2.5f32, 3.5, 6.5, 7.5];
        let mut payload_a = Vec::<u8>::new();
        let mut payload_b = Vec::<u8>::new();
        for value in values_a {
            payload_a.extend_from_slice(&value.to_le_bytes());
        }
        for value in values_b {
            payload_b.extend_from_slice(&value.to_le_bytes());
        }

        let total_len = PAYLOAD_B_OFFSET + payload_b.len();
        let mut bytes = vec![0u8; total_len];
        let marker = DATASET_PATH.as_bytes();
        bytes[64..64 + marker.len()].copy_from_slice(marker);

        let mut cursor = HEADER_OFFSET;
        bytes[cursor] = 1;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(3u16).to_le_bytes());
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 12].copy_from_slice(&(95u32).to_le_bytes());
        bytes[cursor + 12..cursor + 16].copy_from_slice(&0u32.to_le_bytes());
        cursor += 16;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0001u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(24u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 2;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 16].copy_from_slice(&(ROWS as u64).to_le_bytes());
        bytes[cursor + 16..cursor + 24].copy_from_slice(&(COLS as u64).to_le_bytes());
        cursor += 24;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0003u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(8u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 0x13;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&(4u32).to_le_bytes());
        cursor += 8;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0008u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(19u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 3;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 2;
        bytes[cursor + 3..cursor + 11].copy_from_slice(&(CHUNK_INDEX_OFFSET as u64).to_le_bytes());
        bytes[cursor + 11..cursor + 15].copy_from_slice(&(CHUNK_ROWS as u32).to_le_bytes());
        bytes[cursor + 15..cursor + 19].copy_from_slice(&(CHUNK_COLS as u32).to_le_bytes());

        let mut node_cursor = CHUNK_INDEX_OFFSET;
        bytes[node_cursor..node_cursor + 4].copy_from_slice(b"TREE");
        bytes[node_cursor + 4] = 1;
        bytes[node_cursor + 5] = 0;
        bytes[node_cursor + 6..node_cursor + 8].copy_from_slice(&(2u16).to_le_bytes());
        node_cursor += 24;

        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(payload_a.len() as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(PAYLOAD_A_OFFSET as u64).to_le_bytes());
        node_cursor += 8;

        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(payload_b.len() as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(2u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(PAYLOAD_B_OFFSET as u64).to_le_bytes());

        bytes[PAYLOAD_A_OFFSET..PAYLOAD_A_OFFSET + payload_a.len()].copy_from_slice(&payload_a);
        bytes[PAYLOAD_B_OFFSET..PAYLOAD_B_OFFSET + payload_b.len()].copy_from_slice(&payload_b);

        file.write_all(&bytes)
            .expect("synthetic HDF5 two-chunk fixture should be writable");
    }

    fn write_synthetic_hdf5_chunked_two_chunk_f32_deflate_fixture(
        file: &mut tempfile::NamedTempFile,
    ) {
        const DATASET_PATH: &str = "/ScienceData/NDVI_Chunked_Two_Deflate";
        const HEADER_OFFSET: usize = 1024;
        const CHUNK_INDEX_OFFSET: usize = 4096;
        const PAYLOAD_A_OFFSET: usize = 8192;
        const ROWS: usize = 2;
        const COLS: usize = 4;
        const CHUNK_ROWS: usize = 2;
        const CHUNK_COLS: usize = 2;

        let values_a = [0.5f32, 1.5, 4.5, 5.5];
        let values_b = [2.5f32, 3.5, 6.5, 7.5];
        let payload_a = encode_f32_values_as_zlib(&values_a);
        let payload_b = encode_f32_values_as_zlib(&values_b);
        let payload_b_offset = PAYLOAD_A_OFFSET + payload_a.len();

        let total_len = payload_b_offset + payload_b.len();
        let mut bytes = vec![0u8; total_len];
        let marker = DATASET_PATH.as_bytes();
        bytes[64..64 + marker.len()].copy_from_slice(marker);

        let mut cursor = HEADER_OFFSET;
        bytes[cursor] = 1;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(4u16).to_le_bytes());
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 12].copy_from_slice(&(121u32).to_le_bytes());
        bytes[cursor + 12..cursor + 16].copy_from_slice(&0u32.to_le_bytes());
        cursor += 16;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0001u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(24u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 2;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 16].copy_from_slice(&(ROWS as u64).to_le_bytes());
        bytes[cursor + 16..cursor + 24].copy_from_slice(&(COLS as u64).to_le_bytes());
        cursor += 24;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0003u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(8u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 0x13;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&(4u32).to_le_bytes());
        cursor += 8;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0008u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(19u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 3;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 2;
        bytes[cursor + 3..cursor + 11].copy_from_slice(&(CHUNK_INDEX_OFFSET as u64).to_le_bytes());
        bytes[cursor + 11..cursor + 15].copy_from_slice(&(CHUNK_ROWS as u32).to_le_bytes());
        bytes[cursor + 15..cursor + 19].copy_from_slice(&(CHUNK_COLS as u32).to_le_bytes());
        cursor += 19;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x000bu16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(16u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 1;
        bytes[cursor + 1] = 1;
        bytes[cursor + 2..cursor + 8].copy_from_slice(&[0, 0, 0, 0, 0, 0]);
        cursor += 8;
        bytes[cursor..cursor + 2].copy_from_slice(&(1u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(0u16).to_le_bytes());
        bytes[cursor + 4..cursor + 6].copy_from_slice(&(0u16).to_le_bytes());
        bytes[cursor + 6..cursor + 8].copy_from_slice(&(0u16).to_le_bytes());

        let mut node_cursor = CHUNK_INDEX_OFFSET;
        bytes[node_cursor..node_cursor + 4].copy_from_slice(b"TREE");
        bytes[node_cursor + 4] = 1;
        bytes[node_cursor + 5] = 0;
        bytes[node_cursor + 6..node_cursor + 8].copy_from_slice(&(2u16).to_le_bytes());
        node_cursor += 24;

        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(payload_a.len() as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(PAYLOAD_A_OFFSET as u64).to_le_bytes());
        node_cursor += 8;

        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(payload_b.len() as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(2u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(payload_b_offset as u64).to_le_bytes());

        bytes[PAYLOAD_A_OFFSET..PAYLOAD_A_OFFSET + payload_a.len()].copy_from_slice(&payload_a);
        bytes[payload_b_offset..payload_b_offset + payload_b.len()].copy_from_slice(&payload_b);

        file.write_all(&bytes)
            .expect("synthetic HDF5 deflate two-chunk fixture should be writable");
    }

    fn write_synthetic_hdf5_chunked_two_leaf_f32_fixture(file: &mut tempfile::NamedTempFile) {
        const DATASET_PATH: &str = "/ScienceData/NDVI_Chunked_Two_Leaf";
        const HEADER_OFFSET: usize = 1024;
        const FIRST_LEAF_OFFSET: usize = 4096;
        const SECOND_LEAF_OFFSET: usize = 4184;
        const PAYLOAD_A_OFFSET: usize = 8192;
        const PAYLOAD_B_OFFSET: usize = 8208;
        const ROWS: usize = 2;
        const COLS: usize = 4;
        const CHUNK_ROWS: usize = 2;
        const CHUNK_COLS: usize = 2;

        let values_a = [0.5f32, 1.5, 4.5, 5.5];
        let values_b = [2.5f32, 3.5, 6.5, 7.5];
        let mut payload_a = Vec::<u8>::new();
        let mut payload_b = Vec::<u8>::new();
        for value in values_a {
            payload_a.extend_from_slice(&value.to_le_bytes());
        }
        for value in values_b {
            payload_b.extend_from_slice(&value.to_le_bytes());
        }

        let total_len = PAYLOAD_B_OFFSET + payload_b.len();
        let mut bytes = vec![0u8; total_len];
        let marker = DATASET_PATH.as_bytes();
        bytes[64..64 + marker.len()].copy_from_slice(marker);

        let mut cursor = HEADER_OFFSET;
        bytes[cursor] = 1;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(3u16).to_le_bytes());
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 12].copy_from_slice(&(95u32).to_le_bytes());
        bytes[cursor + 12..cursor + 16].copy_from_slice(&0u32.to_le_bytes());
        cursor += 16;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0001u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(24u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 2;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 16].copy_from_slice(&(ROWS as u64).to_le_bytes());
        bytes[cursor + 16..cursor + 24].copy_from_slice(&(COLS as u64).to_le_bytes());
        cursor += 24;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0003u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(8u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 0x13;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&(4u32).to_le_bytes());
        cursor += 8;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0008u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(19u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 3;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 2;
        bytes[cursor + 3..cursor + 11].copy_from_slice(&(FIRST_LEAF_OFFSET as u64).to_le_bytes());
        bytes[cursor + 11..cursor + 15].copy_from_slice(&(CHUNK_ROWS as u32).to_le_bytes());
        bytes[cursor + 15..cursor + 19].copy_from_slice(&(CHUNK_COLS as u32).to_le_bytes());

        let mut node_cursor = FIRST_LEAF_OFFSET;
        bytes[node_cursor..node_cursor + 4].copy_from_slice(b"TREE");
        bytes[node_cursor + 4] = 1;
        bytes[node_cursor + 5] = 0;
        bytes[node_cursor + 6..node_cursor + 8].copy_from_slice(&(1u16).to_le_bytes());
        bytes[node_cursor + 8..node_cursor + 16].copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[node_cursor + 16..node_cursor + 24]
            .copy_from_slice(&(SECOND_LEAF_OFFSET as u64).to_le_bytes());
        node_cursor += 24;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(payload_a.len() as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(PAYLOAD_A_OFFSET as u64).to_le_bytes());

        let mut node_cursor = SECOND_LEAF_OFFSET;
        bytes[node_cursor..node_cursor + 4].copy_from_slice(b"TREE");
        bytes[node_cursor + 4] = 1;
        bytes[node_cursor + 5] = 0;
        bytes[node_cursor + 6..node_cursor + 8].copy_from_slice(&(1u16).to_le_bytes());
        bytes[node_cursor + 8..node_cursor + 16]
            .copy_from_slice(&(FIRST_LEAF_OFFSET as u64).to_le_bytes());
        bytes[node_cursor + 16..node_cursor + 24].copy_from_slice(&u64::MAX.to_le_bytes());
        node_cursor += 24;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(payload_b.len() as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(2u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(PAYLOAD_B_OFFSET as u64).to_le_bytes());

        bytes[PAYLOAD_A_OFFSET..PAYLOAD_A_OFFSET + payload_a.len()].copy_from_slice(&payload_a);
        bytes[PAYLOAD_B_OFFSET..PAYLOAD_B_OFFSET + payload_b.len()].copy_from_slice(&payload_b);

        file.write_all(&bytes)
            .expect("synthetic HDF5 two-leaf fixture should be writable");
    }

    fn write_synthetic_hdf5_chunked_internal_root_fixture(file: &mut tempfile::NamedTempFile) {
        const DATASET_PATH: &str = "/ScienceData/NDVI_Chunked_InternalRoot";
        const HEADER_OFFSET: usize = 1024;
        const INTERNAL_ROOT_OFFSET: usize = 4096;
        const FIRST_LEAF_OFFSET: usize = 4168;
        const SECOND_LEAF_OFFSET: usize = 4256;
        const PAYLOAD_A_OFFSET: usize = 8192;
        const PAYLOAD_B_OFFSET: usize = 8208;
        const ROWS: usize = 2;
        const COLS: usize = 4;
        const CHUNK_ROWS: usize = 2;
        const CHUNK_COLS: usize = 2;

        let values_a = [0.5f32, 1.5, 4.5, 5.5];
        let values_b = [2.5f32, 3.5, 6.5, 7.5];
        let mut payload_a = Vec::<u8>::new();
        let mut payload_b = Vec::<u8>::new();
        for value in values_a {
            payload_a.extend_from_slice(&value.to_le_bytes());
        }
        for value in values_b {
            payload_b.extend_from_slice(&value.to_le_bytes());
        }

        let total_len = PAYLOAD_B_OFFSET + payload_b.len();
        let mut bytes = vec![0u8; total_len];
        let marker = DATASET_PATH.as_bytes();
        bytes[64..64 + marker.len()].copy_from_slice(marker);

        let mut cursor = HEADER_OFFSET;
        bytes[cursor] = 1;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(3u16).to_le_bytes());
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 12].copy_from_slice(&(95u32).to_le_bytes());
        bytes[cursor + 12..cursor + 16].copy_from_slice(&0u32.to_le_bytes());
        cursor += 16;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0001u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(24u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 2;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 16].copy_from_slice(&(ROWS as u64).to_le_bytes());
        bytes[cursor + 16..cursor + 24].copy_from_slice(&(COLS as u64).to_le_bytes());
        cursor += 24;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0003u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(8u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 0x13;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&(4u32).to_le_bytes());
        cursor += 8;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0008u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(19u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 3;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 2;
        bytes[cursor + 3..cursor + 11]
            .copy_from_slice(&(INTERNAL_ROOT_OFFSET as u64).to_le_bytes());
        bytes[cursor + 11..cursor + 15].copy_from_slice(&(CHUNK_ROWS as u32).to_le_bytes());
        bytes[cursor + 15..cursor + 19].copy_from_slice(&(CHUNK_COLS as u32).to_le_bytes());

        bytes[INTERNAL_ROOT_OFFSET..INTERNAL_ROOT_OFFSET + 4].copy_from_slice(b"TREE");
        bytes[INTERNAL_ROOT_OFFSET + 4] = 1;
        bytes[INTERNAL_ROOT_OFFSET + 5] = 1;
        bytes[INTERNAL_ROOT_OFFSET + 6..INTERNAL_ROOT_OFFSET + 8]
            .copy_from_slice(&(2u16).to_le_bytes());
        bytes[INTERNAL_ROOT_OFFSET + 8..INTERNAL_ROOT_OFFSET + 16]
            .copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[INTERNAL_ROOT_OFFSET + 16..INTERNAL_ROOT_OFFSET + 24]
            .copy_from_slice(&u64::MAX.to_le_bytes());

        let mut node_cursor = INTERNAL_ROOT_OFFSET + 24;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(2u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(FIRST_LEAF_OFFSET as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(4u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(SECOND_LEAF_OFFSET as u64).to_le_bytes());

        let mut node_cursor = FIRST_LEAF_OFFSET;
        bytes[node_cursor..node_cursor + 4].copy_from_slice(b"TREE");
        bytes[node_cursor + 4] = 1;
        bytes[node_cursor + 5] = 0;
        bytes[node_cursor + 6..node_cursor + 8].copy_from_slice(&(1u16).to_le_bytes());
        bytes[node_cursor + 8..node_cursor + 16].copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[node_cursor + 16..node_cursor + 24].copy_from_slice(&u64::MAX.to_le_bytes());
        node_cursor += 24;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(payload_a.len() as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(PAYLOAD_A_OFFSET as u64).to_le_bytes());

        let mut node_cursor = SECOND_LEAF_OFFSET;
        bytes[node_cursor..node_cursor + 4].copy_from_slice(b"TREE");
        bytes[node_cursor + 4] = 1;
        bytes[node_cursor + 5] = 0;
        bytes[node_cursor + 6..node_cursor + 8].copy_from_slice(&(1u16).to_le_bytes());
        bytes[node_cursor + 8..node_cursor + 16].copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[node_cursor + 16..node_cursor + 24].copy_from_slice(&u64::MAX.to_le_bytes());
        node_cursor += 24;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(payload_b.len() as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(2u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(PAYLOAD_B_OFFSET as u64).to_le_bytes());

        bytes[PAYLOAD_A_OFFSET..PAYLOAD_A_OFFSET + payload_a.len()].copy_from_slice(&payload_a);
        bytes[PAYLOAD_B_OFFSET..PAYLOAD_B_OFFSET + payload_b.len()].copy_from_slice(&payload_b);

        file.write_all(&bytes)
            .expect("synthetic HDF5 internal-root fixture should be writable");
    }

    fn write_synthetic_hdf5_chunked_multilevel_root_fixture(file: &mut tempfile::NamedTempFile) {
        const DATASET_PATH: &str = "/ScienceData/NDVI_Chunked_MultiLevelRoot";
        const HEADER_OFFSET: usize = 1024;
        const ROOT_OFFSET: usize = 4096;
        const FIRST_INTERNAL_OFFSET: usize = 4168;
        const SECOND_INTERNAL_OFFSET: usize = 4256;
        const FIRST_LEAF_OFFSET: usize = 4344;
        const SECOND_LEAF_OFFSET: usize = 4432;
        const THIRD_LEAF_OFFSET: usize = 4520;
        const PAYLOAD_A_OFFSET: usize = 8192;
        const PAYLOAD_B_OFFSET: usize = 8208;
        const PAYLOAD_C_OFFSET: usize = 8224;
        const ROWS: usize = 2;
        const COLS: usize = 6;
        const CHUNK_ROWS: usize = 2;
        const CHUNK_COLS: usize = 2;

        let values_a = [0.5f32, 1.5, 4.5, 5.5];
        let values_b = [2.5f32, 3.5, 6.5, 7.5];
        let values_c = [8.5f32, 9.5, 10.5, 11.5];
        let mut payload_a = Vec::<u8>::new();
        let mut payload_b = Vec::<u8>::new();
        let mut payload_c = Vec::<u8>::new();
        for value in values_a {
            payload_a.extend_from_slice(&value.to_le_bytes());
        }
        for value in values_b {
            payload_b.extend_from_slice(&value.to_le_bytes());
        }
        for value in values_c {
            payload_c.extend_from_slice(&value.to_le_bytes());
        }

        let total_len = PAYLOAD_C_OFFSET + payload_c.len();
        let mut bytes = vec![0u8; total_len];
        let marker = DATASET_PATH.as_bytes();
        bytes[64..64 + marker.len()].copy_from_slice(marker);

        let mut cursor = HEADER_OFFSET;
        bytes[cursor] = 1;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(3u16).to_le_bytes());
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 12].copy_from_slice(&(95u32).to_le_bytes());
        bytes[cursor + 12..cursor + 16].copy_from_slice(&0u32.to_le_bytes());
        cursor += 16;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0001u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(24u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 2;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 16].copy_from_slice(&(ROWS as u64).to_le_bytes());
        bytes[cursor + 16..cursor + 24].copy_from_slice(&(COLS as u64).to_le_bytes());
        cursor += 24;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0003u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(8u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 0x13;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&(4u32).to_le_bytes());
        cursor += 8;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0008u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(19u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 3;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 2;
        bytes[cursor + 3..cursor + 11].copy_from_slice(&(ROOT_OFFSET as u64).to_le_bytes());
        bytes[cursor + 11..cursor + 15].copy_from_slice(&(CHUNK_ROWS as u32).to_le_bytes());
        bytes[cursor + 15..cursor + 19].copy_from_slice(&(CHUNK_COLS as u32).to_le_bytes());

        bytes[ROOT_OFFSET..ROOT_OFFSET + 4].copy_from_slice(b"TREE");
        bytes[ROOT_OFFSET + 4] = 1;
        bytes[ROOT_OFFSET + 5] = 2;
        bytes[ROOT_OFFSET + 6..ROOT_OFFSET + 8].copy_from_slice(&(2u16).to_le_bytes());
        bytes[ROOT_OFFSET + 8..ROOT_OFFSET + 16].copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[ROOT_OFFSET + 16..ROOT_OFFSET + 24].copy_from_slice(&u64::MAX.to_le_bytes());

        let mut node_cursor = ROOT_OFFSET + 24;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(2u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(FIRST_INTERNAL_OFFSET as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(6u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(SECOND_INTERNAL_OFFSET as u64).to_le_bytes());

        bytes[FIRST_INTERNAL_OFFSET..FIRST_INTERNAL_OFFSET + 4].copy_from_slice(b"TREE");
        bytes[FIRST_INTERNAL_OFFSET + 4] = 1;
        bytes[FIRST_INTERNAL_OFFSET + 5] = 1;
        bytes[FIRST_INTERNAL_OFFSET + 6..FIRST_INTERNAL_OFFSET + 8]
            .copy_from_slice(&(2u16).to_le_bytes());
        bytes[FIRST_INTERNAL_OFFSET + 8..FIRST_INTERNAL_OFFSET + 16]
            .copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[FIRST_INTERNAL_OFFSET + 16..FIRST_INTERNAL_OFFSET + 24]
            .copy_from_slice(&u64::MAX.to_le_bytes());
        let mut node_cursor = FIRST_INTERNAL_OFFSET + 24;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(2u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(FIRST_LEAF_OFFSET as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(4u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(SECOND_LEAF_OFFSET as u64).to_le_bytes());

        bytes[SECOND_INTERNAL_OFFSET..SECOND_INTERNAL_OFFSET + 4].copy_from_slice(b"TREE");
        bytes[SECOND_INTERNAL_OFFSET + 4] = 1;
        bytes[SECOND_INTERNAL_OFFSET + 5] = 1;
        bytes[SECOND_INTERNAL_OFFSET + 6..SECOND_INTERNAL_OFFSET + 8]
            .copy_from_slice(&(1u16).to_le_bytes());
        bytes[SECOND_INTERNAL_OFFSET + 8..SECOND_INTERNAL_OFFSET + 16]
            .copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[SECOND_INTERNAL_OFFSET + 16..SECOND_INTERNAL_OFFSET + 24]
            .copy_from_slice(&u64::MAX.to_le_bytes());
        let mut node_cursor = SECOND_INTERNAL_OFFSET + 24;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(6u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(THIRD_LEAF_OFFSET as u64).to_le_bytes());

        let mut node_cursor = FIRST_LEAF_OFFSET;
        bytes[node_cursor..node_cursor + 4].copy_from_slice(b"TREE");
        bytes[node_cursor + 4] = 1;
        bytes[node_cursor + 5] = 0;
        bytes[node_cursor + 6..node_cursor + 8].copy_from_slice(&(1u16).to_le_bytes());
        bytes[node_cursor + 8..node_cursor + 16].copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[node_cursor + 16..node_cursor + 24].copy_from_slice(&u64::MAX.to_le_bytes());
        node_cursor += 24;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(payload_a.len() as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(PAYLOAD_A_OFFSET as u64).to_le_bytes());

        let mut node_cursor = SECOND_LEAF_OFFSET;
        bytes[node_cursor..node_cursor + 4].copy_from_slice(b"TREE");
        bytes[node_cursor + 4] = 1;
        bytes[node_cursor + 5] = 0;
        bytes[node_cursor + 6..node_cursor + 8].copy_from_slice(&(1u16).to_le_bytes());
        bytes[node_cursor + 8..node_cursor + 16].copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[node_cursor + 16..node_cursor + 24].copy_from_slice(&u64::MAX.to_le_bytes());
        node_cursor += 24;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(payload_b.len() as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(2u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(PAYLOAD_B_OFFSET as u64).to_le_bytes());

        let mut node_cursor = THIRD_LEAF_OFFSET;
        bytes[node_cursor..node_cursor + 4].copy_from_slice(b"TREE");
        bytes[node_cursor + 4] = 1;
        bytes[node_cursor + 5] = 0;
        bytes[node_cursor + 6..node_cursor + 8].copy_from_slice(&(1u16).to_le_bytes());
        bytes[node_cursor + 8..node_cursor + 16].copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[node_cursor + 16..node_cursor + 24].copy_from_slice(&u64::MAX.to_le_bytes());
        node_cursor += 24;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(payload_c.len() as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(4u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(PAYLOAD_C_OFFSET as u64).to_le_bytes());

        bytes[PAYLOAD_A_OFFSET..PAYLOAD_A_OFFSET + payload_a.len()].copy_from_slice(&payload_a);
        bytes[PAYLOAD_B_OFFSET..PAYLOAD_B_OFFSET + payload_b.len()].copy_from_slice(&payload_b);
        bytes[PAYLOAD_C_OFFSET..PAYLOAD_C_OFFSET + payload_c.len()].copy_from_slice(&payload_c);

        file.write_all(&bytes)
            .expect("synthetic HDF5 multilevel-root fixture should be writable");
    }

    fn write_synthetic_hdf5_chunked_malformed_multilevel_root_fixture(
        file: &mut tempfile::NamedTempFile,
    ) {
        const DATASET_PATH: &str = "/ScienceData/NDVI_Chunked_MalformedMultiLevel";
        const HEADER_OFFSET: usize = 1024;
        const ROOT_OFFSET: usize = 4096;
        const ROWS: usize = 2;
        const COLS: usize = 4;
        const CHUNK_ROWS: usize = 2;
        const CHUNK_COLS: usize = 2;

        let total_len = ROOT_OFFSET + 64;
        let mut bytes = vec![0u8; total_len];
        let marker = DATASET_PATH.as_bytes();
        bytes[64..64 + marker.len()].copy_from_slice(marker);

        let mut cursor = HEADER_OFFSET;
        bytes[cursor] = 1;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(3u16).to_le_bytes());
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 12].copy_from_slice(&(95u32).to_le_bytes());
        bytes[cursor + 12..cursor + 16].copy_from_slice(&0u32.to_le_bytes());
        cursor += 16;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0001u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(24u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 2;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 16].copy_from_slice(&(ROWS as u64).to_le_bytes());
        bytes[cursor + 16..cursor + 24].copy_from_slice(&(COLS as u64).to_le_bytes());
        cursor += 24;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0003u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(8u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 0x13;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&(4u32).to_le_bytes());
        cursor += 8;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0008u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(19u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 3;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 2;
        bytes[cursor + 3..cursor + 11].copy_from_slice(&(ROOT_OFFSET as u64).to_le_bytes());
        bytes[cursor + 11..cursor + 15].copy_from_slice(&(CHUNK_ROWS as u32).to_le_bytes());
        bytes[cursor + 15..cursor + 19].copy_from_slice(&(CHUNK_COLS as u32).to_le_bytes());

        bytes[ROOT_OFFSET..ROOT_OFFSET + 4].copy_from_slice(b"TREE");
        bytes[ROOT_OFFSET + 4] = 1;
        bytes[ROOT_OFFSET + 5] = 2;
        bytes[ROOT_OFFSET + 6..ROOT_OFFSET + 8].copy_from_slice(&(1u16).to_le_bytes());
        bytes[ROOT_OFFSET + 8..ROOT_OFFSET + 16].copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[ROOT_OFFSET + 16..ROOT_OFFSET + 24].copy_from_slice(&u64::MAX.to_le_bytes());

        file.write_all(&bytes)
            .expect("synthetic malformed multilevel-root fixture should be writable");
    }

    fn write_synthetic_hdf5_chunked_malformed_multilevel_fanout_fixture(
        file: &mut tempfile::NamedTempFile,
    ) {
        const DATASET_PATH: &str = "/ScienceData/NDVI_Chunked_MalformedMultiLevelFanout";
        const HEADER_OFFSET: usize = 1024;
        const ROOT_OFFSET: usize = 4096;
        const FIRST_INTERNAL_OFFSET: usize = 4168;
        const SECOND_INTERNAL_OFFSET: usize = 4256;
        const FIRST_LEAF_OFFSET: usize = 4344;
        const SECOND_LEAF_OFFSET: usize = 4432;
        const ROWS: usize = 2;
        const COLS: usize = 6;
        const CHUNK_ROWS: usize = 2;
        const CHUNK_COLS: usize = 2;

        let total_len = SECOND_LEAF_OFFSET + 64;
        let mut bytes = vec![0u8; total_len];
        let marker = DATASET_PATH.as_bytes();
        bytes[64..64 + marker.len()].copy_from_slice(marker);

        let mut cursor = HEADER_OFFSET;
        bytes[cursor] = 1;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(3u16).to_le_bytes());
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 12].copy_from_slice(&(95u32).to_le_bytes());
        bytes[cursor + 12..cursor + 16].copy_from_slice(&0u32.to_le_bytes());
        cursor += 16;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0001u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(24u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 2;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&0u32.to_le_bytes());
        bytes[cursor + 8..cursor + 16].copy_from_slice(&(ROWS as u64).to_le_bytes());
        bytes[cursor + 16..cursor + 24].copy_from_slice(&(COLS as u64).to_le_bytes());
        cursor += 24;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0003u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(8u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 0x13;
        bytes[cursor + 1] = 0;
        bytes[cursor + 2] = 0;
        bytes[cursor + 3] = 0;
        bytes[cursor + 4..cursor + 8].copy_from_slice(&(4u32).to_le_bytes());
        cursor += 8;

        bytes[cursor..cursor + 2].copy_from_slice(&(0x0008u16).to_le_bytes());
        bytes[cursor + 2..cursor + 4].copy_from_slice(&(19u16).to_le_bytes());
        bytes[cursor + 4] = 0;
        bytes[cursor + 5..cursor + 8].copy_from_slice(&[0, 0, 0]);
        cursor += 8;
        bytes[cursor] = 3;
        bytes[cursor + 1] = 2;
        bytes[cursor + 2] = 2;
        bytes[cursor + 3..cursor + 11].copy_from_slice(&(ROOT_OFFSET as u64).to_le_bytes());
        bytes[cursor + 11..cursor + 15].copy_from_slice(&(CHUNK_ROWS as u32).to_le_bytes());
        bytes[cursor + 15..cursor + 19].copy_from_slice(&(CHUNK_COLS as u32).to_le_bytes());

        bytes[ROOT_OFFSET..ROOT_OFFSET + 4].copy_from_slice(b"TREE");
        bytes[ROOT_OFFSET + 4] = 1;
        bytes[ROOT_OFFSET + 5] = 2;
        bytes[ROOT_OFFSET + 6..ROOT_OFFSET + 8].copy_from_slice(&(2u16).to_le_bytes());
        bytes[ROOT_OFFSET + 8..ROOT_OFFSET + 16].copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[ROOT_OFFSET + 16..ROOT_OFFSET + 24].copy_from_slice(&u64::MAX.to_le_bytes());
        let mut node_cursor = ROOT_OFFSET + 24;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(2u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(FIRST_INTERNAL_OFFSET as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(6u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(SECOND_INTERNAL_OFFSET as u64).to_le_bytes());

        bytes[FIRST_INTERNAL_OFFSET..FIRST_INTERNAL_OFFSET + 4].copy_from_slice(b"TREE");
        bytes[FIRST_INTERNAL_OFFSET + 4] = 1;
        bytes[FIRST_INTERNAL_OFFSET + 5] = 1;
        bytes[FIRST_INTERNAL_OFFSET + 6..FIRST_INTERNAL_OFFSET + 8]
            .copy_from_slice(&(2u16).to_le_bytes());
        bytes[FIRST_INTERNAL_OFFSET + 8..FIRST_INTERNAL_OFFSET + 16]
            .copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[FIRST_INTERNAL_OFFSET + 16..FIRST_INTERNAL_OFFSET + 24]
            .copy_from_slice(&u64::MAX.to_le_bytes());
        let mut node_cursor = FIRST_INTERNAL_OFFSET + 24;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(2u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(FIRST_LEAF_OFFSET as u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(4u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8]
            .copy_from_slice(&(SECOND_LEAF_OFFSET as u64).to_le_bytes());

        bytes[FIRST_LEAF_OFFSET..FIRST_LEAF_OFFSET + 4].copy_from_slice(b"TREE");
        bytes[FIRST_LEAF_OFFSET + 4] = 1;
        bytes[FIRST_LEAF_OFFSET + 5] = 0;
        bytes[FIRST_LEAF_OFFSET + 6..FIRST_LEAF_OFFSET + 8].copy_from_slice(&(1u16).to_le_bytes());
        bytes[FIRST_LEAF_OFFSET + 8..FIRST_LEAF_OFFSET + 16]
            .copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[FIRST_LEAF_OFFSET + 16..FIRST_LEAF_OFFSET + 24]
            .copy_from_slice(&u64::MAX.to_le_bytes());
        node_cursor = FIRST_LEAF_OFFSET + 24;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(16u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(8192u64).to_le_bytes());

        bytes[SECOND_LEAF_OFFSET..SECOND_LEAF_OFFSET + 4].copy_from_slice(b"TREE");
        bytes[SECOND_LEAF_OFFSET + 4] = 1;
        bytes[SECOND_LEAF_OFFSET + 5] = 0;
        bytes[SECOND_LEAF_OFFSET + 6..SECOND_LEAF_OFFSET + 8]
            .copy_from_slice(&(1u16).to_le_bytes());
        bytes[SECOND_LEAF_OFFSET + 8..SECOND_LEAF_OFFSET + 16]
            .copy_from_slice(&u64::MAX.to_le_bytes());
        bytes[SECOND_LEAF_OFFSET + 16..SECOND_LEAF_OFFSET + 24]
            .copy_from_slice(&u64::MAX.to_le_bytes());
        node_cursor = SECOND_LEAF_OFFSET + 24;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(16u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&0u64.to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(2u64).to_le_bytes());
        node_cursor += 8;
        bytes[node_cursor..node_cursor + 8].copy_from_slice(&(8208u64).to_le_bytes());

        file.write_all(&bytes)
            .expect("synthetic malformed multilevel-fanout fixture should be writable");
    }

    fn encode_f32_values_as_zlib(values: &[f32]) -> Vec<u8> {
        let mut encoder = ZlibEncoder::new(Vec::new(), Compression::default());
        for value in values {
            encoder
                .write_all(&value.to_le_bytes())
                .expect("zlib encoder should accept f32 bytes");
        }
        encoder
            .finish()
            .expect("zlib encoder should finish synthetic payload")
    }

    #[test]
    fn raster_read_hdf4_dataset_uri_reads_supported_layout() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".hdf")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf4_i16_fixture(&mut tmp);

        let uri = format!("{}:///GridA/FieldA", tmp.path().to_string_lossy());
        let raster = Raster::read(&uri).expect("HDF4 dataset URI should decode to raster");

        assert_eq!(raster.rows, 2);
        assert_eq!(raster.cols, 4);
        assert_eq!(raster.bands, 1);
        assert_eq!(raster.data_type, DataType::I16);
        assert_eq!(raster.get(0, 0, 0), 1.0);
        assert_eq!(raster.get(0, 1, 3), 8.0);
    }

    #[test]
    fn raster_read_hdf4_dataset_uri_reads_supported_layout_with_canonical_selector() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".hdf")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf4_i16_fixture(&mut tmp);

        let uri = format!("{}#dataset=/GridA/FieldA", tmp.path().to_string_lossy());
        let raster =
            Raster::read(&uri).expect("canonical HDF4 dataset URI should decode to raster");

        assert_eq!(raster.rows, 2);
        assert_eq!(raster.cols, 4);
        assert_eq!(raster.get(0, 0, 0), 1.0);
        assert_eq!(raster.get(0, 1, 3), 8.0);
    }

    #[test]
    fn raster_read_hdf_dataset_uri_reports_missing_dataset_path() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".hdf")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf4_i16_fixture(&mut tmp);

        let uri = format!("{}:///GridA/DoesNotExist", tmp.path().to_string_lossy());
        let err = Raster::read(&uri).expect_err("missing dataset path should fail");
        assert!(err.to_string().contains("dataset path resolution failed"));
    }

    #[test]
    fn raster_read_hdf5_dataset_uri_reads_supported_gedi_path() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".h5")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf5_gedi_contiguous_fixture(&mut tmp);

        let uri = format!(
            "{}:///BEAM0000/elev_lowestmode",
            tmp.path().to_string_lossy()
        );
        let raster = Raster::read(&uri).expect("HDF5 GEDI URI should materialize to raster");

        assert_eq!(raster.rows, 1);
        assert_eq!(raster.cols, 89_634);
        assert_eq!(raster.bands, 1);
        assert_eq!(raster.data_type, DataType::F32);
        assert_eq!(raster.get(0, 0, 0), 0.0);
        assert_eq!(raster.get(0, 0, 12_345), 12_345.0);
        assert_eq!(raster.get(0, 0, 89_633), 89_633.0);
    }

    #[test]
    fn raster_read_hdf5_dataset_uri_reads_supported_gedi_path_with_canonical_selector() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".h5")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf5_gedi_contiguous_fixture(&mut tmp);

        let uri = format!(
            "{}#dataset=/BEAM0000/elev_lowestmode",
            tmp.path().to_string_lossy()
        );
        let raster =
            Raster::read(&uri).expect("canonical HDF5 GEDI URI should materialize to raster");

        assert_eq!(raster.rows, 1);
        assert_eq!(raster.cols, 89_634);
        assert_eq!(raster.get(0, 0, 0), 0.0);
        assert_eq!(raster.get(0, 0, 12_345), 12_345.0);
    }

    #[test]
    fn raster_read_hdf5_dataset_uri_reads_supported_viirs_xdim_path() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".h5")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf5_viirs_xdim_fixture(&mut tmp);

        let uri = format!(
            "{}:///HDFEOS/GRIDS/VIIRS_Grid_8Day_VI_500m/XDim",
            tmp.path().to_string_lossy()
        );
        let raster = Raster::read(&uri).expect("HDF5 VIIRS URI should materialize to raster");

        assert_eq!(raster.rows, 1);
        assert_eq!(raster.cols, 2_400);
        assert_eq!(raster.bands, 1);
        assert_eq!(raster.data_type, DataType::F64);
        assert_eq!(raster.get(0, 0, 0), 0.5);
        assert_eq!(raster.get(0, 0, 1_234), 1_234.5);
        assert_eq!(raster.get(0, 0, 2_399), 2_399.5);
    }

    #[test]
    fn raster_read_hdf5_dataset_uri_reads_generic_contiguous_f32_path() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".h5")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf5_generic_contiguous_f32_fixture(&mut tmp);

        let uri = format!("{}#dataset=/ScienceData/NDVI", tmp.path().to_string_lossy());
        let raster = Raster::read(&uri).expect("generic contiguous HDF5 URI should materialize");

        assert_eq!(raster.rows, 1);
        assert_eq!(raster.cols, 12);
        assert_eq!(raster.bands, 1);
        assert_eq!(raster.data_type, DataType::F32);
        assert_eq!(raster.get(0, 0, 0), 0.0);
        assert_eq!(raster.get(0, 0, 4), 1.0);
        assert_eq!(raster.get(0, 0, 11), 2.75);
    }

    #[test]
    fn raster_read_hdf5_dataset_uri_reads_chunked_single_chunk_f32_path() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".h5")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf5_chunked_single_chunk_f32_fixture(&mut tmp);

        let uri = format!(
            "{}#dataset=/ScienceData/NDVI_Chunked",
            tmp.path().to_string_lossy()
        );
        let raster = Raster::read(&uri).expect("chunked single-chunk HDF5 URI should materialize");

        assert_eq!(raster.rows, 2);
        assert_eq!(raster.cols, 3);
        assert_eq!(raster.bands, 1);
        assert_eq!(raster.data_type, DataType::F32);
        assert_eq!(raster.get(0, 0, 0), 0.5);
        assert_eq!(raster.get(0, 0, 2), 2.5);
        assert_eq!(raster.get(0, 1, 2), 5.5);
    }

    #[test]
    fn raster_read_hdf5_dataset_uri_reads_chunked_two_chunk_f32_path() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".h5")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf5_chunked_two_chunk_f32_fixture(&mut tmp);

        let uri = format!(
            "{}#dataset=/ScienceData/NDVI_Chunked_Two",
            tmp.path().to_string_lossy()
        );
        let raster = Raster::read(&uri).expect("chunked two-chunk HDF5 URI should materialize");

        assert_eq!(raster.rows, 2);
        assert_eq!(raster.cols, 4);
        assert_eq!(raster.bands, 1);
        assert_eq!(raster.data_type, DataType::F32);
        assert_eq!(raster.get(0, 0, 0), 0.5);
        assert_eq!(raster.get(0, 0, 3), 3.5);
        assert_eq!(raster.get(0, 1, 0), 4.5);
        assert_eq!(raster.get(0, 1, 3), 7.5);
    }

    #[test]
    fn raster_read_hdf5_dataset_uri_reads_chunked_two_chunk_f32_deflate_path() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".h5")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf5_chunked_two_chunk_f32_deflate_fixture(&mut tmp);

        let uri = format!(
            "{}#dataset=/ScienceData/NDVI_Chunked_Two_Deflate",
            tmp.path().to_string_lossy()
        );
        let raster =
            Raster::read(&uri).expect("chunked deflate two-chunk HDF5 URI should materialize");

        assert_eq!(raster.rows, 2);
        assert_eq!(raster.cols, 4);
        assert_eq!(raster.bands, 1);
        assert_eq!(raster.data_type, DataType::F32);
        assert_eq!(raster.get(0, 0, 0), 0.5);
        assert_eq!(raster.get(0, 0, 3), 3.5);
        assert_eq!(raster.get(0, 1, 0), 4.5);
        assert_eq!(raster.get(0, 1, 3), 7.5);
    }

    #[test]
    fn raster_read_hdf5_dataset_uri_reads_chunked_two_leaf_f32_path() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".h5")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf5_chunked_two_leaf_f32_fixture(&mut tmp);

        let uri = format!(
            "{}#dataset=/ScienceData/NDVI_Chunked_Two_Leaf",
            tmp.path().to_string_lossy()
        );
        let raster = Raster::read(&uri).expect("chunked two-leaf HDF5 URI should materialize");

        assert_eq!(raster.rows, 2);
        assert_eq!(raster.cols, 4);
        assert_eq!(raster.bands, 1);
        assert_eq!(raster.data_type, DataType::F32);
        assert_eq!(raster.get(0, 0, 0), 0.5);
        assert_eq!(raster.get(0, 0, 3), 3.5);
        assert_eq!(raster.get(0, 1, 0), 4.5);
        assert_eq!(raster.get(0, 1, 3), 7.5);
    }

    #[test]
    fn raster_read_hdf5_dataset_uri_reads_chunked_internal_root_f32_path() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".h5")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf5_chunked_internal_root_fixture(&mut tmp);

        let uri = format!(
            "{}#dataset=/ScienceData/NDVI_Chunked_InternalRoot",
            tmp.path().to_string_lossy()
        );
        let raster = Raster::read(&uri).expect("internal-root chunk index should materialize");
        assert_eq!(raster.rows, 2);
        assert_eq!(raster.cols, 4);
        assert_eq!(raster.bands, 1);
        assert_eq!(raster.data_type, DataType::F32);
        assert_eq!(raster.get(0, 0, 0), 0.5);
        assert_eq!(raster.get(0, 0, 3), 3.5);
        assert_eq!(raster.get(0, 1, 0), 4.5);
        assert_eq!(raster.get(0, 1, 3), 7.5);
    }

    #[test]
    fn raster_read_hdf5_dataset_uri_reads_chunked_multilevel_root_f32_path() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".h5")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf5_chunked_multilevel_root_fixture(&mut tmp);

        let uri = format!(
            "{}#dataset=/ScienceData/NDVI_Chunked_MultiLevelRoot",
            tmp.path().to_string_lossy()
        );
        let raster = Raster::read(&uri).expect("multilevel root chunk index should materialize");
        assert_eq!(raster.rows, 2);
        assert_eq!(raster.cols, 6);
        assert_eq!(raster.bands, 1);
        assert_eq!(raster.data_type, DataType::F32);
        assert_eq!(raster.get(0, 0, 0), 0.5);
        assert_eq!(raster.get(0, 0, 3), 3.5);
        assert_eq!(raster.get(0, 0, 5), 9.5);
        assert_eq!(raster.get(0, 1, 0), 4.5);
        assert_eq!(raster.get(0, 1, 3), 7.5);
        assert_eq!(raster.get(0, 1, 5), 11.5);
    }

    #[test]
    fn raster_read_hdf5_dataset_uri_reports_malformed_multilevel_root_as_unsupported() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".h5")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf5_chunked_malformed_multilevel_root_fixture(&mut tmp);

        let uri = format!(
            "{}#dataset=/ScienceData/NDVI_Chunked_MalformedMultiLevel",
            tmp.path().to_string_lossy()
        );
        let err = Raster::read(&uri).expect_err("malformed multilevel root should fail explicitly");
        let msg = err.to_string();
        assert!(
            msg.contains("B-tree node is missing TREE signature")
                || msg.contains("exhausted internal-level budget")
                || msg.contains("internal-node cycle")
                || msg.contains("invalid child address"),
            "unexpected malformed-root diagnostic: {msg}"
        );
    }

    #[test]
    fn raster_read_hdf5_dataset_uri_reports_malformed_multilevel_fanout_as_unsupported() {
        let mut tmp = tempfile::Builder::new()
            .suffix(".h5")
            .tempfile()
            .expect("temp file should be created");
        write_synthetic_hdf5_chunked_malformed_multilevel_fanout_fixture(&mut tmp);

        let uri = format!(
            "{}#dataset=/ScienceData/NDVI_Chunked_MalformedMultiLevelFanout",
            tmp.path().to_string_lossy()
        );
        let err =
            Raster::read(&uri).expect_err("malformed multilevel fanout should fail explicitly");
        let msg = err.to_string();
        assert!(
            msg.contains("B-tree node is missing TREE signature")
                || msg.contains("exhausted internal-level budget")
                || msg.contains("internal-node cycle")
                || msg.contains("invalid child address"),
            "unexpected malformed-fanout diagnostic: {msg}"
        );
    }

    #[test]
    fn raster_read_hdf5_dataset_uri_reports_unimplemented_materialization() {
        let err = Raster::read("mock_scene.h5:///ScienceData/DoesNotExist")
            .expect_err("HDF5 dataset URI should currently fail explicitly");
        assert!(err
            .to_string()
            .contains("HDF5 dataset path resolution failed"));
    }

    #[test]
    fn get_set() {
        let mut r = make_raster();
        assert_eq!(r.get(0, 0, 0), 0.0);
        assert_eq!(r.get(0, 2, 3), 11.0);
        r.set(0, 1, 1, -9999.0).unwrap();
        assert!(r.is_nodata(r.get(0, 1, 1))); // nodata
        assert_eq!(r.get_opt(0, 1, 1), None); // optional accessor
    }

    #[test]
    fn statistics() {
        let r = make_raster();
        let s = r.statistics();
        assert_eq!(s.valid_count, 12);
        assert_eq!(s.min, 0.0);
        assert_eq!(s.max, 11.0);
        assert!((s.mean - 5.5).abs() < 1e-10);
    }

    #[test]
    fn world_to_pixel() {
        let r = make_raster();
        // y_max = 30.0, x_max = 40.0
        assert_eq!(r.world_to_pixel(5.0, 25.0), Some((0, 0)));
        assert_eq!(r.world_to_pixel(35.0, 5.0), Some((3, 2)));
        assert_eq!(r.world_to_pixel(-1.0, 0.0), None);
    }

    #[test]
    fn extent() {
        let r = make_raster();
        let e = r.extent();
        assert_eq!(e.x_min, 0.0);
        assert_eq!(e.y_min, 0.0);
        assert_eq!(e.x_max, 40.0);
        assert_eq!(e.y_max, 30.0);
    }

    #[test]
    fn sample_extent_boundary_points_count_and_corners() {
        let e = Extent {
            x_min: 0.0,
            y_min: 0.0,
            x_max: 10.0,
            y_max: 5.0,
        };
        let pts = sample_extent_boundary_points(e, 8);
        assert_eq!(pts.len(), 32);
        assert!(pts.contains(&(0.0, 0.0)));
        assert!(pts.contains(&(0.0, 5.0)));
        assert!(pts.contains(&(10.0, 0.0)));
        assert!(pts.contains(&(10.0, 5.0)));
    }

    #[test]
    fn sample_extent_boundary_points_minimum_sampling_when_zero_requested() {
        let e = Extent {
            x_min: -1.0,
            y_min: -2.0,
            x_max: 3.0,
            y_max: 4.0,
        };
        let pts = sample_extent_boundary_points(e, 0);
        assert_eq!(pts.len(), 4);
        assert!(pts.contains(&(-1.0, -2.0)));
        assert!(pts.contains(&(-1.0, 4.0)));
        assert!(pts.contains(&(3.0, -2.0)));
        assert!(pts.contains(&(3.0, 4.0)));
    }

    #[test]
    fn minimal_wrapped_longitude_bounds_handles_antimeridian_cluster() {
        let lons = [179.0, -179.0, 178.0, -178.0];
        let (x0, x1) = minimal_wrapped_longitude_bounds(&lons).unwrap();
        assert!((x1 - x0) < 6.0);
    }

    #[test]
    fn antimeridian_aware_longitude_bounds_prefers_wrapped_interval() {
        let lons = [179.5, -179.5, 179.0, -179.0];
        let (x0, x1) =
            antimeridian_aware_longitude_bounds(&lons, AntimeridianPolicy::Auto).unwrap();
        assert!((x1 - x0) < 5.0);
        assert!(x0 >= 0.0);
    }

    #[test]
    fn antimeridian_aware_longitude_bounds_keeps_linear_when_better() {
        let lons = [-20.0, -10.0, 0.0, 10.0];
        let (x0, x1) =
            antimeridian_aware_longitude_bounds(&lons, AntimeridianPolicy::Auto).unwrap();
        assert!((x0 - (-20.0)).abs() < 1e-12);
        assert!((x1 - 10.0).abs() < 1e-12);
    }

    #[test]
    fn antimeridian_policy_controls_wrapped_vs_linear_behavior() {
        let lons = [179.5, -179.5, 179.0, -179.0];

        let (ax0, ax1) =
            antimeridian_aware_longitude_bounds(&lons, AntimeridianPolicy::Auto).unwrap();
        let (lx0, lx1) =
            antimeridian_aware_longitude_bounds(&lons, AntimeridianPolicy::Linear).unwrap();
        let (wx0, wx1) =
            antimeridian_aware_longitude_bounds(&lons, AntimeridianPolicy::Wrap).unwrap();

        assert!((ax1 - ax0) < (lx1 - lx0));
        assert!((wx1 - wx0) < (lx1 - lx0));
        assert!((wx1 - wx0 - (ax1 - ax0)).abs() < 1e-9);
    }

    #[test]
    fn reproject_antimeridian_policy_linear_vs_wrap_changes_default_extent() {
        let cfg = RasterConfig {
            cols: 8,
            rows: 4,
            x_min: 170.0,
            y_min: -10.0,
            cell_size: 2.5,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut r = Raster::new(cfg);
        r.crs = CrsInfo::from_epsg(4326);
        for row in 0..r.rows {
            for col in 0..r.cols {
                r.set(0, row as isize, col as isize, (row * r.cols + col) as f64)
                    .unwrap();
            }
        }

        let linear_opts = ReprojectOptions::new(4326, ResampleMethod::Nearest)
            .with_antimeridian_policy(AntimeridianPolicy::Linear);
        let wrap_opts = ReprojectOptions::new(4326, ResampleMethod::Nearest)
            .with_antimeridian_policy(AntimeridianPolicy::Wrap);

        let linear = r.reproject_with_options(&linear_opts).unwrap();
        let wrap = r.reproject_with_options(&wrap_opts).unwrap();

        let linear_width = linear.x_max() - linear.x_min;
        let wrap_width = wrap.x_max() - wrap.x_min;

        assert!(linear_width.is_finite() && linear_width > 0.0);
        assert!(wrap_width.is_finite() && wrap_width > 0.0);
        assert!(wrap_width <= linear_width + 1e-9);
    }

    #[test]
    fn reproject_antimeridian_policy_auto_matches_narrower_interval() {
        let cfg = RasterConfig {
            cols: 8,
            rows: 4,
            x_min: 170.0,
            y_min: -10.0,
            cell_size: 2.5,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut r = Raster::new(cfg);
        r.crs = CrsInfo::from_epsg(4326);
        for row in 0..r.rows {
            for col in 0..r.cols {
                r.set(0, row as isize, col as isize, (row * r.cols + col) as f64)
                    .unwrap();
            }
        }

        let linear = r
            .reproject_with_options(
                &ReprojectOptions::new(4326, ResampleMethod::Nearest)
                    .with_antimeridian_policy(AntimeridianPolicy::Linear),
            )
            .unwrap();
        let wrap = r
            .reproject_with_options(
                &ReprojectOptions::new(4326, ResampleMethod::Nearest)
                    .with_antimeridian_policy(AntimeridianPolicy::Wrap),
            )
            .unwrap();
        let auto = r
            .reproject_with_options(
                &ReprojectOptions::new(4326, ResampleMethod::Nearest)
                    .with_antimeridian_policy(AntimeridianPolicy::Auto),
            )
            .unwrap();

        let linear_width = linear.x_max() - linear.x_min;
        let wrap_width = wrap.x_max() - wrap.x_min;
        let auto_width = auto.x_max() - auto.x_min;

        let expected = linear_width.min(wrap_width);
        assert!((auto_width - expected).abs() < 1e-9);
    }

    #[test]
    fn reproject_to_epsg_requires_source_epsg() {
        let r = make_raster();
        let err = r.reproject_to_epsg_nearest(3857).unwrap_err();
        assert!(err
            .to_string()
            .contains("requires source CRS EPSG in raster.crs.epsg"));
    }

    #[test]
    fn reproject_with_crs_allows_missing_source_epsg() {
        let cfg = RasterConfig {
            cols: 4,
            rows: 4,
            x_min: -1.0,
            y_min: -1.0,
            cell_size: 0.5,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut r = Raster::new(cfg);
        // Intentionally leave `r.crs.epsg` unset.
        for row in 0..4 {
            for col in 0..4 {
                r.set(0, row, col, (row * 4 + col) as f64).unwrap();
            }
        }

        let src = Crs::from_epsg(4326).unwrap();
        let dst = Crs::from_epsg(3857).unwrap();
        let opts = ReprojectOptions::new(3857, ResampleMethod::Nearest);

        let out = r.reproject_with_crs(&src, &dst, &opts).unwrap();
        assert_eq!(out.cols, 4);
        assert_eq!(out.rows, 4);
        assert_eq!(out.crs.epsg, Some(3857));
        assert!(out.statistics().valid_count > 0);
    }

    #[test]
    fn reproject_with_options_and_progress_emits_live_updates() {
        let cfg = RasterConfig {
            cols: 6,
            rows: 5,
            x_min: -80.0,
            y_min: 40.0,
            cell_size: 0.1,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut r = Raster::new(cfg);
        r.crs = CrsInfo::from_epsg(4326);
        for row in 0..r.rows {
            for col in 0..r.cols {
                r.set(0, row as isize, col as isize, (row * r.cols + col) as f64)
                    .unwrap();
            }
        }

        let progress_values: Arc<Mutex<Vec<f64>>> = Arc::new(Mutex::new(Vec::new()));
        let sink = Arc::clone(&progress_values);

        let out = r
            .reproject_with_options_and_progress(
                &ReprojectOptions::new(3857, ResampleMethod::Nearest),
                move |pct| {
                    sink.lock().unwrap().push(pct);
                },
            )
            .unwrap();

        let values = progress_values.lock().unwrap();
        assert!(!values.is_empty());
        assert_eq!(values.len(), out.rows + 1);
        assert!(values
            .iter()
            .all(|v| v.is_finite() && *v >= 0.0 && *v <= 1.0));
        assert!((values.last().copied().unwrap() - 1.0).abs() < 1e-12);
    }

    #[test]
    fn reproject_to_epsg_identity_preserves_data() {
        let mut r = make_raster();
        r.crs = CrsInfo::from_epsg(4326);

        let r2 = r.reproject_to_epsg(4326, ResampleMethod::Nearest).unwrap();
        assert_eq!(r2.cols, r.cols);
        assert_eq!(r2.rows, r.rows);
        assert_eq!(r2.bands, r.bands);
        assert_eq!(r2.crs.epsg, Some(4326));
        assert_eq!(r2.get(0, 0, 0), r.get(0, 0, 0));
        assert_eq!(r2.get(0, 2, 3), r.get(0, 2, 3));
    }

    #[test]
    fn reproject_to_epsg_4326_to_3857_produces_valid_output() {
        let cfg = RasterConfig {
            cols: 4,
            rows: 4,
            x_min: -1.0,
            y_min: -1.0,
            cell_size: 0.5,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut r = Raster::new(cfg);
        r.crs = CrsInfo::from_epsg(4326);
        for row in 0..4 {
            for col in 0..4 {
                r.set(0, row, col, (row * 4 + col) as f64).unwrap();
            }
        }

        let out = r.reproject_to_epsg_nearest(3857).unwrap();
        assert_eq!(out.cols, 4);
        assert_eq!(out.rows, 4);
        assert_eq!(out.crs.epsg, Some(3857));
        assert!(out.x_min.is_finite());
        assert!(out.y_min.is_finite());
        assert!(out.cell_size_x.is_finite() && out.cell_size_x > 0.0);
        assert!(out.cell_size_y.is_finite() && out.cell_size_y > 0.0);
        let s = out.statistics();
        assert!(s.valid_count > 0);
    }

    #[test]
    fn reproject_to_match_grid_honors_target_grid_definition() {
        let src_cfg = RasterConfig {
            cols: 6,
            rows: 4,
            x_min: -3.0,
            y_min: -2.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut src = Raster::new(src_cfg);
        src.crs = CrsInfo::from_epsg(4326);
        for row in 0..src.rows {
            for col in 0..src.cols {
                src.set(0, row as isize, col as isize, (row * src.cols + col) as f64)
                    .unwrap();
            }
        }

        let target_cfg = RasterConfig {
            cols: 12,
            rows: 10,
            x_min: -500_000.0,
            y_min: -400_000.0,
            cell_size: 1.0,
            cell_size_y: Some(1.0),
            nodata: -9999.0,
            ..Default::default()
        };
        let mut target = Raster::new(target_cfg);
        target.crs = CrsInfo::from_epsg(3857);
        target.cell_size_x = (500_000.0 - (-500_000.0)) / target.cols as f64;
        target.cell_size_y = (400_000.0 - (-400_000.0)) / target.rows as f64;

        let out = src
            .reproject_to_match_grid(&target, ResampleMethod::Bilinear)
            .unwrap();

        assert_eq!(out.cols, target.cols);
        assert_eq!(out.rows, target.rows);
        assert_eq!(out.crs.epsg, target.crs.epsg);
        assert!((out.x_min - target.x_min).abs() < 1e-9);
        assert!((out.y_min - target.y_min).abs() < 1e-9);
        assert!((out.x_max() - target.x_max()).abs() < 1e-6);
        assert!((out.y_max() - target.y_max()).abs() < 1e-6);
        assert!(out.cell_size_x.is_finite() && out.cell_size_x > 0.0);
        assert!(out.cell_size_y.is_finite() && out.cell_size_y > 0.0);
    }

    #[test]
    fn reproject_to_match_resolution_honors_reference_cellsize_and_snap() {
        let src_cfg = RasterConfig {
            cols: 6,
            rows: 4,
            x_min: -3.0,
            y_min: -2.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut src = Raster::new(src_cfg);
        src.crs = CrsInfo::from_epsg(4326);
        for row in 0..src.rows {
            for col in 0..src.cols {
                src.set(0, row as isize, col as isize, (row * src.cols + col) as f64)
                    .unwrap();
            }
        }

        let mut reference = Raster::new(RasterConfig {
            cols: 4,
            rows: 3,
            x_min: 50_000.0,
            y_min: -75_000.0,
            cell_size: 100_000.0,
            cell_size_y: Some(80_000.0),
            nodata: -9999.0,
            ..Default::default()
        });
        reference.crs = CrsInfo::from_epsg(3857);

        let out = src
            .reproject_to_match_resolution(&reference, ResampleMethod::Nearest)
            .unwrap();

        assert_eq!(out.crs.epsg, Some(3857));
        assert!((out.cell_size_x - reference.cell_size_x).abs() < 1e-9);
        assert!((out.cell_size_y - reference.cell_size_y).abs() < 1e-9);

        let kx = ((out.x_min - reference.x_min) / reference.cell_size_x).round();
        let ky = ((out.y_min - reference.y_min) / reference.cell_size_y).round();
        assert!((out.x_min - (reference.x_min + kx * reference.cell_size_x)).abs() < 1e-6);
        assert!((out.y_min - (reference.y_min + ky * reference.cell_size_y)).abs() < 1e-6);
        assert!(out.cols > 0);
        assert!(out.rows > 0);
    }

    #[test]
    fn reproject_to_match_resolution_in_epsg_same_crs_matches_reference_settings() {
        let src_cfg = RasterConfig {
            cols: 6,
            rows: 4,
            x_min: -3.0,
            y_min: -2.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut src = Raster::new(src_cfg);
        src.crs = CrsInfo::from_epsg(4326);
        for row in 0..src.rows {
            for col in 0..src.cols {
                src.set(0, row as isize, col as isize, (row * src.cols + col) as f64)
                    .unwrap();
            }
        }

        let mut reference = Raster::new(RasterConfig {
            cols: 4,
            rows: 3,
            x_min: -10.0,
            y_min: -20.0,
            cell_size: 0.5,
            cell_size_y: Some(0.25),
            nodata: -9999.0,
            ..Default::default()
        });
        reference.crs = CrsInfo::from_epsg(4326);

        let out = src
            .reproject_to_match_resolution_in_epsg(4326, &reference, ResampleMethod::Nearest)
            .unwrap();

        assert_eq!(out.crs.epsg, Some(4326));
        assert!((out.cell_size_x - reference.cell_size_x).abs() < 1e-12);
        assert!((out.cell_size_y - reference.cell_size_y).abs() < 1e-12);
    }

    #[test]
    fn reproject_to_match_resolution_in_epsg_cross_crs_converts_resolution() {
        let src_cfg = RasterConfig {
            cols: 6,
            rows: 4,
            x_min: -3.0,
            y_min: -2.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut src = Raster::new(src_cfg);
        src.crs = CrsInfo::from_epsg(4326);
        for row in 0..src.rows {
            for col in 0..src.cols {
                src.set(0, row as isize, col as isize, (row * src.cols + col) as f64)
                    .unwrap();
            }
        }

        let mut reference = Raster::new(RasterConfig {
            cols: 4,
            rows: 3,
            x_min: 0.0,
            y_min: 0.0,
            cell_size: 1.0,
            cell_size_y: Some(1.0),
            nodata: -9999.0,
            ..Default::default()
        });
        reference.crs = CrsInfo::from_epsg(4326);

        let out = src
            .reproject_to_match_resolution_in_epsg(3857, &reference, ResampleMethod::Nearest)
            .unwrap();

        assert_eq!(out.crs.epsg, Some(3857));
        assert!(out.cell_size_x.is_finite());
        assert!(out.cell_size_y.is_finite());
        assert!(out.cell_size_x > 0.0);
        assert!(out.cell_size_y > 0.0);
    }

    #[test]
    fn reproject_to_epsg_bilinear_cubic_and_lanczos_produce_valid_output() {
        let cfg = RasterConfig {
            cols: 8,
            rows: 8,
            x_min: -2.0,
            y_min: -2.0,
            cell_size: 0.5,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut r = Raster::new(cfg);
        r.crs = CrsInfo::from_epsg(4326);
        for row in 0..8 {
            for col in 0..8 {
                let val = (col as f64) * 10.0 + row as f64;
                r.set(0, row, col, val).unwrap();
            }
        }

        let bilinear = r.reproject_to_epsg_bilinear(3857).unwrap();
        let cubic = r.reproject_to_epsg_cubic(3857).unwrap();
        let lanczos = r.reproject_to_epsg_lanczos(3857).unwrap();

        assert_eq!(bilinear.cols, 8);
        assert_eq!(bilinear.rows, 8);
        assert_eq!(bilinear.crs.epsg, Some(3857));
        assert!(bilinear.statistics().valid_count > 0);

        assert_eq!(cubic.cols, 8);
        assert_eq!(cubic.rows, 8);
        assert_eq!(cubic.crs.epsg, Some(3857));
        assert!(cubic.statistics().valid_count > 0);

        assert_eq!(lanczos.cols, 8);
        assert_eq!(lanczos.rows, 8);
        assert_eq!(lanczos.crs.epsg, Some(3857));
        assert!(lanczos.statistics().valid_count > 0);
    }

    #[test]
    fn reproject_with_options_honors_grid_controls() {
        let cfg = RasterConfig {
            cols: 6,
            rows: 4,
            x_min: -3.0,
            y_min: -2.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut r = Raster::new(cfg);
        r.crs = CrsInfo::from_epsg(4326);
        for row in 0..4 {
            for col in 0..6 {
                r.set(0, row, col, (row * 6 + col) as f64).unwrap();
            }
        }

        let opts = ReprojectOptions {
            dst_epsg: 3857,
            resample: ResampleMethod::Bilinear,
            cols: Some(12),
            rows: Some(10),
            extent: Some(Extent {
                x_min: -500_000.0,
                y_min: -400_000.0,
                x_max: 500_000.0,
                y_max: 400_000.0,
            }),
            x_res: None,
            y_res: None,
            snap_x: None,
            snap_y: None,
            nodata_policy: NodataPolicy::PartialKernel,
            antimeridian_policy: AntimeridianPolicy::Auto,
            grid_size_policy: GridSizePolicy::Expand,
            destination_footprint: DestinationFootprint::None,
            warn_on_area_of_use_mismatch: false,
            epoch_transform: EpochTransformOptions::default(),
        };

        let out = r.reproject_with_options(&opts).unwrap();
        assert_eq!(out.cols, 12);
        assert_eq!(out.rows, 10);
        assert!((out.x_min - (-500_000.0)).abs() < 1e-9);
        assert!((out.y_min - (-400_000.0)).abs() < 1e-9);
        assert!((out.x_max() - 500_000.0).abs() < 1e-6);
        assert!((out.y_max() - 400_000.0).abs() < 1e-6);
        assert_eq!(out.crs.epsg, Some(3857));
    }

    #[test]
    fn bilinear_partial_kernel_renormalizes_with_nodata() {
        let cfg = RasterConfig {
            cols: 2,
            rows: 2,
            x_min: 0.0,
            y_min: 0.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        // row-major top-down: [ [1, nodata], [3, 5] ]
        let r = Raster::from_data(cfg, vec![1.0, -9999.0, 3.0, 5.0]).unwrap();

        let v = r.sample_bilinear_partial_pixel(0, 0.5, 0.5).unwrap();
        // weighted average of valid neighbors only: (1 + 3 + 5) / 3 = 3
        assert!((v - 3.0).abs() < 1e-9);
    }

    #[test]
    fn bilinear_partial_kernel_handles_edges() {
        let cfg = RasterConfig {
            cols: 2,
            rows: 2,
            x_min: 0.0,
            y_min: 0.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let r = Raster::from_data(cfg, vec![10.0, 20.0, 30.0, 40.0]).unwrap();
        let v = r.sample_bilinear_partial_pixel(0, -0.2, 0.3).unwrap();
        assert!(v.is_finite());
    }

    #[test]
    fn cubic_partial_kernel_handles_edges_and_nodata() {
        let cfg = RasterConfig {
            cols: 4,
            rows: 4,
            x_min: 0.0,
            y_min: 0.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut data = Vec::new();
        for row in 0..4 {
            for col in 0..4 {
                data.push((row * 4 + col) as f64);
            }
        }
        data[5] = -9999.0; // inject one nodata sample
        let r = Raster::from_data(cfg, data).unwrap();

        let edge_v = r.sample_cubic_partial_pixel(0, -0.25, 0.2).unwrap();
        assert!(edge_v.is_finite());

        let nodata_v = r.sample_cubic_partial_pixel(0, 1.25, 1.25).unwrap();
        assert!(nodata_v.is_finite());
    }

    #[test]
    fn strict_policy_rejects_incomplete_bilinear_kernel() {
        let cfg = RasterConfig {
            cols: 2,
            rows: 2,
            x_min: 0.0,
            y_min: 0.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let r = Raster::from_data(cfg, vec![10.0, 20.0, 30.0, 40.0]).unwrap();

        assert!(r.sample_bilinear_strict_pixel(0, -0.2, 0.3).is_none());
        assert!(r.sample_bilinear_partial_pixel(0, -0.2, 0.3).is_some());
    }

    #[test]
    fn bilinear_strict_simd_matches_expected_for_f64_and_f32_storage() {
        let cfg_f64 = RasterConfig {
            cols: 2,
            rows: 2,
            x_min: 0.0,
            y_min: 0.0,
            cell_size: 1.0,
            nodata: -9999.0,
            data_type: DataType::F64,
            ..Default::default()
        };
        let cfg_f32 = RasterConfig {
            data_type: DataType::F32,
            ..cfg_f64.clone()
        };
        let data = vec![1.0, 2.0, 3.0, 5.0];
        let r64 = Raster::from_data(cfg_f64, data.clone()).unwrap();
        let r32 = Raster::from_data(cfg_f32, data).unwrap();

        let expected = 2.375;
        let v64 = r64.sample_bilinear_strict_pixel(0, 0.25, 0.5).unwrap();
        let v32 = r32.sample_bilinear_strict_pixel(0, 0.25, 0.5).unwrap();
        assert!((v64 - expected).abs() < 1e-9);
        assert!((v32 - expected).abs() < 1e-6);
    }

    #[test]
    fn lanczos_strict_simd_matches_between_f64_and_f32_storage() {
        let cfg_f64 = RasterConfig {
            cols: 16,
            rows: 16,
            x_min: 0.0,
            y_min: 0.0,
            cell_size: 1.0,
            nodata: -9999.0,
            data_type: DataType::F64,
            ..Default::default()
        };
        let cfg_f32 = RasterConfig {
            data_type: DataType::F32,
            ..cfg_f64.clone()
        };

        let mut data = Vec::with_capacity(16 * 16);
        for row in 0..16 {
            for col in 0..16 {
                data.push(((row * 16 + col) as f64).sin() * 100.0 + (row as f64 * 0.5));
            }
        }

        let r64 = Raster::from_data(cfg_f64, data.clone()).unwrap();
        let r32 = Raster::from_data(cfg_f32, data).unwrap();

        let v64 = r64.sample_lanczos_strict_pixel(0, 7.25, 8.5).unwrap();
        let v32 = r32.sample_lanczos_strict_pixel(0, 7.25, 8.5).unwrap();
        assert!((v64 - v32).abs() < 1e-4);
    }

    #[test]
    fn fill_policy_falls_back_to_nearest_for_bilinear() {
        let cfg = RasterConfig {
            cols: 2,
            rows: 2,
            x_min: 0.0,
            y_min: 0.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let r = Raster::from_data(cfg, vec![10.0, 20.0, 30.0, 40.0]).unwrap();

        let v = r.sample_world(0, 0.1, 1.1, ResampleMethod::Bilinear, NodataPolicy::Fill);
        assert_eq!(v, Some(10.0));
    }

    #[test]
    fn fill_policy_falls_back_to_nearest_for_lanczos() {
        let cfg = RasterConfig {
            cols: 2,
            rows: 2,
            x_min: 0.0,
            y_min: 0.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let r = Raster::from_data(cfg, vec![10.0, 20.0, 30.0, 40.0]).unwrap();

        let v = r.sample_world(0, 0.1, 1.1, ResampleMethod::Lanczos, NodataPolicy::Fill);
        assert_eq!(v, Some(10.0));
    }

    #[test]
    fn reproject_options_default_to_partial_kernel_policy() {
        let opts = ReprojectOptions::new(3857, ResampleMethod::Cubic);
        assert_eq!(opts.nodata_policy, NodataPolicy::PartialKernel);
        assert_eq!(opts.x_res, None);
        assert_eq!(opts.y_res, None);
        assert_eq!(opts.snap_x, None);
        assert_eq!(opts.snap_y, None);
        assert_eq!(opts.antimeridian_policy, AntimeridianPolicy::Auto);
        assert_eq!(opts.grid_size_policy, GridSizePolicy::Expand);
        assert_eq!(opts.destination_footprint, DestinationFootprint::None);

        let strict = opts.with_nodata_policy(NodataPolicy::Strict);
        assert_eq!(strict.nodata_policy, NodataPolicy::Strict);

        let sized = strict.with_size(321, 123);
        assert_eq!(sized.cols, Some(321));
        assert_eq!(sized.rows, Some(123));

        let e = Extent {
            x_min: -10.0,
            y_min: -5.0,
            x_max: 10.0,
            y_max: 5.0,
        };
        let ext = sized.with_extent(e);
        assert_eq!(ext.extent, Some(e));

        let res = ext.with_resolution(30.0, 40.0);
        assert_eq!(res.x_res, Some(30.0));
        assert_eq!(res.y_res, Some(40.0));

        let square = res.with_square_resolution(25.0);
        assert_eq!(square.x_res, Some(25.0));
        assert_eq!(square.y_res, Some(25.0));

        let snapped = square.with_snap_origin(0.0, 0.0);
        assert_eq!(snapped.snap_x, Some(0.0));
        assert_eq!(snapped.snap_y, Some(0.0));

        let linear = snapped.with_antimeridian_policy(AntimeridianPolicy::Linear);
        assert_eq!(linear.antimeridian_policy, AntimeridianPolicy::Linear);

        let fit_inside = linear.with_grid_size_policy(GridSizePolicy::FitInside);
        assert_eq!(fit_inside.grid_size_policy, GridSizePolicy::FitInside);

        let masked = fit_inside.with_destination_footprint(DestinationFootprint::SourceBoundary);
        assert_eq!(
            masked.destination_footprint,
            DestinationFootprint::SourceBoundary
        );
    }

    #[test]
    fn sample_extent_boundary_ring_count_and_corners() {
        let e = Extent {
            x_min: 0.0,
            y_min: 0.0,
            x_max: 10.0,
            y_max: 5.0,
        };
        let ring = sample_extent_boundary_ring(e, 8);
        assert_eq!(ring.len(), 32);
        assert!(ring.contains(&(0.0, 0.0)));
        assert!(ring.contains(&(10.0, 0.0)));
        assert!(ring.contains(&(10.0, 5.0)));
        assert!(ring.contains(&(0.0, 5.0)));
    }

    #[test]
    fn point_in_polygon_identifies_inside_and_outside_points() {
        let poly = vec![(0.0, 0.0), (4.0, 0.0), (4.0, 4.0), (0.0, 4.0)];
        assert!(point_in_polygon(2.0, 2.0, &poly));
        assert!(!point_in_polygon(5.0, 2.0, &poly));
    }

    #[test]
    fn thematic_3x3_resamplers_return_expected_statistics() {
        let cfg = RasterConfig {
            cols: 3,
            rows: 3,
            x_min: 0.0,
            y_min: 0.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let data = vec![1.0, 2.0, 2.0, 3.0, 4.0, 4.0, 5.0, 6.0, 6.0];
        let expected_mean = data.iter().sum::<f64>() / data.len() as f64;
        let expected_stddev = (data
            .iter()
            .map(|v| {
                let d = *v - expected_mean;
                d * d
            })
            .sum::<f64>()
            / data.len() as f64)
            .sqrt();
        let r = Raster::from_data(cfg, data).unwrap();

        let x = r.col_center_x(1);
        let y = r.row_center_y(1);

        let avg = r
            .sample_world(0, x, y, ResampleMethod::Average, NodataPolicy::Strict)
            .unwrap();
        let min = r
            .sample_world(0, x, y, ResampleMethod::Min, NodataPolicy::Strict)
            .unwrap();
        let max = r
            .sample_world(0, x, y, ResampleMethod::Max, NodataPolicy::Strict)
            .unwrap();
        let mode = r
            .sample_world(0, x, y, ResampleMethod::Mode, NodataPolicy::Strict)
            .unwrap();
        let median = r
            .sample_world(0, x, y, ResampleMethod::Median, NodataPolicy::Strict)
            .unwrap();
        let stddev = r
            .sample_world(0, x, y, ResampleMethod::StdDev, NodataPolicy::Strict)
            .unwrap();

        assert!((avg - (33.0 / 9.0)).abs() < 1e-9);
        assert_eq!(min, 1.0);
        assert_eq!(max, 6.0);
        assert_eq!(mode, 2.0);
        assert_eq!(median, 4.0);
        assert!((stddev - expected_stddev).abs() < 1e-9);
    }

    #[test]
    fn grid_size_policy_fit_inside_reduces_resolution_derived_size() {
        let mut r = make_raster();
        r.crs = CrsInfo::from_epsg(4326);

        let extent = Extent {
            x_min: -500_000.0,
            y_min: -400_000.0,
            x_max: 500_000.0,
            y_max: 400_000.0,
        };

        let expand = r
            .reproject_with_options(
                &ReprojectOptions::new(3857, ResampleMethod::Nearest)
                    .with_extent(extent)
                    .with_resolution(300_000.0, 300_000.0)
                    .with_grid_size_policy(GridSizePolicy::Expand),
            )
            .unwrap();

        let fit = r
            .reproject_with_options(
                &ReprojectOptions::new(3857, ResampleMethod::Nearest)
                    .with_extent(extent)
                    .with_resolution(300_000.0, 300_000.0)
                    .with_grid_size_policy(GridSizePolicy::FitInside),
            )
            .unwrap();

        assert!(fit.cols <= expand.cols);
        assert!(fit.rows <= expand.rows);
    }

    #[test]
    fn destination_footprint_masks_cells_outside_source_boundary() {
        let cfg = RasterConfig {
            cols: 4,
            rows: 4,
            x_min: 0.0,
            y_min: 0.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut r = Raster::new(cfg);
        r.crs = CrsInfo::from_epsg(4326);
        for row in 0..4 {
            for col in 0..4 {
                r.set(0, row, col, 1.0).unwrap();
            }
        }

        let out = r
            .reproject_with_options(
                &ReprojectOptions::new(4326, ResampleMethod::Nearest)
                    .with_extent(Extent {
                        x_min: -1.0,
                        y_min: -1.0,
                        x_max: 5.0,
                        y_max: 5.0,
                    })
                    .with_size(6, 6)
                    .with_destination_footprint(DestinationFootprint::SourceBoundary),
            )
            .unwrap();

        assert!(out.is_nodata(out.get(0, 0, 0)));
        assert!(!out.is_nodata(out.get(0, 2, 2)));
    }

    #[test]
    fn reproject_with_options_honors_snap_origin_with_resolution() {
        let cfg = RasterConfig {
            cols: 6,
            rows: 4,
            x_min: -3.0,
            y_min: -2.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut r = Raster::new(cfg);
        r.crs = CrsInfo::from_epsg(4326);
        for row in 0..4 {
            for col in 0..6 {
                r.set(0, row, col, (row * 6 + col) as f64).unwrap();
            }
        }

        let out_extent = Extent {
            x_min: -510_000.0,
            y_min: -390_000.0,
            x_max: 490_000.0,
            y_max: 410_000.0,
        };
        let opts = ReprojectOptions::new(3857, ResampleMethod::Bilinear)
            .with_extent(out_extent)
            .with_resolution(200_000.0, 160_000.0)
            .with_snap_origin(0.0, 0.0);

        let out = r.reproject_with_options(&opts).unwrap();
        assert!((out.x_min - (-600_000.0)).abs() < 1e-6);
        assert!((out.y_min - (-480_000.0)).abs() < 1e-6);
        assert!((out.cell_size_x - 200_000.0).abs() < 1e-6);
        assert!((out.cell_size_y - 160_000.0).abs() < 1e-6);
    }

    #[test]
    fn reproject_with_options_honors_resolution_controls() {
        let cfg = RasterConfig {
            cols: 6,
            rows: 4,
            x_min: -3.0,
            y_min: -2.0,
            cell_size: 1.0,
            nodata: -9999.0,
            ..Default::default()
        };
        let mut r = Raster::new(cfg);
        r.crs = CrsInfo::from_epsg(4326);
        for row in 0..4 {
            for col in 0..6 {
                r.set(0, row, col, (row * 6 + col) as f64).unwrap();
            }
        }

        let out_extent = Extent {
            x_min: -500_000.0,
            y_min: -400_000.0,
            x_max: 500_000.0,
            y_max: 400_000.0,
        };
        let opts = ReprojectOptions::new(3857, ResampleMethod::Bilinear)
            .with_extent(out_extent)
            .with_resolution(200_000.0, 160_000.0);

        let out = r.reproject_with_options(&opts).unwrap();
        assert_eq!(out.cols, 5);
        assert_eq!(out.rows, 5);
        assert!((out.cell_size_x - 200_000.0).abs() < 1e-6);
        assert!((out.cell_size_y - 160_000.0).abs() < 1e-6);
    }

    #[test]
    fn reproject_with_options_rejects_invalid_resolution_controls() {
        let mut r = make_raster();
        r.crs = CrsInfo::from_epsg(4326);
        let opts = ReprojectOptions::new(3857, ResampleMethod::Nearest).with_square_resolution(0.0);
        let err = r.reproject_with_options(&opts).unwrap_err();
        assert!(err.to_string().contains("invalid reprojection resolution"));
    }

    #[test]
    fn band_helpers() {
        let cfg = RasterConfig {
            cols: 3,
            rows: 2,
            bands: 2,
            nodata: -9999.0,
            ..Default::default()
        };
        let data = vec![
            1.0, 2.0, 3.0, 4.0, 5.0, -9999.0, 10.0, 20.0, 30.0, 40.0, 50.0, 60.0,
        ];
        let mut r = Raster::from_data(cfg, data).unwrap();

        let b0 = r.band_slice(0);
        assert_eq!(b0.len(), 6);
        assert_eq!(b0[0], 1.0);
        assert_eq!(b0[5], -9999.0);

        let s0 = r.statistics_band(0).unwrap();
        assert_eq!(s0.valid_count, 5);
        assert_eq!(s0.nodata_count, 1);
        assert_eq!(s0.min, 1.0);
        assert_eq!(s0.max, 5.0);

        r.set_band_slice(1, &[7.0, 8.0, 9.0, 10.0, 11.0, 12.0])
            .unwrap();
        assert_eq!(r.get_raw(1, 0, 0), Some(7.0));
        assert_eq!(r.get_raw(1, 1, 2), Some(12.0));
    }

    #[test]
    fn band_transform_helpers() {
        let cfg = RasterConfig {
            cols: 2,
            rows: 2,
            bands: 2,
            nodata: -9999.0,
            ..Default::default()
        };
        let data = vec![1.0, 2.0, 3.0, -9999.0, 10.0, 20.0, 30.0, 40.0];
        let mut r = Raster::from_data(cfg, data).unwrap();

        r.map_valid_band(0, |v| v * 2.0).unwrap();
        assert_eq!(r.get_raw(0, 0, 0), Some(2.0));
        assert_eq!(r.get_raw(0, 0, 1), Some(4.0));
        assert!(r.is_nodata(r.get(0, 1, 1))); // nodata unchanged
        assert_eq!(r.get_raw(1, 0, 0), Some(10.0)); // other band unchanged

        r.replace_band(1, 20.0, 99.0).unwrap();
        assert_eq!(r.get_raw(1, 0, 1), Some(99.0));
        assert_eq!(r.get_raw(1, 0, 0), Some(10.0));
        assert_eq!(r.get_raw(0, 0, 1), Some(4.0));
    }

    #[test]
    fn band_iterators() {
        let cfg = RasterConfig {
            cols: 3,
            rows: 2,
            bands: 2,
            nodata: -9999.0,
            ..Default::default()
        };
        let data = vec![
            1.0, 2.0, -9999.0, 4.0, 5.0, 6.0, 10.0, 20.0, 30.0, 40.0, 50.0, 60.0,
        ];
        let r = Raster::from_data(cfg, data).unwrap();

        let valid_b0: Vec<_> = r.iter_valid_band(0).unwrap().collect();
        assert_eq!(valid_b0.len(), 5);
        assert_eq!(valid_b0[0], (0, 0, 1.0));
        assert_eq!(valid_b0[4], (1, 2, 6.0));

        let rows_b1: Vec<Vec<f64>> = r.iter_band_rows(1).unwrap().collect();
        assert_eq!(rows_b1.len(), 2);
        assert_eq!(rows_b1[0], vec![10.0, 20.0, 30.0]);
        assert_eq!(rows_b1[1], vec![40.0, 50.0, 60.0]);
    }

    #[test]
    fn mutable_band_rows_native() {
        let cfg = RasterConfig {
            cols: 3,
            rows: 2,
            bands: 1,
            data_type: DataType::F32,
            nodata: -9999.0,
            ..Default::default()
        };
        let data = vec![1.0, 2.0, 3.0, 4.0, 5.0, 6.0];
        let mut r = Raster::from_data(cfg, data).unwrap();

        r.for_each_band_row_mut(0, |row, row_mut| {
            if let RasterRowMut::F32(slice) = row_mut {
                for v in slice.iter_mut() {
                    *v += row as f32;
                }
            }
        })
        .unwrap();

        assert_eq!(r.get_raw(0, 0, 0), Some(1.0));
        assert_eq!(r.get_raw(0, 0, 2), Some(3.0));
        assert_eq!(r.get_raw(0, 1, 0), Some(5.0));
        assert_eq!(r.get_raw(0, 1, 2), Some(7.0));
    }

    #[test]
    fn immutable_band_rows_native() {
        let cfg = RasterConfig {
            cols: 3,
            rows: 2,
            bands: 1,
            data_type: DataType::U16,
            nodata: 0.0,
            ..Default::default()
        };
        let data = vec![1.0, 2.0, 3.0, 4.0, 5.0, 6.0];
        let r = Raster::from_data(cfg, data).unwrap();

        let mut sums = Vec::new();
        r.for_each_band_row(0, |_row, row_ref| {
            if let RasterRowRef::U16(slice) = row_ref {
                sums.push(slice.iter().map(|v| *v as u64).sum::<u64>());
            }
        })
        .unwrap();

        assert_eq!(sums, vec![6, 15]);
    }
}