plot3 0.4.0__tar.gz → 0.4.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plot3
-Version: 0.4.0
+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
@@ -376,13 +376,28 @@ ggplot() + geom_function("y = sin(x - t)") + transition_time(t=(0, 6.28))   # tr
 ggplot() + geom_function("y = dbeta(x, a, b)") + slider(a=(0.5, 5), b=(0.5, 5))
 ```
 
-Data animations follow `gganimate`:
+Data animations follow `gganimate`. With a table shaped like gapminder
+(made-up numbers here; the real data is
+`pl.read_csv("https://raw.githubusercontent.com/kirenz/datasets/master/gapminder.csv")`):
 
-```python notest
-(ggplot(gapminder, aes(x="gdp", y="life", size="pop", colour="continent", group="country"))
+```python
+countries = {"Brazil": "Americas", "China": "Asia", "Egypt": "Africa",
+             "France": "Europe", "India": "Asia", "Mexico": "Americas"}
+gapminder = pd.DataFrame([
+    {"country": country, "continent": continent, "year": year,
+     "gdpPercap": 800 * (1.03 + 0.01 * i) ** (year - 1952),
+     "lifeExp": 45 + 0.35 * (year - 1952) + 2 * i,
+     "pop": 2e7 * (1.02 + 0.002 * i) ** (year - 1952)}
+    for i, (country, continent) in enumerate(countries.items())
+    for year in range(1952, 2008, 5)
+])
+
+(ggplot(gapminder, aes(x="gdpPercap", y="lifeExp", size="pop", colour="continent", group="country"))
  + geom_point() + scale_x_log10() + transition_time("year") + labs(title="{frame_time}"))
 ```
 
+`{frame_time}` in a title shows the current year as the animation plays.
+
 The viewer interpolates between frames in the browser, with play, pause,
 scrubbing, speed, and video recording.
 
@@ -437,7 +452,9 @@ tree) is shortened to twice its width so it does not become a thin column;
 - **SolveIt** draws figures inline and hides their HTML from the model's
   context (`autohide(False)` to opt out).
 - **VS Code notebooks** block WebGL in output cells, so plot3 opens figures
-  in your browser (`PLOT3_DISPLAY=browser|iframe` to force a mode).
+  in your browser (`PLOT3_DISPLAY=browser|iframe` to force a mode). The page
+  is written to `.plot3_preview/latest.html` in the notebook's folder, or to
+  the system temp folder when that folder is read-only.
 - **CRAFT / `%gpu`**: the same `ggplot(...)` code runs on the remote kernel;
   stats run where the data lives and only a compact payload comes back.
 

{plot3-0.4.0 → plot3-0.4.2}/README.md

@@ -343,13 +343,28 @@ ggplot() + geom_function("y = sin(x - t)") + transition_time(t=(0, 6.28))   # tr
 ggplot() + geom_function("y = dbeta(x, a, b)") + slider(a=(0.5, 5), b=(0.5, 5))
 ```
 
-Data animations follow `gganimate`:
+Data animations follow `gganimate`. With a table shaped like gapminder
+(made-up numbers here; the real data is
+`pl.read_csv("https://raw.githubusercontent.com/kirenz/datasets/master/gapminder.csv")`):
 
-```python notest
-(ggplot(gapminder, aes(x="gdp", y="life", size="pop", colour="continent", group="country"))
+```python
+countries = {"Brazil": "Americas", "China": "Asia", "Egypt": "Africa",
+             "France": "Europe", "India": "Asia", "Mexico": "Americas"}
+gapminder = pd.DataFrame([
+    {"country": country, "continent": continent, "year": year,
+     "gdpPercap": 800 * (1.03 + 0.01 * i) ** (year - 1952),
+     "lifeExp": 45 + 0.35 * (year - 1952) + 2 * i,
+     "pop": 2e7 * (1.02 + 0.002 * i) ** (year - 1952)}
+    for i, (country, continent) in enumerate(countries.items())
+    for year in range(1952, 2008, 5)
+])
+
+(ggplot(gapminder, aes(x="gdpPercap", y="lifeExp", size="pop", colour="continent", group="country"))
  + geom_point() + scale_x_log10() + transition_time("year") + labs(title="{frame_time}"))
 ```
 
+`{frame_time}` in a title shows the current year as the animation plays.
+
 The viewer interpolates between frames in the browser, with play, pause,
 scrubbing, speed, and video recording.
 
@@ -404,7 +419,9 @@ tree) is shortened to twice its width so it does not become a thin column;
 - **SolveIt** draws figures inline and hides their HTML from the model's
   context (`autohide(False)` to opt out).
 - **VS Code notebooks** block WebGL in output cells, so plot3 opens figures
-  in your browser (`PLOT3_DISPLAY=browser|iframe` to force a mode).
+  in your browser (`PLOT3_DISPLAY=browser|iframe` to force a mode). The page
+  is written to `.plot3_preview/latest.html` in the notebook's folder, or to
+  the system temp folder when that folder is read-only.
 - **CRAFT / `%gpu`**: the same `ggplot(...)` code runs on the remote kernel;
   stats run where the data lives and only a compact payload comes back.
 

plot3-0.4.2/plot3/__version__.py

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

