lets-plot 4.3.2__cp39-cp39-win_amd64.whl → 4.4.0__cp39-cp39-win_amd64.whl

lets_plot/plot/geom.py

@@ -5,7 +5,7 @@
 from lets_plot.geo_data_internals.utils import is_geocoder
 
 from .core import FeatureSpec, LayerSpec
-from .util import as_annotated_data, is_geo_data_frame, geo_data_frame_to_crs, get_geo_data_frame_meta
+from .util import as_annotated_data, is_geo_data_frame, geo_data_frame_to_crs, get_geo_data_frame_meta, key_int2str
 
 #
 # Geoms, short for geometric objects, describe the type of plot ggplot will produce.
@@ -18,6 +18,7 @@ __all__ = ['geom_point', 'geom_path', 'geom_line',
            'geom_contour',
            'geom_contourf', 'geom_polygon', 'geom_map',
            'geom_abline', 'geom_hline', 'geom_vline',
+           'geom_band',
            'geom_boxplot', 'geom_violin', 'geom_ydotplot',
            'geom_area_ridges',
            'geom_ribbon', 'geom_area', 'geom_density',
@@ -29,7 +30,8 @@ __all__ = ['geom_point', 'geom_path', 'geom_line',
            'geom_count']
 
 
-def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+               tooltips=None,
                map=None, map_join=None, use_crs=None,
                size_unit=None,
                color_by=None, fill_by=None,
@@ -60,6 +62,9 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -109,17 +114,18 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
     - alpha : transparency level of the point. Accept values between 0 and 1.
     - color (colour) : color of the geometry. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. Is applied only to the points of shapes having inner area. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
-    - shape : shape of the point, an integer from 0 to 25.
+    - shape : shape of the point, an integer from 0 to 25. For more info see https://lets-plot.org/python/pages/aesthetics.html#point-shapes.
+    - angle : rotation angle of the point shape, in degrees.
     - size : size of the point.
     - stroke : width of the shape border. Applied only to the shapes having border.
 
-    |
+    ----
 
     The `data` and `map` parameters of `GeoDataFrame` type support shapes `Point` and `MultiPoint`.
 
     The `map` parameter of `Geocoder` type implicitly invokes `centroids()` function.
 
-    |
+    ----
 
     The conventions for the values of `map_join` parameter are as follows:
 
@@ -198,6 +204,7 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  map=map, map_join=map_join, use_crs=use_crs,
@@ -206,7 +213,8 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
                  **other_args)
 
 
-def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+              tooltips=None,
               map=None, map_join=None, use_crs=None,
               flat=None, geodesic=None,
               color_by=None,
@@ -236,6 +244,9 @@ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -282,14 +293,14 @@ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=
     - y : y-axis value.
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
     - size : line width.
 
-    |
+    ----
 
     The `data` and `map` parameters of `GeoDataFrame` type support shapes `LineString` and `MultiLineString`.
 
-    |
+    ----
 
     The conventions for the values of `map_join` parameter are as follows.
 
@@ -376,6 +387,7 @@ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  map=map, map_join=map_join, use_crs=use_crs,
@@ -384,7 +396,8 @@ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  **other_args)
 
 
-def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+              tooltips=None,
               color_by=None,
               **other_args):
     """
@@ -414,6 +427,9 @@ def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -444,7 +460,7 @@ def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=
     - y : y-axis value.
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
     - size : line width.
 
     Examples
@@ -487,13 +503,15 @@ def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  color_by=color_by,
                  **other_args)
 
 
-def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+                tooltips=None,
                 orientation=None,
                 method=None,
                 n=None,
@@ -530,6 +548,9 @@ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legen
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -592,7 +613,7 @@ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legen
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color for the confidence interval around the line. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
-    - linetype : type of the line of conditional mean line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : type of the line of conditional mean 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.
     - size : line width. Define line width for conditional mean and confidence bounds lines.
 
     Examples
@@ -656,6 +677,7 @@ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legen
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  orientation=orientation,
@@ -671,7 +693,7 @@ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legen
                  **other_args)
 
 
-def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None,
+def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
              tooltips=None, labels=None,
              orientation=None,
              color_by=None, fill_by=None,
@@ -702,6 +724,9 @@ def geom_bar(mapping=None, *, data=None, stat=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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -813,6 +838,7 @@ def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=N
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  labels=labels,
@@ -821,7 +847,8 @@ def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=N
                  **other_args)
 
 
-def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None,
+def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
+                   sampling=None, threshold=None,
                    tooltips=None, labels=None,
                    orientation=None,
                    bins=None,
@@ -856,9 +883,15 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         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.
     tooltips : `layer_tooltips`
         Result of the call to the `layer_tooltips()` function.
         Specify appearance, style and content.
@@ -964,7 +997,9 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
+                 threshold=threshold,
                  tooltips=tooltips,
                  labels=labels,
                  orientation=orientation,
@@ -976,7 +1011,7 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
                  **other_args)
 
 
-def geom_dotplot(mapping=None, *, data=None, show_legend=None, sampling=None, tooltips=None,
+def geom_dotplot(mapping=None, *, data=None, show_legend=None, manual_key=None, sampling=None, tooltips=None,
                  binwidth=None,
                  bins=None,
                  method=None,
@@ -1003,6 +1038,9 @@ def geom_dotplot(mapping=None, *, data=None, show_legend=None, sampling=None, to
         is inherited from the plot data as specified in the call to ggplot.
     show_legend : bool, default=True
         False - do not show legend for this layer.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -1118,6 +1156,7 @@ def geom_dotplot(mapping=None, *, data=None, show_legend=None, sampling=None, to
                  stat=None,
                  position=None,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  binwidth=binwidth,
@@ -1133,14 +1172,20 @@ def geom_dotplot(mapping=None, *, data=None, show_legend=None, sampling=None, to
                  **other_args)
 
 
-def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+               tooltips=None,
                bins=None,
                binwidth=None,
                drop=None,
                color_by=None, fill_by=None,
                **other_args):
     """
