Skip to main content

Catchmentwide erosion rate calculator

Project description


NEW in version 1.3 (released 2024-06-03):

Updated lithological ('quartz') weighing functions.

Use functions get_ages_from_server() and get_erates_from_server() to obtain point-based exposure ages and erosion rates calculated by the online calculator from sample data in your Excel spreadsheet and save the results as spreadsheet.

See updated documentation quickstart.ipynb


Catchmentwide erosion rates with riversand

riversand is a python package to calculate catchmentwide erosion rates from cosmogenic nuclide concentrations in river sand samples. The program computes the hypsometric statistics of the catchment area from a digital elevation model. It uses the online erosion rate calculator by Greg Balco (e.g. http://stoneage.hzdr.de/) to determine predicted nuclide concentrations $N$ for given erosion rates $E$, and calculates the erosion rate that corresponds to the measured nuclide concentration from a polynomial fit $N(E)$.

Rastergrafik

The method works for in situ Be-10 and Al-26 data. It is fast (few seconds for one catchment) for all production scaling methods implemented in the online calculator (St: Lal 1991/Stone 2000; Lm: Lal/Stone with a geomagnetic correction after Nishiizumi et al. 1989; LSDn: Lifton et al. 2014) and independent of the catchment size or the resolution of the digital elevation model. It is considered robust for catchments up to approx. 600 km x 600 km; for larger catchments the effect of latitude on cosmogenic production may become significant.

The approach is described in:

Stübner, K., Balco, G., and Schmeisser, N. (2023). Riversand: a new tool for efficient computation of catchmentwide erosion rates. Radiocarbon. (link).

Definitely check out the documentation of the online calculator (e.g. here or here) and the publication Balco et al. (2008) before using this calculator.

Documentation

  • quickstart.ipynb
  • step_by_step.ipynb
  • test_data/ : geotiffs of a 35m-resolution digital elevation model, a topographic shielding raster generated with TopoToolbox and a binary raster indicating quartz-bearing and quartz-free lithologies; shapefiles with catchment outlines; a spreadsheet with sample data.

Installation

Install riversand by running:

$ pip install riversand==1.3

Requirements

  • numpy, scipy, pandas, xarray
  • rasterio, fiona, pyproj
  • matplotlib

License

GNU General Public License v3.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

riversand-1.3.tar.gz (57.4 kB view details)

Uploaded Source

Built Distribution

riversand-1.3-py3-none-any.whl (59.6 kB view details)

Uploaded Python 3

File details

Details for the file riversand-1.3.tar.gz.

File metadata

  • Download URL: riversand-1.3.tar.gz
  • Upload date:
  • Size: 57.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.10.13

File hashes

Hashes for riversand-1.3.tar.gz
Algorithm Hash digest
SHA256 d27fefe03eb8225bed0ea9a7a11fb34015a695d582ef4e3778570c945404f032
MD5 4206b7bf6c76e90ff1188cf19834bc0e
BLAKE2b-256 a776dfc1398ce52db435b276c06078df6109fc4e838ef8f495287b18181b6123

See more details on using hashes here.

File details

Details for the file riversand-1.3-py3-none-any.whl.

File metadata

  • Download URL: riversand-1.3-py3-none-any.whl
  • Upload date:
  • Size: 59.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.10.13

File hashes

Hashes for riversand-1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 74459b5f0f2ef9fd3fc7b2fcd712810b6b4a3b89a329788e8214c3adae4b6b52
MD5 daca662d50586081994fb837420a201d
BLAKE2b-256 f7b8dd97db1ebc4d8c5a1a20d1f213c5981f4f12233405445d66be9e4da2beac

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page