pydap
=====
[![Build Status](https://travis-ci.org/pydap/pydap.svg)](https://travis-ci.org/pydap/pydap)
[![Python3](https://img.shields.io/badge/python-3-blue.svg)](https://www.python.org/downloads/)
[![PyPI](https://img.shields.io/pypi/v/pydap.svg?maxAge=2592000?style=plastic)](https://pypi.python.org/pypi/pydap/)
[![Join the chat at https://gitter.im/pydap/pydap](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/pydap/pydap)
[pydap](https://pydap.github.io/pydap/) is an implementation of the
Opendap/DODS protocol, written from scratch in pure python. You can
use pydap to access scientific data on the internet 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.
Quickstart
----------
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. You can now open any remotely served dataset, and pydap
will download the accessed data on-the-fly as needed:
```python
>>> from pydap.client import open_url
>>> dataset = open_url('http://test.opendap.org/dap/data/nc/coads_climatology.nc')
>>> var = dataset['SST']
>>> var.shape
(12, 90, 180)
>>> var.dtype
dtype('>f4')
>>> data = var[0,10:14,10:14] # this will download data from the server
>>> data
<GridType with array 'SST' and maps 'TIME', 'COADSY', 'COADSX'>
>>> print(data.data)
[array([[[ -1.26285708e+00, -9.99999979e+33, -9.99999979e+33,
-9.99999979e+33],
[ -7.69166648e-01, -7.79999971e-01, -6.75454497e-01,
-5.95714271e-01],
[ 1.28333330e-01, -5.00000156e-02, -6.36363626e-02,
-1.41666666e-01],
[ 6.38000011e-01, 8.95384610e-01, 7.21666634e-01,
8.10000002e-01]]], dtype=float32), array([ 366.]), array([-69., -67., -65., -63.]), array([ 41., 43., 45., 47.])]
```
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:
```bash
$ pip install pydap[server,handlers.netcdf]
```
This will install support for
[netCDF](http://www.unidata.ucar.edu/software/netcdf/) files; more
[handlers](https://pydap.github.io/pydap/handlers.html) for
different formats are available, if necessary. Now create a directory
for your server data.
To run the server just issue the command:
```bash
$ pydap --data ./myserver/data/ --port 8001
```
This will start a standalone server running on http://localhost:8001/,
serving netCDF files from ``./myserver/data/``, similar to the test
server at http://test.pydap.org/. Since the server uses the
[WSGI](http://wsgi.org/) standard, it can 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
If you need any help with pydap, please feel free to send an email to
the [mailing list](http://groups.google.com/group/pydap/)
Raw data
{
"_id": null,
"home_page": "http://pydap.org/",
"name": "pydap",
"maintainer": "James Hiebert",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "james@hiebert.name",
"keywords": "opendap dods dap dap2 dap4 science data",
"author": "Roberto De Almeida",
"author_email": "roberto@dealmeida.net",
"download_url": "https://files.pythonhosted.org/packages/24/9f/2b9dfe7c740e4f62901a6cc6679c2b2b527b60105f0bafb10f79e552361f/pydap-3.4.1.tar.gz",
"platform": null,
"description": "pydap\n=====\n\n[![Build Status](https://travis-ci.org/pydap/pydap.svg)](https://travis-ci.org/pydap/pydap)\n[![Python3](https://img.shields.io/badge/python-3-blue.svg)](https://www.python.org/downloads/)\n[![PyPI](https://img.shields.io/pypi/v/pydap.svg?maxAge=2592000?style=plastic)](https://pypi.python.org/pypi/pydap/)\n[![Join the chat at https://gitter.im/pydap/pydap](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/pydap/pydap) \n\n[pydap](https://pydap.github.io/pydap/) is an implementation of the\nOpendap/DODS protocol, written from scratch in pure python. You can\nuse pydap to access scientific data on the internet without having to\ndownload it; instead, you work with special array and iterable objects\nthat download data on-the-fly as necessary, saving bandwidth and\ntime. The module also comes with a robust-but-lightweight Opendap\nserver, implemented as a WSGI application.\n\n\nQuickstart\n----------\n\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```\n\nThis will install pydap together with all the required\ndependencies. You can now open any remotely served dataset, and pydap\nwill download the accessed data on-the-fly as needed:\n\n```python\n\n >>> from pydap.client import open_url\n >>> dataset = open_url('http://test.opendap.org/dap/data/nc/coads_climatology.nc')\n >>> var = dataset['SST']\n >>> var.shape\n (12, 90, 180)\n >>> var.dtype\n dtype('>f4')\n >>> data = var[0,10:14,10:14] # this will download data from the server\n >>> data\n <GridType with array 'SST' and maps 'TIME', 'COADSY', 'COADSX'>\n >>> print(data.data)\n [array([[[ -1.26285708e+00, -9.99999979e+33, -9.99999979e+33,\n -9.99999979e+33],\n [ -7.69166648e-01, -7.79999971e-01, -6.75454497e-01,\n -5.95714271e-01],\n [ 1.28333330e-01, -5.00000156e-02, -6.36363626e-02,\n -1.41666666e-01],\n [ 6.38000011e-01, 8.95384610e-01, 7.21666634e-01,\n 8.10000002e-01]]], dtype=float32), array([ 366.]), array([-69., -67., -65., -63.]), array([ 41., 43., 45., 47.])]\n```\n\nFor more information, please check the documentation on [using pydap\nas a client](https://pydap.github.io/pydap/client.html). pydap also\ncomes 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```bash\n\n $ pip install pydap[server,handlers.netcdf]\n```\n\nThis will install support for\n[netCDF](http://www.unidata.ucar.edu/software/netcdf/) files; more\n[handlers](https://pydap.github.io/pydap/handlers.html) for\ndifferent formats are available, if necessary. Now create a directory\nfor your server data.\n\n\nTo run the server just issue the command:\n\n```bash\n\n $ pydap --data ./myserver/data/ --port 8001\n```\n\nThis will start a standalone server running on http://localhost:8001/,\nserving netCDF files from ``./myserver/data/``, similar to the test\nserver at http://test.pydap.org/. Since the server uses the\n[WSGI](http://wsgi.org/) standard, it can easily be run behind\nApache. 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\ndocumentation](https://pydap.github.io/pydap/).\n\n## Help\n\nIf you need any help with pydap, please feel free to send an email to\nthe [mailing list](http://groups.google.com/group/pydap/)\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "An implementation of the Data Access Protocol.",
"version": "3.4.1",
"project_urls": {
"Homepage": "http://pydap.org/"
},
"split_keywords": [
"opendap",
"dods",
"dap",
"dap2",
"dap4",
"science",
"data"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "37e1176f49111e96267d5b24107f03a9a84eaee1d2fe5922c489c6ba54bbcc51",
"md5": "2210bbdc8e07d2968371ee3a7101481a",
"sha256": "a24cc3bc8c78089542699382bf650d57a055c82bb72c342fa7caa6618b9e4417"
},
"downloads": -1,
"filename": "pydap-3.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2210bbdc8e07d2968371ee3a7101481a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 2325115,
"upload_time": "2023-05-19T19:25:03",
"upload_time_iso_8601": "2023-05-19T19:25:03.422926Z",
"url": "https://files.pythonhosted.org/packages/37/e1/176f49111e96267d5b24107f03a9a84eaee1d2fe5922c489c6ba54bbcc51/pydap-3.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "249f2b9dfe7c740e4f62901a6cc6679c2b2b527b60105f0bafb10f79e552361f",
"md5": "66391fe6f78530caabcbdb32832ecc7b",
"sha256": "17c46087b53c6aec9bc5495a5d52aca19b2aa4b045f370b9f4b3a6058f5d8df7"
},
"downloads": -1,
"filename": "pydap-3.4.1.tar.gz",
"has_sig": false,
"md5_digest": "66391fe6f78530caabcbdb32832ecc7b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 2242799,
"upload_time": "2023-05-19T19:25:05",
"upload_time_iso_8601": "2023-05-19T19:25:05.485403Z",
"url": "https://files.pythonhosted.org/packages/24/9f/2b9dfe7c740e4f62901a6cc6679c2b2b527b60105f0bafb10f79e552361f/pydap-3.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-19 19:25:05",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pydap"
}