easyclimate.plot.icon.plot_cell_contour¶

easyclimate.plot.icon.plot_cell_contour(ds, da, *, ax=None, lon_min=None, lon_max=None, lat_min=None, lat_max=None, auto_extent=True, extent_margin=0.05, contour_margin=0.05, global_plot=False, center_lon=None, levels=10, colors=None, linewidths=0.8, linestyles=None, cmap=None, vmin=None, vmax=None, symmetric=False, percentile=98, extend=None, max_triangle_edge=None, input_radians=True, transform=None, title=None, lon_name_cell='clon', lat_name_cell='clat', use_triangulation_cache=True)¶

Draw contour lines for ICON cell-centered scalar data.

Labels are not added automatically. Add them outside this function with ax.clabel(cs, inline=True, fontsize=8, fmt="%g").

Parameters¶

dsxarray.Dataset: ICON dataset containing cell coordinate variables.
daxarray.DataArray or numpy.ndarray: Cell-centered scalar values. The data must be one-dimensional on ncells after any time or vertical-level selection.
axmatplotlib.axes.Axes, optional: Axes on which to draw. By default, use the current axes.
lon_min, lon_max, lat_min, lat_maxfloat, optional: Plot extent in degrees. Cross-dateline longitude windows are supported.
auto_extentbool, default: True: If True and no explicit extent is supplied, infer the extent from valid cell centers.
extent_marginfloat, default: 0.05: Fractional margin added to the automatically inferred extent.
contour_marginfloat, default: 0.05: Fractional padding used when selecting source cells for contouring.
global_plotbool, default: False: If True, draw a global extent centered on center_lon.
center_lonfloat, optional: Longitude center used for wrapping. If None, infer it from the extent or valid cell centers.
levelsint or array-like, default: 10: Number of contour levels, or explicit level values.
colorscolor or collections.abc.Sequence of colors, optional: Fixed line colors passed to Axes.tricontour. If omitted, use cmap.
linewidths, linestyles: Contour line style options passed to Axes.tricontour.
cmapstr or matplotlib.colors.Colormap, optional: Colormap used when colors is not supplied.
vmin, vmaxfloat, optional: Data limits used by contour levels and color mapping.
symmetricbool, default: False: If True, infer symmetric limits around zero when vmin or vmax is omitted.
percentilefloat, default: 98: Percentile used for automatic data-limit inference.
extend{“neither”, “both”, “min”, “max”}, optional: Contour extension mode. If None, infer it from data and levels.
max_triangle_edgefloat, optional: Maximum accepted edge length for triangles. Longer triangles are masked.
input_radiansbool, default: True: If True, ICON longitude and latitude variables are interpreted as radians and converted to degrees.
transformcartopy.crs.CRS, optional: Coordinate reference system of the input coordinates for Cartopy axes.
titlestr, optional: Axes title. If None, use the data long name.
lon_name_cell, lat_name_cellstr: ICON cell coordinate variable names.
use_triangulation_cachebool, default: True: If True, cache the triangulation for repeated calls on the same mesh and extent.

Returns¶

matplotlib.contour.QuadContourSet: Contour set returned by Axes.tricontour.

ICON Cell-centered contour plots