-    Divides the plane into a grid and color the bins by the count of cases in them.
+    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
     ----------
@@ -1159,6 +1204,9 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -1189,8 +1237,6 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
 
     Notes
     -----
-    `geom_bin2d()` applies rectangular grid to the plane then counts observation
-    in each cell of the grid (bin). Uses `geom_tile()` to display counts as a tile fill-color.
 
     Computed variables:
 
@@ -1286,6 +1332,7 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  bins=bins,
@@ -1295,7 +1342,8 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
                  **other_args)
 
 
-def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+              tooltips=None,
               color_by=None, fill_by=None,
               **other_args):
     """
@@ -1318,6 +1366,9 @@ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -1351,7 +1402,7 @@ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=
     - size : line width, default=0 (i.e. tiles outline initially is not visible).
     - width : width of a tile. Typically range between 0 and 1. Values that are greater than 1 lead to overlapping of the tiles.
     - height : height of a tile. Typically range between 0 and 1. Values that are greater than 1 lead to overlapping of the tiles.
-    - linetype : type of the line of tile's border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : type of the line of tile's border. 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.
 
     Examples
     --------
@@ -1426,13 +1477,15 @@ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  color_by=color_by, fill_by=fill_by,
                  **other_args)
 
 
-def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, fill_by=None,
+def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+                fill_by=None,
                 **other_args):
     """
     Display rectangles with x, y values mapped to the center of the tile.
@@ -1456,6 +1509,9 @@ def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legen
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -1513,12 +1569,14 @@ def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legen
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  fill_by=fill_by,
                  **other_args)
 
 
-def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
+                  sampling=None, tooltips=None,
                   color_by=None,
                   **other_args):
     """
@@ -1546,6 +1604,9 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -1579,7 +1640,7 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - 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.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
 
     Examples
     --------
@@ -1644,13 +1705,15 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  color_by=color_by,
                  **other_args)
 
 
-def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
+                  sampling=None, tooltips=None,
                   fatten=None,
                   color_by=None, fill_by=None,
                   **other_args):
@@ -1679,6 +1742,9 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -1719,7 +1785,7 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
     - fill : fill color. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : lines width.
     - width : width of a bar. Typically range between 0 and 1. Values that are greater than 1 lead to overlapping of the bars.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
 
     Examples
     --------
@@ -1773,6 +1839,7 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  fatten=fatten,
@@ -1780,7 +1847,8 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
                  **other_args)
 
 
-def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None,
+def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
+                    sampling=None,
                     tooltips=None,
                     fatten=None,
                     color_by=None, fill_by=None,
@@ -1810,6 +1878,9 @@ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_l
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -1849,8 +1920,8 @@ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_l
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : size of mid-point.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
-    - shape : shape of the mid-point, an integer from 0 to 25.
+    - linetype : 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.
+    - shape : shape of the mid-point, an integer from 0 to 25. For more info see https://lets-plot.org/python/pages/aesthetics.html#point-shapes.
     - stroke : width of the shape border. Applied only to the shapes having border.
     - linewidth : line width.
 
@@ -1901,6 +1972,7 @@ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_l
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  fatten=fatten,
@@ -1908,7 +1980,8 @@ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_l
                  **other_args)
 
 
-def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
+                   sampling=None, tooltips=None,
                    color_by=None,
                    **other_args):
     """
@@ -1936,6 +2009,9 @@ def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_le
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -1968,7 +2044,7 @@ def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_le
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : line width.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
 
     Examples
     --------
@@ -2017,13 +2093,15 @@ def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_le
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  color_by=color_by,
                  **other_args)
 
 
-def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+                 tooltips=None,
                  bins=None,
                  binwidth=None,
                  color_by=None,
