lets-plot 4.4.0rc1__cp39-cp39-win_amd64.whl → 4.5.0__cp39-cp39-win_amd64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of lets-plot might be problematic. Click here for more details.

Files changed (39) hide show
  1. lets_plot/__init__.py +1 -1
  2. lets_plot/_type_utils.py +9 -4
  3. lets_plot/_version.py +1 -1
  4. lets_plot/bistro/corr.py +8 -1
  5. lets_plot/bistro/joint.py +7 -1
  6. lets_plot/bistro/qq.py +30 -3
  7. lets_plot/bistro/residual.py +6 -0
  8. lets_plot/bistro/waterfall.py +13 -5
  9. lets_plot/export/ggsave_.py +21 -1
  10. lets_plot/package_data/lets-plot.min.js +1 -1
  11. lets_plot/plot/__init__.py +3 -1
  12. lets_plot/plot/annotation.py +2 -2
  13. lets_plot/plot/core.py +11 -5
  14. lets_plot/plot/expand_limits_.py +78 -0
  15. lets_plot/plot/facet.py +9 -5
  16. lets_plot/plot/geom.py +710 -203
  17. lets_plot/plot/geom_function_.py +13 -3
  18. lets_plot/plot/geom_imshow_.py +1 -0
  19. lets_plot/plot/geom_livemap_.py +32 -0
  20. lets_plot/plot/gggrid_.py +5 -4
  21. lets_plot/plot/ggtb_.py +46 -1
  22. lets_plot/plot/guide.py +11 -1
  23. lets_plot/plot/label.py +2 -2
  24. lets_plot/plot/sampling.py +14 -4
  25. lets_plot/plot/scale.py +40 -40
  26. lets_plot/plot/scale_colormap_mpl.py +6 -4
  27. lets_plot/plot/scale_identity_.py +11 -19
  28. lets_plot/plot/scale_position.py +14 -14
  29. lets_plot/plot/stat.py +44 -4
  30. lets_plot/plot/subplots.py +1 -1
  31. lets_plot/plot/theme_.py +93 -13
  32. lets_plot/plot/tooltip.py +3 -3
  33. lets_plot/tilesets.py +4 -69
  34. {lets_plot-4.4.0rc1.dist-info → lets_plot-4.5.0.dist-info}/METADATA +37 -42
  35. {lets_plot-4.4.0rc1.dist-info → lets_plot-4.5.0.dist-info}/RECORD +39 -38
  36. {lets_plot-4.4.0rc1.dist-info → lets_plot-4.5.0.dist-info}/WHEEL +1 -1
  37. lets_plot_kotlin_bridge.cp39-win_amd64.pyd +0 -0
  38. {lets_plot-4.4.0rc1.dist-info → lets_plot-4.5.0.dist-info}/LICENSE +0 -0
  39. {lets_plot-4.4.0rc1.dist-info → lets_plot-4.5.0.dist-info}/top_level.txt +0 -0
lets_plot/plot/geom.py CHANGED
@@ -27,10 +27,12 @@ __all__ = ['geom_point', 'geom_path', 'geom_line',
27
27
  'geom_freqpoly', 'geom_step', 'geom_rect',
28
28
  'geom_segment', 'geom_curve', 'geom_spoke',
29
29
  'geom_text', 'geom_label', 'geom_pie', 'geom_lollipop',
30
- 'geom_count']
30
+ 'geom_count',
31
+ 'geom_blank']
31
32
 
32
33
 
33
- def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
34
+ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
35
+ manual_key=None, sampling=None,
34
36
  tooltips=None,
35
37
  map=None, map_join=None, use_crs=None,
36
38
  size_unit=None,
@@ -62,6 +64,8 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
62
64
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
63
65
  show_legend : bool, default=True
64
66
  False - do not show legend for this layer.
67
+ inherit_aes : bool, default=True
68
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
65
69
  manual_key : str or `layer_key`
66
70
  The key to show in the manual legend.
67
71
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -71,6 +75,7 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
71
75
  tooltips : `layer_tooltips`
72
76
  Result of the call to the `layer_tooltips()` function.
73
77
  Specify appearance, style and content.
78
+ Set tooltips='none' to hide tooltips from the layer.
74
79
  map : `GeoDataFrame` or `Geocoder`
75
80
  Data containing coordinates of points.
76
81
  map_join : str or list
@@ -112,9 +117,9 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
112
117
  - x : x-axis value.
113
118
  - y : y-axis value.
114
119
  - alpha : transparency level of the point. Accept values between 0 and 1.
115
- - 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").
116
- - 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").
117
- - shape : shape of the point, an integer from 0 to 25.
120
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
121
+ - fill : fill color. Is applied only to the points of shapes having inner area. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
122
+ - shape : shape of the point, an integer from 0 to 25. For more info see `Point Shapes <https://lets-plot.org/python/pages/aesthetics.html#point-shapes>`__.
118
123
  - angle : rotation angle of the point shape, in degrees.
119
124
  - size : size of the point.
120
125
  - stroke : width of the shape border. Applied only to the shapes having border.
@@ -149,6 +154,11 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
149
154
 
150
155
  - map_join=['County_name', 'State_Name']
151
156
 
157
+ ----
158
+
159
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
160
+ to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
161
+
152
162
  Examples
153
163
  --------
154
164
  .. jupyter-execute::
@@ -204,6 +214,7 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
204
214
  stat=stat,
205
215
  position=position,
206
216
  show_legend=show_legend,
217
+ inherit_aes=inherit_aes,
207
218
  manual_key=manual_key,
208
219
  sampling=sampling,
209
220
  tooltips=tooltips,
@@ -213,7 +224,8 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
213
224
  **other_args)
214
225
 
215
226
 
216
- def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
227
+ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
228
+ manual_key=None, sampling=None,
217
229
  tooltips=None,
218
230
  map=None, map_join=None, use_crs=None,
219
231
  flat=None, geodesic=None,
@@ -244,6 +256,8 @@ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=
244
256
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
245
257
  show_legend : bool, default=True
246
258
  False - do not show legend for this layer.
259
+ inherit_aes : bool, default=True
260
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
247
261
  manual_key : str or `layer_key`
248
262
  The key to show in the manual legend.
249
263
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -253,6 +267,7 @@ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=
253
267
  tooltips : `layer_tooltips`
254
268
  Result of the call to the `layer_tooltips()` function.
255
269
  Specify appearance, style and content.
270
+ Set tooltips='none' to hide tooltips from the layer.
256
271
  map : `GeoDataFrame`
257
272
  Data containing coordinates of lines.
258
273
  map_join : str or list
@@ -292,8 +307,8 @@ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=
292
307
  - x : x-axis value.
293
308
  - y : y-axis value.
294
309
  - alpha : transparency level of a layer. Accept values between 0 and 1.
295
- - 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").
296
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
310
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
311
+ - 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>`__.
297
312
  - size : line width.
298
313
 
299
314
  ----
@@ -387,6 +402,7 @@ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=
387
402
  stat=stat,
388
403
  position=position,
389
404
  show_legend=show_legend,
405
+ inherit_aes=inherit_aes,
390
406
  manual_key=manual_key,
391
407
  sampling=sampling,
392
408
  tooltips=tooltips,
@@ -396,7 +412,8 @@ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=
396
412
  **other_args)
397
413
 
398
414
 
399
- def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
415
+ def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
416
+ manual_key=None, sampling=None,
400
417
  tooltips=None,
401
418
  color_by=None,
402
419
  **other_args):
@@ -427,6 +444,8 @@ def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=
427
444
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
428
445
  show_legend : bool, default=True
429
446
  False - do not show legend for this layer.
447
+ inherit_aes : bool, default=True
448
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
430
449
  manual_key : str or `layer_key`
431
450
  The key to show in the manual legend.
432
451
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -436,6 +455,7 @@ def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=
436
455
  tooltips : `layer_tooltips`
437
456
  Result of the call to the `layer_tooltips()` function.
438
457
  Specify appearance, style and content.
458
+ Set tooltips='none' to hide tooltips from the layer.
439
459
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
440
460
  Define the color aesthetic for the geometry.
441
461
  other_args
@@ -459,10 +479,15 @@ def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=
459
479
  - x : x-axis value.
460
480
  - y : y-axis value.
461
481
  - alpha : transparency level of a layer. Accept values between 0 and 1.
462
- - 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").
463
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
482
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
483
+ - 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>`__.
464
484
  - size : line width.
465
485
 
486
+ ----
487
+
488
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
489
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
490
+
466
491
  Examples
467
492
  --------
468
493
  .. jupyter-execute::
@@ -503,6 +528,7 @@ def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=
503
528
  stat=stat,
504
529
  position=position,
505
530
  show_legend=show_legend,
531
+ inherit_aes=inherit_aes,
506
532
  manual_key=manual_key,
507
533
  sampling=sampling,
508
534
  tooltips=tooltips,
@@ -510,7 +536,8 @@ def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=
510
536
  **other_args)
511
537
 
512
538
 
513
- def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
539
+ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
540
+ manual_key=None, sampling=None,
514
541
  tooltips=None,
515
542
  orientation=None,
516
543
  method=None,
@@ -548,6 +575,8 @@ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legen
548
575
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
549
576
  show_legend : bool, default=True
550
577
  False - do not show legend for this layer.
578
+ inherit_aes : bool, default=True
579
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
551
580
  manual_key : str or `layer_key`
552
581
  The key to show in the manual legend.
553
582
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -557,6 +586,7 @@ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legen
557
586
  tooltips : `layer_tooltips`
558
587
  Result of the call to the `layer_tooltips()` function.
559
588
  Specify appearance, style and content.
589
+ Set tooltips='none' to hide tooltips from the layer.
560
590
  orientation : str, default='x'
561
591
  Specify the axis that the layer's stat and geom should run along.
562
592
  Possible values: 'x', 'y'.
@@ -611,11 +641,16 @@ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legen
611
641
  - x : x-axis value.
612
642
  - y : y-axis value.
613
643
  - alpha : transparency level of a layer. Accept values between 0 and 1.
614
- - 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").
615
- - 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").
616
- - 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'.
644
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
645
+ - fill : fill color for the confidence interval around the line. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
646
+ - linetype : type of the line of conditional mean 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>`__.
617
647
  - size : line width. Define line width for conditional mean and confidence bounds lines.
618
648
 
649
+ ----
650
+
651
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
652
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
653
+
619
654
  Examples
620
655
  --------
621
656
  .. jupyter-execute::
@@ -677,6 +712,7 @@ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legen
677
712
  stat=stat,
678
713
  position=position,
679
714
  show_legend=show_legend,
715
+ inherit_aes=inherit_aes,
680
716
  manual_key=manual_key,
681
717
  sampling=sampling,
682
718
  tooltips=tooltips,
@@ -693,7 +729,8 @@ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legen
693
729
  **other_args)
694
730
 
695
731
 
696
- def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
732
+ def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
733
+ manual_key=None, sampling=None,
697
734
  tooltips=None, labels=None,
698
735
  orientation=None,
699
736
  color_by=None, fill_by=None,
@@ -724,6 +761,8 @@ def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=N
724
761
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
725
762
  show_legend : bool, default=True
726
763
  False - do not show legend for this layer.
764
+ inherit_aes : bool, default=True
765
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
727
766
  manual_key : str or `layer_key`
728
767
  The key to show in the manual legend.
729
768
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -733,6 +772,7 @@ def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=N
733
772
  tooltips : `layer_tooltips`
734
773
  Result of the call to the `layer_tooltips()` function.
735
774
  Specify appearance, style and content.
775
+ Set tooltips='none' to hide tooltips from the layer.
736
776
  labels : `layer_labels`
737
777
  Result of the call to the `layer_labels()` function.
738
778
  Specify style and content of the annotations.
@@ -776,11 +816,16 @@ def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=N
776
816
  - x : x-axis value (this value will produce cases or bins for bars).
777
817
  - y : y-axis value (this value will be used to multiply the case's or bin's counts).
778
818
  - alpha : transparency level of a layer. Accept values between 0 and 1.
779
- - 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").
780
- - 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").
819
+ - 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>`__.
820
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
781
821
  - size : line width. Define bar line width.
782
822
  - weight : used by 'count' stat to compute weighted sum instead of simple count.
783
823
 
824
+ ----
825
+
826
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
827
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
828
+
784
829
  Examples
785
830
  --------
786
831
  .. jupyter-execute::
@@ -838,6 +883,7 @@ def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=N
838
883
  stat=stat,
839
884
  position=position,
840
885
  show_legend=show_legend,
886
+ inherit_aes=inherit_aes,
841
887
  manual_key=manual_key,
842
888
  sampling=sampling,
843
889
  tooltips=tooltips,
@@ -847,8 +893,8 @@ def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=N
847
893
  **other_args)
848
894
 
849
895
 
850
- def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
851
- sampling=None, threshold=None,
896
+ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
897
+ manual_key=None, sampling=None, threshold=None,
852
898
  tooltips=None, labels=None,
853
899
  orientation=None,
854
900
  bins=None,
@@ -883,6 +929,8 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
883
929
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
884
930
  show_legend : bool, default=True
885
931
  False - do not show legend for this layer.
932
+ inherit_aes : bool, default=True
933
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
886
934
  manual_key : str or `layer_key`
887
935
  The key to show in the manual legend.
888
936
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -895,6 +943,7 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
895
943
  tooltips : `layer_tooltips`
896
944
  Result of the call to the `layer_tooltips()` function.
897
945
  Specify appearance, style and content.
946
+ Set tooltips='none' to hide tooltips from the layer.
898
947
  labels : `layer_labels`
899
948
  Result of the call to the `layer_labels()` function.
900
949
  Specify style and content of the annotations.
@@ -934,6 +983,9 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
934
983
  Computed variables:
935
984
 
936
985
  - ..count.. : number of points with x-axis coordinate in the same bin.
986
+ - ..density.. : normalised number of points so that plot area is 1.
987
+ - ..sumprop.. : normalised number of points so that sum of y-values is 1.
988
+ - ..sumpct.. : normalised number of points so that sum of y-values is 100.
937
989
  - ..binwidth.. : width of each bin.
938
990
 
939
991
  `geom_histogram()` understands the following aesthetics mappings:
@@ -941,11 +993,16 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
941
993
  - x : x-axis value (this value will produce cases or bins for bars).
942
994
  - y : y-axis value, default: '..count..'. Alternatively: '..density..'.
943
995
  - alpha : transparency level of a layer. Accept values between 0 and 1.
