lets-plot 4.6.0rc1__cp311-cp311-win_amd64.whl → 4.6.2__cp311-cp311-win_amd64.whl

lets_plot/plot/geom.py

@@ -939,8 +939,8 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
         Result of the call to the `sampling_xxx()` function.
         To prevent any sampling for this layer pass value "none" (string "none").
     threshold : float, default=None
-        If a bin's `..count..` is less than the threshold, the bin will be removed.
-        Dropping empty bins is particularly useful for faceted plots with free scales.
+        If a bin's `..count..` is less than the threshold, it will be removed, but only if it is on the left or right edge of the histogram.
+        Dropping empty edge bins is particularly useful for faceted plots with free scales.
     tooltips : `layer_tooltips`
         Result of the call to the `layer_tooltips()` function.
         Specify appearance, style and content.
@@ -1466,23 +1466,23 @@ def geom_hex(mapping=None, *, data=None, stat=None, position=None, show_legend=N
         Override `bins`. The default is to use bin widths that cover the entire range of the data.
     drop : bool, default=True
         Specify whether to remove all hexagonal bins with 0 counts.
-    width_unit : {'res', 'identity', 'size', 'px'}, default='identity'
+    width_unit : {'res', 'identity', 'size', 'px'}, default='res'
         Unit for width of the hexagon.
         Possible values:
 
-        - 'res': value 1 corresponds to the resolution along the x-axis, i.e. the minimum distance between data points;
-        - 'identity': value 1 corresponds to the distance from 0 to 1 on the x-axis;
-        - 'size': value 1 corresponds to the diameter of a point of size 1;
-        - 'px': value 1 corresponds to 1 pixel.
+        - 'res': if `stat='binhex'`, the unit equals the hexagonal bin width (`binwidth[0]`); otherwise, it represents the smallest distance between adjacent hexagons along the corresponding axis;
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
 
-    height_unit : {'res', 'identity', 'size', 'px'}, default='identity'
+    height_unit : {'res', 'identity', 'size', 'px'}, default='res'
         Unit for height of the hexagon.
         Possible values:
 
-        - 'res': value 1 corresponds to the resolution along the y-axis, i.e. the minimum distance between data points;
-        - 'identity': value 1 corresponds to the distance from 0 to 1 on the y-axis;
-        - 'size': value 1 corresponds to the diameter of a point of size 1;
-        - 'px': value 1 corresponds to 1 pixel.
+        - 'res': if `stat='binhex'`, the unit equals the hexagonal bin height (`binwidth[1]`); otherwise, it represents the smallest distance between adjacent hexagons along the corresponding axis;
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
 
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
         Define the color aesthetic for the geometry.
@@ -1581,6 +1581,21 @@ def geom_hex(mapping=None, *, data=None, stat=None, position=None, show_legend=N
                        fill='darkgreen') + \\
             ggsize(600, 450)
 
+    |
+
+    .. jupyter-execute::
+        :linenos:
+        :emphasize-lines: 7-8
+
+        import numpy as np
+        from lets_plot import *
+        LetsPlot.setup_html()
+        np.random.seed(42)
+        x, y = np.random.multivariate_normal(mean=[-98, 39], cov=[[100, 0], [0, 10]], size=100).T
+        ggplot() + geom_livemap() + \\
+            geom_hex(aes(x, y, fill='..density..'), \\
+                     bins=[10, 5], alpha=.5, show_legend=False)
+
     """
     return _geom('hex',
                  mapping=mapping,
@@ -1642,19 +1657,19 @@ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=
         Unit for width of the tile.
         Possible values:
 
-        - 'res': value 1 corresponds to the resolution along the x-axis, i.e. the minimum distance between data points;
-        - 'identity': value 1 corresponds to the distance from 0 to 1 on the x-axis;
-        - 'size': value 1 corresponds to the diameter of a point of size 1;
-        - 'px': value 1 corresponds to 1 pixel.
+        - 'res': the unit equals the smallest distance between adjacent tiles along the corresponding axis;
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
 
     height_unit : {'res', 'identity', 'size', 'px'}, default='res'
         Unit for height of the tile.
         Possible values:
 
-        - 'res': value 1 corresponds to the resolution along the y-axis, i.e. the minimum distance between data points;
-        - 'identity': value 1 corresponds to the distance from 0 to 1 on the y-axis;
-        - 'size': value 1 corresponds to the diameter of a point of size 1;
-        - 'px': value 1 corresponds to 1 pixel.
+        - 'res': the unit equals the smallest distance between adjacent tiles along the corresponding axis;
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
 
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
         Define the color aesthetic for the geometry.
@@ -1871,7 +1886,7 @@ def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legen
 def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
                   manual_key=None,
                   sampling=None, tooltips=None,
-                  width_unit=None, height_unit=None,
+                  width_unit=None,
                   color_by=None,
                   **other_args):
     """
@@ -1912,22 +1927,13 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
         Specify appearance, style and content.
         Set tooltips='none' to hide tooltips from the layer.
     width_unit : {'res', 'identity', 'size', 'px'}, default='res'
-        Unit for the whisker width of the vertical error bar.
+        Unit for the whisker width of the error bar.
         Possible values:
 
-        - 'res': value 1 corresponds to the resolution along the x-axis, i.e. the minimum distance between data points;
-        - 'identity': value 1 corresponds to the distance from 0 to 1 on the x-axis;
-        - 'size': value 1 corresponds to the diameter of a point of size 1;
-        - 'px': value 1 corresponds to 1 pixel.
-
-    height_unit : {'res', 'identity', 'size', 'px'}, default='res'
-        Unit for the whisker height of the horizontal error bar.
-        Possible values:
-
-        - 'res': value 1 corresponds to the resolution along the y-axis, i.e. the minimum distance between data points;
-        - 'identity': value 1 corresponds to the distance from 0 to 1 on the y-axis;
-        - 'size': value 1 corresponds to the diameter of a point of size 1;
-        - 'px': value 1 corresponds to 1 pixel.
+        - 'res': the unit equals the smallest distance between adjacent error bars along the corresponding axis;
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
 
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
         Define the color aesthetic for the geometry.
@@ -1955,7 +1961,7 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
     - alpha : transparency level of a layer. Accept values between 0 and 1.
     - color (colour) : color of the geometry lines. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
     - size : line width. Define bar line width.
-    - width or height : size of the whiskers of vertical or horizontal bar, respectively. Typically range between 0 and 1. Values that are greater than 1 lead to overlapping of the bars.
+    - width : size of the whiskers of error bar. Typically range between 0 and 1. Values that are greater than 1 lead to overlapping of the bars.
     - linetype : type of the line. Accept codes or names (0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'), a hex string (up to 8 digits for dash-gap lengths), or a list pattern [offset, [dash, gap, ...]] / [dash, gap, ...]. For more info see `Line Types <https://lets-plot.org/python/pages/aesthetics.html#line-types>`__.
 
     ----
@@ -2017,9 +2023,22 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
             'c': ['gr1', 'gr2', 'gr1', 'gr2']
         }
         ggplot(data) + \\
-            geom_errorbar(aes(y='y', xmin='xmin', xmax='xmax', color='c'), height=0.1, size=2)
+            geom_errorbar(aes(y='y', xmin='xmin', xmax='xmax', color='c'), width=0.1, size=2)
 
     """
+    if mapping is not None and 'height' in mapping.props():
+        print("WARN: using 'height' aesthetic parameter for errorbar was deprecated.\n"
+              "      Please, use 'width' aesthetic instead.")
+        mapping.props()['width'] = mapping.props().pop('height')
+    if 'height' in other_args:
+        print("WARN: using 'height' parameter for errorbar was deprecated.\n"
+              "      Please, use 'width' parameter instead.")
+        other_args['width'] = other_args.pop('height')
+    if 'height_unit' in other_args:
+        print("WARN: using 'height_unit' parameter for errorbar was deprecated.\n"
+              "      Please, use 'width_unit' parameter instead.")
+        other_args.pop('height_unit')
+
     return _geom('errorbar',
                  mapping=mapping,
                  data=data,
@@ -2031,7 +2050,6 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
                  sampling=sampling,
                  tooltips=tooltips,
                  width_unit=width_unit,
-                 height_unit=height_unit,
                  color_by=color_by,
                  **other_args)
 
@@ -2085,10 +2103,10 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
         Unit for the width of the crossbar.
         Possible values:
 
-        - 'res': value 1 corresponds to the resolution along the x-axis, i.e. the minimum distance between data points;
-        - 'identity': value 1 corresponds to the distance from 0 to 1 on the x-axis;
-        - 'size': value 1 corresponds to the diameter of a point of size 1;
-        - 'px': value 1 corresponds to 1 pixel.
+        - 'res': the unit equals the smallest distance between adjacent crossbars along the corresponding axis;
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
 
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
         Define the color aesthetic for the geometry.
@@ -3679,10 +3697,10 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
         Unit for the width of the boxplot.
         Possible values:
 
-        - 'res': value 1 corresponds to the resolution along the x-axis, i.e. the minimum distance between data points;
-        - 'identity': value 1 corresponds to the distance from 0 to 1 on the x-axis;
-        - 'size': value 1 corresponds to the diameter of a point of size 1;
-        - 'px': value 1 corresponds to 1 pixel.
+        - 'res': the unit equals the smallest distance between adjacent boxes along the corresponding axis;
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
 
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
         Define the color aesthetic for the geometry.
@@ -6969,6 +6987,7 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
               na_text=None,
               nudge_x=None, nudge_y=None,
               size_unit=None,
+              nudge_unit=None,
               check_overlap=None,
               color_by=None,
               **other_args):
@@ -7038,6 +7057,14 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
     size_unit : {'x', 'y'}
         Relate the size of the text to the length of the unit step along one of the axes.
         If None, no fitting is performed.
+    nudge_unit : {'identity', 'size', 'px'}, default='identity'
+        Units for x and y nudging.
+        Possible values:
+
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
+
     check_overlap : bool, default=False
         If True, skip plotting text that overlaps previous text in the same layer.
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
@@ -7190,6 +7217,7 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
                  na_text=na_text,
                  nudge_x=nudge_x, nudge_y=nudge_y,
                  size_unit=size_unit,
+                 nudge_unit=nudge_unit,
                  check_overlap=check_overlap,
                  color_by=color_by,
                  **other_args)
@@ -7205,6 +7233,7 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
                label_padding=None, label_r=None, label_size=None,
                alpha_stroke=None,
                size_unit=None,
+               nudge_unit=None,
                check_overlap=None,
                color_by=None, fill_by=None,
                **other_args):
@@ -7282,6 +7311,14 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
     size_unit : {'x', 'y'}
         Relate the size of the text label to the length of the unit step along one of the axes.
         If None, no fitting is performed.
+    nudge_unit : {'identity', 'size', 'px'}, default='identity'
+        Units for x and y nudging.
+        Possible values:
+
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
+
     check_overlap : bool, default=False
         If True, skip plotting text that overlaps previous text in the same layer.
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
@@ -7442,6 +7479,7 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
                  label_size=label_size,
                  alpha_stroke=alpha_stroke,
                  size_unit=size_unit,
+                 nudge_unit=nudge_unit,
                  check_overlap=check_overlap,
                  color_by=color_by, fill_by=fill_by,
                  **other_args)

lets_plot/plot/geom_livemap_.py

@@ -272,33 +272,13 @@ def _prepare_tiles(tiles: Optional[Union[str, dict]]) -> Optional[dict]:
 
 
 def _warn_deprecated_tiles(tiles: Union[dict, None]):
-    # TODO: Remove this warning in future releases.
-
     if tiles is None:
         maptiles_url = get_global_val(MAPTILES_URL)
     else:
         maptiles_url = tiles[MAPTILES_URL]
 
-    if not isinstance(maptiles_url, str):
-        return
-    if not maptiles_url.startswith("https://cartocdn_[abc].global.ssl.fastly.net/"):
-        return
-    if 'base-midnight' not in maptiles_url and 'base-antique' not in maptiles_url and 'base-flatblue' not in maptiles_url:
-        return
-
-    if tiles is None:
-        if not has_global_value(MAPTILES_ATTRIBUTION):
-            return
-        maptiles_attribution = get_global_val(MAPTILES_ATTRIBUTION)
-    else:
-        maptiles_attribution = tiles[MAPTILES_ATTRIBUTION]
-
-    if not isinstance(maptiles_attribution, str):
-        return
-    if not maptiles_attribution.endswith('map data: <a href="https://www.openstreetmap.org/copyright">© OpenStreetMap contributors</a> <a href="https://carto.com/attributions#basemaps">© CARTO</a>, <a href="https://carto.com/attributions">© CARTO</a>'):
-        return
-
-    print(f"WARN: The tileset is no longer available and the corresponding constant will be removed in future releases.")
+    # Check if the current tiles should be deprecated and print a deprecation message. Otherwise, return.
+    return
 
 
 def _prepare_location(location: Union[str, List[float]]) -> Optional[dict]:

lets_plot/plot/ggtb_.py

@@ -29,7 +29,6 @@ def ggtb() -> FeatureSpec:
     Limitations:
 
     - The toolbar does not work with interactive maps.
-    - The toolbar is not compatible with GGBunch.
     - The toolbar cannot be used with plots using a polar coordinate system.
 
     Returns

lets_plot/plot/pos.py

@@ -156,8 +156,13 @@ def position_nudge(x=None, y=None, unit=None):
         Nudging width.
     y : float
         Nudging height.
-    unit : {'identity', 'size', 'px'}
+    unit : {'identity', 'size', 'px'}, default='identity'
         Units for x and y nudging.
+        Possible values:
+
+        - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
+        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'px': the unit is measured in screen pixels.
 
     Returns
     -------

lets_plot/plot/theme_.py

@@ -601,12 +601,11 @@ def element_text(
         Can be used with values out of range, but behaviour is not specified.
     margin : number or list of numbers
         Margins around the text.
-
         The margin may be specified using a number or a list of numbers:
+
         - a number or list of one number - the same margin it applied to all four sides;
         - a list of two numbers - the first margin applies to the top and bottom, the second - to the left and right;
-        - a list of three numbers -  the first margin applies to the top, the second - to the right and left,
-        the third - to the bottom;
+        - a list of three numbers - the first margin applies to the top, the second - to the right and left, the third - to the bottom;
         - a list of four numbers - the margins are applied to the top, right, bottom and left in that order.
 
         It is acceptable to use None for any side; in this case, the default side value for this element will be used.
@@ -658,8 +657,8 @@ def element_markdown(
         Text color.
     family : str
         Font family.
-    face : str
-        Font face ("plain", "italic", "bold", "bold_italic").
+    face : {'plain', 'italic', 'bold', 'bold_italic'}, default='plain'
+        Font face.
     size : int
         Text size in px.
     angle : float
@@ -678,12 +677,11 @@ def element_markdown(
         Can be used with values out of range, but behaviour is not specified.
     margin : number or list of numbers
         Margins around the text.
-
         The margin may be specified using a number or a list of numbers:
+
         - a number or list of one number - the same margin it applied to all four sides;
         - a list of two numbers - the first margin applies to the top and bottom, the second - to the left and right;
-        - a list of three numbers -  the first margin applies to the top, the second - to the right and left,
-        the third - to the bottom;
+        - a list of three numbers -  the first margin applies to the top, the second - to the right and left, the third - to the bottom;
         - a list of four numbers - the margins are applied to the top, right, bottom and left in that order.
 
         It is acceptable to use None for any side; in this case, the default side value for this element will be used.
@@ -699,15 +697,20 @@ def element_markdown(
     --------
     .. jupyter-execute::
         :linenos:
-        :emphasize-lines: 7
+        :emphasize-lines: 12
 
-        import numpy as np
         from lets_plot import *
         LetsPlot.setup_html()
-        np.random.seed(42)
-        data = {'x': np.random.normal(size=1000)}
-        ggplot(data, aes(x='x')) + geom_histogram() + \\
-            theme(axis_text=element_text(color='#cb181d', face='bold_italic', margin=[5, 10]))
+        ggplot() + \\
+            geom_blank() + \\
+            labs(
+                title='*Hello*, **world**',
+                subtitle='_Simple plot_',
+                caption='*Powered by **lets-plot***',
+                x='Title **X**',
+                y='Title **Y**'
+            ) + \\
+            theme(title=element_markdown())
 
     """
     return {'markdown': True, **locals()}

lets_plot/tilesets.py

@@ -140,7 +140,6 @@ def _carto_tiles(tileset, cdn):
         if cdn == 'carto':
             base_url = "https://{{s}}.basemaps.cartocdn.com/rastertiles/{tileset}/{{z}}/{{x}}/{{y}}{hi_res}.png"
         elif cdn == 'fastly':
-            # TODO: remove this branch in future releases
             base_url = "https://cartocdn_{{s}}.global.ssl.fastly.net/{tileset}/{{z}}/{{x}}/{{y}}{hi_res}.png"
         else:
             raise ValueError("Unknown carto cdn: {}. Expected 'carto' or 'fastly'.".format(cdn))
@@ -268,19 +267,85 @@ Examples
 
 CARTO_MIDNIGHT_COMMANDER, CARTO_MIDNIGHT_COMMANDER_HIRES = _carto_tiles('base-midnight', cdn='fastly')
 """
-The tileset is deprecated and will be removed in future releases.
+CARTO tiles, midnight commander theme.
+
+Examples
+--------
+.. jupyter-execute::
+    :linenos:
+    :emphasize-lines: 4
+
+    from lets_plot import *
+    from lets_plot import tilesets
+    LetsPlot.setup_html()
+    ggplot() + geom_livemap(tiles=tilesets.CARTO_MIDNIGHT_COMMANDER)
+
+|
+
+.. jupyter-execute::
+    :linenos:
+    :emphasize-lines: 4
+
+    from lets_plot import *
+    from lets_plot import tilesets
+    LetsPlot.setup_html()
+    ggplot() + geom_livemap(tiles=tilesets.CARTO_MIDNIGHT_COMMANDER_HIRES)
 
 """
 
 CARTO_ANTIQUE, CARTO_ANTIQUE_HIRES = _carto_tiles('base-antique', cdn='fastly')
 """
-The tileset is deprecated and will be removed in future releases.
+CARTO tiles, antique theme.
+
+Examples
+--------
+.. jupyter-execute::
+    :linenos:
+    :emphasize-lines: 4
+
+    from lets_plot import *
+    from lets_plot import tilesets
+    LetsPlot.setup_html()
+    ggplot() + geom_livemap(tiles=tilesets.CARTO_ANTIQUE)
+
+|
+
+.. jupyter-execute::
+    :linenos:
+    :emphasize-lines: 4
+
+    from lets_plot import *
+    from lets_plot import tilesets
+    LetsPlot.setup_html()
+    ggplot() + geom_livemap(tiles=tilesets.CARTO_ANTIQUE_HIRES)
 
 """
 
 CARTO_FLAT_BLUE, CARTO_FLAT_BLUE_HIRES = _carto_tiles('base-flatblue', cdn='fastly')
 """
-The tileset is deprecated and will be removed in future releases.
+CARTO tiles, flat blue theme.
+
+Examples
+--------
+.. jupyter-execute::
+    :linenos:
+    :emphasize-lines: 4
+
+    from lets_plot import *
+    from lets_plot import tilesets
+    LetsPlot.setup_html()
+    ggplot() + geom_livemap(tiles=tilesets.CARTO_FLAT_BLUE)
+
+|
+
+.. jupyter-execute::
+    :linenos:
+    :emphasize-lines: 4
+
+    from lets_plot import *
+    from lets_plot import tilesets
+    LetsPlot.setup_html()
+    ggplot() + geom_livemap(tiles=tilesets.CARTO_FLAT_BLUE_HIRES)
 
 """
 

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: lets-plot
-Version: 4.6.0rc1
+Version: 4.6.2
 Summary: An open source library for statistical plotting
 Home-page: https://lets-plot.org
 Author: JetBrains
@@ -29,7 +29,7 @@ Classifier: Topic :: Scientific/Engineering :: Visualization
 Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: Developers
 Description-Content-Type: text/markdown
-License-File: ../LICENSE
+License-File: LICENSE
 Requires-Dist: pypng
 Requires-Dist: palettable
 Dynamic: author
@@ -40,6 +40,7 @@ Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: keywords
 Dynamic: license
+Dynamic: license-file
 Dynamic: maintainer
 Dynamic: maintainer-email
 Dynamic: project-url
@@ -102,45 +103,38 @@ Also read:
 - [Scientific mode in PyCharm](https://www.jetbrains.com/help/pycharm/matplotlib-support.html)
 - [Scientific mode in IntelliJ IDEA](https://www.jetbrains.com/help/idea/matplotlib-support.html)
 
-## What is new in 4.5.0
+## What is new in 4.6.0
 
-- #### Panning and Zooming
-  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24g/images/ggtb.png" alt="f-24g/images/ggtb.png" width="300" height="134">
+- #### Markdown Support in *Title*, *Subtitle*, *Caption*, and Axis Labels
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25a/images/markdown.png" alt="f-25a/images/markdown.png" width="400" height="237">
   
-  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/interact_pan_zoom.ipynb).
+  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/markdown.ipynb).
 
-- #### Clickable Links
-  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24g/images/lp_verse.png" alt="f-24g/images/lp_verse.png" width="400" height="270">
+- #### Support for Multiline Axis Labels, Text Justification in Axis Labels
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25a/images/multiline_axis_labels.png" alt="f-25a/images/multiline_axis_labels.png" width="400" height="275">
 
-  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/interactive_links.ipynb).
+  See examples: [multiline axis labels](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/multiline_axis_labels.ipynb),
+  [axis label justification](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/axis_label_justification.ipynb),
 
