qmlmathplot 0.1.0__py3-none-any.whl

qmlmathplot/themes/ggplot.mplstyle

@@ -0,0 +1,39 @@
+# from https://everyhue.me/posts/sane-color-scheme-for-matplotlib/
+
+patch.linewidth: 0.5
+patch.facecolor: 348ABD  # blue
+patch.edgecolor: EEEEEE
+patch.antialiased: True
+
+font.size: 10.0
+
+axes.facecolor: E5E5E5
+axes.edgecolor: white
+axes.linewidth: 1
+axes.grid: True
+axes.titlesize: x-large
+axes.labelsize: large
+axes.labelcolor: 555555
+axes.axisbelow: True       # grid/ticks are below elements (e.g., lines, text)
+
+axes.prop_cycle: cycler('color', ['E24A33', '348ABD', '988ED5', '777777', 'FBC15E', '8EBA42', 'FFB5B8'])
+                   # E24A33 : red
+                   # 348ABD : blue
+                   # 988ED5 : purple
+                   # 777777 : gray
+                   # FBC15E : yellow
+                   # 8EBA42 : green
+                   # FFB5B8 : pink
+
+xtick.color: 555555
+xtick.direction: out
+
+ytick.color: 555555
+ytick.direction: out
+
+grid.color: white
+grid.linestyle: -    # solid line
+
+figure.facecolor: white
+figure.edgecolor: 0.50
+

qmlmathplot/themes/grayscale.mplstyle

@@ -0,0 +1,29 @@
+# Set all colors to grayscale
+# Note: strings of float values are interpreted by matplotlib as gray values.
+
+
+lines.color: black
+patch.facecolor: gray
+patch.edgecolor: black
+
+text.color: black
+
+axes.facecolor: white
+axes.edgecolor: black
+axes.labelcolor: black
+# black to light gray
+axes.prop_cycle: cycler('color', ['0.00', '0.40', '0.60', '0.70'])
+
+xtick.color: black
+ytick.color: black
+
+grid.color: black
+
+figure.facecolor: 0.75
+figure.edgecolor: white
+
+image.cmap: gray
+
+savefig.facecolor: white
+savefig.edgecolor: white
+

qmlmathplot/themes/petroff10.mplstyle

@@ -0,0 +1,5 @@
+# Color cycle survey palette from Petroff (2021):
+# https://arxiv.org/abs/2107.02270
+# https://github.com/mpetroff/accessible-color-cycles
+axes.prop_cycle: cycler('color', ['3f90da', 'ffa90e', 'bd1f01', '94a4a2', '832db6', 'a96b59', 'e76300', 'b9ac70', '717581', '92dadd'])
+patch.facecolor: 3f90da

qmlmathplot/themes/seaborn-v0_8-bright.mplstyle

@@ -0,0 +1,3 @@
+# Seaborn bright palette
+axes.prop_cycle: cycler('color', ['003FFF', '03ED3A', 'E8000B', '8A2BE2', 'FFC400', '00D7FF'])
+patch.facecolor: 003FFF

qmlmathplot/themes/seaborn-v0_8-colorblind.mplstyle

@@ -0,0 +1,3 @@
+# Seaborn colorblind palette
+axes.prop_cycle: cycler('color', ['0072B2', '009E73', 'D55E00', 'CC79A7', 'F0E442', '56B4E9'])
+patch.facecolor: 0072B2

qmlmathplot/themes/seaborn-v0_8-dark-palette.mplstyle

@@ -0,0 +1,3 @@
+# Seaborn dark palette
+axes.prop_cycle: cycler('color', ['001C7F', '017517', '8C0900', '7600A1', 'B8860B', '006374'])
+patch.facecolor: 001C7F

qmlmathplot/themes/seaborn-v0_8-dark.mplstyle

