'LiDAR' Terrain Analysis and Change Detection from Above
Overview
Terrain change detection, cut and fill volume estimation, terrain profiling, flood inundation analysis, slope and aspect computation, hillshade generation, contour extraction, reclamation monitoring, erosion analysis, and engineering export (LandXML, STL) from 'LiDAR' (Light Detection and Ranging) point clouds and digital elevation models ('DEMs'). Applications include surface mine reclamation monitoring, sediment pond capacity tracking, highwall safety classification, and erosion channel detection. Built on 'lidR' for point cloud I/O and 'terra' for raster operations. Includes access utilities for 'KyFromAbove' cloud-native elevation data on Amazon Web Services ('AWS') https://kyfromabove.ky.gov/. Methods for terrain change detection and volume estimation follow Li and others (2005) doi:10.1016/j.geomorph.2004.10.007.
New Features
- **Terrain derivatives:**
slope_aspect(),hillshade(),contour_lines(), andzonal_stats()for slope, aspect, shaded relief, contour generation, and general-purpose zonal statistics. - **Flood analysis:**
flood_inundation()for binary inundation masks,flood_depth()for water depth rasters, andheight_above_drainage()implementing the HAND model for flood susceptibility mapping. - **Mining analysis:**
bench_detection()identifies flat mining benches adjacent to highwall faces using slope segmentation. - **Engineering export:**
export_landxml()writes LandXML TIN surfaces for Civil 3D, Bentley OpenRoads, and Trimble.export_stl()writes STL meshes for 3D printing terrain models.
Show all changes in 1.0.0Hide the rest of the changes in 1.0.0
- **KyFromAbove counties:**
kfa_county_bbox()andkfa_list_counties()provide bounding box lookup for all 120 Kentucky counties. - **Color ramps:**
change_colors(),terrain_colors(), andflood_colors()are now exported for use in custom visualizations. - **
has_s3_access()** is now exported for use in@examplesIfguards.
Security
- Added
sanitize_filename()to prevent path traversal in cached file names. - Added
validate_kfa_url()to verify download URLs originate from the KyFromAbove S3 bucket. - Added
safe_download()with configurable timeout (300s default), retry with exponential backoff (3 attempts), and file size limits (500 MB default). kfa_read_dem(),kfa_read_pointcloud(), andkfa_tile_index()now use the hardened download functions.
Documentation
- Added
CITATION.cffand.zenodo.jsonfor DOI-based citation. - Added community health files:
CODE_OF_CONDUCT.md,CONTRIBUTING.md,SECURITY.md,SUPPORT.md,ATTRIBUTION.md,CHANGELOG.md,DEVELOPMENT.md,DISCLAIMER.md,GOVERNANCE.md,MAINTAINERS.md,PRIVACY.md,RESPONSIBLE_USE.md. - Added GitHub issue and PR templates.
Infrastructure
- Added Codecov integration for test coverage reporting.
- Added Dependabot for GitHub Actions dependency updates.
- Added CodeQL security scanning workflow.
- Added dependency review workflow for pull requests.
- Added stale issue/PR bot.
From NEWS.md in the release
Install
Health
CRAN check results are not tracked yet.
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-08
- OK5 OK2026-03-20
Documentation
- Help pages
- 34 (1 internal)includes a package overview page
- Examples that run
- 94%31 run in a plain check (5 of them under a condition) · 2 only when donttest examples are enabled (R CMD check --as-cran)
- Exported functions with examples
- 100%
- Documented parameters
- 100%
- Return-value docs
- 100%
- Help pages citing references
- 0%
Downloads
Dependencies
Code & Tests
People & History
Pick two releases to compare their code metrics.
- archivedRemoved from CRAN2026-06-09requires archived package 'lidR'
- RR 4.6.0 released · 2026-04-24
- 1.0.02026-04-03 · diff ↗ ·
added 15 exports
bench_detection, change_colors, contour_lines, export_landxml, export_stl, flood_colors, flood_depth, flood_inundation, height_above_drainage, hillshade, kfa_county_bbox, kfa_list_counties, slope_aspect, terrain_colors, zonal_stats - 0.1.02026-03-19
- RR 4.5.0 released · 2025-04-11
Package metadata
- First published
- 2026-03-19
- Total releases
- 2 / 1 yrs
- License
- MIT + file LICENSE OSI
- Minimum R
- ≥ 4.1.0
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("aboveR")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-26, which the citation names so these numbers can be found later. More on citing and the projects behind them.