944
- - 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").
945
- - 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").
996
+ - 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>`__.
997
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
946
998
  - size : line width.
947
999
  - weight : used by 'bin' stat to compute weighted sum instead of simple count.
948
1000
 
1001
+ ----
1002
+
1003
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
1004
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
1005
+
949
1006
  Examples
950
1007
  --------
951
1008
  .. jupyter-execute::
@@ -997,6 +1054,7 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
997
1054
  stat=stat,
998
1055
  position=position,
999
1056
  show_legend=show_legend,
1057
+ inherit_aes=inherit_aes,
1000
1058
  manual_key=manual_key,
1001
1059
  sampling=sampling,
1002
1060
  threshold=threshold,
@@ -1011,7 +1069,8 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
1011
1069
  **other_args)
1012
1070
 
1013
1071
 
1014
- def geom_dotplot(mapping=None, *, data=None, show_legend=None, manual_key=None, sampling=None, tooltips=None,
1072
+ def geom_dotplot(mapping=None, *, data=None, show_legend=None, inherit_aes=None,
1073
+ manual_key=None, sampling=None, tooltips=None,
1015
1074
  binwidth=None,
1016
1075
  bins=None,
1017
1076
  method=None,
@@ -1038,6 +1097,8 @@ def geom_dotplot(mapping=None, *, data=None, show_legend=None, manual_key=None,
1038
1097
  is inherited from the plot data as specified in the call to ggplot.
1039
1098
  show_legend : bool, default=True
1040
1099
  False - do not show legend for this layer.
1100
+ inherit_aes : bool, default=True
1101
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
1041
1102
  manual_key : str or `layer_key`
1042
1103
  The key to show in the manual legend.
1043
1104
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -1047,6 +1108,7 @@ def geom_dotplot(mapping=None, *, data=None, show_legend=None, manual_key=None,
1047
1108
  tooltips : `layer_tooltips`
1048
1109
  Result of the call to the `layer_tooltips()` function.
1049
1110
  Specify appearance, style and content.
1111
+ Set tooltips='none' to hide tooltips from the layer.
1050
1112
  binwidth : float
1051
1113
  When method is 'dotdensity', this specifies maximum bin width.
1052
1114
  When method is 'histodot', this specifies bin width.
@@ -1098,10 +1160,15 @@ def geom_dotplot(mapping=None, *, data=None, show_legend=None, manual_key=None,
1098
1160
 
1099
1161
  - x : x-axis value.
1100
1162
  - alpha : transparency level of a layer. Accept values between 0 and 1.
1101
- - 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").
1102
- - 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").
1163
+ - 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>`__.
1164
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
1103
1165
  - stroke : width of the dot border.
1104
1166
 
1167
+ ----
1168
+
1169
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
1170
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
1171
+
1105
1172
  Examples
1106
1173
  --------
1107
1174
  .. jupyter-execute::
@@ -1156,6 +1223,7 @@ def geom_dotplot(mapping=None, *, data=None, show_legend=None, manual_key=None,
1156
1223
  stat=None,
1157
1224
  position=None,
1158
1225
  show_legend=show_legend,
1226
+ inherit_aes=inherit_aes,
1159
1227
  manual_key=manual_key,
1160
1228
  sampling=sampling,
1161
1229
  tooltips=tooltips,
@@ -1172,7 +1240,8 @@ def geom_dotplot(mapping=None, *, data=None, show_legend=None, manual_key=None,
1172
1240
  **other_args)
1173
1241
 
1174
1242
 
1175
- def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
1243
+ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
1244
+ manual_key=None, sampling=None,
1176
1245
  tooltips=None,
1177
1246
  bins=None,
1178
1247
  binwidth=None,
@@ -1204,6 +1273,8 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
1204
1273
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
1205
1274
  show_legend : bool, default=True
1206
1275
  False - do not show legend for this layer.
1276
+ inherit_aes : bool, default=True
1277
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
1207
1278
  manual_key : str or `layer_key`
1208
1279
  The key to show in the manual legend.
1209
1280
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -1213,6 +1284,7 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
1213
1284
  tooltips : `layer_tooltips`
1214
1285
  Result of the call to the `layer_tooltips()` function.
1215
1286
  Specify appearance, style and content.
1287
+ Set tooltips='none' to hide tooltips from the layer.
1216
1288
  bins : list of int, default=[30, 30]
1217
1289
  Number of bins in both directions, vertical and horizontal. Overridden by `binwidth`.
1218
1290
  binwidth : list of float
@@ -1247,11 +1319,16 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
1247
1319
  - x : x-axis value.
1248
1320
  - y : y-axis value.
1249
1321
  - alpha : transparency level of a layer. Accept values between 0 and 1.
1250
- - 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").
1251
- - 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").
1322
+ - 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>`__.
1323
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
1252
1324
  - size : line width, default=0 (i.e. tiles outline initially is not visible).
1253
1325
  - weight : used by 'bin' stat to compute weighted sum instead of simple count.
1254
1326
 
1327
+ ----
1328
+
1329
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
1330
+ to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
1331
+
1255
1332
  Examples
1256
1333
  --------
1257
1334
  .. jupyter-execute::
@@ -1332,6 +1409,7 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
1332
1409
  stat=stat,
1333
1410
  position=position,
1334
1411
  show_legend=show_legend,
1412
+ inherit_aes=inherit_aes,
1335
1413
  manual_key=manual_key,
1336
1414
  sampling=sampling,
1337
1415
  tooltips=tooltips,
@@ -1342,7 +1420,8 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
1342
1420
  **other_args)
1343
1421
 
1344
1422
 
1345
- def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
1423
+ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
1424
+ manual_key=None, sampling=None,
1346
1425
  tooltips=None,
1347
1426
  color_by=None, fill_by=None,
1348
1427
  **other_args):
@@ -1366,6 +1445,8 @@ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=
1366
1445
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
1367
1446
  show_legend : bool, default=True
1368
1447
  False - do not show legend for this layer.
1448
+ inherit_aes : bool, default=True
1449
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
1369
1450
  manual_key : str or `layer_key`
1370
1451
  The key to show in the manual legend.
1371
1452
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -1375,6 +1456,7 @@ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=
1375
1456
  tooltips : `layer_tooltips`
1376
1457
  Result of the call to the `layer_tooltips()` function.
1377
1458
  Specify appearance, style and content.
1459
+ Set tooltips='none' to hide tooltips from the layer.
1378
1460
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
1379
1461
  Define the color aesthetic for the geometry.
1380
1462
  fill_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='fill'
@@ -1397,12 +1479,17 @@ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=
1397
1479
  - x : x-axis coordinates of the center of rectangles.
1398
1480
  - y : y-axis coordinates of the center of rectangles.
1399
1481
  - alpha : transparency level of a layer. Accept values between 0 and 1.
1400
- - 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").
1401
- - 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").
1482
+ - 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>`__.
1483
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
1402
1484
  - size : line width, default=0 (i.e. tiles outline initially is not visible).
1403
1485
  - width : width of a tile. Typically range between 0 and 1. Values that are greater than 1 lead to overlapping of the tiles.
1404
1486
  - height : height of a tile. Typically range between 0 and 1. Values that are greater than 1 lead to overlapping of the tiles.
1405
- - 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'.
1487
+ - linetype : type of the line of tile's border. 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>`__.
1488
+
1489
+ ----
1490
+
1491
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
1492
+ to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
1406
1493
 
1407
1494
  Examples
1408
1495
  --------
@@ -1477,6 +1564,7 @@ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=
1477
1564
  stat=stat,
1478
1565
  position=position,
1479
1566
  show_legend=show_legend,
1567
+ inherit_aes=inherit_aes,
1480
1568
  manual_key=manual_key,
1481
1569
  sampling=sampling,
1482
1570
  tooltips=tooltips,
@@ -1484,7 +1572,8 @@ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=
1484
1572
  **other_args)
1485
1573
 
1486
1574
 
1487
- def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
1575
+ def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
1576
+ manual_key=None, sampling=None,
1488
1577
  fill_by=None,
1489
1578
  **other_args):
