Learn R Programming

HYPEtools

Summary

HYPEtools provides functions to work with the hydrological model HYPE. HYPE and HYPEtools are projects developed by the Swedish Meteorological and Hydrological Institute (SMHI).

License

HYPEtools is licensed under the LGPL-3.0 license.

Changelog

See the HYPEtools changelog here.

Installation

HYPEtools is on CRAN and can be downloaded with:

install.packages("HYPEtools")

If, however, you would like to install the latest development version of HYPEtools from GitHub, then you can do so with:

# install.packages("devtools")
devtools::install_github("rcapell/HYPEtools") # Install Without Vignettes
devtools::install_github("rcapell/HYPEtools", build_vignettes = T) # Install With Vignettes

More detailed instructions on installing the provided sources or package in R can be found here.

Vignettes

Browse HYPEtools Vignettes with:

browseVignettes("HYPEtools")

Citation

Publication

To cite HYPEtools in publications, please use the following publication reference:

Brendel, C., R. Capell, and A. Bartosova. (2024) Rational gaze: Presenting the open-source HYPEtools R package for analysis, visualization, and interpretation of hydrological models and datasets. Environmental Modelling & Software, 178, 106094. https://doi.org/10.1016/j.envsoft.2024.106094

Software

The HYPEtools software itself can also be cited in publications using the output from running the following in R:

citation("HYPEtools")

Copy Link

Version

Install

install.packages('HYPEtools')

Monthly Downloads

357

Version

1.6.4

License

LGPL-3

Issues

Pull Requests

Stars

Forks

Maintainer

Rene Capell

Last Published

November 27th, 2024

Functions in HYPEtools (1.6.4)

CreateOptpar

Create an optpar list
BoxplotSLCClasses

Box plots of SLC distributions
CustomColors

Custom color ramp palettes
AllDownstreamSubids

Find All Downstream SUBIDs
BarplotUpstreamClasses

Bar plots of upstream-averaged classes of HYPE sub-basins
CompareFiles

Compare HYPE model files to identify any differences.
ConvertDischarge

Calculate Specific runoff from volumetric discharge and vice versa
CleanSLCClasses

Clean Soil-Landuse classes (SLCs) from small fractions
AllUpstreamSubids

Find All Upstream SUBIDs
AnnualRegime

Calculate annual regimes
ExtractFreq

Extract quantiles for use in a frequency distribution plot, e.g. a flow duration curve
DirectUpstreamSubids

Find Direct Upstream SUBIDs, with Flow Fractions
EquallySpacedObs

Create an equally spaced time series from irregular observations
HeadwaterSubids

Find all headwater SUBIDs of a model domain
GOF

Goodness of Fit Functions
GwRetention

Calculate groundwater retention of nutrients
GroupSLCClasses

Calculate grouped sums for SLC classes in a GeoData file
ExtractStats

Extract statistics from time series
HypeAttrAccess

Quickly query and set HYPE-specific attributes
HYPEtools-package

HYPEtools: Tools for Processing and Analyzing Files from the Hydrological Catchment Model HYPE
MapRegionalSources

Map regional irrigation source connection as spatial lines
HypeDataExport

Write HYPE data files
HypeSubidChecks

Check HYPE SUBID properties
HypeSingleVar

HypeSingleVar arrays
HypeXobs

HypeXobs data frames
HypeMultiVar

HypeMultiVar arrays
HypeGeoData

HypeGeoData data frames
InfoManipulation

Functions to Manipulate HYPE Info Files
OptimisedClasses

Get optimized classes from an imported optpar.txt file
HypeDataImport

Read HYPE data files
NSE.HypeSingleVar

Nash-Sutcliffe Efficiency
MergeXobs

Merge two Xobs data frames
PlotBasinOutput

Plot a suite of time series plots from a HYPE basin output file
PlotBasinSummary

Plot a summary of model results for a single sub-basin
OutletNearObs

Find outlet-near observations in HYPE observation data files.
OutletSubids

Find all Outlet SUBIDs of a model domain
MergeObs

Merge two HYPE observation data frames
PartyParrot

Create a Party Parrot.
PlotAnnualRegime

Plot annual regimes
OutletIds

Find Outlet IDs
ReadDescription

Read a 'description.txt' file
ReadClassData

Read a 'ClassData.txt' File
PlotDurationCurve

Plot duration curves
ReadBasinOutput

Read a Basin Output File
ReadGeoClass

Read a 'GeoClass.txt' File
PlotMapPoints

Plot function for mapped point information
PlotSimObsRegime

Plot annual regimes of simulated and observed variables
PlotSubbasinRouting

Plot HYPE model subbasin routing.
ReadSubass

Read a 'subassX.txt' file
ReadGeoData

Read a 'GeoData.txt' file
PlotMapOutput

Plot function for HYPE map results.
ReadInfo

Read an 'info.txt' file
ReadMapOutput

Read a Map Output File
ReadOptpar

Read an 'optpar.txt' file
ReadPar

Read a 'par.txt' file
ReadPmsf

Read a 'pmsf.txt' file
PlotPerformanceByAttribute

Plot model performance by SUBID attributes
ReadSimass

Read a 'simass.txt' file
ReadTimeOutput

Read a Time Output File
SimToPar

HYPE Calibration Outputs to par.txt
RescaleSLCClasses

Re-scale SLC classes in a GeoData data frame
ScaleAquiferData

Scale 'AquiferData.txt' files to different model time steps
ReadObs

Read HYPE observation data files
SortGeoData

Sort a GeoData dataframe in downstream order
VisualizeMapPoints

Shiny App for visualizing Mapped Point Information.
VisualizeMapOutput

Shiny App for visualizing HYPE MapOutputs.
ScalePar

Scale 'par.txt' files to different model time step
ScaleFloodData

Scale 'FloodData.txt' files to different model time steps
UpstreamGeoData

Calculate upstream sums and averages of selected GeoData contents
SumUpstreamArea

Calculate upstream area sums
ReadWsOutput

Read optimization simulation results
WriteGeoClass

Write a 'GeoClass.txt' file
WriteBasinOutput

Write a basin output '[SUBID].txt' file
ReadXobs

Read an 'Xobs.txt' file
WritePmsf

Write a 'pmsf.txt' file
UpstreamSLCClasses

Calculate SLC class fractions of all upstream areas
VariableLookup

Lookup Functions For HYPE Variables
WriteMapOutput

Write a 'mapXXXX.txt' file
WriteObs

Write 'Pobs.txt', 'Tobs.txt', 'Qobs.txt', and other observation data files
WriteOptpar

Write an 'optpar.txt' File
WritePar

Write a 'par.txt' File
SubidAttributeSummary

Summarize subbasin attributes
SumSLCClasses

Calculate sums of SLC classes in a GeoData file
UpstreamGroupSLCClasses

Calculate area-weighted upstream averages of grouped SLC class fractions.
UpstreamPointSources

Summarize point source emissions of all upstream areas
WriteTimeOutput

Write a 'timeXXXX.txt' file
WriteHarmonizedSpatialDescription

Write a Harmonized Spatial Description File
WriteInfo

Write a 'info.txt' File
distinctColorPalette

Generate optimally distinct color palettes
WriteXobs

Write an 'Xobs.txt' File
WriteGeoData

Write a 'GeoData.txt' file
WriteHarmonizedData

Write a Harmonized Data File
r

Pearson product-moment correlation coefficient r
merge

Merge HypeGeoData object
pbias.HypeSingleVar

Percent bias