gsplot.style.legend#

Deprecated forwarding shim for gsplot.style.legend.

Functions

legend(target, *[, handles, labels, ...])

Create publication legends on one or more explicit Axes.

legend_axes(*[, replace])

Adapt current-figure legend creation to gsplot.legends().

legend_get_handlers(ax)

Adapt legacy legend extraction to immutable legend_entries().

legend_handlers(ax[, handles, labels, handlers])

Adapt legacy handler arguments to the local canonical legend map.

legend_reverse(ax[, handles, labels, handlers])

Adapt legacy reversed legend construction to reverse=True.
legend(target, *, handles=None, labels=None, handler_map=None, loc='best', frameon=False, fancybox=False, labelspacing=0.3, handlelength=None, reverse=False, replace=False, props=None, **kwargs)#

Create publication legends on one or more explicit Axes.

Parameters:

  • target (Axes | _AxesBase | Sequence[Axes | _AxesBase] | Mapping[Any, Axes | _AxesBase] | ndarray[tuple[int, ...], dtype[Any]]) – One Axes or a deterministic same-Figure collection of Axes.

  • handles (Sequence[Artist] | Mapping[object, Sequence[Artist]] | None) – Optional matched entries. Multi-target explicit entries require exact target-key mappings; otherwise Matplotlib discovery is used.

  • labels (Sequence[str] | Mapping[object, Sequence[str]] | None) – Optional matched entries. Multi-target explicit entries require exact target-key mappings; otherwise Matplotlib discovery is used.

  • handler_map (Mapping[object, HandlerBase] | None) – Optional local handler mapping; it never changes Matplotlib defaults.

  • loc (str | int) – Direct publication controls. Defaults are "best", False, False, 0.3, and None respectively.

  • frameon (bool) – Direct publication controls. Defaults are "best", False, False, 0.3, and None respectively.

  • fancybox (bool) – Direct publication controls. Defaults are "best", False, False, 0.3, and None respectively.

  • labelspacing (float) – Direct publication controls. Defaults are "best", False, False, 0.3, and None respectively.

  • handlelength (float | None) – Direct publication controls. Defaults are "best", False, False, 0.3, and None respectively.

  • reverse (bool) – Reverse each selected entry sequence before construction.

  • replace (bool) – Remove existing legends only when explicitly set to True.

  • props (Mapping[str, object] | None) – Finite Matplotlib Legend constructor properties.

  • **kwargs (Any) – Optional direct Matplotlib Legend constructor properties (e.g. fontsize, title, framealpha). Direct keyword arguments are merged with and take precedence over props.

Returns:

Native Legends in normalized target order. Collection targets skip Axes that have no discovered entries.

Return type:

matplotlib.legend.Legend or tuple of Legend

Raises:

LayoutError – If entries, controls, target, handlers, or properties are invalid.

Examples

>>> import gsplot as gs
>>> figure, ax = gs.subplots()
>>> gs.line(ax, [0, 1], [0, 1], props={"label": "signal"})
[<matplotlib.lines.Line2D object ...>]
>>> item = gs.legend(ax, handlelength=3)
>>> item.axes is ax
True
>>> figure.clear()
legend_axes(*, replace=False, **props)#

Adapt current-figure legend creation to gsplot.legends().

Parameters:

  • replace (bool)

  • props (Any)

Return type:

list[Any]

legend_get_handlers(ax)#

Adapt legacy legend extraction to immutable legend_entries().

Parameters:

ax (Axes)

Return type:

tuple[Any, tuple[str, …], dict[Any, Any]]

legend_handlers(ax, handles=None, labels=None, handlers=None, **props)#

Adapt legacy handler arguments to the local canonical legend map.

Parameters:

  • ax (Axes)

  • handles (Sequence[Any] | None)

  • labels (Sequence[str] | None)

  • handlers (Mapping[Any, Any] | None)

  • props (Any)

Return type:

Any

legend_reverse(ax, handles=None, labels=None, handlers=None, **props)#

Adapt legacy reversed legend construction to reverse=True.

Parameters:

  • ax (Axes)

  • handles (Sequence[Any] | None)

  • labels (Sequence[str] | None)

  • handlers (Mapping[Any, Any] | None)

  • props (Any)

Return type:

Any