plotnine 0.15.0a6__py3-none-any.whl → 0.15.0a8__py3-none-any.whl

plotnine/composition/_stack.py

@@ -1,14 +1,16 @@
 from __future__ import annotations
 
+from dataclasses import dataclass
 from typing import TYPE_CHECKING
 
-from ._arrange import Arrange
+from ._compose import Compose
 
 if TYPE_CHECKING:
     from plotnine.ggplot import ggplot
 
 
-class Stack(Arrange):
+@dataclass
+class Stack(Compose):
     """
     Place plots or compositions on top of each other
 
@@ -20,6 +22,12 @@ class Stack(Arrange):
         composition / composition
 
     Typically, you will use this class through the `/` operator.
+
+    See Also
+    --------
+    plotnine.composition.Beside : To arrange plots side by side
+    plotnine.composition.plot_spacer : To add a blank space between plots
+    plotnine.composition.Compose : For more on composing plots
     """
 
     @property
@@ -30,7 +38,7 @@ class Stack(Arrange):
     def ncol(self) -> int:
         return 1
 
-    def __truediv__(self, rhs: ggplot | Arrange) -> Arrange:
+    def __truediv__(self, rhs: ggplot | Compose) -> Compose:
         """
         Add rhs as a row
         """
@@ -38,7 +46,7 @@ class Stack(Arrange):
         # operands into a single operation
         return Stack([*self, rhs])
 
-    def __or__(self, rhs: ggplot | Arrange) -> Arrange:
+    def __or__(self, rhs: ggplot | Compose) -> Compose:
         """
         Add rhs as a column
         """

plotnine/geoms/geom_bar.py

@@ -32,6 +32,7 @@ class geom_bar(geom_rect):
     See Also
     --------
     plotnine.geom_histogram
+    plotnine.stat_count : The default `stat` for this `geom`.
     """
 
     REQUIRED_AES = {"x", "y"}

plotnine/geoms/geom_bin_2d.py

@@ -17,6 +17,10 @@ class geom_bin_2d(geom_rect):
     Parameters
     ----------
     {common_parameters}
+
+    See Also
+    --------
+    plotnine.stat_bin_2d : The default stat for this `geom`.
     """
 
     DEFAULT_PARAMS = {"stat": "bin_2d", "position": "identity", "na_rm": False}

plotnine/geoms/geom_boxplot.py

@@ -70,6 +70,10 @@ class geom_boxplot(geom):
     fatten : float, default=2
         A multiplicative factor used to increase the size of the
         middle bar across the box.
+
+    See Also
+    --------
+    plotnine.stat_boxplot : The default `stat` for this `geom`.
     """
 
     DEFAULT_AES = {

plotnine/geoms/geom_count.py

@@ -16,6 +16,10 @@ class geom_count(geom_point):
     Parameters
     ----------
     {common_parameters}
+
+    See Also
+    --------
+    plotnine.stat_sum : The default `stat` for this `geom`.
     """
 
     DEFAULT_PARAMS = {"stat": "sum", "position": "identity", "na_rm": False}

plotnine/geoms/geom_density_2d.py

@@ -14,6 +14,10 @@ class geom_density_2d(geom_path):
     Parameters
     ----------
     {common_parameters}
+
+    See Also
+    --------
+    plotnine.stat_density_2d : The default `stat` for this `geom`.
     """
 
     DEFAULT_PARAMS = {

plotnine/geoms/geom_dotplot.py

@@ -46,7 +46,7 @@ class geom_dotplot(geom):
 
     See Also
     --------
-    plotnine.stat_bindot
+    plotnine.stat_bindot : The default `stat` for this `geom`.
     """
 
     DEFAULT_AES = {"alpha": 1, "color": "black", "fill": "black"}

plotnine/geoms/geom_histogram.py

@@ -15,7 +15,7 @@ class geom_histogram(geom_bar):
 
     See Also
     --------
