plotnine 0.16.0a10__tar.gz → 0.16.0a12__tar.gz

{plotnine-0.16.0a10 → plotnine-0.16.0a12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plotnine
-Version: 0.16.0a10
+Version: 0.16.0a12
 Summary: A Grammar of Graphics for Python
 Author-email: Hassan Kibirige <has2k1@gmail.com>
 License: The MIT License (MIT)
@@ -44,13 +44,12 @@ Classifier: Topic :: Scientific/Engineering :: Visualization
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: matplotlib>=3.11.0
+Requires-Dist: matplotlib>=3.10.0
 Requires-Dist: pandas>=2.2.0
 Requires-Dist: mizani~=0.14.0
 Requires-Dist: numpy>=1.25.0
 Requires-Dist: scipy>=1.15.0
-Requires-Dist: statsmodels<=0.14.4; sys_platform == "emscripten"
-Requires-Dist: statsmodels>=0.14.6; sys_platform != "emscripten"
+Requires-Dist: statsmodels>=0.14.6
 Provides-Extra: all
 Requires-Dist: plotnine[extra]; extra == "all"
 Requires-Dist: plotnine[doc]; extra == "all"
@@ -75,6 +74,7 @@ Requires-Dist: quartodoc>=0.11.1; extra == "doc"
 Provides-Extra: lint
 Requires-Dist: ruff; extra == "lint"
 Provides-Extra: test
+Requires-Dist: matplotlib>=3.11.0; extra == "test"
 Requires-Dist: pytest-cov>=4.0.0; extra == "test"
 Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
 Requires-Dist: pytest-sugar>=1.1.1; extra == "test"
@@ -86,7 +86,7 @@ Requires-Dist: twine; extra == "dev"
 Requires-Dist: plotnine[typing]; extra == "dev"
 Requires-Dist: pre-commit; extra == "dev"
 Provides-Extra: typing
-Requires-Dist: pyright==1.1.410; extra == "typing"
+Requires-Dist: pyright==1.1.411; extra == "typing"
 Requires-Dist: ipython; extra == "typing"
 Requires-Dist: pandas-stubs; extra == "typing"
 Dynamic: license-file

{plotnine-0.16.0a10 → plotnine-0.16.0a12}/doc/.gitignore

@@ -13,3 +13,5 @@ objects.json
 objects.txt
 objects.inv
 gallery/thumbnails
+
+**/*.quarto_ipynb

{plotnine-0.16.0a10 → plotnine-0.16.0a12}/doc/_quartodoc.yml

@@ -291,6 +291,8 @@ quartodoc:
         - scale_y_sqrt
         - scale_y_symlog
         - scale_y_timedelta
+        - sec_axis
+        - dup_axis
 
     - subtitle: Shape Scales
       options: *no-members
@@ -401,30 +403,78 @@ quartodoc:
       contents:
         - aspect_ratio
         - axis_line
+        - axis_line_r
+        - axis_line_r_end
+        - axis_line_r_start
+        - axis_line_theta
+        - axis_line_theta_inside
+        - axis_line_theta_outside
         - axis_line_x
+        - axis_line_x_bottom
+        - axis_line_x_top
         - axis_line_y
+        - axis_line_y_left
+        - axis_line_y_right
         - axis_text
+        - axis_text_r
+        - axis_text_r_end
+        - axis_text_r_start
+        - axis_text_theta
+        - axis_text_theta_inside
+        - axis_text_theta_outside
         - axis_text_x
+        - axis_text_x_bottom
+        - axis_text_x_top
         - axis_text_y
+        - axis_text_y_left
+        - axis_text_y_right
         - axis_ticks
         - axis_ticks_length
         - axis_ticks_length_major
+        - axis_ticks_length_major_r
+        - axis_ticks_length_major_theta
         - axis_ticks_length_major_x
         - axis_ticks_length_major_y
         - axis_ticks_length_minor
+        - axis_ticks_length_minor_r
+        - axis_ticks_length_minor_theta
         - axis_ticks_length_minor_x
         - axis_ticks_length_minor_y
         - axis_ticks_major
+        - axis_ticks_major_r
+        - axis_ticks_major_r_end
+        - axis_ticks_major_r_start
+        - axis_ticks_major_theta
+        - axis_ticks_major_theta_inside
+        - axis_ticks_major_theta_outside
         - axis_ticks_major_x
+        - axis_ticks_major_x_bottom
+        - axis_ticks_major_x_top
         - axis_ticks_major_y
+        - axis_ticks_major_y_left
+        - axis_ticks_major_y_right
         - axis_ticks_minor
+        - axis_ticks_minor_r
+        - axis_ticks_minor_r_end
+        - axis_ticks_minor_r_start
+        - axis_ticks_minor_theta
+        - axis_ticks_minor_theta_inside
+        - axis_ticks_minor_theta_outside
         - axis_ticks_minor_x
+        - axis_ticks_minor_x_bottom
+        - axis_ticks_minor_x_top
         - axis_ticks_minor_y
+        - axis_ticks_minor_y_left
+        - axis_ticks_minor_y_right
         - axis_ticks_x
         - axis_ticks_y
         - axis_title
         - axis_title_x
+        - axis_title_x_bottom
+        - axis_title_x_top
         - axis_title_y
+        - axis_title_y_left
+        - axis_title_y_right
         - dpi
         - figure_size
         - legend_background
@@ -499,9 +549,17 @@ quartodoc:
         - strip_background
         - strip_background_x
         - strip_background_y
+        - strip_placement
+        - strip_switch_pad
+        - strip_switch_pad_x
+        - strip_switch_pad_y
         - strip_text
         - strip_text_x
+        - strip_text_x_bottom
+        - strip_text_x_top
         - strip_text_y
+        - strip_text_y_left
+        - strip_text_y_right
         - svg_usefonts
         - text
         - title
@@ -535,6 +593,8 @@ quartodoc:
         - coord_equal
         - coord_fixed
         - coord_flip
+        - coord_polar
+        - coord_radial
         - coord_trans
 
     - title: Composing Plots

{plotnine-0.16.0a10 → plotnine-0.16.0a12}/doc/changelog.qmd

@@ -7,6 +7,14 @@ title: Changelog
 
 ### New
 
+- You can now add a secondary axis to a plot, either as a one-to-one
+  transformation of the primary axis with [](:class:`~plotnine.sec_axis`), or as a
+  mirror of the primary axis with [](:func:`~plotnine.dup_axis`).
+
+- [](:class:`~plotnine.coord_radial`) can now draw an angular scale's secondary
+  axis around the inner rim. Add a [](:class:`~plotnine.sec_axis`) to the scale
+  and set `inner_radius > 0`.
+
 - Added [](:class:`~plotnine.composition.plot_layout`) with which you can customise the
   layout of plots in composition.
 
@@ -44,6 +52,39 @@ title: Changelog
 - Added [](:class:`~plotnine.composition.inset_element`) with which you can insert plot
   compositions or images into another plot.
 
+- Position scales gained a `position` parameter, so you can move an axis to the
+  opposite side of the panel. Use `position="top"` for the x axis and
+  `position="right"` for the y axis.
+
+  ```python
+  ggplot(df, aes("x", "y")) + geom_point() + scale_x_continuous(position="top")
+  ```
+
+  Each axis side can be styled independently with new per-side themeables, e.g.
+  `axis_text_x_top`, `axis_title_y_right`, `axis_line_x_top` and
+  `axis_ticks_major_y_right`.
+
+  ```python
+  theme(axis_text_x_top=element_text(color="blue"))
+  ```
+
+- Added the `strip_placement` theme element which controls how a facet strip and
+  a moved axis on the same side are arranged. The default `"inside"` keeps the
+  strip against the panel and places the axis beyond it; `"outside"` places the
+  strip beyond the axis.
+
+  ```python
+  ggplot(df, aes("x", "y"))
+  + geom_point()
+  + facet_grid("a", "b")
+  + scale_x_continuous(position="top")
+  + theme(strip_placement="outside")
+  ```
+
+- [](:class:`~plotnine.facet_wrap`) gained a `strip_position` parameter with
+  which you can place the strip on any side of the panel; `"top"` (default),
+  `"bottom"`, `"left"` or `"right"`.
+
 ### API Changes
 
 - Removed `geom.to_layer()`, `stat.to_layer()`, `annotate.to_layer()`,
@@ -73,8 +114,57 @@ title: Changelog
   `geom="blank"`, `position="identity"` and `na_rm=False`, so all geoms and
   stats include them automatically.
 
+- plotnine now supports Matplotlib 3.10. This allows installation under
+  Pyodide. Matplotlib 3.10 and 3.11 use different text metrics, so text
+  extents, line spacing, and plot margins may differ. Use Matplotlib 3.11 or
+  later to reproduce the documentation output.
+
+- `statsmodels>=0.14.6` is now required on every platform. This replaces the
+  separate `statsmodels<=0.14.4` requirement for Pyodide.
+
 ### Bug Fixes
 
+- [](:class:`~plotnine.scale_size_datetime`) now honours its `range`
+  argument. Previously it was ignored and mapping data raised an error.
+
+- [](:class:`~plotnine.scale_size_datetime`) now honours its `date_breaks`,
+  `date_labels` and `date_minor_breaks` arguments, which it previously
+  ignored.
+
+- In a non-linear coordinate system (e.g. [](:class:`~plotnine.coord_trans`)),
+  the closing edge of a polygon is now curved along with the rest of its
+  boundary instead of being drawn as a straight chord.
+
+- Stacked bars in a non-linear coordinate system (e.g.
+  [](:class:`~plotnine.coord_trans`)) no longer show triangular spikes; each
+  rectangle is now drawn as its own polygon instead of merging a bar's
+  segments into a single path.
+
+- In a non-linear coordinate system (e.g. [](:class:`~plotnine.coord_trans`)),
+  both edges of a [](:class:`~plotnine.geom_ribbon`) or
+  [](:class:`~plotnine.geom_area`) now curve. Previously each edge held the
+  value of the point its segment started from, so the band was drawn as a
+  staircase.
+
+- [](:class:`~plotnine.geom_ribbon`) and [](:class:`~plotnine.geom_area`) now
+  draw every outline type correctly in non-linear coordinate systems. The
+  `upper`, `lower` and `both` outlines follow the transformed band edges, and
+  `full` outlines no longer raise an error.
+
+- [](:class:`~plotnine.annotation_logticks`) and
+  [](:class:`~plotnine.annotation_stripes`) now render correctly in non-linear
+  coordinate systems such as [](:class:`~plotnine.coord_trans`). Previously,
+  log tick positions were transformed twice, which misplaced or removed ticks,
+  and stripes raised an error.
+
+- The space between facet panels now accounts for the margins of the axis
+  text, so with free scales large margins no longer push the tick labels
+  into the neighbouring panel.
+
+- Plot titles in a composition now sit at the same height even when the
+  plots differ in what lies between the title and the panel — facet
+  strips, top legends or a top-positioned x axis.
+
 - Subclass geoms now inherit their parent geom's default parameters, so
   parameters that a parent geom supports are no longer rejected.
   [](:class:`~plotnine.geom_step`) accepts `lineend`, `linejoin` and `arrow`,

{plotnine-0.16.0a10 → plotnine-0.16.0a12}/plotnine/__init__.py

@@ -20,6 +20,8 @@ from .coords import (
     coord_equal,
     coord_fixed,
     coord_flip,
+    coord_polar,
+    coord_radial,
     coord_trans,
 )
 from .facets import (
@@ -119,6 +121,7 @@ from .qplot import (
     qplot,
 )
 from .scales import (
+    dup_axis,
     expand_limits,
     lims,
     scale_alpha,
@@ -217,6 +220,7 @@ from .scales import (
     scale_y_sqrt,
     scale_y_symlog,
     scale_y_timedelta,
+    sec_axis,
     xlim,
     ylim,
 )
@@ -289,7 +293,10 @@ __all__ = (
     "coord_equal",
     "coord_fixed",
     "coord_flip",
+    "coord_polar",
+    "coord_radial",
     "coord_trans",
+    "dup_axis",
     "element_blank",
     "element_line",
     "element_rect",
@@ -461,6 +468,7 @@ __all__ = (
     "scale_y_sqrt",
     "scale_y_symlog",
     "scale_y_timedelta",
+    "sec_axis",
     "stage",
     "stat_bin",
     "stat_bin2d",

plotnine-0.16.0a12/plotnine/_mpl/__init__.py

@@ -0,0 +1,8 @@
+import matplotlib as mpl
+from packaging.version import Version
+
+# Matplotlib 3.10 requires numeric line spacing and produces different text
+# extents from 3.11. Text elements use this flag to convert `normal`; the test
+# suite uses it to require Matplotlib 3.11. Remove the flag and both uses when
+# plotnine requires Matplotlib 3.11.
+MPL_LT_311 = Version(mpl.__version__) < Version("3.11")