geotiff_reader/

lib.rs

//! Pure-Rust GeoTIFF reader with optional HTTP range-backed remote access.
//!
//! Supports:
//! - **GeoTIFF**: TIFF files with GeoKey metadata (EPSG codes, CRS, tiepoints, pixel scale)
//! - **COG**: overview discovery plus optional remote open via HTTP range requests
//! - **Compression passthrough**: any compression supported by `tiff-reader`, including TIFF
//!   `LERC`, `LERC+DEFLATE`, and, with the `zstd` feature enabled on `tiff-reader`, `LERC+ZSTD`
//!
//! # Example
//!
//! ```no_run
//! # #[cfg(feature = "local")]
//! # fn main() -> Result<(), geotiff_reader::Error> {
//! use geotiff_reader::GeoTiffFile;
//!
//! let file = GeoTiffFile::open("dem.tif")?;
//! println!("EPSG: {:?}", file.epsg());
//! println!("bounds: {:?}", file.geo_bounds());
//! println!("size: {}x{}", file.width(), file.height());
//! # Ok(())
//! # }
//! # #[cfg(not(feature = "local"))]
//! # fn main() {}
//! ```

pub mod crs;
pub mod error;
pub mod geokeys;
pub mod transform;

#[cfg(feature = "cog")]
pub mod cog;

pub use error::{Error, Result};

#[cfg(feature = "local")]
use crs::CrsInfo;
#[cfg(feature = "local")]
use geokeys::GeoKeyDirectory;
#[cfg(feature = "local")]
use ndarray::ArrayD;
#[cfg(feature = "local")]
use std::path::Path;
#[cfg(feature = "local")]
use tiff_reader::{OpenOptions as TiffOpenOptions, TagValue, TiffFile, TiffSample};
#[cfg(feature = "local")]
use transform::GeoTransform;

#[cfg(feature = "local")]
use geotiff_core::tags::{
    TAG_GDAL_NODATA, TAG_GEO_ASCII_PARAMS, TAG_GEO_DOUBLE_PARAMS, TAG_GEO_KEY_DIRECTORY,
    TAG_MODEL_PIXEL_SCALE, TAG_MODEL_TIEPOINT, TAG_MODEL_TRANSFORMATION, TAG_NEW_SUBFILE_TYPE,
    TAG_SUBFILE_TYPE,
};

/// A GeoTIFF file handle with geospatial metadata.
#[cfg(feature = "local")]
pub struct GeoTiffFile {
    tiff: TiffFile,
    geo_metadata: GeoMetadata,
    crs: CrsInfo,
    geokeys: GeoKeyDirectory,
    transform: Option<GeoTransform>,
    base_ifd_index: usize,
    overview_ifds: Vec<usize>,
}

#[cfg(feature = "local")]
pub use tiff_reader::OpenOptions as GeoTiffOpenOptions;

pub use geotiff_core::GeoMetadata;

#[cfg(feature = "local")]
impl GeoTiffFile {
    /// Open a GeoTIFF file from disk.
    pub fn open<P: AsRef<Path>>(path: P) -> Result<Self> {
        Self::open_with_options(path, TiffOpenOptions::default())
    }

    /// Open a GeoTIFF file from disk with explicit TIFF decoder options.
    pub fn open_with_options<P: AsRef<Path>>(path: P, options: GeoTiffOpenOptions) -> Result<Self> {
        let tiff = TiffFile::open_with_options(path, options)?;
        Self::from_tiff(tiff)
    }

    /// Open a GeoTIFF from an owned byte buffer.
    pub fn from_bytes(data: Vec<u8>) -> Result<Self> {
        Self::from_bytes_with_options(data, TiffOpenOptions::default())
    }

    /// Open a GeoTIFF from bytes with explicit TIFF decoder options.
    pub fn from_bytes_with_options(data: Vec<u8>, options: GeoTiffOpenOptions) -> Result<Self> {
        let tiff = TiffFile::from_bytes_with_options(data, options)?;
        Self::from_tiff(tiff)
    }