1490
1579
  """
@@ -1509,6 +1598,8 @@ def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legen
1509
1598
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
1510
1599
  show_legend : bool, default=True
1511
1600
  False - do not show legend for this layer.
1601
+ inherit_aes : bool, default=True
1602
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
1512
1603
  manual_key : str or `layer_key`
1513
1604
  The key to show in the manual legend.
1514
1605
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -1535,7 +1626,7 @@ def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legen
1535
1626
  - x : x-axis coordinates of the center of rectangles.
1536
1627
  - y : y-axis coordinates of the center of rectangles.
1537
1628
  - alpha : transparency level of a layer. Accept values between 0 and 1.
1538
- - 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").
1629
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
1539
1630
 
1540
1631
  Examples
1541
1632
  --------
@@ -1569,13 +1660,15 @@ def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legen
1569
1660
  stat=stat,
1570
1661
  position=position,
1571
1662
  show_legend=show_legend,
1663
+ inherit_aes=inherit_aes,
1572
1664
  manual_key=manual_key,
1573
1665
  sampling=sampling,
1574
1666
  fill_by=fill_by,
1575
1667
  **other_args)
1576
1668
 
1577
1669
 
1578
- def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
1670
+ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
1671
+ manual_key=None,
1579
1672
  sampling=None, tooltips=None,
1580
1673
  color_by=None,
1581
1674
  **other_args):
@@ -1604,6 +1697,8 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1604
1697
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
1605
1698
  show_legend : bool, default=True
1606
1699
  False - do not show legend for this layer.
1700
+ inherit_aes : bool, default=True
1701
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
1607
1702
  manual_key : str or `layer_key`
1608
1703
  The key to show in the manual legend.
1609
1704
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -1613,6 +1708,7 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1613
1708
  tooltips : `layer_tooltips`
1614
1709
  Result of the call to the `layer_tooltips()` function.
1615
1710
  Specify appearance, style and content.
1711
+ Set tooltips='none' to hide tooltips from the layer.
1616
1712
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
1617
1713
  Define the color aesthetic for the geometry.
1618
1714
  other_args
@@ -1637,10 +1733,15 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1637
1733
  - ymin or xmin: lower bound for vertical or horizontal error bar, respectively.
1638
1734
  - ymax or xmax: upper bound for vertical or horizontal error bar, respectively.
1639
1735
  - alpha : transparency level of a layer. Accept values between 0 and 1.
1640
- - 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").
1736
+ - 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>`__.
1641
1737
  - size : line width. Define bar line width.
1642
1738
  - 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.
1643
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
1739
+ - 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>`__.
1740
+
1741
+ ----
1742
+
1743
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
1744
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
1644
1745
 
1645
1746
  Examples
1646
1747
  --------
@@ -1705,6 +1806,7 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1705
1806
  stat=stat,
1706
1807
  position=position,
1707
1808
  show_legend=show_legend,
1809
+ inherit_aes=inherit_aes,
1708
1810
  manual_key=manual_key,
1709
1811
  sampling=sampling,
1710
1812
  tooltips=tooltips,
@@ -1712,8 +1814,8 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1712
1814
  **other_args)
1713
1815
 
1714
1816
 
1715
- def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
1716
- sampling=None, tooltips=None,
1817
+ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
1818
+ manual_key=None, sampling=None, tooltips=None,
1717
1819
  fatten=None,
1718
1820
  color_by=None, fill_by=None,
1719
1821
  **other_args):
@@ -1742,6 +1844,8 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1742
1844
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
1743
1845
  show_legend : bool, default=True
1744
1846
  False - do not show legend for this layer.
1847
+ inherit_aes : bool, default=True
1848
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
1745
1849
  manual_key : str or `layer_key`
1746
1850
  The key to show in the manual legend.
1747
1851
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -1751,6 +1855,7 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1751
1855
  tooltips : `layer_tooltips`
1752
1856
  Result of the call to the `layer_tooltips()` function.
1753
1857
  Specify appearance, style and content.
1858
+ Set tooltips='none' to hide tooltips from the layer.
1754
1859
  fatten : float, default=2.5
1755
1860
  A multiplicative factor applied to size of the middle bar.
1756
1861
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
@@ -1781,11 +1886,16 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1781
1886
  - ymin or xmin: lower bound for vertical or horizontal bar, respectively.
1782
1887
  - ymax or xmax: upper bound for vertical or horizontal bar, respectively.
1783
1888
  - alpha : transparency level of a layer. Accept values between 0 and 1.
1784
- - 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").
1785
- - 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").
1889
+ - 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>`__.
1890
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
1786
1891
  - size : lines width.
1787
1892
  - width : width of a bar. Typically range between 0 and 1. Values that are greater than 1 lead to overlapping of the bars.
1788
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
1893
+ - 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>`__.
1894
+
1895
+ ----
1896
+
1897
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
1898
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
1789
1899
 
1790
1900
  Examples
1791
1901
  --------
@@ -1839,6 +1949,7 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1839
1949
  stat=stat,
1840
1950
  position=position,
1841
1951
  show_legend=show_legend,
1952
+ inherit_aes=inherit_aes,
1842
1953
  manual_key=manual_key,
1843
1954
  sampling=sampling,
1844
1955
  tooltips=tooltips,
@@ -1847,9 +1958,8 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1847
1958
  **other_args)
1848
1959
 
1849
1960
 
1850
- def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
1851
- sampling=None,
1852
- tooltips=None,
1961
+ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
1962
+ manual_key=None, sampling=None, tooltips=None,
1853
1963
  fatten=None,
1854
1964
  color_by=None, fill_by=None,
1855
1965
  **other_args):
@@ -1878,6 +1988,8 @@ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_l
1878
1988
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
1879
1989
  show_legend : bool, default=True
1880
1990
  False - do not show legend for this layer.
1991
+ inherit_aes : bool, default=True
1992
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
1881
1993
  manual_key : str or `layer_key`
1882
1994
  The key to show in the manual legend.
1883
1995
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -1887,6 +1999,7 @@ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_l
1887
1999
  tooltips : `layer_tooltips`
1888
2000
  Result of the call to the `layer_tooltips()` function.
1889
2001
  Specify appearance, style and content.
2002
+ Set tooltips='none' to hide tooltips from the layer.
1890
2003
  fatten : float, default=5.0
1891
2004
  A multiplicative factor applied to size of the middle point.
1892
2005
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
@@ -1917,14 +2030,19 @@ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_l
1917
2030
  - ymin or xmin: lower bound for vertical or horizontal interval, respectively.
1918
2031
  - ymax or xmax: upper bound for vertical or horizontal interval, respectively.
1919
2032
  - alpha : transparency level of a layer. Accept values between 0 and 1.
1920
- - 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").
1921
- - 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").
2033
+ - 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>`__.
2034
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
1922
2035
  - size : size of mid-point.
1923
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
1924
- - shape : shape of the mid-point, an integer from 0 to 25.
2036
+ - 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>`__.
2037
+ - shape : shape of the mid-point, an integer from 0 to 25. For more info see `Point Shapes <https://lets-plot.org/python/pages/aesthetics.html#point-shapes>`__.
1925
2038
  - stroke : width of the shape border. Applied only to the shapes having border.
1926
2039
  - linewidth : line width.
1927
2040
 
2041
+ ----
2042
+
2043
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
2044
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
2045
+
1928
2046
  Examples
1929
2047
  --------
1930
2048
  .. jupyter-execute::
@@ -1972,6 +2090,7 @@ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_l
1972
2090
  stat=stat,
1973
2091
  position=position,
1974
2092
  show_legend=show_legend,
2093
+ inherit_aes=inherit_aes,
1975
2094
  manual_key=manual_key,
1976
2095
  sampling=sampling,
1977
2096
  tooltips=tooltips,
@@ -1980,7 +2099,8 @@ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_l
1980
2099
  **other_args)
1981
2100
 
1982
2101
 
1983
- def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
2102
+ def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
2103
+ manual_key=None,
1984
2104
  sampling=None, tooltips=None,
1985
2105
  color_by=None,
1986
2106
  **other_args):
@@ -2009,6 +2129,8 @@ def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_le
2009
2129
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2010
2130
  show_legend : bool, default=True
2011
2131
  False - do not show legend for this layer.
2132
+ inherit_aes : bool, default=True
2133
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
2012
2134
  manual_key : str or `layer_key`
2013
2135
  The key to show in the manual legend.
2014
2136
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -2018,6 +2140,7 @@ def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_le
2018
2140
  tooltips : `layer_tooltips`
2019
2141
  Result of the call to the `layer_tooltips()` function.
2020
2142
  Specify appearance, style and content.
2143
+ Set tooltips='none' to hide tooltips from the layer.
2021
2144
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
2022
2145
  Define the color aesthetic for the geometry.
2023
2146
  other_args
@@ -2042,9 +2165,14 @@ def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_le
2042
2165
  - ymin or xmin: lower bound for vertical or horizontal line range, respectively.
2043
2166
  - ymax or xmax: upper bound for vertical or horizontal line range, respectively.
2044
2167
  - alpha : transparency level of a layer. Accept values between 0 and 1.
2045
- - 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").
2168
+ - 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>`__.
2046
2169
  - size : line width.
2047
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
2170
+ - 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>`__.
2171
+
2172
+ ----
2173
+
2174
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
2175
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
2048
2176
 
2049
2177
  Examples
2050
2178
  --------
@@ -2093,6 +2221,7 @@ def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_le
2093
2221
  stat=stat,
2094
2222
  position=position,
2095
2223
  show_legend=show_legend,
2224
+ inherit_aes=inherit_aes,
2096
2225
  manual_key=manual_key,
2097
2226
  sampling=sampling,
2098
2227
  tooltips=tooltips,
@@ -2100,7 +2229,8 @@ def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_le
2100
2229
  **other_args)
2101
2230
 
2102
2231
 
2103
- def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
2232
+ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
2233
+ manual_key=None, sampling=None,
2104
2234
  tooltips=None,
2105
2235
  bins=None,
2106
2236
  binwidth=None,
@@ -2126,6 +2256,8 @@ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_lege
2126
2256
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2127
2257
  show_legend : bool, default=True
2128
2258
  False - do not show legend for this layer.
2259
+ inherit_aes : bool, default=True
2260
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
2129
2261
  manual_key : str or `layer_key`
2130
2262
  The key to show in the manual legend.
2131
2263
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -2135,6 +2267,7 @@ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_lege
2135
2267
  tooltips : `layer_tooltips`
2136
2268
  Result of the call to the `layer_tooltips()` function.
2137
2269
  Specify appearance, style and content.
2270
+ Set tooltips='none' to hide tooltips from the layer.
2138
2271
  bins : int
2139
2272
  Number of levels.
2140
2273
  binwidth : float
@@ -2166,9 +2299,14 @@ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_lege
2166
2299
  - y : y-axis coordinates of the center of rectangles, forming a tessellation.
2167
2300
  - z : value at point (x, y).
2168
2301
  - alpha : transparency level of a layer. Accept values between 0 and 1.
2169
- - 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").
2302
+ - 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>`__.
2170
2303
  - size : lines width.
2171
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
2304
+ - 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>`__.
2305
+
2306
+ ----
2307
+
2308
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
2309
+ to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
2172
2310
 
2173
2311
  Examples
2174
2312
  --------
@@ -2236,6 +2374,7 @@ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_lege
2236
2374
  stat=stat,
2237
2375
  position=position,
2238
2376
  show_legend=show_legend,
2377
+ inherit_aes=inherit_aes,
2239
2378
  manual_key=manual_key,
2240
2379
  sampling=sampling,
2241
2380
  tooltips=tooltips,
@@ -2244,7 +2383,8 @@ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_lege
2244
2383
  **other_args)
2245
2384
 
2246
2385
 
2247
- def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
2386
+ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
2387
+ manual_key=None,
2248
2388
  sampling=None, tooltips=None,
2249
2389
  bins=None,
2250
2390
  binwidth=None,
@@ -2270,6 +2410,8 @@ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_leg
2270
2410
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2271
2411
  show_legend : bool, default=True
2272
2412
  False - do not show legend for this layer.
2413
+ inherit_aes : bool, default=True
2414
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
2273
2415
  manual_key : str or `layer_key`
2274
2416
  The key to show in the manual legend.
2275
2417
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -2279,6 +2421,7 @@ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_leg
2279
2421
  tooltips : `layer_tooltips`
2280
2422
  Result of the call to the `layer_tooltips()` function.
2281
2423
  Specify appearance, style and content.
2424
+ Set tooltips='none' to hide tooltips from the layer.
2282
2425
  bins : int
2283
2426
  Number of levels.
2284
2427
  binwidth : float
@@ -2312,7 +2455,7 @@ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_leg
2312
2455
  - y : y-axis coordinates of the center of rectangles, forming a tessellation.
2313
2456
  - z : value at point (x, y).
2314
2457
  - alpha : transparency level of a layer. Accept values between 0 and 1.
2315
- - 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").
2458
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
2316
2459
 
2317
2460
  Examples
2318
2461
  --------
@@ -2335,7 +2478,7 @@ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_leg
2335
2478
  rv = multivariate_normal(mean, cov)
2336
2479
  Z = rv.pdf(np.dstack((X, Y)))
2337
2480
  data = {'x': X.flatten(), 'y': Y.flatten(), 'z': Z.flatten()}
2338
- ggplot(data, aes(x='x', y='y', z='z')) + geom_contourf()
2481
+ ggplot(data, aes(x='x', y='y', z='z')) + geom_contourf(aes(fill='..level..'))
2339
2482
 
2340
2483
  |
2341
2484
 
@@ -2381,6 +2524,7 @@ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_leg
2381
2524
  stat=stat,
2382
2525
  position=position,
2383
2526
  show_legend=show_legend,
2527
+ inherit_aes=inherit_aes,
2384
2528
  manual_key=manual_key,
2385
2529
  sampling=sampling,
2386
2530
  tooltips=tooltips,
@@ -2390,7 +2534,8 @@ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_leg
2390
2534
  **other_args)
2391
2535
 
2392
2536
 
2393
- def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
2537
+ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
2538
+ manual_key=None, sampling=None,
2394
2539
  tooltips=None,
2395
2540
  map=None, map_join=None, use_crs=None,
2396
2541
  color_by=None, fill_by=None,
@@ -2415,6 +2560,8 @@ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_lege
2415
2560
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2416
2561
  show_legend : bool, default=True
2417
2562
  False - do not show legend for this layer.
2563
+ inherit_aes : bool, default=True
2564
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
2418
2565
  manual_key : str or `layer_key`
2419
2566
  The key to show in the manual legend.
2420
2567
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -2424,6 +2571,7 @@ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_lege
2424
2571
  tooltips : `layer_tooltips`
2425
2572
  Result of the call to the `layer_tooltips()` function.
2426
2573
  Specify appearance, style and content.
2574
+ Set tooltips='none' to hide tooltips from the layer.
2427
2575
  map : `GeoDataFrame` or `Geocoder`
2428
2576
  Data contains coordinates of polygon vertices on map.
2429
2577
  map_join : str or list
@@ -2460,10 +2608,10 @@ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_lege
2460
2608
  - x : x-axis coordinates of the vertices of the polygon.
2461
2609
  - y : y-axis coordinates of the vertices of the polygon.
2462
2610
  - alpha : transparency level of a layer. Accept values between 0 and 1.
2463
- - 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").
2464
- - 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").
2611
+ - 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>`__.
2612
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
2465
2613
  - size : line width.
2466
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
2614
+ - 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>`__.
2467
2615
 
2468
2616
  ----
2469
2617
 
@@ -2564,6 +2712,7 @@ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_lege
2564
2712
  stat=stat,
2565
2713
  position=position,
2566
2714
  show_legend=show_legend,
2715
+ inherit_aes=inherit_aes,
2567
2716
  manual_key=manual_key,
2568
2717
  sampling=sampling,
2569
2718
  tooltips=tooltips,
@@ -2572,8 +2721,8 @@ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_lege
2572
2721
  **other_args)
2573
2722
 
2574
2723
 
2575
- def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
2576
- tooltips=None,
2724
+ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
2725
+ manual_key=None, sampling=None, tooltips=None,
2577
2726
  map=None, map_join=None, use_crs=None,
2578
2727
  color_by=None, fill_by=None,
2579
2728
  **other_args):
@@ -2602,6 +2751,8 @@ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=N
2602
2751
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2603
2752
  show_legend : bool, default=True
2604
2753
  False - do not show legend for this layer.
2754
+ inherit_aes : bool, default=True
2755
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
2605
2756
  manual_key : str or `layer_key`
2606
2757
  The key to show in the manual legend.
2607
2758
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -2611,6 +2762,7 @@ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=N
2611
2762
  tooltips : `layer_tooltips`
2612
2763
  Result of the call to the `layer_tooltips()` function.
2613
2764
  Specify appearance, style and content.
2765
+ Set tooltips='none' to hide tooltips from the layer.
2614
2766
  map : `GeoDataFrame` or `Geocoder`
2615
2767
  Data containing region boundaries (coordinates of polygon vertices on map).
2616
2768
  map_join : str or list
@@ -2646,10 +2798,10 @@ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=N
2646
2798
  `geom_map()` understands the following aesthetics:
2647
2799
 
2648
2800
  - alpha : transparency level of a layer. Accept values between 0 and 1.
2649
- - 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").
2650
- - 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").
2801
+ - 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>`__.
2802
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
2651
2803
  - size : line width.
2652
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
2804
+ - 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>`__.
2653
2805
 
2654
2806
  ----
2655
2807
 
@@ -2736,6 +2888,7 @@ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=N
2736
2888
  stat=stat,
2737
2889
  position=position,
2738
2890
  show_legend=show_legend,
2891
+ inherit_aes=inherit_aes,
2739
2892
  manual_key=manual_key,
2740
2893
  sampling=sampling,
2741
2894
  tooltips=tooltips,
@@ -2744,7 +2897,8 @@ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=N
2744
2897
  **other_args)
2745
2898
 
2746
2899
 
2747
- def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
2900
+ def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
2901
+ manual_key=None, sampling=None,
2748
2902
  slope=None,
2749
2903
  intercept=None,
2750
2904
  color_by=None,
@@ -2769,6 +2923,8 @@ def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legen
2769
2923
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2770
2924
  show_legend : bool, default=True
2771
2925
  False - do not show legend for this layer.
2926
+ inherit_aes : bool, default=True
2927
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
2772
2928
  manual_key : str or `layer_key`
2773
2929
  The key to show in the manual legend.
2774
2930
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -2801,9 +2957,9 @@ def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legen
2801
2957
  - slope : line slope.
2802
2958
  - intercept : line y-intercept.
2803
2959
  - alpha : transparency level of a layer. Accept values between 0 and 1.
2804
- - 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").
2960
+ - 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>`__.
2805
2961
  - size : lines width.
2806
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
2962
+ - 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>`__.
2807
2963
 
2808
2964
  Examples
2809
2965
  --------
@@ -2849,6 +3005,7 @@ def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legen
2849
3005
  stat=stat,
2850
3006
  position=position,
2851
3007
  show_legend=show_legend,
3008
+ inherit_aes=inherit_aes,
2852
3009
  manual_key=manual_key,
2853
3010
  sampling=sampling,
2854
3011
  slope=slope,
@@ -2857,8 +3014,8 @@ def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legen
2857
3014
  **other_args)
2858
3015
 
2859
3016
 
2860
- def geom_band(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None,
2861
- tooltips=None,
3017
+ def geom_band(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
3018
+ sampling=None, tooltips=None,
2862
3019
  color_by=None, fill_by=None,
2863
3020
  **other_args):
2864
3021
  """
