Bindings to 'GDAL'
Overview
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. Initial bindings are provided to the unified 'gdal' command line interface added in 'GDAL' 3.11. C++ stand-alone functions provide bindings to most 'GDAL' "traditional" raster and vector utilities, including 'OGR' facilities for vector geoprocessing, several algorithms, as well as 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.
- add
GDALVector$writeArrowBatch(): write a batch of rows from a data frame using GDAL Arrow C stream interface (#976) - add
get_data_ptr(): get the pointer address of R data with format suitable asDATAPOINTERfor a GDAL MEM dataset (#993) - add
g_point_on_surface(): wrapper ofOGR_G_PointOnSurface()in the GDAL API get_pixel_line(): treat points "exactly" on the right or bottom raster edge as inside (#973)RunningStatsclass: support optionally returning the count asbit64::integer64(#975)- fix
print.OGRFeatureSet(): avoid error if geometry column is missing - minor reformat the documentation of Rcpp exposed classes to satisfy CRAN requirements w.r.t.
.Rdfiles without\usage - (internal) replace
ARE_REAL_EQUAL()withequal_within_ulps_()(#974) - (internal) fix tests for some geometry functions due to changes in GEOS 3.15.0
- (internal) fix test for
GDALAlg::setArg()due to an argument data type change at GDAL 3.14
From NEWS.md in the release
Install
Health
- OK13 OK2026-09-27
- ERROR11 OK, 1 NOTE, 1 ERROR2026-09-08
- NOTE12 OK, 1 NOTE2026-07-11
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-08
Show 6 earlier changesHide 6 earlier changes
- OK13 OK2026-05-12
- WARNING12 OK, 1 WARNING2026-05-11
- OK13 OK2026-05-02
- NOTE11 OK, 3 NOTE2026-04-22
- ERROR10 OK, 3 NOTE, 1 ERROR2026-04-18
- NOTE11 OK, 3 NOTE2026-03-10
Documentation
The repository also keeps web-only articles.
- Help pages
- 135includes a package overview page
- Examples that run
- 97%118 run in a plain check (10 of them under a condition) · 3 never run · 1 hold no code
- Exported functions with examples
- 91%
- Documented parameters
- not tracked
- Return-value docs
- not tracked
- Help pages citing references
- 1%
Downloads
Repository
- PRs merged (all time)
- 98%
- Median days to close, 50 most recently updated closed issues
- 6
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
Commits over time
17 development-tooling and community-health practices detected across 7 families in the upstream repository
Checks run against github.com/firelab/gdalraster on 2026-10-11.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-10-07 · The repository has a site deploy workflow
pkgdown site last built 2026-10-07
Show all practicesHide 3 practices
Dependencies
Installing gdalraster adds 10 packages (10 with compiled code, 6.8 MB of source tarballs). Heaviest: Rcpp 1.8 MB, yyjsonr 1.3 MB, wk 1.0 MB.
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- 2.7.0Latest
- 2.6.12026-05-16 · diff ↗
- 2.6.02026-05-04 · diff ↗
- RR 4.6.0 released · 2026-04-24
- 2.5.02026-03-25 · diff ↗
- 2.4.02025-12-18 · diff ↗
- 2.3.02025-11-19 · diff ↗
- 2.2.12025-08-29 · diff ↗
- 2.2.02025-08-22 · diff ↗
- 2.1.02025-07-14 · diff ↗
- 2.0.02025-05-11 · diff ↗
- RR 4.5.0 released · 2025-04-11
- 1.12.02025-01-19 · diff ↗
- 1.11.12024-06-13 · diff ↗
- 1.11.02024-06-03 · diff ↗
- RR 4.4.0 released · 2024-04-24
Show 11 earlier eventsHide 11 earlier events
Package metadata
- First published
- 2023-05-24
- Total releases
- 23 / 3 yrs
- License
- MIT + file LICENSE OSI
- Copyright
- See file inst/COPYRIGHTS for details.
- Minimum R
- ≥ 4.2.0
- Download size
- 3.2 MB
Cite
Cite this package
Run in R for the authors' entry:
citation("gdalraster")The package provides a citation file, so citation() returns the authors' own entry.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-18, which the citation names so these numbers can be found later. More on citing and the projects behind them.