lets-plot 4.4.1__cp39-cp39-macosx_11_0_arm64.whl → 4.5.0__cp39-cp39-macosx_11_0_arm64.whl

lets_plot/plot/scale_identity_.py

@@ -54,7 +54,7 @@ def scale_identity(aesthetic, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -124,7 +124,7 @@ def scale_color_identity(name=None, breaks=None, labels=None, lablim=None, limit
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -133,11 +133,7 @@ def scale_color_identity(name=None, breaks=None, labels=None, lablim=None, limit
 
     Notes
     -----
-    Input data expected: list of strings containing:
-
-    - names of colors (e.g. 'green'),
-    - hex codes of colors (e.g. 'x00ff00'),
-    - css colors (e.g. 'rgb(0, 255, 0)').
+    For more info about input data format, see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
 
     Examples
     --------
@@ -197,7 +193,7 @@ def scale_fill_identity(name=None, breaks=None, labels=None, lablim=None, limits
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -206,11 +202,7 @@ def scale_fill_identity(name=None, breaks=None, labels=None, lablim=None, limits
 
     Notes
     -----
-    Input data expected: list of strings containing:
-
-    - names of colors (e.g. 'green'),
-    - hex codes of colors (e.g. 'x00ff00'),
-    - css colors (e.g. 'rgb(0, 255, 0)').
+    For more info about input data format, see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
 
     Examples
     --------
@@ -270,7 +262,7 @@ def scale_shape_identity(name=None, breaks=None, labels=None, lablim=None, limit
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -343,7 +335,7 @@ def scale_linetype_identity(name=None, breaks=None, labels=None, lablim=None, li
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -419,7 +411,7 @@ def scale_alpha_identity(name=None, breaks=None, labels=None, lablim=None, limit
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -489,7 +481,7 @@ def scale_size_identity(name=None, breaks=None, labels=None, lablim=None, limits
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -559,7 +551,7 @@ def scale_linewidth_identity(name=None, breaks=None, labels=None, lablim=None, l
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------
@@ -627,7 +619,7 @@ def scale_stroke_identity(name=None, breaks=None, labels=None, lablim=None, limi
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
     Returns
     -------

lets_plot/plot/scale_position.py

@@ -65,7 +65,7 @@ def scale_x_continuous(name=None, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     position : str
         The position of the axis:
 
@@ -149,7 +149,7 @@ def scale_y_continuous(name=None, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     position : str
         The position of the axis:
 
@@ -230,7 +230,7 @@ def scale_x_log10(name=None, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     position : str
         The position of the axis:
 
@@ -307,7 +307,7 @@ def scale_y_log10(name=None, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     position : str
         The position of the axis:
 
@@ -384,7 +384,7 @@ def scale_x_log2(name=None, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     position : str
         The position of the axis:
 
@@ -461,7 +461,7 @@ def scale_y_log2(name=None, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     position : str
         The position of the axis:
 
@@ -538,7 +538,7 @@ def scale_x_reverse(name=None, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     position : str
         The position of the axis:
 
@@ -615,7 +615,7 @@ def scale_y_reverse(name=None, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     position : str
         The position of the axis:
 
@@ -699,7 +699,7 @@ def scale_x_discrete(name=None, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     position : str
         The position of the axis:
 
@@ -784,7 +784,7 @@ def scale_x_discrete_reversed(name=None, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     position : str
         The position of the axis:
 
@@ -868,7 +868,7 @@ def scale_y_discrete(name=None, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     position : str
         The position of the axis:
 
@@ -953,7 +953,7 @@ def scale_y_discrete_reversed(name=None, *,
         - 'Num {}' -> 'Num 12.456789'
         - 'TTL: {.2f}$' -> 'TTL: 12.45$'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     position : str
         The position of the axis:
 
@@ -1041,7 +1041,7 @@ def scale_x_datetime(name=None, *,
         - '%B %Y' -> 'August 2019'
         - '%a, %e %b %Y %H:%M:%S' -> 'Tue, 6 Aug 2019 04:46:35'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     position : str
         The position of the axis:
 
@@ -1128,7 +1128,7 @@ def scale_y_datetime(name=None, *,
         - '%B %Y' -> 'August 2019'
         - '%a, %e %b %Y %H:%M:%S' -> 'Tue, 6 Aug 2019 04:46:35'
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
     position : str
         The position of the axis:
 

lets_plot/plot/stat.py

@@ -9,7 +9,8 @@ __all__ = ['stat_summary', 'stat_summary_bin', 'stat_ecdf', 'stat_sum']
 
 
 def stat_summary(mapping=None, *, data=None, geom=None,
-                 position=None, show_legend=None, sampling=None, tooltips=None,
+                 position=None, show_legend=None, inherit_aes=None,
+                 sampling=None, tooltips=None,
                  orientation=None,
                  fun=None, fun_min=None, fun_max=None,
                  quantiles=None,
@@ -35,12 +36,15 @@ def stat_summary(mapping=None, *, data=None, geom=None,
         'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
+    inherit_aes : bool, default=True
+        False - do not combine the layer aesthetic mappings with the plot shared mappings.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
     tooltips : `layer_tooltips`
         Result of the call to the `layer_tooltips()` function.
         Specify appearance, style and content.
+        Set tooltips='none' to hide tooltips from the layer.
     orientation : str
         Specify the axis that the layer's stat and geom should run along.
         The default value (None) automatically determines the orientation based on the aesthetic mapping.
@@ -80,6 +84,11 @@ def stat_summary(mapping=None, *, data=None, geom=None,
     - ..ymin.. : result of calculating of `fun_min`.
     - ..ymax.. : result of calculating of `fun_max`.
 
+    ----
+
+    To hide axis tooltips, set 'blank' or the result of `element_blank()`
+    to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
+
     Examples
     --------
     .. jupyter-execute::
@@ -138,6 +147,7 @@ def stat_summary(mapping=None, *, data=None, geom=None,
                  stat='summary',
                  position=position,
                  show_legend=show_legend,
+                 inherit_aes=inherit_aes,
                  sampling=sampling,
                  tooltips=tooltips,
                  orientation=orientation,
@@ -148,7 +158,8 @@ def stat_summary(mapping=None, *, data=None, geom=None,
 
 
 def stat_summary_bin(mapping=None, *, data=None, geom=None,
-                     position=None, show_legend=None, sampling=None, tooltips=None,
+                     position=None, show_legend=None, inherit_aes=None,
+                     sampling=None, tooltips=None,
                      orientation=None,
                      fun=None, fun_min=None, fun_max=None,
                      quantiles=None,
@@ -177,12 +188,15 @@ def stat_summary_bin(mapping=None, *, data=None, geom=None,
         'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
+    inherit_aes : bool, default=True
+        False - do not combine the layer aesthetic mappings with the plot shared mappings.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
     tooltips : `layer_tooltips`
         Result of the call to the `layer_tooltips()` function.
         Specify appearance, style and content.
+        Set tooltips='none' to hide tooltips from the layer.
     orientation : str, default='x'
         Specify the axis that the layer's stat and geom should run along.
         Possible values: 'x', 'y'.
@@ -231,6 +245,11 @@ def stat_summary_bin(mapping=None, *, data=None, geom=None,
     - ..ymin.. : result of calculating of `fun_min`.
     - ..ymax.. : result of calculating of `fun_max`.
 
+    ----
+
+    To hide axis tooltips, set 'blank' or the result of `element_blank()`
+    to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
+
     Examples
     --------
     .. jupyter-execute::
@@ -290,6 +309,7 @@ def stat_summary_bin(mapping=None, *, data=None, geom=None,
                  stat='summarybin',
                  position=position,
                  show_legend=show_legend,
+                 inherit_aes=inherit_aes,
                  sampling=sampling,
                  tooltips=tooltips,
                  orientation=orientation,
@@ -302,7 +322,8 @@ def stat_summary_bin(mapping=None, *, data=None, geom=None,
 
 
 def stat_ecdf(mapping=None, *, data=None, geom=None,
-              position=None, show_legend=None, sampling=None, tooltips=None,
+              position=None, show_legend=None, inherit_aes=None,
+              sampling=None, tooltips=None,
               orientation=None,
               n=None, pad=None,
               color_by=None,
@@ -327,12 +348,15 @@ def stat_ecdf(mapping=None, *, data=None, geom=None,
         'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
+    inherit_aes : bool, default=True
+        False - do not combine the layer aesthetic mappings with the plot shared mappings.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
     tooltips : `layer_tooltips`
         Result of the call to the `layer_tooltips()` function.
         Specify appearance, style and content.
+        Set tooltips='none' to hide tooltips from the layer.
     orientation : str, default='x'
         Specify the axis that the layer's stat and geom should run along.
         Possible values: 'x', 'y'.
@@ -364,6 +388,11 @@ def stat_ecdf(mapping=None, *, data=None, geom=None,
 
     In addition, you can use any aesthetics, available for the geometry defined by the `geom` parameter.
 
+    ----
+
+    To hide axis tooltips, set 'blank' or the result of `element_blank()`
+    to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
+
     Examples
     --------
     .. jupyter-execute::
@@ -426,6 +455,7 @@ def stat_ecdf(mapping=None, *, data=None, geom=None,
                  stat='ecdf',
                  position=position,
                  show_legend=show_legend,
+                 inherit_aes=inherit_aes,
                  sampling=sampling,
                  tooltips=tooltips,
                  orientation=orientation,
@@ -435,7 +465,8 @@ def stat_ecdf(mapping=None, *, data=None, geom=None,
                  **other_args)
 
 
-def stat_sum(mapping=None, *, data=None, geom=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def stat_sum(mapping=None, *, data=None, geom=None, position=None, show_legend=None, inherit_aes=None,
+             sampling=None, tooltips=None,
              color_by=None, fill_by=None,
              **other_args):
     """
@@ -458,12 +489,15 @@ def stat_sum(mapping=None, *, data=None, geom=None, position=None, show_legend=N
         'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
+    inherit_aes : bool, default=True
+        False - do not combine the layer aesthetic mappings with the plot shared mappings.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
     tooltips : `layer_tooltips`
         Result of the call to the `layer_tooltips()` function.
         Specify appearance, style and content.
+        Set tooltips='none' to hide tooltips from the layer.
     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'
@@ -494,6 +528,11 @@ def stat_sum(mapping=None, *, data=None, geom=None, position=None, show_legend=N
 
     In addition, you can use any aesthetics, available for the geometry defined by the `geom` parameter.
 
+    ----
+
+    To hide axis tooltips, set 'blank' or the result of `element_blank()`
+    to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
+
     Examples
     --------
     .. jupyter-execute::
@@ -534,6 +573,7 @@ def stat_sum(mapping=None, *, data=None, geom=None, position=None, show_legend=N
                  stat='sum',
                  position=position,
                  show_legend=show_legend,
+                 inherit_aes=inherit_aes,
                  sampling=sampling,
                  tooltips=tooltips,
                  color_by=color_by,

lets_plot/plot/subplots.py

@@ -67,7 +67,7 @@ class SupPlotsSpec(FeatureSpec):
                 supplots = supplots.__add__(spec)
             return supplots
 
-        elif isinstance(other, FeatureSpec) and other.kind in ["ggsize", "theme"]:
+        elif isinstance(other, FeatureSpec) and other.kind in ["ggsize", "theme", "ggtoolbar"]:
 
             supplots = SupPlotsSpec.duplicate(self)
             # ToDo: duplication!

lets_plot/plot/theme_.py

@@ -42,6 +42,12 @@ def theme(*,
           legend_background=None,
           legend_text=None, legend_title=None,
           legend_position=None, legend_justification=None, legend_direction=None,
+          legend_margin=None,
+          legend_spacing=None, legend_spacing_x=None,legend_spacing_y=None,
+          legend_key=None,
+          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...
 
           panel_background=None,
@@ -72,8 +78,8 @@ def theme(*,
           plot_title_position=None,
           plot_caption_position=None,
 
-          strip_background=None,  # ToDo: x/y
-          strip_text=None,  # ToDo: x/y
+          strip_background=None, strip_background_x=None, strip_background_y=None,
+          strip_text=None, strip_text_x=None, strip_text_y=None,
           # ToDo: strip.placement
 
           axis_tooltip=None, axis_tooltip_x=None, axis_tooltip_y=None,
@@ -92,13 +98,23 @@ def theme(*,
 
     Parameters
     ----------
-    exponent_format : {'e', 'pow'}, default='e'
+    exponent_format : {'e', 'pow', 'pow_full'} or tuple, default='e'
         Format for numeric labels in scientific notation.
 
-        - e for "e" notation (e.g. 1e+6)
-        - pow for "power" notation (e.g. 1x10^6). This will enable superscript formatting for the exponent.
+        - e for "e" notation (e.g. 1e+6);
+        - pow_full for "power" notation (e.g. 1x10^6). This will enable superscript formatting for the exponent;
+        - pow works as pow_full but will shorten powers of 10 (e.g. 10^6 instead of 1x10^6).
 
-        Note that superscript is not fully support by CairoSVG library and export to PNG/PDF may produce unexpected results.
+        If parameter is a tuple, then it should be a three-element tuple:
+
+        - the first element is the format - 'e', 'pow', 'pow_full';
+        - the second element is minimum exponent value from which to use scientific notation (default is -7);
+        - the third element is maximum exponent value from which to use scientific notation (default is taken from `precision` of the current formatting, see `Formatting <https://lets-plot.org/python/pages/formats.html>`__).
+
+        Minimum and maximum exponent values are only taken into account when "g" format is used,
+        see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
+
+        Superscript is not supported when exporting to PNG/PDF.
     line : str or dict
         All line elements.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
@@ -167,6 +183,44 @@ def theme(*,
         For string parameter the only possible value is 'center'.
     legend_direction : {'horizontal', 'vertical'}
         Layout of items in legends.
+    legend_margin : number or list of numbers
+        Margin around each legend.
+        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 value for the legend margin side will be used.
+    legend_spacing : float
+        Spacing between legends.
+    legend_spacing_x : float
+         Spacing between legends in the horizontal direction, inherited from `legend_spacing`.
+    legend_spacing_y : float
+        Spacing between legends in the vertical direction, inherited from `legend_spacing`.
+    legend_key : str or dict
+        Background underneath legend keys.
+        Set 'blank' or result of `element_blank()` to draw nothing.
+        Set `element_rect()` to specify legend key background parameters, inherited from `rect`.
+    legend_key_size : float
+        Size of legend keys.
+    legend_key_width : float
+        Key background width, inherited from `legend_key_size`.
+    legend_key_height : float
+        Key background height, inherited from `legend_key_size`.
+    legend_key_spacing : float
+        Spacing between legend keys.
+    legend_key_spacing_x : float
+        Spacing between legend keys in the horizontal direction, inherited from `legend_key_spacing`.
+    legend_key_spacing_y : float
+        Spacing between legend keys in the vertical direction, inherited from `legend_key_spacing`.
+    legend_box : {'horizontal', 'vertical'}
+        Arrangement of multiple legends.
+    legend_box_just : {'left', 'right', 'bottom', 'top', 'center'}
+        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.
     panel_background : str or dict
         Background of plotting area.
         Set 'blank' or result of `element_blank()` to draw nothing.
@@ -247,10 +301,26 @@ def theme(*,
         Background of facet labels.
         Set 'blank' or result of `element_blank()` to draw nothing.
         Set `element_rect()` to specify facet label background parameters, inherited from `rect`.
+    strip_background_x : str or dict
+        Horizontal facet background.
+        Set 'blank' or result of `element_blank()` to draw nothing.
+        Set `element_rect()` to specify facet label background parameters, inherited from `strip_background`.
+    strip_background_y : str or dict
+        Vertical facet background.
+        Set 'blank' or result of `element_blank()` to draw nothing.
+        Set `element_rect()` to specify facet label background parameters, inherited from `strip_background`.
     strip_text : str or dict
         Facet labels.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_text()` to specify facet label parameters, inherited from `text`.
+    strip_text_x : str or dict
+        Horizontal facet labels.
+        Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
+        Set `element_text()` to specify facet label parameters, inherited from `strip_text`.
+    strip_text_y : str or dict
+        Vertical facet labels.
+        Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
+        Set `element_text()` to specify facet label parameters, inherited from `strip_text`.
     axis_tooltip, axis_tooltip_x, axis_tooltip_y : str or dict
         Axes tooltips.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
@@ -396,10 +466,14 @@ def element_rect(
         Border color.
     size : int
         Border size.
-    linetype : int or str
-        Type of the line.
-        Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
-        For more info see https://lets-plot.org/python/pages/aesthetics.html#line-types.
+    linetype : int or str or list
+        Type of the line. Accepts the following values:
+
+        - Codes or names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+        - A string of an even number (up to eight) of hexadecimal digits, specifying the lengths in consecutive positions.
+        - A list defines the pattern of dashes and gaps, either with an offset: [offset, [dash, gap, ...]], or without an offset: [dash, gap, ...].
+
+        For more info see `Line Types <https://lets-plot.org/python/pages/aesthetics.html#line-types>`__.
     blank : bool, default=False
         If True - draws nothing, and assigns no space.
 
@@ -443,9 +517,14 @@ def element_line(
         Line color.
     size : int
         Line size.
-    linetype : int or str
-        Type of the line.
-        Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    linetype : int or str or list
+        Type of the line. Accepts the following values:
+
+        - Codes or names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+        - A string of an even number (up to eight) of hexadecimal digits, specifying the lengths in consecutive positions.
+        - A list defines the pattern of dashes and gaps, either with an offset: [offset, [dash, gap, ...]], or without an offset: [dash, gap, ...].
+
+        For more info see `Line Types <https://lets-plot.org/python/pages/aesthetics.html#line-types>`__.
     blank : bool, default=False
         If True - draws nothing, and assigns no space.
 
@@ -599,4 +678,4 @@ def element_geom(
             theme(geom=element_geom(pen='dark_blue', paper='light_blue'))
 
     """
-    return locals()
+    return locals()

lets_plot/plot/tooltip.py

@@ -165,7 +165,7 @@ class layer_tooltips(FeatureSpec):
 
         ----
 
-        For more info see https://lets-plot.org/python/pages/formats.html.
+        For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
 
         Examples
         --------