-- #### LaTeX Support: Subscript, Superscript, Greek Letters and Special Characters 
-  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24g/images/latex.png" alt="f-24g/images/latex.png" width="300" height="227">
+- #### `geom_hex()` Geometry
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25a/images/geom_hex.png" alt="f-25a/images/geom_hex.png" width="370" height="296">
 
-  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/latex_support.ipynb).
+  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/geom_hex.ipynb).
 
-> [!CAUTION]  
-> Subscripts and superscripts are not supported in PDF and PNG exports.
-
-- #### Compact Scientific Notation Formatting
-  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24g/images/compact_exp.png" alt="f-24g/images/compact_exp.png" width="400" height="174">
+- #### `ggbunch()` Function: Combining Plots with Custom Layout
+  It replaces the deprecated `GGBunch` class.  <br/>
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25a/images/ggbunch_indonesia.png" alt="f-25a/images/ggbunch_indonesia.png" width="400" height="164">
      
-  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/superscript_exponent.ipynb).
-
-> [!CAUTION]  
-> `pow` and `pow_full` options are not supported in PDF and PNG exports.     
+  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/ggbunch_indonesia.ipynb).
 
-- #### QQ-Plot: Marginal Distributions
-  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24g/images/gg_marins.png" alt="f-24g/images/gg_marins.png" width="400" height="249">
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25a/images/magnifier_inset.png" alt="f-25a/images/magnifier_inset.png" width="400" height="251">
 