@@ -2048,6 +2126,9 @@ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_lege
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -2087,7 +2168,7 @@ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_lege
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : lines width.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
 
     Examples
     --------
@@ -2155,6 +2236,7 @@ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_lege
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  bins=bins, binwidth=binwidth,
@@ -2162,7 +2244,8 @@ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_lege
                  **other_args)
 
 
-def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
+                  sampling=None, tooltips=None,
                   bins=None,
                   binwidth=None,
                   color_by=None, fill_by=None,
@@ -2187,6 +2270,9 @@ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_leg
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -2295,6 +2381,7 @@ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_leg
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  bins=bins,
@@ -2303,7 +2390,8 @@ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_leg
                  **other_args)
 
 
-def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+                 tooltips=None,
                  map=None, map_join=None, use_crs=None,
                  color_by=None, fill_by=None,
                  **other_args):
@@ -2327,6 +2415,9 @@ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_lege
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -2372,15 +2463,15 @@ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_lege
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : line width.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
 
-    |
+    ----
 
     The `data` and `map` parameters of `GeoDataFrame` type support shapes `Polygon` and `MultiPolygon`.
 
     The `map` parameter of `Geocoder` type implicitly invokes `boundaries()` function.
 
-    |
+    ----
 
     The conventions for the values of `map_join` parameter are as follows:
 
@@ -2473,6 +2564,7 @@ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_lege
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  map=map, map_join=map_join, use_crs=use_crs,
@@ -2480,7 +2572,8 @@ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_lege
                  **other_args)
 
 
-def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+             tooltips=None,
              map=None, map_join=None, use_crs=None,
              color_by=None, fill_by=None,
              **other_args):
@@ -2509,6 +2602,9 @@ def geom_map(mapping=None, *, data=None, stat=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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -2553,15 +2649,15 @@ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=N
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : line width.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
 
-    |
+    ----
 
     The `data` and `map` parameters of `GeoDataFrame` type support shapes `Polygon` and `MultiPolygon`.
 
     The `map` parameter of `Geocoder` type implicitly invokes `boundaries()` function.
 
-    |
+    ----
 
     The conventions for the values of `map_join` parameter are as follows.
 
@@ -2640,6 +2736,7 @@ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=N
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  map=map, map_join=map_join, use_crs=use_crs,
@@ -2647,7 +2744,7 @@ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=N
                  **other_args)
 
 
-def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None,
+def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
                 slope=None,
                 intercept=None,
                 color_by=None,
@@ -2672,6 +2769,9 @@ def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legen
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -2703,7 +2803,7 @@ def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legen
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : lines width.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
 
     Examples
     --------
@@ -2749,6 +2849,7 @@ def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legen
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  slope=slope,
                  intercept=intercept,
@@ -2756,7 +2857,120 @@ def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legen
                  **other_args)
 
 
-def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_band(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None,
+              tooltips=None,
+              color_by=None, fill_by=None,
+              **other_args):
+    """
+    Add a straight vertical or horizontal band to the plot.
+
+    Parameters
+    ----------
+    mapping : `FeatureSpec`
+        Set of aesthetic mappings created by `aes()` function.
+        Aesthetic mappings describe the way that variables in the data are
+        mapped to plot "aesthetics".
+    data : dict or Pandas or Polars `DataFrame`
+        The data to be displayed in this layer. If None, the default, the data
+        is inherited from the plot data as specified in the call to ggplot.
+    stat : str, default='identity'
+        The statistical transformation to use on the data for this layer, as a string.
+    position : str or `FeatureSpec`, default='identity'
+        Position adjustment.
+        Either a position adjustment name: 'dodge', 'dodgev', 'jitter', 'nudge', 'jitterdodge', 'fill',
+        '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.
+    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.
+    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'
+        Define the fill aesthetic for the geometry.
+    other_args
+        Other arguments passed on to the layer.
+        These are often aesthetics settings used to set an aesthetic to a fixed value,
+        like color='red', fill='blue', size=3 or shape=21.
+        They may also be parameters to the paired geom/stat.
+
+    Returns
+    -------
+    `LayerSpec`
+        Geom object specification.
+
+    Notes
+    -----
+    `geom_band()` understands the following aesthetics mappings:
+
+    - xmin : x-axis value.
+    - xmax : x-axis value.
+    - ymin : y-axis value.
+    - ymax : y-axis value.
+    - alpha : transparency level of a layer. Accept values between 0 and 1.
+    - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
+    - fill : fill color. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
+    - size : lines width.
+    - linetype : 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.
+
+    Examples
+    --------
+    .. jupyter-execute::
+        :linenos:
+        :emphasize-lines: 3
+
+        from lets_plot import *
+        LetsPlot.setup_html()
+        ggplot() + geom_band(xmin=-1, xmax=1)
+
+    |
+
+    .. jupyter-execute::
+        :linenos:
+        :emphasize-lines: 16-19
+
+        from lets_plot import *
+        LetsPlot.setup_html()
+        n = 11
+        w = 5
+        color = "orange"
+        xdata = {
+            "xmin": list(range(0, w * n, w)),
+            "xmax": list(range(1, w * n + 1, w)),
+        }
+        ydata = {
+            "ymin": [0, 10],
+            "ymax": [10, 15],
+            "color": [color, "white"],
+        }
+        ggplot() + \\
+            geom_band(aes(xmin="xmin", xmax="xmax"), data=xdata, \\
+                      size=0, fill=color, tooltips='none') + \\
+            geom_band(aes(ymin="ymin", ymax="ymax", fill="color"), data=ydata, \\
+                      size=0, tooltips='none') + \\
+            scale_fill_identity() + \\
+            coord_polar(xlim=[0, w * n], ylim=[0, 25]) + \\
+            theme_void()
+
+    """
+    return _geom('band',
+                 mapping=mapping,
+                 data=data,
+                 stat=stat,
+                 position=position,
+                 show_legend=show_legend,
+                 sampling=sampling,
+                 tooltips=tooltips,
+                 color_by=color_by,
+                 fill_by=fill_by,
+                 **other_args)
+
+
+def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+               tooltips=None,
                yintercept=None,
                color_by=None,
                **other_args):
