ParallelCoordinates API

Bases: AnyWidget

Interactive parallel coordinates plot powered by HiPlot.

Wraps Facebook Research's HiPlot library to provide brush filtering on axes, axis reordering via drag, and coloring lines by a selected dimension -- all inside a notebook widget.

Parameters:

Name	Type	Description	Default
data		Dataset as a list of dictionaries, pandas DataFrame, or polars DataFrame. Each row becomes one polyline in the chart.	None
color_by	str	Column name used to color lines. Leave empty for a single default color.	''
height	int	Widget height in pixels.	600
width	int	Widget width in pixels. Set to 0 for container width.	0

Examples:

from wigglystuff import ParallelCoordinates
import polars as pl

df = pl.DataFrame({
    "x": [1, 2, 3, 4, 5],
    "y": [5, 4, 3, 2, 1],
    "label": ["a", "a", "b", "b", "b"],
})
widget = ParallelCoordinates(df, color_by="label")
widget

Create a ParallelCoordinates widget.

Parameters:

Name	Type	Description	Default
data		Dataset as a list of dicts, pandas DataFrame, or polars DataFrame. Each dict/row is one data point.	None
color_by	str	Column name to color lines by. Empty string for uniform color.	''
height	int	Widget height in pixels.	600
width	int	Widget width in pixels. Set to 0 for container width.	0

Source code in wigglystuff/parallel_coords.py

def __init__(
    self,
    data=None,
    *,
    color_by: str = "",
    height: int = 600,
    width: int = 0,
) -> None:
    """Create a ParallelCoordinates widget.

    Args:
        data: Dataset as a list of dicts, pandas DataFrame, or polars
            DataFrame. Each dict/row is one data point.
        color_by: Column name to color lines by. Empty string for uniform
            color.
        height: Widget height in pixels.
        width: Widget width in pixels. Set to 0 for container width.
    """
    records = _to_records(data)
    filtered_indices = list(range(len(records)))
    super().__init__(
        data=records,
        color_by=color_by,
        height=height,
        width=width,
        filtered_indices=filtered_indices,
        selected_indices=[],
    )

filtered_as_pandas property

filtered_as_pandas

Return filtered data as a :class:pandas.DataFrame.

filtered_as_polars property

filtered_as_polars

Return filtered data as a :class:polars.DataFrame.

filtered_data property

filtered_data: list[dict]

Return the subset of data rows passing all brush filters.

selected_data property

selected_data: list[dict]

Return the subset of data rows that are selected.

Synced traitlets

Traitlet	Type	Notes
data	list[dict]	Input rows rendered as polylines.
color_by	str	Column used for line coloring.
height	int	Plot height in pixels.
filtered_indices	list[int]	Indices currently passing filters/selection.
selected_indices	list[int]	Indices currently selected in the active brush.