earthkit.plots.load_style

earthkit.plots.load_style(name, **kwargs)[source]

Load a named style by its user-facing name.

Style names are defined in the name field of each style variant in the auto-styles YAML files (e.g. temperature-2m-turbo-celsius). The full list of available names can be retrieved with list_styles().

Parameters:
  • name (str) – The name of the style to load, as shown in the styles gallery.

  • **kwargs – Additional keyword arguments passed to the Style constructor, allowing individual parameters to be overridden.

Returns:

The instantiated style object.

Return type:

earthkit.plots.styles.Style

Raises:

KeyError – If no style with the given name is found in any registered style library.

Examples

>>> import earthkit.plots
>>> style = earthkit.plots.styles.load_style("temperature-2m-turbo-celsius")
>>> chart.contourf(data, style=style)