{ "info": { "author": "Brendan C. Ward", "author_email": "", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3.6" ], "description": "# U.S. National Hydrography Dataset Network & Barrier Analysis Tools\n\n[![Build Status](https://travis-ci.org/brendan-ward/nhdnet.svg?branch=master)](https://travis-ci.org/brendan-ward/nhdnet)\n[![Coverage Status](https://coveralls.io/repos/github/brendan-ward/nhdnet/badge.svg?branch=master)](https://coveralls.io/github/brendan-ward/nhdnet?branch=master)\n\nThis library was used to help perform network connectivity analysis for the [Southeast Aquatic Barrier Prioritization Tool](https://connectivity.sarpdata.com). See [https://github.com/astutespruce/sarp-connectivity](https://github.com/astutespruce/sarp-connectivity) for more information about specific processing for that project.\n\nThis library is intended to provide more general processing utilities to assist with analyzing connectivity using the National Hydrography Dataset (NHD) - High Resolution Plus version.\n\nWe do not currently intend to add support for the NHD - Medium Resolution dataset. Pull requests are welcome to add this functionality.\n\nDue to the large size of NHD data, it may be possible to only process a single region at a time, or a group of regions. The key limits are based on the amount of available memory (RAM) and the file sizes of the outputs (shapefiles are limited to 2 GB in size).\n\nKey features:\n\n- preprocessing utilities to prepare NHD data for analysis within this library\n- merging of NHD flowlines between adjacent basins or regions\n- automatic snapping barriers to nearest flowlines, including heuristics to aid with manual QA/QC\n- cutting of NHD flowlines at barriers\n- construction of functional upstream networks from a barrier to the next upstream barriers or origins of a stream network\n- network statistics\n- optimized data I/O using the `feather` file format for intermediate data products and customized serialization / deserialization of spatial data\n\nNotes:\n\n- reading / writing shapefiles using Geopandas can be very slow. We preferred to use the `feather` format for intermediate files (`geofeather` provides spatial compatibility).\n- data from NHD are downloaded as ArcGIS File Geodatabases. While these formats can be read (usually) using Geopandas, it is not possible to write this format, so shapefile outputs are generally the only option for use in GIS.\n\n## Installation\n\n`pip install nhdnet`\n\nThis project uses [`GeoPandas`](http://geopandas.org/), [`Pandas`](https://pandas.pydata.org/), [`rtree`](http://toblerity.org/rtree/), and [`shapely`](https://shapely.readthedocs.io/en/stable/) in Python 3.6+.\n\nWe do not intend to support Python < 3.6.\n\nDue to the complexity of these libraries, installation instructions for your platform may vary from the following.\n\n`rtree` first requires the separate installation of [`libspatialindex`](http://libspatialindex.github.io/).\nOn MacOS:\n\n```\nbrew install spatialindex\n```\n\nPython dependencies and virtual environment are managed using [`pipenv`](https://pipenv.readthedocs.io/en/latest/).\n\n```\npipenv install\n```\n\nIf you do not wish to use `pipenv`, see the `Pipfile` for the list of dependencies.\n\n## Source Data\n\nNHD High Resolution data are downloaded by HUC4 from [NHD Data Distribution Site](https://prd-tnm.s3.amazonaws.com/index.html?prefix=StagedProducts/Hydrography/NHDPlus/HU4/HighResolution/GDB/).\n\n## Development\n\nThis project uses `black` for autoformatting and `pylint` for linting.\n\n## Notes\n\nKnown issues:\n\n- flowlines that cross HUC4 or region boundaries need to be specifically handled as part of network analyses. See [https://github.com/astutespruce/sarp-connectivity/tree/master/analysis/network](https://github.com/astutespruce/sarp-connectivity/tree/master/analysis/network) for more information about network analysis based on this library.\n\n## Credits\n\nThis project was made possible in partnership with the [Southeast Aquatic Resources Partnership](https://southeastaquatics.net) as part of a larger project to develop a comprehensive inventory of aquatic barriers in the Southeastern US and assess impacts of these barriers on aquatic systems.\n\nThe results of this project are available in the [Southeast Aquatic Barrier Prioritization Tool](https://connectivity.sarpdata.com).\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/brendan-ward/nhdnet", "keywords": "nhd hydrography", "license": "", "maintainer": "", "maintainer_email": "", "name": "nhdnet", "package_url": "https://pypi.org/project/nhdnet/", "platform": "", "project_url": "https://pypi.org/project/nhdnet/", "project_urls": { "Homepage": "https://github.com/brendan-ward/nhdnet" }, "release_url": "https://pypi.org/project/nhdnet/0.2.0/", "requires_dist": [ "pandas", "geopandas", "rtree", "geofeather", "requests", "black ; extra == 'dev'", "pylint ; extra == 'dev'", "pytest ; extra == 'test'", "pytest-cov ; extra == 'test'" ], "requires_python": "", "summary": "US National Hydrography Dataset Network and Barrier Analysis Tools", "version": "0.2.0" }, "last_serial": 5980862, "releases": { "0.2.0": [ { "comment_text": "", "digests": { "md5": "f26e68ff387c52dc95d21fbe490dff68", "sha256": "6144496c1534247b088a8eca7a6a5a4cb8920b6c332529de59bce89faf04f9f9" }, "downloads": -1, "filename": "nhdnet-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "f26e68ff387c52dc95d21fbe490dff68", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 20851, "upload_time": "2019-10-16T02:28:10", "url": "https://files.pythonhosted.org/packages/4a/8b/fbaa4523c92de17d323630c58850bd58f858076db7ef2acd1f60ef321336/nhdnet-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1c4c0098626e153a607931bb0ba9807a", "sha256": "c9e845c4533bb4919c4191c4aed899fbf22b2492630a2514dbba31fece3e25fb" }, "downloads": -1, "filename": "nhdnet-0.2.0.tar.gz", "has_sig": false, "md5_digest": "1c4c0098626e153a607931bb0ba9807a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16561, "upload_time": "2019-10-16T02:28:13", "url": "https://files.pythonhosted.org/packages/78/34/fa81ee808b5b96ddfba34e780bcebff84c2664923f1e4a2ff01091d66f2c/nhdnet-0.2.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "f26e68ff387c52dc95d21fbe490dff68", "sha256": "6144496c1534247b088a8eca7a6a5a4cb8920b6c332529de59bce89faf04f9f9" }, "downloads": -1, "filename": "nhdnet-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "f26e68ff387c52dc95d21fbe490dff68", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 20851, "upload_time": "2019-10-16T02:28:10", "url": "https://files.pythonhosted.org/packages/4a/8b/fbaa4523c92de17d323630c58850bd58f858076db7ef2acd1f60ef321336/nhdnet-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1c4c0098626e153a607931bb0ba9807a", "sha256": "c9e845c4533bb4919c4191c4aed899fbf22b2492630a2514dbba31fece3e25fb" }, "downloads": -1, "filename": "nhdnet-0.2.0.tar.gz", "has_sig": false, "md5_digest": "1c4c0098626e153a607931bb0ba9807a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16561, "upload_time": "2019-10-16T02:28:13", "url": "https://files.pythonhosted.org/packages/78/34/fa81ee808b5b96ddfba34e780bcebff84c2664923f1e4a2ff01091d66f2c/nhdnet-0.2.0.tar.gz" } ] }