plot3 0.6.2__py3-none-any.whl → 0.6.4__py3-none-any.whl

plot3/__version__.py

@@ -1 +1 @@
-__version__ = "0.6.2"
+__version__ = "0.6.4"

plot3/contour.py

@@ -115,7 +115,7 @@ def _backend_name() -> str:
         if _load_contourpy() is None:
             raise ValueError(
                 "PLOT3_CONTOUR_BACKEND=contourpy but contourpy>=1.0 is not "
-                "installed. Install it with: pip install plot3[fast]"
+                "installed. Install it with: pip install contourpy"
             )
         return "contourpy"
     if _load_contourpy() is None:
@@ -346,7 +346,7 @@ def _contour_contourpy(
     if contourpy is None:
         raise ValueError(
             "PLOT3_CONTOUR_BACKEND=contourpy but contourpy>=1.0 is not "
-            "installed. Install it with: pip install plot3[fast]"
+            "installed. Install it with: pip install contourpy"
         )
     masked = np.ma.masked_invalid(np.asarray(field, dtype=np.float64))
     generator = contourpy.contour_generator(

plot3/ggplot.py

@@ -517,7 +517,7 @@ class ggplot:
         suffix writes the standalone HTML viewer. ``width`` and ``height``
         are pixels unless ``units`` is ``"in"``, ``"cm"``, or ``"mm"``.
         ``dpi`` is the PNG resolution for a physical size (default 300).
-        PDF needs ``plot3[export]`` and the Cairo C library. ``.svg``
+        PDF needs cairosvg and the Cairo C library. ``.svg``
         needs neither.
         """
         suffix = Path(path).suffix.lower()
@@ -683,8 +683,8 @@ def ggsave(
     """Save ``plot``.
 
     ``ggsave("fig.png", p)`` and ``ggsave("fig.svg", p)`` write a static
-    image. ``ggsave("fig.pdf", p)`` writes a PDF when ``plot3[export]`` is
-    installed. That extra also needs the Cairo C library; ``.svg`` writes
+    image. ``ggsave("fig.pdf", p)`` writes a PDF when cairosvg is
+    installed (``plot3[pdf]``). It also needs the Cairo C library; ``.svg`` writes
     the same drawing with no extra dependencies. Any other suffix,
     including ``.html``, writes the standalone viewer. The plot and the
     filename can be passed in either order.

plot3/static.py

@@ -2,7 +2,7 @@
 
 PNG, SVG, and PDF replay one list of drawing commands. SVG is text.
 PNG and PDF are that same SVG rendered by cairosvg when the optional
-``plot3[export]`` extra is installed, so the three files share one
+``plot3[pdf]`` extra (cairosvg) is installed, so the three files share one
 drawing and one font. That extra needs the Cairo C library as well as
 the Python package (``libcairo2``, or the GTK runtime on Windows).
 Without cairosvg, PNG falls back to a zlib RGB file and a built-in
@@ -42,7 +42,7 @@ _UNIT_INCH = {
 }
 _EXPORT_HINT = (
     "ggsave() needs the Cairo C library to write PDF with a journal font. "
-    "Install the Python extra with: pip install 'plot3[export]'. "
+    "Install it with: pip install cairosvg. "
     "Windows and minimal Linux images also need the Cairo library itself "
     "(for example the libcairo2 package, or the GTK runtime). "
     "ggsave('fig.svg', plot) writes the same drawing with no extra dependencies."
@@ -196,8 +196,8 @@ def save_static(
     ``"cm"`` and ``"mm"``) with ``dpi`` (default 300) sets a physical
     page. Layout stays in CSS pixels (96 per inch) so type keeps its
     size, and cairosvg rasterizes that SVG at ``dpi``. PDF and a
-    journal-font PNG need the Cairo C library (``pip install
-    'plot3[export]'``). ``.svg`` needs nothing extra.
+    journal-font PNG need cairosvg and the Cairo C library (``pip install
+    cairosvg``). ``.svg`` needs nothing extra.
     """
     path = Path(path)
     suffix = path.suffix.lower()
@@ -251,7 +251,7 @@ def save_static(
     if fallback:
         print(
             "plot3: PNG used the built-in font. "
-            "pip install 'plot3[export]' for Helvetica."
+            "pip install cairosvg for Helvetica."
         )
     return str(path)
 

plot3/viewer.py

@@ -55,6 +55,9 @@ body{display:flex;flex-direction:column}
 #legend .sz-block{clear:both;padding-top:6px}
 #legend .bub{display:inline-block;border-radius:50%;box-sizing:border-box;flex:none;
   border:1px solid rgba(0,0,0,.35)}
+#legend.docked{display:flex!important;flex-wrap:wrap;align-items:center;column-gap:14px;row-gap:0;line-height:1.5}
+#legend.docked .sz-block{display:flex;flex-wrap:wrap;align-items:center;column-gap:10px;padding-top:0;clear:none}
+#legend.docked .sz{margin:0}
 #player{display:none;flex:none;align-items:center;flex-wrap:wrap;gap:8px;padding:4px 10px 8px;max-width:100%;box-sizing:border-box}
 #player button{font:inherit;padding:3px 10px;border-radius:5px;cursor:pointer}
 #player #play-range{flex:1;min-width:80px}
@@ -345,19 +348,25 @@ function showLegendBox() {
   legEl.style.border = '1px solid ' + T.grid;
   legEl.style.color = T.ink2;
 }
+// Height the docked legend takes at the bottom; the plot shrinks by it.
+let legendReserve = 0;
 function placeLegend() {
-  if (!legEl || legEl.style.display === 'none' || legEl.dataset.docked === '1') return;
+  legendReserve = 0;
+  if (!legEl || legEl.style.display === 'none') return;
   const figH = figEl.clientHeight || 0;
   if (figH < 40) return;
-  // A key taller than the panel covers the curve. Sit it under the axes.
-  if (legEl.offsetHeight > figH * 0.40) {
+  // A key taller than the panel covers the data (a short notebook output).
+  // Lay it out in rows under the axes, and keep that room free.
+  if (legEl.dataset.docked !== '1' && legEl.offsetHeight > figH * 0.40) {
     legEl.dataset.docked = '1';
+    legEl.classList.add('docked');
     legEl.style.top = 'auto';
-    legEl.style.bottom = '8px';
+    legEl.style.bottom = '6px';
     legEl.style.left = '8px';
     legEl.style.right = '8px';
     legEl.style.maxWidth = 'none';
   }
+  if (legEl.dataset.docked === '1') legendReserve = legEl.offsetHeight + 8;
 }
 const LEGEND_GLYPH = { circle: '●', triangle: '▲', square: '■', diamond: '◆', plus: '+', cross: '×' };
 // Legend keys: a square, the point's symbol, or a short (dashed) line.
@@ -2036,7 +2045,7 @@ if (!S.is3d) {
   function layout() {
     placeLegend();
     W = Math.max(50, figEl.clientWidth - M.l - M.r);
-    H = Math.max(50, figEl.clientHeight - M.t - M.b);
+    H = Math.max(50, figEl.clientHeight - M.t - M.b - legendReserve);
     if (equalAspect) applyEqual();
     host.style.left = M.l + 'px'; host.style.top = M.t + 'px';
     renderer.setSize(W, H);
@@ -2741,7 +2750,7 @@ if (!S.is3d) {
 
   function layout() {
     placeLegend();
-    const w = Math.max(figEl.clientWidth, 1), h = Math.max(figEl.clientHeight, 1);
+    const w = Math.max(figEl.clientWidth, 1), h = Math.max(figEl.clientHeight - legendReserve, 1);
     renderer.setSize(w, h);
     cam.aspect = w / h;
     cam.updateProjectionMatrix();
@@ -2763,7 +2772,7 @@ if (!S.is3d) {
   const touches = (a, b, air) => a[0] - air < b[0] + b[2] && b[0] - air < a[0] + a[2] &&
     a[1] - air < b[1] + b[3] && b[1] - air < a[1] + a[3];
   function declutterTicks() {
-    const w = Math.max(figEl.clientWidth, 1), h = Math.max(figEl.clientHeight, 1);
+    const w = Math.max(figEl.clientWidth, 1), h = Math.max(figEl.clientHeight - legendReserve, 1);
     const placed = [];
     for (const marks of tickSprites) {
       if (!marks.length) continue;

{plot3-0.6.2.dist-info → plot3-0.6.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plot3
-Version: 0.6.2
+Version: 0.6.4
 Summary: ggplot2 grammar of graphics for Python: interactive WebGL figures and journal-ready PNG, SVG, and PDF
 Author: Rigoberto Leyva Salmeron
 License-Expression: MIT
@@ -17,18 +17,12 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy>=1.24
 Requires-Dist: pandas>=2.0
-Provides-Extra: fast
-Requires-Dist: contourpy>=1.0; extra == "fast"
+Provides-Extra: pdf
+Requires-Dist: cairosvg>=2.7; extra == "pdf"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: polars>=1.0; extra == "dev"
 Requires-Dist: contourpy>=1.0; extra == "dev"
-Provides-Extra: jupyter
-Requires-Dist: ipython>=8.0; extra == "jupyter"
-Provides-Extra: polars
-Requires-Dist: polars>=1.0; extra == "polars"
-Provides-Extra: export
-Requires-Dist: cairosvg>=2.7; extra == "export"
 Dynamic: license-file
 
 # plot3
@@ -57,7 +51,7 @@ in the notebook and save as journal-ready PNG, SVG, or PDF.
 </table>
 
 ```bash
-pip install "plot3[jupyter,export]"
+pip install plot3
 ```
 
 Contents: [Plot an equation](#plot-an-equation) ·
@@ -279,27 +273,35 @@ In notebooks, bare column names work as in R: `aes(x=dose, y=response)`.
 ## Install
 
 ```bash
-pip install "plot3[jupyter,export]"
+pip install plot3
 ```
 
 Python 3.10 or newer; NumPy and pandas are the only required packages.
+Notebooks, pandas, and Polars tables work with no extras.
 
-| Extra | Adds |
-|---|---|
-| `export` | `cairosvg`: PNG with real fonts and PDF. Needs the Cairo C library (`brew install cairo`, `apt install libcairo2`). SVG needs nothing. |
-| `fast` | `contourpy`: faster implicit-curve contours (matplotlib users have it) |
-| `jupyter` | IPython integration (bare column names, `%plot3`) |
-| `polars` | Polars tables |
+For PDF, and PNG with real fonts, add cairosvg and the Cairo library. SVG
+needs neither.
+
+```bash
+pip install cairosvg
+```
+
+```bash
+brew install cairo
+```
+
+(`apt install libcairo2` on Debian and Ubuntu.) `pip install "plot3[pdf]"`
+installs plot3 and cairosvg together.
 
 The latest unreleased code installs from GitHub with
-`pip install "plot3[jupyter,export] @ git+https://github.com/rleyvasal/plot3"`.
+`pip install "plot3 @ git+https://github.com/rleyvasal/plot3"`.
 
 ## Development
 
 ```bash
 git clone https://github.com/rleyvasal/plot3 && cd plot3
 python3 -m venv .venv && source .venv/bin/activate
-pip install -e ".[dev,jupyter,export]"
+pip install -e ".[dev]"
 pytest -q                       # includes every example in this README and docs/reference.md
 python examples/showcase_2d.py  # 2D gallery in the browser
 python examples/showcase_3d.py  # 3D gallery

{plot3-0.6.2.dist-info → plot3-0.6.4.dist-info}/RECORD

@@ -1,17 +1,17 @@
 plot3/__init__.py,sha256=-jbV46XmzHZJzv7jrfi50on5Xxs1PJ8U3aV7bbSm1VA,6016
-plot3/__version__.py,sha256=jFlbxEJFS0G44LE-yXXVSwXACA1J_NyYDk5E20_2zpc,22
+plot3/__version__.py,sha256=WMmvm2Keb76yMz8OL_h4fKT34Xpi-1BVfCiTn2QGzz4,22
 plot3/aesexpr.py,sha256=5GbKRX0FZFpDXCDzsZzZW32MKK3uI24Y9nabNJO5RRc,10449
 plot3/build.py,sha256=cEiC9x34uplWWVCuNyAX-vpKbGiF3RIHhCyLHqqJ6EI,171107
 plot3/calculus.py,sha256=yBnZYVHKAehNIdZjYj7fWHadOTQBgSx5Ys8tNQaw11s,45442
 plot3/compose.py,sha256=BICOe1QMnI17k83YqJe8NBKs6lWnjuDox71Sv-erkM0,11513
-plot3/contour.py,sha256=YUrN7rtjjXR8if9L70EMJ6TswWbg9pY6-JSAqADAQEo,20401
+plot3/contour.py,sha256=0EA9EJhhlqq8-cXdqHDnEKoNToNtM5NDp-hhL3z5G9I,20397
 plot3/craft.py,sha256=gZMIrLyY0BJhLNJkBUuP7hEKnkvg7_8M5jITsIFwykA,4639
 plot3/encode.py,sha256=1t1XQwbPV-vKJtTAKkJzr2Kc8umfjsuvffVxyICwcpc,2309
 plot3/expr.py,sha256=lRYeAkMIhQzhwl4uz1oX5zc5SIjJkT6L8FaA_7DuYTY,54584
 plot3/flip.py,sha256=Ox9yxjYzbEpm96raN_qupKru__hEfSMkCZxv01vGOuk,9724
 plot3/function.py,sha256=LYKLPEIdoEp_SnoNYNEXMcV3Mkoh4NyMT1FWyERhZ3c,48749
 plot3/geoms.py,sha256=HsD_opv4cM65XK_X2nMjMz59rZhUS6ajkTK24g1lVAA,90151
-plot3/ggplot.py,sha256=UMurC46txRc2KQgAafDm1qaiLK-vDHE6ulCUxLkyyE8,26719
+plot3/ggplot.py,sha256=_QN6_sFJp2-fVbIM5yBNA4vd54Nd9yez4JU3eoCbCYg,26710
 plot3/io.py,sha256=FirkYHP4r1vaG10dmELCaa7JUwvlc1kwwKtp4zXfXHg,2649
 plot3/jupyter.py,sha256=6EgHacP3eBQ9JGM8nXCNgLosA7tTDFjR-gWij1-oaQM,17790
 plot3/latexin.py,sha256=RrXF6UClHLmsmRH8qCkFOCSgFJxrqPeyzik9t7Ce7iE,21007
@@ -23,13 +23,13 @@ plot3/scales.py,sha256=rBZbM7Z9YcJNjP7Vr3WwAukF2cDqAyGXWPx3Mo8Nko8,14197
 plot3/scaling.py,sha256=3z-m5sGh0BQcQQRIwlsX6tVaGGyMIF2DVcIEGHmY00Y,28316
 plot3/special.py,sha256=ARUav8LGcVe_cPbHoLy73O2U_2wuxUVjvoSwVYfm1-Y,12584
 plot3/stat2d.py,sha256=4a4C3HxBEOeRuMCQXHgLClxFIkPT2-Fz6DJZDev5kdg,66429
-plot3/static.py,sha256=erJR9Hsb_pv_WYYG7xRE-moNbMhON1ce1pu3Rajzv-E,154546
+plot3/static.py,sha256=qzyXkX7AdcQJS4oUadSGuYE1_MTO14e0WuvjMx_qTgc,154532
 plot3/stats3d.py,sha256=B6WCKen7eAHSMlkeo3tnfUGcA1tpdH4OVKOl_5vkbmo,15714
 plot3/table.py,sha256=v4G6NgbEPKv6RakSHLnvfdkWNAaApEgel9be0PzPUMA,26033
 plot3/themes.py,sha256=pQnsBApRRlwQxXPrBFJVYuo6kYan8bgdT3Nlm0T9XFg,5179
-plot3/viewer.py,sha256=tKhBkO7IJpDVs2_NdM87F1O2EVtuAGst1P7bI8gtr_A,141046
-plot3-0.6.2.dist-info/licenses/LICENSE,sha256=OPphTrXUbMt4GNrsK8juVty13iThKFPIPnu_nh4UlAk,1081
-plot3-0.6.2.dist-info/METADATA,sha256=RFUINTip5JKVd8IWARh6jP0av8LFt8aSvDhq9dBqcN0,14318
-plot3-0.6.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-plot3-0.6.2.dist-info/top_level.txt,sha256=wFHSJTzHoaJCrffpONuI8hayEblnTzRMi2y3qCcKzD0,6
-plot3-0.6.2.dist-info/RECORD,,
+plot3/viewer.py,sha256=TWfHDhmzZkowkidsc2elt4lXkFSeQzBfpxjmfKZj264,141647
+plot3-0.6.4.dist-info/licenses/LICENSE,sha256=OPphTrXUbMt4GNrsK8juVty13iThKFPIPnu_nh4UlAk,1081
+plot3-0.6.4.dist-info/METADATA,sha256=U-FW0uwbsM6nQPdDG_DtBvAKmXoqbDnn7qvB-iYdHAo,14007
+plot3-0.6.4.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+plot3-0.6.4.dist-info/top_level.txt,sha256=wFHSJTzHoaJCrffpONuI8hayEblnTzRMi2y3qCcKzD0,6
+plot3-0.6.4.dist-info/RECORD,,