lets-plot 4.6.0a2__cp312-cp312-macosx_11_0_arm64.whl → 4.6.1__cp312-cp312-macosx_11_0_arm64.whl

lets_plot/plot/geom.py

@@ -939,8 +939,8 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
     threshold : float, default=None
-        If a bin's `..count..` is less than the threshold, the bin will be removed.
-        Dropping empty bins is particularly useful for faceted plots with free scales.
+        If a bin's `..count..` is less than the threshold, it will be removed, but only if it is on the left or right edge of the histogram.
+        Dropping empty edge bins is particularly useful for faceted plots with free scales.
     tooltips : `layer_tooltips`
         Result of the call to the `layer_tooltips()` function.
         Specify appearance, style and content.
@@ -1253,10 +1253,6 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
     Apply a rectangular grid to the plane, count observations in each cell (bin) of the grid,
     and map the count to the fill color of the cell (tile).
 
-    By default, this geom uses `coord_fixed()`.
-    However, this may not be the best choice when the values on the X/Y axis have significantly different magnitudes.
-    In such cases, try using `coord_cartesian()`.
-
     Parameters
     ----------
     mapping : `FeatureSpec`
@@ -1427,16 +1423,13 @@ def geom_hex(mapping=None, *, data=None, stat=None, position=None, show_legend=N
              bins=None,
              binwidth=None,
              drop=None,
+             width_unit=None, height_unit=None,
              color_by=None, fill_by=None,
              **other_args):
     """
     Apply a hexagonal grid to the plane, count observations in each cell (hexagonal bin) of the grid,
     and map the count to the fill color of the cell (hexagonal tile).
 
-    By default, this geom uses `coord_fixed()`.
-    However, this may not be the best choice when the values on the X/Y axis have significantly different magnitudes.
-    In such cases, try using `coord_cartesian()`.
-
     Parameters
     ----------
     mapping : `FeatureSpec`
@@ -1473,6 +1466,24 @@ def geom_hex(mapping=None, *, data=None, stat=None, position=None, show_legend=N
         Override `bins`. The default is to use bin widths that cover the entire range of the data.
     drop : bool, default=True
         Specify whether to remove all hexagonal bins with 0 counts.
+    width_unit : {'res', 'identity', 'size', 'px'}, default='res'
+        Unit for width of the hexagon.
+        Possible values:
+
+        - 'res': if `stat='binhex'`, the unit equals the hexagonal bin width (`binwidth[0]`); otherwise, it represents the smallest distance between adjacent hexagons along the corresponding axis;
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
+
+    height_unit : {'res', 'identity', 'size', 'px'}, default='res'
+        Unit for height of the hexagon.
+        Possible values:
+
+        - 'res': if `stat='binhex'`, the unit equals the hexagonal bin height (`binwidth[1]`); otherwise, it represents the smallest distance between adjacent hexagons along the corresponding axis;
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
+
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
         Define the color aesthetic for the geometry.
     fill_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='fill'
@@ -1570,6 +1581,21 @@ def geom_hex(mapping=None, *, data=None, stat=None, position=None, show_legend=N
                        fill='darkgreen') + \\
             ggsize(600, 450)
 
+    |
+
+    .. jupyter-execute::
+        :linenos:
+        :emphasize-lines: 7-8
+
+        import numpy as np
+        from lets_plot import *
+        LetsPlot.setup_html()
+        np.random.seed(42)
+        x, y = np.random.multivariate_normal(mean=[-98, 39], cov=[[100, 0], [0, 10]], size=100).T
+        ggplot() + geom_livemap() + \\
+            geom_hex(aes(x, y, fill='..density..'), \\
+                     bins=[10, 5], alpha=.5, show_legend=False)
+
     """
     return _geom('hex',
                  mapping=mapping,
@@ -1584,6 +1610,7 @@ def geom_hex(mapping=None, *, data=None, stat=None, position=None, show_legend=N
                  bins=bins,
                  binwidth=binwidth,
                  drop=drop,
+                 width_unit=width_unit, height_unit=height_unit,
                  color_by=color_by, fill_by=fill_by,
                  **other_args)
 
@@ -1591,6 +1618,7 @@ def geom_hex(mapping=None, *, data=None, stat=None, position=None, show_legend=N
 def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
               manual_key=None, sampling=None,
               tooltips=None,
+              width_unit=None, height_unit=None,
               color_by=None, fill_by=None,
               **other_args):
     """
@@ -1625,6 +1653,24 @@ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=
         Result of the call to the `layer_tooltips()` function.
         Specify appearance, style and content.
         Set tooltips='none' to hide tooltips from the layer.
+    width_unit : {'res', 'identity', 'size', 'px'}, default='res'
+        Unit for width of the tile.
+        Possible values:
+
+        - 'res': the unit equals the smallest distance between adjacent tiles along the corresponding axis;
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
+
+    height_unit : {'res', 'identity', 'size', 'px'}, default='res'
+        Unit for height of the tile.
+        Possible values:
+
+        - 'res': the unit equals the smallest distance between adjacent tiles along the corresponding axis;
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
+
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
         Define the color aesthetic for the geometry.
     fill_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='fill'
@@ -1736,6 +1782,8 @@ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
+                 width_unit=width_unit,
+                 height_unit=height_unit,
                  color_by=color_by, fill_by=fill_by,
                  **other_args)
 
@@ -1838,6 +1886,7 @@ def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legen
 def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
                   manual_key=None,
                   sampling=None, tooltips=None,
+                  width_unit=None,
                   color_by=None,
                   **other_args):
     """
@@ -1877,6 +1926,15 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
         Result of the call to the `layer_tooltips()` function.
         Specify appearance, style and content.
         Set tooltips='none' to hide tooltips from the layer.
+    width_unit : {'res', 'identity', 'size', 'px'}, default='res'
+        Unit for the whisker width of the error bar.
+        Possible values:
+
+        - 'res': the unit equals the smallest distance between adjacent error bars along the corresponding axis;
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
+
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
         Define the color aesthetic for the geometry.
     other_args
@@ -1903,7 +1961,7 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry lines. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
     - size : line width. Define bar line width.
-    - width or height : size of the whiskers of vertical or horizontal bar, respectively. Typically range between 0 and 1. Values that are greater than 1 lead to overlapping of the bars.
+    - width : size of the whiskers of error bar. Typically range between 0 and 1. Values that are greater than 1 lead to overlapping of the bars.
     - linetype : type of the line. 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 `Line Types <https://lets-plot.org/python/pages/aesthetics.html#line-types>`__.
 
     ----
@@ -1965,9 +2023,22 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
             'c': ['gr1', 'gr2', 'gr1', 'gr2']
         }
         ggplot(data) + \\