@@ -2881,12 +3038,15 @@ def geom_band(mapping=None, *, data=None, stat=None, position=None, show_legend=
2881
3038
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2882
3039
  show_legend : bool, default=True
2883
3040
  False - do not show legend for this layer.
3041
+ inherit_aes : bool, default=True
3042
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
2884
3043
  sampling : `FeatureSpec`
2885
3044
  Result of the call to the `sampling_xxx()` function.
2886
3045
  To prevent any sampling for this layer pass value "none" (string "none").
2887
3046
  tooltips : `layer_tooltips`
2888
3047
  Result of the call to the `layer_tooltips()` function.
2889
3048
  Specify appearance, style and content.
3049
+ Set tooltips='none' to hide tooltips from the layer.
2890
3050
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
2891
3051
  Define the color aesthetic for the geometry.
2892
3052
  fill_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='fill'
@@ -2911,10 +3071,10 @@ def geom_band(mapping=None, *, data=None, stat=None, position=None, show_legend=
2911
3071
  - ymin : y-axis value.
2912
3072
  - ymax : y-axis value.
2913
3073
  - alpha : transparency level of a layer. Accept values between 0 and 1.
2914
- - 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").
2915
- - 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").
3074
+ - 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>`__.
3075
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
2916
3076
  - size : lines width.
2917
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
3077
+ - 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>`__.
2918
3078
 
2919
3079
  Examples
2920
3080
  --------
@@ -2930,30 +3090,26 @@ def geom_band(mapping=None, *, data=None, stat=None, position=None, show_legend=
2930
3090
 
2931
3091
  .. jupyter-execute::
2932
3092
  :linenos:
2933
- :emphasize-lines: 16-19
3093
+ :emphasize-lines: 16-17
2934
3094
 
3095
+ import numpy as np
3096
+ import pandas as pd
2935
3097
  from lets_plot import *
2936
3098
  LetsPlot.setup_html()
2937
- n = 11
2938
- w = 5
2939
- color = "orange"
2940
- xdata = {
2941
- "xmin": list(range(0, w * n, w)),
2942
- "xmax": list(range(1, w * n + 1, w)),
2943
- }
2944
- ydata = {
2945
- "ymin": [0, 10],
2946
- "ymax": [10, 15],
2947
- "color": [color, "white"],
2948
- }
3099
+ groups = ["A", "B", "C"]
3100
+ n, m = 15, len(groups)
3101
+ np.random.seed(42)
3102
+ points_df = pd.DataFrame({
3103
+ 'x': np.random.normal(size=m*n),
3104
+ 'y': np.concatenate([np.random.normal(loc=loc, size=n)
3105
+ for loc in np.random.uniform(-1, 1, size=m)]),
3106
+ 'g': np.random.choice(groups, size=m*n),
3107
+ })
3108
+ vertical_bands_df = points_df.groupby('g')['y'].agg(['min', 'max']).reset_index()
2949
3109
  ggplot() + \\
2950
- geom_band(aes(xmin="xmin", xmax="xmax"), data=xdata, \\
2951
- size=0, fill=color, tooltips='none') + \\
2952
- geom_band(aes(ymin="ymin", ymax="ymax", fill="color"), data=ydata, \\
2953
- size=0, tooltips='none') + \\
2954
- scale_fill_identity() + \\
2955
- coord_polar(xlim=[0, w * n], ylim=[0, 25]) + \\
2956
- theme_void()
3110
+ geom_band(aes(ymin='min', ymax='max', paint_a='g'), data=vertical_bands_df, \\
3111
+ fill_by='paint_a', alpha=.2, size=0) + \\
3112
+ geom_point(aes('x', 'y', paint_a='g'), data=points_df, color_by='paint_a')
2957
3113
 
2958
3114
  """
2959
3115
  return _geom('band',
@@ -2962,6 +3118,7 @@ def geom_band(mapping=None, *, data=None, stat=None, position=None, show_legend=
2962
3118
  stat=stat,
2963
3119
  position=position,
2964
3120
  show_legend=show_legend,
3121
+ inherit_aes=inherit_aes,
2965
3122
  sampling=sampling,
2966
3123
  tooltips=tooltips,
2967
3124
  color_by=color_by,
@@ -2969,7 +3126,8 @@ def geom_band(mapping=None, *, data=None, stat=None, position=None, show_legend=
2969
3126
  **other_args)
2970
3127
 
2971
3128
 
2972
- def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
3129
+ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
3130
+ manual_key=None, sampling=None,
2973
3131
  tooltips=None,
2974
3132
  yintercept=None,
2975
3133
  color_by=None,
@@ -2994,6 +3152,8 @@ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend
2994
3152
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2995
3153
  show_legend : bool, default=True
2996
3154
  False - do not show legend for this layer.
3155
+ inherit_aes : bool, default=True
3156
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
2997
3157
  manual_key : str or `layer_key`
2998
3158
  The key to show in the manual legend.
2999
3159
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -3003,6 +3163,7 @@ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend
3003
3163
  tooltips : `layer_tooltips`
3004
3164
  Result of the call to the `layer_tooltips()` function.
3005
3165
  Specify appearance, style and content.
3166
+ Set tooltips='none' to hide tooltips from the layer.
3006
3167
  yintercept : float
3007
3168
  The value of y at the point where the line crosses the y axis.
3008
3169
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
@@ -3024,9 +3185,9 @@ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend
3024
3185
 
3025
3186
  - yintercept : line y-intercept.
3026
3187
  - alpha : transparency level of a layer. Accept values between 0 and 1.
3027
- - 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").
3188
+ - 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>`__.
3028
3189
  - size : line width.
3029
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
3190
+ - 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>`__.
3030
3191
 
3031
3192
  Examples
3032
3193
  --------
@@ -3081,6 +3242,7 @@ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend
3081
3242
  stat=stat,
3082
3243
  position=position,
3083
3244
  show_legend=show_legend,
3245
+ inherit_aes=inherit_aes,
3084
3246
  manual_key=manual_key,
3085
3247
  sampling=sampling,
3086
3248
  tooltips=tooltips,
@@ -3089,7 +3251,8 @@ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend
3089
3251
  **other_args)
3090
3252
 
3091
3253
 
3092
- def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
3254
+ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
3255
+ manual_key=None, sampling=None,
3093
3256
  tooltips=None,
3094
3257
  xintercept=None,
3095
3258
  color_by=None,
@@ -3114,6 +3277,8 @@ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend
3114
3277
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
3115
3278
  show_legend : bool, default=True
3116
3279
  False - do not show legend for this layer.
3280
+ inherit_aes : bool, default=True
3281
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
3117
3282
  manual_key : str or `layer_key`
3118
3283
  The key to show in the manual legend.
3119
3284
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -3123,6 +3288,7 @@ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend
3123
3288
  tooltips : `layer_tooltips`
3124
3289
  Result of the call to the `layer_tooltips()` function.
3125
3290
  Specify appearance, style and content.
3291
+ Set tooltips='none' to hide tooltips from the layer.
3126
3292
  xintercept : float
3127
3293
  The value of x at the point where the line crosses the x axis.
3128
3294
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
@@ -3144,9 +3310,9 @@ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend
3144
3310
 
3145
3311
  - xintercept : line x-intercept.
3146
3312
  - alpha : transparency level of a layer. Accept values between 0 and 1.
3147
- - 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").
3313
+ - 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>`__.
3148
3314
  - size : lines width.
3149
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
3315
+ - 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>`__.
3150
3316
 
3151
3317
  Examples
3152
3318
  --------
@@ -3201,6 +3367,7 @@ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend
3201
3367
  stat=stat,
3202
3368
  position=position,
3203
3369
  show_legend=show_legend,
3370
+ inherit_aes=inherit_aes,
3204
3371
  manual_key=manual_key,
3205
3372
  sampling=sampling,
3206
3373
  tooltips=tooltips,
@@ -3209,7 +3376,8 @@ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend
3209
3376
  **other_args)
3210
3377
 
3211
3378
 
3212
- def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, tooltips=None,
3379
+ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
3380
+ manual_key=None, tooltips=None,
3213
3381
  orientation=None,
3214
3382
  fatten=None,
3215
3383
  outlier_alpha=None, outlier_color=None, outlier_fill=None,
@@ -3240,12 +3408,15 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
3240
3408
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
3241
3409
  show_legend : bool, default=True
3242
3410
  False - do not show legend for this layer.
3411
+ inherit_aes : bool, default=True
3412
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
3243
3413
  manual_key : str or `layer_key`
3244
3414
  The key to show in the manual legend.
3245
3415
  Specify text for the legend label or advanced settings using the `layer_key()` function.
3246
3416
  tooltips : `layer_tooltips`
3247
3417
  Result of the call to the `layer_tooltips()` function.
3248
3418
  Specify appearance, style and content.
3419
+ Set tooltips='none' to hide tooltips from the layer.
3249
3420
  orientation : str
3250
3421
  Specify the axis that the layer's stat and geom should run along.
3251
3422
  The default value (None) automatically determines the orientation based on the aesthetic mapping.
@@ -3304,12 +3475,17 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
3304
3475
  - ymin : lower whisker.
3305
3476
  - ymax : upper whisker.
3306
3477
  - alpha : transparency level of a layer. Accept values between 0 and 1.
3307
- - 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").
3308
- - 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").
3478
+ - 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>`__.
3479
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
3309
3480
  - size : lines width.
3310
- - linetype : type of the line of border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
3481
+ - linetype : type of the line of border. 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>`__.
3311
3482
  - width : width of boxplot. Typically ranges between 0 and 1. Values that are greater than 1 lead to overlapping of the boxes.
3312
3483
 
3484
+ ----
3485
+
3486
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
3487
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
3488
+
3313
3489
  Examples
3314
3490
  --------
3315
3491
  .. jupyter-execute::
@@ -3337,8 +3513,8 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
3337
3513
  LetsPlot.setup_html()
3338
3514
  n = 100
3339
3515
  np.random.seed(42)
3340
- x = np.random.choice(['a', 'b', 'b', 'c'], size=n)
3341
- y = np.random.normal(size=n)
3516
+ x = np.random.normal(size=n)
3517
+ y = np.random.choice(['a', 'b', 'b', 'c'], size=n)
3342
3518
  ggplot({'x': x, 'y': y}, aes(x='x', y='y')) + \\
3343
3519
  geom_boxplot(fatten=5, varwidth=True, \\
3344
3520
  outlier_shape=8, outlier_size=2)
@@ -3379,10 +3555,10 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
3379
3555
  LetsPlot.setup_html()
3380
3556
  n, m = 100, 5
3381
3557
  np.random.seed(42)
3382
- df = pd.DataFrame({'x%s' % i: np.random.normal(size=n) \\
3558
+ df = pd.DataFrame({'y%s' % i: np.random.normal(size=n) \\
3383
3559
  for i in range(1, m + 1)})
3384
3560
  ggplot(df.melt()) + \\
3385
- geom_boxplot(aes(x='variable', y='value', color='variable', \\
3561
+ geom_boxplot(aes(x='value', y='variable', color='variable', \\
3386
3562
  fill='variable'), \\
3387
3563
  outlier_shape=21, outlier_size=1.5, size=2, \\
3388
3564
  alpha=.5, width=.5, show_legend=False)
@@ -3394,7 +3570,8 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
3394
3570
  stat=stat,
3395
3571
  position=position,
3396
3572
  show_legend=show_legend,
3397
- manual_key=manual_key,
3573
+ inherit_aes=inherit_aes,
3574
+ manual_key=manual_key,
3398
3575
  sampling=None,
3399
3576
  tooltips=tooltips,
3400
3577
  orientation=orientation,
@@ -3415,6 +3592,7 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
3415
3592
  stat='boxplot_outlier',
3416
3593
  position=position,
3417
3594
  show_legend=False,
3595
+ inherit_aes=inherit_aes,
3418
3596
  sampling=None,
3419
3597
  orientation=orientation,
3420
3598
  alpha=outlier_alpha,
@@ -3427,7 +3605,8 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
3427
3605
  return boxplot_layer
3428
3606
 
3429
3607
 
3430
- def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
3608
+ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
3609
+ manual_key=None, sampling=None,
3431
3610
  tooltips=None,
3432
3611
  orientation=None,
3433
3612
  show_half=None,
@@ -3455,6 +3634,8 @@ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legen
3455
3634
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
3456
3635
  show_legend : bool, default=True
3457
3636
  False - do not show legend for this layer.
3637
+ inherit_aes : bool, default=True
3638
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
3458
3639
  manual_key : str or `layer_key`
3459
3640
  The key to show in the manual legend.
3460
3641
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -3464,6 +3645,7 @@ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legen
3464
3645
  tooltips : `layer_tooltips`
3465
3646
  Result of the call to the `layer_tooltips()` function.
3466
3647
  Specify appearance, style and content.
3648
+ Set tooltips='none' to hide tooltips from the layer.
3467
3649
  orientation : str
3468
3650
  Specify the axis that the layer's stat and geom should run along.
3469
3651
  The default value (None) automatically determines the orientation based on the aesthetic mapping.
@@ -3528,13 +3710,18 @@ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legen
3528
3710
  - x : x-axis coordinates.
3529
3711
  - y : y-axis coordinates.
3530
3712
  - alpha : transparency level of a layer. Accept values between 0 and 1.
3531
- - 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").
3532
- - 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").
3713
+ - 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>`__.
3714
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
3533
3715
  - size : lines width.
3534
- - linetype : type of the line of border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
3716
+ - linetype : type of the line of border. 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>`__.
3535
3717
  - weight : used by 'ydensity' stat to compute weighted density.
3536
3718
  - quantile : quantile values to draw quantile lines and fill quantiles of the geometry by color.
3537
3719
 
3720
+ ----
3721
+
3722
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
3723
+ to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
3724
+
3538
3725
  Examples
3539
3726
  --------
3540
3727
  .. jupyter-execute::
@@ -3635,6 +3822,7 @@ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legen
3635
3822
  stat=stat,
3636
3823
  position=position,
3637
3824
  show_legend=show_legend,
3825
+ inherit_aes=inherit_aes,
3638
3826
  manual_key=manual_key,
3639
3827
  sampling=sampling,
3640
3828
  tooltips=tooltips,
@@ -3642,12 +3830,15 @@ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legen
3642
3830
  show_half=show_half,
3643
3831
  quantiles=quantiles,
3644
3832
  quantile_lines=quantile_lines,
3645
- scale=scale, trim=trim, tails_cutoff=tails_cutoff, kernel=kernel, bw=bw, adjust=adjust, n=n, fs_max=fs_max,
3833
+ scale=scale, trim=trim, tails_cutoff=tails_cutoff, kernel=kernel, bw=bw, adjust=adjust, n=n,
3834
+ fs_max=fs_max,
3646
3835
  color_by=color_by, fill_by=fill_by,
3647
3836
  **other_args)
3648
3837
 
3649
3838
 
3650
- def geom_ydotplot(mapping=None, *, data=None, show_legend=None, manual_key=None, sampling=None, tooltips=None,
3839
+ def geom_ydotplot(mapping=None, *, data=None, show_legend=None, inherit_aes=None,
3840
+ manual_key=None, sampling=None,
3841
+ tooltips=None,
3651
3842
  orientation=None,
3652
3843
  binwidth=None,
3653
3844
  bins=None,
@@ -3676,6 +3867,8 @@ def geom_ydotplot(mapping=None, *, data=None, show_legend=None, manual_key=None,
3676
3867
  is inherited from the plot data as specified in the call to ggplot.
3677
3868
  show_legend : bool, default=True
3678
3869
  False - do not show legend for this layer.
3870
+ inherit_aes : bool, default=True
3871
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
3679
3872
  manual_key : str or `layer_key`
3680
3873
  The key to show in the manual legend.
3681
3874
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -3685,6 +3878,7 @@ def geom_ydotplot(mapping=None, *, data=None, show_legend=None, manual_key=None,
3685
3878
  tooltips : `layer_tooltips`
3686
3879
  Result of the call to the `layer_tooltips()` function.
3687
3880
  Specify appearance, style and content.
3881
+ Set tooltips='none' to hide tooltips from the layer.
3688
3882
  orientation : str
3689
3883
  Specify the axis that the layer's stat and geom should run along.
3690
3884
  The default value (None) automatically determines the orientation based on the aesthetic mapping.
@@ -3743,10 +3937,15 @@ def geom_ydotplot(mapping=None, *, data=None, show_legend=None, manual_key=None,
3743
3937
  - x : x-axis value.
3744
3938
  - y : y-axis value.
3745
3939
  - alpha : transparency level of a layer. Accept values between 0 and 1.
3746
- - 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").
3747
- - 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").
3940
+ - 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>`__.
3941
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
3748
3942
  - stroke : width of the dot border.
3749
3943
 
3944
+ ----
3945
+
3946
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
3947
+ to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
3948
+
3750
3949
  Examples
3751
3950
  --------
3752
3951
  .. jupyter-execute::
@@ -3812,6 +4011,7 @@ def geom_ydotplot(mapping=None, *, data=None, show_legend=None, manual_key=None,
3812
4011
  stat=None,
3813
4012
  position=None,
3814
4013
  show_legend=show_legend,
4014
+ inherit_aes=inherit_aes,
3815
4015
  manual_key=manual_key,
3816
4016
  sampling=sampling,
3817
4017
  tooltips=tooltips,
@@ -3829,7 +4029,8 @@ def geom_ydotplot(mapping=None, *, data=None, show_legend=None, manual_key=None,
3829
4029
  **other_args)
3830
4030
 
3831
4031
 
3832
- def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
4032
+ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
4033
+ manual_key=None,
3833
4034
  sampling=None, tooltips=None,
3834
4035
  trim=None, tails_cutoff=None, kernel=None, adjust=None, bw=None, n=None, fs_max=None,
3835
4036
  min_height=None, scale=None, quantiles=None, quantile_lines=None,
@@ -3857,6 +4058,8 @@ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_
3857
4058
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
3858
4059
  show_legend : bool, default=True
3859
4060
  False - do not show legend for this layer.
4061
+ inherit_aes : bool, default=True
4062
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
3860
4063
  manual_key : str or `layer_key`
3861
4064
  The key to show in the manual legend.
3862
4065
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -3866,6 +4069,7 @@ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_
3866
4069
  tooltips : `layer_tooltips`
3867
4070
  Result of the call to the `layer_tooltips()` function.
3868
4071
  Specify appearance, style and content.
4072
+ Set tooltips='none' to hide tooltips from the layer.
3869
4073
  trim : bool, default=False
3870
4074
  Trim the tails of the ridges to the range of the data.
3871
4075
  tails_cutoff : float
@@ -3927,13 +4131,18 @@ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_
3927
4131
  - y : y-axis coordinates.
3928
4132
  - height : height of the ridge. Assumed to be between 0 and 1, though this is not required.
3929
4133
  - alpha : transparency level of a layer. Accept values between 0 and 1.
3930
- - 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").
3931
- - 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").
4134
+ - 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>`__.
4135
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
3932
4136
  - size : lines width.
3933
- - linetype : type of the line of border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
4137
+ - linetype : type of the line of border. 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>`__.
3934
4138
  - weight : used by 'densityridges' stat to compute weighted density.
3935
4139
  - quantile : quantile values to draw quantile lines and fill quantiles of the geometry by color.
3936
4140
 
4141
+ ----
4142
+
4143
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
4144
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
4145
+
3937
4146
  Examples
3938
4147
  --------
3939
4148
  .. jupyter-execute::
@@ -3993,6 +4202,7 @@ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_
3993
4202
  stat=stat,
3994
4203
  position=position,
3995
4204
  show_legend=show_legend,
4205
+ inherit_aes=inherit_aes,
3996
4206
  manual_key=manual_key,
3997
4207
  sampling=sampling,
3998
4208
  tooltips=tooltips,
@@ -4011,7 +4221,8 @@ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_
4011
4221
  **other_args)
4012
4222
 
4013
4223
 
4014
- def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
4224
+ def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
4225
+ manual_key=None, sampling=None,
4015
4226
  tooltips=None,
4016
4227
  color_by=None, fill_by=None,
4017
4228
  **other_args):
@@ -4035,6 +4246,8 @@ def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legen
4035
4246
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
4036
4247
  show_legend : bool, default=True
4037
4248
  False - do not show legend for this layer.
4249
+ inherit_aes : bool, default=True
4250
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
4038
4251
  manual_key : str or `layer_key`
4039
4252
  The key to show in the manual legend.
4040
4253
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -4044,6 +4257,7 @@ def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legen
4044
4257
  tooltips : `layer_tooltips`
4045
4258
  Result of the call to the `layer_tooltips()` function.
4046
4259
  Specify appearance, style and content.
4260
+ Set tooltips='none' to hide tooltips from the layer.
4047
4261
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
4048
4262
  Define the color aesthetic for the geometry.
4049
4263
  fill_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='fill'
@@ -4069,10 +4283,15 @@ def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legen
4069
4283
  - ymin or xmin: y-axis or x-axis coordinates of the lower bound for horizontal or vertical ribbon, respectively.
4070
4284
  - ymax or xmax: y-axis or x-axis coordinates of the upper bound for horizontal or vertical ribbon, respectively.
4071
4285
  - alpha : transparency level of a layer. Accept values between 0 and 1.
4072
- - 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").
4073
- - 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").
4286
+ - 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>`__.
4287
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
4074
4288
  - size : lines width.
4075
- - linetype : type of the line of border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
4289
+ - linetype : type of the line of border. 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>`__.
4290
+
4291
+ ----
4292
+
4293
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
4294
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
4076
4295
 
4077
4296
  Examples
4078
4297
  --------
@@ -4120,6 +4339,7 @@ def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legen
4120
4339
  stat=stat,
4121
4340
  position=position,
4122
4341
  show_legend=show_legend,
4342
+ inherit_aes=inherit_aes,
4123
4343
  manual_key=manual_key,
4124
4344
  sampling=sampling,
4125
4345
  tooltips=tooltips,
@@ -4127,8 +4347,8 @@ def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legen
4127
4347
  **other_args)
4128
4348
 
4129
4349
 
4130
- def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
4131
- tooltips=None,
4350
+ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
4351
+ manual_key=None, sampling=None, tooltips=None,
4132
4352
  flat=None, color_by=None, fill_by=None,
4133
4353
  **other_args):
4134
4354
  """
@@ -4157,6 +4377,8 @@ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=
4157
4377
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
4158
4378
  show_legend : bool, default=True
4159
4379
  False - do not show legend for this layer.
4380
+ inherit_aes : bool, default=True
4381
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
4160
4382
  manual_key : str or `layer_key`
4161
4383
  The key to show in the manual legend.
4162
4384
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -4166,6 +4388,7 @@ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=
4166
4388
  tooltips : `layer_tooltips`
4167
4389
  Result of the call to the `layer_tooltips()` function.
4168
4390
  Specify appearance, style and content.
4391
+ Set tooltips='none' to hide tooltips from the layer.
4169
4392
  flat : bool, default=False.
4170
4393
  True - keep a line straight (corresponding to a loxodrome in case of Mercator projection).
4171
4394
  False - allow a line to be reprojected, so it can become a curve.
@@ -4193,10 +4416,15 @@ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=
4193
4416
  - x : x-axis coordinates.
4194
4417
  - y : y-axis coordinates.
4195
4418
  - alpha : transparency level of a layer. Accept values between 0 and 1.
4196
- - 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").
4197
- - 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").
4419
+ - 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>`__.
4420
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
4198
4421
  - size : lines width.
4199
- - linetype : type of the line of border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
4422
+ - linetype : type of the line of border. 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>`__.
4423
+
4424
+ ----
4425
+
4426
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
4427
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
4200
4428
 
4201
4429
  Examples
4202
4430
  --------
@@ -4246,6 +4474,7 @@ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=
4246
4474
  stat=stat,
4247
4475
  position=position,
4248
4476
  show_legend=show_legend,
4477
+ inherit_aes=inherit_aes,
4249
4478
  manual_key=manual_key,
4250
4479
  sampling=sampling,
4251
4480
  tooltips=tooltips,
@@ -4254,7 +4483,8 @@ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=
4254
4483
  **other_args)
4255
4484
 
4256
4485
 
4257
- def geom_density(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
4486
+ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
4487
+ manual_key=None, sampling=None,
4258
4488
  tooltips=None,
4259
4489
  orientation=None,
4260
4490
  trim=None,
@@ -4292,6 +4522,8 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
4292
4522
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
4293
4523
  show_legend : bool, default=True
4294
4524
  False - do not show legend for this layer.
4525
+ inherit_aes : bool, default=True
4526
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
4295
4527
  manual_key : str or `layer_key`
4296
4528
  The key to show in the manual legend.
4297
4529
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -4301,6 +4533,7 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
4301
4533
  tooltips : `layer_tooltips`
4302
4534
  Result of the call to the `layer_tooltips()` function.
4303
4535
  Specify appearance, style and content.
4536
+ Set tooltips='none' to hide tooltips from the layer.
4304
4537
  orientation : str, default='x'
4305
4538
  Specify the axis that the layer's stat and geom should run along.
4306
4539
  Possible values: 'x', 'y'.
@@ -4353,13 +4586,18 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
4353
4586
 
4354
4587
  - x : x-axis coordinates.
4355
4588
  - alpha : transparency level of a layer. Accept values between 0 and 1.
4356
- - 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").
4357
- - 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").
4589
+ - 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>`__.
4590
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
4358
4591
  - size : lines width.
4359
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
4592
+ - 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>`__.
4360
4593
  - weight : used by 'density' stat to compute weighted density.
4361
4594
  - quantile : quantile values to draw quantile lines and fill quantiles of the geometry by color.
4362
4595
 
4596
+ ----
4597
+
4598
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
4599
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
4600
+
4363
4601
  Examples
4364
4602
  --------
4365
4603
  .. jupyter-execute::
@@ -4458,6 +4696,7 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
4458
4696
  stat=stat,
4459
4697
  position=position,
4460
4698
  show_legend=show_legend,
4699
+ inherit_aes=inherit_aes,
4461
4700
  manual_key=manual_key,
4462
4701
  sampling=sampling,
4463
4702
  tooltips=tooltips,
@@ -4468,8 +4707,8 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
4468
4707
  **other_args)
4469
4708
 
4470
4709
 
4471
- def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
4472
- sampling=None, tooltips=None,
4710
+ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
4711
+ manual_key=None, sampling=None, tooltips=None,
4473
4712
  kernel=None,
4474
4713
  adjust=None,
4475
4714
  bw=None,
@@ -4502,6 +4741,8 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
4502
4741
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
4503
4742
  show_legend : bool, default=True
4504
4743
  False - do not show legend for this layer.
4744
+ inherit_aes : bool, default=True
4745
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
4505
4746
  manual_key : str or `layer_key`
4506
4747
  The key to show in the manual legend.
4507
4748
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -4511,6 +4752,7 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
4511
4752
  tooltips : `layer_tooltips`
4512
4753
  Result of the call to the `layer_tooltips()` function.
4513
4754
  Specify appearance, style and content.
4755
+ Set tooltips='none' to hide tooltips from the layer.
4514
4756
  kernel : str, default='gaussian'
4515
4757
  The kernel we use to calculate the density function.
4516
4758
  Choose among 'gaussian', 'cosine', 'optcosine', 'rectangular' (or 'uniform'),
@@ -4553,13 +4795,18 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
4553
4795
  - x : x-axis coordinates.
4554
4796
  - y : y-axis coordinates.
4555
4797
  - alpha : transparency level of a layer. Accept values between 0 and 1.
4556
- - 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").
4798
+ - 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>`__.
4557
4799
  - size : lines width.
4558
- - linetype : type of the line of border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
4800
+ - linetype : type of the line of border. 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>`__.
4559
4801
  - weight : used by 'density2d' stat to compute weighted density.
4560
4802
 
4561
4803
  ----
4562
4804
 
4805
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
4806
+ to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
4807
+
4808
+ ----
4809
+
4563
4810
  'density2d' statistical transformation combined with parameter value `contour=False`
4564
4811
  could be used to draw heatmaps (see the example below).
4565
4812
 
@@ -4682,6 +4929,7 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
4682
4929
  stat=stat,
4683
4930
  position=position,
4684
4931
  show_legend=show_legend,
4932
+ inherit_aes=inherit_aes,
4685
4933
  manual_key=manual_key,
4686
4934
  sampling=sampling,
4687
4935
  tooltips=tooltips,
@@ -4690,8 +4938,8 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
4690
4938
  **other_args)
4691
4939
 
4692
4940
 
4693
- def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
4694
- sampling=None,
4941
+ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
4942
+ manual_key=None, sampling=None,
4695
4943
  tooltips=None,
4696
4944
  kernel=None,
4697
4945
  adjust=None,
@@ -4725,6 +4973,8 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
4725
4973
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
4726
4974
  show_legend : bool, default=True
4727
4975
  False - do not show legend for this layer.
4976
+ inherit_aes : bool, default=True
4977
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
4728
4978
  manual_key : str or `layer_key`
4729
4979
  The key to show in the manual legend.
4730
4980
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -4734,6 +4984,7 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
4734
4984
  tooltips : `layer_tooltips`
4735
4985
  Result of the call to the `layer_tooltips()` function.
4736
4986
  Specify appearance, style and content.
4987
+ Set tooltips='none' to hide tooltips from the layer.
4737
4988
  kernel : str, default='gaussian'
4738
4989
  The kernel we use to calculate the density function.
4739
4990
  Choose among 'gaussian', 'cosine', 'optcosine', 'rectangular' (or 'uniform'),
@@ -4777,7 +5028,7 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
4777
5028
 
4778
5029
  - x : x-axis coordinates.
4779
5030
  - alpha : transparency level of a layer. Accept values between 0 and 1.
4780
- - 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").
5031
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
4781
5032
  - weight : used by 'density2df' stat to compute weighted density.
4782
5033
 
4783
5034
  ----
@@ -4799,7 +5050,7 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
4799
5050
  x = np.random.normal(size=n)
4800
5051
  y = np.random.normal(size=n)
4801
5052
  ggplot({'x': x, 'y': y}, aes(x='x', y='y')) + \\
4802
- geom_density2df()
5053
+ geom_density2df(aes(fill='..level..'))
4803
5054
 
4804
5055
  |
4805
5056
 
@@ -4907,6 +5158,7 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
4907
5158
  stat=stat,
4908
5159
  position=position,
4909
5160
  show_legend=show_legend,
5161
+ inherit_aes=inherit_aes,
4910
5162
  manual_key=manual_key,
4911
5163
  sampling=sampling,
4912
5164
  tooltips=tooltips,
@@ -4919,7 +5171,8 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
4919
5171
  **other_args)
