Skip to main content

Python interface for ERDDAP

Project description

erddapy

erddapy: ERDDAP + Python.

conda-forge downloads Latest version Commits since last release # contributors zenodo zenodo pre-commit.ci status GHA-tests


Table of contents

Overview

Easier access to scientific data.

erddapy takes advantage of ERDDAP's RESTful web services and creates the ERDDAP URL for any request, like searching for datasets, acquiring metadata, downloading the data, etc.

What is ERDDAP? ERDDAP unifies the different types of data servers and offers a consistent way to get the data in multiple the formats. For more information on ERDDAP servers please see https://coastwatch.pfeg.noaa.gov/erddap/index.html.

Documentation and code

The documentation is hosted at https://ioos.github.io/erddapy.

The code is hosted at https://github.com/ioos/erddapy.

Installation

For conda users you can

conda install --channel conda-forge erddapy

or, if you are a pip users

python -m pip install erddapy

Note that, if you are installing the requirements-dev.txt, the iris package is named scitools-iris on PyPI so pip users must rename that before installing.

Example

from erddapy import ERDDAP


e = ERDDAP(
  server="https://gliders.ioos.us/erddap",
  protocol="tabledap",
)

e.response = "csv"
e.dataset_id = "whoi_406-20160902T1700"
e.constraints = {
    "time>=": "2016-07-10T00:00:00Z",
    "time<=": "2017-02-10T00:00:00Z",
    "latitude>=": 38.0,
    "latitude<=": 41.0,
    "longitude>=": -72.0,
    "longitude<=": -69.0,
}
e.variables = [
    "depth",
    "latitude",
    "longitude",
    "salinity",
    "temperature",
    "time",
]

df = e.to_pandas()

Get in touch

Report bugs, suggest features or view the source code on GitHub.

Projects using erddapy

Similar projects

  • rerddap implements a nice client for R that performs searches on a curated set of servers instead of a query per server like erddapy.

  • erddap-python 99% of the same functionality as erddapy but with a JavaScript-like API.

License and copyright

Erddapy is licensed under BSD 3-Clause "New" or "Revised" License (BSD-3-Clause).

Development occurs on GitHub at https://github.com/ioos/erddapy.

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

erddapy-2.2.3.tar.gz (21.6 kB view details)

Uploaded Source

Built Distribution

erddapy-2.2.3-py3-none-any.whl (24.5 kB view details)

Uploaded Python 3

File details

Details for the file erddapy-2.2.3.tar.gz.

File metadata

  • Download URL: erddapy-2.2.3.tar.gz
  • Upload date:
  • Size: 21.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for erddapy-2.2.3.tar.gz
Algorithm Hash digest
SHA256 0206dcba3954340281a9e283d9bc3925581205492531d98775c65a61cb23bb90
MD5 f58bc0224b81352b282ddbb77aa8aebc
BLAKE2b-256 4a99c0c2f84c4e33345e05c179db8e1a72f6129f5e76fc0ca96fbb91bb94c568

See more details on using hashes here.

File details

Details for the file erddapy-2.2.3-py3-none-any.whl.

File metadata

  • Download URL: erddapy-2.2.3-py3-none-any.whl
  • Upload date:
  • Size: 24.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for erddapy-2.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 ebd601820106166b0752f08ce2192599b7940f19170ccf9c009d8ba6703a601a
MD5 7a8daf9cc878045fe092001d2868f5f1
BLAKE2b-256 a0f30488a55f657c47a6fc84f1772362c76266b8acde3a0bdc842f7893941656

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