new_map

Maps.new_map(ax=None, keep_on_top=False, inherit_data=False, inherit_classification=False, inherit_shape=False, **kwargs)

Create a new map that shares the figure with this Maps-object.

Note

Using this function, for example:

>>> m = Maps(ax=211)
>>> m2 = m.new_map(ax=212, ...)

is equivalent to:

>>> m = Maps(ax=211)
>>> m2 = Maps(f=m.f, ax=212, ...)
Parameters:

  • ax (int, list, tuple, matplotlib.Axes, matplotlib.gridspec.SubplotSpec or None) –

    Explicitly specify the position of the axes or use already existing axes.

    Possible values are:

    • None:

      Initialize a new axes at the center of the figure (the default)

    • A tuple of 4 floats (left, bottom, width, height)

      The absolute position of the axis in relative figure-coordinates (e.g. in the range [0 , 1]) NOTE: since the axis-size is dependent on the plot-extent, the size of the map will be adjusted to fit in the provided bounding-box.

    • A tuple of 3 integers (nrows, ncols, index)

      The map will be positioned at the index position of a grid with nrows rows and ncols columns. index starts at 1 in the upper left corner and increases to the right. index can also be a two-tuple specifying the (first, last) indices (1-based, and including last) of the subplot, e.g., ax = (3, 1, (1, 2)) makes a map that spans the upper 2/3 of the figure.

    • A 3-digit integer

      Same as using a tuple of three single-digit integers. (e.g. 111 is the same as (1, 1, 1) )

    • matplotilb.gridspec.SubplotSpec:

      Use the SubplotSpec for initializing the axes.

    • matplotilb.Axes:

      Directly use the provided figure and axes instances for plotting. NOTE: The axes MUST be a geo-axes with m.crs_plot projection!

  • keep_on_top (bool) – If True, this map will be drawn on top of all other axes. (e.g. similar to InsetMaps) The default is False.

  • preferred_wms_service (str, optional) – Set the preferred way for accessing WebMap services if both WMS and WMTS capabilities are possible. The default is β€œwms”

  • inherit_data (bool) –

    Indicator if the corresponding properties should be inherited from the parent Maps-object.

    By default only the shape is inherited.

    For more details, see Maps.inherit_data() and Maps.inherit_classification()

  • inherit_classification (bool) –

    Indicator if the corresponding properties should be inherited from the parent Maps-object.

    By default only the shape is inherited.

    For more details, see Maps.inherit_data() and Maps.inherit_classification()

  • inherit_shape (bool) –

    Indicator if the corresponding properties should be inherited from the parent Maps-object.

    By default only the shape is inherited.

    For more details, see Maps.inherit_data() and Maps.inherit_classification()

  • kwargs – additional kwargs are passed to matplotlib.pyplot.figure() - e.g. figsize=(10,5)

Returns:

m – The Maps object representing the new map.

Return type:

EOmaps.Maps