    pub(crate) fn from_tiff(tiff: TiffFile) -> Result<Self> {
        let metadata_ifd_index = find_metadata_ifd_index(tiff.ifds())?;
        let metadata_ifd = tiff.ifd(metadata_ifd_index)?;
        let geokeys = parse_geokey_directory(metadata_ifd)?;
        let crs = CrsInfo::from_geokeys(&geokeys);
        let epsg = crs.epsg();
        let tiepoints = parse_tiepoints(metadata_ifd);
        let pixel_scale = parse_fixed_len_double_tag::<3>(
            metadata_ifd
                .tag(TAG_MODEL_PIXEL_SCALE)
                .map(|tag| &tag.value),
        );
        let transformation = parse_fixed_len_double_tag::<16>(
            metadata_ifd
                .tag(TAG_MODEL_TRANSFORMATION)
                .map(|tag| &tag.value),
        );
        let transform = transformation
            .as_ref()
            .map(GeoTransform::from_transformation_matrix)
            .or_else(|| {
                let tiepoint = tiepoints.first()?;
                let scale = pixel_scale.as_ref()?;
                Some(GeoTransform::from_tiepoint_and_scale_with_raster_type(
                    tiepoint,
                    scale,
                    crs.raster_type_enum(),
                ))
            });
        let base_ifd_index = find_base_ifd_index(tiff.ifds(), metadata_ifd_index);
        let base_ifd = tiff.ifd(base_ifd_index)?;
        let geo_bounds = transform
            .as_ref()
            .map(|gt| gt.bounds(base_ifd.width(), base_ifd.height()));
        let overview_ifds = tiff
            .ifds()
            .iter()
            .enumerate()
            .filter_map(|(index, candidate)| {
                (index != base_ifd_index
                    && index != metadata_ifd_index
                    && is_overview_ifd(base_ifd, candidate))
                .then_some(index)
            })
            .collect();

        let geo_metadata = GeoMetadata {
            epsg,
            tiepoints,
            pixel_scale,
            transformation,
            nodata: parse_nodata(metadata_ifd),
            band_count: base_ifd.samples_per_pixel() as u32,
            width: base_ifd.width(),
            height: base_ifd.height(),
            geo_bounds,
        };

        Ok(Self {
            tiff,
            geo_metadata,
            crs,
            geokeys,
            transform,
            base_ifd_index,
            overview_ifds,
        })
    }

    /// Returns the underlying TIFF file.
    pub fn tiff(&self) -> &TiffFile {
        &self.tiff
    }

    /// Returns the parsed GeoTIFF metadata.
    pub fn metadata(&self) -> &GeoMetadata {
        &self.geo_metadata
    }

    /// Returns the EPSG code of the coordinate reference system, if present.
    pub fn epsg(&self) -> Option<u32> {
        self.geo_metadata.epsg
    }

    /// Returns the extracted CRS information.
    pub fn crs(&self) -> &CrsInfo {
        &self.crs
    }

    /// Returns the parsed GeoKey directory.
    pub fn geokeys(&self) -> &GeoKeyDirectory {
        &self.geokeys
    }

    /// Returns the affine transform, if present.
    pub fn transform(&self) -> Option<&GeoTransform> {
        self.transform.as_ref()
    }

    /// Returns the geographic bounds as `(min_x, min_y, max_x, max_y)`.
    pub fn geo_bounds(&self) -> Option<[f64; 4]> {
        self.geo_metadata.geo_bounds
    }

    /// Convert a pixel coordinate to map coordinates.
    pub fn pixel_to_geo(&self, col: f64, row: f64) -> Option<(f64, f64)> {
        self.transform
            .map(|transform| transform.pixel_to_geo(col, row))
    }

    /// Convert map coordinates to pixel coordinates.
    pub fn geo_to_pixel(&self, x: f64, y: f64) -> Option<(f64, f64)> {
        self.transform
            .and_then(|transform| transform.geo_to_pixel(x, y))
    }

    /// Returns the image width in pixels.
    pub fn width(&self) -> u32 {
        self.geo_metadata.width
    }

    /// Returns the image height in pixels.
    pub fn height(&self) -> u32 {
        self.geo_metadata.height
    }

    /// Returns the number of bands.
    pub fn band_count(&self) -> u32 {
        self.geo_metadata.band_count
    }

    /// Returns the nodata value, if set.
    pub fn nodata(&self) -> Option<&str> {
        self.geo_metadata.nodata.as_deref()
    }

    /// Returns the number of internal overview IFDs.
    pub fn overview_count(&self) -> usize {
        self.overview_ifds.len()
    }