@@ -2780,6 +2994,9 @@ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -2809,7 +3026,7 @@ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : line width.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
 
     Examples
     --------
@@ -2864,6 +3081,7 @@ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  yintercept=yintercept,
@@ -2871,7 +3089,8 @@ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend
                  **other_args)
 
 
-def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+               tooltips=None,
                xintercept=None,
                color_by=None,
                **other_args):
@@ -2895,6 +3114,9 @@ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -2924,7 +3146,7 @@ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : lines width.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
 
     Examples
     --------
@@ -2979,6 +3201,7 @@ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  xintercept=xintercept,
@@ -2986,7 +3209,7 @@ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend
                  **other_args)
 
 
-def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_legend=None, tooltips=None,
+def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, tooltips=None,
                  orientation=None,
                  fatten=None,
                  outlier_alpha=None, outlier_color=None, outlier_fill=None,
@@ -3017,6 +3240,9 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     tooltips : `layer_tooltips`
         Result of the call to the `layer_tooltips()` function.
         Specify appearance, style and content.
@@ -3081,7 +3307,7 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : lines width.
-    - linetype : type of the line of border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : type of the line of border. 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.
     - width : width of boxplot. Typically ranges between 0 and 1. Values that are greater than 1 lead to overlapping of the boxes.
 
     Examples
@@ -3168,6 +3394,7 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
                           stat=stat,
                           position=position,
                           show_legend=show_legend,
+                 manual_key=manual_key,
                           sampling=None,
                           tooltips=tooltips,
                           orientation=orientation,
@@ -3200,7 +3427,8 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
     return boxplot_layer
 
 
-def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+                tooltips=None,
                 orientation=None,
                 show_half=None,
                 quantiles=None, quantile_lines=None,
@@ -3227,6 +3455,9 @@ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legen
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -3300,7 +3531,7 @@ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legen
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : lines width.
-    - linetype : type of the line of border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : type of the line of border. 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.
     - weight : used by 'ydensity' stat to compute weighted density.
     - quantile : quantile values to draw quantile lines and fill quantiles of the geometry by color.
 
@@ -3404,6 +3635,7 @@ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legen
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  orientation=orientation,
@@ -3415,7 +3647,7 @@ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legen
                  **other_args)
 
 
