plot3 0.4.0__py3-none-any.whl → 0.4.2__py3-none-any.whl

plot3/__version__.py

@@ -1 +1 @@
-__version__ = "0.4.0"
+__version__ = "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/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/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.dist-info → plot3-0.4.2.dist-info}/METADATA

@@ -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.dist-info → plot3-0.4.2.dist-info}/RECORD

@@ -1,5 +1,5 @@
 plot3/__init__.py,sha256=-jbV46XmzHZJzv7jrfi50on5Xxs1PJ8U3aV7bbSm1VA,6016
-plot3/__version__.py,sha256=42STGor_9nKYXumfeV5tiyD_M8VdcddX7CEexmibPBk,22
+plot3/__version__.py,sha256=6hfVa12Q-nXyUEXr6SyKpqPEDJW6vlRHyPxlA27PfTs,22
 plot3/aesexpr.py,sha256=5GbKRX0FZFpDXCDzsZzZW32MKK3uI24Y9nabNJO5RRc,10449
 plot3/build.py,sha256=ilabpra3FkzL0vBMNx-yhQXOVwJxOlOwakWvWR3gqWM,167841
 plot3/calculus.py,sha256=QONvIZPi4QMAiTUUw3sHe8G3yicgxaMvZN3JLoLcOi0,42272
@@ -9,9 +9,9 @@ plot3/craft.py,sha256=gZMIrLyY0BJhLNJkBUuP7hEKnkvg7_8M5jITsIFwykA,4639
 plot3/encode.py,sha256=1t1XQwbPV-vKJtTAKkJzr2Kc8umfjsuvffVxyICwcpc,2309
 plot3/expr.py,sha256=HMePIjqT4kGfRNhYkSyAfKz_MuGLvQUlZlp_ZNffgqQ,54070
 plot3/flip.py,sha256=Ox9yxjYzbEpm96raN_qupKru__hEfSMkCZxv01vGOuk,9724
-plot3/function.py,sha256=xhU0UGTDlA9nkorOI3stkbHlMwmYWs69Dlrk_CKmqGQ,48377
+plot3/function.py,sha256=LYKLPEIdoEp_SnoNYNEXMcV3Mkoh4NyMT1FWyERhZ3c,48749
 plot3/geoms.py,sha256=O36fCt2nQilbPc3BmD3lEEGFhZa7oX2m4B2cyEReORI,89491
-plot3/ggplot.py,sha256=HEoq5gAtJdy_E_hnOMZWwknKQVz43nTlXn_2Is4p4Tk,26234
+plot3/ggplot.py,sha256=rC--7Dk0ULV95zzeqzQc_XOZZOT0NvYPO3kw8ovJLU8,26573
 plot3/io.py,sha256=FirkYHP4r1vaG10dmELCaa7JUwvlc1kwwKtp4zXfXHg,2649
 plot3/jupyter.py,sha256=6EgHacP3eBQ9JGM8nXCNgLosA7tTDFjR-gWij1-oaQM,17790
 plot3/latexin.py,sha256=RrXF6UClHLmsmRH8qCkFOCSgFJxrqPeyzik9t7Ce7iE,21007
@@ -27,9 +27,9 @@ plot3/static.py,sha256=KrAWbocyejKpi27VEKlJfSTZYcp5mC0IZc_1lDqeH-A,150660
 plot3/stats3d.py,sha256=mRp6n648_yIP7L1e4eh68lzqbT0rwaPOxcAucuEZX4c,16693
 plot3/table.py,sha256=v4G6NgbEPKv6RakSHLnvfdkWNAaApEgel9be0PzPUMA,26033
 plot3/themes.py,sha256=mK9zWm4nRLSDbH2xDJqdrRnnkb9bGUWByyI-x9ZupdU,5145
-plot3/viewer.py,sha256=LiIkh6lsGmm-veV7ZFCOlLqnCiuE_MxznJp8tbWA4fs,140117
-plot3-0.4.0.dist-info/licenses/LICENSE,sha256=OPphTrXUbMt4GNrsK8juVty13iThKFPIPnu_nh4UlAk,1081
-plot3-0.4.0.dist-info/METADATA,sha256=Mvr4DOm5vPhtjL1JuKZ7J6SUGTOjsKrpVdA9SpwsPo8,24408
-plot3-0.4.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-plot3-0.4.0.dist-info/top_level.txt,sha256=wFHSJTzHoaJCrffpONuI8hayEblnTzRMi2y3qCcKzD0,6
-plot3-0.4.0.dist-info/RECORD,,
+plot3/viewer.py,sha256=tKhBkO7IJpDVs2_NdM87F1O2EVtuAGst1P7bI8gtr_A,141046
+plot3-0.4.2.dist-info/licenses/LICENSE,sha256=OPphTrXUbMt4GNrsK8juVty13iThKFPIPnu_nh4UlAk,1081
+plot3-0.4.2.dist-info/METADATA,sha256=CpbQDHQN_LVTjRr60zTEpRIOSAUmLqigX-Jac-DAZ_o,25295
+plot3-0.4.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+plot3-0.4.2.dist-info/top_level.txt,sha256=wFHSJTzHoaJCrffpONuI8hayEblnTzRMi2y3qCcKzD0,6
+plot3-0.4.2.dist-info/RECORD,,