4920
5172
 
4921
5173
 
4922
- def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
5174
+ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
5175
+ manual_key=None, sampling=None,
4923
5176
  tooltips=None,
4924
5177
  width=None, height=None,
4925
5178
  color_by=None, fill_by=None,
@@ -4950,6 +5203,8 @@ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legen
4950
5203
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
4951
5204
  show_legend : bool, default=True
4952
5205
  False - do not show legend for this layer.
5206
+ inherit_aes : bool, default=True
5207
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
4953
5208
  manual_key : str or `layer_key`
4954
5209
  The key to show in the manual legend.
4955
5210
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -4959,6 +5214,7 @@ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legen
4959
5214
  tooltips : `layer_tooltips`
4960
5215
  Result of the call to the `layer_tooltips()` function.
4961
5216
  Specify appearance, style and content.
5217
+ Set tooltips='none' to hide tooltips from the layer.
4962
5218
  width : float, default=0.4
4963
5219
  Amount of horizontal variation. The jitter is added in both directions, so the total spread is twice the specified parameter.
4964
5220
  Typically ranges between 0 and 0.5. Values that are greater than 0.5 lead to overlapping of the points.
@@ -4993,12 +5249,17 @@ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legen
4993
5249
  - x : x-axis value.
4994
5250
  - y : y-axis value.
