PlotTheme

PlotTheme

Publication plotting standards shared by every figure: the Okabe–Ito semantic palette, journal-width figure geometry, print-scale typography, and the CairoMakie theme (telemetry_theme).

PlotStyle

Print-scale parameters of one figure set: scale relative to the double-column design width (178 mm ↔ 673 Makie units), the derived figure sizes, line width, marker size, and the font sizes (body, axis label, tick label, legend, in-axis annotation). Fonts and strokes do not shrink linearly with the width — PlotStyle(scale) floors them so text stays ≥ 7 pt at the final print size — and narrow figures gain height for the legends that wrap.

style_for_width(column_width_mm::Real) -> PlotStyle

The PlotStyle of a figure printed column_width_mm wide (Makie units are 1/96 inch; 178 mm is the design width, scale 1).

label(style::PlotStyle, long::AbstractString, short::AbstractString) -> AbstractString

long at the design width, short for narrow figures (scale < 0.7), where a long axis label would collide with the neighboring panel. Plain and LaTeX strings alike.

annotation_side(occupied, x_lo, x_hi; fraction = 0.38) -> Symbol

Which end of an axis an in-axis annotation block should occupy: :right unless one of the occupied x positions — the upright rules and shaded edges a figure draws — falls within fraction of the axis width of the right edge, in which case :left. fraction is the block's own width relative to the axis (annotation_width_fraction), so the test asks exactly whether a rule would cross the text. When both ends are occupied it stays :right, since moving buys nothing.

annotation_width_fraction(style::PlotStyle, text, axis_width) -> Float64

Width of the annotation text as a fraction of an axis axis_width Makie units wide, capped at 0.45 — beyond that neither end of the axis is free and annotation_side has nothing to choose between.

label_extent(style::PlotStyle, text; fontsize = style.fontsize_label) -> Float64

Estimated rendered length of text in Makie units, i.e. the height a rotated y-label occupies or the width an annotation line takes. The estimate takes half an em per character, the mean advance of the text face, and exists to floor panel heights and to place annotation blocks clear of upright rules; nothing is positioned precisely with it.

legend_row_height(style::PlotStyle) -> Float64

Height of one row of a horizontal figure legend in Makie units: the entry patch and the gap above it, at the legend size of style.

line_advance(style::PlotStyle) -> Float64

Vertical advance between two lines of in-axis annotation text in Makie units: the line height of the theme's text face (height / units_per_EM, the multiplier Makie applies to multi-line text) times the annotation font size. Places a second text primitive directly under a first, e.g. a plain block below a LaTeX headline.

save_figure(fig, dir::String, stem::String; formats = ("png", "pdf"), suffix = "") -> String

Saves fig as <dir>/<stem><suffix>.<ext> for every extension in formats — PNG at px_per_unit = 4 (≥ 380 dpi at print size), vector formats at native size — and returns the path of the first one.

telemetry_theme(style::PlotStyle = PlotStyle())

Returns a CairoMakie Theme configured for publication-quality telemetry plots at the final printed width: (New) Computer Modern faces via MathTeXEngine (a plain font = "Computer Modern" string is ignored by current Makie and silently falls back to DejaVu), ≈ 9 pt body text at double-column scale (floored at ≈ 7 pt for narrower styles), boxed axes with inward ticks, no titles, no minor ticks, faint dashed grid. Tick-label rotation is applied per axis where labels actually crowd (session HH:MM axes), not globally.

COLOR_LIVE

Plot color for near-real-time (Live, FIFO-priority) data batches (Okabe–Ito sky blue).

COLOR_ARCHIVE

Plot color for blind-spot archive (LIFO-backfilled) data batches (Okabe–Ito bluish green).

COLOR_BANDWIDTH

Plot color for the DSN link-capacity (bandwidth) curve (Okabe–Ito blue).

COLOR_ONBOARD

Plot color for the onboard SSD backlog curve (Okabe–Ito orange; role is additionally encoded by the dashed line style, so the figure survives grayscale).

COLOR_LOST

Plot color for permanently lost (retry-exhausted) data batches (Okabe–Ito vermillion; role additionally encoded by ✕ markers).

COLOR_COUNTERFACTUAL

Plot color for counterfactual quantities — the first-in, first-out drain the alert-latency figure contrasts with the realized doctrine (Okabe–Ito reddish purple; role additionally encoded by the dotted line style).

COLOR_DISRUPTION

Base color for disruption-event window shading: a neutral dark wash for the blackout span that fades to zero alpha across the recovery ramp, with dashed same-hue edge lines at higher alpha. Deliberately neutral so it never competes with the series palette.

COLOR_OUTAGE

Base color for component-outage window shading: a neutral wash at low alpha with dotted same-hue edge lines at higher alpha, so unscheduled infrastructure outages stay apart from the series palette and, by line style, from the dashed disruption shading.

COLOR_MARKER

Plot color for the per-event-marker realized latency curves of the alert-latency figure — a family apart from the population bands, its members told apart by cycling line styles.

COLOR_GUIDE

Neutral grey for population aggregates and reference guides: the all-batches delivery curve, the delivery-requirement line, and its label.

COLOR_FUTURE

Wash of the not-yet-generated region of the batch-state raster: a near-white that reads as absence rather than as one more state, so the generation front appears as the boundary of the drawn area.

FIG_SIZE_SUMMARY

Mission-summary figure size in Makie units: 178 mm double-column width at the final printed scale (three stacked panels + legend strip).

FIG_SIZE_SESSION

Session-detail figure size in Makie units: 178 mm double-column width (two stacked panels + legend strip).

LINEWIDTH_DATA

Data-series line width in Makie units (≈ 1.1 pt at final print scale; PlotStyle floors the scaled width at 0.9 of it, ≈ 1 pt, for narrower figures).

MARKERSIZE_DATA

Marker size in Makie units for event pins and legend glyphs — one size everywhere, so every figure of the project draws it identically.

FONTSIZE_ANNOTATION

In-axis annotation font size in Makie units (≈ 7.5 pt at print scale).