lets-plot 4.4.1__cp311-cp311-macosx_11_0_arm64.whl → 4.5.0rc1__cp311-cp311-macosx_11_0_arm64.whl

lets_plot/_version.py

@@ -3,4 +3,4 @@
 # Use of this source code is governed by the MIT license that can be found in the LICENSE file.
 #
 # see: https://www.python.org/dev/peps/pep-0440/#developmental-releases
-__version__ = '4.4.1'
+__version__ = '4.5.0rc1'

lets_plot/bistro/qq.py

@@ -10,6 +10,7 @@ def qq_plot(data=None, sample=None, *, x=None, y=None,
             distribution=None, dparams=None, quantiles=None,
             group=None,
             show_legend=None,
+            marginal=None,
             color=None, fill=None, alpha=None, size=None, shape=None,
             line_color=None, line_size=None, linetype=None) -> PlotSpec:
     """
@@ -49,6 +50,20 @@ def qq_plot(data=None, sample=None, *, x=None, y=None,
         If it is specified and color-parameters isn't then different groups will has different colors.
     show_legend : bool, default=True
         False - do not show legend.
+    marginal : str, default='dens:tr'
+        Description of marginal layers packed to string value.
+        Different marginals are separated by the ',' char.
+        Parameters of a marginal are separated by the ':' char.
+        First parameter of a marginal is a geometry name.
+        Possible values: 'dens'/'density', 'hist'/'histogram', 'box'/'boxplot'.
+        Second parameter is a string specifying which sides of the plot the marginal layer will appear on.
+        Possible values: 't' (top), 'b' (bottom), 'l' (left), 'r' (right).
+        Third parameter (optional) is size of marginal.
+        To suppress marginals use `marginal='none'`.
+        Examples:
+        "hist:tr:0.3",
+        "dens:tr,hist:bl",
+        "box : tr : .05, dens : bl".
     color : str
         Color of a points.
         For more info see https://lets-plot.org/python/pages/aesthetics.html#color-and-fill.
@@ -67,10 +82,11 @@ def qq_plot(data=None, sample=None, *, x=None, y=None,
         For more info see https://lets-plot.org/python/pages/aesthetics.html#color-and-fill.
     line_size : float, default=0.75
         Width of the fitting line.
-    linetype : int or str
+    linetype : int or str or list
         Type of the fitting line.
-        Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed',
-        3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+        Accept codes or names (0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'),
+        a hex string (up to 8 digits for dash-gap lengths),
+        or a list pattern [offset, [dash, gap, ...]] / [dash, gap, ...].
         For more info see https://lets-plot.org/python/pages/aesthetics.html#line-types.
 
     Returns
@@ -174,6 +190,7 @@ def qq_plot(data=None, sample=None, *, x=None, y=None,
         'quantiles': quantiles,
         'group': group,
         'show_legend': show_legend,
+        'marginal': marginal,
         'color': color,
         'fill': fill,
         'alpha': alpha,

lets_plot/bistro/waterfall.py

@@ -12,6 +12,7 @@ def waterfall_plot(data, x, y, *,
                    width=None,
                    show_legend=None, relative_tooltips=None, absolute_tooltips=None,
                    sorted_value=None, threshold=None, max_values=None,
+                   base=None,
                    calc_total=None, total_title=None,
                    hline=None, hline_ontop=None,
                    connector=None,
@@ -49,10 +50,11 @@ def waterfall_plot(data, x, y, *,
         Line width of the box boundary lines.
     alpha : float
         Transparency level of the boxes. Accept values between 0 and 1.
-    linetype : int or str
+    linetype : int or str or list
         Type of the box boundary lines.
-        Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed',
-        3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+        Accept codes or names (0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'),
+        a hex string (up to 8 digits for dash-gap lengths),
+        or a list pattern [offset, [dash, gap, ...]] / [dash, gap, ...].
         For more info see https://lets-plot.org/python/pages/aesthetics.html#line-types.
     width : float, default=0.9
         Width of the boxes. Typically range between 0 and 1.
@@ -77,6 +79,8 @@ def waterfall_plot(data, x, y, *,
         Groups all categories under a certain threshold value into "Other" category.
     max_values : int
         Groups all categories with the smallest changes, except the first `max_values`, into "Other" category.
+    base : float, default=0.0
+        Values with measure 'absolute' or 'total' are relative to this value.
     calc_total : bool, default=True
         Setting the `calc_total` to True will put the final cumulative sum into a new separate box.
         Taken into account only if the 'measure' column isn't provided.
@@ -235,6 +239,7 @@ def waterfall_plot(data, x, y, *,
         'sorted_value': sorted_value,
         'threshold': threshold,
         'max_values': max_values,
+        'base': base,
         'calc_total': calc_total,
         'total_title': total_title,
         'hline': hline,

lets_plot/export/ggsave_.py

@@ -34,7 +34,7 @@ def ggsave(plot: Union[PlotSpec, SupPlotsSpec, GGBunch], filename: str, *, path:
         to one of the supported formats: SVG, HTML (or HTM), PNG (requires CairoSVG library), PDF.
     path : str
         Path to a directory to save image files in.
-        By default it is ${user.dir}/lets-plot-images.
+        By default, it is ${user.dir}/lets-plot-images.
     iframe : bool, default=True
         Whether to wrap HTML page into a iFrame.
         Only applicable when exporting to HTML.
@@ -60,6 +60,26 @@ def ggsave(plot: Union[PlotSpec, SupPlotsSpec, GGBunch], filename: str, *, path:
     str
         Absolute pathname of created file.
 
+    Notes
+    -----
+    Output format is inferred from the filename extension.
+
+    For PNG and PDF formats:
+
+    1. If `w`, `h`, `unit`, and `dpi` are all specified:
+
+       - `scale` is ignored.
+       - The plot's pixel size (default or set by `ggsize()`) is converted to the specified units using the given dpi.
+       - If the aspect ratio of `w` and `h` differs from the plot's pixel aspect ratio:
+
+         * The plot maintains its original (pixel) aspect ratio.
+         * It's fitted within the specified `w` x `h` area.
+         * Any extra space is left empty.
+
+    2. If `w`, `h` are not specified:
+
+       - The `scale` parameter is used to determine the output size.
+
     Examples
     --------
     .. code-block::