Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://ioos.github.io/erddapy/
Python interface for ERDDAP
https://ioos.github.io/erddapy/
hacktoberfest
Last synced: 3 months ago
JSON representation
Python interface for ERDDAP
- Host: GitHub
- URL: https://ioos.github.io/erddapy/
- Owner: ioos
- License: bsd-3-clause
- Created: 2017-09-26T17:56:53.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2024-07-11T09:23:24.000Z (4 months ago)
- Last Synced: 2024-07-11T10:52:47.301Z (4 months ago)
- Topics: hacktoberfest
- Language: Python
- Homepage: https://ioos.github.io/erddapy/
- Size: 41.7 MB
- Stars: 76
- Watchers: 12
- Forks: 30
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.txt
- License: LICENSE.txt
- Code of conduct: code-of-conduct.md
Awesome Lists containing this project
- awesome-erddap - erddapy - Python language package for simplified access to ERDDAP servers. (ERDDAP Clients)
README
erddapy
erddapy: ERDDAP + Python.
# Table of contents
- [Overview](#overview)
- [Example](#example)
- [Get in touch](#get-in-touch)
- [License and copyright](#license-and-copyright)
## 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](https://coastwatch.pfeg.noaa.gov/erddap/index.html).
### Documentation and code
The documentation is hosted at .
The code is hosted at .
### Installation
For `conda` users you can
```shell
conda install --channel conda-forge erddapy
```
or, if you are a `pip` users
```shell
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
```python
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](https://github.com/ioos/erddapy/issues).
## Projects using erddapy
- [argopy](https://github.com/euroargodev/argopy)
- [gliderpy](https://github.com/ioos/gliderpy)
- [gdutils](https://github.com/kerfoot/gdutils)
- [colocate](https://github.com/ioos/colocate)
- [intake-erddap](https://github.com/jmunroe/intake-erddap)
- [ioos_qc](https://github.com/ioos/ioos_qc)
## Similar projects
- [rerddap](https://cran.r-project.org/web/packages/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](https://github.com/hmedrano/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 .