Skip to main content

glodap

Tests pypi badge Conda Version DOI License: GPL v3 Ruff

Download GLODAP datasets and import them as pandas DataFrames.

Install

pip install glodap
conda install conda-forge::glodap

Use

The functions arctic, atlantic, indian, pacific and world import the latest version of the GLODAP dataset for the corresponding region, first downloading the file if it's not already saved locally. For example:

import glodap
df_atlantic = glodap.atlantic()

Files are saved by default at "~/.glodap", but this can be controlled with the kwarg gpath. See the function docstrings for more information.

The columns are the same as in the original GLODAP .mat files available from glodap.info, except:

  • The "G2" at the start of each parameter has been removed.
  • Flags end with "_f" instead of just "f".
  • There is a "datetime" column, which combines the "year", "month" and "day" but NOT the "hour" and "minute" (because some of these are missing).

The functions download and read can also be used for finer control, such as specifying a particular GLODAP version rather than using the latest one (currently v3.2026). See their function docstrings for more information.

The files from the GEOMAR mirrors are downloaded (v2: .mat files; v3: .csv.zip files), and the SHA256 checksum of each downloaded file is checked before the file is written to disk.

With PyCO2SYS

The columns of the imported DataFrames can be passed directly into PyCO2SYS v2:

import PyCO2SYS as pyco2
co2s_atlantic = pyco2.sys(data=df_atlantic.drop(columns="fco2"), nitrite=0)

Note nitrite=0 - this means PyCO2SYS will ignore the "nitrite" column, which is necessary because while PyCO2SYS includes the nitrite-nitrous acid equilibrium, its equilibrium constant is valid only under lab conditions.

Because of how the columns are named, and because we dropped the "fco2" column, when passing the DataFrame directly to PyCO2SYS as above, the system will be solved from DIC and alkalinity, not pH nor fCO2.

Cite

If you use GLODAP data, please cite the paper corresponding to the version you used:

If your analysis leans heavily on a specific subset of GLODAP, please consider inviting the PIs of the relevant datasets to be contribute as co-authors.

If you would also like to cite this tool directly:

Humphreys, M. P. (2026). GLODAP downloader and importer in Python [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.21295574

Metadata

Release files for glodap 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for glodap 1.0.0
File Size Uploaded Provenance Actions
glodap-1.0.0.tar.gz 22.5 kB Without provenance Details for glodap-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for glodap 1.0.0
File Interpreter ABI Platform Actions
glodap-1.0.0-py3-none-any.whl Python 3 none any Details for glodap-1.0.0-py3-none-any.whl

Total release size: 42.7 kB

Release files / glodap-1.0.0.tar.gz

Download URL glodap-1.0.0.tar.gz
Size 22.5 kB
Tags Source
SHA-256 checksum
How to use checksums
984739a84892a4ef6cbdf8aebcdac114edfde09dc7ab68f3ada1a94330e3e003
BLAKE2b-256 checksum
How to use checksums
93616a91665b6f2d80a9e5878e024be731d862d36b3261f04fa25002051cdc30
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / glodap-1.0.0-py3-none-any.whl

Download URL glodap-1.0.0-py3-none-any.whl
Size 20.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ce45c07b4159c2954d9f3b0293e79f2253fe7fddc63b9d1d34f8085e4b64108e
BLAKE2b-256 checksum
How to use checksums
3feea4a0e84e1721e1df44f05e05fe968902fdd99c2af9c7c6a0f9276d55445d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for glodap 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page