HMPlot

LinkViews

Makes 2D plots pan and zoom together, over one shared domain.

Scatter plot of y against x. x from 0.9 to 4.1, y from 0.9 to 4.1. 4 points. Line chart of y against x. x from 0.9 to 4.1, y from 0.9 to 4.1. 4 rows.

Static preview; loading the interactive plot

import hmplot as hm

data = {"x": [1, 2, 3, 4], "y": [3, 1, 4, 2]}
with hm.Scene() as scene:
    with hm.Plot(data=data, height=300, axes2d=True) as top:
        hm.Points(x="x", y="y")
    with hm.Plot(data=data, height=300, axes2d=True) as bottom:
        hm.Line(x="x", y="y")
    hm.LinkViews(top, bottom)
scene

Options

Keywords are snake_case.

axes"x" | "y" | "xy"
Which axes follow when one of the plots pans or zooms. The plots are given positionally: hm.LinkViews(first, second). Default: "xy".
scales"shared" | "free"
"shared" shows one domain on the linked axes, the union of the plots' domains (their data, or an explicit domain), so the same value lines up in each; "free" keeps each plot's own. A plot's explicit domain is kept either way. Default: "shared".

Usage

Pass the Plot handles positionally: hm.LinkViews(first, second, axes=‘x’). Links compatible 2D dimensions with feedback suppression; 3D cameras remain independent.

The linked axes share one domain: the union of the plots’ domains (each one’s data, or its explicit domain), so a value lines up in every plot and panning or zooming one moves the others over the same range. Stacked panels whose data end at different dates, or whose labels pad their ends differently, still align. A plot with an explicit domain keeps it, so it lines up with the others only where its domain is theirs; a plot whose marks draw nothing takes the others’ domain. A plot can be in several LinkViews (one on x, another on y): each shares the domains of its own plots, as it links their views. scales="free" keeps each plot’s own domain.

A domain can be dates: x={"domain": [datetime.date(2024, 1, 1), datetime.date(2024, 3, 1)]} (or datetime64) draws a time axis over those days.

Related examples

Linked views & minimap