Metadata-Version: 2.4
Name: pangaeapy
Version: 1.1.2
Summary: Download and analyse (meta-)data of PANGAEA datasets
Author-email: Robert Huber <rhuber@uni-bremen.de>
License-Expression: GPL-3.0-only
Project-URL: Homepage, https://www.pangaea.de
Project-URL: Source, https://github.com/pangaea-data-publisher/pangaeapy
Project-URL: Documentation, https://pangaea-data-publisher.github.io/pangaeapy/
Project-URL: Issues, https://github.com/pangaea-data-publisher/pangaeapy/issues
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.11.0
Requires-Dist: jmespath>=1.0.0
Requires-Dist: lxml>=4.9.3
Requires-Dist: netcdf4>1.6.5
Requires-Dist: numpy>=1.24.4
Requires-Dist: pandas>=2.2.2
Requires-Dist: requests>=2.26.0
Dynamic: license-file

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.4013941.svg)](https://doi.org/10.5281/zenodo.4013941)

# pangaeapy - a Python module to access and analyse PANGAEA data

## Background

![pangaea](https://pangaea.de/assets/v.0163d8ce3a8d13294b065fcbdc04aebc/layout-images/pangaea-logo.png)

PANGAEA ([https://www.pangaea.de](https://www.pangaea.de)) is one of the world's largest archives of this kind offering essential data services such as data curation, long-term data archiving and data publication. PANGAEA hosts about 400,000 datasets comprising around 17.5 billion individual measurements (Aug. 2020) and observations which have been collected during more than 240 international research projects. The system is open to any project, institution or individual scientist using, archiving or publishing research data.

Since the programming languages Python and R have become increasingly important for scientific data analysis in recent years, we have developed 'pangaeapy'  a new, custom Python module that considerably simplifies typical data science tasks.

Given a DOI, pangaeapy uses PANGAEA’s web services to automatically load PANGAEA metadata into a dedicated python object and tabular data into a Python Data Analysis Library (pandas) DataFrame with a mere call of a specialized function. This makes it possible to integrate PANGAEA data with data from a large number of sources and formats (Excel, NetCDF, etc.) and to carry out data analyses within a suitable computational environment such as Jupyter notebooks in a uniform manner.

## Installation

* Source code from [GitHub](https://github.com/pangaea-data-publisher/pangaeapy)
    * `pip install git+https://github.com/pangaea-data-publisher/pangaeapy.git`
* Wheels for Python from [PyPI](https://pypi.org/project/pangaeapy/)
    * `pip install pangaeapy`

## Usage

```python
from pangaeapy import PanDataSet

ds = PanDataSet(787140)
print(ds.title)
print(ds.data.head())
```

## Examples
Please take a look at the example Jupyter Notebooks in the `examples` folder.

## Documentation

[https://pangaea-data-publisher.github.io/pangaeapy/](https://pangaea-data-publisher.github.io/pangaeapy/)

## Running the tests

The tests are located in the `test` directory. You can run them by executing `pytest` or `tox` in the root directory.

## Cite as
Robert Huber, Egor Gordeev, Markus Stocker, Aarthi Balamurugan, & Uwe Schindler (2020). pangaeapy - a Python module to access and analyse PANGAEA data. Zenodo. [http://doi.org/10.5281/zenodo.4013940](http://doi.org/10.5281/zenodo.4013940).

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.4013940.svg)](https://doi.org/10.5281/zenodo.4013940)
