ICOS Carbon Portal Jupyter Services

Welcome to the user documentation for the ICOS Carbon Portal Jupyter services.

ICOS and the ICOS Carbon Portal

The Integrated Carbon Observation System ICOS is a European research infrastructure that measures, stores, and disseminates standardised, high-quality, long-term observations of greenhouse gas concentrations in the atmosphere and carbon fluxes between the atmosphere, land, and oceans. The ICOS station network consists of approximately 180 stations across Europe, organised into three domains: Atmosphere, Ecosystem, and Ocean.

The ICOS Carbon Portal is the data centre of ICOS. It is responsible for storing and disseminating ICOS data and for providing services that help researchers, policy makers, and the general public access and use those data.

Virtual Research Environments based on Jupyter are one part of these services.

What is Jupyter?

Jupyter is a Virtual Research Environment (VRE) for interactive computing and sharing computational work. In a Jupyter environment, users can:

  • Create directories
  • Upload data, such as CSV, TXT, NetCDF, HDF, TIFF, GeoTIFF, PNG, and JPEG files
  • Create Python code files (.py)
  • Create and work with Jupyter Notebook files (.ipynb)
  • Combine code, output, visualisations, equations, links, and explanatory text in one document

The ICOS Jupyter service is based on the official quay.io/jupyter/datascience-notebook Docker image. Python, Julia, and R kernels are available. Julia and R are provided as standard components of the environment, while the ICOS Carbon Portal currently provides technical support for Python.

Jupyter Notebooks

Jupyter notebooks are interactive documents that combine code, text, equations, figures, and results in one place. They are commonly used for scientific analysis, data exploration, teaching, reproducible research and sharing scientific workflows.

ICOS Carbon Portal Jupyter Services

The ICOS Carbon Portal provides two Jupyter-based services:

  • ExploreData – a public environment for exploring example notebooks and ICOS data.
  • Collaborative Jupyter Hub – a persistent workspace for users and project groups working with ICOS data.

Where should I start?

If you are new to Jupyter notebooks, start with Your First Notebook.

If you want to explore public ICOS notebooks, see the ExploreData user guide.

If you have a personal account on the collaborative platform, see the Collaborative Jupyter Hub user guide.

If you are working with other users in a shared project area or want to install additional Python packages, see the How-to guides.

Access to notebooks and documentation

Openly available ICOS notebooks and supporting documentation are available through the ICOS Carbon Portal Jupyter repository on [GitHub].

Support

For technical questions, account issues, project administration requests, or notebook problems, contact:

jupyter-info@icos-ri.eu