lets-plot 4.6.0a1__cp310-cp310-macosx_11_0_arm64.whl → 4.6.0rc1__cp310-cp310-macosx_11_0_arm64.whl

lets_plot/plot/geom.py

@@ -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='identity'
+        Unit for width of the hexagon.
+        Possible values:
+
+        - 'res': value 1 corresponds to the resolution along the x-axis, i.e. the minimum distance between data points;
+        - 'identity': value 1 corresponds to the distance from 0 to 1 on the x-axis;
+        - 'size': value 1 corresponds to the diameter of a point of size 1;
+        - 'px': value 1 corresponds to 1 pixel.
+
+    height_unit : {'res', 'identity', 'size', 'px'}, default='identity'
+        Unit for height of the hexagon.
+        Possible values:
+
+        - 'res': value 1 corresponds to the resolution along the y-axis, i.e. the minimum distance between data points;
+        - 'identity': value 1 corresponds to the distance from 0 to 1 on the y-axis;
+        - 'size': value 1 corresponds to the diameter of a point of size 1;
+        - 'px': value 1 corresponds to 1 pixel.
+
     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'
@@ -1584,6 +1595,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 +1603,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 +1638,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': value 1 corresponds to the resolution along the x-axis, i.e. the minimum distance between data points;
+        - 'identity': value 1 corresponds to the distance from 0 to 1 on the x-axis;
+        - 'size': value 1 corresponds to the diameter of a point of size 1;
+        - 'px': value 1 corresponds to 1 pixel.
+
+    height_unit : {'res', 'identity', 'size', 'px'}, default='res'
+        Unit for height of the tile.
+        Possible values:
+
+        - 'res': value 1 corresponds to the resolution along the y-axis, i.e. the minimum distance between data points;
+        - 'identity': value 1 corresponds to the distance from 0 to 1 on the y-axis;
+        - 'size': value 1 corresponds to the diameter of a point of size 1;
+        - 'px': value 1 corresponds to 1 pixel.
+
     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 +1767,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 +1871,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, height_unit=None,
                   color_by=None,
                   **other_args):
     """
@@ -1877,6 +1911,24 @@ 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 vertical error bar.
+        Possible values:
+
+        - 'res': value 1 corresponds to the resolution along the x-axis, i.e. the minimum distance between data points;
+        - 'identity': value 1 corresponds to the distance from 0 to 1 on the x-axis;
+        - 'size': value 1 corresponds to the diameter of a point of size 1;
+        - 'px': value 1 corresponds to 1 pixel.
+
+    height_unit : {'res', 'identity', 'size', 'px'}, default='res'
+        Unit for the whisker height of the horizontal error bar.
+        Possible values:
+
+        - 'res': value 1 corresponds to the resolution along the y-axis, i.e. the minimum distance between data points;
+        - 'identity': value 1 corresponds to the distance from 0 to 1 on the y-axis;
+        - 'size': value 1 corresponds to the diameter of a point of size 1;
+        - 'px': value 1 corresponds to 1 pixel.
+
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
         Define the color aesthetic for the geometry.
     other_args
@@ -1978,6 +2030,8 @@ 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,
+                 height_unit=height_unit,
                  color_by=color_by,
                  **other_args)
 
@@ -1985,6 +2039,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 +2081,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': value 1 corresponds to the resolution along the x-axis, i.e. the minimum distance between data points;
+        - 'identity': value 1 corresponds to the distance from 0 to 1 on the x-axis;
+        - 'size': value 1 corresponds to the diameter of a point of size 1;
+        - 'px': value 1 corresponds to 1 pixel.
+
     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 +2186,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 +3617,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 +3675,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': value 1 corresponds to the resolution along the x-axis, i.e. the minimum distance between data points;
+        - 'identity': value 1 corresponds to the distance from 0 to 1 on the x-axis;
+        - 'size': value 1 corresponds to the diameter of a point of size 1;
+        - 'px': value 1 corresponds to 1 pixel.
+
     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 +3821,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 +4896,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 +4913,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 +4930,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 +4969,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 +5092,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 +5105,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 +5131,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 +5156,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 +5205,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 +5322,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 +5335,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 +5349,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 +5362,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 +6551,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 +6718,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
@@ -7385,6 +7454,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 +7512,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 +7700,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,8 @@ def position_nudge(x=None, y=None):
         Nudging width.
     y : float
         Nudging height.
+    unit : {'identity', 'size', 'px'}
+        Units for x and y nudging.
 
     Returns
     -------
@@ -182,10 +184,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,

lets_plot/plot/theme_.py

@@ -10,6 +10,7 @@ __all__ = [
     "element_line",
     'element_rect',
     'element_text',
+    'element_markdown',
     'margin',
     'element_geom',
 ]
@@ -48,12 +49,11 @@ def theme(*,
           legend_key_size=None, legend_key_width=None, legend_key_height=None,
           legend_key_spacing=None, legend_key_spacing_x=None, legend_key_spacing_y=None,
           legend_box=None, legend_box_just=None, legend_box_spacing=None,
-          # ToDo: other legend options...
+          legend_ticks=None, legend_ticks_length=None,
 
           panel_background=None,
           panel_border=None,
           panel_border_ontop=None,
-          # ToDo: other panel options...
 
           panel_grid=None,
           panel_grid_ontop=None,
@@ -221,6 +221,14 @@ def theme(*,
         Justification of each legend within the overall bounding box, when there are multiple legends.
     legend_box_spacing : float
         Spacing between plotting area and legend box.
+    legend_ticks : str or dict
+        Tick marks in colorbars.
+        Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
+        Set `element_line()` to specify all tick mark parameters.
+        `legend_ticks_*` DOES NOT inherit from `line`.
+        By default, the colorbar tick marks are drawn with the same color as the colorbar background.
+    legend_ticks_length : float
+        Length of colorbar tick marks in px.
     panel_background : str or dict
         Background of plotting area.
         Set 'blank' or result of `element_blank()` to draw nothing.
@@ -628,6 +636,83 @@ def element_text(
     return locals()
 
 
+def element_markdown(
+        color=None,
+        family=None,
+        face=None,
+        size=None,
+        angle=None,
+        # ToDo: lineheight
+        hjust=None,
+        vjust=None,
+        margin=None,
+        blank=False,
+) -> dict:
+    """
+    Specify how non-data components of the plot are drawn.
+    This theme element draws texts with Markdown support.
+
+    Parameters
+    ----------
+    color : str
+        Text color.
+    family : str
+        Font family.
+    face : str
+        Font face ("plain", "italic", "bold", "bold_italic").
+    size : int
+        Text size in px.
+    angle : float
+        Angle to rotate the text (in degrees).
+    hjust : float
+        Horizontal justification (in [0, 1]).
+        0 - left-justified;
+        1 - right-justified;
+        0.5 - center-justified.
+        Can be used with values out of range, but behaviour is not specified.
+    vjust : float
+        Vertical justification (in [0, 1]).
+        0 - bottom-justified;
+        1 - top-justified;
+        0.5 - middle-justified.
+        Can be used with values out of range, but behaviour is not specified.
+    margin : number or list of numbers
+        Margins around the text.
+
+        The margin may be specified using a number or a list of numbers:
+        - a number or list of one number - the same margin it applied to all four sides;
+        - a list of two numbers - the first margin applies to the top and bottom, the second - to the left and right;
+        - a list of three numbers -  the first margin applies to the top, the second - to the right and left,
+        the third - to the bottom;
+        - a list of four numbers - the margins are applied to the top, right, bottom and left in that order.
+
+        It is acceptable to use None for any side; in this case, the default side value for this element will be used.
+    blank : bool, default=False
+        If True - draws nothing, and assigns no space.
+
+    Returns
+    -------
+    `dict`
+        Theme element specification.
+
+    Examples
+    --------
+    .. jupyter-execute::
+        :linenos:
+        :emphasize-lines: 7
+
+        import numpy as np
+        from lets_plot import *
+        LetsPlot.setup_html()
+        np.random.seed(42)
+        data = {'x': np.random.normal(size=1000)}
+        ggplot(data, aes(x='x')) + geom_histogram() + \\
+            theme(axis_text=element_text(color='#cb181d', face='bold_italic', margin=[5, 10]))
+
+    """
+    return {'markdown': True, **locals()}
+
+
 def margin(t=None, r=None, b=None, l=None):
     """
     Function `margin()` is deprecated.

{lets_plot-4.6.0a1.dist-info → lets_plot-4.6.0rc1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: lets-plot
-Version: 4.6.0a1
+Version: 4.6.0rc1
 Summary: An open source library for statistical plotting
 Home-page: https://lets-plot.org
 Author: JetBrains