{plot3-0.4.0 → 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.0 → plot3-0.4.2}/plot3/ggplot.py

@@ -8,6 +8,7 @@ from plot3 import scaling as _scaling
 import html as _htmlesc
 import os
 import sys
+import tempfile
 import webbrowser
 from pathlib import Path
 
@@ -545,7 +546,13 @@ class ggplot:
     ) -> Path:
         if path is None:
             out_dir = Path.cwd() / ".plot3_preview"
-            out_dir.mkdir(parents=True, exist_ok=True)
+            try:
+                out_dir.mkdir(parents=True, exist_ok=True)
+            except OSError:
+                # A kernel started in "/" or another read-only folder (VS
+                # Code does this for notebooks outside a workspace).
+                out_dir = Path(tempfile.gettempdir()) / "plot3_preview"
+                out_dir.mkdir(parents=True, exist_ok=True)
             path = out_dir / "latest.html"
         else:
             path = Path(path)

{plot3-0.4.0 → 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.0 → plot3-0.4.2}/plot3.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plot3
-Version: 0.4.0
+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
@@ -376,13 +376,28 @@ ggplot() + geom_function("y = sin(x - t)") + transition_time(t=(0, 6.28))   # tr
 ggplot() + geom_function("y = dbeta(x, a, b)") + slider(a=(0.5, 5), b=(0.5, 5))
 ```
 
-Data animations follow `gganimate`:
+Data animations follow `gganimate`. With a table shaped like gapminder
+(made-up numbers here; the real data is
+`pl.read_csv("https://raw.githubusercontent.com/kirenz/datasets/master/gapminder.csv")`):
 
-```python notest
-(ggplot(gapminder, aes(x="gdp", y="life", size="pop", colour="continent", group="country"))
+```python
+countries = {"Brazil": "Americas", "China": "Asia", "Egypt": "Africa",
+             "France": "Europe", "India": "Asia", "Mexico": "Americas"}
+gapminder = pd.DataFrame([
+    {"country": country, "continent": continent, "year": year,
+     "gdpPercap": 800 * (1.03 + 0.01 * i) ** (year - 1952),
+     "lifeExp": 45 + 0.35 * (year - 1952) + 2 * i,
+     "pop": 2e7 * (1.02 + 0.002 * i) ** (year - 1952)}
+    for i, (country, continent) in enumerate(countries.items())
+    for year in range(1952, 2008, 5)
+])
+
+(ggplot(gapminder, aes(x="gdpPercap", y="lifeExp", size="pop", colour="continent", group="country"))
  + geom_point() + scale_x_log10() + transition_time("year") + labs(title="{frame_time}"))
 ```
 
+`{frame_time}` in a title shows the current year as the animation plays.
+
 The viewer interpolates between frames in the browser, with play, pause,
 scrubbing, speed, and video recording.
 
@@ -437,7 +452,9 @@ tree) is shortened to twice its width so it does not become a thin column;
 - **SolveIt** draws figures inline and hides their HTML from the model's
   context (`autohide(False)` to opt out).
 - **VS Code notebooks** block WebGL in output cells, so plot3 opens figures
-  in your browser (`PLOT3_DISPLAY=browser|iframe` to force a mode).
+  in your browser (`PLOT3_DISPLAY=browser|iframe` to force a mode). The page
+  is written to `.plot3_preview/latest.html` in the notebook's folder, or to
+  the system temp folder when that folder is read-only.
 - **CRAFT / `%gpu`**: the same `ggplot(...)` code runs on the remote kernel;
   stats run where the data lives and only a compact payload comes back.
 

{plot3-0.4.0 → 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.0 → plot3-0.4.2}/tests/test_payload_display.py

@@ -114,3 +114,29 @@ def test_freeze_faceted_raises(cars):
     fig = ggplot(cars, aes(x="wt", y="mpg")) + geom_point() + facet_wrap("cyl")
     with pytest.raises(ValueError, match="facet"):
         fig.freeze()
+
+
+def test_browser_preview_falls_back_when_the_folder_is_read_only(tmp_path, monkeypatch):
+    """A kernel started in a read-only folder ("/" in VS Code) still shows plots."""
+    import importlib
+    import os
+    import tempfile
+
+    gg = importlib.import_module("plot3.ggplot")
+
+    if os.name == "nt" or os.geteuid() == 0:
+        pytest.skip("needs a folder the test user cannot write to")
+    locked = tmp_path / "locked"
+    locked.mkdir()
+    locked.chmod(0o555)
+    monkeypatch.chdir(locked)
+    monkeypatch.setattr(gg.webbrowser, "open", lambda *_a, **_k: None)
+    monkeypatch.setattr(tempfile, "tempdir", str(tmp_path / "tmp"))
+    (tmp_path / "tmp").mkdir()
+    fig = ggplot({"x": [1, 2], "y": [3, 4]}, aes(x="x", y="y")) + geom_point()
+    try:
+        out = fig.show(browser=True)
+    finally:
+        locked.chmod(0o755)
+    assert out == (tmp_path / "tmp" / "plot3_preview" / "latest.html").resolve()
+    assert out.read_text(encoding="utf-8").startswith("<!")

plot3-0.4.0/plot3/__version__.py

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