Skip to main content

An implementation of the Data Access Protocol.

Project description

Pydap
=====

[![Build Status](https://travis-ci.org/pydap/pydap.svg)](https://travis-ci.org/pydap/pydap)
[![Python2](https://img.shields.io/badge/python-2-blue.svg)](https://www.python.org/downloads/)
[![Python3](https://img.shields.io/badge/python-3-blue.svg)](https://www.python.org/downloads/)
[![documentation](https://readthedocs.org/projects/pydap/badge/?version=latest)](http://pydap.readthedocs.org/en/latest/)
[![PyPI](https://img.shields.io/pypi/v/pydap.svg?maxAge=2592000?style=plastic)](https://pypi-hypernode.com/pypi/Pydap/)

[Pydap](http://pydap.readthedocs.io/en/latest/) 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](http://pydap.readthedocs.io/en/latest/server.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](http://pydap.readthedocs.io/en/latest/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](server.html) has more information on how to better deploy Pydap.

## Documentation
For more information, see [![documentation](https://readthedocs.org/projects/pydap/badge/?version=latest)](http://pydap.readthedocs.org/en/latest/)

## 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/)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Pydap-3.2.2.tar.gz (3.9 MB view details)

Uploaded Source

Built Distribution

Pydap-3.2.2-py3-none-any.whl (2.3 MB view details)

Uploaded Python 3

File details

Details for the file Pydap-3.2.2.tar.gz.

File metadata

  • Download URL: Pydap-3.2.2.tar.gz
  • Upload date:
  • Size: 3.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for Pydap-3.2.2.tar.gz
Algorithm Hash digest
SHA256 86326642e24f421595a74b0f9986da76d7932b277768f501fe214d72592bdc40
MD5 8565f116015eda02f548fab8fbad36de
BLAKE2b-256 1d87b892c0a148fa8cea9c38e95394795ded015ee0679e9d8dadb3b939b38e21

See more details on using hashes here.

File details

Details for the file Pydap-3.2.2-py3-none-any.whl.

File metadata

File hashes

Hashes for Pydap-3.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9655711d8da71192bda78fed15cbf4fc7fb1decc661ea5022263c0143648cf63
MD5 b2ebf339a119b568f3157234a92c304b
BLAKE2b-256 9ead01367f79b24015e223dd7679e4c9b16a6792fe5a9772e45e5f81b2c4a021

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page