peterson-tim-j / HydroSight

Groundwater timeseries analysis of hydrographs
GNU General Public License v3.0
45 stars 20 forks source link
aquifer-parameters groundwater hydrogeology hydrology matlab recharge timeseries

HydroSight: Open-source data-driven hydrogeological insights

Testing Codecov GitHub release View HydroSight on File Exchange [Github All Releases]() GitHub license GitHub forks GitHub stars

HydroSight is statistical toolbox for data-driven insights into groundwater dynamics and aquifer properties. Many hundreds of bores can be easily analysed, all without any programming, to quantify:

Installation Options

HydroSight is operating system independent and has been tested on Windows 10+, Mac and Linux (Ubuntu 20.04 LTS). There are four installation options:

  1. Stand-alone app within Windows. The latest .exe is available here.
  2. Install Hydrosight Matlab source code by (i) downloading the source code, (ii) unzipping the downloaded file, (ii) setting the Matlab Current Folder to where the file was unzipped and (iv) entering HydroSight into the Matlab Command Window.
  3. Install Hydrosight from within Matlab using the Add-Ons menu item and searching for HydroSight. From the Add button select Add to Matlab. Once installed, enter HydroSight into the Matlab Command Window.
  4. Compile your own stand-alone app from within Matlab by (i) downloading the source code and (ii) running the command: makeStandaloneHydroSight()

For futher details see the installation wiki page.

Examples

Multiple examples are built into the HydroSight GUI, each highlighting aspects of the above papers. Soon, each example will be supported by online videos. In the meantime major aspects of the graphical interface and the algorithms are outlined on the wiki page.

HydroSight can also be run from the Matlab command window. For an example of this see here.

What does HydroSight look like?

The HydroSight graphical interface includes tabs for each step in the modelling of groundwater hydrographs:

  1. Project documentation.
  2. Hydrograph outlier detection.
  3. Time-series model construction, specifically defining the data and the form of the model.
  4. Model calibration and tools to examine the internal dynamics of the calibrated model, e.g. recharge. The screenshot below shows this tab and an estimate of the annual groundwater recharge.
  5. Model simulations, allowing hydrograph decomposition, exploration of scenarios (e.g. different climate or pumping), hindcasting and interpolation.

_HydroSight_ Recharge estimation

Contributing

HydroSight is an ongoing research project and that depends upon your support. Two easy ways to support us are:

  1. Give us a GitHub ⭐.
  2. Cite the relevant papers (using the "Cite Project" option within the GUI).

And, if HydroSight doesn't do what you need then Support gives more options.