Repository navigation
Releases
Releases · mluttikh/anytrellis
anytrellis 0.6.0
Changed
- A new default look,
theme="minimal": panels without a fill, the grid as the text
colour at 10% opacity and only across y (across x too for points, or when y is a band),
an x baseline and no y axis line, strips as left-aligned semibold titles with nothing
behind them, the y title level over the plot (↑ temp), a grid's row labels level at the
right as wide as they need, no x title on a time axis unless given, and Petroff's
colour-vision-tested palette (petroff10) in place of tab10. A paged wrap's strip keeps
the panel's name whole and shows the sorted value in lighter type.theme="classic"
keeps the look before (Upgrading); images saved from
Python (save_svg,save_png) draw both looks the same as the browser. - The toolbar explains itself. What a drag does is one control of three, pan, box zoom
and select, with the one on filled; they were two toggles that left pan implied. The
icons are in the muted colour at full opacity (over 3:1 on the background), the text
colour on hover and focus, where they were faded to 45% and looked disabled. Chips beside
the toolbar say what differs from the start, "Zoomed in x", "267 of 693 marks selected",
"2 filters: 12 of 40 panels", each with its Reset or Clear (the count of a brush released
is no longer a passing notice).?or the new ? button shows the keys and mouse,
the renderer and the anytrellis version; the renderer's name no longer appears in the
plot's corner on hover. - Time axes take the nearest calendar step, as d3 does, not the next larger one, and
never fewer than two ticks: a week of data in a narrow panel is labelled every two days,
where it showed a single date; a year at six ticks is labelled every two months. - Category labels too long to sit side by side wrap onto two lines, or failing that are
set at 45 degrees (cut at 90 px), instead of being thinned out: every variety of the
barley data now shows under its bar, where two of ten did. The x axis grows to hold them,
in the browser and insave_svg/save_png. - Panels with an
aspect(banked or a number) keep their shape in full screen, in an
opened panel and in an image of a givenheight: as large as fits, narrower and centred
when the height is too low for the whole width. An opened panel is then at most 85% of
the window high (720 px in an image), and at least 320 px. Before, the height given
overrode the shape. Plots without anaspectare unchanged.
Added
- Bars along y:
bars(x="units", y="product"), with a category y and x not, draws
the bars from zero along x, stacked or dodged as upright ones are. position="fill"onbars(),area()andhist(): each stack as shares of its
total, up to 1, on an axis written in percent.points(jitter=): points spread across their category's band, up to that fraction
of its width, each row in the same place every time it is drawn.- Rules from data:
rule(targets, y="target")draws a line per row of a table, in the
panel of its facet columns' values (or every panel, without them). colormap()for number colour columns:"viridis"(the default),"cividis",
"magma","Blues","RdBu"and"PuOr", each reversed with"_r", or a list of
colours; and how the values take it,scale=:"linear","diverging"(as deep on
both sides ofmidpoint=, RdBu with red high by default),"binned"(aboutbins=
steps of round width) or"quantile"(bins=steps of as many values each). A stepped
scale's legend lists its ranges ("10–20"), written byformat(color=)when given.palette="okabe-ito"(Okabe and Ito's eight colours), andpalette=as a dict,
{"USA": "#d62728"}: those categories keep their colours in every plot, the others take
the palette's colours that are left.limits(x=, y=): an axis's range, either endNonefor the data's own
(limits(y=(0, None))); times as dates, log axes in their values. Zooming starts there
and Reset returns there.format(x=, y=, color=): d3-format strings for numbers (",.0f",".1%",".2s",
"$,.2f") and strftime strings for times ("%b %Y"), for tick labels, tooltips and a
colour legend's ends, in the page and insave_svg/save_pngalike. Both sides are
checked against d3's own output.legend(position, title=):"right"(a column right of the plot) and"none"
join"auto"and"bottom", also asTrellis(legend=);title=renames the legend.subtitle=andcaption=onTrellisandpairs: a line or two under the title,
and a note under the plot (a source, a footnote). Both wrap, and both are in exported
images, from the page and fromsave_svg/save_png.labels=, one dictionary naming columns for readers ({"mpg": "Fuel use (mpg)"}):
used for axis titles, the legend's title, tooltips, a page column's title, the sort and
filter menus, and a pairs plot's strips. Code still names columns as they are.Trellis(theme=):"minimal","framed"or"classic", also onpairs().framed,
after Observable Plot, draws a thin frame around each panel, 10 px between them, strips
centred, the x title at its axis' end (weight →) and d3's observable10 palette.anytrellis.Theme("minimal", frame=True, panel_gap=12, ...): a named theme with any of
its settings changed (panel fill, frame, grid direction and opacity, axis lines, strip
fill, alignment and weight, where the axis titles go, row labels level or on their side,
the gap between panels, the palette).anytrellis.set_theme()sets the session's
default;get_theme()reads it.palette=takes a name:"petroff10","petroff8","petroff6","observable10"or
"tab10".Trellis(aspect="bank"): the panels' shape that shows the median slope of the lines'
segments at 45 degrees, each measured in its own panel's ranges (Cleveland's banking):
thesmooth()fits' (a trend, not the noise around it), or without them theline()
layers'. Between 0.02 and 5 times as
high as wide; withload="pages", kept from the panels read first.horizon(x, y, bands=3, origin=0, step=None): a horizon chart in each panel. A series'
distance fromoriginis cut into bands of one height, laid over each other and darker
the farther, blues above the origin and reds below it, so a series shows its highs and
lows in a panel 24 px high. Every panel shares the band height (by default a round
number reaching the farthest value of any panel); the legend names each band's range,
and clicking it selects the times a series reaches it. Works withload="pages";
margins are left empty.Trellis(margins=): a grid's "(all)" panels, as ggplot2'sfacet_grid(margins = TRUE).
Trueadds an (all) row under the rows (each panel the rows of its column) and an (all)
column right of the columns (each panel the rows of its row), with a corner of every
row;"row"or"col"adds one. Every layer draws them, summaries computed from their
rows; a row selected in a margin is selected once. Withempty="blank"andpage=;
not withload="pages"or a wrap.share_x="sliced"/share_y="sliced"(also inshare()): each panel its own range,
about its own data, every one as wide as the widest, so a change of 5 looks the same size
in every panel (lattice'srelation="sliced"). Zooming one panel zooms all to its width,
each about its own centre; panning moves one; fitting y keeps them as wide. Bars keep
their base at 0. Withload="pages", the widths come from every panel's range in the
database. Not on an axis of categories.
Fixed
- Lines, areas and bands drawn in other panels than their own (a margin's, or with
facet="all"or"exclude") no longer join the rows of several panels into one line
zigzagging between them: each panel's rows stay a line of their own.
anytrellis 0.5.0
Added
Trellis.as_category("column"): a number column read as categories. Its distinct values
are the levels, in order (-10, -2, 3), labelled as numbers (4, not4.0), rows
without one last as(missing): a colour per value from the palette with a legend, a
band per value on an axis, a series per value withgroup=, andorder()with numbers.
Withload="pages", the database finds the values and selects by them.
Fixed
- Panel backgrounds, gridlines, strips and axes no longer vanish when the window is
resized. A resized plot is drawn again at once instead of a frame later, and a plot
whose height brings a page scrollbar at one width and not 17 px narrower (Windows) no
longer flips between the two widths every frame, blank each time: it keeps the narrower.
anytrellis 0.4.0
Added
Trellis(strips=):"nested"(the default) or"joined". With several facet columns,
nested strips give each column a strip, the first outermost, spanning the panels next
to each other that share its level (as ggh4x's in R): stacked on top of a grid's columns
and a wrap's panels, side by side on the right of a grid's rows. Saved images draw them
too.Trellis(empty="blank"): a grid's cells without data are left out, and the other
panels keep their rows and columns, with axes drawn into the blank cells beside them.
The default,"draw", keeps the empty panels. Withpage=, a cell is left out when
it has no data on any page, so every page has the same cells.Trellis(strip_label=): a column whose value names each panel (one value per panel),
in a strip of the panel's own, in a grid too, in place of the row, column and nested
strips. A panel without a value is named by its levels; panel names inpanels()and
open()stay the levels. Withload="pages", the database gives the labels with the
panels.
Changed
- A plot faceted by several columns (
wrap=["a", "b"],col=[...],row=[...]) now
shows nested strips, not one strip per panel naming the levels together ("a · b");
strips="joined"shows those. Panel names inpanels()andopen()are unchanged. See
Upgrading.
Fixed
- A panel's last x label no longer runs into the y labels or the strip of the panel below
and right of it, when both draw into the empty cell between them ("10" over "4").
anytrellis 0.3.0
Added
Trellis(page=): a page per level of a column (or columns). A grid (row=,col=)
shows each level's every cell, in the same place on every page; a wrap shows the level's
panels, sorted and filtered within it, on several pages withrows=when there are more
than fit. The pager names the page shown and lists the levels to pick from;
show_page("north")andpage_namesdo the same from Python.share_x="page"and
share_y="page"give each page its own scale. Withload="pages", a level's rows are
read as its page is turned to.pairs(): a scatterplot matrix of a table's number columns, x by column and y by row,
each variable's scale shared along its column and its row. The diagonal shows each
variable alone (a density curve per colour, or a stacked histogram) over its own range.
Brushing a panel lights up its rows in every panel;selected()gives them as rows of
the table, and hovering a point shows its row.corner=Truekeeps each pair once.Trellis(aspect=): each panel's height as a multiple of its width (1: square).- Lazy tables and databases: a Polars
LazyFrame, a DuckDB relation or an Ibis table (on
any database Ibis queries) is read in one query, with only the columns the plot uses,
when the plot is first drawn. The database computes the panels' summaries: the pages'
statistics (rows, mean, median, min, max, sd) andorder()'s summaries; the trend comes
from the rows without sorting them. Ten million rows in 1,000 panels build in 3.3 s
rather than 5.3 s from Ibis on DuckDB (3.2 s rather than 6.6 s from aLazyFrame). Trellis(load="pages"): a paged wrap of a lazy table (DuckDB, Ibis, aLazyFrame) reads
only the rows of the panels of the page shown and the pages either side of it, and the
next ones as the pages turn. The panels, their statistics (with the trend), each panel's
range of x and y, the category levels and the colour ranges come from the database, so
every page looks as with every row read. Ten million rows in 1,000 panels from DuckDB
are drawn in 1.0 s from 480,000 rows read (3.9 s reading all of them); a page turned
reads only the page that came near and makes only its panels' lines and points, keeping
the others', in 0.2 s.selected()is a query of the selected
rows; a saved page reads every row of the lines, points and text.- Summaries with
load="pages":hist,box,violin,density,smoothand
errorbarof the plot's data are computed by the database, every panel's at once, and
no row is read: bin counts, quartiles and whiskers, means and spreads, sums of squares,
and values in fine bins for densities, violins and loess fits (drawn from the bins, to
within about 0.03%). The axes are every panel's from the start, and pages turn without
asking again. A brush over a summary selects the rows it stands for, as a query. Ten
million rows in 1,000 panels: a histogram in 0.8 s (3.2 s reading every row), a loess
fit in 3.6 s (22 s). - Linking with
load="pages":link=selects the rows sharing the brushed rows' keys in
every panel, as a query.anytrellis.link(..., on=)links a plot reading pages to any
other: its selection is read as the keys chosen, and a selection elsewhere lights up the
rows of the pages read and fills its summaries to the share of the keys chosen, which
the database counts in a query per summary (0.2 s for 4,000 of 5,000 keys over ten
million rows). A link of a plot reading pages needson=. - Paged wraps send only the panels near the page shown: in a notebook, the browser gets
the data of the page shown and the pages either side of it, and more as the pages turn,
are sorted or filtered, or a panel of another page opens; a page further away says it
is loading until its data comes. A thousand panels of a week's readings start with
2.2 MB instead of 46 MB. A page fromsave_htmlorto_htmlstill holds every panel. - Level of detail: what goes to the browser grows with the pixels shown, not the rows. A
panel of more than 20,000 points of a line sends each series thinned (M4: per column,
its first, last, lowest and highest point), and a panel of more than 100,000 points is
drawn as cells, each in its points' colours mixed in proportion and more opaque the more
it holds; hovering one tells its points, of each colour. Zoomed in, in a notebook, Python
sends the panels shown in more detail: a line at two columns a pixel, finer cells, or
the points again. Four million points send about 1 MB instead of 128 MB, and their
save_htmlpage shrinks from 171 MB to 1.4 MB. Selections still use every row;
save_pngandsave_svgdraw the detail shown; a saved page shows the plot as it
starts.
Changed
- A lazy table (a Polars
LazyFrame, a DuckDB relation, an Ibis table) is read when the
plot is first drawn, with only the columns it uses, not collected whole when the plot
is made. A panel of more than 20,000 points of a line or 100,000 points shows them at
the level of detail its pixels need (see Added); zoom in for more. No code changes. See
Upgrading. - Faster selections over linked rows (
link=): number and category link columns are
keyed from their values and codes, not their text; and dense points' cells are counted
and grouped without sorting their points. - Faster plots of many rows in panels: rows find their panel by their column's codes, not
their text, and numbers as panels are labelled once per value, not once per row. Four
million rows of a line in four panels build in 1.2 s instead of 2.2 s (by a column of
numbers: 1 s instead of 4.2 s), and in 1,000 panels ordered by a median, with statistics
to sort pages by, in 3.5 s instead of 93 s. - Text columns are encoded by PyArrow when it is installed, not labelled row by row in
Python: ten million rows of text facets read in 0.15 s instead of 4 s. A Polars
DataFrameof ten million rows in 1,000 panels builds in 4.2 s instead of 6.1 s. - Rects edge to edge (heatmap tiles, cells) show no seams between them in Canvas 2D, the
browser's image export,save_pngandsave_svg: their edges fall on whole pixels.
anytrellis 0.2.0
Added
- Export images of a plot (toolbar button, or
e): copy a PNG, or an SVG with a PNG beside
it, to the clipboard; download a PNG (twice the screen's size) or an SVG; or, in a
notebook, save either next to the notebook without overwriting. The image is the plot as
shown (zoom, selection, opened panel, theme), without the toolbar. It works in pages
saved withsave_htmltoo. Trellis.save_pngandTrellis.save_svg: the same image drawn in Python, without a
browser (scripts, reports, CI): the zoom last shown in the notebook, the selection, a
linked plot's highlight and an opened panel, in the light or dark theme, at any size.
PNGs need the newpngextra (pip install "anytrellis[png]", with resvg-py).- Pages of panels: a wrap of more than 100 panels shows them a page at a time (6 by 4;
Trellis(rows=, cols=)sets the page,rows="all"turns paging off), with a bar to turn
the pages (also Page Up and Page Down), sort the panels by a statistic of each and filter
them by name and by statistics' ranges. The statistics are computed in Python: rows, and
the mean, median, min, max, sd and trend of the values drawn, plus any columns given with
panel_stats(). From Python:sort_panels(),filter_panels(),show_page(),
shown_panels(),stats(),page,pagesandpaging. An opened panel steps through
the panels as sorted and filtered; images and saved pages show the page shown. violin(): each group's values as a violin (a kernel density mirrored around its
position), with its median and quartiles, or its values as points (inner=). Scaled to
the same area, by count or to the same width (scale=); side by side with a colour,
sideways when y is the category. Brushing selects whole violins.errorbar(): each group's mean with its confidence interval (extent="ci", at
level=), standard error, standard deviation or range, with caps and a point at the
mean; or intervals you computed, fromymin=/ymax=(orxmin=/xmax=, sideways).line(step=...): step lines,"post","pre"or"mid". Hovering a step shows the
row it starts from.- Documentation at mluttikh.github.io/anytrellis:
tutorials, how-to guides, a gallery, the API reference and explanations, with live plots.
Changed
- A wrap of more than 100 panels now shows them a page at a time (it drew them all, small);
Trellis(..., rows="all")draws them all as before. See
Upgrading. - A page of many plots (
standalone.js) starts each plot as it scrolls near, so a long
page stays within the browser's limit of GPU contexts.
Fixed
- Tooltips on documentation sites (Material, Zensical) are as compact as in a notebook:
the site's table styles no longer reach them, nor its letter spacing the plot. - A linked plot's highlight of part of a histogram's bars draws the faded bars whole, with
the selected share solid from their base (the faded part was missing). - x labels of neighbouring panels no longer run together at their edges ("AprMar"): a
label that would reach the next panel's first is left out. - Box plots failed in WebAssembly (marimo's in-browser notebooks, Pyodide), where indices
are 32-bit. - A plot now redraws when the page switches between light and dark by
data-md-color-scheme(Material and Zensical sites).
anytrellis 0.1.0
The first release.
Added
Trellis: one panel per level of the facet columns: a wrap (wrap=,cols=) or a
grid (row=,col=) that keeps empty cells, with shared, per-row, per-column or free
scales (share_x=,share_y=), linear or log (x_scale=,y_scale=).- Marks:
line,points,bars(stacked or dodged),area,band,rect,text,
rule, and summaries computed per panel in Python:hist,box,densityandsmooth
(loess or linear, with a confidence band). - Data from Polars, pandas, PyArrow or DuckDB (through narwhals), or a dict of arrays;
numbers, times and categories, with category colours and legends. - Drawing with WebGPU, WebGL2 or Canvas 2D, whichever the browser has; the data goes to the
browser once, as binary buffers, so millions of marks stay interactive. - Zooming and panning (scroll, drag, one axis, box zoom), panels that share a scale
zooming together,fit_yto fit y to the data in view, undo and reset; one panel at a
time (open,close) and full screen. - Selecting: a brush (
s) in every panel or, withlink=, in one panel and followed by
key;select(),selectionandselected()from Python. Clicking legend entries
selects their colours. - Linked plots:
link(a, b, ..., on=)shares one selection between plots, histograms
filling to their selected share (crossfiltering). - Tooltips with Python's values;
save_htmlwrites a page that opens without Python. - Works in JupyterLab and marimo, and other anywidget hosts (Jupyter Notebook, VS Code).
anytrellis.datasets.load: six small example datasets, with their sources and licences
indatasets/SOURCES.md; example notebooks for Jupyter and marimo.