    /// Returns the TIFF IFD index of the requested overview.
    pub fn overview_ifd_index(&self, overview_index: usize) -> Result<usize> {
        self.overview_ifds
            .get(overview_index)
            .copied()
            .ok_or(Error::OverviewNotFound(overview_index))
    }

    /// Returns the TIFF IFD index of the base-resolution image.
    pub fn base_ifd_index(&self) -> usize {
        self.base_ifd_index
    }

    /// Decode the base-resolution raster into a typed ndarray.
    pub fn read_raster<T: TiffSample>(&self) -> Result<ArrayD<T>> {
        self.tiff
            .read_image::<T>(self.base_ifd_index)
            .map_err(Into::into)
    }

    /// Decode a base-resolution pixel window into a typed ndarray.
    pub fn read_window<T: TiffSample>(
        &self,
        row_off: usize,
        col_off: usize,
        rows: usize,
        cols: usize,
    ) -> Result<ArrayD<T>> {
        self.tiff
            .read_window::<T>(self.base_ifd_index, row_off, col_off, rows, cols)
            .map_err(Into::into)
    }

    /// Decode an overview raster into a typed ndarray.
    pub fn read_overview<T: TiffSample>(&self, overview_index: usize) -> Result<ArrayD<T>> {
        let ifd_index = self.overview_ifd_index(overview_index)?;
        self.tiff.read_image::<T>(ifd_index).map_err(Into::into)
    }

    /// Decode an overview pixel window into a typed ndarray.
    pub fn read_overview_window<T: TiffSample>(
        &self,
        overview_index: usize,
        row_off: usize,
        col_off: usize,
        rows: usize,
        cols: usize,
    ) -> Result<ArrayD<T>> {
        let ifd_index = self.overview_ifd_index(overview_index)?;
        self.tiff
            .read_window::<T>(ifd_index, row_off, col_off, rows, cols)
            .map_err(Into::into)
    }
}

#[cfg(feature = "local")]
fn is_overview_ifd(base: &tiff_reader::Ifd, candidate: &tiff_reader::Ifd) -> bool {
    let smaller = candidate.width() < base.width() || candidate.height() < base.height();
    if !smaller {
        return false;
    }

    let same_layout = candidate.samples_per_pixel() == base.samples_per_pixel()
        && candidate.bits_per_sample() == base.bits_per_sample()
        && candidate.sample_format() == base.sample_format()
        && candidate.photometric_interpretation() == base.photometric_interpretation();
    if !same_layout {
        return false;
    }

    has_reduced_resolution_flag(candidate)
        || (candidate.tag(TAG_NEW_SUBFILE_TYPE).is_none()
            && candidate.tag(TAG_SUBFILE_TYPE).is_none())
}

#[cfg(feature = "local")]
fn find_metadata_ifd_index(ifds: &[tiff_reader::Ifd]) -> Result<usize> {
    ifds.iter()
        .position(|ifd| ifd.tag(TAG_GEO_KEY_DIRECTORY).is_some())
        .ok_or(Error::NotGeoTiff)
}

#[cfg(feature = "local")]
fn find_base_ifd_index(ifds: &[tiff_reader::Ifd], metadata_ifd_index: usize) -> usize {
    let metadata_ifd = &ifds[metadata_ifd_index];
    if !has_reduced_resolution_flag(metadata_ifd) {
        return metadata_ifd_index;
    }

    ifds.iter()
        .enumerate()
        .skip(metadata_ifd_index + 1)
        .find_map(|(index, ifd)| (!has_reduced_resolution_flag(ifd)).then_some(index))
        .unwrap_or(metadata_ifd_index)
}

#[cfg(feature = "local")]
fn has_reduced_resolution_flag(ifd: &tiff_reader::Ifd) -> bool {
    ifd.tag(TAG_NEW_SUBFILE_TYPE)
        .and_then(|tag| tag.value.as_u64())
        .map(|flags| flags & 0x1 != 0)
        .or_else(|| {
            ifd.tag(TAG_SUBFILE_TYPE)
                .and_then(|tag| tag.value.as_u16())
                .map(|value| value == 2)
        })
        .unwrap_or(false)
}