-    plotnine.geom_bar
+    plotnine.geom_bar : The default `stat` for this `geom`.
     """
 
     DEFAULT_PARAMS = {"stat": "bin", "position": "stack", "na_rm": False}

plotnine/geoms/geom_pointdensity.py

@@ -12,6 +12,10 @@ class geom_pointdensity(geom_point):
     Parameters
     ----------
     {common_parameters}
+
+    See Also
+    --------
+    plotnine.stat_pointdensity : The default `stat` for this `geom`.
     """
 
     DEFAULT_PARAMS = {

plotnine/geoms/geom_qq.py

@@ -12,6 +12,10 @@ class geom_qq(geom_point):
     Parameters
     ----------
     {common_parameters}
+
+    See Also
+    --------
+    plotnine.stat_qq : The default `stat` for this `geom`.
     """
 
     DEFAULT_PARAMS = {"stat": "qq", "position": "identity", "na_rm": False}

plotnine/geoms/geom_qq_line.py

@@ -12,6 +12,10 @@ class geom_qq_line(geom_path):
     Parameters
     ----------
     {common_parameters}
+
+    See Also
+    --------
+    plotnine.stat_qq_line : The default `stat` for this `geom`.
     """
 
     DEFAULT_PARAMS = {

plotnine/geoms/geom_quantile.py

@@ -16,6 +16,10 @@ class geom_quantile(geom_path):
         Line end style. This option is applied for solid linetypes.
     linejoin : Literal["round", "miter", "bevel"], default="round"
         Line join style. This option is applied for solid linetypes.
+
+    See Also
+    --------
+    plotnine.stat_quantile : The default `stat` for this `geom`.
     """
 
     DEFAULT_AES = {

plotnine/geoms/geom_sina.py

@@ -20,7 +20,7 @@ class geom_sina(geom_point):
 
     See Also
     --------
-    plotnine.stat_sina
+    plotnine.stat_sina : The default `stat` for this `geom`.
 
     References
     ----------

plotnine/geoms/geom_smooth.py

@@ -34,6 +34,10 @@ class geom_smooth(geom):
         How much (vertically) of the legend box should be filled by
         the color that indicates the confidence intervals. Should be
         in the range [0, 1].
+
+    See Also
+    --------
+    plotnine.stat_smooth : The default `stat` for this `geom`.
     """
 
     DEFAULT_AES = {

plotnine/geoms/geom_violin.py

@@ -45,6 +45,10 @@ class geom_violin(geom):
         'left-right'  # Alternate (left first) half violins by the group
         'right-left'  # Alternate (right first) half violins by the group
         ```
+
+    See Also
+    --------
+    plotnine.stat_ydensity : The default `stat` for this `geom`.
     """
 
     DEFAULT_AES = {

plotnine/ggplot.py

@@ -52,7 +52,7 @@ if TYPE_CHECKING:
 
     from plotnine import watermark
     from plotnine._mpl.gridspec import p9GridSpec
-    from plotnine.composition import Arrange
+    from plotnine.composition import Compose
     from plotnine.coords.coord import coord
     from plotnine.facets.facet import facet
     from plotnine.layer import layer
@@ -245,7 +245,7 @@ class ggplot:
         self = deepcopy(self)
         return self.__iadd__(rhs)
 
-    def __or__(self, rhs: ggplot | Arrange) -> Arrange:
+    def __or__(self, rhs: ggplot | Compose) -> Compose:
         """
         Compose 2 plots columnwise
         """
@@ -253,7 +253,7 @@ class ggplot:
 
         return Beside([self, rhs])
 
-    def __truediv__(self, rhs: ggplot | Arrange) -> Arrange:
+    def __truediv__(self, rhs: ggplot | Compose) -> Compose:
         """
         Compose 2 plots rowwise
         """
@@ -261,7 +261,7 @@ class ggplot:
 
         return Stack([self, rhs])
 
-    def __sub__(self, rhs: ggplot | Arrange) -> Arrange:
+    def __sub__(self, rhs: ggplot | Compose) -> Compose:
         """
         Compose 2 plots columnwise
         """

plotnine/stats/stat_bin.py

@@ -53,6 +53,10 @@ class stat_bin(stat):
     pad : bool, default=False
         If `True`{.py}, adds empty bins at either side of x.
         This ensures that frequency polygons touch 0.
+
+    See Also
+    --------
+    plotnine.histogram : The default `geom` for this `stat`.
     """
 
     _aesthetics_doc = """

plotnine/stats/stat_bin_2d.py

@@ -35,6 +35,10 @@ class stat_bin_2d(stat):
         the stories in your data.
     drop : bool, default=False
         If `True`{.py}, removes all cells with zero counts.
+
+    See Also
+    --------
+    plotnine.geom_rect : The default `geom` for this `stat`.
     """
 
     _aesthetics_doc = """

plotnine/stats/stat_bindot.py

@@ -68,6 +68,7 @@ class stat_bindot(stat):
 
     See Also
     --------
+    plotnine.geom_dotplot : The default `geom` for this `stat`.
     plotnine.stat_bin
     """
 

plotnine/stats/stat_boxplot.py

@@ -22,7 +22,7 @@ class stat_boxplot(stat):
 
     See Also
     --------
-    plotnine.geom_boxplot
+    plotnine.geom_boxplot: The default `geom` for this `stat`.
     """
 
     _aesthetics_doc = """

plotnine/stats/stat_count.py

@@ -23,6 +23,7 @@ class stat_count(stat):
 
     See Also
     --------
+    plotnine.geom_histogram : The default `geom` for this `stat`.
     plotnine.stat_bin
     """
 

plotnine/stats/stat_density.py

@@ -85,7 +85,7 @@ class stat_density(stat):
 
     See Also
     --------
-    plotnine.geom_density
+    plotnine.geom_density : The default `geom` for this `stat`.
     statsmodels.nonparametric.kde.KDEUnivariate
     statsmodels.nonparametric.kde.KDEUnivariate.fit
     """

plotnine/stats/stat_density_2d.py

@@ -37,6 +37,7 @@ class stat_density_2d(stat):
 
     See Also
     --------
+    plotnine.geom_density_2d : The default `geom` for this `stat`.
     statsmodels.nonparametric.kernel_density.KDEMultivariate
     scipy.stats.gaussian_kde
     sklearn.neighbors.KernelDensity

plotnine/stats/stat_ecdf.py

@@ -25,7 +25,7 @@ class stat_ecdf(stat):
 
     See Also
     --------
-    plotnine.geom_step
+    plotnine.geom_step : The default `geom` for this `stat`.
     """
 
     _aesthetics_doc = """

plotnine/stats/stat_ellipse.py

@@ -37,6 +37,10 @@ class stat_ellipse(stat):
         The confidence level at which to draw the ellipse.
     segments : int, default=51
         Number of segments to be used in drawing the ellipse.
+
+    See Also
+    --------
+    plotnine.geom_path : The default `geom` for this `stat`.
     """
 
     REQUIRED_AES = {"x", "y"}

plotnine/stats/stat_function.py

@@ -37,6 +37,10 @@ class stat_function(stat):
         then the `xlim` must be provided.
     args : Optional[tuple[Any] | dict[str, Any]], default=None
         Arguments to pass to `fun`.
+
+    See Also
+    --------
+    plotnine.geom_path : The default `geom` for this `stat`.
     """
 
     _aesthetics_doc = """

plotnine/stats/stat_hull.py

@@ -26,6 +26,10 @@ class stat_hull(stat):
         Raised when Qhull encounters an error condition,
         such as geometrical degeneracy when options to resolve are
         not enabled.
+
+    See Also
+    --------
+    plotnine.geom_path : The default `geom` for this `stat`.
     """
 
     _aesthetics_doc = """

plotnine/stats/stat_identity.py

@@ -12,6 +12,10 @@ class stat_identity(stat):
     Parameters
     ----------
     {common_parameters}
+
+    See Also
+    --------
+    plotnine.geom_point : The default `geom` for this `stat`.
     """
 
     DEFAULT_PARAMS = {"geom": "point", "position": "identity", "na_rm": False}

plotnine/stats/stat_pointdensity.py

@@ -24,6 +24,7 @@ class stat_pointdensity(stat):
 
     See Also
     --------
+    plotnine.geom_density_2d : The default `geom` for this `stat`.
     statsmodels.nonparametric.kde.KDEMultivariate
     scipy.stats.gaussian_kde
     sklearn.neighbors.KernelDensity

plotnine/stats/stat_qq.py

@@ -47,6 +47,7 @@ class stat_qq(stat):
 
     See Also
     --------
+    plotnine.geom_qq : The default `geom` for this `stat`.
     scipy.stats.mstats.plotting_positions : Uses `alpha_beta`
         to calculate the quantiles.
     """

plotnine/stats/stat_qq_line.py

@@ -41,6 +41,7 @@ class stat_qq_line(stat):
 
     See Also
     --------
+    plotnine.geom_qq_line : The default `geom` for this `stat`.
     scipy.stats.mstats.plotting_positions : Uses `alpha_beta`
         to calculate the quantiles.
     """

plotnine/stats/stat_quantile.py

@@ -29,8 +29,8 @@ class stat_quantile(stat):
 
     See Also
     --------
+    plotnine.geom_quantile : The default `geom` for this `stat`.
     statsmodels.regression.quantile_regression.QuantReg
-    plotnine.geom_quantile
     """
 
     _aesthetics_doc = """

plotnine/stats/stat_sina.py

@@ -69,7 +69,7 @@ class stat_sina(stat):
 
     See Also
     --------
-    plotnine.geom_sina
+    plotnine.geom_sina : The default `geom` for this `stat`.
     """
 
     _aesthetics_doc = """

plotnine/stats/stat_smooth.py

@@ -106,6 +106,7 @@ class stat_smooth(stat):
 
     See Also
     --------
+    plotnine.geom_smooth : The default `geom` for this `stat`.
     statsmodels.regression.linear_model.OLS
     statsmodels.regression.linear_model.WLS
     statsmodels.robust.robust_linear_model.RLM

plotnine/stats/stat_sum.py

@@ -17,6 +17,10 @@ class stat_sum(stat):
     Parameters
     ----------
     {common_parameters}
+
+    See Also
+    --------
+    plotnine.geom_point : The default `geom` for this `stat`.
     """
 
     _aesthetics_doc = """

plotnine/stats/stat_summary.py

@@ -247,7 +247,7 @@ class stat_summary(stat):
 
     See Also
     --------
-    plotnine.geom_pointrange
+    plotnine.geom_pointrange : The default `geom` for this `stat`.
     """
 
     _aesthetics_doc = """

plotnine/stats/stat_summary_bin.py

@@ -63,7 +63,7 @@ class stat_summary_bin(stat):
 
     See Also
     --------
-    plotnine.geom_pointrange
+    plotnine.geom_pointrange : The default `geom` for this `stat`.
     """
 
     _aesthetics_doc = """

plotnine/stats/stat_unique.py

@@ -12,6 +12,10 @@ class stat_unique(stat):
     Parameters
     ----------
     {common_parameters}
+
+    See Also
+    --------
+    plotnine.geom_point : The default `geom` for this `stat`.
     """
 
     DEFAULT_PARAMS = {"geom": "point", "position": "identity", "na_rm": False}

plotnine/stats/stat_ydensity.py

@@ -69,7 +69,7 @@ class stat_ydensity(stat):
 
     See Also
     --------
-    plotnine.geom_violin
+    plotnine.geom_violin : The default `geom` for this `stat`.
     statsmodels.nonparametric.kde.KDEUnivariate
     statsmodels.nonparametric.kde.KDEUnivariate.fit
     """

plotnine/themes/theme.py

@@ -72,7 +72,7 @@ class theme:
         ```
 
         will only modify the x-axis text.
-    kwargs: dict
+    kwargs: Any
         kwargs are `themeables`. The themeables are elements that are
         subclasses of `themeable`. Many themeables are defined using
         theme elements i.e

plotnine/themes/theme_void.py

@@ -25,7 +25,6 @@ class theme_void(theme):
 
     def __init__(self, base_size=11, base_family=None):
         base_family = base_family or get_option("base_family")
-        half_line = base_size / 2
         m = get_option("base_margin")
         # Use only inherited elements and make everything blank
         theme.__init__(
@@ -98,11 +97,6 @@ class theme_void(theme):
             plot_tag_location="margin",
             plot_tag_position="topleft",
             strip_align=0,
-            strip_text=element_text(
-                color="#1A1A1A",
-                size=base_size * 0.8,
-                linespacing=1.5,
-                margin=margin_auto(half_line * 0.8),
-            ),
+            strip_text=element_text(size=base_size * 0.8),
             complete=True,
         )

{plotnine-0.15.0a6.dist-info → plotnine-0.15.0a8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plotnine
-Version: 0.15.0a6
+Version: 0.15.0a8
 Summary: A Grammar of Graphics for Python
 Author-email: Hassan Kibirige <has2k1@gmail.com>
 License: The MIT License (MIT)