-def geom_ydotplot(mapping=None, *, data=None, show_legend=None, sampling=None, tooltips=None,
+def geom_ydotplot(mapping=None, *, data=None, show_legend=None, manual_key=None, sampling=None, tooltips=None,
                   orientation=None,
                   binwidth=None,
                   bins=None,
@@ -3444,6 +3676,9 @@ def geom_ydotplot(mapping=None, *, data=None, show_legend=None, sampling=None, t
         is inherited from the plot data as specified in the call to ggplot.
     show_legend : bool, default=True
         False - do not show legend for this layer.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -3577,6 +3812,7 @@ def geom_ydotplot(mapping=None, *, data=None, show_legend=None, sampling=None, t
                  stat=None,
                  position=None,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  orientation=orientation,
@@ -3593,7 +3829,8 @@ def geom_ydotplot(mapping=None, *, data=None, show_legend=None, sampling=None, t
                  **other_args)
 
 
-def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
+                     sampling=None, tooltips=None,
                      trim=None, tails_cutoff=None, kernel=None, adjust=None, bw=None, n=None, fs_max=None,
                      min_height=None, scale=None, quantiles=None, quantile_lines=None,
                      color_by=None, fill_by=None,
@@ -3620,6 +3857,9 @@ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -3690,7 +3930,7 @@ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : lines width.
-    - linetype : type of the line of border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : type of the line of border. 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.
     - weight : used by 'densityridges' stat to compute weighted density.
     - quantile : quantile values to draw quantile lines and fill quantiles of the geometry by color.
 
@@ -3753,6 +3993,7 @@ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  trim=trim,
@@ -3770,7 +4011,8 @@ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_
                  **other_args)
 
 
-def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+                tooltips=None,
                 color_by=None, fill_by=None,
                 **other_args):
     """
@@ -3793,6 +4035,9 @@ def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legen
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -3827,7 +4072,7 @@ def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legen
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : lines width.
-    - linetype : type of the line of border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : type of the line of border. 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.
 
     Examples
     --------
@@ -3875,13 +4120,15 @@ def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legen
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  color_by=color_by, fill_by=fill_by,
                  **other_args)
 
 
-def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+              tooltips=None,
               flat=None, color_by=None, fill_by=None,
               **other_args):
     """
@@ -3910,6 +4157,9 @@ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -3946,7 +4196,7 @@ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : lines width.
-    - linetype : type of the line of border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : type of the line of border. 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.
 
     Examples
     --------
@@ -3996,6 +4246,7 @@ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  flat=flat,
@@ -4003,7 +4254,8 @@ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  **other_args)
 
 
-def geom_density(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_density(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+                 tooltips=None,
                  orientation=None,
                  trim=None,
                  kernel=None,
@@ -4040,6 +4292,9 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -4101,7 +4356,7 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : lines width.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
     - weight : used by 'density' stat to compute weighted density.
     - quantile : quantile values to draw quantile lines and fill quantiles of the geometry by color.
 
@@ -4203,6 +4458,7 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  orientation=orientation,
@@ -4212,7 +4468,8 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
                  **other_args)
 
 
-def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
+                   sampling=None, tooltips=None,
                    kernel=None,
                    adjust=None,
                    bw=None,
@@ -4224,6 +4481,10 @@ 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`
@@ -4241,6 +4502,9 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -4278,7 +4542,6 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
 
     Notes
     -----
-    `geom_density2d()` draws density function.
 
     Computed variables:
 
@@ -4292,9 +4555,10 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : lines width.
-    - linetype : type of the line of border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : type of the line of border. 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.
+    - weight : used by 'density2d' stat to compute weighted density.
 
-    |
+    ----
 
     'density2d' statistical transformation combined with parameter value `contour=False`
     could be used to draw heatmaps (see the example below).
@@ -4418,6 +4682,7 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  kernel=kernel, adjust=adjust, bw=bw, n=n, bins=bins, binwidth=binwidth,
@@ -4425,7 +4690,8 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
                  **other_args)
 
 
-def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None,
+def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
+                    sampling=None,
                     tooltips=None,
                     kernel=None,
                     adjust=None,
@@ -4438,6 +4704,10 @@ 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`
@@ -4455,6 +4725,9 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -4494,7 +4767,6 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
 
     Notes
     -----
-    `geom_density2df()` fills density contours.
 
     Computed variables:
 
@@ -4506,8 +4778,9 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
     - x : x-axis coordinates.
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - fill : fill color. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
+    - weight : used by 'density2df' stat to compute weighted density.
 
-    |
+    ----
 
     'density2df' statistical transformation combined with parameter value `contour=False`
     could be used to draw heatmaps (see the example below).
@@ -4634,6 +4907,7 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  kernel=kernel,
@@ -4645,7 +4919,8 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
                  **other_args)
 
 
-def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+                tooltips=None,
                 width=None, height=None,
                 color_by=None, fill_by=None,
                 seed=None,
@@ -4675,6 +4950,9 @@ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legen
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -4717,7 +4995,7 @@ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legen
     - alpha : transparency level of a point. Accept values between 0 and 1.
     - color (colour) : color of the geometry. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. Is applied only to the points of shapes having inner area. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
-    - shape : shape of the point, an integer from 0 to 25.
+    - shape : shape of the point, an integer from 0 to 25. For more info see https://lets-plot.org/python/pages/aesthetics.html#point-shapes.
     - size : size of the point.
     - stroke : width of the shape border. Applied only to the shapes having border.
 
@@ -4765,6 +5043,7 @@ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legen
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  width=width, height=height,
@@ -4773,7 +5052,8 @@ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legen
                  **other_args)
 
 
-def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+            tooltips=None,
             distribution=None,
             dparams=None,
             color_by=None, fill_by=None,
@@ -4804,6 +5084,9 @@ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=No
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -4854,7 +5137,7 @@ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=No
     - alpha : transparency level of a point. Accept values between 0 and 1.
     - color (colour) : color of the geometry. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. Is applied only to the points of shapes having inner area. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