#[cfg(feature = "local")]
fn parse_geokey_directory(ifd: &tiff_reader::Ifd) -> Result<GeoKeyDirectory> {
    let directory = ifd
        .tag(TAG_GEO_KEY_DIRECTORY)
        .and_then(|tag| match &tag.value {
            TagValue::Short(values) => Some(values.as_slice()),
            _ => None,
        })
        .ok_or(Error::NotGeoTiff)?;
    let double_params = ifd
        .tag(TAG_GEO_DOUBLE_PARAMS)
        .and_then(|tag| tag.value.as_f64_vec())
        .unwrap_or_default();
    let ascii_params = ifd
        .tag(TAG_GEO_ASCII_PARAMS)
        .and_then(|tag| tag.value.as_str())
        .unwrap_or("");
    GeoKeyDirectory::parse(directory, &double_params, ascii_params)
        .ok_or(Error::InvalidGeoKeyDirectory)
}

#[cfg(feature = "local")]
fn parse_fixed_len_double_tag<const N: usize>(value: Option<&TagValue>) -> Option<[f64; N]> {
    let values = value.and_then(TagValue::as_f64_vec)?;
    if values.len() < N {
        return None;
    }
    let mut out = [0.0; N];
    out.copy_from_slice(&values[..N]);
    Some(out)
}

#[cfg(feature = "local")]
fn parse_tiepoints(ifd: &tiff_reader::Ifd) -> Vec<[f64; 6]> {
    let values = ifd
        .tag(TAG_MODEL_TIEPOINT)
        .and_then(|tag| tag.value.as_f64_vec())
        .unwrap_or_default();
    values
        .chunks_exact(6)
        .map(|chunk| [chunk[0], chunk[1], chunk[2], chunk[3], chunk[4], chunk[5]])
        .collect()
}

#[cfg(feature = "local")]
fn parse_nodata(ifd: &tiff_reader::Ifd) -> Option<String> {
    ifd.tag(TAG_GDAL_NODATA)
        .and_then(|tag| tag.value.as_str())
        .map(ToOwned::to_owned)
}

#[cfg(test)]
#[cfg(feature = "local")]
mod tests {
    use super::GeoTiffFile;

    #[derive(Clone)]
    struct TestIfdSpec {
        entries: Vec<(u16, u16, u32, Vec<u8>)>,
        image_data: Vec<u8>,
    }

    fn le_u16(value: u16) -> [u8; 2] {
        value.to_le_bytes()
    }

    fn le_u32(value: u32) -> [u8; 4] {
        value.to_le_bytes()
    }

    fn le_f64(value: f64) -> [u8; 8] {
        value.to_le_bytes()
    }

    fn inline_short(value: u16) -> Vec<u8> {
        let mut bytes = [0u8; 4];
        bytes[..2].copy_from_slice(&le_u16(value));
        bytes.to_vec()
    }

    #[allow(clippy::too_many_arguments)]
    fn build_lerc2_header_v2(
        width: u32,
        height: u32,
        valid_pixel_count: u32,
        image_type: i32,
        max_z_error: f64,
        z_min: f64,
        z_max: f64,
        payload_len: usize,
    ) -> Vec<u8> {
        let blob_size = 58 + 4 + payload_len;
        let mut bytes = Vec::with_capacity(blob_size);
        bytes.extend_from_slice(b"Lerc2 ");
        bytes.extend_from_slice(&2i32.to_le_bytes());
        bytes.extend_from_slice(&height.to_le_bytes());
        bytes.extend_from_slice(&width.to_le_bytes());
        bytes.extend_from_slice(&valid_pixel_count.to_le_bytes());
        bytes.extend_from_slice(&8i32.to_le_bytes());
        bytes.extend_from_slice(&(blob_size as i32).to_le_bytes());
        bytes.extend_from_slice(&image_type.to_le_bytes());
        bytes.extend_from_slice(&max_z_error.to_le_bytes());
        bytes.extend_from_slice(&z_min.to_le_bytes());
        bytes.extend_from_slice(&z_max.to_le_bytes());
        bytes
    }

