ggplot2-python 4.0.2.9000__py3-none-any.whl

ggplot2_python-4.0.2.9000.dist-info/METADATA

@@ -0,0 +1,179 @@
+Metadata-Version: 2.4
+Name: ggplot2-python
+Version: 4.0.2.9000
+Summary: Python port of the R ggplot2 package (tracks R ggplot2 4.0.2.9000)
+Project-URL: Homepage, https://github.com/Bio-Babel/ggplot2-python
+Project-URL: Repository, https://github.com/Bio-Babel/ggplot2-python
+Project-URL: Issues, https://github.com/Bio-Babel/ggplot2-python/issues
+Project-URL: Documentation, https://github.com/Bio-Babel/ggplot2-python#readme
+Author-email: Jeffery Liu <jeffliu.lucky@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: R-port,data-visualization,ggplot2,grammar-of-graphics,plotting,statistical-graphics,visualization
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: contourpy>=1.0
+Requires-Dist: geopandas>=0.12
+Requires-Dist: gtable-python>=0.3.6
+Requires-Dist: matplotlib>=3.6
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=1.5
+Requires-Dist: pillow>=9.0
+Requires-Dist: rgrid-python>=4.5.3
+Requires-Dist: scales-python>=1.4.0
+Requires-Dist: scipy>=1.10
+Requires-Dist: statsmodels>=0.13
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs; extra == 'docs'
+Requires-Dist: mkdocs-jupyter; extra == 'docs'
+Requires-Dist: mkdocs-material; extra == 'docs'
+Requires-Dist: mkdocstrings[python]; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# ggplot2_py <a href="https://github.com/R2pyBioinformatics/ggplot2_py"><img src="assets/ggplot2_py_logo.png" align="right" height="138" alt="ggplot2_py logo" /></a>
+
+AI-assisted Python port of the R **ggplot2** package — Create Elegant Data Visualisations Using the Grammar of Graphics.
+
+## Overview
+
+ggplot2_py implements the grammar of graphics in Python, faithfully porting R's ggplot2 using pandas DataFrames as the data container and a Cairo-based rendering backend. It supports 47 geoms, 32 stats, faceting, coordinate systems, themes, guides, and 130+ scales.
+
+Beyond a direct port, ggplot2_py adds **Python-exclusive features** that extend the Grammar of Graphics with Python-native idioms while preserving full orthogonality of GOG components.
+
+## Python-Exclusive Features
+
+These capabilities have no R equivalent and leverage Python-specific language features:
+
+| Feature | Python mechanism | What it enables |
+|---------|-----------------|-----------------|
+| **Callable `aes()` expressions** | First-class functions / lambdas | `aes(y=lambda d: np.log(d["mpg"]))` — inline data transforms without pre-computing columns |
+| **`after_stat()` / `after_scale()` callables** | Same | `after_stat(lambda d: d["count"] / d["count"].sum())` — arbitrary expressions at each pipeline stage |
+| **`singledispatch` extensibility** | `functools.singledispatch` | `@update_ggplot.register(MyClass)` — any Python class can be added to a plot with `+` |
+| **Build hooks** | Dict-keyed callback lists | `plot.add_build_hook("after", BuildStage.COMPUTE_STAT, fn)` — intercept data at any of 16 named pipeline stages |
+| **Auto-registration** | `__init_subclass__` | `class GeomStar(Geom): ...` auto-registers; no manual wiring needed |
+| **Protocol contracts** | `typing.Protocol` | `isinstance(my_geom, GeomProtocol)` — structural type checking for extensions |
+| **Scoped defaults** | `contextvars.ContextVar` | `with ggplot_defaults(theme=theme_minimal()): ...` — thread-safe scoped defaults |
+
+## Installation
+
+```bash
+# From PyPI
+pip install ggplot2-python
+```
+
+For a local development:
+
+```bash
+git clone https://github.com/Bio-Babel/ggplot2-python.git
+cd ggplot2_py
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+from ggplot2_py import *
+from ggplot2_py.datasets import mpg
+
+(ggplot(mpg, aes(x="displ", y="hwy", colour="class"))
+ + geom_point()
+ + geom_smooth(method="lm")
+ + facet_wrap("drv")
+ + theme_minimal()
+ + labs(title="Engine Displacement vs Highway MPG"))
+```
+
+### Callable expressions in aes (Python-exclusive)
+
+```python
+import numpy as np
+from ggplot2_py import ggplot, aes, geom_point, geom_histogram, after_stat
+
+# Inline data transform — no need to pre-compute a column
+ggplot(mpg, aes(x=lambda d: np.log(d["displ"]), y="hwy")) + geom_point()
+
+# Normalised histogram — callable in after_stat
+(ggplot(mpg, aes(x="hwy"))
+ + geom_histogram(aes(y=after_stat(lambda d: d["count"] / d["count"].sum())), bins=15))
+```
+
+### Extending with custom types (Python-exclusive)
+
+```python
+from ggplot2_py import update_ggplot
+
+class Watermark:
+    def __init__(self, text): self.text = text
+
+@update_ggplot.register(Watermark)
+def _add_watermark(obj, plot, object_name=""):
+    plot.labels["caption"] = f"[{obj.text}]"
+    return plot
+
+# Now use with +
+ggplot(mpg, aes("displ", "hwy")) + geom_point() + Watermark("DRAFT")
+```
+
+### Scoped defaults (Python-exclusive)
+
+```python
+from ggplot2_py import ggplot_defaults
+
+with ggplot_defaults(theme=theme_minimal()):
+    p1 = ggplot(df, aes("x", "y")) + geom_point()   # theme_minimal applied
+    p2 = ggplot(df, aes("x", "y")) + geom_bar()     # theme_minimal applied
+# Outside: no defaults
+```
+
+## Tutorials
+
+### User Tutorials
+- [Getting Started](tutorials/ggplot2.ipynb) — core concepts: data, aes, geoms, stats, scales, facets, coords, themes
+- [Geom Gallery](tutorials/geoms_gallery.ipynb) — boxplot, violin, density, tile, hex and combinations
+- [Labels & Facets](tutorials/labels_and_facets.ipynb) — axis titles, plot title/subtitle/caption, facet strip labels
+- [Aesthetic Specs](tutorials/aesthetic_specs.ipynb) — colour, fill, alpha, linetype, shape, size, colour scales
+- [Extending ggplot2](tutorials/extending_ggplot2.ipynb) — custom stats, geoms, themes via ggproto
+
+### Python-Exclusive Feature Tutorials
+- [Callable aes Expressions](tutorials/aes_expressions.ipynb) — lambdas in `aes()`, `after_stat()`, `after_scale()`, `stage()`
+- [Extensible Pipeline](tutorials/pipeline_dispatch.ipynb) — `singledispatch` registration, custom types with `+`
+- [Build Hooks](tutorials/build_hooks.ipynb) — intercepting the 16-stage build pipeline
+
+### Developer Guide
+- [Developer Guide: Extending ggplot2_py](tutorials/developer_guide.ipynb) — comprehensive guide covering ggproto system, custom Stat/Geom creation, Protocol contracts, singledispatch, hooks, auto-registration, context manager, and packaging
+
+## Extension Architecture
+
+ggplot2_py is designed as an **extensible platform**. The following table summarises all extension points:
+
+| Extension point | Mechanism | How to use |
+|----------------|-----------|-----------|
+| Custom Stat | Subclass `Stat` | Override `compute_group()` — auto-registered via `__init_subclass__` |
+| Custom Geom | Subclass `Geom` | Override `draw_panel()` — auto-registered |
+| Custom Scale | Subclass `ScaleContinuous` / `ScaleDiscrete` | Implement `train()`, `map()`, `get_breaks()` |
+| Custom Coord | Subclass `Coord` | Override `transform()`, `setup_panel_params()` |
+| Custom Facet | Subclass `Facet` | Override `compute_layout()`, `map_data()` |
+| Custom Position | Subclass `Position` | Override `compute_layer()` — auto-registered |
+| Custom `+` types | `@update_ggplot.register(MyClass)` | Register any Python class for the `+` operator |
+| Custom plot types | `@ggplot_build.register(MyPlot)` | Override the entire build pipeline |
+| Build hooks | `plot.add_build_hook(timing, stage, fn)` | Intercept data at any pipeline stage |
+| Protocol validation | `isinstance(obj, GeomProtocol)` | Verify structural conformance |
+| Scoped defaults | `with ggplot_defaults(theme=...):` | Thread-safe scoped defaults |