-    - shape : shape of the point, an integer from 0 to 25.
+    - shape : shape of the point, an integer from 0 to 25. For more info see https://lets-plot.org/python/pages/aesthetics.html#point-shapes.
     - size : size of the point.
     - stroke : width of the shape border. Applied only to the shapes having border.
 
@@ -4894,6 +5177,7 @@ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=No
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  distribution=distribution,
@@ -4902,7 +5186,8 @@ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=No
                  **other_args)
 
 
-def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+             tooltips=None,
              color_by=None, fill_by=None,
              **other_args):
     """
@@ -4931,6 +5216,9 @@ def geom_qq2(mapping=None, *, data=None, stat=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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -4970,7 +5258,7 @@ def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=N
     - alpha : transparency level of a point. Accept values between 0 and 1.
     - color (colour) : color of the geometry. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. Is applied only to the points of shapes having inner area. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
-    - shape : shape of the point, an integer from 0 to 25.
+    - shape : shape of the point, an integer from 0 to 25. For more info see https://lets-plot.org/python/pages/aesthetics.html#point-shapes.
     - size : size of the point.
     - stroke : width of the shape border. Applied only to the shapes having border.
 
@@ -4996,13 +5284,15 @@ def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=N
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  color_by=color_by, fill_by=fill_by,
                  **other_args)
 
 
-def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+                 tooltips=None,
                  distribution=None,
                  dparams=None,
                  quantiles=None,
@@ -5034,6 +5324,9 @@ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_lege
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -5080,7 +5373,7 @@ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_lege
     - sample : y-axis value.
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
     - size : line width.
 
     Examples
@@ -5120,6 +5413,7 @@ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_lege
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  distribution=distribution,
@@ -5129,7 +5423,8 @@ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_lege
                  **other_args)
 
 
-def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
+                  sampling=None, tooltips=None,
                   quantiles=None,
                   color_by=None,
                   **other_args):
@@ -5159,6 +5454,9 @@ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_leg
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -5191,7 +5489,7 @@ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_leg
     - y : y-axis value.
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
     - size : line width.
 
     Examples
@@ -5216,6 +5514,7 @@ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_leg
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  quantiles=quantiles,
@@ -5223,7 +5522,8 @@ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_leg
                  **other_args)
 
 
-def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
+                  sampling=None, tooltips=None,
                   orientation=None,
                   color_by=None,
                   **other_args):
@@ -5253,6 +5553,9 @@ def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_leg
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -5290,7 +5593,7 @@ def geom_freqpoly(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. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : lines width.
-    - linetype : type of the line of border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : type of the line of border. 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.
 
     Examples
     --------
@@ -5331,6 +5634,7 @@ def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_leg
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  orientation=orientation,
@@ -5338,7 +5642,8 @@ def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_leg
                  **other_args)
 
 
-def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+              tooltips=None,
               direction=None,
               color_by=None,
               **other_args):
@@ -5367,6 +5672,9 @@ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -5400,7 +5708,7 @@ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : line width.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
 
     Examples
     --------
@@ -5443,6 +5751,7 @@ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  direction=direction,
@@ -5450,7 +5759,8 @@ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  **other_args)
 
 
-def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+              tooltips=None,
               map=None, map_join=None, use_crs=None,
               color_by=None, fill_by=None,
               **other_args):
@@ -5474,6 +5784,9 @@ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -5520,15 +5833,15 @@ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : lines width.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
 
-    |
+    ----
 
     The `data` and `map` parameters of `GeoDataFrame` type support shapes `MultiPoint`, `Line`, `MultiLine`, `Polygon` and `MultiPolygon`.
 
     The `map` parameter of `Geocoder` type implicitly invokes `limits()` function.
 
-    |
+    ----
 
     The conventions for the values of `map_join` parameter are as follows:
 
@@ -5609,6 +5922,7 @@ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  map=map, map_join=map_join, use_crs=use_crs,
@@ -5616,7 +5930,8 @@ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  **other_args)
 
 
-def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+                 tooltips=None,
                  arrow=None, flat=None, geodesic=None, spacer=None, color_by=None, **other_args):
     """
     Draw a straight line segment between two points.
@@ -5643,6 +5958,9 @@ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_lege
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -5684,7 +6002,7 @@ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_lege
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : line width.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
     - size_start : offset from the segment start coordinate (usually equal to the size of the point object from which the segment starts to avoid overlapping with it).
     - size_end : offset from the segment end coordinate (usually equal to the size of the point object from which the segment ends to avoid overlapping with it).
     - stroke_start : offset from the segment start coordinate (usually equal to the stroke of the point object from which the segment starts to avoid overlapping with it).
@@ -5755,6 +6073,7 @@ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_lege
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  arrow=arrow,
@@ -5765,7 +6084,8 @@ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_lege
                  **other_args)
 
 
-def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+               tooltips=None,
                arrow=None,
                curvature=None, angle=None, ncp=None,
                spacer=None,