    fn build_classic_tiff(ifds: &[TestIfdSpec]) -> Vec<u8> {
        let mut ifd_offsets = Vec::with_capacity(ifds.len());
        let mut cursor = 8usize;
        for ifd in ifds {
            ifd_offsets.push(cursor as u32);
            let deferred_len: usize = ifd
                .entries
                .iter()
                .filter(|(tag, _, _, value)| *tag != 273 && value.len() > 4)
                .map(|(_, _, _, value)| value.len())
                .sum();
            cursor += 2 + ifd.entries.len() * 12 + 4 + ifd.image_data.len() + deferred_len;
        }

        let mut bytes = Vec::with_capacity(cursor);
        bytes.extend_from_slice(b"II");
        bytes.extend_from_slice(&le_u16(42));
        bytes.extend_from_slice(&le_u32(ifd_offsets.first().copied().unwrap_or(0)));

        for (ifd_index, ifd) in ifds.iter().enumerate() {
            let ifd_offset = ifd_offsets[ifd_index] as usize;
            debug_assert_eq!(bytes.len(), ifd_offset);

            let ifd_size = 2 + ifd.entries.len() * 12 + 4;
            let mut next_data_offset = ifd_offset + ifd_size;
            let image_offset = next_data_offset as u32;
            next_data_offset += ifd.image_data.len();

            bytes.extend_from_slice(&le_u16(ifd.entries.len() as u16));
            let mut deferred = Vec::new();
            for (tag, ty, count, value) in &ifd.entries {
                bytes.extend_from_slice(&le_u16(*tag));
                bytes.extend_from_slice(&le_u16(*ty));
                bytes.extend_from_slice(&le_u32(*count));
                if *tag == 273 {
                    bytes.extend_from_slice(&le_u32(image_offset));
                } else if value.len() <= 4 {
                    let mut inline = [0u8; 4];
                    inline[..value.len()].copy_from_slice(value);
                    bytes.extend_from_slice(&inline);
                } else {
                    bytes.extend_from_slice(&le_u32(next_data_offset as u32));
                    next_data_offset += value.len();
                    deferred.push(value.clone());
                }
            }

            let next_ifd_offset = ifd_offsets.get(ifd_index + 1).copied().unwrap_or(0);
            bytes.extend_from_slice(&le_u32(next_ifd_offset));
            bytes.extend_from_slice(&ifd.image_data);
            for value in deferred {
                bytes.extend_from_slice(&value);
            }
            debug_assert_eq!(bytes.len(), next_data_offset);
        }

        bytes
    }

    fn build_simple_geotiff(pixel_is_point: bool) -> Vec<u8> {
        let image_data = vec![10u8, 20, 30, 40];
        let tiepoints = [0.0, 0.0, 0.0, 100.0, 200.0, 0.0];
        let scales = [2.0, 2.0, 0.0];
        let geo_keys = if pixel_is_point {
            vec![
                1, 1, 0, 3, // header
                1024, 0, 1, 2, // model type = Geographic
                1025, 0, 1, 2, // raster type = PixelIsPoint
                2048, 0, 1, 4326, // EPSG:4326
            ]
        } else {
            vec![
                1, 1, 0, 2, // header
                1024, 0, 1, 2, // model type = Geographic
                2048, 0, 1, 4326, // EPSG:4326
            ]
        };
        let nodata = b"-9999\0".to_vec();

        build_classic_tiff(&[TestIfdSpec {
            image_data,
            entries: vec![
                (256u16, 4u16, 1u32, le_u32(2).to_vec()),
                (257u16, 4u16, 1u32, le_u32(2).to_vec()),
                (258u16, 3u16, 1u32, [8, 0, 0, 0].to_vec()),
                (259u16, 3u16, 1u32, [1, 0, 0, 0].to_vec()),
                (273u16, 4u16, 1u32, vec![]),
                (277u16, 3u16, 1u32, [1, 0, 0, 0].to_vec()),
                (278u16, 4u16, 1u32, le_u32(2).to_vec()),
                (279u16, 4u16, 1u32, le_u32(4).to_vec()),
                (
                    33550u16,
                    12u16,
                    3u32,
                    scales.iter().flat_map(|value| le_f64(*value)).collect(),
                ),
                (
                    33922u16,
                    12u16,
                    6u32,
                    tiepoints.iter().flat_map(|value| le_f64(*value)).collect(),
                ),
                (
                    34735u16,
                    3u16,
                    geo_keys.len() as u32,
                    geo_keys.iter().flat_map(|value| le_u16(*value)).collect(),
                ),
                (42113u16, 2u16, nodata.len() as u32, nodata),
            ],
        }])
    }

