| Name | hyswap JSON |
| Version |
0.1.1
JSON |
| download |
| home_page | |
| Summary | Analysis of surface water data. |
| upload_time | 2024-02-05 18:30:13 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.8 |
| 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)](https://creativecommons.org/publicdomain/zero/1.0/legalcode). ### 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. |
| keywords |
usgs
water data
analysis
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# hyswap - HYdrologic Surface Water Analysis Package
[](https://owi.usgs.gov/R/packages.html#core)
[](https://code.usgs.gov/water/computational-tools/surface-water-work/hyswap/-/commits/main)
[](https://code.usgs.gov/water/computational-tools/surface-water-work/hyswap/-/commits/main)
[](https://badge.fury.io/py/hyswap)
[](https://img.shields.io/pypi/pyversions/hyswap)
## Overview
`hyswap` (HYdrologic Surface Water Analysis Package), is a Python package which provides a set of functions for manipulating and visualizing USGS water data.
Specifically, a number of functions for calculating statistics (e.g., exceedance probabilities, daily historic percentiles) and generating related plots (e.g., flow duration curves, streamflow duration hydrographs) are available.
These methods are provided in a modular fashion as individual functions, and are designed to give the user flexibility in implementation.
### Project Documentation
For more information, visit the `hyswap` [documentation](https://doi-usgs.github.io/hyswap/).
## Installation
### User Installation via `pip`
One-liner to install `hyswap` via `pip`:
```bash
pip install hyswap
```
*Note:* `hyswap` has 4 dependencies right now, `numpy`, `pandas`, `scipy`, and `matplotlib`, these will be installed automatically when installing the package via `pip`.
### User Installation From Source
To install `hyswap` from source, first you will need to clone the repository.
Next, from the root of the repository, run the following commands:
```bash
pip install -r requirements.txt
pip install .
```
### Developer Installation
Developer installation should be performed from source.
First you will need to clone the repository.
Next, from the root of the repository, run the following commands:
```bash
pip install -r requirements.txt
pip install -r requirements-dev.txt
pip install -e .
```
### Testing and Building Documentation Locally
To test the code and building and test the documentation locally, you must have cloned the source repository, follow the instructions above for a "developer installation" first.
To test the package locally, run the following command from the root of the repository:
```bash
pytest
```
To build the documentation locally, run the following commands from the root of the repository:
```bash
cd docs
make docs
```
### Running the Linting and Formatting Checks Locally
To run the linting and formatting checks locally, run the following commands from the root of the repository:
```bash
flake8 .
pydocstringformatter .
```
## Contributing
See the [contributing guidelines](CONTRIBUTING.md) for more information.
## License
See the [license](LICENSE.md) for more information.
## Disclaimer
See the [disclaimer](DISCLAIMER.md) for more information.
Raw data
{
"_id": null,
"home_page": "",
"name": "hyswap",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "USGS,water data,analysis",
"author": "",
"author_email": "USGS <comptools@usgs.gov>",
"download_url": "https://files.pythonhosted.org/packages/ef/92/a15c3096102149ad7d6358203f3fb96b7c43efbaab776d0983150845053b/hyswap-0.1.1.tar.gz",
"platform": null,
"description": "# hyswap - HYdrologic Surface Water Analysis Package\n\n[](https://owi.usgs.gov/R/packages.html#core)\n[](https://code.usgs.gov/water/computational-tools/surface-water-work/hyswap/-/commits/main)\n[](https://code.usgs.gov/water/computational-tools/surface-water-work/hyswap/-/commits/main)\n[](https://badge.fury.io/py/hyswap)\n[](https://img.shields.io/pypi/pyversions/hyswap)\n\n## Overview\n\n`hyswap` (HYdrologic Surface Water Analysis Package), is a Python package which provides a set of functions for manipulating and visualizing USGS water data.\nSpecifically, a number of functions for calculating statistics (e.g., exceedance probabilities, daily historic percentiles) and generating related plots (e.g., flow duration curves, streamflow duration hydrographs) are available.\nThese methods are provided in a modular fashion as individual functions, and are designed to give the user flexibility in implementation.\n\n### Project Documentation\n\nFor more information, visit the `hyswap` [documentation](https://doi-usgs.github.io/hyswap/).\n\n## Installation\n\n### User Installation via `pip`\n\nOne-liner to install `hyswap` via `pip`:\n\n```bash\npip install hyswap\n```\n\n*Note:* `hyswap` has 4 dependencies right now, `numpy`, `pandas`, `scipy`, and `matplotlib`, these will be installed automatically when installing the package via `pip`.\n\n### User Installation From Source\n\nTo install `hyswap` from source, first you will need to clone the repository.\nNext, from the root of the repository, run the following commands:\n\n```bash\npip install -r requirements.txt\npip install .\n```\n\n### Developer Installation\n\nDeveloper installation should be performed from source.\nFirst you will need to clone the repository.\nNext, from the root of the repository, run the following commands:\n\n```bash\npip install -r requirements.txt\npip install -r requirements-dev.txt\npip install -e .\n```\n\n### Testing and Building Documentation Locally\n\nTo test the code and building and test the documentation locally, you must have cloned the source repository, follow the instructions above for a \"developer installation\" first.\n\nTo test the package locally, run the following command from the root of the repository:\n\n```bash\npytest\n```\n\nTo build the documentation locally, run the following commands from the root of the repository:\n\n```bash\ncd docs\nmake docs\n```\n\n### Running the Linting and Formatting Checks Locally\n\nTo run the linting and formatting checks locally, run the following commands from the root of the repository:\n\n```bash\nflake8 .\npydocstringformatter .\n```\n\n## Contributing\n\nSee the [contributing guidelines](CONTRIBUTING.md) for more information.\n\n## License\n\nSee the [license](LICENSE.md) for more information.\n\n## Disclaimer\n\nSee the [disclaimer](DISCLAIMER.md) for more information.\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)](https://creativecommons.org/publicdomain/zero/1.0/legalcode). ### 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. ",
"summary": "Analysis of surface water data.",
"version": "0.1.1",
"project_urls": {
"homepage": "https://code.usgs.gov/water/computational-tools/surface-water-work/hyswap",
"repository": "https://code.usgs.gov/water/computational-tools/surface-water-work/hyswap.git"
},
"split_keywords": [
"usgs",
"water data",
"analysis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "67dc70f8f804ba55294d34e3716925de8c6e45553b73c1bf5ddce85ae395571b",
"md5": "c1111a3cd7c663418f97d645246bbf65",
"sha256": "0c8a830761d4ad1d1c2191442714d3386f73985e347d1e1a068ea1c5ed6c2938"
},
"downloads": -1,
"filename": "hyswap-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c1111a3cd7c663418f97d645246bbf65",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 42112,
"upload_time": "2024-02-05T18:30:11",
"upload_time_iso_8601": "2024-02-05T18:30:11.444689Z",
"url": "https://files.pythonhosted.org/packages/67/dc/70f8f804ba55294d34e3716925de8c6e45553b73c1bf5ddce85ae395571b/hyswap-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ef92a15c3096102149ad7d6358203f3fb96b7c43efbaab776d0983150845053b",
"md5": "2536df6f60ce203937124ed7a738bb47",
"sha256": "cde5034618bc2db64f43b85e7ec034075c2169ef94eab47cefc46068020f709c"
},
"downloads": -1,
"filename": "hyswap-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "2536df6f60ce203937124ed7a738bb47",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 282565,
"upload_time": "2024-02-05T18:30:13",
"upload_time_iso_8601": "2024-02-05T18:30:13.503700Z",
"url": "https://files.pythonhosted.org/packages/ef/92/a15c3096102149ad7d6358203f3fb96b7c43efbaab776d0983150845053b/hyswap-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-05 18:30:13",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "hyswap"
}
