Build potentiometric surfaces and hydraulic-gradient arrows

potentiomap prepares groundwater-head observations, interpolates mapped potentiometric surfaces, reports model diagnostics and prediction support, creates contour inventories, and derives local hydraulic-gradient arrow symbols. It is intended for hydrogeologists, environmental scientists, and GIS users reviewing groundwater-level data.

Details

Main functions:

• ps_make_points() and ps_potentiometric_points() prepare observations.

• ps_interpolate() and ps_interpolate_grouped() create surfaces.

• ps_diagnostics() and ps_prediction_support() describe model behavior and where predictions have limited observational support.

• ps_contours() inventories requested contour levels, and ps_contour_support() divides those lines by user-defined local support.

• ps_flow_arrows() and ps_validate_arrows() create and check local negative-gradient symbols.

• ps_quicklook(), ps_export_surfaces(), and ps_export_contour_support() review and save products.

• ps_check_observations(), ps_select_event(), and ps_screen_groups() document observation, timing, and screen-selection decisions.

• ps_validate(), ps_compare_methods(), and ps_tune_interpolation() evaluate explicit prediction tasks without calling them map truth.

• ps_surface_uncertainty() and ps_contour_uncertainty() retain model-conditional or resampling assumptions.

• ps_head_change(), ps_vertical_gradient(), ps_well_influence(), and ps_network_thinning() support event and monitoring-network review.

• ps_surface_profile(), ps_cross_section(), ps_export_style(), and ps_report() create review and exchange products.

Hydraulic-gradient arrows are map symbols derived from the local gradient of a modeled surface. Their lengths are display conventions. They are not traced groundwater paths, groundwater velocities, or travel times. A finite surface or a passing arrow-tip check does not establish hydrogeologic validity; users should evaluate measurements, method assumptions, spatial trend, prediction support, and intended map use.

Project links:

• Documentation: https://el-cordero.github.io/potentiomap/

• Source: https://github.com/el-cordero/potentiomap

• Issues: https://github.com/el-cordero/potentiomap/issues

• CRAN: https://CRAN.R-project.org/package=potentiomap

Use citation("potentiomap") for citation guidance.

See also

Useful links:

• https://el-cordero.github.io/potentiomap/

• https://github.com/el-cordero/potentiomap

• Report bugs at https://github.com/el-cordero/potentiomap/issues

Author

Maintainer: Elvin Cordero elvin.cordero@seamountgeo.com (ORCID)