-            geom_errorbar(aes(y='y', xmin='xmin', xmax='xmax', color='c'), height=0.1, size=2)
+            geom_errorbar(aes(y='y', xmin='xmin', xmax='xmax', color='c'), width=0.1, size=2)
 
     """
+    if mapping is not None and 'height' in mapping.props():
+        print("WARN: using 'height' aesthetic parameter for errorbar was deprecated.\n"
+              "      Please, use 'width' aesthetic instead.")
+        mapping.props()['width'] = mapping.props().pop('height')
+    if 'height' in other_args:
+        print("WARN: using 'height' parameter for errorbar was deprecated.\n"
+              "      Please, use 'width' parameter instead.")
+        other_args['width'] = other_args.pop('height')
+    if 'height_unit' in other_args:
+        print("WARN: using 'height_unit' parameter for errorbar was deprecated.\n"
+              "      Please, use 'width_unit' parameter instead.")
+        other_args.pop('height_unit')
+
     return _geom('errorbar',
                  mapping=mapping,
                  data=data,
@@ -1978,6 +2049,7 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
                  manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
+                 width_unit=width_unit,
                  color_by=color_by,
                  **other_args)
 
@@ -1985,6 +2057,7 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
 def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
                   manual_key=None, sampling=None, tooltips=None,
                   fatten=None,
+                  width_unit=None,
                   color_by=None, fill_by=None,
                   **other_args):
     """
@@ -2026,6 +2099,15 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
         Set tooltips='none' to hide tooltips from the layer.
     fatten : float, default=2.5
         A multiplicative factor applied to size of the middle bar.
+    width_unit : {'res', 'identity', 'size', 'px'}, default='res'
+        Unit for the width of the crossbar.
+        Possible values:
+
+        - 'res': the unit equals the smallest distance between adjacent crossbars along the corresponding axis;
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
+
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
         Define the color aesthetic for the geometry.
     fill_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='fill'
@@ -2122,6 +2204,7 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
                  sampling=sampling,
                  tooltips=tooltips,
                  fatten=fatten,
