femic.lidar_terrain

Native-grid terrain raster, slope, and zonal-statistic helpers.

P79.3 accepts existing DTM/DEM/DSM rasters and provides a small point-cloud cell-aggregation API for callers that already hold sample points. It does not read LAZ/COPC files, classify ground returns, reproject, or resample silently.

Functions

build_terrain_products(source_path, ...[, ...])

Build terrain products and write JSON/CSV QA reports.

compute_zonal_statistics(zones_path, ...[, ...])

Compute zonal statistics over aligned zones and values rasters.

derive_slope_percent(source_path, output_path, *)

Derive percent slope from a single-band elevation raster.

inspect_terrain_raster(path)

Read normalized metadata for one terrain raster without loading values.

rasterize_point_cloud(points_xyz, *, ...[, ...])

Rasterize points into a native-grid DTM/DSM-like surface.

read_terrain_grid(path)

Load a single-band terrain grid and its validity mask.

require_projected_metre_grid(metadata)

Require the native-grid slope/flow contract for a terrain raster.

write_terrain_qa_report(report, path)

Write a terrain QA report as pretty-printed JSON.

write_terrain_qa_summary_csv(report, path)

Write a one-row-per-product terrain QA summary CSV.

Classes

TerrainGrid(values, valid, metadata)

One loaded terrain grid with validity mask and metadata.

TerrainProcessingError

Raised when a terrain raster, slope, or zonal operation is invalid.

TerrainQaReport(generated_utc, source, products)

QA report for a terrain-product build.

TerrainRasterMetadata(path, crs, transform, ...)

Normalized metadata for one terrain raster.

TerrainRasterResult(product, path, ...[, ...])

One derived terrain raster and its QA summary.

ZonalStatisticRow(zone_id, count[, mean, ...])

Statistics for one positive zone ID.

ZonalStatisticsResult(zones_path, ...[, ...])

Zonal-statistic outcome for one zones/values raster pair.