easyclimate.plot.icon.plot_cell_contourf¶

easyclimate.plot.icon.plot_cell_contourf(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, cmap=None, vmin=None, vmax=None, symmetric=False, percentile=98, extend=None, max_triangle_edge=None, input_radians=True, transform=None, add_colorbar=True, cbar_kwargs=None, title=None, lon_name_cell='clon', lat_name_cell='clat', use_triangulation_cache=True)¶

Draw filled contour for ICON cell-centered scalar data.

The scalar values are drawn from ICON cell centers using matplotlib.tri.Triangulation.

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.
cmapstr or matplotlib.colors.Colormap, optional: Colormap used for filled contours.
vmin, vmaxfloat, optional: Color/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: Colorbar 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.
add_colorbarbool, default: True: If True, add a colorbar for the filled contour set.
cbar_kwargsdict, optional: Keyword arguments passed to Figure.colorbar.
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: Filled contour set returned by Axes.tricontourf.

ICON Cell-centered contour plots