+                 width_unit=width_unit,
                  color_by=color_by, fill_by=fill_by,
                  **other_args)
 
@@ -3552,6 +3635,7 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
                  outlier_shape=None, outlier_size=None, outlier_stroke=None,
                  varwidth=None,
                  whisker_width=None,
+                 width_unit=None,
                  color_by=None, fill_by=None,
                  **other_args):
     """
@@ -3609,6 +3693,15 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
         of the number of observations in the groups.
     whisker_width : float, default=0.5
         A multiplicative factor applied to the box width to draw horizontal segments on whiskers.
+    width_unit : {'res', 'identity', 'size', 'px'}, default='res'
+        Unit for the width of the boxplot.
+        Possible values:
+
+        - 'res': the unit equals the smallest distance between adjacent boxes along the corresponding axis;
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
+
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
         Define the color aesthetic for the geometry.
     fill_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='fill'
@@ -3746,6 +3839,7 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
                           fatten=fatten,
                           varwidth=varwidth,
                           whisker_width=whisker_width,
+                          width_unit=width_unit,
                           color_by=color_by, fill_by=fill_by,
                           **other_args)
     if stat is None or stat == 'boxplot':
@@ -4820,7 +4914,7 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
 
     .. jupyter-execute::
         :linenos:
-        :emphasize-lines: 11
+        :emphasize-lines: 10-11
 
         import numpy as np
         from lets_plot import *
@@ -4837,14 +4931,13 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
             for bw in bandwidths
             for n in sample_sizes
         ]
-
         gggrid(plots, ncol=3) + ggsize(900, 600)
 
     |
 
     .. jupyter-execute::
         :linenos:
-        :emphasize-lines: 10-11
+        :emphasize-lines: 10-12
 
         import numpy as np
         from lets_plot import *
@@ -4855,12 +4948,12 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
         p = ggplot({'x': x, 'y': y}, aes(x='x'))
         adjustments = [0.5 * (1 + i) for i in range(3)]
         plots = [
-            p + geom_density(aes(weight='y'),
+            p + geom_density(
+                aes(weight='y'),
                 kernel='cosine', adjust=adjust
             ) + ggtitle(f'adjust={adjust}')
             for adjust in adjustments
         ]
-
         gggrid(plots) + ggsize(800, 200)
 
     """
@@ -4894,10 +4987,6 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
     """
     Display density function contour.
 
-    By default, this geom uses `coord_fixed()`.
-    However, this may not be the best choice when the values on the X/Y axis have significantly different magnitudes.
-    In such cases, try using `coord_cartesian()`.
-
     Parameters
     ----------
     mapping : `FeatureSpec`
@@ -5021,7 +5110,7 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
 
     .. jupyter-execute::
         :linenos:
-        :emphasize-lines: 13
+        :emphasize-lines: 12-14
 
         import numpy as np
         from lets_plot import *
@@ -5034,20 +5123,20 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
         bandwidths = [0.2, 0.4]
         sample_sizes = [16, 256]
         plots = [
-            p + geom_density2d(kernel='epanechikov',
-                               bw=bw, n=n
+            p + geom_density2d(
+                kernel='epanechikov',
+                bw=bw, n=n
             ) + ggtitle(f'bw={bw}, n={n}')
             for bw in bandwidths
             for n in sample_sizes
         ]
-
         gggrid(plots, ncol=2) + ggsize(600, 650)
 
     |
 
     .. jupyter-execute::
         :linenos:
-        :emphasize-lines: 13-14
+        :emphasize-lines: 12-15
 
         import numpy as np
         from lets_plot import *
@@ -5060,14 +5149,14 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
         adjustments = [1.5, 2.5]
         bin_counts = [5, 15]
         plots = [
-            p + geom_density2d(kernel='cosine',
+            p + geom_density2d(
+                kernel='cosine',
                 adjust=adjust,
                 bins=bins
             ) + ggtitle(f'adjust={adjust}, bins={bins}')
             for adjust in adjustments
             for bins in bin_counts
         ]
-
         gggrid(plots, ncol=2) + ggsize(600, 650)
 
     |
@@ -5085,7 +5174,7 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
         y = np.random.normal(size=n)
         ggplot({'x': x, 'y': y}, aes('x', 'y')) + \\
             geom_raster(aes(fill='..density..'), \\
-                       stat='density2d', contour=False, n=50) + \\
+                        stat='density2d', contour=False, n=50) + \\
             scale_fill_gradient(low='#49006a', high='#fff7f3')
 
     |
@@ -5134,10 +5223,6 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
     """
     Fill density function contour.
 
