ESA title
ESA logo
English French German Dutch Spanish
CCI Home Climate Change Initiative News Highlights ECV Projects Cross-ECV Projects Paris Agreement Support Tipping Elements Projects Observations & Modelling Data Climate Data Records Training About Us Explore Contact us
/en/
  1. Home
  2. Data
Helpdesk

APIs

Programmatic access to CCI data is available through the following methods.

OpenSearch

Access all data of the CCI Open Data Portal through OpenSearch, a suite of web-based search engine and search protocol standards. An OpenSearch description provides the web interface of the CCI Open Data Portal search engine -
https://archive.opensearch.ceda.ac.uk/opensearch/description.xml

THREDDS

A THREDDS web server provides access to data and metadata on the CCI Open Data Portal via the Web Map Service (WMS) and Web Coverage Service (WCS) standards of the Open Geospatial Consortium and the Open-source Project for a Network Data Access Protocol (OPeNDAP) standard.
https://data.cci.ceda.ac.uk/

Earth System Grid Federation

CCI Obs4MIPs datasets are available through the Earth System Grid Federation (ESGF). These provide observational CCI products technically aligned with climate model data, specifically that made available from the Coupled Model Intercomparison Project (CMIP). ESGF provide a RESTful API.
https://esgf.ceda.ac.uk/esg-search/search/?query=CCI

FedEO

The CEOS Federated EO Gateway (FedEO) Clearinghouse STAC index provides interoperable access, following ISO/OGC interface guidelines, to Earth Observation metadata. The FedEO service periodically ingests the latest CCI Open Data Portal catalogue of all CCI datasets.

https://radiantearth.github.io/stac-browser/#/external/fedeo.ceos.org/series/eo:organisationName/CEDA

ESA Data Discovery Portal

The ESA Data Discovery Portal crawls publicly available metadata of ESA datasets and indexes the metadata, providing a unified view of all ESA data holdings including in a machine-readable way so it can be processed by search engines that index structured data.
https://data.esa.int/


Toolbox

Welcome to the CCI Toolbox!

The Toolbox is a python package that provides access and operations to CCI data.

It is available on GitHub and can be installed with Conda and PyPi.

Accessing CCI Data

The CCI Toolbox provides access to the datasets from the various CCI projects. It provides functionality to search for specific datasets, to describe its metadata, and to load it into an appropriate data representation, defined by Python packages xarray and geopandas.

The CCI Data is provided in three different formats which are handled by three different data stores, based on the xcube store framework:

- The CCI Open Data Portal Store(esa-cci) provides the most comprehensive access

- The CCI Zarr Data Store (esa-cci-zarr) accesses datasets that have been converted to the Zarr format for faster access. Applicable to selected datasets.

- The CCI Kerchunk Data Store (esa-cci-kc) provides Zarr views on datasets provided as collections of datasets, thereby establishing a very good compromise on the completeness of the ODP Store and the Zarr Store

Operations

The CCI Toolbox provides climate analyses operations geared to CCI data for coregistration, resampling, spatial and temporal subsetting, time series extraction, outlier detection, merging, normalising, spatial adjustment, temporal adjustment, and providing the means for operation registration. In addition, the Python packages xarray, pandas, and geopandas provide a rich and powerful low-level data processing interface for datasets opened through the CCI Toolbox. See the API reference for details.

Quick Start

The Toolbox documentation has a dedicated quick start section which provides Jupyter Notebooks on listing and searching CCI data, subsetting CCI data, accessing Zarr format CCI data, listing the operations of the CCI Toolbox, and general operations on CCI data.

If you don't want to install the Toolbox on your local machine for now, we invite you to try the ESA CCI Jupyter Lab, where you will find the latest and maintained versions of the Toolbox, notebooks, and required software. Just register for free with your email or github account.

If you'd like to explore a specific ECV project, we've made it easy for you! We've put together helpful notebooks that give you direct access to prticular datasets.

You'll find these conveniently organised in the Examples Explorer within Jupyter Lab, ready for you to dive in and explore.

