add_wordmarks

add_wordmarks(target: Any, *args: Any, **kwargs: Any) -> Any

Add team wordmarks to a plot or table of any supported library.

Routes to the adapter for target's library (matplotlib, plotnine, Plotly, Altair, great_tables, ...) and returns the object that was drawn on: target itself when the library mutates in place, a new object otherwise. Every adapter takes the same arguments.

Arguments

Name	Description
target	The plot or table object. Its type picks the adapter.
*args	Passed to the adapter. By convention x, y (positions in the target's own coordinates) and teams (the team values to draw), in that order.
**kwargs	Passed to the adapter: league (the SDV league key), season (one season or one per team), height (the mark's height as a fraction of the plot height), alpha (opacity, 0 to 1) and variant (a mark variant, as in logo_url).

Returns

object — The drawn-on plot or table: target itself, or the new object the adapter built.

Raises

• UnsupportedTargetError: If no adapter is registered for target's library.
• OptionalDependencyError: If the adapter's optional extra is not installed.

Example

import matplotlib.pyplot as plt
import sdvplot

fig, ax = plt.subplots()
sdvplot.add_wordmarks(ax, [0.5], [0.5], ["KC"], league="nfl", height=0.1)

See also

• sdvplotR
• sdv-py