-    By default, this geom uses `coord_fixed()`.
-    However, this may not be the best choice when the values on the X/Y axis have significantly different magnitudes.
-    In such cases, try using `coord_cartesian()`.
-
     Parameters
     ----------
     mapping : `FeatureSpec`
@@ -5255,7 +5340,7 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
 
     .. jupyter-execute::
         :linenos:
-        :emphasize-lines: 13
+        :emphasize-lines: 12-15
 
         import numpy as np
         from lets_plot import *
@@ -5268,8 +5353,10 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
         bandwidths = [0.2, 0.4]
         sample_sizes = [16, 256]
         plots = [
-            p + geom_density2df(kernel='epanechikov', size=.5, color='white',
-                               bw=bw, n=n
+            p + geom_density2df(
+                kernel='epanechikov',
+                size=.5, color='white',
+                bw=bw, n=n
             ) + ggtitle(f'bw={bw}, n={n}')
             for bw in bandwidths
             for n in sample_sizes
@@ -5280,7 +5367,7 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
 
     .. jupyter-execute::
         :linenos:
-        :emphasize-lines: 12-14
+        :emphasize-lines: 12-15
 
         import numpy as np
         from lets_plot import *
@@ -5293,14 +5380,14 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
         adjustments = [1.5, 2.5]
         bin_counts = [5, 15]
         plots = [
-            p + geom_density2df(kernel='cosine', size=.5, color='white',
+            p + geom_density2df(
+                kernel='cosine', size=.5, color='white',
                 adjust=adjust,
                 bins=bins
             ) + ggtitle(f'adjust={adjust}, bins={bins}')
             for adjust in adjustments
             for bins in bin_counts
         ]
-
         gggrid(plots, ncol=2) + ggsize(600, 650)
 
     |
@@ -6482,7 +6569,7 @@ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_lege
     geodesic : bool, default=False
         Draw geodesic. Coordinates expected to be in WGS84. Works only with `geom_livemap()`.
     spacer : float, default=0.0
-        Space to shorten a segment by moving the start/end.
+        Pixels to shorten segment, creating gaps at start/end points.
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
         Define the color aesthetic for the geometry.
     other_args
@@ -6649,7 +6736,7 @@ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend
     ncp : int, default=5
         The number of control points used to draw the curve. More control points creates a smoother curve.
     spacer : float, default=0.0
-        Space to shorten a curve by moving the start/end.
+        Pixels to shorten segment, creating gaps at start/end points.
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
         Define the color aesthetic for the geometry.
     other_args
@@ -6900,6 +6987,7 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
               na_text=None,
               nudge_x=None, nudge_y=None,
               size_unit=None,
+              nudge_unit=None,
               check_overlap=None,
               color_by=None,
               **other_args):
@@ -6969,6 +7057,14 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
     size_unit : {'x', 'y'}
         Relate the size of the text to the length of the unit step along one of the axes.
         If None, no fitting is performed.
+    nudge_unit : {'identity', 'size', 'px'}, default='identity'
+        Units for x and y nudging.
+        Possible values:
+
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
+
     check_overlap : bool, default=False
         If True, skip plotting text that overlaps previous text in the same layer.
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
@@ -7121,6 +7217,7 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  na_text=na_text,
                  nudge_x=nudge_x, nudge_y=nudge_y,
                  size_unit=size_unit,
+                 nudge_unit=nudge_unit,
                  check_overlap=check_overlap,
                  color_by=color_by,
                  **other_args)
@@ -7136,6 +7233,7 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
                label_padding=None, label_r=None, label_size=None,
                alpha_stroke=None,
                size_unit=None,
+               nudge_unit=None,
                check_overlap=None,
                color_by=None, fill_by=None,
                **other_args):
@@ -7213,6 +7311,14 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
     size_unit : {'x', 'y'}
         Relate the size of the text label to the length of the unit step along one of the axes.
         If None, no fitting is performed.
+    nudge_unit : {'identity', 'size', 'px'}, default='identity'
+        Units for x and y nudging.
+        Possible values:
+
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
+
     check_overlap : bool, default=False
         If True, skip plotting text that overlaps previous text in the same layer.
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
@@ -7373,6 +7479,7 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
                  label_size=label_size,
                  alpha_stroke=alpha_stroke,
                  size_unit=size_unit,
