ldsr

Streamflow reconstruction using linear dynamical system

https://github.com/Critical-Infrastructure-Systems-Lab/ldsr

Science Score: 13.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
  • .zenodo.json file
  • DOI references
    Found 4 DOI reference(s) in README
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.4%) to scientific vocabulary

Keywords

expectation-maximization-algorithm hydrology kalman-smoother linear-dynamical-systems paleoclimate
Last synced: 6 months ago · JSON representation

Repository

Streamflow reconstruction using linear dynamical system

Basic Info
  • Host: GitHub
  • Owner: Critical-Infrastructure-Systems-Lab
  • Language: R
  • Default Branch: master
  • Size: 938 KB
Statistics
  • Stars: 8
  • Watchers: 1
  • Forks: 1
  • Open Issues: 1
  • Releases: 0
Topics
expectation-maximization-algorithm hydrology kalman-smoother linear-dynamical-systems paleoclimate
Created over 7 years ago · Last pushed over 3 years ago
Metadata Files
Readme

README.md

Travis build status GPL license GitHub version CRAN_Status_Badge <!-- badges: end -->

Streamflow Reconstruction Using Linear Dynamical System

A typical streamflow reconstruction model is linear: the relationship between streamflow y and the paleoclimate proxies u is modelled as

Linear models do not account for the catchment state and the catchment memory effect. To tackle this, we experiment with using the Linear Dynamical System (LDS) model. The relationship between streamflow and paleoclimate proxies is characterized as follows:

Observe that linear regression is a special case of LDS. The constant term \alpha of linear regression is replaced by a state-dependent term Cx_t, and the system state follows a state transition equation.

We described the method in full detail, together with a case study for the Ping River (Thailand), in Nguyen and Galelli (2018)---please cite this paper when you use the package. We also used the method to reconstruct streamflow for 48 stations in 16 countries in Asia (Nguyen et al, 2019).

For a tutorial on how to use the package, please see the package's vignette.

Installation

ldsr is now available on CRAN, so you can install with

install.packages('ldsr')

To install the development version, if you are using Windows, you will first need to install Rtools to compile the C++ code. For R 4.0.0. For older R.

Now to install the development version

install.packages('remotes') remotes::install_github('ntthung/ldsr')

References

Nguyen, H. T. T., & Galelli, S. (2018). A linear dynamical systems approach to streamflow reconstruction reveals history of regime shifts in northern Thailand. Water Resources Research, 54, 2057– 2077. https://doi.org/10.1002/2017WR022114

Nguyen, H. T. T., Turner, S. W., Buckley, B. M., & Galelli, S. (2019). Coherent streamflow variability in Monsoon Asia over the past eight centuries---links to oceanic drivers. https://doi.org/10.31223/osf.io/5tg68

Owner

  • Name: CRITICAL Infrastructure Systems Lab
  • Login: Critical-Infrastructure-Systems-Lab
  • Kind: organization
  • Email: stefano_galelli@sutd.edu.sg
  • Location: Singapore

Connecting climate | water | energy

GitHub Events

Total
Last Year

Committers

Last synced: about 2 years ago

All Time
  • Total Commits: 254
  • Total Committers: 1
  • Avg Commits per committer: 254.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
ntthung n****g@g****m 254

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 2
  • Total pull requests: 1
  • Average time to close issues: 8 months
  • Average time to close pull requests: N/A
  • Total issue authors: 1
  • Total pull request authors: 1
  • Average comments per issue: 2.0
  • Average comments per pull request: 1.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • ntthung (2)
Pull Request Authors
  • FabrizioSandri (1)
Top Labels
Issue Labels
enhancement (1)
Pull Request Labels

Dependencies

DESCRIPTION cran
  • R >= 3.5 depends
  • MASS * imports
  • Rcpp * imports
  • data.table * imports
  • dplR * imports
  • foreach * imports
  • stats * imports
  • GA * suggests
  • doFuture * suggests
  • future * suggests
  • ggplot2 * suggests
  • knitr * suggests
  • patchwork * suggests
  • rmarkdown * suggests
  • testthat * suggests