potentiomap: Build Potentiometric Surfaces and Hydraulic-Gradient Arrows

Prepares groundwater-level observations from measured hydraulic head or from depth-to-water and land-surface elevation, interpolates potentiometric surfaces using thin-plate splines, inverse-distance weighting, ordinary Kriging, universal Kriging, or user-supplied methods, and creates raster, contour, diagnostic, support, and hydraulic-gradient products for review and export. Functions retain method conditions and fit diagnostics, validate explicit prediction tasks, inspect model-conditional uncertainty and monitoring-network sensitivity, identify limited prediction support, and check whether scaled hydraulic-gradient arrows remain within finite raster support and end at lower modeled head. Raster processing uses methods from 'terra' (Hijmans 2025) <doi:10.32614/CRAN.package.terra>, thin-plate splines use methods from 'fields' (Nychka et al. 2021) <doi:10.5065/D6W957CT>, and geostatistical interpolation uses methods from 'gstat' (Pebesma 2004) <doi:10.1016/j.cageo.2004.03.012>.

Version:	0.2.0
Depends:	R (≥ 4.1)
Imports:	fields, grDevices, graphics, gstat, sf, stats, terra, xml2
Suggests:	knitr, rmarkdown, testthat (≥ 3.0.0), withr
Published:	2026-07-18
DOI:	10.32614/CRAN.package.potentiomap
Author:	Elvin Cordero [aut, cre]
Maintainer:	Elvin Cordero <elvin.cordero at seamountgeo.com>
BugReports:	https://github.com/el-cordero/potentiomap/issues
License:	GPL-3
URL:	https://el-cordero.github.io/potentiomap/, https://github.com/el-cordero/potentiomap
NeedsCompilation:	no
Language:	en-US
Materials:	README, NEWS
CRAN checks:	potentiomap results

Documentation:

Reference manual:

potentiomap.html , potentiomap.pdf

Vignettes:

Contours and hydraulic-gradient arrows (source, R code) Interpolation diagnostics and prediction support (source, R code) Getting started with potentiomap (source, R code) Exporting GIS products and technical reports (source, R code) Monitoring-network sensitivity and candidate locations (source, R code) Preparing and checking groundwater observations (source, R code) Surface profiles, depth to water, and cross-sections (source, R code) Temporal head change and vertical hydraulic gradients (source, R code) Prediction support, surface uncertainty, and contour uncertainty (source, R code) Units, vertical references, and grouped groundwater observations (source, R code) Validating and comparing interpolation methods (source, R code) Variograms, anisotropy, and external drift (source, R code)

Downloads:

Package source:	potentiomap_0.2.0.tar.gz
Windows binaries:	r-devel: potentiomap_0.2.0.zip, r-release: potentiomap_0.1.0.zip, r-oldrel: potentiomap_0.1.0.zip
macOS binaries:	r-release (arm64): potentiomap_0.2.0.tgz, r-oldrel (arm64): potentiomap_0.2.0.tgz, r-release (x86_64): potentiomap_0.2.0.tgz, r-oldrel (x86_64): potentiomap_0.2.0.tgz
Old sources:	potentiomap archive

Linking:

Please use the canonical form https://CRAN.R-project.org/package=potentiomap to link to this page.