API bindings to the Geospatial Data Abstraction Library ('GDAL', <https://gdal.org>). Implements the 'GDAL' Raster and Vector Data Models. Bindings are implemented with 'Rcpp' modules. Exposed C++ classes and stand-alone functions wrap much of the 'GDAL' API and provide additional functionality. Calling signatures resemble the native C, C++ and Python APIs provided by the 'GDAL' project. Class 'GDALRaster' encapsulates a 'GDALDataset' and its raster band objects. Class 'GDALVector' encapsulates an 'OGRLayer' and the 'GDALDataset' that contains it. Class 'VSIFile' provides bindings to the 'GDAL' 'VSIVirtualHandle' API. Additional classes include 'CmbTable' for counting unique combinations of integers, and 'RunningStats' for computing summary statistics efficiently on large data streams. C++ stand-alone functions provide bindings to most 'GDAL' raster and vector utilities including 'OGR' facilities for vector geoprocessing, several algorithms, the Geometry API ('GEOS' via 'GDAL' headers), the Spatial Reference Systems API, and methods for coordinate transformation. Bindings to the Virtual Systems Interface ('VSI') API implement standard file system operations, abstracted for URLs, cloud storage services, 'Zip'/'GZip'/'7z'/'RAR', in-memory files, as well as regular local file systems. This provides a single interface for operating on file system objects that works the same for any storage backend. A custom raster calculator evaluates a user-defined R expression on a layer or stack of layers, with pixel x/y available as variables in the expression. Raster 'combine()' identifies and counts unique pixel combinations across multiple input layers, with optional raster output of the pixel-level combination IDs. Basic plotting capability is provided for raster and vector display. 'gdalraster' leans toward minimalism and the use of simple, lightweight objects for holding raw data. Currently, only minimal S3 class interfaces have been implemented for selected R objects that contain spatial data. 'gdalraster' may be useful in applications that need scalable, low-level I/O, or prefer a direct 'GDAL' API.
| Version: | 2.0.0 |
| Depends: | R (≥ 4.2.0) |
| Imports: | bit64, graphics, grDevices, methods, nanoarrow, Rcpp (≥ 1.0.7), stats, tools, utils, wk, xml2 |
| LinkingTo: | nanoarrow, Rcpp, RcppInt64 |
| Suggests: | gt, knitr, rmarkdown, scales, testthat (≥ 3.0.0) |
| Published: | 2025-05-11 |
| DOI: | 10.32614/CRAN.package.gdalraster |
| Author: | Chris Toney [aut, cre] (R interface/additional functionality), Michael D. Sumner [ctb], Frank Warmerdam [ctb, cph] (GDAL API documentation; src/progress_r.cpp from gdal/port/cpl_progress.cpp), Even Rouault [ctb, cph] (GDAL API documentation), Marius Appel [ctb, cph] (configure.ac based on https://github.com/appelmar/gdalcubes), Daniel James [ctb, cph] (Boost combine hashes method in src/cmb_table.h), Peter Dimov [ctb, cph] (Boost combine hashes method in src/cmb_table.h) |
| Maintainer: | Chris Toney <chris.toney at usda.gov> |
| BugReports: | https://github.com/USDAForestService/gdalraster/issues |
| License: | MIT + file LICENSE |
| Copyright: | See file inst/COPYRIGHTS for details. gdalraster copyright details |
| URL: | https://usdaforestservice.github.io/gdalraster/, https://github.com/USDAForestService/gdalraster |
| NeedsCompilation: | yes |
| SystemRequirements: | C++17, GDAL (>= 3.1.0, built against GEOS) |
| Citation: | gdalraster citation info |
| Materials: | README NEWS |
| In views: | Spatial |
| CRAN checks: | gdalraster results |
| Reference manual: | gdalraster.pdf |
| Vignettes: |
GDAL Config Quick Reference (source, R code) Raster API Tutorial (source, R code) Raster Attribute Tables (source, R code) Vector API Overview (source, R code) |
| Package source: | gdalraster_2.0.0.tar.gz |
| Windows binaries: | r-devel: gdalraster_1.12.0.zip, r-release: gdalraster_2.0.0.zip, r-oldrel: gdalraster_1.12.0.zip |
| macOS binaries: | r-release (arm64): gdalraster_2.0.0.tgz, r-oldrel (arm64): gdalraster_2.0.0.tgz, r-release (x86_64): gdalraster_2.0.0.tgz, r-oldrel (x86_64): gdalraster_2.0.0.tgz |
| Old sources: | gdalraster archive |
| Reverse imports: | FIESTA, FIESTAutils |
| Reverse suggests: | geotargets, gpkg, ursa |
Please use the canonical form https://CRAN.R-project.org/package=gdalraster to link to this page.