About

HowLeaky is a software application that has been designed to assess the impacts of different land uses, soil conditions, management practices and climate-types on water balance and water quality. It can provide reliable and flexible results from limited input data for a wide range of land use studies. It is highly suited for benchmarking and comparison of land use practices and exploring and highlighting the impacts of changing key variables on the system response. HowLeaky is particularly useful for investigating the water quality and erosion effects of agricultural practices such as irrigation, tillage, pesticide and nutrient (N and P) applications. 

The HowLeaky model simulates the soil water balance (core model) and its effects on different agricultural and land use management practices (submodels) at a point-scale and on a daily time-step. The model uses daily climate data and a volumetric parameterisation of the soil layers to model the core components of soil water inflows, outflows and redistribution of water in the soil. 

Runoff is calculated as a function of daily rainfall, soil water deficit, surface residue, crop cover and surface roughness. Soil water is updated on a daily basis by any rainfall exceeding the daily runoff volume. Infiltration is partitioned into the soil profile from the surface, filling subsequent layers to total porosity. When a soil profile layer is above its defined field capacity, soil water redistribution occurs but only if the layer immediately below can hold the water. Redistribution from the lowest profile layer is assumed lost to the system as deep drainage. 

Water can be lost from the soil profile as transpiration and soil evaporation. Transpiration is represented as a function of pan evaporation, green cover (or leaf area) and soil moisture. It is removed from the profile according to the current depth and distribution of roots. Transpiration can only dry a profile layer to its defined wilting point. Soil evaporation isread more

Modelling

Studies

A "study" can refer to a single site, multiple treatments at a site or collection of locations where some aspects of water balance and water quality have been carried out. A collation of studies related to water balance and water quality across Australia can be found at http://howleaky.net/index.php/library, but this dataset does not have guaranteed tenure.

This site is a collection of studies with varying degrees of data completeness to support ongoing development of an understanding of the role of land sue and management on water, sediment, nutrient and pesticide flows from agricultural management units (paddocks or fields).

One aim of this site is for data custodians to add sites as they see fit. This might be to initially explore how the Howleaky model can deal with their data and ideally, to share site details and data sets that might help improve our understanding of how landscape and paddock management contribute to catchment behaviors.

Datasets

A "dataset" can range from general descriptions of how a site under a specified management behaves under natural rainfall or irrigation, through to detailed observations and measurements of water, soil, sediment, nutrient and pesticide flows.

Ideally, a dataset should be sufficiently described to help others to use this information to improve understanding of hydrology and material flows at the paddock and catchment level.

Rather than specifying a "minimum description", contributors are encouraged to add any data they think might be useful to others, and at least, but adding some site description and data, promote dialogue and ideas sharing.  We have found that some very coarse or poorly described datasets can be highly valued, especially when there is little other information available.

Simulations

A site may have a set of model simulations designed to: test the models ability to simulate a set of observations and explore a range of management conditions beyond conditions available within the sites' observations i.e. differnt soil types, climates, crops.

New model users can use an existing simulation as a starting point for exploring the Howleaky model. Some users may test a "published" (on this site) dataet and simulation with new data streams.

Sharing

This site has a number of datasets and simulations "published" and available for further exploration. The aim of this site is to promote sharing of datasets ( small and large, incomplete and comprehensive) that might contribute to our understanding of soil and landscape processes.

New datasets and simulations can be added, but remain unpublished until the data custodian or modelers wishes to make these available. A site can be shared with specified others who register on the site. Contributors to the site have full control over their data entries.

Open-source Development

Source Code on GitHub

The source-code for the HowLeaky Simulation Engine is freely available for anyone to download and use via the GitHub repository.  You may use this code however you like under the Creative Commons Attribution-ShareAlike 4.0 International License (https://creativecommons.org/licenses/by-sa/4.0/). This Code is deveoped in the C# langauge and can be managed using either Microsoft Visual Studio IDE or Microsoft Visual Studio Code.

It is encouraged that any code changes which could benefit the wider HowLeaky community be re-uploaded back to the repository. These changes will then be reviewed by the HowLeaky "scientific" Panel, for possible inclusion in future versions.

Repository Components

The HowLeaky-Core repository contains the following modules:

  • HowLeaky Core Engine. This project contains all the code required to run the HowLeaky Simulation Engine, including classes for inputs and outputs. Note however, that it doesn't contain any information on how to read these inputs or write these outputs. For that see the IO Module.
  • HowLeaky IO Module. Contains code to read legacy hlk project files, as well as write outputs to CSV and Binary files.
  • HowLeaky Console. Contains code to run the HowLeaky model from HLK files and output CSV files.
  • HowLeaky Unit Tests. Unit tests for engine.

Forking Repository

 To use this code, please follow these steps:

  1. Create your own GitHub account and go to  the HowLeaky-Core repository.
  2. It is highly recommended that you download the GitHub Desktop software to manage this code.
  3. Create a new "Fork" of the repository to your account. Only changes to this fork can be resubmitted back to the repository for review by the HowLeaky Panel.
  4. Login to GitHub Desktop, and pull down the fork you have created. 

 

Submitting Changes

To sumit your changes back to the HowLeaky Panel for review (and possible inclusion in the "base" version"

  1. Push your changes to your branch back to the repository.
  2. Fill out the Submission Form on this website to notify the Panel of your submission. 
  3. Once you have made contact with the Panel, create a "Pull Request" in your fork of the HowLeaky-core repository by following the instructions below. This will allow the Panel to evalulate your code changes. 

Contact us for more information

Would you like more information about how to be involved with the HowLeaky project?
BESbswy