+                 nudge_unit=nudge_unit,
                  check_overlap=check_overlap,
                  color_by=color_by, fill_by=fill_by,
                  **other_args)
@@ -7385,6 +7492,7 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
              hole=None,
              stroke_side=None,
              spacer_width=None, spacer_color=None,
+             start=None, direction=None,
              size_unit=None,
              color_by=None, fill_by=None,
              **other_args):
@@ -7442,10 +7550,15 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
     stroke_side : {'outer', 'inner', 'both'}, default='both'
         Define which arcs of pie sector should have a stroke.
     spacer_width : float, default=0.75
-        Line width between sectors.
+        Line width between sectors in pixels.
         Spacers are not applied to exploded sectors and to sides of adjacent sectors.
     spacer_color : str
         Color for spacers between sectors. By default, the "paper" color is used.
+    start : float, default=None
+        Specify the angle at which the first sector starts. Accept values between 0 and 360.
+        Default is a negative angle of the first sector.
+    direction : {1, -1}, default=1
+        Specify angle direction, 1=clockwise, -1=counter-clockwise.
     size_unit : {'x', 'y'}
         Relate the size of the pie chart to the length of the unit step along one of the axes.
         If None, no fitting is performed.
@@ -7625,6 +7738,7 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
                  stroke_side=stroke_side,
                  spacer_width=spacer_width,
                  spacer_color=spacer_color,
+                 start=start, direction=direction,
                  size_unit=size_unit,
                  color_by=color_by, fill_by=fill_by,
                  **other_args)

lets_plot/plot/pos.py

@@ -146,7 +146,7 @@ def position_jitter(width=None, height=None, seed=None):
     return _pos('jitter', width=width, height=height, seed=seed)
 
 
-def position_nudge(x=None, y=None):
+def position_nudge(x=None, y=None, unit=None):
     """
     Adjust position by nudging a given offset.
 
@@ -156,6 +156,13 @@ def position_nudge(x=None, y=None):
         Nudging width.
     y : float
         Nudging height.
+    unit : {'identity', 'size', 'px'}, default='identity'
+        Units for x and y nudging.
+        Possible values:
+
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
 
     Returns
     -------
@@ -182,10 +189,10 @@ def position_nudge(x=None, y=None):
         t = np.random.choice(list('abcdefghijk'), size=n)
         ggplot({'x': x, 'y': y, 't': t}, aes('x', 'y')) + \\
             geom_point(size=5, shape=21, color='black', fill='red') + \\
-            geom_text(aes(label='t'), position=position_nudge(y=.05))
+            geom_text(aes(label='t'), position=position_nudge(y=.05, unit='identity'))
 
     """
-    return _pos('nudge', x=x, y=y)
+    return _pos('nudge', x=x, y=y, unit=unit)
 
 
 def position_jitterdodge(dodge_width=None, jitter_width=None, jitter_height=None, seed=None):

lets_plot/plot/scale.py

@@ -741,18 +741,18 @@ def scale_continuous(aesthetic, *,
 
     .. jupyter-execute::
         :linenos:
-        :emphasize-lines: 10
+        :emphasize-lines: 9
 
         from lets_plot import *
         LetsPlot.setup_html()
-
-        d = {
+        data = {
             'x': [0, 1, 2],
             'y': [0, 1, 2]
         }
-        ggplot(d) + \\
+        ggplot(data) + \\
             geom_point(aes(x='x', y='y'), size=15) + \\
             scale_continuous(['x','y'], expand=[0, 0]) #  no expansion - points right on the edges
+
     """
     if _is_color_scale(aesthetic):
         scale_mapper_kind = 'color_gradient' if scale_mapper_kind is None else scale_mapper_kind
@@ -2027,18 +2027,18 @@ def scale_discrete(aesthetic, *,
 
     .. jupyter-execute::
         :linenos:
-        :emphasize-lines: 10
+        :emphasize-lines: 9
 
         from lets_plot import *
         LetsPlot.setup_html()
-
-        d = {
+        data = {
             'x': [0, 1, 2],
             'y': [0, 1, 2]
         }
-        ggplot(d) + \\
+        ggplot(data) + \\
             geom_point(aes(x='x', y='y'), size=15) + \\
             scale_discrete(['x','y'], expand=[0, 0]) #  no expansion - points right on the edges
+
     """
     return _scale(aesthetic=aesthetic,
                   name=name,