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 contour keyword aliases (#177, 03c13ce)

  • Review fixes for errorbar and span keyword aliases (#233, e209677)

  • Review fixes for open_gle recovery warnings (#135, db5eed7)

  • Review fixes for savefig keyword warnings (#183, 0a66f21)

  • Savefig warns on keywords it ignores (#183, a5ee4b6)

  • Warn when a colour silently becomes BLACK or loses its alpha (#267, 7132d7a)

Continuous Integration

  • Add a Windows leg with GLE to the test job (#102, 4e69f91)

  • Put Ghostscript on PATH for the Windows GLE leg (#102, 9ef1780)

  • Scope Git Bash to the steps that need it (#102, 92645de)

Documentation

  • Address review of the scale_mode docs (#131, 8d47cc3)

  • Describe scale_mode in public terms; ‘fixed’ has no effect (#131, 625aa95)

  • Mention the Windows GLE leg in the testing guide (#102, c38f936)

  • Prefer Cairo-safe TeX fonts in the font examples (#128, 6610b31)

  • Use GLE font names in the configuration docs (#128, 3805ca3)

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 a colour (#244, 1127994)

  • Read a numpy RGB(A) array as one hist colour (#244, b4dc551)

  • Review fixes for plot keyword handling (#166, 24499cc)

Documentation

  • Address review of the README rewrite (#103, 4a48619)

  • Record release policy in AGENTS.md (#263, 0945f13)

  • Rewrite the README to show what gleplot is for (#103, 6526832)

  • Separate unknown keyword names from junk values in release policy (#263, bd75a92)

v5.6.0 (2026-11-19)

v5.5.0 (2026-11-19)

Features

  • Colorbar for a colour-mapped scatter (#89, fc22c9f)

  • Review fixes for the scatter colorbar (#89, 802f869)

v5.4.0 (2026-11-19)

Features

  • Pcolormesh draws each cell of a uniform grid (#90, stage 1 of 2) (9d50b5a)

  • Review fixes for pcolormesh (#90, 99087e6)

v5.3.0 (2026-11-19)

v5.2.0 (2026-11-19)

Features

  • Per-point scatter colours with c=, cmap=, vmin= and vmax= (#89, 675dbdf)

  • Review fixes for per-point scatter colours (#89, fe42ab0)

v5.1.0 (2026-11-19)

Features

  • Place an inset with Figure.add_axes(rect) (bb6a364)

  • Record add_axes insets in the metadata header (#85, fa6b809)

  • Review fixes for add_axes insets (#85, 84d5419)

  • Review fixes for spanning add_subplot (#85, 16eff6c)

  • Span several grid cells with add_subplot(rows, cols, (first, last)) (e3b48a0)

v5.0.0 (2026-11-19)

Features

  • Figure-level suptitle, text and legend (#84, 9fba7cd)

  • Review fixes for figure-level text and legend (#84, 8263642)

v4.10.0 (2026-11-18)

Features

  • Place ax.text in axes fractions with transform=ax.transAxes (#84, d5ee6cb)

  • Review fixes for axes-fraction text (#84, 8ae8e11)

v4.9.0 (2026-11-18)

Features

  • Reversed colormap names (cmap=”RdBu_r”) (#179, c6cbd23)

  • Review fixes for reversed colormap names (#179, 4044569)

v4.8.0 (2026-11-18)

Features

  • Hide an axis line with set_axis_line(visible=False) (#83, 7bc457b)

  • Review fixes for hidden axis lines (#83, 4a44fc7)

v4.7.0 (2026-11-18)

Features

  • Matplotlib axis helpers twinx, invert_axis, semilog, set_*ticklabels, axis (#81, 97a75a9)

  • Review fixes for the axis helpers (#81, 2668576)

v4.6.0 (2026-11-18)

Features

  • Fit results in the legend with Axes.fit label placeholders (#75, 6546a26)

  • Review fixes for fit result legends (#75, 1c4a429)

v4.5.0 (2026-11-18)

Features

v4.4.0 (2026-11-18)

Features

  • Axes.image raises NotImplementedError on a polar axes (#59, 895f3c7)

  • Place image files in data coordinates with Axes.image (#59, ec71e09)

  • Review fixes for Axes.image (#59, b57b781)

v4.3.0 (2026-11-18)

Features

  • Heatmap from an expression with Axes.function2d (#77, 04e3104)

  • Review fixes for function2d (#77, 83b6542)

v4.2.0 (2026-11-18)

Features

  • Guard Axes.derived on a polar axes (#58, 32d0ec3)

  • Polar angle labels under usetex (#58, d25333a)

  • Polar axes with add_subplot(projection=’polar’) (#58, 0aafacd)

  • Polar scatters with per-point sizes, tick methods guarded (#58, b7df619)

  • Review fixes for polar axes (#58, 09acc50)

v4.1.0 (2026-11-18)

Features

  • Curves computed from other series with Axes.derived (#76, 4c87fe0)

  • Free page drawing with Figure.circle, ellipse, arc, bezier, curve, polygon, table and tex (#60, 9402ff9)

  • Per-point marker sizes for scatter (#70, d2394af)

v4.0.0 (2026-11-18)

Bug Fixes

  • Colorbar() label uses the heatmap’s own axes (3bc52b3)

Features

  • Closed-form fits with Axes.fit(model=…) (#75, 263b48d)

  • Colorbar per axes and horizontal colorbars (#78, a882209)

  • Hatch patterns on bars (#71, 232b7ca)

  • LaTeX-rendered labels with GLEStyleConfig(usetex=True) (#72, 34e3ca4)

v3.19.0 (2026-11-18)

Features

  • Clip box plots to the frame, review fixes for boxplot (#57, 6aa1634)

  • Legend bbox_to_anchor, spacing keywords and labelcolor (#87, 957f957)

  • Tick marks, minor ticks and log sub-labels (#73, 047e1ef)

  • Vertical box plots with Axes.boxplot and glp.boxplot (#57, a8fe0b5)

Testing

  • Pin round trip of hand-written custom marker definitions (724180b)

v3.18.0 (2026-11-18)

Features

  • Axes through the origin with Axes.set_math_mode (#74, 0a1163b)

  • Figure-wide line cap, join and dash length (#80, 99b3234)

  • Transparent and grayscale output options on savefig (#79, 60f66f4)

  • Warn when math mode cannot show the axes (#74, 0fcb306)

  • Warn where savefig’s transparent and grayscale cannot act (#79, d5e4ff8)

v3.17.0 (2026-11-18)

Features

  • Accept numpy numbers and size names in pie, one text per wedge (#56, 5d6a075)

  • Pie charts with Axes.pie and glp.pie (#56, e9aaeb7)

v3.16.0 (2026-11-18)

Bug Fixes

  • List unknown-cmap alternatives as matplotlib spells them (#55, 5a62bbd)

Features

  • ColorBrewer cmaps for imshow and tripcolor (#55, 379a820)

v3.15.0 (2026-11-18)

Documentation

  • Explain the one-colormap limit and why contours have no smoothing (#54, 5b010c4)

  • Point the migration guide at the heatmap limit instead of restating it (#54, de3c97a)

Features

  • Draw GLE-fitted curves with Axes.fit (#53, 64864e9)

  • Name the argument when fit() data is not numbers (#53, 2a8387c)

v3.14.0 (2026-11-18)

Features

  • Draw GLE-sampled function curves with Axes.function (#52, e429caa)

v3.13.0 (2026-11-18)

Features

  • Data-file reading options on line_from_file and errorbar_from_file (#51, 08b72c8)

v3.12.0 (2026-11-18)

Features

  • Plot() mdist, deresolve and per-series clip window (#50, 07163ee)

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

  • Keep a dataset line’s missing colour and width missing on re-save (#134, 28fe11a)

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 contours to the writer whole (#147, 0b49be2)

  • 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 heatmaps to the writer whole (#147, c5deccb)

  • Pass histogram series to the writer whole (#100 stage 2) (e5b4243)

  • Pass line series to the writer whole (#100 stage 1) (f2dcda4)

  • Pass reference lines to the writer whole (#147, d4e60c7)

  • Pass scatter series to the writer whole (#100 stage 2) (dbd98cb)

  • Pass spans to the writer whole (#147, 17c5b76)

  • Pass text annotations to the writer whole (#147, 2a04db5)

  • 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 _Recognizer.run into its phases (#109, c38c674)

  • Split Figure._write_axes_content into per-phase methods (06616eb)

  • Split GLEWriter.add_axes into per-axis steps (#109, 52d7bd8)

  • Tidy the graph-block pass state (#109, 30d9824)

  • 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

  • Clear the mypy errors and make the type check gate the build (2c26a2f)

  • Run the examples and a strict Sphinx build on pull requests (c65d78e)

Documentation

  • Link each known-debt entry to its issue (2f6ad2f)

  • State the agent contract as the target form and list known debt (bddd2ce)

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

  • Bound the parallel GLE build (c990314)

  • Cache the GLE build and move the version spread to the no-GLE job (b99ca06)

  • Run the no-GLE job on ubuntu-24.04 (7c0f7f7)

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() honours fontsize (GLE key ... hei, points converted with the same pt→cm rule as set hei, including matplotlib’s relative names) and frameon (key ... nobox); all eleven matplotlib loc strings now reach GLE’s nine key anchors instead of five of them collapsing onto top right

  • Every other matplotlib legend() keyword — and an unrecognized loc, and an explicit handles/labels sequence — warns instead of being silently dropped

  • ax.contour(X, Y, Z) accepts matplotlib’s 2-D np.meshgrid coordinate 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}' or r'$T_N$'.

Fixes

  • gleplot.calibration hardens glestudio-cal/glestudio-box/glestudio-tw markers against spoofing: an optional per-invocation nonce on instrument_script/inject_text_metrics/build_text_metric_script (new_calibration_nonce() mints one) embeds marker:<nonce> in every printed record, and parse_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 a print "glestudio-cal ..." smuggled into a document as passthrough text (axes ids travel in GLEstudio’s project.json plaintext) could poison the data↔cm map before the real record — printed after the actual graph block — ever arrived. Opt-in: omitting nonce/expected_nonce reproduces 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/axvspan as first-class Axes methods, matplotlib-compatible reference lines and shaded spans

  • Axes.set_xticks/set_yticks accept dticks/dsubticks for explicit major/minor tick spacing

  • height_ratios/width_ratios on Figure/glp.figure/glp.subplots for matplotlib-gridspec-style uneven subplot grids

  • Open (outline) and white-filled marker variants, selected via fillstyle or markerfacecolor/mfc on plot, scatter, and errorbar

  • scatter accepts markersize (matplotlib Line2D diameter convention) alongside its existing s (area) convention; passing both prefers markersize

  • Every 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 colours

  • Line series are drawn as the data itself rather than a spline through it unless smoothing is explicitly requested (GLEGraphConfig.smooth_curves now defaults to False)

  • 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 (with where=), combined X+Y error bars, side-by-side subplots (1×2), stacked subplots (2×1), 2×2 mixed-type subplot grid, 1×3 comparison

  • Documentation 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