@@ -5795,6 +6115,9 @@ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -5841,7 +6164,7 @@ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry lines. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : line width.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
     - size_start : offset from the start coordinate (usually equal to the size of the point object from which the curve starts to avoid overlapping with it).
     - size_end : offset from the end coordinate (usually equal to the size of the point object from which the curve ends to avoid overlapping with it).
     - stroke_start : offset from the start coordinate (usually equal to the stroke of the point object from which the curve starts to avoid overlapping with it).
@@ -5908,6 +6231,7 @@ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  arrow=arrow,
@@ -5917,7 +6241,8 @@ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend
                  **other_args)
 
 
-def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, manual_key=None, sampling=None,
+               tooltips=None,
                arrow=None, pivot=None,
                color_by=None, **other_args):
     """
@@ -5938,6 +6263,9 @@ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, samp
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -5972,7 +6300,7 @@ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, samp
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the line. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - size : line width.
-    - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : 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.
 
     Examples
     --------
@@ -6037,6 +6365,7 @@ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, samp
                  stat=None,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  arrow=arrow,
@@ -6045,7 +6374,8 @@ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, samp
                  **other_args)
 
 
-def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+              tooltips=None,
               map=None, map_join=None, use_crs=None,
               label_format=None,
               na_text=None,
@@ -6078,6 +6408,9 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -6145,13 +6478,13 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
     - angle : text rotation angle in degrees.
     - lineheight : line height multiplier applied to the font size in the case of multi-line text.
 
-    |
+    ----
 
     The `data` and `map` parameters of `GeoDataFrame` type support shapes `Point` and `MultiPoint`.
 
     The `map` parameter of `Geocoder` type implicitly invokes `centroids()` function.
 
-    |
+    ----
 
     The conventions for the values of `map_join` parameter are as follows:
 
@@ -6254,6 +6587,7 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  map=map, map_join=map_join, use_crs=use_crs,
@@ -6265,7 +6599,8 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  **other_args)
 
 
-def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+               tooltips=None,
                map=None, map_join=None, use_crs=None,
                label_format=None,
                na_text=None,
@@ -6300,6 +6635,9 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -6378,13 +6716,13 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
     - angle : rotation angle in degrees.
     - lineheight : line height multiplier applied to the font size in the case of multi-line text.
 
-    |
+    ----
 
     The `data` and `map` parameters of `GeoDataFrame` type support shapes `Point` and `MultiPoint`.
 
     The `map` parameter of `Geocoder` type implicitly invokes `centroids()` function.
 
-    |
+    ----
 
     The conventions for the values of `map_join` parameter are as follows:
 
@@ -6488,6 +6826,7 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  map=map, map_join=map_join, use_crs=use_crs,
@@ -6503,7 +6842,8 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
                  **other_args)
 
 
-def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None, labels=None,
+def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+             tooltips=None, labels=None,
              map=None, map_join=None, use_crs=None,
              hole=None,
              stroke_side=None,
@@ -6533,6 +6873,9 @@ def geom_pie(mapping=None, *, data=None, stat=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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -6597,7 +6940,7 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
     - x : x-axis value.
     - y : y-axis value.
     - slice : values associated to pie sectors.
-    - explode : values to explode slices away from their center point, detaching it from the main pie.
+    - explode : values to explode slices away from their center point, detaching it from the main pie. Accept values between 0 and 1.
     - size : pie diameter.
     - fill : fill color. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - alpha : transparency level of the pie. Accept values between 0 and 1.
@@ -6605,13 +6948,13 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
     - stroke : width of inner and outer arcs of pie sector.
     - color : color of inner and outer arcs of pie sector.
 
-    |
+    ----
 
     The `data` and `map` parameters of `GeoDataFrame` type support shapes `Point` and `MultiPoint`.
 
     The `map` parameter of `Geocoder` type implicitly invokes `centroids()` function.
 
-    |
+    ----
 
     The conventions for the values of `map_join` parameter are as follows:
 
@@ -6635,8 +6978,6 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
 
       - map_join=['County_name', 'State_Name']
 
-    |
-
     Examples
     --------
     .. jupyter-execute::
@@ -6676,10 +7017,9 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
 
     .. jupyter-execute::
         :linenos:
-        :emphasize-lines: 5-9
+        :emphasize-lines: 4-8
 
         from lets_plot import *
-        from lets_plot.mapping import *
         LetsPlot.setup_html()
         data = {'name': ['a', 'b', 'c', 'd', 'b'], 'value': [40, 90, 10, 50, 20]}
         ggplot(data) + geom_pie(aes(fill=as_discrete('name', order_by='..count..'), weight='value'), \\
@@ -6692,10 +7032,9 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
 
     .. jupyter-execute::
         :linenos:
-        :emphasize-lines: 5-7
+        :emphasize-lines: 4-6
 
         from lets_plot import *
-        from lets_plot.mapping import *
         LetsPlot.setup_html()
         data = {'name': ['a', 'b', 'c', 'd', 'b'], 'value': [40, 90, 10, 50, 20]}
         ggplot(data) + geom_pie(aes(fill=as_discrete('name', order_by='..count..'), weight='value'), \\
@@ -6731,6 +7070,7 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  labels=labels,
@@ -6744,7 +7084,8 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
                  **other_args)
 
 
-def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
+                  sampling=None, tooltips=None,
                   orientation=None,
                   dir=None, fatten=None, slope=None, intercept=None,
                   color_by=None, fill_by=None,
@@ -6774,6 +7115,9 @@ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_leg
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -6817,13 +7161,13 @@ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_leg
     - alpha : transparency level of the point. Accept values between 0 and 1.
     - color (colour) : color of the geometry. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. Is applied only to the points of shapes having inner area. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
-    - shape : shape of the point, an integer from 0 to 25.
+    - shape : shape of the point, an integer from 0 to 25. For more info see https://lets-plot.org/python/pages/aesthetics.html#point-shapes.
     - size : size of the point.
     - stroke : width of the shape border. Applied only to the shapes having border.
     - linewidth : stick width.
-    - linetype : type of the stick line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
+    - linetype : type of the stick 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.
 
-    |
+    ----
 
     When `slope=0`, the baseline cannot be parallel to the lollipop sticks.
     So, in this case, if `dir='h'`, the baseline will becomes vertical, as for infinity slope.
@@ -6884,6 +7228,7 @@ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_leg
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  orientation=orientation,
@@ -6892,7 +7237,8 @@ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_leg
                  **other_args)
 
 
-def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
+def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
+               tooltips=None,
                color_by=None, fill_by=None,
                **other_args):
     """