4995
5251
  - alpha : transparency level of a point. Accept values between 0 and 1.
4996
- - 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").
4997
- - 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").
4998
- - shape : shape of the point, an integer from 0 to 25.
5252
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
5253
+ - fill : fill color. Is applied only to the points of shapes having inner area. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
5254
+ - shape : shape of the point, an integer from 0 to 25. For more info see `Point Shapes <https://lets-plot.org/python/pages/aesthetics.html#point-shapes>`__.
4999
5255
  - size : size of the point.
5000
5256
  - stroke : width of the shape border. Applied only to the shapes having border.
5001
5257
 
5258
+ ----
5259
+
5260
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
5261
+ to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
5262
+
5002
5263
  Examples
5003
5264
  --------
5004
5265
  .. jupyter-execute::
@@ -5043,6 +5304,7 @@ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legen
5043
5304
  stat=stat,
5044
5305
  position=position,
5045
5306
  show_legend=show_legend,
5307
+ inherit_aes=inherit_aes,
5046
5308
  manual_key=manual_key,
5047
5309
  sampling=sampling,
5048
5310
  tooltips=tooltips,
@@ -5052,7 +5314,8 @@ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legen
5052
5314
  **other_args)
5053
5315
 
5054
5316
 
5055
- def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
5317
+ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
5318
+ manual_key=None, sampling=None,
5056
5319
  tooltips=None,
5057
5320
  distribution=None,
5058
5321
  dparams=None,
@@ -5084,6 +5347,8 @@ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=No
5084
5347
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5085
5348
  show_legend : bool, default=True
5086
5349
  False - do not show legend for this layer.
5350
+ inherit_aes : bool, default=True
5351
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
5087
5352
  manual_key : str or `layer_key`
5088
5353
  The key to show in the manual legend.
5089
5354
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -5093,6 +5358,7 @@ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=No
5093
5358
  tooltips : `layer_tooltips`
5094
5359
  Result of the call to the `layer_tooltips()` function.
5095
5360
  Specify appearance, style and content.
5361
+ Set tooltips='none' to hide tooltips from the layer.
5096
5362
  distribution : {'norm', 'uniform', 't', 'gamma', 'exp', 'chi2'}, default='norm'
5097
5363
  Distribution function to use.
5098
5364
  dparams : list
@@ -5135,12 +5401,17 @@ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=No
5135
5401
 
5136
5402
  - sample : y-axis value.
5137
5403
  - alpha : transparency level of a point. Accept values between 0 and 1.
5138
- - 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").
5139
- - 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").
5140
- - shape : shape of the point, an integer from 0 to 25.
5404
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
5405
+ - fill : fill color. Is applied only to the points of shapes having inner area. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
5406
+ - shape : shape of the point, an integer from 0 to 25. For more info see `Point Shapes <https://lets-plot.org/python/pages/aesthetics.html#point-shapes>`__.
5141
5407
  - size : size of the point.
5142
5408
  - stroke : width of the shape border. Applied only to the shapes having border.
5143
5409
 
5410
+ ----
5411
+
5412
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
5413
+ to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
5414
+
5144
5415
  Examples
5145
5416
  --------
5146
5417
  .. jupyter-execute::
@@ -5177,6 +5448,7 @@ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=No
5177
5448
  stat=stat,
5178
5449
  position=position,
5179
5450
  show_legend=show_legend,
5451
+ inherit_aes=inherit_aes,
5180
5452
  manual_key=manual_key,
5181
5453
  sampling=sampling,
5182
5454
  tooltips=tooltips,
@@ -5186,7 +5458,8 @@ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=No
5186
5458
  **other_args)
5187
5459
 
5188
5460
 
5189
- def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
5461
+ def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
5462
+ manual_key=None, sampling=None,
5190
5463
  tooltips=None,
5191
5464
  color_by=None, fill_by=None,
5192
5465
  **other_args):
@@ -5216,6 +5489,8 @@ def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=N
5216
5489
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5217
5490
  show_legend : bool, default=True
5218
5491
  False - do not show legend for this layer.
5492
+ inherit_aes : bool, default=True
5493
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
5219
5494
  manual_key : str or `layer_key`
5220
5495
  The key to show in the manual legend.
5221
5496
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -5225,6 +5500,7 @@ def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=N
5225
5500
  tooltips : `layer_tooltips`
5226
5501
  Result of the call to the `layer_tooltips()` function.
5227
5502
  Specify appearance, style and content.
5503
+ Set tooltips='none' to hide tooltips from the layer.
5228
5504
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
5229
5505
  Define the color aesthetic for the geometry.
5230
5506
  fill_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='fill'
@@ -5256,12 +5532,17 @@ def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=N
5256
5532
  - x : x-axis value.
5257
5533
  - y : y-axis value.
5258
5534
  - alpha : transparency level of a point. Accept values between 0 and 1.
5259
- - 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").
5260
- - 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").
5261
- - shape : shape of the point, an integer from 0 to 25.
5535
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
5536
+ - fill : fill color. Is applied only to the points of shapes having inner area. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
5537
+ - shape : shape of the point, an integer from 0 to 25. For more info see `Point Shapes <https://lets-plot.org/python/pages/aesthetics.html#point-shapes>`__.
5262
5538
  - size : size of the point.
5263
5539
  - stroke : width of the shape border. Applied only to the shapes having border.
5264
5540
 
5541
+ ----
5542
+
5543
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
5544
+ to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
5545
+
5265
5546
  Examples
5266
5547
  --------
5267
5548
  .. jupyter-execute::
@@ -5284,6 +5565,7 @@ def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=N
5284
5565
  stat=stat,
5285
5566
  position=position,
5286
5567
  show_legend=show_legend,
5568
+ inherit_aes=inherit_aes,
5287
5569
  manual_key=manual_key,
5288
5570
  sampling=sampling,
5289
5571
  tooltips=tooltips,
@@ -5291,7 +5573,8 @@ def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=N
5291
5573
  **other_args)
5292
5574
 
5293
5575
 
5294
- def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
5576
+ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
5577
+ manual_key=None, sampling=None,
5295
5578
  tooltips=None,
5296
5579
  distribution=None,
5297
5580
  dparams=None,
@@ -5324,6 +5607,8 @@ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_lege
5324
5607
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5325
5608
  show_legend : bool, default=True
5326
5609
  False - do not show legend for this layer.
5610
+ inherit_aes : bool, default=True
5611
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
5327
5612
  manual_key : str or `layer_key`
5328
5613
  The key to show in the manual legend.
5329
5614
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -5333,6 +5618,7 @@ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_lege
5333
5618
  tooltips : `layer_tooltips`
5334
5619
  Result of the call to the `layer_tooltips()` function.
5335
5620
  Specify appearance, style and content.
5621
+ Set tooltips='none' to hide tooltips from the layer.
5336
5622
  distribution : {'norm', 'uniform', 't', 'gamma', 'exp', 'chi2'}, default='norm'
5337
5623
  Distribution function to use.
5338
5624
  dparams : list
@@ -5372,8 +5658,8 @@ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_lege
5372
5658
 
5373
5659
  - sample : y-axis value.
5374
5660
  - alpha : transparency level of a layer. Accept values between 0 and 1.
5375
- - 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").
5376
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
5661
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
5662
+ - 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>`__.
5377
5663
  - size : line width.
5378
5664
 
5379
5665
  Examples
@@ -5413,6 +5699,7 @@ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_lege
5413
5699
  stat=stat,
5414
5700
  position=position,
5415
5701
  show_legend=show_legend,
5702
+ inherit_aes=inherit_aes,
5416
5703
  manual_key=manual_key,
5417
5704
  sampling=sampling,
5418
5705
  tooltips=tooltips,
@@ -5423,7 +5710,8 @@ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_lege
5423
5710
  **other_args)
5424
5711
 
5425
5712
 
5426
- def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
5713
+ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
5714
+ manual_key=None,
5427
5715
  sampling=None, tooltips=None,
5428
5716
  quantiles=None,
5429
5717
  color_by=None,
@@ -5454,6 +5742,8 @@ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_leg
5454
5742
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5455
5743
  show_legend : bool, default=True
5456
5744
  False - do not show legend for this layer.
5745
+ inherit_aes : bool, default=True
5746
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
5457
5747
  manual_key : str or `layer_key`
5458
5748
  The key to show in the manual legend.
5459
5749
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -5463,6 +5753,7 @@ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_leg
5463
5753
  tooltips : `layer_tooltips`
5464
5754
  Result of the call to the `layer_tooltips()` function.
5465
5755
  Specify appearance, style and content.
5756
+ Set tooltips='none' to hide tooltips from the layer.
5466
5757
  quantiles : list, default=[0.25, 0.75]
5467
5758
  Pair of quantiles to use when fitting the Q-Q line.
5468
5759
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
@@ -5488,8 +5779,8 @@ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_leg
5488
5779
  - x : x-axis value.
5489
5780
  - y : y-axis value.
5490
5781
  - alpha : transparency level of a layer. Accept values between 0 and 1.
5491
- - 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").
5492
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
5782
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
5783
+ - 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>`__.
5493
5784
  - size : line width.
5494
5785
 
5495
5786
  Examples
@@ -5514,6 +5805,7 @@ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_leg
5514
5805
  stat=stat,
5515
5806
  position=position,
5516
5807
  show_legend=show_legend,
5808
+ inherit_aes=inherit_aes,
5517
5809
  manual_key=manual_key,
5518
5810
  sampling=sampling,
5519
5811
  tooltips=tooltips,
@@ -5522,8 +5814,8 @@ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_leg
5522
5814
  **other_args)
5523
5815
 
5524
5816
 
5525
- def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
5526
- sampling=None, tooltips=None,
5817
+ def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
5818
+ manual_key=None, sampling=None, tooltips=None,
5527
5819
  orientation=None,
5528
5820
  color_by=None,
5529
5821
  **other_args):
@@ -5553,6 +5845,8 @@ def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_leg
5553
5845
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5554
5846
  show_legend : bool, default=True
5555
5847
  False - do not show legend for this layer.
5848
+ inherit_aes : bool, default=True
5849
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
5556
5850
  manual_key : str or `layer_key`
5557
5851
  The key to show in the manual legend.
5558
5852
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -5562,6 +5856,7 @@ def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_leg
5562
5856
  tooltips : `layer_tooltips`
5563
5857
  Result of the call to the `layer_tooltips()` function.
5564
5858
  Specify appearance, style and content.
5859
+ Set tooltips='none' to hide tooltips from the layer.
5565
5860
  orientation : str, default='x'
5566
5861
  Specify the axis that the layer's stat and geom should run along.
5567
5862
  Possible values: 'x', 'y'.
@@ -5591,9 +5886,14 @@ def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_leg
5591
5886
  - x : x-axis value.
5592
5887
  - y : y-axis value.
5593
5888
  - alpha : transparency level of a layer. Accept values between 0 and 1.
5594
- - 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").
5889
+ - 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>`__.
5595
5890
  - size : lines width.
5596
- - linetype : type of the line of border. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
5891
+ - linetype : type of the line of border. 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>`__.
5892
+
5893
+ ----
5894
+
5895
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
5896
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
5597
5897
 
5598
5898
  Examples
5599
5899
  --------
@@ -5634,6 +5934,7 @@ def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_leg
5634
5934
  stat=stat,
5635
5935
  position=position,
5636
5936
  show_legend=show_legend,
5937
+ inherit_aes=inherit_aes,
5637
5938
  manual_key=manual_key,
5638
5939
  sampling=sampling,
5639
5940
  tooltips=tooltips,
@@ -5642,7 +5943,8 @@ def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_leg
5642
5943
  **other_args)
5643
5944
 
5644
5945
 
5645
- def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
5946
+ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
5947
+ manual_key=None, sampling=None,
5646
5948
  tooltips=None,
5647
5949
  direction=None,
5648
5950
  color_by=None,
@@ -5672,6 +5974,8 @@ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=
5672
5974
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5673
5975
  show_legend : bool, default=True
5674
5976
  False - do not show legend for this layer.
5977
+ inherit_aes : bool, default=True
5978
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
5675
5979
  manual_key : str or `layer_key`
5676
5980
  The key to show in the manual legend.
5677
5981
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -5681,6 +5985,7 @@ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=
5681
5985
  tooltips : `layer_tooltips`
5682
5986
  Result of the call to the `layer_tooltips()` function.
5683
5987
  Specify appearance, style and content.
5988
+ Set tooltips='none' to hide tooltips from the layer.
5684
5989
  direction : {'hv', 'vh'}, default='hv'
5685
5990
  'hv' or 'HV' stands for horizontal then vertical;
5686
5991
  'vh' or 'VH' stands for vertical then horizontal.
@@ -5706,9 +6011,14 @@ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=
5706
6011
  - x : x-axis value.
5707
6012
  - y : y-axis value.
5708
6013
  - alpha : transparency level of a layer. Accept values between 0 and 1.
5709
- - 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").
6014
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
5710
6015
  - size : line width.
5711
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
6016
+ - 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>`__.
6017
+
6018
+ ----
6019
+
6020
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
6021
+ to the `axis_tooltip` or `axis_tooltip_x` parameter of the `theme()`.
5712
6022
 
5713
6023
  Examples
5714
6024
  --------
@@ -5751,6 +6061,7 @@ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=
5751
6061
  stat=stat,
5752
6062
  position=position,
5753
6063
  show_legend=show_legend,
6064
+ inherit_aes=inherit_aes,
5754
6065
  manual_key=manual_key,
5755
6066
  sampling=sampling,
5756
6067
  tooltips=tooltips,
@@ -5759,7 +6070,8 @@ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=
5759
6070
  **other_args)
5760
6071
 
5761
6072
 
5762
- def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
6073
+ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
6074
+ manual_key=None, sampling=None,
5763
6075
  tooltips=None,
5764
6076
  map=None, map_join=None, use_crs=None,
5765
6077
  color_by=None, fill_by=None,
@@ -5784,6 +6096,8 @@ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=
5784
6096
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5785
6097
  show_legend : bool, default=True
5786
6098
  False - do not show legend for this layer.
6099
+ inherit_aes : bool, default=True
6100
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
5787
6101
  manual_key : str or `layer_key`
5788
6102
  The key to show in the manual legend.
5789
6103
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -5793,6 +6107,7 @@ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=
5793
6107
  tooltips : `layer_tooltips`
5794
6108
  Result of the call to the `layer_tooltips()` function.
5795
6109
  Specify appearance, style and content.
6110
+ Set tooltips='none' to hide tooltips from the layer.
5796
6111
  map : `GeoDataFrame` or `Geocoder`
5797
6112
  Bounding boxes of geometries will be drawn.
5798
6113
  map_join : str or list
@@ -5830,10 +6145,10 @@ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=
5830
6145
  - ymin : y-axis value.
5831
6146
  - ymax : y-axis value.
5832
6147
  - alpha : transparency level of a layer. Accept values between 0 and 1.
5833
- - 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").
5834
- - 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").
6148
+ - 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>`__.
6149
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
5835
6150
  - size : lines width.