-  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/qq_plot_marginal.ipynb).
+  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/magnifier_inset.ipynb).
 
-- #### More Theme Settings
-  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24g/images/theme_legend_scheme.png" alt="f-24g/images/theme_legend_scheme.png" width="400" height="320">
+- #### Parameters `start` and `direction` in `geom_pie()` Geometry
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25a/images/geom_pie_params.png" alt="f-25a/images/geom_pie_params.png" width="400" height="119">
 
-  See examples: [legend margins](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/theme_legend_margins.ipynb),
-  [legend key](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/theme_legend_key.ipynb),
-  [facet strip](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/theme_facet_strip_xy.ipynb).
+  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/geom_pie_params.ipynb).
 
 
 - #### And More
@@ -150,6 +144,21 @@ Also read:
 
 ## Recent Updates in the [Gallery](https://lets-plot.org/python/pages/gallery.html)
 
+  <a href="https://nbviewer.org/github/JetBrains/lets-plot-docs/blob/master/source/examples/demo/magnifier_inset.ipynb">
+    <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25a/images/magnifier_inset.png" alt="f-25a/images/magnifier_inset.png" width="128" height="128">
+  </a>
+  <a href="https://nbviewer.org/github/JetBrains/lets-plot-docs/blob/master/source/examples/demo/ggbunch_indonesia.ipynb">
+    <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25a/images/ggbunch_indonesia.png" alt="f-25a/images/ggbunch_indonesia.png" width="128" height="128">
+  </a>
+  <a href="https://nbviewer.org/github/JetBrains/lets-plot-docs/blob/master/source/examples/demo/theme_legend_scheme.ipynb">
+    <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24g/images/theme_legend_scheme.png" alt="f-24g/images/theme_legend_scheme.png" width="128" height="128">
+  </a>
+  <a href="https://nbviewer.org/github/JetBrains/lets-plot-docs/blob/master/source/examples/demo/interact_pan_zoom.ipynb">
+    <img src="https://github.com/JetBrains/lets-plot-docs/blob/4b9571b8af759574fa2db313a102069d8f8c7238/source/_static/images/changelog/4.5.0/interact_pan_zoom.png?raw=true" alt="images/changelog/4.5.0/interact_pan_zoom.png" width="128" height="128">
+  </a>
+  <a href="https://nbviewer.org/github/JetBrains/lets-plot-docs/blob/master/source/examples/demo/lp_verse.ipynb">
+    <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24g/images/lp_verse.png" alt="f-24g/images/lp_verse.png" width="128" height="128">
+  </a>
   <a href="https://nbviewer.org/github/JetBrains/lets-plot-docs/blob/master/source/examples/demo/us_unemployment.ipynb">
     <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24e/images/us_unemployment.png" alt="f-24e/images/us_unemployment.png" width="128" height="128">
   </a>
