glodap
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:
v3.2026: TBC (submitted to Earth System Science Data)v2.2023: https://doi.org/10.5194/essd-16-2047-2024v2.2022: https://doi.org/10.5194/essd-14-5543-2022v2.2021: https://doi.org/10.5194/essd-13-5565-2021v2.2020: https://doi.org/10.5194/essd-12-3653-2020v2.2019: https://doi.org/10.5194/essd-11-1437-2019v2.2016: https://doi.org/10.5194/essd-8-297-2016
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.