5836
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
6151
+ - 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>`__.
5837
6152
 
5838
6153
  ----
5839
6154
 
@@ -5922,6 +6237,7 @@ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=
5922
6237
  stat=stat,
5923
6238
  position=position,
5924
6239
  show_legend=show_legend,
6240
+ inherit_aes=inherit_aes,
5925
6241
  manual_key=manual_key,
5926
6242
  sampling=sampling,
5927
6243
  tooltips=tooltips,
@@ -5930,7 +6246,8 @@ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=
5930
6246
  **other_args)
5931
6247
 
5932
6248
 
5933
- def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
6249
+ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
6250
+ manual_key=None, sampling=None,
5934
6251
  tooltips=None,
5935
6252
  arrow=None, flat=None, geodesic=None, spacer=None, color_by=None, **other_args):
5936
6253
  """
@@ -5958,6 +6275,8 @@ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_lege
5958
6275
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5959
6276
  show_legend : bool, default=True
5960
6277
  False - do not show legend for this layer.
6278
+ inherit_aes : bool, default=True
6279
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
5961
6280
  manual_key : str or `layer_key`
5962
6281
  The key to show in the manual legend.
5963
6282
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -5967,6 +6286,7 @@ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_lege
5967
6286
  tooltips : `layer_tooltips`
5968
6287
  Result of the call to the `layer_tooltips()` function.
5969
6288
  Specify appearance, style and content.
6289
+ Set tooltips='none' to hide tooltips from the layer.
5970
6290
  arrow : `FeatureSpec`
5971
6291
  Specification for arrow head, as created by `arrow()` function.
5972
6292
  flat : bool, default=False.
@@ -6000,9 +6320,9 @@ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_lege
6000
6320
  - xend : x-axis value.
6001
6321
  - yend : y-axis value.
6002
6322
  - alpha : transparency level of a layer. Accept values between 0 and 1.
6003
- - 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").
6323
+ - 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>`__.
6004
6324
  - size : line width.
6005
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
6325
+ - 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>`__.
6006
6326
  - 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).
6007
6327
  - 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).
6008
6328
  - 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).
@@ -6073,6 +6393,7 @@ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_lege
6073
6393
  stat=stat,
6074
6394
  position=position,
6075
6395
  show_legend=show_legend,
6396
+ inherit_aes=inherit_aes,
6076
6397
  manual_key=manual_key,
6077
6398
  sampling=sampling,
6078
6399
  tooltips=tooltips,
@@ -6084,7 +6405,8 @@ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_lege
6084
6405
  **other_args)
6085
6406
 
6086
6407
 
6087
- def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
6408
+ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
6409
+ manual_key=None, sampling=None,
6088
6410
  tooltips=None,
6089
6411
  arrow=None,
6090
6412
  curvature=None, angle=None, ncp=None,
@@ -6115,6 +6437,8 @@ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend
6115
6437
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
6116
6438
  show_legend : bool, default=True
6117
6439
  False - do not show legend for this layer.
6440
+ inherit_aes : bool, default=True
6441
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
6118
6442
  manual_key : str or `layer_key`
6119
6443
  The key to show in the manual legend.
6120
6444
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -6124,6 +6448,7 @@ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend
6124
6448
  tooltips : `layer_tooltips`
6125
6449
  Result of the call to the `layer_tooltips()` function.
6126
6450
  Specify appearance, style and content.
6451
+ Set tooltips='none' to hide tooltips from the layer.
6127
6452
  arrow : `FeatureSpec`
6128
6453
  Specification for arrow head, as created by `arrow()` function.
6129
6454
  curvature : float, default=0.5
@@ -6162,9 +6487,9 @@ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend
6162
6487
  - xend : x-axis value.
6163
6488
  - yend : y-axis value.
6164
6489
  - alpha : transparency level of a layer. Accept values between 0 and 1.
6165
- - 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").
6490
+ - 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>`__.
6166
6491
  - size : line width.
6167
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
6492
+ - 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>`__.
6168
6493
  - 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).
6169
6494
  - 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).
6170
6495
  - 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).
@@ -6231,6 +6556,7 @@ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend
6231
6556
  stat=stat,
6232
6557
  position=position,
6233
6558
  show_legend=show_legend,
6559
+ inherit_aes=inherit_aes,
6234
6560
  manual_key=manual_key,
6235
6561
  sampling=sampling,
6236
6562
  tooltips=tooltips,
@@ -6241,7 +6567,8 @@ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend
6241
6567
  **other_args)
6242
6568
 
6243
6569
 
6244
- def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, manual_key=None, sampling=None,
6570
+ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, inherit_aes=None,
6571
+ manual_key=None, sampling=None,
6245
6572
  tooltips=None,
6246
6573
  arrow=None, pivot=None,
6247
6574
  color_by=None, **other_args):
@@ -6263,6 +6590,8 @@ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, manu
6263
6590
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
6264
6591
  show_legend : bool, default=True
6265
6592
  False - do not show legend for this layer.
6593
+ inherit_aes : bool, default=True
6594
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
6266
6595
  manual_key : str or `layer_key`
6267
6596
  The key to show in the manual legend.
6268
6597
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -6272,6 +6601,7 @@ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, manu
6272
6601
  tooltips : `layer_tooltips`
6273
6602
  Result of the call to the `layer_tooltips()` function.
6274
6603
  Specify appearance, style and content.
6604
+ Set tooltips='none' to hide tooltips from the layer.
6275
6605
  arrow : `FeatureSpec`
6276
6606
  Specification for arrow head, as created by `arrow()` function.
6277
6607
  pivot : {'tail', 'middle', 'mid', 'tip'}, default='tail'
@@ -6298,9 +6628,9 @@ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, manu
6298
6628
  - angle : slope's angle in radians.
6299
6629
  - radius : segment length.
6300
6630
  - alpha : transparency level of a layer. Accept values between 0 and 1.
6301
- - 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").
6631
+ - color (colour) : color of the line. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
6302
6632
  - size : line width.
6303
- - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
6633
+ - 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>`__.
6304
6634
 
6305
6635
  Examples
6306
6636
  --------
@@ -6365,6 +6695,7 @@ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, manu
6365
6695
  stat=None,
6366
6696
  position=position,
6367
6697
  show_legend=show_legend,
6698
+ inherit_aes=inherit_aes,
6368
6699
  manual_key=manual_key,
6369
6700
  sampling=sampling,
6370
6701
  tooltips=tooltips,
@@ -6374,13 +6705,15 @@ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, manu
6374
6705
  **other_args)
6375
6706
 
6376
6707
 
6377
- def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
6708
+ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
6709
+ manual_key=None, sampling=None,
6378
6710
  tooltips=None,
6379
6711
  map=None, map_join=None, use_crs=None,
6380
6712
  label_format=None,
6381
6713
  na_text=None,
6382
6714
  nudge_x=None, nudge_y=None,
6383
6715
  size_unit=None,
6716
+ check_overlap=None,
6384
6717
  color_by=None,
6385
6718
  **other_args):
6386
6719
  """
@@ -6408,6 +6741,8 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
6408
6741
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
6409
6742
  show_legend : bool, default=True
6410
6743
  False - do not show legend for this layer.
6744
+ inherit_aes : bool, default=True
6745
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
6411
6746
  manual_key : str or `layer_key`
6412
6747
  The key to show in the manual legend.
6413
6748
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -6417,6 +6752,7 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
6417
6752
  tooltips : `layer_tooltips`
6418
6753
  Result of the call to the `layer_tooltips()` function.
6419
6754
  Specify appearance, style and content.
6755
+ Set tooltips='none' to hide tooltips from the layer.
6420
6756
  map : `GeoDataFrame` or `Geocoder`
6421
6757
  Data containing coordinates of points.
6422
6758
  map_join : str or list
@@ -6436,7 +6772,7 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
6436
6772
  - 'Num {}' -> 'Num 12.456789'
6437
6773
  - 'TTL: {.2f}$' -> 'TTL: 12.45$'
6438
6774
 
6439
- For more info see https://lets-plot.org/python/pages/formats.html.
6775
+ For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
6440
6776
  na_text : str, default='n/a'
6441
6777
  Text to show for missing values.
6442
6778
  nudge_x : float
@@ -6446,6 +6782,8 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
6446
6782
  size_unit : {'x', 'y'}
6447
6783
  Relate the size of the text to the length of the unit step along one of the axes.
6448
6784
  If None, no fitting is performed.
6785
+ check_overlap : bool, default=False
6786
+ If True, skip plotting text that overlaps previous text in the same layer.
6449
6787
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
6450
6788
  Define the color aesthetic for the geometry.
6451
6789
  other_args
@@ -6468,11 +6806,11 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
6468
6806
  - x : x-axis value.
6469
6807
  - y : y-axis value.
6470
6808
  - alpha : transparency level of a layer. Accept values between 0 and 1.
6471
- - 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").
6809
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
6472
6810
  - size : font size.
6473
6811
  - label : text to add to plot.
6474
- - family : font family. Possible values: 'sans', 'serif', 'mono', any other like: "Times New Roman". The default is 'sans'.
6475
- - fontface : font style and weight. Possible values: 'plain', 'bold', 'italic', 'bold italic'. The default is 'plain'.
6812
+ - family : font family. For more info see `Text <https://lets-plot.org/python/pages/aesthetics.html#text>`__.
6813
+ - fontface : font style and weight. For more info see `Text <https://lets-plot.org/python/pages/aesthetics.html#text>`__.
6476
6814
  - hjust : horizontal text alignment. Possible values: 'left', 'middle', 'right' or number between 0 ('left') and 1 ('right'). There are two special alignments: 'inward' (aligns text towards the plot center) and 'outward' (away from the plot center).
6477
6815
  - vjust : vertical text alignment. Possible values: 'bottom', 'center', 'top' or number between 0 ('bottom') and 1 ('top'). There are two special alignments: 'inward' (aligns text towards the plot center) and 'outward' (away from the plot center).
6478
6816
  - angle : text rotation angle in degrees.
@@ -6587,6 +6925,7 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
6587
6925
  stat=stat,
6588
6926
  position=position,
6589
6927
  show_legend=show_legend,
6928
+ inherit_aes=inherit_aes,
6590
6929
  manual_key=manual_key,
6591
6930
  sampling=sampling,
6592
6931
  tooltips=tooltips,
@@ -6595,11 +6934,13 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
6595
6934
  na_text=na_text,
6596
6935
  nudge_x=nudge_x, nudge_y=nudge_y,
6597
6936
  size_unit=size_unit,
6937
+ check_overlap=check_overlap,
6598
6938
  color_by=color_by,
6599
6939
  **other_args)
6600
6940
 
6601
6941
 
6602
- def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
6942
+ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
6943
+ manual_key=None, sampling=None,
6603
6944
  tooltips=None,
6604
6945
  map=None, map_join=None, use_crs=None,
6605
6946
  label_format=None,
@@ -6608,6 +6949,7 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
6608
6949
  label_padding=None, label_r=None, label_size=None,
6609
6950
  alpha_stroke=None,
6610
6951
  size_unit=None,
6952
+ check_overlap=None,
6611
6953
  color_by=None, fill_by=None,
6612
6954
  **other_args):
6613
6955
  """
@@ -6635,6 +6977,8 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
6635
6977
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
6636
6978
  show_legend : bool, default=True
6637
6979
  False - do not show legend for this layer.
6980
+ inherit_aes : bool, default=True
6981
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
6638
6982
  manual_key : str or `layer_key`
6639
6983
  The key to show in the manual legend.
6640
6984
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -6644,6 +6988,7 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
6644
6988
  tooltips : `layer_tooltips`
6645
6989
  Result of the call to the `layer_tooltips()` function.
6646
6990
  Specify appearance, style and content.
6991
+ Set tooltips='none' to hide tooltips from the layer.
6647
6992
  map : `GeoDataFrame` or `Geocoder`
6648
6993
  Data containing coordinates of points.
6649
6994
  map_join : str or list
@@ -6663,7 +7008,7 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
6663
7008
  - 'Num {}' -> 'Num 12.456789'
6664
7009
  - 'TTL: {.2f}$' -> 'TTL: 12.45$'
6665
7010
 
6666
- For more info see https://lets-plot.org/python/pages/formats.html.
7011
+ For more info see `Formatting <https://lets-plot.org/python/pages/formats.html>`__.
6667
7012
  nudge_x : float
6668
7013
  Horizontal adjustment to nudge labels by.
6669
7014
  nudge_y : float
@@ -6681,6 +7026,8 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
6681
7026
  size_unit : {'x', 'y'}
6682
7027
  Relate the size of the text label to the length of the unit step along one of the axes.
6683
7028
  If None, no fitting is performed.
7029
+ check_overlap : bool, default=False
7030
+ If True, skip plotting text that overlaps previous text in the same layer.
6684
7031
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
6685
7032
  Define the color aesthetic for the geometry.
6686
7033
  fill_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='fill'
@@ -6705,12 +7052,12 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
6705
7052
  - x : x-axis value.
6706
7053
  - y : y-axis value.
6707
7054
  - alpha : transparency level of a layer. Accept values between 0 and 1.
6708
- - 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").
7055
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
6709
7056
  - fill: background color of the label.
6710
7057
  - size : font size.
6711
7058
  - label : text to add to plot.
6712
- - family : font family. Possible values: 'sans', 'serif', 'mono', any other like: "Times New Roman". The default is 'sans'.
6713
- - fontface : font style and weight. Possible values: 'plain', 'bold', 'italic', 'bold italic'. The default is 'plain'.
7059
+ - family : font family. For more info see `Text <https://lets-plot.org/python/pages/aesthetics.html#text>`__.
7060
+ - fontface : font style and weight. For more info see `Text <https://lets-plot.org/python/pages/aesthetics.html#text>`__.
6714
7061
  - hjust : horizontal alignment. Possible values: 'left', 'middle', 'right' or number between 0 ('left') and 1 ('right'). There are two special alignments: 'inward' (aligns label towards the plot center) and 'outward' (away from the plot center).
6715
7062
  - vjust : vertical alignment. Possible values: 'bottom', 'center', 'top' or number between 0 ('bottom') and 1 ('top'). There are two special alignments: 'inward' (aligns label towards the plot center) and 'outward' (away from the plot center).
6716
7063
  - angle : rotation angle in degrees.
@@ -6826,6 +7173,7 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
6826
7173
  stat=stat,
6827
7174
  position=position,
6828
7175
  show_legend=show_legend,
7176
+ inherit_aes=inherit_aes,
6829
7177
  manual_key=manual_key,
6830
7178
  sampling=sampling,
6831
7179
  tooltips=tooltips,
@@ -6838,11 +7186,13 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
6838
7186
  label_size=label_size,
6839
7187
  alpha_stroke=alpha_stroke,
6840
7188
  size_unit=size_unit,
