basin3d 0.4.0__tar.gz

basin3d-0.4.0/LICENSE

@@ -0,0 +1,43 @@
+Broker for Assimilation, Synthesis and Integration of eNvironmental Diverse, Distributed Datasets (BASIN-3D) Copyright (c) 2019, The
+Regents of the University of California, through Lawrence Berkeley National
+Laboratory (subject to receipt of any required approvals from the U.S.
+Dept. of Energy).  All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+(1) Redistributions of source code must retain the above copyright notice,
+this list of conditions and the following disclaimer.
+
+(2) Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+(3) Neither the name of the University of California, Lawrence Berkeley
+National Laboratory, U.S. Dept. of Energy nor the names of its contributors
+may be used to endorse or promote products derived from this software
+without specific prior written permission.
+
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+You are under no obligation whatsoever to provide any bug fixes, patches,
+or upgrades to the features, functionality or performance of the source
+code ("Enhancements") to anyone; however, if you choose to make your
+Enhancements available either publicly, or directly to Lawrence Berkeley
+National Laboratory, without imposing a separate written license agreement
+for such Enhancements, then you hereby grant the following license: a
+non-exclusive, royalty-free perpetual license to install, use, modify,
+prepare derivative works, incorporate into other computer software,
+distribute, and sublicense such enhancements or derivative works thereof,
+in binary and source code form.

basin3d-0.4.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include LICENSE
+include README.md
+include basin3d/core/logging.yaml
+include basin3d/data/basin3d_variables_hydrology.csv
+include basin3d/plugins/usgs_mapping.csv
+prune tests