    fn build_simple_lerc_geotiff() -> Vec<u8> {
        let tiepoints = [0.0, 0.0, 0.0, 100.0, 200.0, 0.0];
        let scales = [2.0, 2.0, 0.0];
        let geo_keys = vec![
            1, 1, 0, 2, // header
            1024, 0, 1, 2, // model type = Geographic
            2048, 0, 1, 4326, // EPSG:4326
        ];

        let mut image_data = build_lerc2_header_v2(2, 2, 4, 6, 0.0, 1.0, 4.0, 1 + 16);
        image_data.extend_from_slice(&0u32.to_le_bytes());
        image_data.push(1);
        for value in [1.0f32, 2.0, 3.0, 4.0] {
            image_data.extend_from_slice(&value.to_le_bytes());
        }
        let image_len = image_data.len() as u32;

        build_classic_tiff(&[TestIfdSpec {
            image_data,
            entries: vec![
                (256u16, 4u16, 1u32, le_u32(2).to_vec()),
                (257u16, 4u16, 1u32, le_u32(2).to_vec()),
                (258u16, 3u16, 1u32, inline_short(32)),
                (259u16, 3u16, 1u32, inline_short(34887)),
                (273u16, 4u16, 1u32, vec![]),
                (277u16, 3u16, 1u32, inline_short(1)),
                (278u16, 4u16, 1u32, le_u32(2).to_vec()),
                (279u16, 4u16, 1u32, le_u32(image_len).to_vec()),
                (339u16, 3u16, 1u32, inline_short(3)),
                (
                    33550u16,
                    12u16,
                    3u32,
                    scales.iter().flat_map(|value| le_f64(*value)).collect(),
                ),
                (
                    33922u16,
                    12u16,
                    6u32,
                    tiepoints.iter().flat_map(|value| le_f64(*value)).collect(),
                ),
                (
                    34735u16,
                    3u16,
                    geo_keys.len() as u32,
                    geo_keys.iter().flat_map(|value| le_u16(*value)).collect(),
                ),
            ],
        }])
    }

    fn overwrite_classic_inline_long_tag(bytes: &mut [u8], tag_code: u16, value: u32) {
        let entry_count = u16::from_le_bytes([bytes[8], bytes[9]]) as usize;
        let mut offset = 10usize;
        for _ in 0..entry_count {
            let code = u16::from_le_bytes([bytes[offset], bytes[offset + 1]]);
            if code == tag_code {
                bytes[offset + 8..offset + 12].copy_from_slice(&le_u32(value));
                return;
            }
            offset += 12;
        }
        panic!("tag {tag_code} not found in classic TIFF");
    }

    fn build_geotiff_with_overview() -> Vec<u8> {
        let base = TestIfdSpec {
            image_data: vec![10u8, 20, 30, 40],
            entries: vec![
                (256u16, 4u16, 1u32, le_u32(2).to_vec()),
                (257u16, 4u16, 1u32, le_u32(2).to_vec()),
                (258u16, 3u16, 1u32, [8, 0, 0, 0].to_vec()),
                (259u16, 3u16, 1u32, [1, 0, 0, 0].to_vec()),
                (273u16, 4u16, 1u32, vec![]),
                (277u16, 3u16, 1u32, [1, 0, 0, 0].to_vec()),
                (278u16, 4u16, 1u32, le_u32(2).to_vec()),
                (279u16, 4u16, 1u32, le_u32(4).to_vec()),
                (
                    33550u16,
                    12u16,
                    3u32,
                    [2.0, 2.0, 0.0]
                        .iter()
                        .flat_map(|value| le_f64(*value))
                        .collect(),
                ),
                (
                    33922u16,
                    12u16,
                    6u32,
                    [0.0, 0.0, 0.0, 100.0, 200.0, 0.0]
                        .iter()
                        .flat_map(|value| le_f64(*value))
                        .collect(),
                ),
                (
                    34735u16,
                    3u16,
                    12u32,
                    [1u16, 1, 0, 2, 1024, 0, 1, 2, 2048, 0, 1, 4326]
                        .iter()
                        .flat_map(|value| le_u16(*value))
                        .collect(),
                ),
            ],
        };
        let overview = TestIfdSpec {
            image_data: vec![99u8],
            entries: vec![
                (254u16, 4u16, 1u32, le_u32(1).to_vec()),
                (256u16, 4u16, 1u32, le_u32(1).to_vec()),
                (257u16, 4u16, 1u32, le_u32(1).to_vec()),
                (258u16, 3u16, 1u32, [8, 0, 0, 0].to_vec()),
                (259u16, 3u16, 1u32, [1, 0, 0, 0].to_vec()),
                (273u16, 4u16, 1u32, vec![]),
                (277u16, 3u16, 1u32, [1, 0, 0, 0].to_vec()),
                (278u16, 4u16, 1u32, le_u32(1).to_vec()),
                (279u16, 4u16, 1u32, le_u32(1).to_vec()),
            ],
        };

        build_classic_tiff(&[base, overview])
    }