7189
+ check_overlap=check_overlap,
6841
7190
  color_by=color_by, fill_by=fill_by,
6842
7191
  **other_args)
6843
7192
 
6844
7193
 
6845
- def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
7194
+ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
7195
+ manual_key=None, sampling=None,
6846
7196
  tooltips=None, labels=None,
6847
7197
  map=None, map_join=None, use_crs=None,
6848
7198
  hole=None,
@@ -6873,6 +7223,8 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
6873
7223
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
6874
7224
  show_legend : bool, default=True
6875
7225
  False - do not show legend for this layer.
7226
+ inherit_aes : bool, default=True
7227
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
6876
7228
  manual_key : str or `layer_key`
6877
7229
  The key to show in the manual legend.
6878
7230
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -6882,6 +7234,7 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
6882
7234
  tooltips : `layer_tooltips`
6883
7235
  Result of the call to the `layer_tooltips()` function.
6884
7236
  Specify appearance, style and content.
7237
+ Set tooltips='none' to hide tooltips from the layer.
6885
7238
  labels : `layer_labels`
6886
7239
  Result of the call to the `layer_labels()` function.
6887
7240
  Specify style and content of the annotations.
@@ -6942,7 +7295,7 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
6942
7295
  - slice : values associated to pie sectors.
6943
7296
  - explode : values to explode slices away from their center point, detaching it from the main pie. Accept values between 0 and 1.
6944
7297
  - size : pie diameter.
6945
- - 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").
7298
+ - fill : fill color. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
6946
7299
  - alpha : transparency level of the pie. Accept values between 0 and 1.
6947
7300
  - weight : used by 'count2d' stat to compute weighted sum instead of simple count.
6948
7301
  - stroke : width of inner and outer arcs of pie sector.
@@ -6978,6 +7331,11 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
6978
7331
 
6979
7332
  - map_join=['County_name', 'State_Name']
6980
7333
 
7334
+ ----
7335
+
7336
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
7337
+ to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
7338
+
6981
7339
  Examples
6982
7340
  --------
6983
7341
  .. jupyter-execute::
@@ -7070,6 +7428,7 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
7070
7428
  stat=stat,
7071
7429
  position=position,
7072
7430
  show_legend=show_legend,
7431
+ inherit_aes=inherit_aes,
7073
7432
  manual_key=manual_key,
7074
7433
  sampling=sampling,
7075
7434
  tooltips=tooltips,
@@ -7084,8 +7443,8 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
7084
7443
  **other_args)
7085
7444
 
7086
7445
 
7087
- def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
7088
- sampling=None, tooltips=None,
7446
+ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
7447
+ manual_key=None, sampling=None, tooltips=None,
7089
7448
  orientation=None,
7090
7449
  dir=None, fatten=None, slope=None, intercept=None,
7091
7450
  color_by=None, fill_by=None,
@@ -7115,6 +7474,8 @@ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_leg
7115
7474
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
7116
7475
  show_legend : bool, default=True
7117
7476
  False - do not show legend for this layer.
7477
+ inherit_aes : bool, default=True
7478
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
7118
7479
  manual_key : str or `layer_key`
7119
7480
  The key to show in the manual legend.
7120
7481
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -7124,6 +7485,7 @@ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_leg
7124
7485
  tooltips : `layer_tooltips`
7125
7486
  Result of the call to the `layer_tooltips()` function.
7126
7487
  Specify appearance, style and content.
7488
+ Set tooltips='none' to hide tooltips from the layer.
7127
7489
  orientation : str
7128
7490
  Specify the axis that the layer's stat and geom should run along.
7129
7491
  The default value (None) automatically determines the orientation based on the aesthetic mapping.
@@ -7159,19 +7521,24 @@ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_leg
7159
7521
  - x : x-axis value.
7160
7522
  - y : y-axis value.
7161
7523
  - alpha : transparency level of the point. Accept values between 0 and 1.
7162
- - 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").
7163
- - 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").
7164
- - shape : shape of the point, an integer from 0 to 25.
7524
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
7525
+ - fill : fill color. Is applied only to the points of shapes having inner area. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
7526
+ - shape : shape of the point, an integer from 0 to 25. For more info see `Point Shapes <https://lets-plot.org/python/pages/aesthetics.html#point-shapes>`__.
7165
7527
  - size : size of the point.
7166
7528
  - stroke : width of the shape border. Applied only to the shapes having border.
7167
7529
  - linewidth : stick width.
7168
- - linetype : type of the stick line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
7530
+ - linetype : type of the stick 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>`__.
7169
7531
 
7170
7532
  ----
7171
7533
 
7172
7534
  When `slope=0`, the baseline cannot be parallel to the lollipop sticks.
7173
7535
  So, in this case, if `dir='h'`, the baseline will becomes vertical, as for infinity slope.
7174
7536
 
7537
+ ----
7538
+
7539
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
7540
+ to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
7541
+
7175
7542
  Examples
7176
7543
  --------
7177
7544
  .. jupyter-execute::
@@ -7228,6 +7595,7 @@ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_leg
7228
7595
  stat=stat,
7229
7596
  position=position,
7230
7597
  show_legend=show_legend,
7598
+ inherit_aes=inherit_aes,
7231
7599
  manual_key=manual_key,
7232
7600
  sampling=sampling,
7233
7601
  tooltips=tooltips,
@@ -7237,7 +7605,8 @@ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_leg
7237
7605
  **other_args)
7238
7606
 
7239
7607
 
7240
- def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
7608
+ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=None,
7609
+ manual_key=None, sampling=None,
7241
7610
  tooltips=None,
7242
7611
  color_by=None, fill_by=None,
7243
7612
  **other_args):
@@ -7261,6 +7630,8 @@ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend
7261
7630
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
7262
7631
  show_legend : bool, default=True
7263
7632
  False - do not show legend for this layer.
7633
+ inherit_aes : bool, default=True
7634
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
7264
7635
  manual_key : str or `layer_key`
7265
7636
  The key to show in the manual legend.
7266
7637
  Specify text for the legend label or advanced settings using the `layer_key()` function.
@@ -7270,6 +7641,7 @@ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend
7270
7641
  tooltips : `layer_tooltips`
7271
7642
  Result of the call to the `layer_tooltips()` function.
7272
7643
  Specify appearance, style and content.
7644
+ Set tooltips='none' to hide tooltips from the layer.
7273
7645
  color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
7274
7646
  Define the color aesthetic for the geometry.
7275
7647
  fill_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='fill'
@@ -7298,12 +7670,17 @@ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend
7298
7670
  - x : x-axis coordinates.
7299
7671
  - y : y-axis coordinates.
7300
7672
  - alpha : transparency level of the point. Accept values between 0 and 1.
7301
- - 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").
7302
- - 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").
7303
- - shape : shape of the point, an integer from 0 to 25.
7673
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
7674
+ - fill : fill color. Is applied only to the points of shapes having inner area. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
7675
+ - shape : shape of the point, an integer from 0 to 25. For more info see `Point Shapes <https://lets-plot.org/python/pages/aesthetics.html#point-shapes>`__.
7304
7676
  - size : size of the point.
7305
7677
  - stroke : width of the shape border. Applied only to the shapes having border.
7306
7678
 
7679
+ ----
7680
+
7681
+ To hide axis tooltips, set 'blank' or the result of `element_blank()`
7682
+ to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
7683
+
7307
7684
  Examples
7308
7685
  --------
7309
7686
  .. jupyter-execute::
@@ -7344,6 +7721,7 @@ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend
7344
7721
  stat=stat,
7345
7722
  position=position,
7346
7723
  show_legend=show_legend,
7724
+ inherit_aes=inherit_aes,
7347
7725
  manual_key=manual_key,
7348
7726
  sampling=sampling,
7349
7727
  tooltips=tooltips,
@@ -7351,12 +7729,140 @@ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend
7351
7729
  **other_args)
7352
7730
 
7353
7731
 
7732
+ def geom_blank(mapping=None, *, data=None, stat=None, position=None, show_legend=None, inherit_aes=False,
7733
+ manual_key=None,
7734
+ sampling=None,
7735
+ map=None, map_join=None, use_crs=None,
7736
+ color_by=None, fill_by=None,
7737
+ **other_args):
7738
+ """
7739
+ Draw nothing, but can be a useful way of ensuring common scales between different plots (see `expand_limits()`).
7740
+ Also, can help to avoid the "No layers in plot" error when building plots using automated tools.
7741
+
7742
+ Parameters
7743
+ ----------
7744
+ mapping : `FeatureSpec`
7745
+ Set of aesthetic mappings created by `aes()` function.
7746
+ Aesthetic mappings describe the way that variables in the data are
7747
+ mapped to plot "aesthetics".
7748
+ data : dict or Pandas or Polars `DataFrame` or `GeoDataFrame`
7749
+ The data to be displayed in this layer. If None, the default, the data
7750
+ is inherited from the plot data as specified in the call to ggplot.
7751
+ stat : str, default='identity'
7752
+ The statistical transformation to use on the data for this layer, as a string.
7753
+ Supported transformations: 'identity' (leaves the data unchanged),
7754
+ 'count' (counts number of points with same x-axis coordinate),
7755
+ 'bin' (counts number of points with x-axis coordinate in the same bin),
7756
+ 'smooth' (performs smoothing - linear default),
7757
+ 'density' (computes and draws kernel density estimate),
7758
+ 'sum' (counts the number of points at each location - might help to workaround overplotting).
7759
+ position : str or `FeatureSpec`, default='identity'
7760
+ Position adjustment.
7761
+ Either a position adjustment name: 'dodge', 'dodgev', 'jitter', 'nudge', 'jitterdodge', 'fill',
7762
+ 'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
7763
+ show_legend : bool, default=True
7764
+ False - do not show legend for this layer.
7765
+ inherit_aes : bool, default=False
7766
+ False - do not combine the layer aesthetic mappings with the plot shared mappings.
7767
+ manual_key : str or `layer_key`
7768
+ The key to show in the manual legend.
7769
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
7770
+ sampling : `FeatureSpec`
7771
+ Result of the call to the `sampling_xxx()` function.
7772
+ To prevent any sampling for this layer pass value "none" (string "none").
7773
+ map : `GeoDataFrame` or `Geocoder`
7774
+ Data containing coordinates of points.
7775
+ map_join : str or list
7776
+ Keys used to join map coordinates with data.
7777
+ First value in pair - column/columns in `data`.
7778
+ Second value in pair - column/columns in `map`.
7779
+ use_crs : str, optional, default="EPSG:4326" (aka WGS84)
7780
+ EPSG code of the coordinate reference system (CRS) or the keyword "provided".
7781
+ If an EPSG code is given, then all the coordinates in `GeoDataFrame` (see the `map` parameter)
7782
+ will be projected to this CRS.
7783
+ Specify "provided" to disable any further re-projection and to keep the `GeoDataFrame's` original CRS.
7784
+ color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
7785
+ Define the color aesthetic for the geometry.
7786
+ fill_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='fill'
7787
+ Define the fill aesthetic for the geometry.
7788
+ other_args
7789
+ Other arguments passed on to the layer.
7790
+ These are often aesthetics settings used to set an aesthetic to a fixed value,
7791
+ like color='red', fill='blue', size=3 or shape=21.
7792
+ They may also be parameters to the paired geom/stat.
7793
+
7794
+ Returns
7795
+ -------
7796
+ `LayerSpec`
7797
+ Geom object specification.
7798
+
7799
+ Notes
7800
+ -----
7801
+ The point geometry is used to create scatterplots.
7802
+ The scatterplot is useful for displaying the relationship between
7803
+ two continuous variables, although it can also be used with one continuous
7804
+ and one categorical variable, or two categorical variables.
7805
+
7806
+ `geom_blank()` 'understands' any aesthetic mappings of `geom_point()`, but the most useful are those related to the chart guides (i.e., axes and legends):
7807
+
7808
+ - x : x-axis value.
7809
+ - y : y-axis value.
7810
+ - color (colour) : color of the geometry. For more info see `Color and Fill <https://lets-plot.org/python/pages/aesthetics.html#color-and-fill>`__.
7811
+ - fill : fill color.
7812
+
7813
+ ----
7814
+
7815
+ The `data` and `map` parameters of `GeoDataFrame` type support shapes `Point` and `MultiPoint`.
7816
+
7817
+ The `map` parameter of `Geocoder` type implicitly invokes `centroids()` function.
7818
+
7819
+ ----
7820
+
7821
+ The conventions for the values of `map_join` parameter are as follows:
7822
+
7823
+ - Joining data and `GeoDataFrame` object
7824
+
7825
+ Data has a column named 'State_name' and `GeoDataFrame` has a matching column named 'state':
7826
+
7827
+ - map_join=['State_Name', 'state']
7828
+ - map_join=[['State_Name'], ['state']]
7829
+
7830
+ - Joining data and `Geocoder` object
7831
+
7832
+ Data has a column named 'State_name'. The matching key in `Geocoder` is always 'state' (providing it is a state-level geocoder) and can be omitted:
7833
+
7834
+ - map_join='State_Name'
7835
+ - map_join=['State_Name']
7836
+
7837
+ - Joining data by composite key
7838
+
7839
+ Joining by composite key works like in examples above, but instead of using a string for a simple key you need to use an array of strings for a composite key. The names in the composite key must be in the same order as in the US street addresses convention: 'city', 'county', 'state', 'country'. For example, the data has columns 'State_name' and 'County_name'. Joining with a 2-keys county level `Geocoder` object (the `Geocoder` keys 'county' and 'state' are omitted in this case):
7840
+
7841
+ - map_join=['County_name', 'State_Name']
7842
+
7843
+ """
7844
+ return _geom('blank',
7845
+ mapping=mapping,
7846
+ data=data,
7847
+ stat=stat,
7848
+ position=position,
7849
+ show_legend=show_legend,
7850
+ inherit_aes=inherit_aes,
7851
+ manual_key=manual_key,
7852
+ sampling=sampling,
7853
+ tooltips='none',
7854
+ map=map, map_join=map_join, use_crs=use_crs,
7855
+ color_by=color_by, fill_by=fill_by,
7856
+ **other_args)
7857
+
7858
+
7354
7859
  def _geom(name, *,
7355
7860
  mapping=None,
7356
7861
  data=None,
7357
7862
  stat=None,
7358
7863
  position=None,
7359
7864
  show_legend=None,
7865
+ inherit_aes=None,
7360
7866
  manual_key=None,
7361
7867
  sampling=None,
7362
7868
  tooltips=None,
@@ -7383,6 +7889,7 @@ def _geom(name, *,
7383
7889
  mapping=mapping,
7384
7890
  position=position,
7385
7891
  show_legend=show_legend,
7892
+ inherit_aes=inherit_aes,
7386
7893
  manual_key=manual_key,
7387
7894
  sampling=sampling,
7388
7895
  tooltips=tooltips,