ggplot2_python-4.0.2.9000.dist-info/RECORD

@@ -0,0 +1,54 @@
+ggplot2_py/__init__.py,sha256=_hNuH6YGAjWUXOM-4J0ledrAIG6EI6Qj9JmIVwf6pTM,24411
+ggplot2_py/_compat.py,sha256=sLzzhq0ii2eSx1xMRaHemNnNqUd6FfT3wRierE1EXCg,10670
+ggplot2_py/_plugins.py,sha256=TLsSEfN5L5VyWtsHaV_fms3TjQezUDUWWEj8ctVxK88,4323
+ggplot2_py/_utils.py,sha256=Qyh2ORUgLlT_rgJ9IaJpzej6G7BIK13nzBR1hF5Zjtw,13612
+ggplot2_py/aes.py,sha256=pGlvRo893GBFE_uxgh6pHrFb0QR2fu57WJ-XfEHzvc0,17031
+ggplot2_py/annotation.py,sha256=g-m5954fFq0FcKnjBBrZTP9m__Kk04df85voCXv_mwE,14863
+ggplot2_py/coord.py,sha256=IxkLU2tZBkWpuo2UVsc54LT7lKuhKm9T9VWO6kXjFmg,65687
+ggplot2_py/datasets.py,sha256=wYFX7mlhe6KiUwggjt6f72-T3ikelwzfdIlttbIu_os,6708
+ggplot2_py/draw_key.py,sha256=apH36BxxjiMxuKjJzpo371I8uk97hy9SDZ1eFBbiC_Y,12472
+ggplot2_py/facet.py,sha256=8mtbAic1dRgoZZtgMrheWa3M_Thy_0KiLw4LUiIs-Cw,46608
+ggplot2_py/fortify.py,sha256=hjIp2EnBnkeVhSUNmXlz4RYVNmuffFHTrHqUdAvFONU,2798
+ggplot2_py/geom.py,sha256=fHC4IIBqm5VZ732zBDGnj3h8VMBblp4RFQZMHSMACZ4,151174
+ggplot2_py/ggproto.py,sha256=cWcEBUHQkSrAitCPv1M7MdLJSXRzskOk-VETKXOeMdA,8510
+ggplot2_py/guide.py,sha256=VIXCNAIcq5QmKfs-y_vC-RSC_QY1YSC58WD4l8t_JDQ,79876
+ggplot2_py/guide_axis.py,sha256=-wfDumlLMriqHp-9k66jKr3ytrin61xe3i8h-DVqSuM,22338
+ggplot2_py/guide_colourbar.py,sha256=cm7kd6Uu8NsaUBWc8jsdkfQcuU_GEGkjCHMqgZyUpzA,20420
+ggplot2_py/guide_legend.py,sha256=duheTtTiTwU6WzjyInrNuJEh8uLKMJ9Y1Ju6UJjhGBc,37298
+ggplot2_py/labeller.py,sha256=vMPePSFy6rRHoKqZOmrdAWh-loQixJggBBn0Zq6Wy2U,7969
+ggplot2_py/labels.py,sha256=8JkSdSdpICcItyBv5RPh4PmzF4TzOnF5_umTHhul5Ro,8306
+ggplot2_py/layer.py,sha256=de6GyIir0L7GLgGQ3e4w3VTKOEwW5h34zmZvlmCg5ZA,29346
+ggplot2_py/layout.py,sha256=QkaGP3anrQYS8vIFMlsz3jKmblHUTYGSevCXIMGlDns,25341
+ggplot2_py/limits.py,sha256=e1WezeXnqPUKn6aaNgyDkLkF1JbxustqfQorKrmjPHI,8219
+ggplot2_py/plot.py,sha256=tMdrEosF9la9rK_QxcRGjFMWvcO7xBg8eG2_kMZy_fM,41102
+ggplot2_py/plot_render.py,sha256=cwdLBFFQn0flsx2L7eg6kPFQ97OMIFprIxqIo1APkIk,29149
+ggplot2_py/position.py,sha256=weKCXpnDtif0NZ9cZqOEs4J96GJhMxUZiBFhZgt0IFM,34339
+ggplot2_py/protocols.py,sha256=7d34T7v7NLg3N1bSEPmmPFrV-5BZvnzBsbpiqnDatZA,5353
+ggplot2_py/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ggplot2_py/qplot.py,sha256=gZ6BWdU2bZwN1zwJCi9unOeWGDVEmV_FQPqb2X6-2TU,6551
+ggplot2_py/save.py,sha256=CVj-oZzdzUm14JQv6nQsaxgJcurDr1M-4Rjs2U0xoqQ,9055
+ggplot2_py/scale.py,sha256=ufYdBhtEv-_KlXYFTzX6iHjS5fd0DTmR1VpE02gSLb8,82254
+ggplot2_py/stat.py,sha256=airtZLlQMoOAMnrn62DoQSMHzAMf8zVEQBQdldl8iWQ,167192
+ggplot2_py/theme.py,sha256=23cbJ64wkfFyw4g474yBFzjFBLtKp3vv61iDdsUA64I,13546
+ggplot2_py/theme_defaults.py,sha256=iA_kJBjjzLpsG7vHzEL5ma7t_9INiy2e6XXtZCfWH68,36311
+ggplot2_py/theme_elements.py,sha256=2e6hMWbLNMPCMqzjlyS1bH6XL5l22EqxdMwKQuqTyw0,63580
+ggplot2_py/coords/__init__.py,sha256=EB2z4ocd6jRlf2f95-_F8xD4aLvf2QFMmqos2PUixiw,834
+ggplot2_py/geoms/__init__.py,sha256=iUCIceJbLSD4TjOtBLCn-8BK2jHVyIJBVYfjTt9BdIA,293
+ggplot2_py/guides/__init__.py,sha256=YPw0bfL6l-xpduIJuwPcq4KVtnJVgOqLcYHzxTh-Fbc,204
+ggplot2_py/resources/diamonds.csv,sha256=lXRzCwOrokHYmcSpdRHFBhsZNY-riVEHdPtsJBaDRcQ,2772143
+ggplot2_py/resources/economics.csv,sha256=BQvcE7wWyfny4D6pB0xP5HHmH_mRjDCqRIuGR_M4GUc,22131
+ggplot2_py/resources/economics_long.csv,sha256=zx_EiNCtKlwl0HEYcv6KoTCAddDumE9cYbYpxCZUCKM,123547
+ggplot2_py/resources/faithfuld.csv,sha256=U2LleBDYmogQb_kDeil2v__YHUCubh8bgzFjyrOdIg4,298297
+ggplot2_py/resources/luv_colours.csv,sha256=L-c3aEHMJPZNcdDKqqU0b90W5FM4UtbEe-Np29LOKRQ,39004
+ggplot2_py/resources/midwest.csv,sha256=FOhp7_w4R-gHqCZJlM5c59-RNbiV07WaIt881IKPt0A,98022
+ggplot2_py/resources/mpg.csv,sha256=FpX7FxpCJOxfkCZS9ghMRr1Sisv1Anj4O6gQTON0Mzw,16046
+ggplot2_py/resources/msleep.csv,sha256=Cm5ArhLjOFXbU5Ubo3slSyZgv36TCjMECQY9L9dY2GM,6773
+ggplot2_py/resources/presidential.csv,sha256=-IVpCt0WvBwYerzte6KOaDBpThxj2GIx49ChOoRcdfk,555
+ggplot2_py/resources/seals.csv,sha256=VEuSEBLz3Fj14eBdM6hp6M6GpH2lqN5ekT_d2Mk1rK0,57035
+ggplot2_py/resources/txhousing.csv,sha256=RdHoH5W9bud_DzsefIc8yNOFaxMl6IDDKMiP68aoIoY,523993
+ggplot2_py/scales/__init__.py,sha256=n1NLGW0cOeFxOYkj_yS2rvec4p9N1ZJBsugPG2TOHgY,100013
+ggplot2_py/stats/__init__.py,sha256=X_WSwq3jS2iJPGy7jEu_tXSQvVrIvC-5pm4ag2qTLVI,222
+ggplot2_python-4.0.2.9000.dist-info/METADATA,sha256=XlPN5apyiqjKVSHhnC7dJyKzRxjthLK8K2BTMvCIUzY,8231
+ggplot2_python-4.0.2.9000.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+ggplot2_python-4.0.2.9000.dist-info/licenses/LICENSE,sha256=E0GJjw07cYRmJYj_8UZKbhevWQ-Swd3nVR6qBddvz9c,39
+ggplot2_python-4.0.2.9000.dist-info/RECORD,,

ggplot2_python-4.0.2.9000.dist-info/WHEEL

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

ggplot2_python-4.0.2.9000.dist-info/licenses/LICENSE

@@ -0,0 +1,3 @@
+# MIT
+
+See DESCRIPTION from R package.