    fn build_cog_like_geotiff_with_ghost_ifd() -> Vec<u8> {
        let geo_keys = [1u16, 1, 0, 2, 1024, 0, 1, 2, 2048, 0, 1, 4326];
        let ghost = TestIfdSpec {
            image_data: vec![0u8],
            entries: vec![
                (254u16, 4u16, 1u32, le_u32(1).to_vec()),
                (256u16, 4u16, 1u32, le_u32(1).to_vec()),
                (257u16, 4u16, 1u32, le_u32(1).to_vec()),
                (258u16, 3u16, 1u32, [8, 0, 0, 0].to_vec()),
                (259u16, 3u16, 1u32, [1, 0, 0, 0].to_vec()),
                (273u16, 4u16, 1u32, vec![]),
                (277u16, 3u16, 1u32, [1, 0, 0, 0].to_vec()),
                (278u16, 4u16, 1u32, le_u32(1).to_vec()),
                (279u16, 4u16, 1u32, le_u32(1).to_vec()),
                (
                    33550u16,
                    12u16,
                    3u32,
                    [2.0, 2.0, 0.0]
                        .iter()
                        .flat_map(|value| le_f64(*value))
                        .collect(),
                ),
                (
                    33922u16,
                    12u16,
                    6u32,
                    [0.0, 0.0, 0.0, 100.0, 200.0, 0.0]
                        .iter()
                        .flat_map(|value| le_f64(*value))
                        .collect(),
                ),
                (
                    34735u16,
                    3u16,
                    geo_keys.len() as u32,
                    geo_keys.iter().flat_map(|value| le_u16(*value)).collect(),
                ),
            ],
        };
        let overview = TestIfdSpec {
            image_data: vec![50u8, 60, 70, 80],
            entries: vec![
                (254u16, 4u16, 1u32, le_u32(1).to_vec()),
                (256u16, 4u16, 1u32, le_u32(2).to_vec()),
                (257u16, 4u16, 1u32, le_u32(2).to_vec()),
                (258u16, 3u16, 1u32, [8, 0, 0, 0].to_vec()),
                (259u16, 3u16, 1u32, [1, 0, 0, 0].to_vec()),
                (273u16, 4u16, 1u32, vec![]),
                (277u16, 3u16, 1u32, [1, 0, 0, 0].to_vec()),
                (278u16, 4u16, 1u32, le_u32(2).to_vec()),
                (279u16, 4u16, 1u32, le_u32(4).to_vec()),
            ],
        };
        let base = TestIfdSpec {
            image_data: (1u8..=16).collect(),
            entries: vec![
                (256u16, 4u16, 1u32, le_u32(4).to_vec()),
                (257u16, 4u16, 1u32, le_u32(4).to_vec()),
                (258u16, 3u16, 1u32, [8, 0, 0, 0].to_vec()),
                (259u16, 3u16, 1u32, [1, 0, 0, 0].to_vec()),
                (273u16, 4u16, 1u32, vec![]),
                (277u16, 3u16, 1u32, [1, 0, 0, 0].to_vec()),
                (278u16, 4u16, 1u32, le_u32(4).to_vec()),
                (279u16, 4u16, 1u32, le_u32(16).to_vec()),
            ],
        };

        build_classic_tiff(&[ghost, overview, base])
    }

    #[test]
    fn parses_geotiff_metadata_and_reads_raster() {
        let file = GeoTiffFile::from_bytes(build_simple_geotiff(false)).unwrap();
        assert_eq!(file.epsg(), Some(4326));
        assert_eq!(file.width(), 2);
        assert_eq!(file.height(), 2);
        assert_eq!(file.band_count(), 1);
        assert_eq!(file.nodata(), Some("-9999"));
        assert_eq!(file.geo_bounds(), Some([100.0, 196.0, 104.0, 200.0]));

        let raster = file.read_raster::<u8>().unwrap();
        assert_eq!(raster.shape(), &[2, 2]);
        let (values, offset) = raster.into_raw_vec_and_offset();
        assert_eq!(offset, Some(0));
        assert_eq!(values, vec![10, 20, 30, 40]);
    }