@@ -6915,6 +7261,9 @@ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend
         '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.
+    manual_key : str or `layer_key`
+        The key to show in the manual legend.
+        Specify text for the legend label or advanced settings using the `layer_key()` function.
     sampling : `FeatureSpec`
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
@@ -6951,20 +7300,18 @@ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend
     - alpha : transparency level of the point. Accept values between 0 and 1.
     - color (colour) : color of the geometry. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
     - fill : fill color. Is applied only to the points of shapes having inner area. String in the following formats: RGB/RGBA (e.g. "rgb(0, 0, 255)"); HEX (e.g. "#0000FF"); color name (e.g. "red"); role name ("pen", "paper" or "brush").
-    - shape : shape of the point, an integer from 0 to 25.
+    - shape : shape of the point, an integer from 0 to 25. For more info see https://lets-plot.org/python/pages/aesthetics.html#point-shapes.
     - size : size of the point.
     - stroke : width of the shape border. Applied only to the shapes having border.
 
-
     Examples
     --------
     .. jupyter-execute::
         :linenos:
-        :emphasize-lines: 10
+        :emphasize-lines: 9
 
         import numpy as np
         from lets_plot import *
-        from lets_plot.mapping import as_discrete
         LetsPlot.setup_html()
         n = 50
         np.random.seed(42)
@@ -6977,11 +7324,10 @@ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend
 
     .. jupyter-execute::
         :linenos:
-        :emphasize-lines: 10
+        :emphasize-lines: 9
 
         import numpy as np
         from lets_plot import *
-        from lets_plot.mapping import as_discrete
         LetsPlot.setup_html()
         n = 50
         np.random.seed(42)
@@ -6998,6 +7344,7 @@ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend
                  stat=stat,
                  position=position,
                  show_legend=show_legend,
+                 manual_key=manual_key,
                  sampling=sampling,
                  tooltips=tooltips,
                  color_by=color_by, fill_by=fill_by,
@@ -7010,6 +7357,7 @@ def _geom(name, *,
           stat=None,
           position=None,
           show_legend=None,
+          manual_key=None,
           sampling=None,
           tooltips=None,
           **kwargs):
@@ -7017,11 +7365,13 @@ def _geom(name, *,
         if not (isinstance(mapping, FeatureSpec) and mapping.kind == 'mapping'):
             raise ValueError("Unexpected value for argument 'mapping'. Hint: try to use function aes()")
 
-    data, mapping, data_meta = as_annotated_data(data, mapping)
-
     if is_geocoder(data):
         data = data.get_geocodes()
 
+    data = key_int2str(data)
+
+    data, mapping, data_meta = as_annotated_data(data, mapping)
+
     # GDF in a map parameter has higher priority for defining a geo_data_meta
     if is_geo_data_frame(data) and not is_geo_data_frame(kwargs.get('map')):
         data = geo_data_frame_to_crs(data, kwargs.get('use_crs'))
@@ -7033,6 +7383,7 @@ def _geom(name, *,
                      mapping=mapping,
                      position=position,
                      show_legend=show_legend,
+                     manual_key=manual_key,
                      sampling=sampling,
                      tooltips=tooltips,
                      **data_meta,