@@ -0,0 +1,30 @@
+# Seaborn common parameters
+# .15 = dark_gray
+# .8 = light_gray
+figure.facecolor: white
+text.color: .15
+axes.labelcolor: .15
+legend.frameon: False
+legend.numpoints: 1
+legend.scatterpoints: 1
+xtick.direction: out
+ytick.direction: out
+xtick.color: .15
+ytick.color: .15
+axes.axisbelow: True
+image.cmap: Greys
+font.family: sans-serif
+font.sans-serif: Arial, Liberation Sans, DejaVu Sans, Bitstream Vera Sans, sans-serif
+grid.linestyle: -
+lines.solid_capstyle: round
+
+# Seaborn dark parameters
+axes.grid: False
+axes.facecolor: EAEAF2
+axes.edgecolor: white
+axes.linewidth: 0
+grid.color: white
+xtick.major.size: 0
+ytick.major.size: 0
+xtick.minor.size: 0
+ytick.minor.size: 0

qmlmathplot/themes/seaborn-v0_8-darkgrid.mplstyle

@@ -0,0 +1,30 @@
+# Seaborn common parameters
+# .15 = dark_gray
+# .8 = light_gray
+figure.facecolor: white
+text.color: .15
+axes.labelcolor: .15
+legend.frameon: False
+legend.numpoints: 1
+legend.scatterpoints: 1
+xtick.direction: out
+ytick.direction: out
+xtick.color: .15
+ytick.color: .15
+axes.axisbelow: True
+image.cmap: Greys
+font.family: sans-serif
+font.sans-serif: Arial, Liberation Sans, DejaVu Sans, Bitstream Vera Sans, sans-serif
+grid.linestyle: -
+lines.solid_capstyle: round
+
+# Seaborn darkgrid parameters
+axes.grid: True
+axes.facecolor: EAEAF2
+axes.edgecolor: white
+axes.linewidth: 0
+grid.color: white
+xtick.major.size: 0
+ytick.major.size: 0
+xtick.minor.size: 0
+ytick.minor.size: 0

qmlmathplot/themes/seaborn-v0_8-deep.mplstyle

@@ -0,0 +1,3 @@
+# Seaborn deep palette
+axes.prop_cycle: cycler('color', ['4C72B0', '55A868', 'C44E52', '8172B2', 'CCB974', '64B5CD'])
+patch.facecolor: 4C72B0

qmlmathplot/themes/seaborn-v0_8-muted.mplstyle

@@ -0,0 +1,3 @@
+# Seaborn muted palette
+axes.prop_cycle: cycler('color', ['4878CF', '6ACC65', 'D65F5F', 'B47CC7', 'C4AD66', '77BEDB'])
+patch.facecolor: 4878CF

qmlmathplot/themes/seaborn-v0_8-notebook.mplstyle

@@ -0,0 +1,21 @@
+# Seaborn notebook context
+figure.figsize: 8.0, 5.5
+axes.labelsize: 11
+axes.titlesize: 12
+xtick.labelsize: 10
+ytick.labelsize: 10
+legend.fontsize: 10
+
+grid.linewidth: 1
+lines.linewidth: 1.75
+patch.linewidth: .3
+lines.markersize: 7
+lines.markeredgewidth: 0
+
+xtick.major.width: 1
+ytick.major.width: 1
+xtick.minor.width: .5
+ytick.minor.width: .5
+
+xtick.major.pad: 7
+ytick.major.pad: 7

qmlmathplot/themes/seaborn-v0_8-paper.mplstyle

@@ -0,0 +1,21 @@
+# Seaborn paper context
+figure.figsize: 6.4, 4.4
+axes.labelsize: 8.8
+axes.titlesize: 9.6
+xtick.labelsize: 8
+ytick.labelsize: 8
+legend.fontsize: 8
+
+grid.linewidth: 0.8
+lines.linewidth: 1.4
+patch.linewidth: 0.24
+lines.markersize: 5.6
+lines.markeredgewidth: 0
+
+xtick.major.width: 0.8
+ytick.major.width: 0.8
+xtick.minor.width: 0.4
+ytick.minor.width: 0.4
+
+xtick.major.pad: 5.6
+ytick.major.pad: 5.6

qmlmathplot/themes/seaborn-v0_8-pastel.mplstyle

@@ -0,0 +1,3 @@
+# Seaborn pastel palette
+axes.prop_cycle: cycler('color', ['92C6FF', '97F0AA', 'FF9F9A', 'D0BBFF', 'FFFEA3', 'B0E0E6'])
+patch.facecolor: 92C6FF

qmlmathplot/themes/seaborn-v0_8-poster.mplstyle