    #[test]
    fn parses_geotiff_metadata_and_reads_lerc_raster() {
        let file = GeoTiffFile::from_bytes(build_simple_lerc_geotiff()).unwrap();
        assert_eq!(file.epsg(), Some(4326));
        assert_eq!(file.width(), 2);
        assert_eq!(file.height(), 2);

        let raster = file.read_raster::<f32>().unwrap();
        assert_eq!(raster.shape(), &[2, 2]);
        let (values, offset) = raster.into_raw_vec_and_offset();
        assert_eq!(offset, Some(0));
        assert_eq!(values, vec![1.0, 2.0, 3.0, 4.0]);
    }

    #[test]
    fn pixel_is_point_metadata_shifts_bounds_to_outer_edges() {
        let file = GeoTiffFile::from_bytes(build_simple_geotiff(true)).unwrap();
        assert_eq!(file.geo_bounds(), Some([99.0, 197.0, 103.0, 201.0]));

        let transform = file.transform().unwrap();
        let (center_x, center_y) = transform.pixel_to_geo(0.5, 0.5);
        assert_eq!((center_x, center_y), (100.0, 200.0));
    }

    #[test]
    fn discovers_reduced_resolution_overviews() {
        let file = GeoTiffFile::from_bytes(build_geotiff_with_overview()).unwrap();
        assert_eq!(file.overview_count(), 1);
        assert_eq!(file.overview_ifd_index(0).unwrap(), 1);

        let overview = file.read_overview::<u8>(0).unwrap();
        assert_eq!(overview.shape(), &[1, 1]);
        let (values, offset) = overview.into_raw_vec_and_offset();
        assert_eq!(offset, Some(0));
        assert_eq!(values, vec![99]);
    }

    #[test]
    fn reads_base_raster_window() {
        let file = GeoTiffFile::from_bytes(build_simple_geotiff(false)).unwrap();
        let window = file.read_window::<u8>(1, 0, 1, 2).unwrap();
        assert_eq!(window.shape(), &[1, 2]);
        let (values, offset) = window.into_raw_vec_and_offset();
        assert_eq!(offset, Some(0));
        assert_eq!(values, vec![30, 40]);
    }

    #[test]
    fn reads_overview_window() {
        let file = GeoTiffFile::from_bytes(build_geotiff_with_overview()).unwrap();
        let window = file.read_overview_window::<u8>(0, 0, 0, 1, 1).unwrap();
        assert_eq!(window.shape(), &[1, 1]);
        let (values, offset) = window.into_raw_vec_and_offset();
        assert_eq!(offset, Some(0));
        assert_eq!(values, vec![99]);
    }

    #[test]
    fn prefers_non_ghost_base_ifd_for_cog_like_layouts() {
        let file = GeoTiffFile::from_bytes(build_cog_like_geotiff_with_ghost_ifd()).unwrap();
        assert_eq!(file.base_ifd_index(), 2);
        assert_eq!(file.width(), 4);
        assert_eq!(file.height(), 4);
        assert_eq!(file.geo_bounds(), Some([100.0, 192.0, 108.0, 200.0]));
        assert_eq!(file.overview_count(), 1);
        assert_eq!(file.overview_ifd_index(0).unwrap(), 1);

        let base = file.read_raster::<u8>().unwrap();
        assert_eq!(base.shape(), &[4, 4]);
        let (values, offset) = base.into_raw_vec_and_offset();
        assert_eq!(offset, Some(0));
        assert_eq!(values, (1u8..=16).collect::<Vec<_>>());

        let overview = file.read_overview::<u8>(0).unwrap();
        assert_eq!(overview.shape(), &[2, 2]);
        let (values, offset) = overview.into_raw_vec_and_offset();
        assert_eq!(offset, Some(0));
        assert_eq!(values, vec![50, 60, 70, 80]);
    }

    #[test]
    fn rejects_zero_rows_per_strip_without_panicking() {
        let mut bytes = build_simple_geotiff(false);
        overwrite_classic_inline_long_tag(&mut bytes, 278, 0);

        let file = GeoTiffFile::from_bytes(bytes).unwrap();
        assert_eq!(file.epsg(), Some(4326));

        let error = file.tiff().read_image_bytes(0).unwrap_err();
        assert!(error.to_string().contains("RowsPerStrip"));
    }
}