anyplotlib 0.1.0__py3-none-any.whl

anyplotlib-0.1.0.dist-info/METADATA

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: anyplotlib
+Version: 0.1.0
+Summary: A plotting library using python, javascript and anywidget for performant in browser plotting.
+Project-URL: Homepage, https://cssfrancis.github.io/anyplotlib/
+Project-URL: Repository, https://github.com/CSSFrancis/anyplotlib
+Project-URL: Bug Tracker, https://github.com/CSSFrancis/anyplotlib/issues
+Author-email: Carter Francis <cartsfrancis@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: anywidget,canvas,interactive,jupyter,plotting,visualization
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Jupyter
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.10
+Requires-Dist: anywidget>=0.9.0
+Requires-Dist: colorcet>=3.0
+Requires-Dist: numpy>=2.0.0
+Requires-Dist: traitlets>=5.0.0
+Provides-Extra: docs
+Requires-Dist: bokeh>=3.0; extra == 'docs'
+Requires-Dist: matplotlib>=3.7; extra == 'docs'
+Requires-Dist: pillow>=10.0; extra == 'docs'
+Requires-Dist: playwright>=1.58.0; extra == 'docs'
+Requires-Dist: plotly>=5.0; extra == 'docs'
+Requires-Dist: pydata-sphinx-theme>=0.16; extra == 'docs'
+Requires-Dist: scipy>=1.15.3; extra == 'docs'
+Requires-Dist: sphinx-design>=0.6; extra == 'docs'
+Requires-Dist: sphinx-gallery>=0.18; extra == 'docs'
+Requires-Dist: sphinx>=8.0; extra == 'docs'
+Provides-Extra: jupyter
+Requires-Dist: jupyterlab>=4.5.5; extra == 'jupyter'
+Description-Content-Type: text/markdown
+
+# anyplotlib
+
+[![codecov](https://codecov.io/gh/CSSFrancis/anyplotlib/branch/main/graph/badge.svg)](https://codecov.io/gh/CSSFrancis/anyplotlib)
+[![Tests](https://github.com/CSSFrancis/anyplotlib/actions/workflows/tests.yml/badge.svg)](https://github.com/CSSFrancis/anyplotlib/actions/workflows/tests.yml)
+
+**anyplotlib** is a fast, interactive plotting library for Jupyter, built on
+[anywidget](https://anywidget.dev/) and a pure-JavaScript canvas renderer.
+It follows matplotlib's object-oriented API — create a `Figure`, call methods
+on `Axes` — so switching is often a one-line change:
+
+```python
+import anyplotlib as apl
+
+fig, ax = apl.subplots(1, 1)        # same shape as plt.subplots(1, 1)
+ax.imshow(data)                     # pan, zoom, and inspect — live
+fig                                 # display in a Jupyter cell
+```
+
+If you have used matplotlib's OO interface, you already know most of
+anyplotlib. What you gain is interactivity that stays fast on large data —
+without a kernel round-trip per frame.
+
+## Why another plotting library?
+
+Matplotlib is a superb tool for publication-quality static figures, but its
+interactive notebook story (`ipympl`) re-renders the whole figure on the
+Python side for every frame. anyplotlib makes the opposite trade-off:
+
+- **All rendering happens in the browser.** Python serialises compact state
+  (raw image bytes, base64-encoded float arrays) once; pan/zoom/drag never
+  touch the kernel.
+- **Each image, line collection, or marker group is a single canvas object**,
+  so blitting works and drag interactions run at full frame rate.
+- **The scope is deliberately limited.** The OO API only (no `plt.plot()`
+  global state), a curated set of plot types and marker styles, and raster
+  canvas output rather than vector graphics. For print-quality SVG/PDF
+  figures, matplotlib remains the right tool.
+
+## Features
+
+- **Plot types** — `plot` (1-D lines with markers, linestyles, legends, log y),
+  `imshow` (2-D images with colormaps, colorbars, scale bars, overlay masks),
+  `pcolormesh` (non-uniform 2-D meshes), `bar` (grouped, horizontal, log,
+  value labels), and 3-D `plot_surface` / `scatter3d` / `plot3d`.
+- **Layouts** — `subplots`, matplotlib-compatible `GridSpec` indexing
+  (slices, spans, negative indices), `width_ratios`/`height_ratios`,
+  `sharex`/`sharey` linked pan-zoom, and floating inset axes with
+  minimize/maximize.
+- **Markers** — static overlays (points, circles, ellipses, rectangles,
+  polygons, arrows, line segments, text, h/v lines) with matplotlib-style
+  kwargs and live `.set()` updates.
+- **Widgets** — draggable overlays (`RectangleWidget`, `CircleWidget`,
+  `AnnularWidget`, `CrosshairWidget`, `PolygonWidget`, `VLineWidget`,
+  `HLineWidget`, `RangeWidget`, …) that report positions back to Python.
+- **Events** — a two-tier callback system: `pointer_move` fires every drag
+  frame for cheap updates; `pointer_settled` / `pointer_up` fire once for
+  expensive recomputation. Plus `key_down`, `wheel`, `double_click`, and
+  per-line scoped handlers.
+- **Interactive docs** — the bundled `anyplotlib.sphinx_anywidget` extension
+  makes any anywidget figure live in Sphinx Gallery pages via Pyodide — no
+  kernel or server needed.
+- **Embeddable anywhere** — figures don't require Jupyter. Export
+  self-contained HTML (`fig.save_html("plot.html")`), mount the renderer
+  directly in an Electron app or web page via the JS `mount()` API, or run a
+  live Python backend over any transport with `anyplotlib.embed.FigureBridge`
+  (full callback support). See the embedding guide in the docs.
+
+```python
+import numpy as np
+import anyplotlib as apl
+
+fig, (ax_img, ax_spec) = apl.subplots(1, 2, figsize=(900, 400))
+img  = ax_img.imshow(stack.mean(axis=2), cmap="viridis")
+spec = ax_spec.plot(stack[64, 64], units="eV")
+
+cross = img.add_widget("crosshair", cx=64, cy=64)
+
+@cross.add_event_handler("pointer_move")   # every drag frame — keep it cheap
+def update(event):
+    spec.set_data(stack[int(cross.cy), int(cross.cx)])
+```
+
+## Installation
+
+```bash
+pip install anyplotlib
+```
+
+Works anywhere anywidget does: JupyterLab, Jupyter Notebook, VS Code,
+PyCharm, Google Colab, and marimo. Dependencies are intentionally light:
+`anywidget`, `numpy`, `traitlets`, and `colorcet` (no matplotlib required).
+
+## Documentation
+
+Full docs, a live example gallery (interactive in the browser — no install),
+and the event-system guide are at
+**[cssfrancis.github.io/anyplotlib](https://cssfrancis.github.io/anyplotlib/)**.
+
+## Development
+
+```bash
+git clone https://github.com/CSSFrancis/anyplotlib
+cd anyplotlib
+uv sync                              # install with dev dependencies
+uv run playwright install chromium   # browsers for rendering tests
+uv run pytest                        # full suite (unit + Playwright + visual)
+make html                            # build the docs locally
+```
+
+The architecture is a single `anywidget.AnyWidget` (`Figure`) that owns all
+traitlets; plot objects are plain Python classes that serialise their state
+dicts to per-panel traits, and `figure_esm.js` renders them. See
+[AGENTS.md](AGENTS.md) for the codebase guide and
+[`anyplotlib/FIGURE_ESM.md`](anyplotlib/FIGURE_ESM.md) for a map of the JS
+renderer.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

anyplotlib-0.1.0.dist-info/RECORD

@@ -0,0 +1,42 @@
+anyplotlib/__init__.py,sha256=_u7ILZ2e7lyQxmpdWiQ6cFqkoo-gMzIdZ4bRT2myvK0,2036
+anyplotlib/_base_plot.py,sha256=iqrsRrm8Slei0n730yp3zLd2EPQeWOyU0jqNuGtUxhU,7740
+anyplotlib/_electron.py,sha256=pCSoUi7jMaucvPd8BsPWtHd1EMZS-SjdDtO9Z1Q9UmU,2245
+anyplotlib/_repr_utils.py,sha256=9oU_v83zffwviO_uhzTUH1uJJrXy530k0TAij61jMfA,12946
+anyplotlib/_utils.py,sha256=RH4N9QhU2RHPxpZXepnKuWpVOM8VrP-7yzcfIWHYkf4,6918
+anyplotlib/callbacks.py,sha256=Pb8eD2Bo-TNLTvE0seig36TFI8JaIdnjxPuHPuflxNY,12285
+anyplotlib/embed.py,sha256=cSDgjRSwqaJb6OvuJ5g3QFlNg0k0EEQH48VtVaR0K_I,7389
+anyplotlib/figure_esm.js,sha256=zljDrA7dsYYWKrCgZSEAj3DuTY5Vi3CV6wUwkjQkwcg,269142
+anyplotlib/markers.py,sha256=VGIN3imVgxMI1vnw0mqOE9q18Aa7qaP_fjEokxF7788,25066
+anyplotlib/axes/__init__.py,sha256=vsMU_WjFcha17Xozxe7v4_oYQ_6qatk8GZlbwKm-cAc,186
+anyplotlib/axes/_axes.py,sha256=7o6gSQWK-85JSaftiDb0x84WFHXM60OLWg0JpFoVW-E,21964
+anyplotlib/axes/_inset_axes.py,sha256=w_7lji2eyiuzGz5vpjMP3I3faPH6MdwSfWLXodq7E4M,4437
+anyplotlib/figure/__init__.py,sha256=9492s6i5zyS47_x4tt9VrP2rFgeajSGuAm6EOH-2V1g,294
+anyplotlib/figure/_figure.py,sha256=H667AK1X32A2vFLlP1sUm97SJ2gkBDa09GeQU5mVnP0,25997
+anyplotlib/figure/_gridspec.py,sha256=LkNepJxzb1ycM3C_uNQlhbq-4LwhGSWt9wIwycT7K5I,3756
+anyplotlib/figure/_subplots.py,sha256=E7kpJ4Y6BA9iXEBLNfSDXJjxf-O-gHQUweHfMd0Nivs,3425
+anyplotlib/plot1d/__init__.py,sha256=xjnzGsO0yjzoE1Rg9yVyFsMgtBzL90jJF7gAFuS0YR0,210
+anyplotlib/plot1d/_plot1d.py,sha256=F64qCQzgSLkj2xWXlMS-2n47GkPBfpcGsdkRx0qMdw0,54308
+anyplotlib/plot1d/_plotbar.py,sha256=2hbj3I86TJr5Zds4a179iNQ9CyQTG8ys9MqY8xBTX_Y,17356
+anyplotlib/plot2d/__init__.py,sha256=g1evLODxN8zPHY4QfS5zEPeuBr_Lu3YIj5bJ1cpBx-M,205
+anyplotlib/plot2d/_plot2d.py,sha256=dl7AHIEiCxNQG5-6zUpPhoS7V8dq5tgrVujPDeItKNI,33442
+anyplotlib/plot2d/_plotmesh.py,sha256=apuGaTApj36sY1fFYr_l3xPie_y5QsiSYG1pAMHsSfg,4533
+anyplotlib/plot3d/__init__.py,sha256=m851XQKGzx5bywIbBK0qntBxzJU7zwxqf6xnOQ8pD1M,138
+anyplotlib/plot3d/_plot3d.py,sha256=dazOH3a8YXtWpEzkhz6f8vEfnX3xJl73UF9NOB6XjVI,21871
+anyplotlib/plotxy/__init__.py,sha256=GsePPwkRzRUxai_vhe1KZpVZgnQIFABFbqw5o3cjU_Q,137
+anyplotlib/plotxy/_plotxy.py,sha256=CP-tj464YhXeELWjJx9XozRAe6KsTnAv3CFSfDIAVKM,13043
+anyplotlib/sphinx_anywidget/__init__.py,sha256=b9BhXg3LoQDYj167Zy5l5d-1sSNIrKIbP4cI_3bFmLA,6559
+anyplotlib/sphinx_anywidget/_directive.py,sha256=_orXovvxqrfHmhu1Wi1DJGx3ITlhi9hdfd0qBaeNYjA,9229
+anyplotlib/sphinx_anywidget/_repr_utils.py,sha256=7Mmcv1gnqiXpRd28i3iiI5Fcmt9iotkJQs8F4Wd3e1w,10144
+anyplotlib/sphinx_anywidget/_scraper.py,sha256=Ku6T63uPvokTMOLalXlenfWCc1gcu1VEI4bvEmjNymo,14660
+anyplotlib/sphinx_anywidget/_wheel_builder.py,sha256=Oi3202dXambMNf5OrObuMic5wkQapHOHzOaWAcsaKyw,2721
+anyplotlib/sphinx_anywidget/static/anywidget_bridge.js,sha256=jPJ7l7JbzoVaFu5ofSbKQ-DGEV-N4n-7NH_9ZarHJrs,47029
+anyplotlib/sphinx_anywidget/static/anywidget_overlay.css,sha256=TlIWo4OUsEZFNROH3UOOpEjrDu8ouulSF-x4qz60ilo,3590
+anyplotlib/widgets/__init__.py,sha256=YUQqQxl2EO_dCMCVWsdZcm9AdzcijHFGOj5zv14V7uQ,633
+anyplotlib/widgets/_base.py,sha256=oWaUFTAmDp1727MGDjK6XUDHxrW5nOhYtrpwXfh5za4,7611
+anyplotlib/widgets/_widgets1d.py,sha256=iFqJd-9qEnB6mXzomUK8xj1dJ5Bpmprkgi7nJ4v1Vb4,3693
+anyplotlib/widgets/_widgets2d.py,sha256=0mjiV5oAgOcWVQsJ63UvdGEgl7-ST-n0BTtX9ogMZWk,4355
+anyplotlib/widgets/_widgets3d.py,sha256=zRd2q5O2KePxU5raCnvO-LatMlpGQjnDMPhG61d40Ks,1638
+anyplotlib-0.1.0.dist-info/METADATA,sha256=55PdoxDikMMFC2rzngYiNI2JRRp2IxUfKF7T6K4WfVk,7068
+anyplotlib-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+anyplotlib-0.1.0.dist-info/licenses/LICENSE,sha256=NonSXCjWxcYbaMxPnkgFzPpP0bVBTwUDpuDKyKC2uvQ,1071
+anyplotlib-0.1.0.dist-info/RECORD,,

anyplotlib-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

anyplotlib-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Carter Francis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.