| Name | pydap JSON |
| Version |
3.5.2
JSON |
| download |
| home_page | None |
| Summary | A pure python implementation of the Data Access Protocol. |
| upload_time | 2024-11-19 23:24:20 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | The MIT License Copyright (c) 2003-2010 Roberto De Almeida Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
pydap
=====
[](https://github.com/pydap/pydap/actions/workflows/run_tests_ubuntu.yml)
[](https://github.com/pydap/pydap/actions/workflows/run_tests_macos.yml)
[](https://pypi.python.org/pypi/pydap/)
[](https://pypi.python.org/pypi/pydap/)
[](https://anaconda.org/conda-forge/pydap)
[](https://github.com/psf/black)
[](https://github.com/pydap/pydap)
[](https://results.pre-commit.ci/latest/github/pydap/pydap/main)
[](https://doi.org/10.5281/zenodo.14010567)
What is pydap?
----------
[pydap](https://pydap.github.io/pydap/) is an open-source implementation of the OPeNDAP protocol, written from scratch in pure python. You can use pydap to access scientific data available on the many OPeNDAP servers publically available through the internet. Because pydap supports remote and lazy evaluation, you can access the data without having to download it; instead, you work with special array and iterable objects that download data on-the-fly as necessary, saving bandwidth and time. The module also comes with a robust-but-lightweight OPeNDAP server, implemented as a WSGI application.
Why pydap?
----------
Originally developed in the 2000s, pydap is one of the oldest open-source python projects available and it gets rutinely developed and maintained by the OPeNDAP community at large. In addition, pydap is a long-recognized backend engine (and dependency) for [xarray](https://github.com/pydata/xarray) and chances are you have used pydap in past without knowing.
Quickstart
----------
pydap is a lighweight python package that you can use in either
of the two modalities: a client and as a server.
You can install the latest version using
[pip](http://pypi.python.org/pypi/pip). After [installing
pip](http://www.pip-installer.org/en/latest/installing.html) you can
install pydap with this command:
```bash
$ pip install pydap
```
This will install pydap together with all the required
dependencies.
pydap is also available through [Anaconda](https://www.anaconda.com/).
Below we install pydap and its required dependencies, along with common
additional packages in a fresh conda environment named pydap:
```bash
$ conda create -n pydap -c conda-forge python=3.10 pydap numpy">=2.0" jupyterlab ipython netCDF4 scipy matplotlib
```
Now you simply activate the pydap environment:
```bash
conda activate pydap
```
(NOTE: if you have `mamba` install, you can replace `conda` in the commands with `mamba`). You can now use pydap as a client and open any remotely served
dataset, and pydap will download the accessed data on-the-fly as needed. For example consider [this](http://test.opendap.org:8080/opendap/catalog/ghrsst/20210102090000-JPL-L4_GHRSST-SSTfnd-MUR-GLOB-v02.0-fv04.1.nc.dmr.html) dataset currently hosted on OPeNDAP's Hyrax data server
```python
from pydap.client import open_url
pyds = open_url('http://test.opendap.org:8080/opendap/catalog/ghrsst/20210102090000-JPL-L4_GHRSST-SSTfnd-MUR-GLOB-v02.0-fv04.1.nc', protocol='dap4')
pyds.tree()
```
```python
.20210102090000-JPL-L4_GHRSST-SSTfnd-MUR-GLOB-v02.0-fv04.1.nc
├──time
├──lat
├──lon
├──analysed_sst
├──analysis_error
├──mask
├──sea_ice_fraction
├──dt_1km_data
└──sst_anomaly
```
```python
pyds['sst_anomaly'].shape
```
```python
(1, 17999, 36000)
```
**NOTE** In the example above, no data was downloaded, it was all lazily evaluated using OPeNDAP's DMR (DAP4) metadata representation. For more information, please check the documentation on [using pydap
as a client](https://pydap.github.io/pydap/client.html).
pydap also comes with a simple server, implemented as a [WSGI]( http://wsgi.org/)
application. To use it, you first need to install the server and
optionally a data handler:
## Running pydap as a Server
```bash
$ pip install "pydap[server,netcdf]"
```
This will install the necessary dependencies for running pydap as a server, along with extra dependencies for handling [netCDF4](https://www.unidata.ucar.edu/software/netcdf/) dataset. Now create a directory
for your server data.
To run the server just issue the command:
```bash
$ pydap --data ./myserver/data/ --port 8001 --workers 4 --threads 4
```
This will start a standalone server running on the default http://localhost:8001/,
serving netCDF files from ``./myserver/data/`` Since the server uses the
[WSGI](http://wsgi.org/) standard, pydap uses by default 1 worker and 1
thread, but these can be defined by the user like in the case above (4 workers
and 4 threads). Pydap can also easily be run behind Apache. The [server
documentation](https://pydap.github.io/pydap/server.html) has
more information on how to better deploy pydap.
## Documentation
For more information, see [the pydap documentation](https://pydap.github.io/pydap/).
## Help and Community
If you need any help with pydap, open an issue in this repository. You can also send an email to
the [mailing list](http://groups.google.com/group/pydap/). Finally, ff you have a broader OPeNDAP access question, you can reach the OPeNDAP team on the [OPeNDAP Discourse](https://opendap.discourse.group/)!
Raw data
{
"_id": null,
"home_page": null,
"name": "pydap",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Miguel Jimenez-Urias <mjimenez@opendap.org>",
"keywords": null,
"author": null,
"author_email": "Roberto De Almeida <roberto@dealmeida.net>",
"download_url": "https://files.pythonhosted.org/packages/a1/0b/9b57a2d547fe23025162f7adffdfdc4aab8d333dfddc38d455628511bd65/pydap-3.5.2.tar.gz",
"platform": null,
"description": "pydap\n=====\n[](https://github.com/pydap/pydap/actions/workflows/run_tests_ubuntu.yml)\n[](https://github.com/pydap/pydap/actions/workflows/run_tests_macos.yml)\n[](https://pypi.python.org/pypi/pydap/)\n[](https://pypi.python.org/pypi/pydap/)\n[](https://anaconda.org/conda-forge/pydap)\n[](https://github.com/psf/black)\n[](https://github.com/pydap/pydap)\n[](https://results.pre-commit.ci/latest/github/pydap/pydap/main)\n[](https://doi.org/10.5281/zenodo.14010567)\n\n\nWhat is pydap?\n----------\n[pydap](https://pydap.github.io/pydap/) is an open-source implementation of the OPeNDAP protocol, written from scratch in pure python. You can use pydap to access scientific data available on the many OPeNDAP servers publically available through the internet. Because pydap supports remote and lazy evaluation, you can access the data without having to download it; instead, you work with special array and iterable objects that download data on-the-fly as necessary, saving bandwidth and time. The module also comes with a robust-but-lightweight OPeNDAP server, implemented as a WSGI application.\n\nWhy pydap?\n----------\nOriginally developed in the 2000s, pydap is one of the oldest open-source python projects available and it gets rutinely developed and maintained by the OPeNDAP community at large. In addition, pydap is a long-recognized backend engine (and dependency) for [xarray](https://github.com/pydata/xarray) and chances are you have used pydap in past without knowing.\n\n\nQuickstart\n----------\npydap is a lighweight python package that you can use in either\nof the two modalities: a client and as a server.\nYou can install the latest version using\n[pip](http://pypi.python.org/pypi/pip). After [installing\npip](http://www.pip-installer.org/en/latest/installing.html) you can\ninstall pydap with this command:\n\n```bash\n $ pip install pydap\n```\nThis will install pydap together with all the required\ndependencies.\n\npydap is also available through [Anaconda](https://www.anaconda.com/).\nBelow we install pydap and its required dependencies, along with common\nadditional packages in a fresh conda environment named pydap:\n\n```bash\n$ conda create -n pydap -c conda-forge python=3.10 pydap numpy\">=2.0\" jupyterlab ipython netCDF4 scipy matplotlib\n```\nNow you simply activate the pydap environment:\n```bash\nconda activate pydap\n```\n(NOTE: if you have `mamba` install, you can replace `conda` in the commands with `mamba`). You can now use pydap as a client and open any remotely served\ndataset, and pydap will download the accessed data on-the-fly as needed. For example consider [this](http://test.opendap.org:8080/opendap/catalog/ghrsst/20210102090000-JPL-L4_GHRSST-SSTfnd-MUR-GLOB-v02.0-fv04.1.nc.dmr.html) dataset currently hosted on OPeNDAP's Hyrax data server\n\n```python\n from pydap.client import open_url\n pyds = open_url('http://test.opendap.org:8080/opendap/catalog/ghrsst/20210102090000-JPL-L4_GHRSST-SSTfnd-MUR-GLOB-v02.0-fv04.1.nc', protocol='dap4')\n pyds.tree()\n```\n```python\n .20210102090000-JPL-L4_GHRSST-SSTfnd-MUR-GLOB-v02.0-fv04.1.nc\n \u251c\u2500\u2500time\n \u251c\u2500\u2500lat\n \u251c\u2500\u2500lon\n \u251c\u2500\u2500analysed_sst\n \u251c\u2500\u2500analysis_error\n \u251c\u2500\u2500mask\n \u251c\u2500\u2500sea_ice_fraction\n \u251c\u2500\u2500dt_1km_data\n \u2514\u2500\u2500sst_anomaly\n```\n```python\n pyds['sst_anomaly'].shape\n```\n```python\n (1, 17999, 36000)\n```\n**NOTE** In the example above, no data was downloaded, it was all lazily evaluated using OPeNDAP's DMR (DAP4) metadata representation. For more information, please check the documentation on [using pydap\nas a client](https://pydap.github.io/pydap/client.html).\n\npydap also comes with a simple server, implemented as a [WSGI]( http://wsgi.org/)\napplication. To use it, you first need to install the server and\noptionally a data handler:\n\n## Running pydap as a Server\n\n```bash\n $ pip install \"pydap[server,netcdf]\"\n```\n\nThis will install the necessary dependencies for running pydap as a server, along with extra dependencies for handling [netCDF4](https://www.unidata.ucar.edu/software/netcdf/) dataset. Now create a directory\nfor your server data.\n\nTo run the server just issue the command:\n\n```bash\n\n $ pydap --data ./myserver/data/ --port 8001 --workers 4 --threads 4\n```\n\nThis will start a standalone server running on the default http://localhost:8001/,\nserving netCDF files from ``./myserver/data/`` Since the server uses the\n[WSGI](http://wsgi.org/) standard, pydap uses by default 1 worker and 1\nthread, but these can be defined by the user like in the case above (4 workers\nand 4 threads). Pydap can also easily be run behind Apache. The [server\ndocumentation](https://pydap.github.io/pydap/server.html) has\nmore information on how to better deploy pydap.\n\n## Documentation\n\nFor more information, see [the pydap documentation](https://pydap.github.io/pydap/).\n\n## Help and Community\n\nIf you need any help with pydap, open an issue in this repository. You can also send an email to\nthe [mailing list](http://groups.google.com/group/pydap/). Finally, ff you have a broader OPeNDAP access question, you can reach the OPeNDAP team on the [OPeNDAP Discourse](https://opendap.discourse.group/)!\n",
"bugtrack_url": null,
"license": "The MIT License Copyright (c) 2003-2010 Roberto De Almeida Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
"summary": "A pure python implementation of the Data Access Protocol.",
"version": "3.5.2",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1890ed2ce3b638aec8534ece225e97a4aae499f086dbeb3b02eaa29a7f6ca9e2",
"md5": "7efdfae9e56841e450d4e0f85a682ee5",
"sha256": "9196d8e7cc8a446565a9126b9d7b0e51ab73bac0fdbb31dd64fb55f018a8f4a4"
},
"downloads": -1,
"filename": "pydap-3.5.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7efdfae9e56841e450d4e0f85a682ee5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 2390054,
"upload_time": "2024-11-19T23:24:17",
"upload_time_iso_8601": "2024-11-19T23:24:17.708830Z",
"url": "https://files.pythonhosted.org/packages/18/90/ed2ce3b638aec8534ece225e97a4aae499f086dbeb3b02eaa29a7f6ca9e2/pydap-3.5.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a10b9b57a2d547fe23025162f7adffdfdc4aab8d333dfddc38d455628511bd65",
"md5": "fa3b783afaf26187a8db952a42e245da",
"sha256": "d26d3d2e3ad4def85b93c4277e9a1819ced86aa6c0a495c2c68e1726ab3ee794"
},
"downloads": -1,
"filename": "pydap-3.5.2.tar.gz",
"has_sig": false,
"md5_digest": "fa3b783afaf26187a8db952a42e245da",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 5457179,
"upload_time": "2024-11-19T23:24:20",
"upload_time_iso_8601": "2024-11-19T23:24:20.043234Z",
"url": "https://files.pythonhosted.org/packages/a1/0b/9b57a2d547fe23025162f7adffdfdc4aab8d333dfddc38d455628511bd65/pydap-3.5.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-19 23:24:20",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pydap"
}