basin3d-0.4.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.1
+Name: basin3d
+Version: 0.4.0
+Summary: BASIN-3D Core Framework
+Author-email: Valerie C Hendrix <vchendrix@lbl.gov>, Danielle Svehla Christianson <dschristianson@lbl.gov>, Charuleka Varadharajan <cvaradharajan@lbl.gov>, Catherine Wong <catwong@lbl.gov>
+Maintainer-email: Valerie C Hendrix <vchendrix@lbl.gov>, Danielle Svehla Christianson <dschristianson@lbl.gov>
+License: Broker for Assimilation, Synthesis and Integration of eNvironmental Diverse, Distributed Datasets (BASIN-3D) Copyright (c) 2019, The
+        Regents of the University of California, through Lawrence Berkeley National
+        Laboratory (subject to receipt of any required approvals from the U.S.
+        Dept. of Energy).  All rights reserved.
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        (1) Redistributions of source code must retain the above copyright notice,
+        this list of conditions and the following disclaimer.
+        
+        (2) Redistributions in binary form must reproduce the above copyright
+        notice, this list of conditions and the following disclaimer in the
+        documentation and/or other materials provided with the distribution.
+        
+        (3) Neither the name of the University of California, Lawrence Berkeley
+        National Laboratory, U.S. Dept. of Energy nor the names of its contributors
+        may be used to endorse or promote products derived from this software
+        without specific prior written permission.
+        
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+        ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+        LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+        CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+        SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+        INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+        CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+        ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+        POSSIBILITY OF SUCH DAMAGE.
+        
+        You are under no obligation whatsoever to provide any bug fixes, patches,
+        or upgrades to the features, functionality or performance of the source
+        code ("Enhancements") to anyone; however, if you choose to make your
+        Enhancements available either publicly, or directly to Lawrence Berkeley
+        National Laboratory, without imposing a separate written license agreement
+        for such Enhancements, then you hereby grant the following license: a
+        non-exclusive, royalty-free perpetual license to install, use, modify,
+        prepare derivative works, incorporate into other computer software,
+        distribute, and sublicense such enhancements or derivative works thereof,
+        in binary and source code form.
+        
+Project-URL: homepage, https://github.com/BASIN-3D/basin3d
+Project-URL: documentation, https://basin3d.readthedocs.io/
+Project-URL: repository, https://github.com/BASIN-3D
+Project-URL: changelog, https://github.com/BASIN-3D/basin3d/blob/main/CHANGES.md
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Hydrology
+Requires-Python: <3.11,>=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Provides-Extra: docs
+License-File: LICENSE
+
+# basin3d
+Broker for Assimilation, Synthesis and Integration of eNvironmental Diverse, Distributed Datasets. 
+
+![basin3d](https://user-images.githubusercontent.com/20212666/112556236-ff1a9b80-8d86-11eb-9009-25b658ce41e0.png)
+
+BASIN-3D is a software ecosystem that synthesizes diverse earth science data from a variety of remote data sources on-demand, without the need for storing data in a single database. It is designed to parse, translate, and synthesize diverse observations from well-curated repositories into standardized formats for scientific uses such as analysis and visualization.
+
+basin3d is the core BASIN-3D application that uses a generalized data synthesis model that applies across a variety of earth science observation types (hydrology, geochemistry, climate etc.). 
+
+basin3d has available plugins that can connect to specific data sources of interest, and map the data source vocabularies to the basin3d synthesis models.
+
+
+
+## Getting Started
+
+### Install
+
+Install a source distribution with pip:
+
+    $ pip install basin3d
+    
+Make sure your installation was successful:
+
+    $ python
+    >>> import basin3d
+    >>>
+
+## Documentation
+
+See latest basin3d documentation [here](https://basin3d.readthedocs.io/en/latest/)
+
+
+## Contributing
+
+If you’re interested in contributing to basin3d, check out out our [contributing guidelines](CONTRIBUTING.md). It will help explain why, what, and how to get started.
+
+
+## Changelog
+See the [changelog](https://basin3d.readthedocs.io/en/stable/changelog.html) for a history of updates and changes to basin3d
+
+## Authors
+
+* **Charuleka Varadharajan** - [LBL](https://eesa.lbl.gov/profiles/charuleka-varadharajan/)
+* **Valerie Hendrix**  - [LBL](https://crd.lbl.gov/departments/data-science-and-technology/uss/staff/valerie-hendrix)
+* **Danielle Svehla Christianson** - [LBL](https://crd.lbl.gov/departments/data-science-and-technology/uss/staff/danielle-christianson/)
+* **Catherine Wong**  - [LBL](https://crd.lbl.gov/departments/data-science-and-technology/uss)
+
+
+## Copyright
+
+Broker for Assimilation, Synthesis and Integration of eNvironmental Diverse, Distributed Datasets (BASIN-3D) Copyright (c) 2019, The
+Regents of the University of California, through Lawrence Berkeley National
+Laboratory (subject to receipt of any required approvals from the U.S.
+Dept. of Energy).  All rights reserved.
+
+If you have questions about your rights to use or distribute this software,
+please contact Berkeley Lab's Intellectual Property Office at
+IPO@lbl.gov.
+
+NOTICE.  This Software was developed under funding from the U.S. Department
+of Energy and the U.S. Government consequently retains certain rights.  As
+such, the U.S. Government has been granted for itself and others acting on
+its behalf a paid-up, nonexclusive, irrevocable, worldwide license in the
+Software to reproduce, distribute copies to the public, prepare derivative
+works, and perform publicly and display publicly, and to permit other to do
+so.
+
+## License
+
+See [LICENSE](https://basin3d.readthedocs.io/en/stable/license_agreement.html) file for licensing details
+
+## Acknowledgments
+
+This research is supported as part of the Watershed Function Scientific Focus Area and a DOE Early Career Project funded by the U.S. Department of Energy, Office of Science, Office of Biological and Environmental Research under Award no. DE-AC02-05CH11231. This research used resources of the National Energy Research Scientific Computing Center (NERSC), a U.S. Department of Energy Office of Science User Facility operated under Contract No. DE-AC02-05CH11231.
+
+ 

basin3d-0.4.0/README.md

@@ -0,0 +1,76 @@
+# basin3d
+Broker for Assimilation, Synthesis and Integration of eNvironmental Diverse, Distributed Datasets. 
+
+![basin3d](https://user-images.githubusercontent.com/20212666/112556236-ff1a9b80-8d86-11eb-9009-25b658ce41e0.png)
+
+BASIN-3D is a software ecosystem that synthesizes diverse earth science data from a variety of remote data sources on-demand, without the need for storing data in a single database. It is designed to parse, translate, and synthesize diverse observations from well-curated repositories into standardized formats for scientific uses such as analysis and visualization.
+
+basin3d is the core BASIN-3D application that uses a generalized data synthesis model that applies across a variety of earth science observation types (hydrology, geochemistry, climate etc.). 
+
+basin3d has available plugins that can connect to specific data sources of interest, and map the data source vocabularies to the basin3d synthesis models.
+
+
+
+## Getting Started
+
+### Install
+
+Install a source distribution with pip:
+
+    $ pip install basin3d
+    
+Make sure your installation was successful:
+
+    $ python
+    >>> import basin3d
+    >>>
+
+## Documentation
+
+See latest basin3d documentation [here](https://basin3d.readthedocs.io/en/latest/)
+
+
+## Contributing
+
+If you’re interested in contributing to basin3d, check out out our [contributing guidelines](CONTRIBUTING.md). It will help explain why, what, and how to get started.
+
+
+## Changelog
+See the [changelog](https://basin3d.readthedocs.io/en/stable/changelog.html) for a history of updates and changes to basin3d
+
+## Authors
+
+* **Charuleka Varadharajan** - [LBL](https://eesa.lbl.gov/profiles/charuleka-varadharajan/)
+* **Valerie Hendrix**  - [LBL](https://crd.lbl.gov/departments/data-science-and-technology/uss/staff/valerie-hendrix)
+* **Danielle Svehla Christianson** - [LBL](https://crd.lbl.gov/departments/data-science-and-technology/uss/staff/danielle-christianson/)
+* **Catherine Wong**  - [LBL](https://crd.lbl.gov/departments/data-science-and-technology/uss)
+
+
+## Copyright
+
+Broker for Assimilation, Synthesis and Integration of eNvironmental Diverse, Distributed Datasets (BASIN-3D) Copyright (c) 2019, The
+Regents of the University of California, through Lawrence Berkeley National
+Laboratory (subject to receipt of any required approvals from the U.S.
+Dept. of Energy).  All rights reserved.
+
+If you have questions about your rights to use or distribute this software,
+please contact Berkeley Lab's Intellectual Property Office at
+IPO@lbl.gov.
+
+NOTICE.  This Software was developed under funding from the U.S. Department
+of Energy and the U.S. Government consequently retains certain rights.  As
+such, the U.S. Government has been granted for itself and others acting on
+its behalf a paid-up, nonexclusive, irrevocable, worldwide license in the
+Software to reproduce, distribute copies to the public, prepare derivative
+works, and perform publicly and display publicly, and to permit other to do
+so.
+
+## License
+
+See [LICENSE](https://basin3d.readthedocs.io/en/stable/license_agreement.html) file for licensing details
+
+## Acknowledgments
+
+This research is supported as part of the Watershed Function Scientific Focus Area and a DOE Early Career Project funded by the U.S. Department of Energy, Office of Science, Office of Biological and Environmental Research under Award no. DE-AC02-05CH11231. This research used resources of the National Energy Research Scientific Computing Center (NERSC), a U.S. Department of Energy Office of Science User Facility operated under Contract No. DE-AC02-05CH11231.
+
+ 

basin3d-0.4.0/basin3d/__init__.py

@@ -0,0 +1,9 @@
+from basin3d import monitor, synthesis
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("basin3d")
+except PackageNotFoundError:
+    # package is not installed
+    pass
+__all__ = ['monitor', 'synthesis']

basin3d-0.4.0/basin3d/core/access.py

@@ -0,0 +1,48 @@
+"""
+
+.. currentmodule:: basin3d.core.access
+
+:platform: Unix, Mac
+:synopsis: BASIN-3D ``DataSource`` access classes
+:module author: Val Hendrix <vhendrix@lbl.gov>
+:module author: Danielle Svehla Christianson <dschristianson@lbl.gov>
+
+.. contents:: Contents
+    :local:
+    :backlinks: top
+
+"""
+from basin3d.core import monitor
+
+logger = monitor.get_logger(__name__)
+
+
+def get_url(url, params=None, headers=None, verify=True, **kwargs):
+    """
+    Send a GET request to the specified URL.  Note look up extra
+    `kwargs` in `requests.get`
+    :param url:
+    :param params: request parameters
+    :param headers: request headers
+    :param verify: verify SSL connection
+    :return: Response
+    """
+    import requests
+    response = requests.get(url, params=params, verify=verify, headers=headers, **kwargs)
+    logger.info("url:{}".format(response.url))
+    return response
+
+
+def post_url(url, params=None, headers=None, verify=True):
+    """
+    Send a POST request to the specified URL
+    :param url:
+    :param params: request parameters
+    :param headers: request headers
+    :param verify: verify SSL connection
+    :return: Response
+    """
+    import requests
+    response = requests.post(url, params=params, verify=verify, headers=headers)
+    logger.info("url:{}".format(response.url))
+    return response