@@ -165,21 +174,7 @@ Also read:
   <a href="https://www.kaggle.com/code/alshan/japanese-volcanoes-on-map">
     <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24b/images/gal_japanese_volcanoes_on_map.png" alt="f-24b/images/gal_japanese_volcanoes_on_map.png" width="128" height="128">
   </a>
-  <a href="https://nextjournal.com/asmirnov-horis/bbc-visual-and-data-journalism-cookbook-for-lets-plot">
-    <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24a/images/gal_bbc_cookbook.png" alt="f-24a/images/gal_bbc_cookbook.png" width="128" height="128">
-  </a>
-  <a href="https://nbviewer.org/github/JetBrains/lets-plot-docs/blob/master/source/examples/demo/palmer_penguins.ipynb">
-    <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24a/images/gal_penguins.png" alt="f-24a/images/gal_penguins.png" width="128" height="128">
-  </a>
-  <a href="https://nbviewer.org/github/JetBrains/lets-plot-docs/blob/master/source/examples/demo/periodic_table.ipynb">
-    <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24a/images/gal_periodic_table.png" alt="f-24a/images/gal_periodic_table.png" width="128" height="128">
-  </a>
-  <a href="https://nbviewer.org/github/JetBrains/lets-plot-docs/blob/master/source/examples/demo/wind_rose.ipynb">
-    <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24a/images/gal_wind_rose.png" alt="f-24a/images/gal_wind_rose.png" width="128" height="128">
-  </a>
-  <a href="https://nbviewer.org/github/JetBrains/lets-plot-docs/blob/master/source/examples/demo/heatmap_in_polar_coord.ipynb">
-    <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-24a/images/gal_polar_heatmap.png" alt="f-24a/images/gal_polar_heatmap.png" width="128" height="128">
-  </a>
+
 
 ## Change Log