Enum DatasetFormat 

pub enum DatasetFormat {
    GeoTiff,
    GeoJson,
    Shapefile,
    GeoParquet,
    NetCdf,
    Hdf5,
    Zarr,
    Grib,
    Stac,
    Terrain,
    Vrt,
    FlatGeobuf,
    Jpeg2000,
    GeoPackage,
    PMTiles,
    MBTiles,
    Copc,
    Las,
    Unknown,
}

Detected format of a geospatial dataset.

Variants

GeoTiff

GeoTIFF / Cloud-Optimized GeoTIFF (.tif, .tiff)

GeoJson

GeoJSON (.geojson, .json)

Shapefile

ESRI Shapefile (.shp)

GeoParquet

GeoParquet (.parquet, .geoparquet)

NetCdf

NetCDF (.nc, .nc4)

Hdf5

HDF5 (.h5, .hdf5, .he5)

Zarr

Zarr (.zarr directory)

Grib

GRIB/GRIB2 (.grib, .grib2, .grb, .grb2)

Stac

STAC catalog (.json with STAC metadata)

Terrain

Terrain formats

Vrt

Virtual Raster Tiles (.vrt)

FlatGeobuf

FlatGeobuf (.fgb)

Jpeg2000

JPEG2000 (.jp2, .j2k)

GeoPackage

GeoPackage (.gpkg, SQLite-based)

PMTiles

PMTiles v3 single-file tile archive (.pmtiles)

MBTiles

MBTiles SQLite tile archive (.mbtiles)

Copc

Cloud Optimized Point Cloud (.copc.laz)

Las

Plain LAS / LAZ point cloud (.las, .laz) — not COPC-structured.

COPC is a specific LAZ 1.4 profile requiring an octree-hierarchy VLR and chunked layout. A generic .las/.laz file does not have that structure, so it is tagged Las rather than Copc. Only the compound .copc.laz extension (or a verified COPC VLR) is reported as Copc.

Unknown

Unknown / user-specified

Implementations

impl DatasetFormat

pub fn is_geopackage(path: &Path) -> bool

Returns true if this format is likely a GeoPackage (GPKG).

impl DatasetFormat

pub fn from_extension(path: &str) -> Self

Detect format from file extension.

Returns DatasetFormat::Unknown if the extension is not recognized. For .copc.laz files, the compound extension is checked first.

pub fn detect_from_magic_bytes(bytes: &[u8]) -> Option<Self>

Detect format purely from a byte slice — no file I/O.

Pass the first 72 bytes of a file (MAGIC_READ_SIZE). Returns None when no known magic signature is matched.

Note: ZIP magic (PK\x03\x04) and SQLite magic are mapped to DatasetFormat::GeoPackage as a conservative default; callers can refine the choice with the file extension when needed.

pub fn detect(path: &Path) -> Result<Self>

Detect format by reading magic bytes from a file on disk.

Opens the file, reads 72 bytes (MAGIC_READ_SIZE), then calls DatasetFormat::detect_from_magic_bytes. When the magic check yields DatasetFormat::GeoPackage the file extension is used to disambiguate between GeoPackage (.gpkg), MBTiles (.mbtiles), and generic SQLite.

Errors

Returns std::io::Error if the file cannot be opened or read.

pub fn driver_name(&self) -> &'static str

Human-readable driver name (matches GDAL naming convention).

Trait Implementations

impl Clone for DatasetFormat

fn clone(&self) -> DatasetFormat

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DatasetFormat

impl Debug for DatasetFormat

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

Formats the value using the given formatter.

impl Display for DatasetFormat

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

Formats the value using the given formatter.

impl Eq for DatasetFormat

impl PartialEq for DatasetFormat

fn eq(&self, other: &DatasetFormat) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for DatasetFormat