regionmask.Regions.plot_regions
- Regions.plot_regions(*, ax: Axes_or_GeoAxes | None = None, add_label: bool = True, label: Literal['number', 'name', 'abbrev'] = 'number', line_kws: dict[str, Any] | None = None, text_kws: dict[str, Any] | None = None, label_multipolygon: Literal['largest', 'all'] = 'largest', tolerance: Literal['auto'] | float | None = 'auto') Axes_or_GeoAxes
plot regions on regular axes
- Parameters:
- axaxes handle, optional
If given, uses existing axes. If not given, uses the current axes or creates new axes. In contrast to
Regions.plot
this does not create a cartopy axes.- add_labelbool, default: True
If True labels the regions.
- label‘number’ | ‘name’ | ‘abbrev’, default: ‘number’
If ‘number’ labels the regions with numbers, if ‘name’ uses the long name of the regions, if ‘abbrev’ uses abbreviations of the regions. Default ‘number’.
- line_kwsdict, optional
Arguments passed to plot.
- text_kwsdict, optional
Arguments passed to the labels (ax.text).
- label_multipolygon‘largest’ | ‘all’, default: ‘largest’
If ‘largest’ only adds a text label for the largest Polygon of a MultiPolygon. If ‘all’ adds text labels to all of them.
- toleranceNone | ‘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:
- axaxes handle