plotastro 1.0.0__py3-none-any.whl

plotastro/_core.py

@@ -0,0 +1,256 @@
+"""Journal definitions, style activation and figure sizing."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import matplotlib as mpl
+import matplotlib.pyplot as plt
+
+STYLE_DIR = Path(__file__).resolve().parent / "styles"
+
+#: Golden ratio (height/width) used for default figure heights.
+GOLDEN = (5 ** 0.5 - 1) / 2  # 0.618...
+
+_SERIF_TEX = r"\usepackage{newtxtext}\usepackage{newtxmath}"
+_SANS_TEX = (r"\usepackage{helvet}\usepackage{sansmath}\sansmath"
+             r"\renewcommand{\familydefault}{\sfdefault}")
+
+#: Text-block widths in LaTeX points (1 pt = 1/72.27 inch) per journal,
+#: the style sheet each journal uses, and its LaTeX font preamble.
+JOURNALS = {
+    "mnras":    {"column": 240.0,     "full": 504.0,     "style": "mnras",
+                 "tex": _SERIF_TEX,
+                 "name": "Monthly Notices of the RAS"},
+    "rasti":    {"column": 240.0,     "full": 504.0,     "style": "rasti",
+                 "tex": _SERIF_TEX,
+                 "name": "RAS Techniques and Instruments"},
+    "aanda":    {"column": 250.38,    "full": 512.15,    "style": "aanda",
+                 "tex": _SERIF_TEX,
+                 "name": "Astronomy & Astrophysics"},
+    "apj":      {"column": 242.26653, "full": 513.11743, "style": "apj",
+                 "tex": _SERIF_TEX,
+                 "name": "The Astrophysical Journal (AASTeX)"},
+    "oja":      {"column": 245.26653, "full": 508.0,     "style": "oja",
+                 "tex": _SERIF_TEX,
+                 "name": "The Open Journal of Astrophysics"},
+    "prd":      {"column": 246.0,     "full": 510.0,     "style": "prd",
+                 "tex": _SERIF_TEX,
+                 "name": "Physical Review D (REVTeX 4.2)"},
+    "jcap":     {"column": 455.24,    "full": 455.24,    "style": "jcap",
+                 "tex": _SERIF_TEX,
+                 "name": "J. of Cosmology and Astroparticle Physics"},
+    "natastro": {"column": 253.23,    "full": 520.68,    "style": "natastro",
+                 "tex": _SANS_TEX,
+                 "name": "Nature Astronomy"},
+    # Not journals, but handy width presets (they use the MNRAS look):
+    "thesis":   {"column": 426.79135, "full": 426.79135, "style": "mnras",
+                 "tex": _SERIF_TEX,
+                 "name": "A4 thesis text width"},
+    "beamer":   {"column": 307.28987, "full": 307.28987, "style": "mnras",
+                 "tex": _SERIF_TEX,
+                 "name": "Beamer slide text width"},
+}
+
+_ALIASES = {
+    "a&a": "aanda", "aa": "aanda", "astronomy&astrophysics": "aanda",
+    "apjl": "apj", "aj": "apj", "aas": "apj", "aastex": "apj",
+    "openjournal": "oja", "theoj": "oja", "openjournalofastrophysics": "oja",
+    "prl": "prd", "aps": "prd", "revtex": "prd",
+    "nature": "natastro", "natureastronomy": "natastro", "natastron": "natastro",
+    "mnras_full": "mnras",  # legacy name from the old set_size() API
+}
+
+_state = {"journal": "mnras"}
+
+
+def _resolve(journal):
+    key = str(journal).lower().replace(" ", "").replace("-", "")
+    key = _ALIASES.get(key, key)
+    if key not in JOURNALS:
+        options = ", ".join(sorted(JOURNALS))
+        raise ValueError(f"Unknown journal {journal!r}. Choose one of: {options}")
+    return key
+
+
+def current_journal():
+    """Name of the journal activated by the last :func:`set_style` call."""
+    return _state["journal"]
+
+
+# ----------------------------------------------------------------------
+# Style activation
+# ----------------------------------------------------------------------
+
+def set_style(journal="mnras", *, usetex=False, grid=None, **rc_overrides):
+    """Activate the plotting style for a journal.
+
+    Parameters
+    ----------
+    journal : str
+        One of ``"mnras"``, ``"rasti"``, ``"aanda"`` (aliases ``"a&a"``,
+        ``"aa"``), ``"apj"`` (aliases ``"apjl"``, ``"aastex"``), ``"oja"``,
+        ``"prd"`` (aliases ``"prl"``, ``"revtex"``), ``"jcap"``,
+        ``"natastro"`` (alias ``"nature"``), ``"thesis"`` or ``"beamer"``.
+    usetex : bool, optional
+        If True, render all text with a real LaTeX installation using
+        fonts matching the journal (newtx Times for the serif journals,
+        Helvetica for Nature Astronomy). Default False (portable mathtext).
+    grid : bool, optional
+        Override the style's grid setting (the styles default to a
+        subtle grid; pass ``grid=False`` for a clean journal look).
+    **rc_overrides
+        Any extra rcParams, e.g. ``set_style("mnras", **{"font.size": 10})``.
+
+    Examples
+    --------
+    >>> pa.set_style("aanda")
+    >>> pa.set_style("mnras", usetex=True, grid=False)
+    """
+    key = _resolve(journal)
+    style_file = STYLE_DIR / f"{JOURNALS[key]['style']}.mplstyle"
+    plt.style.use(style_file)
+    _state["journal"] = key
+    # Presets sharing a style file (thesis, beamer) still get the right
+    # default figure size:
+    mpl.rcParams["figure.figsize"] = figsize("column", journal=key)
+    if usetex:
+        mpl.rcParams.update({
+            "text.usetex": True,
+            "text.latex.preamble": JOURNALS[key]["tex"],
+        })
+    if grid is not None:
+        mpl.rcParams["axes.grid"] = bool(grid)
+    if rc_overrides:
+        mpl.rcParams.update(rc_overrides)
+
+
+#: Alias for :func:`set_style`, for those who prefer ``pa.use("mnras")`` —
+#: after which everything is plain matplotlib.
+use = set_style
+
+
+# ----------------------------------------------------------------------
+# Figure sizing
+# ----------------------------------------------------------------------
+
+def figsize(width="column", *, journal=None, fraction=1.0, nrows=1, ncols=1,
+            aspect=GOLDEN, height=None):
+    """Figure dimensions (inches) that match the journal's text layout,
+    so the figure is never rescaled (and its fonts shrunk) by LaTeX.
+
+    Parameters
+    ----------
+    width : {"column", "full"} or float
+        ``"column"`` for a one-column figure, ``"full"`` for the full
+        text width, or a number = a custom width in LaTeX points
+        (get yours with ``\\the\\columnwidth`` in your .tex file).
+    journal : str, optional
+        Journal to size for; defaults to the one from the last
+        :func:`set_style` call.
+    fraction : float, optional
+        Fraction of that width to occupy (e.g. 0.5 for half a column).
+    nrows, ncols : int, optional
+        Subplot grid shape; the height scales so each panel keeps the
+        requested aspect ratio.
+    aspect : float, optional
+        Height/width ratio of one panel. Default: golden ratio (0.618).
+        Use ``aspect=1`` for square panels.
+    height : float, optional
+        Explicit figure height in inches (overrides ``aspect``).
+
+    Returns
+    -------
+    (width_in, height_in) : tuple of float
+    """
+    key = _resolve(journal) if journal is not None else _state["journal"]
+    if isinstance(width, str):
+        w = width.lower()
+        if w in ("column", "col", "onecolumn", "one", "single"):
+            width_pt = JOURNALS[key]["column"]
+        elif w in ("full", "fullwidth", "two", "twocolumn", "page", "text"):
+            width_pt = JOURNALS[key]["full"]
+        else:
+            raise ValueError(
+                f"width must be 'column', 'full' or a number of points, got {width!r}")
+    else:
+        width_pt = float(width)
+
+    fig_width_in = width_pt * fraction / 72.27
+    if height is not None:
+        fig_height_in = float(height)
+    else:
+        fig_height_in = fig_width_in * aspect * (nrows / ncols)
+    return (fig_width_in, fig_height_in)
+
+
+def subplots(nrows=1, ncols=1, *, width="column", journal=None, fraction=1.0,
+             aspect=GOLDEN, height=None, **kwargs):
+    """`plt.subplots` with the figure size computed by :func:`figsize`.
+
+    Examples
+    --------
+    >>> fig, ax = pa.subplots()                          # one-column figure
+    >>> fig, axes = pa.subplots(2, 2, width="full")      # full-width 2x2 grid
+    >>> fig, ax = pa.subplots(aspect=1)                  # square panel
+    """
+    if "figsize" not in kwargs:
+        kwargs["figsize"] = figsize(width, journal=journal, fraction=fraction,
+                                    nrows=nrows, ncols=ncols, aspect=aspect,
+                                    height=height)
+    return plt.subplots(nrows, ncols, **kwargs)
+
+
+def savefig(name, fig=None, formats=("pdf",), **kwargs):
+    """Save a figure under one or more formats at once.
+
+    Parameters
+    ----------
+    name : str or Path
+        Output path without extension (a known extension is stripped).
+    fig : Figure, optional
+        Defaults to the current figure.
+    formats : sequence of str, optional
+        e.g. ``("pdf", "png")`` to get both a vector file for the paper
+        and a raster preview.
+    **kwargs
+        Forwarded to ``fig.savefig`` (e.g. ``dpi=600``).
+
+    Returns
+    -------
+    list of str : the files written.
+    """
+    fig = fig if fig is not None else plt.gcf()
+    base = Path(name)
+    if base.suffix.lower() in (".pdf", ".png", ".eps", ".svg", ".jpg", ".tiff"):
+        formats = (base.suffix[1:],)
+        base = base.with_suffix("")
+    written = []
+    for ext in formats:
+        out = f"{base}.{ext}"
+        fig.savefig(out, **kwargs)
+        written.append(out)
+    return written
+
+
+# ----------------------------------------------------------------------
+# Backwards compatibility with the original myfigsize.set_size()
+# ----------------------------------------------------------------------
+
+def set_size(width="mnras", fraction=1, subplots=(1, 1), hight_ratio=1):
+    """Deprecated — use :func:`figsize` instead. Kept so old scripts run.
+
+    ``set_size('mnras')`` == ``figsize('column', journal='mnras')`` and
+    ``set_size('mnras_full')`` == ``figsize('full', journal='mnras')``.
+    """
+    if width == "mnras_full":
+        return figsize("full", journal="mnras", fraction=fraction,
+                       nrows=subplots[0], ncols=subplots[1],
+                       aspect=GOLDEN * hight_ratio)
+    if isinstance(width, str):
+        return figsize("column", journal=width, fraction=fraction,
+                       nrows=subplots[0], ncols=subplots[1],
+                       aspect=GOLDEN * hight_ratio)
+    return figsize(width, fraction=fraction,
+                   nrows=subplots[0], ncols=subplots[1],
+                   aspect=GOLDEN * hight_ratio)

plotastro/_extras.py

@@ -0,0 +1,187 @@
+"""Markers, line styles, property cyclers, panel labels, reference charts."""
+
+from __future__ import annotations
+
+import functools
+import operator
+import string
+
+import matplotlib.pyplot as plt
+from cycler import cycler
+
+from ._colors import COLORS, CYCLE
+from ._core import figsize
+
+#: A marker sequence that stays distinguishable at small sizes.
+MARKERS = ["o", "s", "^", "D", "v", "p", "*", "X"]
+
+#: Named dash patterns. The tuples are matplotlib (offset, (on, off, ...))
+#: dash specs — they scale with the line width and print cleanly.
+LINESTYLES = {
+    "solid":            "-",
+    "dashed":           (0, (5, 2)),
+    "dotted":           (0, (1, 1.5)),
+    "dashdot":          (0, (5, 2, 1, 2)),
+    "long dash":        (0, (9, 3)),
+    "dash dot dot":     (0, (5, 2, 1, 2, 1, 2)),
+    "densely dotted":   (0, (1, 0.8)),
+    "loosely dashed":   (0, (5, 6)),
+}
+
+
+def style_cycler(n=None, *, colors=True, markers=False, linestyles=False):
+    """Build a property cycler that pairs colours with markers and/or
+    dash patterns, so lines stay distinguishable in greyscale and for
+    colour-blind readers (redundant encoding).
+
+    Parameters
+    ----------
+    n : int, optional
+        Number of entries (default: length of the colour cycle, or 8
+        when markers/linestyles are included).
+    colors, markers, linestyles : bool
+        Which properties to cycle together.
+
+    Examples
+    --------
+    >>> ax.set_prop_cycle(pa.style_cycler(markers=True))
+    >>> ax.set_prop_cycle(pa.style_cycler(linestyles=True))
+    >>> plt.rc("axes", prop_cycle=pa.style_cycler(markers=True))  # globally
+    """
+    if n is None:
+        n = len(CYCLE) if not (markers or linestyles) else min(len(CYCLE), 8)
+    parts = []
+    if colors:
+        parts.append(cycler(color=(CYCLE * 3)[:n]))
+    if markers:
+        parts.append(cycler(marker=(MARKERS * 3)[:n]))
+    if linestyles:
+        parts.append(cycler(linestyle=(list(LINESTYLES.values()) * 3)[:n]))
+    if not parts:
+        raise ValueError("Enable at least one of colors/markers/linestyles.")
+    return functools.reduce(operator.add, parts)
+
+
+# ----------------------------------------------------------------------
+# Panel labels
+# ----------------------------------------------------------------------
+
+_PANEL_POSITIONS = {
+    # loc: (x, y, ha, va) in axes coordinates
+    "upper left":  (0.05, 0.95, "left", "top"),
+    "upper right": (0.95, 0.95, "right", "top"),
+    "lower left":  (0.05, 0.05, "left", "bottom"),
+    "lower right": (0.95, 0.05, "right", "bottom"),
+    "outside":     (0.0, 1.02, "left", "bottom"),
+}
+
+
+def label_panels(axes, fmt="({})", loc="upper left", uppercase=False,
+                 labels=None, **text_kw):
+    """Stamp (a), (b), (c), ... on a grid of subplots, the way most
+    journals want multi-panel figures labelled.
+
+    Parameters
+    ----------
+    axes : Axes, sequence of Axes, or array from plt.subplots
+        Labelled in the order given (arrays are flattened row-major).
+    fmt : str, optional
+        Applied to each letter; e.g. ``"({})"`` -> "(a)", ``"{}."`` -> "a.".
+    loc : str, optional
+        One of "upper left", "upper right", "lower left", "lower right",
+        or "outside" (above the top-left corner — the Nature convention,
+        usually combined with ``fmt="{}"`` and bold text).
+    uppercase : bool, optional
+        Use A, B, C instead of a, b, c.
+    labels : sequence of str, optional
+        Explicit labels, overriding the alphabet.
+    **text_kw
+        Forwarded to ``ax.text`` (e.g. ``fontweight="bold"``).
+
+    Returns
+    -------
+    list of the Text objects created.
+
+    Examples
+    --------
+    >>> fig, axes = pa.subplots(2, 2, width="full")
+    >>> pa.label_panels(axes)
+    >>> pa.label_panels(axes, loc="outside", fmt="{}", fontweight="bold")
+    """
+    if hasattr(axes, "flat"):          # numpy array from plt.subplots
+        axes = list(axes.flat)
+    elif not hasattr(axes, "__iter__"):
+        axes = [axes]
+    if loc not in _PANEL_POSITIONS:
+        options = ", ".join(_PANEL_POSITIONS)
+        raise ValueError(f"loc must be one of: {options}; got {loc!r}")
+    x, y, ha, va = _PANEL_POSITIONS[loc]
+    letters = string.ascii_uppercase if uppercase else string.ascii_lowercase
+    if labels is None:
+        labels = [fmt.format(letters[i]) for i in range(len(axes))]
+    texts = []
+    for ax, label in zip(axes, labels):
+        texts.append(ax.text(x, y, label, transform=ax.transAxes,
+                             ha=ha, va=va, **text_kw))
+    return texts
+
+
+# ----------------------------------------------------------------------
+# Reference charts (used in the tutorial and README)
+# ----------------------------------------------------------------------
+
+def show_colors(palette=None, title="Default colour-blind-friendly cycle"):
+    """Swatch chart of a palette dict (default: the style's colour cycle)."""
+    palette = palette if palette is not None else COLORS
+    names = list(palette)
+    fig, ax = plt.subplots(
+        figsize=figsize("full", journal="mnras", fraction=0.9,
+                        height=0.32 * len(names) + 0.5))
+    ax.set_axis_off()
+    ax.set_title(title)
+    for i, name in enumerate(names):
+        y = len(names) - 1 - i
+        ax.add_patch(plt.Rectangle((0, y + 0.1), 1.6, 0.8,
+                                   color=palette[name], ec="0.2", lw=0.4))
+        ax.text(1.75, y + 0.5, f"C{i}  ·  {name}  ·  {str(palette[name]).upper()}",
+                va="center", ha="left", fontsize=8, family="monospace")
+    ax.set_xlim(0, 6)
+    ax.set_ylim(0, len(names))
+    return fig
+
+
+def show_markers():
+    """Reference chart of the marker sequence (and a few more)."""
+    extra = ["<", ">", "h", "8", "P", "d", "x", "+"]
+    all_markers = MARKERS + extra
+    fig, ax = plt.subplots(
+        figsize=figsize("full", journal="mnras", fraction=0.9, height=1.6))
+    ax.set_axis_off()
+    ax.set_title("Markers — first row is plotastro.MARKERS")
+    for i, m in enumerate(all_markers):
+        row, col = divmod(i, 8)
+        y = 1.4 - row
+        ax.plot(col, y, marker=m, ms=7, color=CYCLE[col % len(CYCLE)],
+                ls="none", clip_on=False)
+        ax.text(col, y - 0.42, repr(m), ha="center", va="top", fontsize=8,
+                family="monospace")
+    ax.set_xlim(-0.5, 7.5)
+    ax.set_ylim(-0.7, 2.0)
+    return fig
+
+
+def show_linestyles():
+    """Reference chart of the named dash patterns in LINESTYLES."""
+    fig, ax = plt.subplots(
+        figsize=figsize("full", journal="mnras", fraction=0.9,
+                        height=0.34 * len(LINESTYLES) + 0.5))
+    ax.set_axis_off()
+    ax.set_title("Named line styles — plotastro.LINESTYLES")
+    for i, (name, ls) in enumerate(LINESTYLES.items()):
+        y = len(LINESTYLES) - 1 - i
+        ax.plot([0.35, 1.0], [y, y], ls=ls, lw=1.4,
+                color=CYCLE[i % len(CYCLE)])
+        ax.text(0.32, y, name, ha="right", va="center", fontsize=8)
+    ax.set_xlim(0, 1.02)
+    ax.set_ylim(-0.6, len(LINESTYLES) - 0.4)
+    return fig

plotastro/styles/aanda.mplstyle

@@ -0,0 +1,101 @@
+# =====================================================================
+#  aanda.mplstyle — Astronomy & Astrophysics (A&A)
+#
+#  Figure widths:
+#      one column : 250.38 pt = 3.46 in (88 mm)
+#      full width : 512.15 pt = 7.09 in (180 mm)
+#      (from the A&A author guide: 88 mm / 170-180 mm)
+#  The default figsize below is one column wide with a golden-ratio
+#  height. For other sizes use plotastro.figsize() / plotastro.subplots().
+#
+#  Colours: colour-blind-friendly cycle — see the README for details.
+#  Generated by tools/generate_styles.py — edit that, not this file.
+#
+#  Usage:   import plotastro; plotastro.set_style("aanda")
+#     or:   import plotastro; plt.style.use("aanda")
+# =====================================================================
+
+## ---- Lines & markers ------------------------------------------------
+lines.linewidth       : 1.2
+lines.markersize      : 4
+lines.markeredgewidth : 0.8
+errorbar.capsize      : 2
+patch.linewidth       : 0.8
+
+## ---- Fonts ----------------------------------------------------------
+font.family      : serif
+font.serif       : Times New Roman, Times, Nimbus Roman, STIXGeneral, DejaVu Serif
+font.size        : 9
+mathtext.fontset : stix          # Times-compatible maths without LaTeX
+
+# Full LaTeX text rendering (needs a working LaTeX installation).
+# Uncomment below, or call plotastro.set_style("aanda", usetex=True).
+#text.usetex         : True
+#text.latex.preamble : \usepackage{newtxtext}\usepackage{newtxmath}
+
+## ---- Axes -----------------------------------------------------------
+axes.linewidth             : 0.6
+axes.labelsize             : medium
+axes.titlesize             : medium
+axes.labelpad              : 3
+axes.axisbelow             : True    # grid behind the data
+axes.formatter.use_mathtext: True
+axes.xmargin               : 0.03
+axes.ymargin               : 0.05
+
+# Colour-blind-friendly colour cycle (see README, "The colour palette")
+axes.prop_cycle : cycler('color', ['377eb8', 'ff7f00', '4daf4a', 'f781bf', 'a65628', '984ea3', '999999', 'e41a1c', 'dede00', 'a2c8ec', 'ffbc79', 'ababab'])
+
+## ---- Grid (subtle; set axes.grid: False to disable) -----------------
+axes.grid      : True
+grid.linewidth : 0.4
+grid.alpha     : 0.25
+
+## ---- Ticks: all four sides, pointing in, with minors ----------------
+xtick.direction     : in
+xtick.top           : True
+xtick.bottom        : True
+xtick.minor.visible : True
+xtick.major.size    : 3.5
+xtick.minor.size    : 2
+xtick.major.width   : 0.6
+xtick.minor.width   : 0.4
+xtick.labelsize     : small      # ~1 pt below the base font size
+
+ytick.direction     : in
+ytick.left          : True
+ytick.right         : True
+ytick.minor.visible : True
+ytick.major.size    : 3.5
+ytick.minor.size    : 2
+ytick.major.width   : 0.6
+ytick.minor.width   : 0.4
+ytick.labelsize     : small
+
+## ---- Legend ---------------------------------------------------------
+legend.fontsize       : small
+legend.title_fontsize : small
+legend.frameon        : False
+legend.handlelength   : 1.8
+legend.handletextpad  : 0.5
+legend.labelspacing   : 0.3
+legend.columnspacing  : 1.2
+legend.borderaxespad  : 0.4
+
+## ---- Figure ---------------------------------------------------------
+figure.figsize                : 3.4646, 2.1412   # one column, golden ratio
+figure.dpi                    : 150              # on-screen / notebook display
+figure.titlesize              : medium
+figure.constrained_layout.use : True             # no cut-off labels
+
+## ---- Images ---------------------------------------------------------
+image.cmap : viridis
+#image.origin : lower    # uncomment for the astro image convention
+
+## ---- Saving ---------------------------------------------------------
+savefig.format     : pdf      # journals prefer vector formats
+savefig.dpi        : 450      # comfortably above journal raster minimums
+savefig.bbox       : tight
+savefig.pad_inches : 0.02
+pdf.fonttype       : 42       # embed TrueType fonts (no Type-3)
+ps.fonttype        : 42

plotastro/styles/apj.mplstyle

@@ -0,0 +1,101 @@
+# =====================================================================
+#  apj.mplstyle — The Astrophysical Journal (ApJ / ApJL, AASTeX v6.3+)
+#
+#  Figure widths:
+#      one column : 242.27 pt = 3.35 in
+#      full width : 513.12 pt = 7.10 in
+#      (from the aastex631 two-column class)
+#  The default figsize below is one column wide with a golden-ratio
+#  height. For other sizes use plotastro.figsize() / plotastro.subplots().
+#
+#  Colours: colour-blind-friendly cycle — see the README for details.
+#  Generated by tools/generate_styles.py — edit that, not this file.
+#
+#  Usage:   import plotastro; plotastro.set_style("apj")
+#     or:   import plotastro; plt.style.use("apj")
+# =====================================================================
+
+## ---- Lines & markers ------------------------------------------------
+lines.linewidth       : 1.2
+lines.markersize      : 4
+lines.markeredgewidth : 0.8
+errorbar.capsize      : 2
+patch.linewidth       : 0.8
+
+## ---- Fonts ----------------------------------------------------------
+font.family      : serif
+font.serif       : Times New Roman, Times, Nimbus Roman, STIXGeneral, DejaVu Serif
+font.size        : 9
+mathtext.fontset : stix          # Times-compatible maths without LaTeX
+
+# Full LaTeX text rendering (needs a working LaTeX installation).
+# Uncomment below, or call plotastro.set_style("apj", usetex=True).
+#text.usetex         : True
+#text.latex.preamble : \usepackage{newtxtext}\usepackage{newtxmath}
+
+## ---- Axes -----------------------------------------------------------
+axes.linewidth             : 0.6
+axes.labelsize             : medium
+axes.titlesize             : medium
+axes.labelpad              : 3
+axes.axisbelow             : True    # grid behind the data
+axes.formatter.use_mathtext: True
+axes.xmargin               : 0.03
+axes.ymargin               : 0.05
+
+# Colour-blind-friendly colour cycle (see README, "The colour palette")
+axes.prop_cycle : cycler('color', ['377eb8', 'ff7f00', '4daf4a', 'f781bf', 'a65628', '984ea3', '999999', 'e41a1c', 'dede00', 'a2c8ec', 'ffbc79', 'ababab'])
+
+## ---- Grid (subtle; set axes.grid: False to disable) -----------------
+axes.grid      : True
+grid.linewidth : 0.4
+grid.alpha     : 0.25
+
+## ---- Ticks: all four sides, pointing in, with minors ----------------
+xtick.direction     : in
+xtick.top           : True
+xtick.bottom        : True
+xtick.minor.visible : True
+xtick.major.size    : 3.5
+xtick.minor.size    : 2
+xtick.major.width   : 0.6
+xtick.minor.width   : 0.4
+xtick.labelsize     : small      # ~1 pt below the base font size
+
+ytick.direction     : in
+ytick.left          : True
+ytick.right         : True
+ytick.minor.visible : True
+ytick.major.size    : 3.5
+ytick.minor.size    : 2
+ytick.major.width   : 0.6
+ytick.minor.width   : 0.4
+ytick.labelsize     : small
+
+## ---- Legend ---------------------------------------------------------
+legend.fontsize       : small
+legend.title_fontsize : small
+legend.frameon        : False
+legend.handlelength   : 1.8
+legend.handletextpad  : 0.5
+legend.labelspacing   : 0.3
+legend.columnspacing  : 1.2
+legend.borderaxespad  : 0.4
+
+## ---- Figure ---------------------------------------------------------
+figure.figsize                : 3.3522, 2.0718   # one column, golden ratio
+figure.dpi                    : 150              # on-screen / notebook display
+figure.titlesize              : medium
+figure.constrained_layout.use : True             # no cut-off labels
+
+## ---- Images ---------------------------------------------------------
+image.cmap : viridis
+#image.origin : lower    # uncomment for the astro image convention
+
+## ---- Saving ---------------------------------------------------------
+savefig.format     : pdf      # journals prefer vector formats
+savefig.dpi        : 450      # comfortably above journal raster minimums
+savefig.bbox       : tight
+savefig.pad_inches : 0.02
+pdf.fonttype       : 42       # embed TrueType fonts (no Type-3)
+ps.fonttype        : 42