| Name | pywatershed JSON |
| Version |
1.0.0
JSON |
| download |
| home_page | |
| Summary | pywatershed is a Python package for hydrologic modeling |
| upload_time | 2023-12-18 23:04:22 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | <3.11,>=3.9 |
| license | CC0 |
| keywords |
hydrology
prms
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# pywatershed
[](https://github.com/ec-usgs/pywatershed/actions?query=workflow%3ACI)
[](https://codecov.io/gh/ec-usgs/pywatershed)
[](https://pywatershed.readthedocs.io/en/latest/?badge=latest)
[](https://github.com/ec-usgs/pywatershed)
[](https://github.com/python/black)
[](https://pypi.python.org/pypi/pywatershed)
[](https://pypi.python.org/pypi/pywatershed)
[](https://pypi.python.org/pypi/pywatershed)
[](https://anaconda.org/conda-forge/pywatershed)
[](https://anaconda.org/conda-forge/pywatershed)
[](https://dashboard.wholetale.org/run/64ae29e8a887f48b9f173678?tab=metadata)
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**Table of Contents**
- [About](#about)
- [Installation](#installation)
- [Getting started / Example notebooks](#getting-started--example-notebooks)
- [Community engagement](#community-engagement)
- [Disclaimer](#disclaimer)
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
## About
Welcome to the pywatershed repository!
Pywatershed is Python package for simulating hydrologic processes motivated by
the need to modernize important, legacy hydrologic models at the USGS,
particularly the
[Precipitation-Runoff Modeling System](https://www.usgs.gov/software/precipitation-runoff-modeling-system-prms)
(PRMS, Markstrom et al., 2015) and its role in
[GSFLOW](https://www.usgs.gov/software/gsflow-coupled-groundwater-and-surface-water-flow-model>)
(Markstrom et al., 2008).
The goal of modernization is to make these legacy models more flexible as process
representations, to support testing of alternative hydrologic process
conceptualizations, and to facilitate the incorporation of cutting edge
modeling techniques and data sources. Pywatershed is a place for experimentation
with software design, process representation, and data fusion in the context
of well-established hydrologic process modeling.
For more information on the goals and status of pywatershed, please see the [pywatershed docs](https://pywatershed.readthedocs.io/).
## Installation
`pywatershed` uses Python 3.9 or 3.10.
The `pywatershed` package is [available on
PyPI](https://pypi.org/project/pywatershed/) but installation of all
dependencies sets (lint, test, optional, doc, and all) may not be reliable on
all platforms.
The `pywatershed` package is [available on
conda-forge](https://anaconda.org/conda-forge/pywatershed). The installation
is the quickest way to get up and running by provides only the minimal set of
dependencies (not including Jupyter nor all packages needed for running the
example notebooks, also not suitable for development purposes).
We recommend the following installation procedures to get fully-functional
environments for running `pywatershed` and its example notebooks. We strongly
recommend using [Mamba](https://mamba.readthedocs.io/en/latest/)to first
instal dependencies from the `environment_y_jupyter.yml` file in the
repository before installing `pywatershed` itself. Mamba will be much faster
than Ananconda (but the conda command could also be used).
If you wish to use the stable release, you will use `main` in place of
`<branch>` in the following commands. If you want to follow development, you'll
use `develop` instead.
Without using `git` (directly), you may:
```
curl -L -O https://raw.githubusercontent.com/EC-USGS/pywatershed/<branch>/environment_w_jupyter.yml
mamba env create -f environment_w_jupyter.yml
conda activate pws
pip install git+https://github.com/EC-USGS/pywatershed.git@<branch>
```
Or to use `git` and to be able to develop:
```
git clone https://github.com/EC-USGS/pywatershed.git
cd pywatershed
mamba env create -f environment_w_jupyter.yml
activate pws
pip install -e .
```
(If you want to name the environment other than the default `pws`, use the
command
`mamba env update --name your_env_name --file environment_w_jupyter.yml --prune`
you will also need to activate this environment by name.)
We install the `environment_w_jupyter.yml` to provide all known dependencies
including those for running the example notebooks. (The `environment.yml`
does not contain Jupyter or JupyterLab because this interferes with installation
on WholeTale, see Getting Started section below.)
## Getting started / Example notebooks
Please note that you can browse the API reference, developer info, and index
in the [pywatershed docs]((https://pywatershed.readthedocs.io/)). But
*the best way to get started with pywatershed is to dive into the example
notebooks*.
For introductory example notebooks, look in the
[`examples/`](https://github.com/EC-USGS/pywatershed/tree/main/examples>)
directory in the repository. Numbered starting at 00, these are meant to be
completed in order. Numbered starting at 00, these are meant to be completed
in order. Notebook outputs are not saved in Github. But you can run these
notebooks locally or using WholeTale (an NSF funded project supporting logins
from many institutions, free but sign-up or log-in required)
where the pywatershed environment is all ready to go:
[](https://dashboard.wholetale.org)
* [Run latest release in WholeTale](https://dashboard.wholetale.org/run/64ae29e8a887f48b9f173678?tab=metadata)
* [Run the develop branch in WholeTale](https://dashboard.wholetale.org/run/64ae25c3a887f48b9f1735c8?tab=metadata)
WholeTale will give you a JupyterLab running in the root of this
repository. You can navigate to `examples/` and then open and run the notebooks
of your choice. The develop container may require the user to update the
repository (`git pull origin`) to stay current with development.
Non-numbered notebooks in `examples/` cover additional topics. These
notebooks are not yet covered by testing and you may encounter some
issues. In `examples/developer/` there are notebooks of interest to
developers who may want to learn about running the software tests.
## Community engagement
We value your feedback! Please use [discussions](https://github.com/EC-USGS/pywatershed/discussions)
or [issues](https://github.com/EC-USGS/pywatershed/issues) on Github.
For more in-depth contributions, please start by reading over
the pywatershed
[DEVELOPER.md](https://github.com/EC-USGS/pywatershed/blob/develop/DEVELOPER.md) and
[CONTRIBUTING.md](https://github.com/EC-USGS/pywatershed/blob/develop/CONTRIBUTING.md)
guidelines.
Thank you for your interest.
## Disclaimer
This information is preliminary or provisional and is subject to revision. It is
being provided to meet the need for timely best science. The information has not
received final approval by the U.S. Geological Survey (USGS) and is provided on
the condition that neither the USGS nor the U.S. Government shall be held liable
for any damages resulting from the authorized or unauthorized use of the
information.
From: https://www2.usgs.gov/fsp/fsp_disclaimers.asp#5
This software is in the public domain because it contains materials that
originally came from the U.S. Geological Survey, an agency of the United States
Department of Interior. For more information, see the [official USGS copyright
policy](https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits
"official USGS copyright policy")
Although this software program has been used by the USGS, no warranty, expressed
or implied, is made by the USGS or the U.S. Government as to the accuracy and
functioning of the program and related program material nor shall the fact of
distribution constitute any such warranty, and no responsibility is assumed by
the USGS in connection therewith. This software is provided "AS IS."
Raw data
{
"_id": null,
"home_page": "",
"name": "pywatershed",
"maintainer": "",
"docs_url": null,
"requires_python": "<3.11,>=3.9",
"maintainer_email": "\"James L. McCreight\" <jmccreight@usgs.gov>, \"Joseph D. Hughes\" <jdhughes@usgs.gov>",
"keywords": "hydrology,PRMS",
"author": "",
"author_email": "USGS Enterprise Capacity Team <modflow@usgs.gov>",
"download_url": "https://files.pythonhosted.org/packages/2a/ca/80923a4c4e3ddb556575cfcb44b5119b7f714e13f08c3f692fbf6295499f/pywatershed-1.0.0.tar.gz",
"platform": null,
"description": "# pywatershed\n\n[](https://github.com/ec-usgs/pywatershed/actions?query=workflow%3ACI)\n[](https://codecov.io/gh/ec-usgs/pywatershed)\n[](https://pywatershed.readthedocs.io/en/latest/?badge=latest)\n[](https://github.com/ec-usgs/pywatershed)\n[](https://github.com/python/black)\n\n[](https://pypi.python.org/pypi/pywatershed)\n[](https://pypi.python.org/pypi/pywatershed)\n[](https://pypi.python.org/pypi/pywatershed)\n\n[](https://anaconda.org/conda-forge/pywatershed)\n[](https://anaconda.org/conda-forge/pywatershed)\n\n[](https://dashboard.wholetale.org/run/64ae29e8a887f48b9f173678?tab=metadata)\n\n\n<!-- START doctoc generated TOC please keep comment here to allow auto update -->\n<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->\n**Table of Contents**\n\n- [About](#about)\n- [Installation](#installation)\n- [Getting started / Example notebooks](#getting-started--example-notebooks)\n- [Community engagement](#community-engagement)\n- [Disclaimer](#disclaimer)\n\n<!-- END doctoc generated TOC please keep comment here to allow auto update -->\n\n## About\n\nWelcome to the pywatershed repository!\n\nPywatershed is Python package for simulating hydrologic processes motivated by\nthe need to modernize important, legacy hydrologic models at the USGS,\nparticularly the\n[Precipitation-Runoff Modeling System](https://www.usgs.gov/software/precipitation-runoff-modeling-system-prms)\n(PRMS, Markstrom et al., 2015) and its role in\n[GSFLOW](https://www.usgs.gov/software/gsflow-coupled-groundwater-and-surface-water-flow-model>)\n(Markstrom et al., 2008).\nThe goal of modernization is to make these legacy models more flexible as process\nrepresentations, to support testing of alternative hydrologic process\nconceptualizations, and to facilitate the incorporation of cutting edge\nmodeling techniques and data sources. Pywatershed is a place for experimentation\nwith software design, process representation, and data fusion in the context\nof well-established hydrologic process modeling.\n\nFor more information on the goals and status of pywatershed, please see the [pywatershed docs](https://pywatershed.readthedocs.io/).\n\n\n## Installation\n\n`pywatershed` uses Python 3.9 or 3.10.\n\nThe `pywatershed` package is [available on\nPyPI](https://pypi.org/project/pywatershed/) but installation of all\ndependencies sets (lint, test, optional, doc, and all) may not be reliable on\nall platforms. \n\nThe `pywatershed` package is [available on\nconda-forge](https://anaconda.org/conda-forge/pywatershed). The installation\nis the quickest way to get up and running by provides only the minimal set of\ndependencies (not including Jupyter nor all packages needed for running the\nexample notebooks, also not suitable for development purposes). \n\nWe recommend the following installation procedures to get fully-functional\nenvironments for running `pywatershed` and its example notebooks. We strongly\nrecommend using [Mamba](https://mamba.readthedocs.io/en/latest/)to first\ninstal dependencies from the `environment_y_jupyter.yml` file in the\nrepository before installing `pywatershed` itself. Mamba will be much faster\nthan Ananconda (but the conda command could also be used). \n\nIf you wish to use the stable release, you will use `main` in place of \n`<branch>` in the following commands. If you want to follow development, you'll\nuse `develop` instead.\n\nWithout using `git` (directly), you may:\n```\ncurl -L -O https://raw.githubusercontent.com/EC-USGS/pywatershed/<branch>/environment_w_jupyter.yml\nmamba env create -f environment_w_jupyter.yml\nconda activate pws\npip install git+https://github.com/EC-USGS/pywatershed.git@<branch>\n```\n\nOr to use `git` and to be able to develop:\n\n```\ngit clone https://github.com/EC-USGS/pywatershed.git\ncd pywatershed\nmamba env create -f environment_w_jupyter.yml\nactivate pws\npip install -e .\n```\n\n(If you want to name the environment other than the default `pws`, use the\ncommand \n`mamba env update --name your_env_name --file environment_w_jupyter.yml --prune`\nyou will also need to activate this environment by name.)\n\n\nWe install the `environment_w_jupyter.yml` to provide all known dependencies \nincluding those for running the example notebooks. (The `environment.yml` \ndoes not contain Jupyter or JupyterLab because this interferes with installation\non WholeTale, see Getting Started section below.)\n\n\n## Getting started / Example notebooks\n\nPlease note that you can browse the API reference, developer info, and index\nin the [pywatershed docs]((https://pywatershed.readthedocs.io/)). But\n*the best way to get started with pywatershed is to dive into the example\nnotebooks*.\n\nFor introductory example notebooks, look in the\n[`examples/`](https://github.com/EC-USGS/pywatershed/tree/main/examples>)\ndirectory in the repository. Numbered starting at 00, these are meant to be\ncompleted in order. Numbered starting at 00, these are meant to be completed\nin order. Notebook outputs are not saved in Github. But you can run these\nnotebooks locally or using WholeTale (an NSF funded project supporting logins\nfrom many institutions, free but sign-up or log-in required)\nwhere the pywatershed environment is all ready to go:\n\n[](https://dashboard.wholetale.org)\n\n * [Run latest release in WholeTale](https://dashboard.wholetale.org/run/64ae29e8a887f48b9f173678?tab=metadata)\n * [Run the develop branch in WholeTale](https://dashboard.wholetale.org/run/64ae25c3a887f48b9f1735c8?tab=metadata)\n\nWholeTale will give you a JupyterLab running in the root of this\nrepository. You can navigate to `examples/` and then open and run the notebooks\nof your choice. The develop container may require the user to update the\nrepository (`git pull origin`) to stay current with development.\n\nNon-numbered notebooks in `examples/` cover additional topics. These\nnotebooks are not yet covered by testing and you may encounter some\nissues. In `examples/developer/` there are notebooks of interest to\ndevelopers who may want to learn about running the software tests.\n\n\n## Community engagement\n\nWe value your feedback! Please use [discussions](https://github.com/EC-USGS/pywatershed/discussions)\nor [issues](https://github.com/EC-USGS/pywatershed/issues) on Github. \nFor more in-depth contributions, please start by reading over\nthe pywatershed\n[DEVELOPER.md](https://github.com/EC-USGS/pywatershed/blob/develop/DEVELOPER.md) and\n[CONTRIBUTING.md](https://github.com/EC-USGS/pywatershed/blob/develop/CONTRIBUTING.md)\nguidelines.\n\nThank you for your interest.\n\n\n## Disclaimer\n\nThis information is preliminary or provisional and is subject to revision. It is\nbeing provided to meet the need for timely best science. The information has not\nreceived final approval by the U.S. Geological Survey (USGS) and is provided on\nthe condition that neither the USGS nor the U.S. Government shall be held liable\nfor any damages resulting from the authorized or unauthorized use of the\ninformation.\n\nFrom: https://www2.usgs.gov/fsp/fsp_disclaimers.asp#5\n\nThis software is in the public domain because it contains materials that\noriginally came from the U.S. Geological Survey, an agency of the United States\nDepartment of Interior. For more information, see the [official USGS copyright\npolicy](https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits\n\"official USGS copyright policy\")\n\nAlthough this software program has been used by the USGS, no warranty, expressed\nor implied, is made by the USGS or the U.S. Government as to the accuracy and\nfunctioning of the program and related program material nor shall the fact of\ndistribution constitute any such warranty, and no responsibility is assumed by\nthe USGS in connection therewith. This software is provided \"AS IS.\"\n",
"bugtrack_url": null,
"license": "CC0",
"summary": "pywatershed is a Python package for hydrologic modeling",
"version": "1.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/EC-USGS/pywatershed/issues",
"Documentation": "https://pywatershed.readthedocs.io",
"Source Code": "https://github.com/EC-USGS/pywatershed"
},
"split_keywords": [
"hydrology",
"prms"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "552f2746a2b48a0684e9ca41da5f306a0ef48ceb7fbcdaf5dc22bb5ebc2ee0bb",
"md5": "ba3e0fcef733db253947f1c88ce2ec74",
"sha256": "c4f206a720c3f39f60fb45553c57a6fb56955c0524e9e705efef87e09f90e032"
},
"downloads": -1,
"filename": "pywatershed-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ba3e0fcef733db253947f1c88ce2ec74",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.11,>=3.9",
"size": 14125981,
"upload_time": "2023-12-18T23:04:19",
"upload_time_iso_8601": "2023-12-18T23:04:19.005980Z",
"url": "https://files.pythonhosted.org/packages/55/2f/2746a2b48a0684e9ca41da5f306a0ef48ceb7fbcdaf5dc22bb5ebc2ee0bb/pywatershed-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2aca80923a4c4e3ddb556575cfcb44b5119b7f714e13f08c3f692fbf6295499f",
"md5": "403099f2b78d3d1f1d72161026ef056b",
"sha256": "65c9bab1a715366895251850c25789562bb11f4d044006b00e53d4f667b8f9fe"
},
"downloads": -1,
"filename": "pywatershed-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "403099f2b78d3d1f1d72161026ef056b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.11,>=3.9",
"size": 14084387,
"upload_time": "2023-12-18T23:04:22",
"upload_time_iso_8601": "2023-12-18T23:04:22.127220Z",
"url": "https://files.pythonhosted.org/packages/2a/ca/80923a4c4e3ddb556575cfcb44b5119b7f714e13f08c3f692fbf6295499f/pywatershed-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-18 23:04:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "EC-USGS",
"github_project": "pywatershed",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pywatershed"
}
