Changelog
v5.6.3 (2026-11-19)
Bug Fixes
Draw matplotlib’s named line styles and warn on undrawable ones (
035fc06)Give scatter() matplotlib’s marker=None default (
e539380)Keep a dN line with unmodelled qualifiers as raw GLE (
22be88c)Keep a stored colour equal across a to_dict JSON round trip (#273,
18d9132)Keep raised columns from zeroing values and cover heatmap extents and log limits (#250,
db845de)Keep view()’s output for every format and tolerate locked work files (
7bb2d3e)Map named line styles in contour and keep (offset, None) solid (
fee1164)Model the series and report what is dropped where a raw dN line would break (#165,
323e64b)Remove view()’s script, sidecars and GLE work files after compiling (
1380d76)Scatter(marker=None) draws matplotlib’s default circle (
df36b8c)Store an array colour in the style config or a broken axes as a tuple (#273,
4ad3631)Write data columns and axis ranges at the precision their values need (#250,
4829c4c)
v5.6.2 (2026-11-19)
Bug Fixes
Alpha= overrides an RGBA colour’s alpha without a warning (#267,
5b79a9f)Errorbar, axvline/axhline and axvspan/axhspan honour aliases and warn on ignored keywords (#233,
90f5e34)Imshow, contour, tripcolor and tricontour warn on keywords they ignore (#177,
b381cd5)Model only tick intervals the writer writes back unchanged (#155,
666edec)Open_gle raises each recovery note as a UserWarning (
0135197)Open_gle recovers dticks/dsubticks onto the axes (
7406745)Review fixes for errorbar and span keyword aliases (#233,
e209677)Warn when a colour silently becomes BLACK or loses its alpha (#267,
7132d7a)
Continuous Integration
Documentation
v5.6.1 (2026-11-19)
Bug Fixes
Accept matplotlib grey-level strings as colours (#193,
81ec0a7)Keep a raw constant-error dataset defined when its file is re-saved (
d76f89e)List grey-level strings in the colour fidelity contract (#193,
ff3ce5e)Plot() honours lw/ls/c/ms and warns on keywords it ignores (#166,
025697b)Read a numpy RGB(A) array as one hist colour (#244,
b4dc551)
Documentation
v5.6.0 (2026-11-19)
v5.5.0 (2026-11-19)
Features
v5.4.0 (2026-11-19)
Features
v5.3.0 (2026-11-19)
v5.2.0 (2026-11-19)
Features
v5.1.0 (2026-11-19)
Features
v5.0.0 (2026-11-19)
Features
v4.10.0 (2026-11-18)
Features
v4.9.0 (2026-11-18)
Features
v4.8.0 (2026-11-18)
Features
v4.7.0 (2026-11-18)
Features
v4.6.0 (2026-11-18)
Features
v4.5.0 (2026-11-18)
Features
v4.4.0 (2026-11-18)
Features
v4.3.0 (2026-11-18)
Features
v4.2.0 (2026-11-18)
Features
v4.1.0 (2026-11-18)
Features
v4.0.0 (2026-11-18)
Bug Fixes
Colorbar() label uses the heatmap’s own axes (
3bc52b3)
Features
v3.19.0 (2026-11-18)
Features
Testing
Pin round trip of hand-written custom marker definitions (
724180b)
v3.18.0 (2026-11-18)
Features
v3.17.0 (2026-11-18)
Features
v3.16.0 (2026-11-18)
Bug Fixes
Features
v3.15.0 (2026-11-18)
Documentation
Features
v3.14.0 (2026-11-18)
Features
v3.13.0 (2026-11-18)
Features
v3.12.0 (2026-11-18)
Features
v3.11.0 (2026-11-18)
Documentation
Say that honouring a warned-and-ignored keyword is not breaking (
4341e59)
Features
Axis-line styling, title fonts and GLE tick placement (
0286c0d)
v3.10.0 (2026-11-17)
Features
Deprecate GLEWriter’s keyword-argument series methods (#100 stage 4) (
56a946e)
v3.9.3 (2026-11-17)
Bug Fixes
Documentation
Add the Opening GLE files guide (
bddb657)Generate the gallery from the examples registry (
8caed17)Regroup the site navigation into the sections of #104 (
0597117)Replace CONFIGURATION_API.md with the generated reference (
2c311b7)Split the usage page into user-guide topics (
158342b)contributing: Build the contributing page from CONTRIBUTING.md (
8d67254)examples: Keep run_all output apart from run_and_compile’s (
3084fe2)examples: Stop committing generated example output (
97d4ca3)guides: Fold the PyPI publishing setup into VERSIONING.md (
8180911)guides: Keep the PyPI publishing steps true to release.yml (
27b9c3e)guides: Link the guides index and sibling guides from the site (
6602888)guides: Publish the topic guides on the Sphinx site (
0a2fcd5)
Refactoring
Attribute warnings to the caller’s line and check for stacklevel (
ec81e84)Clarify the per-phase write methods in AGENTS.md and the dispatcher docstring (
afd3249)Map dN display attributes to series fields in one place (#100 stage 3) (
a04487b)Pass bar series to the writer whole (#100 stage 2) (
b74b17e)Pass errorbar series to the writer whole (#100 stage 2) (
99a52a9)Pass file series to the writer whole (#100 stage 2) (
31ff30a)Pass fill series to the writer whole (#100 stage 2) (
d4eef29)Pass histogram series to the writer whole (#100 stage 2) (
e5b4243)Pass line series to the writer whole (#100 stage 1) (
f2dcda4)Pass scatter series to the writer whole (#100 stage 2) (
dbd98cb)Route every library warning through warn_external (
1923c6c)Say nbars can exceed 1 for a grouped bar in the G16 note (
17bb811)Split _Recognizer._parse_graph_block into named steps (#109,
c6bfc76)Split Figure._write_axes_content into per-phase methods (
06616eb)Split GLEWriter.add_axes into per-axis steps (#109,
52d7bd8)examples: Leave compiling to the runner (
f4cf69d)examples: One registry and one runner for the examples (
82c4e59)
Testing
Add a golden builder for the bar fields no builder set (
df5b7c7)Add a golden builder for the contour fields no builder set (
76202d1)Add a golden builder for the errorbar fields no builder set (
35f5f58)Add a golden builder for the file-series fields no builder set (
c95ee4f)Add a golden builder for the fill fields no builder set (
af79979)Add a golden builder for the heatmap fields no builder set (
c961055)Add a golden builder for the histogram fields no builder set (
f704b9f)Add a golden builder for the line fields no builder set (
3cb454e)Add a golden builder for the scatter fields no builder set (
6a9297d)Check warn_explicit too and keep attribution-test cleanup in finally (
77f4afb)Convert the remaining unittest modules to pytest and remove tests/_tempdir.py (
c31f43d)Cover an unloadable error-bar dataset before folding the dN field mapping (
1dbe6e3)Cover the page-level trailer branches before splitting _Recognizer.run (
3208a7a)Cover the y-side tick options before splitting GLEWriter.add_axes (
c3e5931)Hold third-party imports to the declared runtime dependencies (
230073d)Keep an unpaired histogram let as raw GLE with a note (
f3e3c6c)Keep the first-UserWarning check and use pathlib for tmp_path joins (
d370292)Move the unpaired histogram let test to the parser layer (
47b78d6)Pin add_plot_line’s keyword mapping and repoint stale comments (
dd55e04)Round-trip a styled, fractional draw-form reference line (
8284cad)Round-trip a styled, fractional draw-form span (
7c270ed)Share one import walker and parse dependency specs robustly (
36d9598)Strip the directory from data_error with Path, not a slash regex (
e269e10)
v3.9.2 (2026-11-17)
Bug Fixes
Stop printing from library code; make show() view the figure (
34e04c0)
Continuous Integration
Documentation
Refactoring
Make module-level imports acyclic and test the layering (
06cf064)
Testing
Count drawn segments instead of timing the decimated compile (
4e6a277)
v3.9.1 (2026-11-16)
Bug Fixes
Discover series fields on Python 3.14 (
b9b518b)
Build System
Raise the Python floor to 3.9 and configure the lint tools (
a5e5779)
Code Style
Format the tree with black and isort (
c1f6006)
Continuous Integration
Documentation
Prune stale pages and complete the API reference (
aee7dd3)
Testing
Skip GLE-dependent tests through the gle marker and lint in CI (
10ba438)
v3.9.0 (2026-11-16)
Features
Add Axes.annotate with data-coordinate arrows (
8b9e202)
v3.8.0 (2026-11-15)
Features
Add a secondary x axis as a data scale (
001232a)
v3.7.0 (2026-11-15)
Features
Draw error bars on bar charts (
e7737b4)
v3.6.0 (2026-11-14)
Features
Model bar colors, horizontal bars, groups, and stacks (
0603d41)
v3.5.0 (2026-11-14)
Features
Fill to an axis, clip bands, and fill polygons (
8420553)
v3.4.0 (2026-11-14)
Features
Bin samples with Axes.hist (
93f1970)
v3.3.0 (2026-11-14)
Features
Emit step, stem, and histogram outlines as GLE line modes (
45f91f8)
v3.2.0 (2026-11-14)
Features
Draw bar and fill labels in the legend (
022ec15)
Testing
Expect a legend swatch on a labelled span (
827c996)
v3.1.0 (2026-11-14)
Features
Emit text vertical alignment, rotation, and backgrounds (
c95857a)
Testing
Refresh text annotation emission digests (
cbb045c)
v3.0.0 (2026-11-14)
Continuous Integration
Simplify release to PSR v10 and gate PyPI (
8359a69)
Features
Unreleased
Features
ax.legend()honoursfontsize(GLEkey ... hei, points converted with the same pt→cm rule asset hei, including matplotlib’s relative names) andframeon(key ... nobox); all eleven matplotliblocstrings now reach GLE’s nine key anchors instead of five of them collapsing onto top rightEvery other matplotlib
legend()keyword — and an unrecognizedloc, and an explicit handles/labels sequence — warns instead of being silently droppedax.contour(X, Y, Z)accepts matplotlib’s 2-Dnp.meshgridcoordinate arrays; irregular grids, transposed (indexing='ij') grids and shape mismatches each raise their own message
Behaviour changes
Plain display strings now render literally. GLE’s text engine reads
_and^as sub/superscripts and swallows braces, so'lambda_tail'used to render as “lambda” with a subscripted “tail” and'{a, b}'lost its braces. gleplot now follows matplotlib’s contract — literal by default, math opt-in via$...$— and escapes_,^,{and}in every non-math segment of every display string (axis labels, titles, legend keys, annotations, tick labels).Still treated as GLE markup, so existing figures that use it are unaffected: a backslash (
r'\chi{} (emu/mol)','{\bf bold}') and a braced script ('T_{N}','mol^{-1}'). Only a bare_/^changed meaning. If you relied on'T_N'subscripting, write'T_{N}'orr'$T_N$'.
Fixes
gleplot.calibrationhardensglestudio-cal/glestudio-box/glestudio-twmarkers against spoofing: an optional per-invocationnonceoninstrument_script/inject_text_metrics/build_text_metric_script(new_calibration_nonce()mints one) embedsmarker:<nonce>in every printed record, andparse_calibration_records(..., expected_nonce=...)rejects any record whose marker lacks or mismatches it as a new"spoofed"CalibrationWarning, instead of letting it race the genuine record for the first-parsed slot. Fixes a hole where aprint "glestudio-cal ..."smuggled into a document as passthrough text (axes ids travel in GLEstudio’sproject.jsonplaintext) could poison the data↔cm map before the real record — printed after the actual graph block — ever arrived. Opt-in: omittingnonce/expected_noncereproduces prior behaviour exactly.
v1.9.0 (2026-07-31)
Features
Figure.add_broken_xaxes— split/broken x-axis figures, rendered as independent GLE subplot segments with a shared y-axis and configurable divider style (double-slash, single rule, or none)axhline/axvline/axhspan/axvspanas first-classAxesmethods, matplotlib-compatible reference lines and shaded spansAxes.set_xticks/set_yticksacceptdticks/dsubticksfor explicit major/minor tick spacingheight_ratios/width_ratiosonFigure/glp.figure/glp.subplotsfor matplotlib-gridspec-style uneven subplot gridsOpen (outline) and white-filled marker variants, selected via
fillstyleormarkerfacecolor/mfconplot,scatter, anderrorbarscatteracceptsmarkersize(matplotlibLine2Ddiameter convention) alongside its existings(area) convention; passing both prefersmarkersizeEvery matplotlib string marker code is now mapped to a GLE glyph
Fixes
Colours are emitted as exact
rgb255(...)values instead of being snapped onto the nearest of ~8 named GLE coloursLine series are drawn as the data itself rather than a spline through it unless smoothing is explicitly requested (
GLEGraphConfig.smooth_curvesnow defaults toFalse)Line styles use the GLE line-style numbers that actually render as their names say (dashed, dotted, and dash-dot no longer render as each other)
Error bars and their caps consistently take the series colour, including bars-only error series
Figure(data_prefix=...)is validated instead of silently producing GLE scripts that fail to parse
v1.0.1 (2026-03-03)
Improvements
Gallery updated to use example outputs instead of test suite outputs
All gallery code snippets now match the actual example source files
New examples added: conditional
fill_between(withwhere=), combined X+Y error bars, side-by-side subplots (1×2), stacked subplots (2×1), 2×2 mixed-type subplot grid, 1×3 comparisonDocumentation homepage now includes prominent links to the GitHub repository
GitHub Pages deployment workflow fixed (
fetch-tags: true)
v0.0.1 (2026-03-01)
Features
Initial release of gleplot
Matplotlib-compatible API for creating GLE plots
Support for line plots, scatter plots, bar charts, and fill_between
Full axis customization (labels, limits, scales, grid)
Color and marker mappings compatible with matplotlib
Direct compilation to PDF, PNG, and EPS via GLE
Export to GLE scripts for manual editing
Comprehensive test suite with 34 tests
Sphinx documentation with GitHub Actions publishing
Examples gallery demonstrating various plot types