discontinuum


Namediscontinuum JSON
Version 0.2 PyPI version JSON
download
home_pageNone
SummaryEstimate discontinuous timeseries from continuous covariates.
upload_time2024-05-24 15:31:30
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseLicense ======= Unless otherwise noted, this project is in the public domain in the United States because it contains materials that originally came from the United States Geological Survey, an agency of the United States Department of Interior. For more information, see the official USGS copyright policy at https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits Additionally, we waive copyright and related rights in the work worldwide through the CC0 1.0 Universal public domain dedication. CC0 1.0 Universal Summary ------------------------- This is a human-readable summary of the [Legal Code (read the full text)][1]. ### No Copyright The person who associated a work with this deed has dedicated the work to the public domain by waiving all of his or her rights to the work worldwide under copyright law, including all related and neighboring rights, to the extent allowed by law. You can copy, modify, distribute and perform the work, even for commercial purposes, all without asking permission. ### Other Information In no way are the patent or trademark rights of any person affected by CC0, nor are the rights that other persons may have in the work or in how the work is used, such as publicity or privacy rights. Unless expressly stated otherwise, the person who associated a work with this deed makes no warranties about the work, and disclaims liability for all uses of the work, to the fullest extent permitted by applicable law. When using or citing the work, you should not imply endorsement by the author or the affirmer. [1]: https://creativecommons.org/publicdomain/zero/1.0/legalcode
keywords timeseries gaussian processes discontinuous
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # discontinuum
> [!WARNING]  
> Experimental.

## Overview
`discontinuum` is a middleware for developing Gaussian process (GP) timeseries models.
Why might we want a middleware? 
GP's are an elegant way to model timeseries with uncertainty.
In many cases, we can represent a complex timeseries as a GP with only a few lines of math.
However, fitting GP's is numerically intense, $\mathcal{O}(n^3)$ complexity.
There are several optimizations that take advantage of simplifying assumptions, different algorithms, or GPUs,
but each has different tradeoffs.
Ideally, we could write the mathematical model once, then run it on whichever "engine" is best suited for a particular problem.
With every model comes a lot of standard utility functions,
and the goal of `discontinuum` is to package these different model applications, engines, and utilities into a single ecosystem.

## Installation
```
pip install discontinuum
```

## Models
Only one for now.

### loadset-gp
LOAD ESTimator (LOADEST) is a software program for estimating river constituent timeseries using surrogate variables (covariates).
For example, estimating nitrate concentration based on date and streamflow.
However, LOADEST has several serious limitations---it's essentially a linear regression---
and it has been all but replaced by the more flexible Weighted Regression on Time Discharge and Season (WRTDS),
which allows the relation between target and covariate to vary through time.
`loadest-gp` takes the WRTDS idea and reimplements it as a GP.