@@ -0,0 +1,21 @@
+# Seaborn poster context
+figure.figsize: 12.8, 8.8
+axes.labelsize: 17.6
+axes.titlesize: 19.2
+xtick.labelsize: 16
+ytick.labelsize: 16
+legend.fontsize: 16
+
+grid.linewidth: 1.6
+lines.linewidth: 2.8
+patch.linewidth: 0.48
+lines.markersize: 11.2
+lines.markeredgewidth: 0
+
+xtick.major.width: 1.6
+ytick.major.width: 1.6
+xtick.minor.width: 0.8
+ytick.minor.width: 0.8
+
+xtick.major.pad: 11.2
+ytick.major.pad: 11.2

qmlmathplot/themes/seaborn-v0_8-talk.mplstyle

@@ -0,0 +1,21 @@
+# Seaborn talk context
+figure.figsize: 10.4, 7.15
+axes.labelsize: 14.3
+axes.titlesize: 15.6
+xtick.labelsize: 13
+ytick.labelsize: 13
+legend.fontsize: 13
+
+grid.linewidth: 1.3
+lines.linewidth: 2.275
+patch.linewidth: 0.39
+lines.markersize: 9.1
+lines.markeredgewidth: 0
+
+xtick.major.width: 1.3
+ytick.major.width: 1.3
+xtick.minor.width: 0.65
+ytick.minor.width: 0.65
+
+xtick.major.pad: 9.1
+ytick.major.pad: 9.1

qmlmathplot/themes/seaborn-v0_8-ticks.mplstyle

@@ -0,0 +1,30 @@
+# Seaborn common parameters
+# .15 = dark_gray
+# .8 = light_gray
+figure.facecolor: white
+text.color: .15
+axes.labelcolor: .15
+legend.frameon: False
+legend.numpoints: 1
+legend.scatterpoints: 1
+xtick.direction: out
+ytick.direction: out
+xtick.color: .15
+ytick.color: .15
+axes.axisbelow: True
+image.cmap: Greys
+font.family: sans-serif
+font.sans-serif: Arial, Liberation Sans, DejaVu Sans, Bitstream Vera Sans, sans-serif
+grid.linestyle: -
+lines.solid_capstyle: round
+
+# Seaborn white parameters
+axes.grid: False
+axes.facecolor: white
+axes.edgecolor: .15
+axes.linewidth: 1.25
+grid.color: .8
+xtick.major.size: 6
+ytick.major.size: 6
+xtick.minor.size: 3
+ytick.minor.size: 3

qmlmathplot/themes/seaborn-v0_8-white.mplstyle

@@ -0,0 +1,30 @@
+# Seaborn common parameters
+# .15 = dark_gray
+# .8 = light_gray
+figure.facecolor: white
+text.color: .15
+axes.labelcolor: .15
+legend.frameon: False
+legend.numpoints: 1
+legend.scatterpoints: 1
+xtick.direction: out
+ytick.direction: out
+xtick.color: .15
+ytick.color: .15
+axes.axisbelow: True
+image.cmap: Greys
+font.family: sans-serif
+font.sans-serif: Arial, Liberation Sans, DejaVu Sans, Bitstream Vera Sans, sans-serif
+grid.linestyle: -
+lines.solid_capstyle: round
+
+# Seaborn white parameters
+axes.grid: False
+axes.facecolor: white
+axes.edgecolor: .15
+axes.linewidth: 1.25
+grid.color: .8
+xtick.major.size: 0
+ytick.major.size: 0
+xtick.minor.size: 0
+ytick.minor.size: 0

qmlmathplot/themes/seaborn-v0_8-whitegrid.mplstyle

@@ -0,0 +1,30 @@
+# Seaborn common parameters
+# .15 = dark_gray
+# .8 = light_gray
+figure.facecolor: white
+text.color: .15
+axes.labelcolor: .15
+legend.frameon: False
+legend.numpoints: 1
+legend.scatterpoints: 1
+xtick.direction: out
+ytick.direction: out
+xtick.color: .15
+ytick.color: .15
+axes.axisbelow: True
+image.cmap: Greys
+font.family: sans-serif
+font.sans-serif: Arial, Liberation Sans, DejaVu Sans, Bitstream Vera Sans, sans-serif
+grid.linestyle: -
+lines.solid_capstyle: round
+
+# Seaborn whitegrid parameters
+axes.grid: True
+axes.facecolor: white
+axes.edgecolor: .8
+axes.linewidth: 1
+grid.color: .8
+xtick.major.size: 0
+ytick.major.size: 0
+xtick.minor.size: 0
+ytick.minor.size: 0

