hydrographr: An R package for scalable hydrographic data processing
Authors:
- Afroditi GrigoropoulouAGAfroditi Grigoropoulou
- Jaime García MárquezJMJaime García Márquez
- Yusdiel Torres‐CambasYTYusdiel Torres‐Cambas
- Mathieu FlouryMFMathieu Floury
- Vanessa BremerichVBVanessa Bremerich
- Christoph SchürzCSChristoph Schürz
- Giuseppe AmatulliGAGiuseppe Amatulli
- Hans‐Peter GrossartHGHans‐Peter Grossart
- Sami DomischSDSami Domisch
Open Access
- 30 October 2023
- journal article
- research article
- Published by Wiley in Methods in Ecology and Evolution
- Vol. 14 (12) , 2953-2963
Abstract
Freshwater ecosystems are considered biodiversity hotspots, but assessing the spatial distribution of species remains challenging. One major obstacle lies in the complex geospatial processing of large amounts of data, such as stream network, sub‐catchment and basin data, that are necessary for addressing the longitudinal connectivity among water bodies. Workflows thus need to be scalable, especially when working across large spatial extents and at high spatial resolution. This in turn requires advanced command‐line GIS skills and programming language integration, which often poses a challenge for freshwater researchers. To address this challenge, we developed the package hydrographr that provides scalable hydrographic data processing in R. The package contains functions for downloading data of the high‐resolution Hydrography90m dataset, processing, reading and extracting information, as well as assessing network distances and connectivity. While the functions are, by default, tailored toward the Hydrography90m data, they can also be generalised toward other data and purposes, such as efficient cropping and merging of raster and vector data, point‐raster extraction, raster reclassification and data aggregation. The package depends on the open‐source software GDAL/OGR, GRASS‐GIS and the AWK programming language in the Linux environment, allowing a seamless language integration. Since the data is processed outside R, hydrographr allows creating scalable geo‐processing workflows. We illustrate the hydrographr functions using two workflows that focus on (i) a freshwater species distribution modelling approach, and (ii) assessing stream connectivity given the fragmentation by dams. We also provide a detailed guide for the initial installation of the required software. Windows users need to first enable the Windows Subsystem for Linux (WSL) feature, and can then follow the same software installation as Linux users. hydrographr is maintained on GitHub at https://github.com/glowabio/hydrographr. hydrographr provides a set of key functions for processing freshwater geospatial data. We expect that the package will support the freshwater‐related research communities given the easy‐to‐use wrapper functions that allow capitalizing on powerful open‐source command‐line software, which may otherwise require a steep learning curve. Users can thus perform large‐scale freshwater‐specific longitudinal connectivity and network analyses across large geographic extents while staying within the R environment.Keywords
Funding Information
- Alexander von Humboldt-Stiftung (Ref 3.2‐CUB‐1212347‐GF‐P)
This publication has 20 references indexed in Scilit:
- Global priorities for an effective information basis of biodiversity distributionsNature Communications, 2015
- Application of species distribution models in stream ecosystems: the challenges of spatial and temporal scale, environmental predictors and species occurrence dataFundamental and Applied Limnology, 2015
- A global boom in hydropower dam constructionAquatic Sciences, 2014
- Global carbon dioxide emissions from inland watersNature, 2013
- Diversity in riverine metacommunities: a network perspectiveAquatic Ecology, 2013
- High‐resolution mapping of the world's reservoirs and dams for sustainable river‐flow managementFrontiers in Ecology and the Environment, 2011
- A topological system for delineation and codification of the Earth’s river basinsJournal of Hydrology, 1999
- The Modifiable Areal Unit Problem in Multivariate Statistical AnalysisEnvironment and Planning A: Economy and Space, 1991
- Digital terrain modelling: A review of hydrological, geomorphological, and biological applicationsHydrological Processes, 1991
- Awk — a pattern scanning and processing languageSoftware: Practice and Experience, 1979