ExamplesExplorer

Quick looks are available on this website for:

  • Aerosol
  • Biomass
  • Cloud
  • Fire
  • Greenhouse Gases
  • Ice Sheets
  • Lakes
  • Land Cover
  • Land Surface Temperature
  • Ocean Colour
  • Ozone
  • Permafrost
  • Sea Ice
  • Sea Level
  • Sea Surface Salinity
  • Sea Surface Temperature
  • Snow
  • Soil Moisture
  • Vegetation
  • Water Vapour

Of course, you can also install the Toolbox on your local machine following the steps in the next section.

Installation

Method 1 - Install Conda and then run the following

$ conda create --name ect --channel conda-forge esa-climate-toolbox
$ conda activate ect

Method 2 - Or, if you already have an existing Conda environment then just run the following with the environment activated

$ conda install --channel conda-forge esa-climate-toolbox

Method 3 - Install directly from the GitHub repository as follows

$ git clone https://github.com/esa-cci/esa-climate-toolbox.git
$ cd esa-climate-toolbox
$ conda env create
$ conda activate ect
$ pip install -e .

Method 4 - Install using pip
$ pip install esa-climate-toolbox

Getting Started

Try our Jupyter Notebooks on listing and searching CCI data, subsetting CCI data, accessing Zarr format CCI data, listing the operations of the CCI Toolbox, and general operations on CCI data.

Helpdesk

For support with the CCI Toolbox, please visit our Helpdesk.


Policy & Standards


CCI Data Policy

The CCI Data Policy ensures free and open access to CCI data. The policy is available here.

CCI Data Standards

The CCI Data Standards are community-driven requirements ensuring consistent essential climate variable (ECV) data production across the CCI programme. Version 2.3 is the latest. The requirements include data production conformance to the network Common Data Form (netCDF) format, the Climate and Forecasting (CF) metadata conventions, the Attribute Convention for Data Discovery (ACDD), and Infrastructure for Spatial Information in the European Community (INSPIRE) compliant discovery metadata.

CCI Ontology

To ensure consistency where the same global attributes apply to all CCI essential climate variables (ECVs), and to avoid different terms being used for the same entity, relevant terms have been gathered in a CCI Ontology defining all CCI entities and the relationship between those entities, including CCI project, platform, sensor and institution. For example, the ontology defines common entities for the satellite platforms used across the CCI projects in their data production.


About


Established by ESA in 2008, the Climate Change Initiative (CCI) is a major science programme focused on developing global, decadal-long satellite-derived climate data records. Collectively, these data provide a major contribution to the Intergovernmental Panel on Climate Change (IPCC) assessment of the state of the climate and underpin the climate value information chain that inform effective policy, decision-making and action.

The CCI programme leverages a 40-year satellite data archive from ESA and its Member States, including current ESA missions, the Copernicus Sentinels, ESA third-party missions, and agency partners including NASA, NOAA, JAXA, and EUMETSAT. The CCI programme produces datasets for Essential Climate Variables (ECVs), critical for climate monitoring as defined by the Global Climate Observing System (GCOS) and required by the United Nations Framework Convention on Climate Change (UNFCCC) to systematically monitor the Earth system. Satellite observations form the backbone of GCOS, with two-thirds of the 55 ECVs primarily measured from space. As of January 2024, the CCI has contributed to records for 27 ECVs, marking a significant impact on understanding Earth's climate system.

CCI Open Data Portal

The CCI Open Data Portal is the data management facility of the CCI programme. It offers free, open and easy access to all CCI data via a user-friendly dashboard, a faceted search interface, OpenSearch, OPeNDAP, ESGF, WMS, WCS, HTTPS and FTP. The facility also forms part of the CEOS Federated Earth Observation Gateway (FedEO) and the ESA Data Discovery Portal.


European Space Agency
Projects News & Events Contacts Helpdesk FAQs Terms & Conditions Privacy Notice
How satisfied are you with the Climate Office website?
How could the site be improved?

Alternatively, answer our full survey here [en]!