lets-plot 4.6.2__cp311-cp311-macosx_11_0_arm64.whl → 4.7.0__cp311-cp311-macosx_11_0_arm64.whl

lets_plot/plot/theme_.py

@@ -32,6 +32,7 @@ def theme(*,
           axis_text=None, axis_text_x=None, axis_text_y=None,
           # ToDo: axis.text.x.top, axis.text.x.bottom
           # ToDo: axis.text.x.left, axis.text.x.right
+          axis_text_spacing=None, axis_text_spacing_x=None, axis_text_spacing_y=None,
           axis_ticks=None, axis_ticks_x=None, axis_ticks_y=None,
           # ToDo: axis.ticks.x.top, axis.ticks.x.bottom
           # ToDo: axis.ticks.x.left, axis.ticks.x.right
@@ -116,59 +117,61 @@ def theme(*,
 
         Superscript is not supported when exporting to PNG/PDF.
     line : str or dict
-        All line elements.
+        Style settings for all line elements.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_line()` to specify line parameters.
     rect : str or dict
-        All rectangular elements.
+        Style settings for all rectangular elements.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_rect()` to specify rectangular element parameters.
     text : str or dict
-        All text elements.
+        Style settings for all text elements.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_text()` to specify text parameters.
     title : str or dict
-        All title elements: plot, axes, legends.
+        Style settings for all title elements: plot, axes, legends.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_text()` to specify title text parameters, inherited from `text`.
     axis : str or dict
-        All axis elements: lines, ticks, texts, titles.
+        Style settings for all axis elements: lines, ticks, texts, titles.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_line()` to specify axes parameters.
     axis_ontop, axis_ontop_x, axis_ontop_y : bool, default=True
         Option to place axis (lines, tickmarks and labels) over the data layers.
     axis_title, axis_title_x, axis_title_y : str or dict
-        Labels of axes.
+        Style settings for axis titles.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
-        Set `element_text()` to specify axes label parameters.
+        Set `element_text()` to specify axis title parameters.
         `axis_title_*` inherits from `axis_title` which inherits from `text`.
     axis_text, axis_text_x, axis_text_y : str or dict
-        Tick labels along axes.
+        Style settings for tick labels along axes.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_text()` to specify all axes tick label parameters.
         `axis_text_*` inherits from `axis_text` which inherits from `text`.
+    axis_text_spacing, axis_text_spacing_x, axis_text_spacing_y : float
+        Spacing between the axis label text and its tick mark.
     axis_ticks, axis_ticks_x, axis_ticks_y : str or dict
-        Tick marks along axes.
+        Style settings for tick marks along axes.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_line()` to specify all tick mark parameters.
         `axis_ticks_*` inherits from `axis_ticks` which inherits from `line`.
     axis_ticks_length, axis_ticks_length_x, axis_ticks_length_y : float
         Length of tick marks in px.
     axis_line, axis_line_x, axis_line_y : str or dict
-        Lines along axes.
+        Style settings for lines along axes.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_line()` to specify line parameters along all axes.
         `axis_line_*` inherits from `axis_line` which inherits from `line`.
     legend_background : str or dict
-        Background of legend.
+        Style settings for background of legend.
         Set 'blank' or result of `element_blank()` to draw nothing.
         Set `element_rect()` to specify legend background parameters, inherited from `rect`.
     legend_text : str or dict
-        Legend item labels.
+        Style settings for legend item labels.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_text()` to specify legend item label parameters, inherited from `text`.
     legend_title : str or dict
-        Title of legend.
+        Style settings for legend title.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_text()` to specify legend title parameters, inherited from `title`.
     legend_position : {'none', 'left', 'right', 'bottom', 'top'} or list
@@ -187,7 +190,7 @@ def theme(*,
         Margin around each legend.
         The margin may be specified using a number or a list of numbers:
 
-        - a number or list of one number - the same margin it applied to all four sides;
+        - a number or list of one number - the same margin is applied to all four sides;
         - a list of two numbers - the first margin applies to the top and bottom, the second - to the left and right;
         - a list of three numbers - the first margin applies to the top, the second - to the right and left, the third - to the bottom;
         - a list of four numbers - the margins are applied to the top, right, bottom and left in that order.
@@ -200,7 +203,7 @@ def theme(*,
     legend_spacing_y : float
         Spacing between legends in the vertical direction, inherited from `legend_spacing`.
     legend_key : str or dict
-        Background underneath legend keys.
+        Style settings for legend key background.
         Set 'blank' or result of `element_blank()` to draw nothing.
         Set `element_rect()` to specify legend key background parameters, inherited from `rect`.
     legend_key_size : float
@@ -222,7 +225,7 @@ def theme(*,
     legend_box_spacing : float
         Spacing between plotting area and legend box.
     legend_ticks : str or dict
-        Tick marks in colorbars.
+        Style settings for tick marks in colorbars.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_line()` to specify all tick mark parameters.
         `legend_ticks_*` DOES NOT inherit from `line`.
@@ -230,58 +233,58 @@ def theme(*,
     legend_ticks_length : float
         Length of colorbar tick marks in px.
     panel_background : str or dict
-        Background of plotting area.
+        Style settings for background of plotting area.
         Set 'blank' or result of `element_blank()` to draw nothing.
         Set `element_rect()` to specify plotting area background parameters, inherited from `rect`.
     panel_border : str or dict
-        Border around plotting area.
+        Style settings for border around plotting area.
         Set 'blank' or result of `element_blank()` to draw nothing.
         Set `element_rect()` to specify border parameters, inherited from `rect`.
     panel_border_ontop : bool, default=True
         Option to place border around plotting area over the data layers.
     panel_grid, panel_grid_major, panel_grid_minor, panel_grid_major_x, panel_grid_major_y, panel_grid_minor_x, panel_grid_minor_y : str or dict
-        Grid lines. Specify major grid lines or minor grid lines separately if needed.
+        Style settings for grid lines. Specify major grid lines or minor grid lines separately if needed.
         Set 'blank' or result of `element_blank()` to draw nothing.
         Set `element_line()` to specify grid line parameters.
         `panel_grid_*_*` inherits from `panel_grid_*` which inherits from `panel_grid`,
         which in turn inherits from `line`.
     panel_inset : number or list of numbers
-        Inset for a panel. The inset behaves like a padding for `coord_polar(transofrm_bkgr=False)` otherwise it behaves like a margin around the panel.
+        Inset for a panel. The inset behaves like a padding for `coord_polar(transform_bkgr=False)` otherwise it behaves like a margin around the panel.
         The inset may be specified using a number or a list of numbers:
 
-        - a number or list of one number - the same inset it applied to all four sides;
+        - a number or list of one number - the same inset is applied to all four sides;
         - a list of two numbers - the first inset applies to the top and bottom, the second - to the left and right;
         - a list of three numbers - the first inset applies to the top, the second - to the right and left, the third - to the bottom;
         - a list of four numbers - the insets are applied to the top, right, bottom and left in that order.
 
-        It is acceptable to use None for any side; in this case, the default value for the plot inset side will be used.
+        It is acceptable to use None for any side; in this case, the default value for the panel inset side will be used.
     panel_grid_ontop, panel_grid_ontop_x, panel_grid_ontop_y : bool, default=False
         Option to place major grid lines and minor grid lines over the data layers.
     plot_background : str or dict
-        Background of the entire plot.
+        Style settings for overall plot background.
         Set 'blank' or result of `element_blank()` to draw nothing.
         Set `element_rect()` to specify plot background parameters, inherited from `rect`.
     plot_title : str or dict
-        Plot title.
+        Style settings for plot title.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_text()` to specify plot title parameters, inherited from `title`.
     plot_subtitle : str or dict
-        Plot subtitle.
+        Style settings for plot subtitle.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_text()` to specify plot subtitle parameters, inherited from `plot_title` or `title`.
     plot_caption : str or dict
-        Plot caption.
+        Style settings for plot caption.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_text()` to specify plot caption parameters, inherited from `title`.
     plot_message : str or dict
-        Plot message (e.g. sampling messages).
+        Style settings for plot message (e.g. sampling messages).
         Set 'blank' or result of `element_blank()` to show nothing.
         Set `element_text()` to show sampling messages (`element_text()` options don't affect a message text).
     plot_margin : number or list of numbers
         Margin around entire plot.
         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 number or list of one number - the same margin is applied to all four sides;
         - a list of two numbers - the first margin applies to the top and bottom, the second - to the left and right;
         - a list of three numbers - the first margin applies to the top, the second - to the right and left, the third - to the bottom;
         - a list of four numbers - the margins are applied to the top, right, bottom and left in that order.
@@ -291,7 +294,7 @@ def theme(*,
         Inset for a plotting area, including the axes with their labels, but without titles.
         The inset may be specified using a number or a list of numbers:
 
-        - a number or list of one number - the same inset it applied to all four sides;
+        - a number or list of one number - the same inset is applied to all four sides;
         - a list of two numbers - the first inset applies to the top and bottom, the second - to the left and right;
         - a list of three numbers - the first inset applies to the top, the second - to the right and left, the third - to the bottom;
         - a list of four numbers - the insets are applied to the top, right, bottom and left in that order.
@@ -306,55 +309,55 @@ def theme(*,
         A value of 'panel' means that caption is aligned to the plot panels.
         A value of 'plot' means that caption is aligned to the entire plot (excluding margins).
     strip_background : str or dict
-        Background of facet labels.
+        Style settings for facet strip background.
         Set 'blank' or result of `element_blank()` to draw nothing.
         Set `element_rect()` to specify facet label background parameters, inherited from `rect`.
     strip_background_x : str or dict
-        Horizontal facet background.
+        Style settings for horizontal facet background.
         Set 'blank' or result of `element_blank()` to draw nothing.
         Set `element_rect()` to specify facet label background parameters, inherited from `strip_background`.
     strip_background_y : str or dict
-        Vertical facet background.
+        Style settings for vertical facet background.
         Set 'blank' or result of `element_blank()` to draw nothing.
         Set `element_rect()` to specify facet label background parameters, inherited from `strip_background`.
     strip_text : str or dict
-        Facet labels.
+        Style settings for facet labels.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_text()` to specify facet label parameters, inherited from `text`.
     strip_text_x : str or dict
-        Horizontal facet labels.
+        Style settings for horizontal facet labels.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_text()` to specify facet label parameters, inherited from `strip_text`.
     strip_text_y : str or dict
-        Vertical facet labels.
+        Style settings for vertical facet labels.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_text()` to specify facet label parameters, inherited from `strip_text`.
     axis_tooltip, axis_tooltip_x, axis_tooltip_y : str or dict
-        Axes tooltips.
+        Style settings for axes tooltips.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_rect()` to specify axes tooltip parameters.
         `axis_tooltip_*` inherits from `axis_tooltip` which inherits from `rect`.
     axis_tooltip_text, axis_tooltip_text_x, axis_tooltip_text_y : str or dict
-        Text in axes tooltips.
+        Style settings for text in axes tooltips.
         Set 'blank' or result of `element_blank()` to draw nothing and assign no space.
         Set `element_text()` to specify axes text tooltip parameters.
         `axis_tooltip_text_*` inherits from `axis_tooltip_text` which inherits from `tooltip_text`.
     tooltip : str or dict
-        General tooltip.
+        Style settings for general tooltip.
         Set 'blank' or result of `element_blank()` to hide the tooltip (also hides side tooltips).
         Set `element_rect()` to specify tooltip rectangular parameters, inherited from `rect`.
-    tooltip_text : str or dict
-        Text in general tooltip.
+    tooltip_text : dict
+        Style settings for text in general tooltip.
         Set `element_text()` to specify tooltip text parameters.
-    tooltip_title_text : str or dict
-        Tooltip title text.
+    tooltip_title_text : dict
+        Style settings for tooltip title text.
         Set `element_text()` to specify tooltip title parameters, inherited from `tooltip_text`. Bold by default.
-    label_text : str or dict
-        Annotation text.
-        Annotations are currently supported for pie and bar charts.
+    label_text : dict
+        Style settings for annotation text.
+        Annotations are currently supported for pie, bar chart and crossbar.
         Set `element_text()` to specify annotation text parameters: font family and face, text size, text color.
     geom : dict
-        Geometry colors.
+        Color settings for geometries.
         Set `element_geom()` to specify new values for the named colors.
 
     Returns
@@ -573,7 +576,7 @@ def element_text(
 ) -> dict:
     """
     Specify how non-data components of the plot are drawn.
-    This theme element draws texts.
+    This theme element draws text.
 
     Parameters
     ----------
@@ -592,18 +595,18 @@ def element_text(
         0 - left-justified;
         1 - right-justified;
         0.5 - center-justified.
-        Can be used with values out of range, but behaviour is not specified.
+        Values outside the [0, 1] range are allowed but may produce unpredictable results.
     vjust : float
         Vertical justification (in [0, 1]).
         0 - bottom-justified;
         1 - top-justified;
         0.5 - middle-justified.
-        Can be used with values out of range, but behaviour is not specified.
+        Values outside the [0, 1] range are allowed but may produce unpredictable results.
     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 number or list of one number - the same margin is applied to all four sides;
         - a list of two numbers - the first margin applies to the top and bottom, the second - to the left and right;
         - a list of three numbers - the first margin applies to the top, the second - to the right and left, the third - to the bottom;
         - a list of four numbers - the margins are applied to the top, right, bottom and left in that order.
@@ -629,7 +632,7 @@ def element_text(
         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]))
+            theme(axis_text=element_text(color='#cb181d', face='bold_italic'))
 
     """
     return locals()
@@ -649,7 +652,7 @@ def element_markdown(
 ) -> dict:
     """
     Specify how non-data components of the plot are drawn.
-    This theme element draws texts with Markdown support.
+    This theme element draws text with Markdown support.
 
     Parameters
     ----------
@@ -679,7 +682,7 @@ def element_markdown(
         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 number or list of one number - the same margin is applied to all four sides;
         - a list of two numbers - the first margin applies to the top and bottom, the second - to the left and right;
         - a list of three numbers -  the first margin applies to the top, the second - to the right and left, the third - to the bottom;
         - a list of four numbers - the margins are applied to the top, right, bottom and left in that order.
@@ -735,7 +738,7 @@ def element_geom(
         # ToDo: fatten
 ) -> dict:
     """
-    Specify new values for the named colors.
+    Specify custom values for named geom colors used in plot elements.
 
     Parameters
     ----------

lets_plot/plot/util.py

@@ -7,8 +7,8 @@ from typing import Any, Tuple, Sequence, Optional, Dict, List
 from lets_plot._type_utils import is_pandas_data_frame
 from lets_plot.geo_data_internals.utils import find_geo_names
 from lets_plot.mapping import MappingMeta
-from lets_plot.plot.core import aes, FeatureSpec
-from lets_plot.plot.series_meta import infer_type, TYPE_UNKNOWN
+from lets_plot.plot.core import aes, FeatureSpec, PlotSpec
+from lets_plot.plot.series_meta import _infer_type, TYPE_UNKNOWN, TYPE_DATE_TIME, _detect_time_zone
 
 
 def as_boolean(val, *, default):
@@ -18,6 +18,21 @@ def as_boolean(val, *, default):
     return bool(val) and val != 'False'
 
 
+def update_plot_aes_mapping(plot: PlotSpec, add_mapping: FeatureSpec):
+    existing_spec = plot.props().get('mapping', aes())
+    merged_mapping = {**existing_spec.as_dict(), **add_mapping.as_dict()}
+
+    # Re-annotate the data with the merged mapping.
+    data = plot.props().get('data', None)
+    data, processed_mapping, data_meta = as_annotated_data(data, aes(**merged_mapping))
+    plot.props()['data'] = data
+    plot.props()['mapping'] = processed_mapping
+
+    # Add data_meta to plot properties
+    for key, value in data_meta.items():
+        plot.props()[key] = value
+
+
 def as_annotated_data(data: Any, mapping_spec: FeatureSpec) -> Tuple:
     data_type_by_var: Dict[str, str] = {}  # VarName to Type
     mapping_meta_by_var: Dict[str, Dict[str, MappingMeta]] = {}  # VarName to Dict[Aes, MappingMeta]
@@ -26,10 +41,10 @@ def as_annotated_data(data: Any, mapping_spec: FeatureSpec) -> Tuple:
     # fill mapping_meta_by_var, mappings and data_type_by_var.
     if mapping_spec is not None:
         for key, spec in mapping_spec.props().items():
-            # key is either an aesthetic name or 'name' (FeatureSpec.name property)
+            # the key is either an aesthetic name or 'name' (FeatureSpec.name property)
             if key == 'name':  # ignore FeatureSpec.name property
                 continue
-                
+
             if isinstance(spec, MappingMeta):
                 mappings[key] = spec.variable
                 mapping_meta_by_var.setdefault(spec.variable, {})[key] = spec
@@ -37,7 +52,15 @@ def as_annotated_data(data: Any, mapping_spec: FeatureSpec) -> Tuple:
             else:
                 mappings[key] = spec  # spec is a variable name
 
-    data_type_by_var.update(infer_type(data))
+    data_type_by_var.update(_infer_type(data))
+
+    # Detect the tome zone - one for the entire data set.
+    time_zone_by_var_name = {}
+    for var_name, data_type in data_type_by_var.items():
+        if data_type == TYPE_DATE_TIME:
+            time_zone = _detect_time_zone(var_name, data)
+            if time_zone is not None:
+                time_zone_by_var_name[var_name] = time_zone
 
     # fill series annotations
     series_annotations = {}  # var to series_annotation
@@ -47,6 +70,9 @@ def as_annotated_data(data: Any, mapping_spec: FeatureSpec) -> Tuple:
         if data_type != TYPE_UNKNOWN:
             series_annotation['type'] = data_type
 
+        if var_name in time_zone_by_var_name:
+            series_annotation['time_zone'] = time_zone_by_var_name[var_name]
+
         if is_pandas_data_frame(data) and data[var_name].dtype.name == 'category' and data[var_name].dtype.ordered:
             series_annotation['factor_levels'] = data[var_name].cat.categories.to_list()
         elif var_name in mapping_meta_by_var:

{lets_plot-4.6.2.dist-info → lets_plot-4.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lets-plot
-Version: 4.6.2
+Version: 4.7.0
 Summary: An open source library for statistical plotting
 Home-page: https://lets-plot.org
 Author: JetBrains
@@ -11,9 +11,7 @@ License: MIT
 Project-URL: Github, https://github.com/JetBrains/lets-plot
 Project-URL: Documentation, https://lets-plot.org
 Keywords: ggplot,ggplot2,geospatial,geopandas,geocoding
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Development Status :: 5 - Production/Stable
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -30,8 +28,13 @@ Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: Developers
 Description-Content-Type: text/markdown
 License-File: LICENSE
+License-File: licenses/LICENSE.FreeType
+License-File: licenses/LICENSE.ImageMagick
+License-File: licenses/LICENSE.expat
+License-File: licenses/LICENSE.fontconfig
 Requires-Dist: pypng
 Requires-Dist: palettable
+Requires-Dist: pillow
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -103,38 +106,63 @@ 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.6.0
+## What is new in 4.7.0
 
-- #### 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">
+- #### Time Series Plotting
+  - Support for Python `time` and `date` objects.
+  - Support for timezone-aware `datetime` objects and Pandas/Polars `Series`.
+
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25b/images/time_date_datetime.png" alt="f-25b/images/time_date_datetime.png" width="400" height="237">
   
-  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/markdown.ipynb).
+  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25b/time_date_datetime.ipynb).
+
+- #### Native support for PNG and PDF exports
+  Exporting to PNG and PDF formats now uses the `ImageMagick` library bundled with Lets-Plot Python wheels and available out-of-the-box. <br>
+  This replaces the previous dependency on the `CairoSVG` library and comes with improved support for LaTeX labels rasterization. <br>
+
+- #### `geom_sina()` Geometry
+
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25b/images/geom_sina.png" alt="f-25b/images/geom_sina.png" width="400" height="276">
+
+  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25b/geom_sina.ipynb).
+
+- #### `geom_text_repel()` and `geom_label_repel()` Geometries
+
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25b/images/geom_repel.png" alt="f-25b/images/geom_repel.png" width="400" height="232">
+
+  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25b/ggrepel.ipynb).
+
+- #### `waterfall_plot()` Chart
+
+  - Annotations support via `relative_labels` and `absolute_labels` parameters. <br>
+    <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25b/images/waterfall_plot_annotations.png" alt="f-25b/images/waterfall_plot_annotations.png" width="400" height="253">
 
-- #### 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-25b/waterfall_plot_annotations.ipynb).
+                                   
+  - Support for combining waterfall bars with other geometry layers. <br>
+    <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25b/images/waterfall_plot_layers.png" alt="f-25b/images/waterfall_plot_layers.png" width="400" height="227">
 
-  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),
+    See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25b/waterfall_plot_layers.ipynb).
 
-- #### `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">
+- #### Continuous Data on Discrete Scales
 
-  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/geom_hex.ipynb).
+  Continuous data when used with discrete positional scales is no longer transformed to discrete data. <br>
+  Instead, it remains continuous, allowing for precise positioning of continuous elements relative to discrete ones. <br>
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25b/images/combo_discrete_continuous.png" alt="f-25b/images/combo_discrete_continuous.png" width="400" height="151">
 
-- #### `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-25a/ggbunch_indonesia.ipynb).
+  See: [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25b/numeric_data_on_discrete_scale.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="400" height="251">
+> [!TIP]
+> New way of handling continuous data on discrete scales could potentially break existing plots.
+> If you want to restore a broken plot to its original form, you can use the [`as_discrete()`](https://lets-plot.org/python/pages/api/lets_plot.mapping.as_discrete.html) function to annotate continuous data as discrete.
 
-  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/magnifier_inset.ipynb).
 
-- #### 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">
+- #### Plot Layout
+  The default plot layout has been improved to better accommodate axis labels and titles. <br>
+  Also, new `theme()` options `axis_text_spacing`, `axis_text_spacing_x`, and `axis_text_spacing_y` control spacing between axis ticks and labels. <br>
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-25b/images/plot_layout_diagram.png" alt="f-25b/images/plot_layout_diagram.png" width="400" height="175">
 
-  See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/geom_pie_params.ipynb).
+  See the [plot layout diagram](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25b/plot_layout_scheme.ipynb) showing various layout options and their effects on plot appearance.
 
 
 - #### And More

{lets_plot-4.6.2.dist-info → lets_plot-4.7.0.dist-info}/RECORD

@@ -1,22 +1,22 @@
-lets_plot_kotlin_bridge.cpython-311-darwin.so,sha256=3swNma7UhtQQ-RtxhWigF1GtL0NO5asV2Ap-Cr7wqoI,9540304
+lets_plot_kotlin_bridge.cpython-311-darwin.so,sha256=qYW8F6Gm524Kyyy9BMGIPwCGuZJKG_OKSdmoT8sprjg,17219152
 lets_plot/__init__.py,sha256=JBXXtPi4nwhU9jrsUXcQTP1iaGF0jbHBVk_66pohq9I,11224
-lets_plot/_global_settings.py,sha256=4P9UL6xWEARJuxyvXBQUxt1NE_YDrU_ElF34pr72VhA,7440
-lets_plot/_kbridge.py,sha256=u5bBe6sTDbNgoAk3HmtkhQXxCYofjSSin-J-yHz0pfY,4675
-lets_plot/_type_utils.py,sha256=2GZ4GrJHe7rk_DPSHj88nBW8R9xxx7IGbgGQwhQclOg,2919
-lets_plot/_version.py,sha256=69RsyAckyHWeKA9dimVXADg43i1UW7dKe9mUXEJGEaE,233
+lets_plot/_global_settings.py,sha256=TDxQp44IWvAUDWXnNQKIumAfrGEBHHg6OMuQNbiodA0,7778
+lets_plot/_kbridge.py,sha256=as2-FrQEQs5JUEyFq7_wGJY9hhctN3FXso8a1SGbwDE,5048
+lets_plot/_type_utils.py,sha256=mlNG1J0Lgt7n0gERJZFkdhP6B3C7iZD5WRMB0yS6-r0,3828
+lets_plot/_version.py,sha256=GFXgama76znVGQCLosg5P9HjsYxEGStHpFFyea7qOPw,233
 lets_plot/mapping.py,sha256=q-O14pcnAosRIWcgg9-CkXMF43p5H7cKbyT4ne9w6hY,3576
 lets_plot/settings_utils.py,sha256=PrceNltN0JNzYxkIx0hwGgzX9dNxgVNqZY5hQ-r8QMQ,8434
 lets_plot/tilesets.py,sha256=gN7gfn4qnXZj699LyxpDWwEuWwNmAJr2ZQ7VJX7rzoU,10382
 lets_plot/bistro/__init__.py,sha256=4Vix3Qu2P4zqGiDx8gnTd3usCLQQGBRKhseSNjrsBUY,426
 lets_plot/bistro/_plot2d_common.py,sha256=NuRH-tJ-PKtC4X69hvtGu9Zhn0IvsGviDeHoy3JuXSQ,3883
 lets_plot/bistro/corr.py,sha256=nfxVWcS1UOfIMXWuE69-2ya0Omxi5jhIcRp3pSTxHZA,12892
-lets_plot/bistro/im.py,sha256=vwJuPzeyWe1J1KRPxGIjvdQKwZD4QSn9hcfPQ5RzXs4,6379
+lets_plot/bistro/im.py,sha256=46OPkYKvvXlsx5d1LxcxPqApXh-ns-J2p1YN8WIb_tw,6445
 lets_plot/bistro/joint.py,sha256=BIAII_eYGyHJ43kk7BABqRDhUMIIpLNafMN-0YDrl_w,6571
 lets_plot/bistro/qq.py,sha256=4AMBjbtcwE4mQNmZSglGt1w8MnvhNqg7CZEVNb9fUr4,8098
 lets_plot/bistro/residual.py,sha256=el9B_nd4vT53hIXvgVtqbMr5QvjxLZwzH4UbCGxlxbM,12332
-lets_plot/bistro/waterfall.py,sha256=5iPADC8T6zUbjum5DKS4QihifdqTFaE8WOok5ULO0gU,10474
+lets_plot/bistro/waterfall.py,sha256=XXo3onoxfzD2OODwftqfJ0sb5NuL1Q8lqqQbb-UA4-E,14267
 lets_plot/export/__init__.py,sha256=lDs6fqtQjkgJyKqeYlOdhrHMN__TeggTz73hgHAkyzc,188
-lets_plot/export/ggsave_.py,sha256=qUw9Dw_-MTFgOy2qVd60pTtxO_JnW_kedMT1C_39C_g,4558
+lets_plot/export/ggsave_.py,sha256=Vt0Ai-ccGDg-IjPtHCQJCKL5lMHSk-38MNJcrBdkT50,5020
 lets_plot/frontend_context/__init__.py,sha256=nqIogfMulwKRY2l_v3Rn7tXMQ1btasX9f7dwfrVaj_A,204
 lets_plot/frontend_context/_configuration.py,sha256=Xxbbm1rP7ZaH2HIPf4LrCby4Z-LI-CKlEUxzWX7fQF0,5567
 lets_plot/frontend_context/_frontend_ctx.py,sha256=073vxq0laO6ubol3kJK6aBbWo9Fr2_olbQEZUbr_QFc,359
@@ -47,19 +47,19 @@ lets_plot/geo_data/gis/response.py,sha256=7Ac2VN4Hl9iffm7wAyfL80Wzo7sG9A1F5BqzJU
 lets_plot/geo_data_internals/__init__.py,sha256=4R6hr7MVB9iRi9JNQm_UUQL9jCe_dYDtizw_230V2Yg,234
 lets_plot/geo_data_internals/constants.py,sha256=IDpHhOOg7dbfIKqLNSk3AGa-5HjDcnItFZDxCm4fylw,428
 lets_plot/geo_data_internals/utils.py,sha256=phV_Q84xz4uZH2jI9WLUrYDyZAz0d2-00OOLxkRH4iw,967
-lets_plot/package_data/lets-plot.min.js,sha256=HEtstIsBt4qAtwh3CG3psJEl3xK6sYgvhAXaQqm5p0c,2321076
+lets_plot/package_data/lets-plot.min.js,sha256=aQQWmb9UwVgnjqy8qPKU9ZQRyM3BOhJzB7J67OkPoLk,2759344
 lets_plot/plot/__init__.py,sha256=RNsQuVS8qe4Xf4so7PJiQJKdYYnDMIqydUQNzstqhZI,1771
 lets_plot/plot/_global_theme.py,sha256=hOV9MzYpfjdF6hDE3mfLv_LqFtaouCJcccoW8pGoFoU,297
-lets_plot/plot/annotation.py,sha256=ZBQ9ZTxOVT-ePVTUocPTQnM92loiVP0jgWw8XM9Cfmo,7660
+lets_plot/plot/annotation.py,sha256=6bOJunvFRo99jAIFo6d5KEfZ0ILKB2vi1naG8nntynE,9839
 lets_plot/plot/coord.py,sha256=h9ZTNmSbRjIdVTL_TTl9Dn5AsY46tYxuAKddUPjwe8s,7976
-lets_plot/plot/core.py,sha256=I3H-btDBoAoPeLxY2v4mVbrrTwvu6MBFGXcFYPTUSKk,31542
+lets_plot/plot/core.py,sha256=hh4QshpyFt17im002cZZAVqOCJQHLQ5xPWq9Zce2peA,36374
 lets_plot/plot/expand_limits_.py,sha256=UJzBbNNrdSG7osANmchQ-Jcg27DuSzFXGu27-WxiPSI,2307
 lets_plot/plot/facet.py,sha256=1vDo1xk0G95x2SSf6HNWfeEgXS-FDxtpd18fo63_6gI,7030
 lets_plot/plot/font_features.py,sha256=vUc_ICerwqnwwJbDaAm_fS8fmbRTZHzPoAHRszw0SF4,2238
-lets_plot/plot/geom.py,sha256=UtQz8WPStQaG51M0qu3toss2OgUw7w8TAjnoU9UFvf4,354624
+lets_plot/plot/geom.py,sha256=V-Rk0qRdAcXVQKPhVk_PN4VCjtNuTtxT3V_w2RmoH4E,387600
 lets_plot/plot/geom_extras.py,sha256=I_ERjnZlk5VyilJELx0sA_4C2a_Ycjc2Thas-I6WZoo,1694
-lets_plot/plot/geom_function_.py,sha256=bMGr73qaEW3HnxlWADvHyt_nYn9HJGZzBqYiHx4yIHY,7871
-lets_plot/plot/geom_imshow_.py,sha256=LWlNVriYK26HZGUjdkbiB4YaoTlVQxUyaNUPY46RVqw,14759
+lets_plot/plot/geom_function_.py,sha256=J8gx5U7zjlE9aYJTUsy8hr9dQ4ibZ9X7KMNvIVmQwqM,7861
+lets_plot/plot/geom_imshow_.py,sha256=I7l2rm0QzATN8a4Lt5mJC4G3YsvbJA4OiBjl2JlZ6kw,14439
 lets_plot/plot/geom_livemap_.py,sha256=LfuxJ2BHK9AeN6-z8YEnp24HYSguSu0jdJlKCIxjKTA,12201
 lets_plot/plot/ggbunch_.py,sha256=kRAZGcDDe33SrU9kH_XVJqJBTfW3ho3VXm3ZchUzPO4,3091
 lets_plot/plot/gggrid_.py,sha256=6M7YRxcrpftAardpKTMbkIeN0V7CB9FvFLdlSAKhZMA,3893
@@ -68,24 +68,28 @@ lets_plot/plot/guide.py,sha256=C-mDgjXKwQz_Pv6OB1rcQohAIUAl0QvoApPsAR5lbs4,6694
 lets_plot/plot/label.py,sha256=iXTTLP-AjFtHRnti8v4mZMnGLRNLhsxhvetoQPhi8H0,4549
 lets_plot/plot/marginal_layer.py,sha256=Y4FMmQZlUuLxzjjntVQThuV8scG6LbEmDGjstGMOls4,6357
 lets_plot/plot/plot.py,sha256=t7zXnu6tiqhwvthO4C7CfaYv2gH_zPzQ8ias9cK3m3Y,8282
-lets_plot/plot/pos.py,sha256=BRrgTYH_Qn9R1a4syDSeDHoce0UPZr4cluyZKk8NVWo,10738
+lets_plot/plot/pos.py,sha256=2ZPUdwAEK2_MQBbFch7kSFJqnPqQTl-JbKQGOuKrYAg,10063
 lets_plot/plot/sampling.py,sha256=qy0aesxFgpx-cO0-dC1Wv9r4oSbtz7hRPC9YsNk9Pyo,8489
 lets_plot/plot/sandbox_.py,sha256=Tb5UwJqe8HMMSCbDLdrj_BcxPSkmyxy-hI0_2L6kpBk,545
 lets_plot/plot/scale.py,sha256=d_cTAnRdTHwSPnUp7mmCTjM6PDOKmr9FMESGu3DQOzk,136949
 lets_plot/plot/scale_colormap_mpl.py,sha256=D5iWNaWGWpVFCJiNDwf-wHa8Snbd1YiWp6yktOkUl_A,10267
 lets_plot/plot/scale_convenience.py,sha256=VWe9BJhFlUbWL2CLrOrxPy523dGIKIOL7A2H7OPx8_0,4116
 lets_plot/plot/scale_identity_.py,sha256=qHo_CI7Xb9Olqza_MqvEV672AaaXM9gWac20SX4AGc4,23796
-lets_plot/plot/scale_position.py,sha256=J8pFmYX2YorK6JhDKtgpFCMS5JhvKSzuASEwQCc6IgA,46285
-lets_plot/plot/series_meta.py,sha256=0aleiIjUKG5nhqrkPwUpWELedz79JgRjq8zwcnevUiA,5780
-lets_plot/plot/stat.py,sha256=XuZvGxt801db37yM6MsiLb8L5f6BN2L0wfP-QjBDjcc,22933
-lets_plot/plot/subplots.py,sha256=l3lbbxhCwgib1sIUYx-POpJXT8HbhMk9OeIh3zo8kEM,11333
+lets_plot/plot/scale_position.py,sha256=3k8pe_opLrjC5fM3c_Yrjhzc5qPI5APvUoNVFYsqKy0,46972
+lets_plot/plot/series_meta.py,sha256=ar_97wY5_dM5vjaXpGKHwPMuNhktzwTlxMKkSM9R4O4,6852
+lets_plot/plot/stat.py,sha256=rXYtkOzsNQi51zPv3NaKZDdk5LPGLN2SjkCVeoewlZk,22893
+lets_plot/plot/subplots.py,sha256=v9zzddkG0mMtpNAYWb-shf3kv5deNE8zH5KvYeRsC6I,11331
 lets_plot/plot/subplots_util.py,sha256=T04pwI7LaYliUqEdRHog1SGExVt9XosQk6XDwqOg7q0,913
-lets_plot/plot/theme_.py,sha256=zQmlXuU7Y0dJa3ZlQFwNJNpsoWe0Eyvf-EErzw1BQuQ,31674
+lets_plot/plot/theme_.py,sha256=s4zdHoTo9Zo8kWsh5ECWyXTR18CCcAuxK0u5NhSiTe4,32550
 lets_plot/plot/theme_set.py,sha256=USNU-ccPKlZ4KEC1ij92n-SHY5271Ru_c1CQIIWXonI,9103
 lets_plot/plot/tooltip.py,sha256=AvRjT5UPop5wVORFHnaVeBhAIHTYbIjf0FXXUTB4Qvg,15983
-lets_plot/plot/util.py,sha256=778yCTbEOvFRNueMyEPhRkJtPEwzh3Lo0LQO0FtoM0U,8586
-lets_plot-4.6.2.dist-info/licenses/LICENSE,sha256=r43VKLFaMylB4Ru-pE07j0cfUO7wQpMnWm-uZ8hEqMw,1066
-lets_plot-4.6.2.dist-info/METADATA,sha256=2izNUgG73jSEDhpTUoXSnMoOV2PAtusmfbbPKmhOQ-Y,11440
-lets_plot-4.6.2.dist-info/WHEEL,sha256=Xj8rcS70kI3WNyj68KMW0GqC-OwQXhrSLbEcAxgv044,109
-lets_plot-4.6.2.dist-info/top_level.txt,sha256=ID-ORXUWN-oVZmD4YFy1rQVm2QT1D-MlGON3vdxqgpY,34
-lets_plot-4.6.2.dist-info/RECORD,,
+lets_plot/plot/util.py,sha256=CSv-koubJBEcsVM2XOcB5ooBqBNgqQffxdJs2aK0FHI,9668
+lets_plot-4.7.0.dist-info/licenses/LICENSE,sha256=r43VKLFaMylB4Ru-pE07j0cfUO7wQpMnWm-uZ8hEqMw,1066
+lets_plot-4.7.0.dist-info/licenses/licenses/LICENSE.FreeType,sha256=7YOXABSJgU7bZvuf8s6ySO493IEQ2hotc3nsCvHx3us,6718
+lets_plot-4.7.0.dist-info/licenses/licenses/LICENSE.ImageMagick,sha256=pVbFKSyHyaaseVyAZpsMNmD59ynejEdr8rEPg6sbNOw,12577
+lets_plot-4.7.0.dist-info/licenses/licenses/LICENSE.expat,sha256=MbFd6CqhmoRRVhaaF6VIi_WX5WGywxjRWe1YMTmyXoc,1144
+lets_plot-4.7.0.dist-info/licenses/licenses/LICENSE.fontconfig,sha256=UaUaqYI3BP2QvMxhbN0X66u1srPpy96IbKAscAIogGc,8616
+lets_plot-4.7.0.dist-info/METADATA,sha256=3cE5ZLxJJu1EeA_smWOvlD1cR1iQ0SU7cNayRnaobZc,13147
+lets_plot-4.7.0.dist-info/WHEEL,sha256=qxQkdhERtGxJzqnVOBnucx1aUmU2n3HmuzYdln_LyOw,109
+lets_plot-4.7.0.dist-info/top_level.txt,sha256=ID-ORXUWN-oVZmD4YFy1rQVm2QT1D-MlGON3vdxqgpY,34
+lets_plot-4.7.0.dist-info/RECORD,,

{lets_plot-4.6.2.dist-info → lets_plot-4.7.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (78.1.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: false
 Tag: cp311-cp311-macosx_11_0_arm64