Geospatial Semantic Segmentation with Torch and Terra
Overview
Provides tools for semantic segmentation of geospatial data using convolutional neural network-based deep learning. Utility functions allow for creating masks, image chips, data frames listing image chips in a directory, and DataSets for use within DataLoaders. Additional functions are provided to serve as checks during the data preparation and training process. A UNet architecture can be defined with 4 blocks in the encoder, a bottleneck block, and 4 blocks in the decoder. The UNet can accept a variable number of input channels, and the user can define the number of feature maps produced in each encoder and decoder block and the bottleneck. Users can also choose to (1) replace all rectified linear unit (ReLU) activation functions with leaky ReLU or swish, (2) implement attention gates along the skip connections, (3) implement squeeze and excitation modules within the encoder blocks, (4) add residual connections within all blocks, (5) replace the bottleneck with a modified atrous spatial pyramid pooling (ASPP) module, and/or (6) implement deep supervision using predictions generated at each stage in the decoder. A unified focal loss framework is implemented after Yeung et al. (2022) doi:10.1016/j.compmedimag.2021.102026. We have also implemented assessment metrics using the 'luz' package including F1-score, recall, and precision. Trained models can be used to predict to spatial data without the need to generate chips from larger spatial extents. Functions are available for performing accuracy assessment. The package relies on 'torch' for implementing deep learning, which does not require the installation of a 'Python' environment. Raster geospatial data are handled with 'terra'. Models can be trained using a Compute Unified Device Architecture (CUDA)-enabled graphics processing unit (GPU); however, multi-GPU training is not supported by 'torch' in 'R'.
Install
Health
CRAN check results are not tracked yet.
- OK14 OK2026-03-10
Documentation
- Help pages
- 38
- Examples that run
- 7%2 run in a plain check (1 of them under a condition) · 5 only when donttest examples are enabled (R CMD check --as-cran) · 20 never run
- Exported functions with examples
- 71%
- Documented parameters
- 99%
- Return-value docs
- 84%
- Help pages citing references
- 0%
Downloads
Dependencies
Code & Tests
People & History
Pick two releases to compare their code metrics.
- archivedRemoved from CRAN2026-04-28issues were not corrected in time
- RR 4.6.0 released · 2026-04-24
- 0.3.12025-12-02 · diff ↗
- 0.3.02025-11-12 · diff ↗ ·
removed 1 export
makeTerrainDerivativesadded 16 exports
callback_save_model_state_dict, checkDynamicChips, countParams, defineDynmamicSegDataSet, defineTerrainSeg, defineUNet3p, makeAspect, makeCrv, makeDynamicChipsSF, makeHillshade, makeSlope, makeTPI, makeTRI, makeTerrainVisTerra, makeTerrainVisTorch, saveDynamicChips - RR 4.5.0 released · 2025-04-11
- 0.2.02024-08-20
- RR 4.4.0 released · 2024-04-24
Package metadata
- First published
- 2024-08-20
- Total releases
- 3 / 2 yrs
- License
- GPL (>= 3) OSI
- Minimum R
- ≥ 4.2
- Download size
- 94 KB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("geodl")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-24, which the citation names so these numbers can be found later. More on citing and the projects behind them.