Example notebooks

In this section, we introduce examples of using pyicon. In Introduction we cover some basics of python and pyicon. Then, we have three subsections Atmosphere, Ocean, and Ocean-Atmosphere covering the usage of pyicon specifically for the ocean and the atmosphere. In the section Plotting we show how to manage axes and grids. Finally, in the section View, we cover a pyicon specific, pyicon view, that aims to reproduce some ncview-like plotting options. A great overview of pyicon is the notebook Basic plotting of ICON data, and we recommend going through this notebook.

Introductory notebooks

In this section, you can find introduction notebooks. If you are already experienced in python, we advise you to start with Basic plotting of ICON data. For beginners, we offer a basic python introduction Welcome to a short introduction to python. If you are already experienced in python and only new to pyicon, you can start with Starter example for pyicon.

Contents:

• Welcome to a short introduction to python
• HEALPix with pyicon
• Basic plotting of ICON data
• Starter example for pyicon
• Starter example for pyicon using xarray

Atmosphere

Here you can find notebooks of examples where pyicon is used for atmosphere.

Contents:

• Example for plotting atmospheric data
• Example for converting omeage (Pa/s) into w (m/s)
• Example for calculating density from the equation of state
• Example for plotting geopotential height
• Example for plotting zonal averages of atmospheric data
• Example for plotting ERA data
• Example for plotting atmospheric data
• Example for plotting atmospheric data

Ocean

Here you can find notebooks of examples where pyicon is used for ocean.

Contents:

• Starter example for pyicon
• Starter example for pyicon using xarray
• Calculate and visualize biases of an ICON simulation
• Calculate density and velocity gradients
• Calculate density and velocity gradients
• Specify data set
• Load data
• Edges to 2D cell local (edges2cell, calc_2dlocal_from_3d)
• 3D cell to 2D local (calc_2dlocal_from_3d)
• 3D cell to edges (calc_3d_from_2dlocal, edges2cell, cell2edges)
• Derive vertical velocity from edge mass fluxes
• Tracer fluxes (edges2edges_via_cell_scalar)
• Example for plotting ICON time series data
• Calculate barotropic and meridional streamfunction
• Specify data set
• Load data
• u and v from mass_flux
• w from mass_flux
• Calculate vertical density and velocity gradients
• Evaluate simulation using zstar
• Vikram, please check

Ocean Atmposphere

Contents:

• Example for cropping the plot domain
• Example for saving data to netcdf
• Example on how to use time averaging with dask

Plotting

The following notebooks are the examples of plotting with pyicon, mainly covering how to modify axes and grids.

Contents:

• Create edges of primal and dual grid
• Global plots
• Sattelite plots
• Poloar plots
• Regional plots

View

In this section we cover pyicon view that aims to reproduce some ncview like plotting options. This allows loading an ICON data set and click through the time or depth axes. All variables within the file can be depicted, color limits can be set and the plot can be manipulated e.g. by adding Rectangles.

Contents:

• pyICON.view for cdo remapped data
• pyICON.view for R2B9 atmospheric data
• pyICON.view for NextGems with xarray/dask support
• pyICON.view for NextGems with xarray/dask from intake catalogue
• Compare two datasets
• pyICON.view for NextGems with xarray/dask from intake catalogue
• Welcome to pyICON.view
• Welcome to pyicon
• pyICON.view for SMT ocean data