plot3 0.4.0__py3-none-any.whl

plot3/themes.py

@@ -0,0 +1,104 @@
+"""Palettes and theme tokens."""
+
+from __future__ import annotations
+
+# Validated: light on #fcfcfb, dark on #0b1020 — dataviz reference
+_CAT_LIGHT = ["#2a78d6", "#1baf7a", "#eda100", "#008300",
+              "#4a3aa7", "#e34948", "#e87ba4", "#eb6834"]
+_CAT_DARK = ["#3987e5", "#199e70", "#c98500", "#008300",
+             "#9085e9", "#e66767", "#d55181", "#d95926"]
+# Sequential blue ramp, steps 100..700 (light -> dark). Light mode uses it as
+# given (low=light); dark mode reversed so "near zero" recedes to the surface.
+_SEQ = ["#cde2fb", "#b7d3f6", "#9ec5f4", "#86b6ef", "#6da7ec", "#5598e7",
+        "#3987e5", "#2a78d6", "#256abf", "#1c5cab", "#184f95", "#104281",
+        "#0d366b"]
+
+# Perceptually-ordered scientific colormaps (exact matplotlib 16-stop hex) —
+# multi-hue but monotonic in lightness, CVD-safe; the lidar/heatmap choice.
+# Same stops in both themes (standard practice for viridis-family maps).
+_VIRIDIS = ["#440154", "#481a6c", "#472f7d", "#414487", "#39568c", "#31688e",
+            "#2a788e", "#23888e", "#1f988b", "#22a884", "#35b779", "#54c568",
+            "#7ad151", "#a5db36", "#d2e21b", "#fde725"]
+_MAGMA = ["#000004", "#0b0924", "#20114b", "#3b0f70", "#57157e", "#721f81",
+          "#8c2981", "#a8327d", "#c43c75", "#de4968", "#f1605d", "#fa7f5e",
+          "#fe9f6d", "#febf84", "#fddea0", "#fcfdbf"]
+_TURBO = ["#30123b", "#4143a7", "#4771e9", "#3e9bfe", "#22c5e2", "#1ae4b6",
+          "#46f884", "#88ff4e", "#b9f635", "#e1dd37", "#faba39", "#fd8d27",
+          "#f05b12", "#d63506", "#af1801", "#7a0403"]
+# Driving-scene height colours: bright green ground, cyan objects, violet
+# and pink for the tallest. Every stop stays visible on black.
+_LIDAR = ["#22b14c", "#2fd35a", "#3fe28a", "#3fe6c8", "#41c8f0", "#5aa0ff",
+          "#8a86ff", "#b07cff", "#e07ce8", "#ff7ad9"]
+_CONT_PALETTES = {"viridis": _VIRIDIS, "magma": _MAGMA, "turbo": _TURBO, "lidar": _LIDAR}
+# Class colours that read on black, for boxes around detected objects.
+_CAT_LIDAR = ["#ff8a80", "#ffffff", "#b39ddb", "#80deea", "#ffe57f",
+              "#a5d6a7", "#f48fb1", "#90caf9"]
+
+# frame is how static export draws the panel: "box" (full rectangle),
+# "axes" (left and bottom only), or "none". The viewer ignores it and
+# strokes T.axis around the panel, so a white axis colour hides that box.
+_THEMES = {
+    "light": dict(
+        surface="#fcfcfb", ink="#0b0b0b", ink2="#52514e", muted="#898781",
+        grid="#e1e0d9", axis="#c3c2b7", cat=_CAT_LIGHT, seq=_SEQ,
+        frame="box",
+    ),
+    "dark": dict(
+        surface="#0b1020", ink="#ffffff", ink2="#c3c2b7", muted="#898781",
+        grid="#1c2742", axis="#2e3a5c", cat=_CAT_DARK,
+        seq=list(reversed(_SEQ)),
+        frame="box",
+    ),
+    # ggplot2 theme_bw: white page, grey major grid, dark panel border.
+    "bw": dict(
+        surface="#ffffff", ink="#000000", ink2="#222222", muted="#4d4d4d",
+        grid="#ebebeb", axis="#333333", cat=_CAT_LIGHT, seq=_SEQ,
+        frame="box",
+    ),
+    # ggplot2 theme_classic: white page, no grid, black axis lines.
+    "classic": dict(
+        surface="#ffffff", ink="#000000", ink2="#000000", muted="#4d4d4d",
+        grid="#ffffff", axis="#000000", cat=_CAT_LIGHT, seq=_SEQ,
+        frame="axes",
+    ),
+    # A driving scene: black page, the data alone, height colours that
+    # stay bright on black. void hides the 3D box, grid, and tick labels.
+    "lidar": dict(
+        surface="#000000", ink="#ffffff", ink2="#c3c2b7", muted="#898781",
+        grid="#000000", axis="#000000", cat=_CAT_LIDAR, seq=_LIDAR,
+        frame="none", void=True, ramp3d="lidar",
+    ),
+    # ggplot2 theme_void: the data alone, no axes, ticks, grid, or box.
+    "void": dict(
+        surface="#ffffff", ink="#000000", ink2="#222222", muted="#4d4d4d",
+        grid="#ffffff", axis="#ffffff", cat=_CAT_LIGHT, seq=_SEQ,
+        frame="none", void=True,
+    ),
+    # ggplot2's default theme_grey: a grey panel with white grid lines.
+    "grey": dict(
+        surface="#ffffff", panel="#ebebeb", ink="#000000", ink2="#000000",
+        muted="#4d4d4d", grid="#ffffff", axis="#ebebeb", cat=_CAT_LIGHT, seq=_SEQ,
+        frame="none",
+    ),
+    # ggplot2 theme_linedraw: white panel, thin dark grid, black border.
+    "linedraw": dict(
+        surface="#ffffff", ink="#000000", ink2="#000000", muted="#000000",
+        grid="#c7c7c7", axis="#000000", cat=_CAT_LIGHT, seq=_SEQ, frame="box",
+    ),
+    # ggplot2 theme_minimal: white page, light grid, no axis box.
+    "minimal": dict(
+        surface="#ffffff", ink="#000000", ink2="#222222", muted="#4d4d4d",
+        grid="#ebebeb", axis="#ffffff", cat=_CAT_LIGHT, seq=_SEQ,
+        frame="none",
+    ),
+}
+
+# What a layer with no colour of its own is drawn in. ggplot2 draws points,
+# lines, and outlines black and bars grey35; the dark viewer theme keeps
+# its own blue, which black would not show on.
+for _name, _theme in _THEMES.items():
+    _light = _theme["surface"].lower() not in {"#0b1020", "#000000"}
+    _theme.setdefault("mark", "#000000" if _light else ("#ffffff" if _name == "lidar" else _theme["cat"][0]))
+    _theme.setdefault("bar", "#595959" if _light else _theme["cat"][0])
+
+