lets-plot 4.6.0a2__cp312-cp312-macosx_11_0_arm64.whl → 4.6.1__cp312-cp312-macosx_11_0_arm64.whl

lets_plot/plot/theme_.py

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

{lets_plot-4.6.0a2.dist-info → lets_plot-4.6.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: lets-plot
-Version: 4.6.0a2
+Version: 4.6.1
 Summary: An open source library for statistical plotting
 Home-page: https://lets-plot.org
 Author: JetBrains
@@ -102,45 +102,34 @@ 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.     
-
-- #### 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">
-
-  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/ggbunch_indonesia.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

{lets_plot-4.6.0a2.dist-info → lets_plot-4.6.1.dist-info}/RECORD

@@ -1,9 +1,9 @@
-lets_plot_kotlin_bridge.cpython-312-darwin.so,sha256=jZIFDwhxUDE_6RZg-d6xzIkfgXa8FvMQ8jPGcIUGFn4,9421792
+lets_plot_kotlin_bridge.cpython-312-darwin.so,sha256=Z8VFPR5FV3V6ZoiasADwol-Ti6KosSH3Axl0qH-4ZdY,9540272
 lets_plot/__init__.py,sha256=JBXXtPi4nwhU9jrsUXcQTP1iaGF0jbHBVk_66pohq9I,11224
 lets_plot/_global_settings.py,sha256=4P9UL6xWEARJuxyvXBQUxt1NE_YDrU_ElF34pr72VhA,7440
-lets_plot/_kbridge.py,sha256=c5WraZIVSbkTdkaL1nH5T3YsxMk8GGzx_UoKGIO6Qgw,3520
+lets_plot/_kbridge.py,sha256=u5bBe6sTDbNgoAk3HmtkhQXxCYofjSSin-J-yHz0pfY,4675
 lets_plot/_type_utils.py,sha256=2GZ4GrJHe7rk_DPSHj88nBW8R9xxx7IGbgGQwhQclOg,2919
-lets_plot/_version.py,sha256=rmD4JqP-SlpUQyW_PbAPrMYIfXQjRnGxlytOEgaAbH0,239
+lets_plot/_version.py,sha256=VvHV3uIbm4nvaSLO3VKZJlSbOIQacEVQIRlxpP3vYHA,233
 lets_plot/mapping.py,sha256=q-O14pcnAosRIWcgg9-CkXMF43p5H7cKbyT4ne9w6hY,3576
 lets_plot/settings_utils.py,sha256=PrceNltN0JNzYxkIx0hwGgzX9dNxgVNqZY5hQ-r8QMQ,8434
 lets_plot/tilesets.py,sha256=6Hqz-m-rFCq2XbMHtRJ0Zq3GTrnV-GCIhlFMT1opevs,9186
@@ -47,7 +47,7 @@ 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=9GVPVwviWOobhr8O-cl2SELRLBCwAi_GJaii7ZIdEZI,2295723
+lets_plot/package_data/lets-plot.min.js,sha256=VYHOe3GfimcWAh4QUez7m0cowJO9fBzO1IF25cFN5S8,2321322
 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
@@ -56,7 +56,7 @@ lets_plot/plot/core.py,sha256=I3H-btDBoAoPeLxY2v4mVbrrTwvu6MBFGXcFYPTUSKk,31542
 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=tTU4V-VX1db7tj1aTYNBV8HdiEKt9R83YmF_jOg2_oY,349057
+lets_plot/plot/geom.py,sha256=UtQz8WPStQaG51M0qu3toss2OgUw7w8TAjnoU9UFvf4,354624
 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
@@ -68,10 +68,10 @@ 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=FIVYTElPSU5P8ZjI0FyweO2j1Cgb62dvJ172xXtxUp8,10359
+lets_plot/plot/pos.py,sha256=BRrgTYH_Qn9R1a4syDSeDHoce0UPZr4cluyZKk8NVWo,10738
 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=Y3JYxPUKLcxiWCnLHeleXSi-63NNAh5bmgKTi1tkZwA,136939
+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
@@ -80,12 +80,12 @@ lets_plot/plot/series_meta.py,sha256=0aleiIjUKG5nhqrkPwUpWELedz79JgRjq8zwcnevUiA
 lets_plot/plot/stat.py,sha256=XuZvGxt801db37yM6MsiLb8L5f6BN2L0wfP-QjBDjcc,22933
 lets_plot/plot/subplots.py,sha256=l3lbbxhCwgib1sIUYx-POpJXT8HbhMk9OeIh3zo8kEM,11333
 lets_plot/plot/subplots_util.py,sha256=T04pwI7LaYliUqEdRHog1SGExVt9XosQk6XDwqOg7q0,913
-lets_plot/plot/theme_.py,sha256=nOUOPRDtUtbzl5lRiDnhLbWkNd2KKGkk4GsoKpQwX9E,28677
+lets_plot/plot/theme_.py,sha256=zQmlXuU7Y0dJa3ZlQFwNJNpsoWe0Eyvf-EErzw1BQuQ,31674
 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.0a2.dist-info/LICENSE,sha256=r43VKLFaMylB4Ru-pE07j0cfUO7wQpMnWm-uZ8hEqMw,1066
-lets_plot-4.6.0a2.dist-info/METADATA,sha256=ap0X2yWU2XlGtUwVnidW53DCx7NQAYA0uULctySdktc,11452
-lets_plot-4.6.0a2.dist-info/WHEEL,sha256=VujM3ypTCyUW6hcTDdK2ej0ARVMxlU1Djlh_zWnDgqk,109
-lets_plot-4.6.0a2.dist-info/top_level.txt,sha256=ID-ORXUWN-oVZmD4YFy1rQVm2QT1D-MlGON3vdxqgpY,34
-lets_plot-4.6.0a2.dist-info/RECORD,,
+lets_plot-4.6.1.dist-info/LICENSE,sha256=r43VKLFaMylB4Ru-pE07j0cfUO7wQpMnWm-uZ8hEqMw,1066
+lets_plot-4.6.1.dist-info/METADATA,sha256=tVaoqaUUk6OCfJYGrriR4Ejqv7wr0x6FJlATgw258YI,11037
+lets_plot-4.6.1.dist-info/WHEEL,sha256=s9Qepq-rbSAzRXMu2ebLaLpFVEK77cKNCRNg8zN3U4g,109
+lets_plot-4.6.1.dist-info/top_level.txt,sha256=ID-ORXUWN-oVZmD4YFy1rQVm2QT1D-MlGON3vdxqgpY,34
+lets_plot-4.6.1.dist-info/RECORD,,

{lets_plot-4.6.0a2.dist-info → lets_plot-4.6.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.8.0)
+Generator: setuptools (75.8.2)
 Root-Is-Purelib: false
 Tag: cp312-cp312-macosx_11_0_arm64