qmlmathplot/themes/seaborn-v0_8.mplstyle

@@ -0,0 +1,57 @@
+# default seaborn aesthetic
+# darkgrid + deep palette + notebook context
+
+axes.axisbelow: True
+axes.edgecolor: white
+axes.facecolor: EAEAF2
+axes.grid: True
+axes.labelcolor: .15
+axes.labelsize: 11
+axes.linewidth: 0
+axes.prop_cycle: cycler('color', ['4C72B0', '55A868', 'C44E52', '8172B2', 'CCB974', '64B5CD'])
+axes.titlesize: 12
+
+figure.facecolor: white
+figure.figsize: 8.0, 5.5
+
+font.family: sans-serif
+font.sans-serif: Arial, Liberation Sans, DejaVu Sans, Bitstream Vera Sans, sans-serif
+
+grid.color: white
+grid.linestyle: -
+grid.linewidth: 1
+
+image.cmap: Greys
+
+legend.fontsize: 10
+legend.frameon: False
+legend.numpoints: 1
+legend.scatterpoints: 1
+
+lines.linewidth: 1.75
+lines.markeredgewidth: 0
+lines.markersize: 7
+lines.solid_capstyle: round
+
+patch.facecolor: 4C72B0
+patch.linewidth: .3
+
+text.color: .15
+
+xtick.color: .15
+xtick.direction: out
+xtick.labelsize: 10
+xtick.major.pad: 7
+xtick.major.size: 0
+xtick.major.width: 1
+xtick.minor.size: 0
+xtick.minor.width: .5
+
+ytick.color: .15
+ytick.direction: out
+ytick.labelsize: 10
+ytick.major.pad: 7
+ytick.major.size: 0
+ytick.major.width: 1
+ytick.minor.size: 0
+ytick.minor.width: .5

qmlmathplot/themes/tableau-colorblind10.mplstyle

@@ -0,0 +1,3 @@
+# Tableau colorblind 10 palette
+axes.prop_cycle: cycler('color', ['006BA4', 'FF800E', 'ABABAB', '595959', '5F9ED1', 'C85200', '898989', 'A2C8EC', 'FFBC79', 'CFCFCF'])
+patch.facecolor: 006BA4

qmlmathplot/themes.py

