ESGVOC Library

ESGVOC is a Python library designed to simplify interaction with controlled vocabularies (CVs) used in WCRP climate data projects. It supports querying, caching, and validating terms across various CV repositories like the universe and project-specific repositories (e.g., CMIP6Plus, CMIP6, etc.).

Full documentation is available at https://esgf.github.io/esgf-vocab/.

---

Features

• Query controlled vocabularies:

  • Retrieve terms, collections, or descriptors.
  • Perform cross-validation and search operations.
  • Supports case-sensitive, wildcard, and approximate matching.

• Caching:

  • Download CVs to a local database for offline use.
  • Keep the local cache up-to-date.

• Validation:

  • Validate strings against CV terms and templates.

---

Installation

ESGVOC is available on PyPI. Install it with pip:

pip install esgvoc

Following this command to install or update the latest CVs.

esgvoc install

How to contribute

Install Python dev environment

• Pip

pip install -e .

• Rye

rye sync

Linters & code formatters

• Pip

pip install pre-commit
pre-commit install

• Rye

rye install
rye run pre-commit install