Skip to content

link and Link

link(
    *plots: Trellis, on: str | Sequence[str] | None = None
) -> Link

Link plots: a selection made in one shows in all of them.

at.link(scatter, counts)                 # the same table: the same rows
at.link(by_year, by_country, on="iso")   # any tables: rows with the same "iso"

Parameters:

  • plots (Trellis, default: () ) โ€“

    Two plots or more, each in one link at most.

  • on (str | Sequence[str] | None, default: None ) โ€“

    Column(s) whose values identify a thing across the plots' tables: selecting rows selects every row sharing their values. Default: the plots draw the same table (the same object), and a selection is its rows.

Returns:

  • Link โ€“

    The link: unlink() it to set the plots apart again.

Link(
    plots: Sequence[Trellis], on: str | Sequence[str] | None
)

Plots sharing one selection: made by link().

unlink() -> None

Each plot on its own again (a plot's own brush stays; highlights go).

clear

clear() -> None

Nothing selected, in any plot of the link.