@@ -0,0 +1,236 @@
+"""Matplotlib-flavoured themes.
+
+A theme is a set of overrides for a :class:`~qmlmathplot.plot.Plot`'s style properties.
+The bundled ones are Matplotlib's own style sheets, vendored verbatim into
+``qmlmathplot/themes/*.mplstyle`` and redistributed under Matplotlib's BSD license (see
+``themes/LICENSE.matplotlib``). They are converted at load time: Matplotlib's ``rcParams``
+keys are mapped onto this library's property names, and keys that describe things this
+library does not have (spines, figure size, dpi, legend, marker styles, …) are ignored.
+
+    plot.theme = "ggplot"
+    plot.theme = "dark_background"
+    plot.theme = "seaborn-v0_8-darkgrid"
+    plot.theme = "my-style"                  # themes/my-style.mplstyle
+    plot.theme = "path/to/any.mplstyle"      # any file with the same format
+
+The file format is Matplotlib's: ``key: value`` lines, ``#`` starts a comment. Only the
+keys listed in ``_KEY_MAP`` are converted; the rest are dropped silently, so a style sheet
+can be dropped in without editing.
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+__all__ = ["names", "raw", "resolve"]
+
+THEME_DIR = Path(__file__).with_name("themes")
+
+#: Matplotlib sizes are in points; this library's properties are logical pixels.
+PT_TO_PX = 4.0 / 3.0
+
+#: Matplotlib's named font sizes, in points.
+_NAMED_SIZES = {
+    "xx-small": 5.79, "x-small": 6.94, "small": 8.33, "medium": 10.0,
+    "large": 12.0, "x-large": 14.4, "xx-large": 17.28,
+}
+
+_LINE_STYLES = {
+    "solid": "-", "dashed": "--", "dotted": ":", "dashdot": "-.", "none": "", "": "",
+    "-": "-", "--": "--", ":": ":", "-.": "-.",
+}
+
+#: matplotlib's single-letter colour names.
+_SHORT_COLORS = {
+    "b": "blue", "g": "green", "r": "red", "c": "cyan",
+    "m": "magenta", "y": "yellow", "k": "black", "w": "white",
+}
+
+#: Font weights that mean "bold" (matplotlib's ``axes.titleweight``).
+_BOLD_WEIGHTS = frozenset({"bold", "heavy", "semibold", "black"})
+
+#: For every Plot property, the style-sheet keys that can feed it, most specific first.
+#: A key that is absent is skipped; unknown keys are dropped entirely.
+_SOURCES: dict[str, tuple[str, ...]] = {
+    "background": ("axes.facecolor", "figure.facecolor"),
+    "grid": ("axes.grid",),
+    "grid_color": ("grid.color",),
+    "grid_width": ("grid.linewidth",),
+    "grid_alpha": ("grid.alpha",),
+    "grid_style": ("grid.linestyle",),
+    "color_cycle": ("axes.prop_cycle",),
+    "line_width": ("lines.linewidth",),
+    "text_color": ("text.color", "axes.labelcolor"),
+    "tick_color": ("xtick.color", "ytick.color"),
+    "tick_length": ("xtick.major.size", "ytick.major.size"),
+    "font_size": ("font.size",),
+    "tick_font_size": ("xtick.labelsize", "ytick.labelsize"),
+    "title_color": ("axes.titlecolor",),
+    "title_font_size": ("axes.titlesize",),
+    "title_bold": ("axes.titleweight",),
+}
+
+#: Keys whose value is a boolean rather than text.
+_BOOL_KEYS = frozenset({"axes.grid", "axes.titleweight"})
+#: Keys whose value is a size in points (converted to logical pixels).
+_PT_KEYS = frozenset({
+    "grid.linewidth", "lines.linewidth", "xtick.major.size", "ytick.major.size",
+    "font.size", "xtick.labelsize", "ytick.labelsize", "axes.titlesize",
+})
+#: Keys whose value is a colour.
+_COLOR_KEYS = frozenset({
+    "xtick.color", "ytick.color", "text.color", "axes.labelcolor", "axes.titlecolor",
+    "grid.color", "axes.facecolor", "figure.facecolor",
+})
+
+
+def names() -> list[str]:
+    """Names of the bundled themes (file stems), plus ``"default"`` (no overrides)."""
+    stems = sorted(p.stem for p in THEME_DIR.glob("*.mplstyle")) if THEME_DIR.is_dir() else []
+    return ["default", *stems]
+
+
+def raw(name: str) -> dict[str, str]:
+    """The theme's raw ``rcParams`` (key -> text value), before conversion."""
+    if name == "default":
+        return {}
+    path = Path(name)
+    if not path.is_file():
+        path = THEME_DIR / f"{name}.mplstyle"
+    if not path.is_file():
+        raise KeyError(f"unknown theme {name!r}; available: {', '.join(names())}")
+    return _parse(path.read_text(encoding="utf-8"))
+
+
+def resolve(name: str) -> dict[str, object]:
+    """Convert a theme into ``{plot property: value}`` overrides.
+
+    Only keys this library understands are returned; everything else in the style sheet
+    (spines, figure size, dpi, legend, marker styles, …) is dropped, because there is no
+    figure, no axes box and no legend here.
+    """
+    values = raw(name)
+    cycle = _parse_cycle(values.get("axes.prop_cycle", ""))
+    out: dict[str, object] = {}
+    for prop, keys in _SOURCES.items():
+        for key in keys:
+            if key not in values:
+                continue
+            value = _convert(key, values[key], cycle)
+            if value is not None:
+                out[prop] = value
+                break
+    return out
+
+
+def _convert(key: str, text: str, cycle: list[str]) -> object | None:
+    """One style-sheet value -> the value a Plot property expects (``None`` = skip)."""
+    if key == "axes.prop_cycle":
+        return cycle or None
+    if key == "axes.grid":
+        return text.strip().lower() in ("true", "1", "yes", "on")
+    if key == "axes.titleweight":
+        return text.strip().lower() in _BOLD_WEIGHTS
+    if key == "grid.linestyle":
+        return _LINE_STYLES.get(text.strip().lower())
+    if key in _PT_KEYS:
+        return _size(text) * PT_TO_PX if key.endswith("size") else _number(text) * PT_TO_PX
+    if key in _COLOR_KEYS:
+        return _color(text, cycle)
+    return None
+
+
+# --------------------------------------------------------------------------- parsing
+
+
+def _parse(text: str) -> dict[str, str]:
+    """Parse ``key: value`` lines; later keys win (Matplotlib semantics)."""
+    out: dict[str, str] = {}
+    for line in text.splitlines():
+        line = line.split("#", 1)[0].strip() if not line.lstrip().startswith("#") else ""
+        if not line or ":" not in line:
+            continue
+        key, _, value = line.partition(":")
+        out[key.strip()] = value.strip()
+    return out
+
+
+def _number(text: str) -> float:
+    try:
+        return float(text.strip())
+    except ValueError:
+        return 0.0
+
+
+def _size(text: str) -> float:
+    """A font size: a number in points, a named size, or a relative one."""
+    text = text.strip().lower()
+    if text in _NAMED_SIZES:
+        return _NAMED_SIZES[text]
+    try:
+        return float(text)
+    except ValueError:
+        return _NAMED_SIZES["medium"]
+
+
+_CYCLE_LIST = re.compile(r"\[([^\]]*)\]")
+_QUOTED = re.compile(r"['\"]([^'\"]+)['\"]")
+
+
+def _parse_cycle(text: str) -> list[str]:
+    """``cycler('color', ['#1f77b4', …])`` -> the colour list.
+
+    Only the quoted strings *inside the list* count: the first argument of ``cycler`` is the
+    property name (``'color'``) and must not be mistaken for a colour.
+    """
+    if "cycler" not in text:
+        return []
+    inside = _CYCLE_LIST.search(text)
+    if not inside:
+        return []
+    out: list[str] = []
+    for item in _QUOTED.findall(inside.group(1)):
+        value = _color(item, [])
+        if isinstance(value, str):
+            out.append(value)
+    return out
+
+
+def _gray(value: float) -> str:
+    """A 0..1 grayscale value as ``#rrggbb`` (matplotlib's float colour shorthand)."""
+    level = int(round(max(0.0, min(1.0, value)) * 255))
+    return f"#{level:02x}{level:02x}{level:02x}"
+
+
+def _normalise_hex(text: str) -> str:
+    """Matplotlib accepts hex colours without the leading ``#`` (``E24A33``)."""
+    text = text.strip()
+    if re.fullmatch(r"[0-9a-fA-F]{6}", text) or re.fullmatch(r"[0-9a-fA-F]{3}", text):
+        return f"#{text}"
+    return text
+
+
+def _color(text: str, cycle: list[str]) -> str | float | None:
+    """A colour value: ``#rrggbb``, a name, a grayscale float, or ``C0``… from the cycle.
+
+    Returns ``None`` for values that mean "nothing" (``none``), which have no equivalent
+    here because there is no frame or spine to hide.
+    """
+    text = text.strip()
+    low = text.lower()
+    if low in ("none", ""):
+        return None
+    match = re.fullmatch(r"c(\d+)", low)
+    if match:
+        index = int(match.group(1))
+        return cycle[index % len(cycle)] if cycle else None
+    if text in _SHORT_COLORS:       # matplotlib's single-letter names ("w", "k")
+        return _SHORT_COLORS[text]
+    if re.fullmatch(r"[0-9a-fA-F]{6}", text) or re.fullmatch(r"[0-9a-fA-F]{3}", text):
+        return f"#{text}"           # matplotlib accepts hex without the leading '#'
+    try:
+        value = float(text)
+    except ValueError:
+        return text                 # a colour name ("white", "steelblue", …)
+    return _gray(value) if 0.0 <= value <= 1.0 else None   # grayscale shorthand ("0.8")