plot3 0.4.1__tar.gz → 0.4.2__tar.gz

{plot3-0.4.1 → plot3-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plot3
-Version: 0.4.1
+Version: 0.4.2
 Summary: ggplot2 grammar of graphics for Python: interactive WebGL figures and journal-ready PNG, SVG, and PDF
 Author: Rigoberto Leyva Salmeron
 License-Expression: MIT

plot3-0.4.2/plot3/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.4.2"

{plot3-0.4.1 → plot3-0.4.2}/plot3/function.py

@@ -135,9 +135,18 @@ def _bind_swept_symbols(geom, formula: Formula, ranges: dict) -> Formula:
     params = dict(getattr(geom, "params", None) or {})
     for name in swept:
         params[name] = float(ranges[name][0])
+    from dataclasses import replace
+
     from plot3.expr import parse_formula
 
-    return parse_formula(source, params, defer_missing=True)
+    bound = parse_formula(source, params, defer_missing=True)
+    # Labels keep the swept symbol: the stand-in value would read "(t = 0)"
+    # in the legend and tooltip on every frame.
+    texts = (
+        "label", "latex", "pretty", "legend_latex", "legend_pretty",
+        "caption_latex", "caption_pretty",
+    )
+    return replace(bound, **{name: getattr(formula, name) for name in texts})
 
 
 def _reject_curve_extras(geom, addons) -> None:

{plot3-0.4.1 → plot3-0.4.2}/plot3/viewer.py

@@ -16,7 +16,8 @@ body{display:flex;flex-direction:column}
 #canvas-host{position:absolute;z-index:1}
 #year{display:none;position:absolute;left:50%;top:46%;transform:translate(-50%,-50%);
   z-index:0;font-weight:700;line-height:1;letter-spacing:-0.04em;opacity:0.13;
-  pointer-events:none;user-select:none}
+  pointer-events:none;user-select:none;font-variant-numeric:tabular-nums;
+  white-space:nowrap;text-align:right}
 #axes{position:absolute;inset:0;pointer-events:none;z-index:2}
 #grid{position:absolute;inset:0;pointer-events:none;z-index:0}
 #legend{position:absolute;right:10px;top:36px;z-index:4;padding:6px 9px;
@@ -1214,6 +1215,27 @@ function fmtParam(v) {
   if (a >= 1e6 || (a > 0 && a < 1e-3)) return v.toExponential(2);
   return v.toFixed(2);
 }
+// The big frame label must not move while it changes: pick one font size
+// for the whole animation and a box as wide as its widest label (in em, so
+// it scales with the window); digits are tabular and right-aligned in it.
+function steadyFrameLabel(el, nF) {
+  const count = Math.min(Math.max(nF, 1), 240);
+  const labels = new Set();
+  for (let i = 0; i < count; i++) {
+    labels.add(frameText(count <= 1 ? 0 : i * (nF - 1) / (count - 1)));
+  }
+  let longest = 0;
+  for (const lab of labels) longest = Math.max(longest, lab.length);
+  el.style.fontSize = longest > 8 ? '56px' : 'min(22vw, 148px)';
+  el.style.width = 'auto';
+  const size = parseFloat(getComputedStyle(el).fontSize) || 1;
+  let widest = 0;
+  for (const lab of labels) {
+    el.textContent = lab;
+    widest = Math.max(widest, el.getBoundingClientRect().width);
+  }
+  el.style.width = (widest / size + 0.05).toFixed(3) + 'em';
+}
 function frameText(t) {
   const tr = S.transition;
   if (tr.params && tr.params.length) {
@@ -1349,6 +1371,7 @@ function installPlayer(renderFrame) {
   btn.style.border = '1px solid ' + T.axis;
   yearEl.style.display = 'block';
   yearEl.style.color = T.ink;
+  steadyFrameLabel(yearEl, nF);
   const titleTemplate = (S.labs && S.labs.title) || '';
   let shownLab = null;
   function syncChrome() {
@@ -1356,7 +1379,6 @@ function installPlayer(renderFrame) {
     frameLabel = lab;
     readout.textContent = lab;
     yearEl.textContent = lab;
-    yearEl.style.fontSize = lab.length > 8 ? '56px' : 'min(22vw, 148px)';
     range.value = (nF <= 1) ? '1000' : String(Math.round(playT / (nF - 1) * 1000));
     btn.textContent = playing ? 'Pause' : 'Play';
     btn.setAttribute('aria-label', playing ? 'Pause' : 'Play');

{plot3-0.4.1 → plot3-0.4.2}/plot3.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plot3
-Version: 0.4.1
+Version: 0.4.2
 Summary: ggplot2 grammar of graphics for Python: interactive WebGL figures and journal-ready PNG, SVG, and PDF
 Author: Rigoberto Leyva Salmeron
 License-Expression: MIT

{plot3-0.4.1 → plot3-0.4.2}/tests/test_animation.py

@@ -639,3 +639,35 @@ def test_slider_refuses_a_grid_that_is_too_large():
             + geom_function("z = a sin(x) cos(y)")
             + slider(a=(0, 1), k=(1, 2), steps=25)
         )
+
+
+def test_frame_label_stays_in_place_while_it_changes():
+    """The big frame label uses one size, a fixed box, and tabular digits."""
+    from plot3 import geom_function, ggplot, transition_time
+
+    doc = (
+        ggplot() + geom_function("y = sin(x - t)") + transition_time(t=(-5, 12))
+    ).html()
+    assert "font-variant-numeric:tabular-nums" in doc.split("#year{", 1)[1].split("}", 1)[0]
+    assert "steadyFrameLabel(yearEl, nF)" in doc
+    # The size is chosen once per animation, not per frame.
+    assert "lab.length > 8" not in doc
+
+
+def test_swept_parameter_is_not_frozen_into_labels():
+    """transition_time(t=...) must not label curves with the first frame's t."""
+    import json
+
+    from plot3 import geom_function, ggplot, transition_time
+    from plot3.build import build_spec
+
+    spec = json.dumps(
+        build_spec(
+            ggplot()
+            + geom_function("y = sin(x - t)")
+            + geom_function("y = a cos(x - t)", a=2)
+            + transition_time(t=(0, 6.28))
+        )
+    )
+    assert "t = 0" not in spec
+    assert "(a = 2)" in spec  # fixed coefficients still show their value

plot3-0.4.1/plot3/__version__.py

@@ -1 +0,0 @@
-__version__ = "0.4.1"