```python
from loadest_gp import LoadestGP()

model = LoadestGP()
model.fit(target, covariates)
model.plot(covariates)
```
![example plot](https://github.com/thodson-usgs/discontinuum/blob/main/docs/assets/illinois-river-nitrate.png?raw=true)

## Engines
Currently, the only engine is `pymc`'s marginal likelihood implementation.

## Roadmap
```mermaid
mindmap
  root((discontinuum))
    data providers
      USGS
      EPA
      etc
    engines
      PyMC
      Tensorflow
      PyTorch
    utilities
      pre-processing
      post-processing
      plotting
    models
      loadest-gp
      your own
      
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "discontinuum",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": "Timothy Hodson <thodson@usgs.gov>",
    "keywords": "timeseries, Gaussian processes, discontinuous",
    "author": null,
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/25/92/5cd98dcecc6104daedefe1a92d670c98922df10a00299352b07a5ebb1adb/discontinuum-0.2.tar.gz",
    "platform": null,
    "description": "# discontinuum\n> [!WARNING]  \n> Experimental.\n\n## Overview\n`discontinuum` is a middleware for developing Gaussian process (GP) timeseries models.\nWhy might we want a middleware? \nGP's are an elegant way to model timeseries with uncertainty.\nIn many cases, we can represent a complex timeseries as a GP with only a few lines of math.\nHowever, fitting GP's is numerically intense, $\\mathcal{O}(n^3)$ complexity.\nThere are several optimizations that take advantage of simplifying assumptions, different algorithms, or GPUs,\nbut each has different tradeoffs.\nIdeally, we could write the mathematical model once, then run it on whichever \"engine\" is best suited for a particular problem.\nWith every model comes a lot of standard utility functions,\nand the goal of `discontinuum` is to package these different model applications, engines, and utilities into a single ecosystem.\n\n## Installation\n```\npip install discontinuum\n```\n\n## Models\nOnly one for now.\n\n### loadset-gp\nLOAD ESTimator (LOADEST) is a software program for estimating river constituent timeseries using surrogate variables (covariates).\nFor example, estimating nitrate concentration based on date and streamflow.\nHowever, LOADEST has several serious limitations---it's essentially a linear regression---\nand it has been all but replaced by the more flexible Weighted Regression on Time Discharge and Season (WRTDS),\nwhich allows the relation between target and covariate to vary through time.\n`loadest-gp` takes the WRTDS idea and reimplements it as a GP.\n\n```python\nfrom loadest_gp import LoadestGP()\n\nmodel = LoadestGP()\nmodel.fit(target, covariates)\nmodel.plot(covariates)\n```\n![example plot](https://github.com/thodson-usgs/discontinuum/blob/main/docs/assets/illinois-river-nitrate.png?raw=true)\n\n## Engines\nCurrently, the only engine is `pymc`'s marginal likelihood implementation.\n\n## Roadmap\n```mermaid\nmindmap\n  root((discontinuum))\n    data providers\n      USGS\n      EPA\n      etc\n    engines\n      PyMC\n      Tensorflow\n      PyTorch\n    utilities\n      pre-processing\n      post-processing\n      plotting\n    models\n      loadest-gp\n      your own\n      \n```\n",
    "bugtrack_url": null,
    "license": "License =======  Unless otherwise noted, this project is in the public domain in the United States because it contains materials that originally came from the United States Geological Survey, an agency of the United States Department of Interior. For more information, see the official USGS copyright policy at https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits  Additionally, we waive copyright and related rights in the work worldwide through the CC0 1.0 Universal public domain dedication.   CC0 1.0 Universal Summary -------------------------  This is a human-readable summary of the [Legal Code (read the full text)][1].   ### No Copyright  The person who associated a work with this deed has dedicated the work to the public domain by waiving all of his or her rights to the work worldwide under copyright law, including all related and neighboring rights, to the extent allowed by law.  You can copy, modify, distribute and perform the work, even for commercial purposes, all without asking permission.   ### Other Information  In no way are the patent or trademark rights of any person affected by CC0, nor are the rights that other persons may have in the work or in how the work is used, such as publicity or privacy rights.  Unless expressly stated otherwise, the person who associated a work with this deed makes no warranties about the work, and disclaims liability for all uses of the work, to the fullest extent permitted by applicable law. When using or citing the work, you should not imply endorsement by the author or the affirmer.    [1]: https://creativecommons.org/publicdomain/zero/1.0/legalcode ",
    "summary": "Estimate discontinuous timeseries from continuous covariates.",
    "version": "0.2",
    "project_urls": {
        "homepage": "https://github.com/thodson-usgs/discontinuum",
        "repository": "https://github.com/thodson-usgs/discontinuum.git"
    },
    "split_keywords": [
        "timeseries",
        " gaussian processes",
        " discontinuous"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c5fe0c2ce6cd13d7068a0c3060946cfcb95673412e67e1feab61ad06346f9b4f",
                "md5": "e9a27456bb56089893986b4ff3224796",
                "sha256": "6d8bf101378d55b0e348b88826b74ce6d7944610db008bf63fc652517f562850"
            },
            "downloads": -1,
            "filename": "discontinuum-0.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "e9a27456bb56089893986b4ff3224796",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 22577,
            "upload_time": "2024-05-24T15:31:29",
            "upload_time_iso_8601": "2024-05-24T15:31:29.100626Z",
            "url": "https://files.pythonhosted.org/packages/c5/fe/0c2ce6cd13d7068a0c3060946cfcb95673412e67e1feab61ad06346f9b4f/discontinuum-0.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "25925cd98dcecc6104daedefe1a92d670c98922df10a00299352b07a5ebb1adb",
                "md5": "d408b139536f7ea60d0ae4a42949bf7e",
                "sha256": "12ccb79564ca1adba04de777e39ff9e4d69c66269bbc9e96bc195f0acd7eb70b"
            },
            "downloads": -1,
            "filename": "discontinuum-0.2.tar.gz",
            "has_sig": false,
            "md5_digest": "d408b139536f7ea60d0ae4a42949bf7e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 464308,
            "upload_time": "2024-05-24T15:31:30",
            "upload_time_iso_8601": "2024-05-24T15:31:30.699989Z",
            "url": "https://files.pythonhosted.org/packages/25/92/5cd98dcecc6104daedefe1a92d670c98922df10a00299352b07a5ebb1adb/discontinuum-0.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-24 15:31:30",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "thodson-usgs",
    "github_project": "discontinuum",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "discontinuum"
}
        
Elapsed time: 0.25648s