regionmask.Regions.plot_regions

Regions.plot_regions(ax=None, regions=None, add_label=True, label='number', line_kws=None, text_kws=None, subsample=None, label_multipolygon='largest', tolerance='auto')

plot map with with srex regions

Parameters

• ax (axes handle, optional) – If given, uses existing axes. If not given, uses the current axes or creates new axes. In contrast to plot this does not create a cartopy axes.

• regions (list of int or str | ‘all’, default: “all”) – Deprecated - subset regions before plotting, i.e. use r[regions].plot() instead of r.plot(regions=regions). Select the regions (by number, abbrev or name, can be mixed) that should be drawn.

• add_label (bool) – If true labels the regions. Optional, default True.

• label (‘number’ | ‘name’ | ‘abbrev’, optional) – If ‘number’ labels the regions with numbers, if ‘name’ uses the long name of the regions, if ‘short_name’ uses abbreviations of the regions. Default ‘number’.

• line_kws (dict, optional) – Arguments passed to plot.

• text_kws (dict, optional) – Arguments passed to the labels (ax.text).

• subsample (None or bool, optional) – Deprecated, use tolerance.

• label_multipolygon (‘largest’ | ‘all’, optional) – If ‘largest’ only adds a text label for the largest Polygon of a MultiPolygon. If ‘all’ adds text labels to all of them. Default: ‘largest’.

• tolerance (None | ‘auto’ | float, default: ‘auto’.) – Maximum length of drawn line segments. Can lead to better looking plots on certain maps.

  • None: draw original coordinates

  • float > 0: the maximum (euclidean) length of each line segment.

  • ‘auto’: None if a matplotlib axes is passed. If a cartopy GeoAxes is passed the tolerance is automatically determined based on the log10 of the largest absolute coordinate. Defaults to 1 for lat/ lon coordinates.

Returns

ax (axes handle)