lets-plot 4.3.3__cp38-cp38-win_amd64.whl → 4.4.0rc1__cp38-cp38-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 (36) hide show
  1. lets_plot/__init__.py +2 -0
  2. lets_plot/_type_utils.py +8 -0
  3. lets_plot/_version.py +1 -1
  4. lets_plot/bistro/__init__.py +3 -1
  5. lets_plot/bistro/corr.py +3 -3
  6. lets_plot/bistro/im.py +1 -1
  7. lets_plot/bistro/residual.py +8 -3
  8. lets_plot/bistro/waterfall.py +242 -0
  9. lets_plot/geo_data/to_geo_data_frame.py +5 -1
  10. lets_plot/mapping.py +6 -7
  11. lets_plot/package_data/lets-plot.min.js +1 -1
  12. lets_plot/plot/__init__.py +5 -1
  13. lets_plot/plot/annotation.py +2 -4
  14. lets_plot/plot/coord.py +1 -2
  15. lets_plot/plot/core.py +25 -30
  16. lets_plot/plot/geom.py +434 -84
  17. lets_plot/plot/geom_function_.py +6 -1
  18. lets_plot/plot/geom_imshow_.py +1 -1
  19. lets_plot/plot/geom_livemap_.py +4 -0
  20. lets_plot/plot/ggtb_.py +11 -0
  21. lets_plot/plot/guide.py +84 -8
  22. lets_plot/plot/label.py +30 -6
  23. lets_plot/plot/marginal_layer.py +1 -2
  24. lets_plot/plot/plot.py +4 -2
  25. lets_plot/plot/scale_colormap_mpl.py +295 -0
  26. lets_plot/plot/series_meta.py +123 -0
  27. lets_plot/plot/stat.py +2 -4
  28. lets_plot/plot/theme_.py +11 -0
  29. lets_plot/plot/tooltip.py +24 -24
  30. lets_plot/plot/util.py +106 -113
  31. {lets_plot-4.3.3.dist-info → lets_plot-4.4.0rc1.dist-info}/METADATA +1 -1
  32. {lets_plot-4.3.3.dist-info → lets_plot-4.4.0rc1.dist-info}/RECORD +36 -32
  33. {lets_plot-4.3.3.dist-info → lets_plot-4.4.0rc1.dist-info}/WHEEL +1 -1
  34. lets_plot_kotlin_bridge.cp38-win_amd64.pyd +0 -0
  35. {lets_plot-4.3.3.dist-info → lets_plot-4.4.0rc1.dist-info}/LICENSE +0 -0
  36. {lets_plot-4.3.3.dist-info → lets_plot-4.4.0rc1.dist-info}/top_level.txt +0 -0
lets_plot/plot/geom.py CHANGED
@@ -5,7 +5,7 @@
5
5
  from lets_plot.geo_data_internals.utils import is_geocoder
6
6
 
7
7
  from .core import FeatureSpec, LayerSpec
8
- from .util import as_annotated_data, is_geo_data_frame, geo_data_frame_to_crs, get_geo_data_frame_meta
8
+ from .util import as_annotated_data, is_geo_data_frame, geo_data_frame_to_crs, get_geo_data_frame_meta, key_int2str
9
9
 
10
10
  #
11
11
  # Geoms, short for geometric objects, describe the type of plot ggplot will produce.
@@ -18,6 +18,7 @@ __all__ = ['geom_point', 'geom_path', 'geom_line',
18
18
  'geom_contour',
19
19
  'geom_contourf', 'geom_polygon', 'geom_map',
20
20
  'geom_abline', 'geom_hline', 'geom_vline',
21
+ 'geom_band',
21
22
  'geom_boxplot', 'geom_violin', 'geom_ydotplot',
22
23
  'geom_area_ridges',
23
24
  'geom_ribbon', 'geom_area', 'geom_density',
@@ -29,7 +30,8 @@ __all__ = ['geom_point', 'geom_path', 'geom_line',
29
30
  'geom_count']
30
31
 
31
32
 
32
- def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
33
+ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
34
+ tooltips=None,
33
35
  map=None, map_join=None, use_crs=None,
34
36
  size_unit=None,
35
37
  color_by=None, fill_by=None,
@@ -60,6 +62,9 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
60
62
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
61
63
  show_legend : bool, default=True
62
64
  False - do not show legend for this layer.
65
+ manual_key : str or `layer_key`
66
+ The key to show in the manual legend.
67
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
63
68
  sampling : `FeatureSpec`
64
69
  Result of the call to the `sampling_xxx()` function.
65
70
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -114,13 +119,13 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
114
119
  - size : size of the point.
115
120
  - stroke : width of the shape border. Applied only to the shapes having border.
116
121
 
117
- |
122
+ ----
118
123
 
119
124
  The `data` and `map` parameters of `GeoDataFrame` type support shapes `Point` and `MultiPoint`.
120
125
 
121
126
  The `map` parameter of `Geocoder` type implicitly invokes `centroids()` function.
122
127
 
123
- |
128
+ ----
124
129
 
125
130
  The conventions for the values of `map_join` parameter are as follows:
126
131
 
@@ -199,6 +204,7 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
199
204
  stat=stat,
200
205
  position=position,
201
206
  show_legend=show_legend,
207
+ manual_key=manual_key,
202
208
  sampling=sampling,
203
209
  tooltips=tooltips,
204
210
  map=map, map_join=map_join, use_crs=use_crs,
@@ -207,7 +213,8 @@ def geom_point(mapping=None, *, data=None, stat=None, position=None, show_legend
207
213
  **other_args)
208
214
 
209
215
 
210
- def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
216
+ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
217
+ tooltips=None,
211
218
  map=None, map_join=None, use_crs=None,
212
219
  flat=None, geodesic=None,
213
220
  color_by=None,
@@ -237,6 +244,9 @@ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=
237
244
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
238
245
  show_legend : bool, default=True
239
246
  False - do not show legend for this layer.
247
+ manual_key : str or `layer_key`
248
+ The key to show in the manual legend.
249
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
240
250
  sampling : `FeatureSpec`
241
251
  Result of the call to the `sampling_xxx()` function.
242
252
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -286,11 +296,11 @@ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=
286
296
  - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
287
297
  - size : line width.
288
298
 
289
- |
299
+ ----
290
300
 
291
301
  The `data` and `map` parameters of `GeoDataFrame` type support shapes `LineString` and `MultiLineString`.
292
302
 
293
- |
303
+ ----
294
304
 
295
305
  The conventions for the values of `map_join` parameter are as follows.
296
306
 
@@ -377,6 +387,7 @@ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=
377
387
  stat=stat,
378
388
  position=position,
379
389
  show_legend=show_legend,
390
+ manual_key=manual_key,
380
391
  sampling=sampling,
381
392
  tooltips=tooltips,
382
393
  map=map, map_join=map_join, use_crs=use_crs,
@@ -385,7 +396,8 @@ def geom_path(mapping=None, *, data=None, stat=None, position=None, show_legend=
385
396
  **other_args)
386
397
 
387
398
 
388
- def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
399
+ def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
400
+ tooltips=None,
389
401
  color_by=None,
390
402
  **other_args):
391
403
  """
@@ -415,6 +427,9 @@ def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=
415
427
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
416
428
  show_legend : bool, default=True
417
429
  False - do not show legend for this layer.
430
+ manual_key : str or `layer_key`
431
+ The key to show in the manual legend.
432
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
418
433
  sampling : `FeatureSpec`
419
434
  Result of the call to the `sampling_xxx()` function.
420
435
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -488,13 +503,15 @@ def geom_line(mapping=None, *, data=None, stat=None, position=None, show_legend=
488
503
  stat=stat,
489
504
  position=position,
490
505
  show_legend=show_legend,
506
+ manual_key=manual_key,
491
507
  sampling=sampling,
492
508
  tooltips=tooltips,
493
509
  color_by=color_by,
494
510
  **other_args)
495
511
 
496
512
 
497
- def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
513
+ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
514
+ tooltips=None,
498
515
  orientation=None,
499
516
  method=None,
500
517
  n=None,
@@ -531,6 +548,9 @@ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legen
531
548
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
532
549
  show_legend : bool, default=True
533
550
  False - do not show legend for this layer.
551
+ manual_key : str or `layer_key`
552
+ The key to show in the manual legend.
553
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
534
554
  sampling : `FeatureSpec`
535
555
  Result of the call to the `sampling_xxx()` function.
536
556
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -657,6 +677,7 @@ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legen
657
677
  stat=stat,
658
678
  position=position,
659
679
  show_legend=show_legend,
680
+ manual_key=manual_key,
660
681
  sampling=sampling,
661
682
  tooltips=tooltips,
662
683
  orientation=orientation,
@@ -672,7 +693,7 @@ def geom_smooth(mapping=None, *, data=None, stat=None, position=None, show_legen
672
693
  **other_args)
673
694
 
674
695
 
675
- def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None,
696
+ def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
676
697
  tooltips=None, labels=None,
677
698
  orientation=None,
678
699
  color_by=None, fill_by=None,
@@ -703,6 +724,9 @@ def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=N
703
724
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
704
725
  show_legend : bool, default=True
705
726
  False - do not show legend for this layer.
727
+ manual_key : str or `layer_key`
728
+ The key to show in the manual legend.
729
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
706
730
  sampling : `FeatureSpec`
707
731
  Result of the call to the `sampling_xxx()` function.
708
732
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -814,6 +838,7 @@ def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=N
814
838
  stat=stat,
815
839
  position=position,
816
840
  show_legend=show_legend,
841
+ manual_key=manual_key,
817
842
  sampling=sampling,
818
843
  tooltips=tooltips,
819
844
  labels=labels,
@@ -822,7 +847,8 @@ def geom_bar(mapping=None, *, data=None, stat=None, position=None, show_legend=N
822
847
  **other_args)
823
848
 
824
849
 
825
- def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None,
850
+ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
851
+ sampling=None, threshold=None,
826
852
  tooltips=None, labels=None,
827
853
  orientation=None,
828
854
  bins=None,
@@ -857,9 +883,15 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
857
883
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
858
884
  show_legend : bool, default=True
859
885
  False - do not show legend for this layer.
886
+ manual_key : str or `layer_key`
887
+ The key to show in the manual legend.
888
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
860
889
  sampling : `FeatureSpec`
861
890
  Result of the call to the `sampling_xxx()` function.
862
891
  To prevent any sampling for this layer pass value "none" (string "none").
892
+ threshold : float, default=None
893
+ If a bin's `..count..` is less than the threshold, the bin will be removed.
894
+ Dropping empty bins is particularly useful for faceted plots with free scales.
863
895
  tooltips : `layer_tooltips`
864
896
  Result of the call to the `layer_tooltips()` function.
865
897
  Specify appearance, style and content.
@@ -965,7 +997,9 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
965
997
  stat=stat,
966
998
  position=position,
967
999
  show_legend=show_legend,
1000
+ manual_key=manual_key,
968
1001
  sampling=sampling,
1002
+ threshold=threshold,
969
1003
  tooltips=tooltips,
970
1004
  labels=labels,
971
1005
  orientation=orientation,
@@ -977,7 +1011,7 @@ def geom_histogram(mapping=None, *, data=None, stat=None, position=None, show_le
977
1011
  **other_args)
978
1012
 
979
1013
 
980
- def geom_dotplot(mapping=None, *, data=None, show_legend=None, sampling=None, tooltips=None,
1014
+ def geom_dotplot(mapping=None, *, data=None, show_legend=None, manual_key=None, sampling=None, tooltips=None,
981
1015
  binwidth=None,
982
1016
  bins=None,
983
1017
  method=None,
@@ -1004,6 +1038,9 @@ def geom_dotplot(mapping=None, *, data=None, show_legend=None, sampling=None, to
1004
1038
  is inherited from the plot data as specified in the call to ggplot.
1005
1039
  show_legend : bool, default=True
1006
1040
  False - do not show legend for this layer.
1041
+ manual_key : str or `layer_key`
1042
+ The key to show in the manual legend.
1043
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
1007
1044
  sampling : `FeatureSpec`
1008
1045
  Result of the call to the `sampling_xxx()` function.
1009
1046
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -1119,6 +1156,7 @@ def geom_dotplot(mapping=None, *, data=None, show_legend=None, sampling=None, to
1119
1156
  stat=None,
1120
1157
  position=None,
1121
1158
  show_legend=show_legend,
1159
+ manual_key=manual_key,
1122
1160
  sampling=sampling,
1123
1161
  tooltips=tooltips,
1124
1162
  binwidth=binwidth,
@@ -1134,14 +1172,20 @@ def geom_dotplot(mapping=None, *, data=None, show_legend=None, sampling=None, to
1134
1172
  **other_args)
1135
1173
 
1136
1174
 
1137
- def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
1175
+ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
1176
+ tooltips=None,
1138
1177
  bins=None,
1139
1178
  binwidth=None,
1140
1179
  drop=None,
1141
1180
  color_by=None, fill_by=None,
1142
1181
  **other_args):
1143
1182
  """
1144
- Divides the plane into a grid and color the bins by the count of cases in them.
1183
+ Apply a rectangular grid to the plane, count observations in each cell (bin) of the grid,
1184
+ and map the count to the fill color of the cell (tile).
1185
+
1186
+ By default, this geom uses `coord_fixed()`.
1187
+ However, this may not be the best choice when the values on the X/Y axis have significantly different magnitudes.
1188
+ In such cases, try using `coord_cartesian()`.
1145
1189
 
1146
1190
  Parameters
1147
1191
  ----------
@@ -1160,6 +1204,9 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
1160
1204
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
1161
1205
  show_legend : bool, default=True
1162
1206
  False - do not show legend for this layer.
1207
+ manual_key : str or `layer_key`
1208
+ The key to show in the manual legend.
1209
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
1163
1210
  sampling : `FeatureSpec`
1164
1211
  Result of the call to the `sampling_xxx()` function.
1165
1212
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -1190,8 +1237,6 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
1190
1237
 
1191
1238
  Notes
1192
1239
  -----
1193
- `geom_bin2d()` applies rectangular grid to the plane then counts observation
1194
- in each cell of the grid (bin). Uses `geom_tile()` to display counts as a tile fill-color.
1195
1240
 
1196
1241
  Computed variables:
1197
1242
 
@@ -1287,6 +1332,7 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
1287
1332
  stat=stat,
1288
1333
  position=position,
1289
1334
  show_legend=show_legend,
1335
+ manual_key=manual_key,
1290
1336
  sampling=sampling,
1291
1337
  tooltips=tooltips,
1292
1338
  bins=bins,
@@ -1296,7 +1342,8 @@ def geom_bin2d(mapping=None, *, data=None, stat=None, position=None, show_legend
1296
1342
  **other_args)
1297
1343
 
1298
1344
 
1299
- def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
1345
+ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
1346
+ tooltips=None,
1300
1347
  color_by=None, fill_by=None,
1301
1348
  **other_args):
1302
1349
  """
@@ -1319,6 +1366,9 @@ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=
1319
1366
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
1320
1367
  show_legend : bool, default=True
1321
1368
  False - do not show legend for this layer.
1369
+ manual_key : str or `layer_key`
1370
+ The key to show in the manual legend.
1371
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
1322
1372
  sampling : `FeatureSpec`
1323
1373
  Result of the call to the `sampling_xxx()` function.
1324
1374
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -1427,13 +1477,15 @@ def geom_tile(mapping=None, *, data=None, stat=None, position=None, show_legend=
1427
1477
  stat=stat,
1428
1478
  position=position,
1429
1479
  show_legend=show_legend,
1480
+ manual_key=manual_key,
1430
1481
  sampling=sampling,
1431
1482
  tooltips=tooltips,
1432
1483
  color_by=color_by, fill_by=fill_by,
1433
1484
  **other_args)
1434
1485
 
1435
1486
 
1436
- def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, fill_by=None,
1487
+ def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
1488
+ fill_by=None,
1437
1489
  **other_args):
1438
1490
  """
1439
1491
  Display rectangles with x, y values mapped to the center of the tile.
@@ -1457,6 +1509,9 @@ def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legen
1457
1509
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
1458
1510
  show_legend : bool, default=True
1459
1511
  False - do not show legend for this layer.
1512
+ manual_key : str or `layer_key`
1513
+ The key to show in the manual legend.
1514
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
1460
1515
  sampling : `FeatureSpec`
1461
1516
  Result of the call to the `sampling_xxx()` function.
1462
1517
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -1514,12 +1569,14 @@ def geom_raster(mapping=None, *, data=None, stat=None, position=None, show_legen
1514
1569
  stat=stat,
1515
1570
  position=position,
1516
1571
  show_legend=show_legend,
1572
+ manual_key=manual_key,
1517
1573
  sampling=sampling,
1518
1574
  fill_by=fill_by,
1519
1575
  **other_args)
1520
1576
 
1521
1577
 
1522
- def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
1578
+ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
1579
+ sampling=None, tooltips=None,
1523
1580
  color_by=None,
1524
1581
  **other_args):
1525
1582
  """
@@ -1547,6 +1604,9 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1547
1604
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
1548
1605
  show_legend : bool, default=True
1549
1606
  False - do not show legend for this layer.
1607
+ manual_key : str or `layer_key`
1608
+ The key to show in the manual legend.
1609
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
1550
1610
  sampling : `FeatureSpec`
1551
1611
  Result of the call to the `sampling_xxx()` function.
1552
1612
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -1645,13 +1705,15 @@ def geom_errorbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1645
1705
  stat=stat,
1646
1706
  position=position,
1647
1707
  show_legend=show_legend,
1708
+ manual_key=manual_key,
1648
1709
  sampling=sampling,
1649
1710
  tooltips=tooltips,
1650
1711
  color_by=color_by,
1651
1712
  **other_args)
1652
1713
 
1653
1714
 
1654
- def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
1715
+ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
1716
+ sampling=None, tooltips=None,
1655
1717
  fatten=None,
1656
1718
  color_by=None, fill_by=None,
1657
1719
  **other_args):
@@ -1680,6 +1742,9 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1680
1742
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
1681
1743
  show_legend : bool, default=True
1682
1744
  False - do not show legend for this layer.
1745
+ manual_key : str or `layer_key`
1746
+ The key to show in the manual legend.
1747
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
1683
1748
  sampling : `FeatureSpec`
1684
1749
  Result of the call to the `sampling_xxx()` function.
1685
1750
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -1774,6 +1839,7 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1774
1839
  stat=stat,
1775
1840
  position=position,
1776
1841
  show_legend=show_legend,
1842
+ manual_key=manual_key,
1777
1843
  sampling=sampling,
1778
1844
  tooltips=tooltips,
1779
1845
  fatten=fatten,
@@ -1781,7 +1847,8 @@ def geom_crossbar(mapping=None, *, data=None, stat=None, position=None, show_leg
1781
1847
  **other_args)
1782
1848
 
1783
1849
 
1784
- def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None,
1850
+ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
1851
+ sampling=None,
1785
1852
  tooltips=None,
1786
1853
  fatten=None,
1787
1854
  color_by=None, fill_by=None,
@@ -1811,6 +1878,9 @@ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_l
1811
1878
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
1812
1879
  show_legend : bool, default=True
1813
1880
  False - do not show legend for this layer.
1881
+ manual_key : str or `layer_key`
1882
+ The key to show in the manual legend.
1883
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
1814
1884
  sampling : `FeatureSpec`
1815
1885
  Result of the call to the `sampling_xxx()` function.
1816
1886
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -1902,6 +1972,7 @@ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_l
1902
1972
  stat=stat,
1903
1973
  position=position,
1904
1974
  show_legend=show_legend,
1975
+ manual_key=manual_key,
1905
1976
  sampling=sampling,
1906
1977
  tooltips=tooltips,
1907
1978
  fatten=fatten,
@@ -1909,7 +1980,8 @@ def geom_pointrange(mapping=None, *, data=None, stat=None, position=None, show_l
1909
1980
  **other_args)
1910
1981
 
1911
1982
 
1912
- def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
1983
+ def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
1984
+ sampling=None, tooltips=None,
1913
1985
  color_by=None,
1914
1986
  **other_args):
1915
1987
  """
@@ -1937,6 +2009,9 @@ def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_le
1937
2009
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
1938
2010
  show_legend : bool, default=True
1939
2011
  False - do not show legend for this layer.
2012
+ manual_key : str or `layer_key`
2013
+ The key to show in the manual legend.
2014
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
1940
2015
  sampling : `FeatureSpec`
1941
2016
  Result of the call to the `sampling_xxx()` function.
1942
2017
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -2018,13 +2093,15 @@ def geom_linerange(mapping=None, *, data=None, stat=None, position=None, show_le
2018
2093
  stat=stat,
2019
2094
  position=position,
2020
2095
  show_legend=show_legend,
2096
+ manual_key=manual_key,
2021
2097
  sampling=sampling,
2022
2098
  tooltips=tooltips,
2023
2099
  color_by=color_by,
2024
2100
  **other_args)
2025
2101
 
2026
2102
 
2027
- def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
2103
+ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
2104
+ tooltips=None,
2028
2105
  bins=None,
2029
2106
  binwidth=None,
2030
2107
  color_by=None,
@@ -2049,6 +2126,9 @@ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_lege
2049
2126
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2050
2127
  show_legend : bool, default=True
2051
2128
  False - do not show legend for this layer.
2129
+ manual_key : str or `layer_key`
2130
+ The key to show in the manual legend.
2131
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
2052
2132
  sampling : `FeatureSpec`
2053
2133
  Result of the call to the `sampling_xxx()` function.
2054
2134
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -2156,6 +2236,7 @@ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_lege
2156
2236
  stat=stat,
2157
2237
  position=position,
2158
2238
  show_legend=show_legend,
2239
+ manual_key=manual_key,
2159
2240
  sampling=sampling,
2160
2241
  tooltips=tooltips,
2161
2242
  bins=bins, binwidth=binwidth,
@@ -2163,7 +2244,8 @@ def geom_contour(mapping=None, *, data=None, stat=None, position=None, show_lege
2163
2244
  **other_args)
2164
2245
 
2165
2246
 
2166
- def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
2247
+ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
2248
+ sampling=None, tooltips=None,
2167
2249
  bins=None,
2168
2250
  binwidth=None,
2169
2251
  color_by=None, fill_by=None,
@@ -2188,6 +2270,9 @@ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_leg
2188
2270
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2189
2271
  show_legend : bool, default=True
2190
2272
  False - do not show legend for this layer.
2273
+ manual_key : str or `layer_key`
2274
+ The key to show in the manual legend.
2275
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
2191
2276
  sampling : `FeatureSpec`
2192
2277
  Result of the call to the `sampling_xxx()` function.
2193
2278
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -2296,6 +2381,7 @@ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_leg
2296
2381
  stat=stat,
2297
2382
  position=position,
2298
2383
  show_legend=show_legend,
2384
+ manual_key=manual_key,
2299
2385
  sampling=sampling,
2300
2386
  tooltips=tooltips,
2301
2387
  bins=bins,
@@ -2304,7 +2390,8 @@ def geom_contourf(mapping=None, *, data=None, stat=None, position=None, show_leg
2304
2390
  **other_args)
2305
2391
 
2306
2392
 
2307
- def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
2393
+ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
2394
+ tooltips=None,
2308
2395
  map=None, map_join=None, use_crs=None,
2309
2396
  color_by=None, fill_by=None,
2310
2397
  **other_args):
@@ -2328,6 +2415,9 @@ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_lege
2328
2415
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2329
2416
  show_legend : bool, default=True
2330
2417
  False - do not show legend for this layer.
2418
+ manual_key : str or `layer_key`
2419
+ The key to show in the manual legend.
2420
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
2331
2421
  sampling : `FeatureSpec`
2332
2422
  Result of the call to the `sampling_xxx()` function.
2333
2423
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -2375,13 +2465,13 @@ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_lege
2375
2465
  - size : line width.
2376
2466
  - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
2377
2467
 
2378
- |
2468
+ ----
2379
2469
 
2380
2470
  The `data` and `map` parameters of `GeoDataFrame` type support shapes `Polygon` and `MultiPolygon`.
2381
2471
 
2382
2472
  The `map` parameter of `Geocoder` type implicitly invokes `boundaries()` function.
2383
2473
 
2384
- |
2474
+ ----
2385
2475
 
2386
2476
  The conventions for the values of `map_join` parameter are as follows:
2387
2477
 
@@ -2474,6 +2564,7 @@ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_lege
2474
2564
  stat=stat,
2475
2565
  position=position,
2476
2566
  show_legend=show_legend,
2567
+ manual_key=manual_key,
2477
2568
  sampling=sampling,
2478
2569
  tooltips=tooltips,
2479
2570
  map=map, map_join=map_join, use_crs=use_crs,
@@ -2481,7 +2572,8 @@ def geom_polygon(mapping=None, *, data=None, stat=None, position=None, show_lege
2481
2572
  **other_args)
2482
2573
 
2483
2574
 
2484
- def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
2575
+ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
2576
+ tooltips=None,
2485
2577
  map=None, map_join=None, use_crs=None,
2486
2578
  color_by=None, fill_by=None,
2487
2579
  **other_args):
@@ -2510,6 +2602,9 @@ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=N
2510
2602
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2511
2603
  show_legend : bool, default=True
2512
2604
  False - do not show legend for this layer.
2605
+ manual_key : str or `layer_key`
2606
+ The key to show in the manual legend.
2607
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
2513
2608
  sampling : `FeatureSpec`
2514
2609
  Result of the call to the `sampling_xxx()` function.
2515
2610
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -2556,13 +2651,13 @@ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=N
2556
2651
  - size : line width.
2557
2652
  - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
2558
2653
 
2559
- |
2654
+ ----
2560
2655
 
2561
2656
  The `data` and `map` parameters of `GeoDataFrame` type support shapes `Polygon` and `MultiPolygon`.
2562
2657
 
2563
2658
  The `map` parameter of `Geocoder` type implicitly invokes `boundaries()` function.
2564
2659
 
2565
- |
2660
+ ----
2566
2661
 
2567
2662
  The conventions for the values of `map_join` parameter are as follows.
2568
2663
 
@@ -2641,6 +2736,7 @@ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=N
2641
2736
  stat=stat,
2642
2737
  position=position,
2643
2738
  show_legend=show_legend,
2739
+ manual_key=manual_key,
2644
2740
  sampling=sampling,
2645
2741
  tooltips=tooltips,
2646
2742
  map=map, map_join=map_join, use_crs=use_crs,
@@ -2648,7 +2744,7 @@ def geom_map(mapping=None, *, data=None, stat=None, position=None, show_legend=N
2648
2744
  **other_args)
2649
2745
 
2650
2746
 
2651
- def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None,
2747
+ def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
2652
2748
  slope=None,
2653
2749
  intercept=None,
2654
2750
  color_by=None,
@@ -2673,6 +2769,9 @@ def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legen
2673
2769
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2674
2770
  show_legend : bool, default=True
2675
2771
  False - do not show legend for this layer.
2772
+ manual_key : str or `layer_key`
2773
+ The key to show in the manual legend.
2774
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
2676
2775
  sampling : `FeatureSpec`
2677
2776
  Result of the call to the `sampling_xxx()` function.
2678
2777
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -2750,6 +2849,7 @@ def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legen
2750
2849
  stat=stat,
2751
2850
  position=position,
2752
2851
  show_legend=show_legend,
2852
+ manual_key=manual_key,
2753
2853
  sampling=sampling,
2754
2854
  slope=slope,
2755
2855
  intercept=intercept,
@@ -2757,7 +2857,120 @@ def geom_abline(mapping=None, *, data=None, stat=None, position=None, show_legen
2757
2857
  **other_args)
2758
2858
 
2759
2859
 
2760
- def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
2860
+ def geom_band(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None,
2861
+ tooltips=None,
2862
+ color_by=None, fill_by=None,
2863
+ **other_args):
2864
+ """
2865
+ Add a straight vertical or horizontal band to the plot.
2866
+
2867
+ Parameters
2868
+ ----------
2869
+ mapping : `FeatureSpec`
2870
+ Set of aesthetic mappings created by `aes()` function.
2871
+ Aesthetic mappings describe the way that variables in the data are
2872
+ mapped to plot "aesthetics".
2873
+ data : dict or Pandas or Polars `DataFrame`
2874
+ The data to be displayed in this layer. If None, the default, the data
2875
+ is inherited from the plot data as specified in the call to ggplot.
2876
+ stat : str, default='identity'
2877
+ The statistical transformation to use on the data for this layer, as a string.
2878
+ position : str or `FeatureSpec`, default='identity'
2879
+ Position adjustment.
2880
+ Either a position adjustment name: 'dodge', 'dodgev', 'jitter', 'nudge', 'jitterdodge', 'fill',
2881
+ 'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2882
+ show_legend : bool, default=True
2883
+ False - do not show legend for this layer.
2884
+ sampling : `FeatureSpec`
2885
+ Result of the call to the `sampling_xxx()` function.
2886
+ To prevent any sampling for this layer pass value "none" (string "none").
2887
+ tooltips : `layer_tooltips`
2888
+ Result of the call to the `layer_tooltips()` function.
2889
+ Specify appearance, style and content.
2890
+ color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
2891
+ Define the color aesthetic for the geometry.
2892
+ fill_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='fill'
2893
+ Define the fill aesthetic for the geometry.
2894
+ other_args
2895
+ Other arguments passed on to the layer.
2896
+ These are often aesthetics settings used to set an aesthetic to a fixed value,
2897
+ like color='red', fill='blue', size=3 or shape=21.
2898
+ They may also be parameters to the paired geom/stat.
2899
+
2900
+ Returns
2901
+ -------
2902
+ `LayerSpec`
2903
+ Geom object specification.
2904
+
2905
+ Notes
2906
+ -----
2907
+ `geom_band()` understands the following aesthetics mappings:
2908
+
2909
+ - xmin : x-axis value.
2910
+ - xmax : x-axis value.
2911
+ - ymin : y-axis value.
2912
+ - ymax : y-axis value.
2913
+ - 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").
2916
+ - 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'.
2918
+
2919
+ Examples
2920
+ --------
2921
+ .. jupyter-execute::
2922
+ :linenos:
2923
+ :emphasize-lines: 3
2924
+
2925
+ from lets_plot import *
2926
+ LetsPlot.setup_html()
2927
+ ggplot() + geom_band(xmin=-1, xmax=1)
2928
+
2929
+ |
2930
+
2931
+ .. jupyter-execute::
2932
+ :linenos:
2933
+ :emphasize-lines: 16-19
2934
+
2935
+ from lets_plot import *
2936
+ 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
+ }
2949
+ 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()
2957
+
2958
+ """
2959
+ return _geom('band',
2960
+ mapping=mapping,
2961
+ data=data,
2962
+ stat=stat,
2963
+ position=position,
2964
+ show_legend=show_legend,
2965
+ sampling=sampling,
2966
+ tooltips=tooltips,
2967
+ color_by=color_by,
2968
+ fill_by=fill_by,
2969
+ **other_args)
2970
+
2971
+
2972
+ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
2973
+ tooltips=None,
2761
2974
  yintercept=None,
2762
2975
  color_by=None,
2763
2976
  **other_args):
@@ -2781,6 +2994,9 @@ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend
2781
2994
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2782
2995
  show_legend : bool, default=True
2783
2996
  False - do not show legend for this layer.
2997
+ manual_key : str or `layer_key`
2998
+ The key to show in the manual legend.
2999
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
2784
3000
  sampling : `FeatureSpec`
2785
3001
  Result of the call to the `sampling_xxx()` function.
2786
3002
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -2865,6 +3081,7 @@ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend
2865
3081
  stat=stat,
2866
3082
  position=position,
2867
3083
  show_legend=show_legend,
3084
+ manual_key=manual_key,
2868
3085
  sampling=sampling,
2869
3086
  tooltips=tooltips,
2870
3087
  yintercept=yintercept,
@@ -2872,7 +3089,8 @@ def geom_hline(mapping=None, *, data=None, stat=None, position=None, show_legend
2872
3089
  **other_args)
2873
3090
 
2874
3091
 
2875
- def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
3092
+ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
3093
+ tooltips=None,
2876
3094
  xintercept=None,
2877
3095
  color_by=None,
2878
3096
  **other_args):
@@ -2896,6 +3114,9 @@ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend
2896
3114
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
2897
3115
  show_legend : bool, default=True
2898
3116
  False - do not show legend for this layer.
3117
+ manual_key : str or `layer_key`
3118
+ The key to show in the manual legend.
3119
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
2899
3120
  sampling : `FeatureSpec`
2900
3121
  Result of the call to the `sampling_xxx()` function.
2901
3122
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -2980,6 +3201,7 @@ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend
2980
3201
  stat=stat,
2981
3202
  position=position,
2982
3203
  show_legend=show_legend,
3204
+ manual_key=manual_key,
2983
3205
  sampling=sampling,
2984
3206
  tooltips=tooltips,
2985
3207
  xintercept=xintercept,
@@ -2987,7 +3209,7 @@ def geom_vline(mapping=None, *, data=None, stat=None, position=None, show_legend
2987
3209
  **other_args)
2988
3210
 
2989
3211
 
2990
- def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_legend=None, tooltips=None,
3212
+ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, tooltips=None,
2991
3213
  orientation=None,
2992
3214
  fatten=None,
2993
3215
  outlier_alpha=None, outlier_color=None, outlier_fill=None,
@@ -3018,6 +3240,9 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
3018
3240
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
3019
3241
  show_legend : bool, default=True
3020
3242
  False - do not show legend for this layer.
3243
+ manual_key : str or `layer_key`
3244
+ The key to show in the manual legend.
3245
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
3021
3246
  tooltips : `layer_tooltips`
3022
3247
  Result of the call to the `layer_tooltips()` function.
3023
3248
  Specify appearance, style and content.
@@ -3169,6 +3394,7 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
3169
3394
  stat=stat,
3170
3395
  position=position,
3171
3396
  show_legend=show_legend,
3397
+ manual_key=manual_key,
3172
3398
  sampling=None,
3173
3399
  tooltips=tooltips,
3174
3400
  orientation=orientation,
@@ -3201,7 +3427,8 @@ def geom_boxplot(mapping=None, *, data=None, stat=None, position=None, show_lege
3201
3427
  return boxplot_layer
3202
3428
 
3203
3429
 
3204
- def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
3430
+ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
3431
+ tooltips=None,
3205
3432
  orientation=None,
3206
3433
  show_half=None,
3207
3434
  quantiles=None, quantile_lines=None,
@@ -3228,6 +3455,9 @@ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legen
3228
3455
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
3229
3456
  show_legend : bool, default=True
3230
3457
  False - do not show legend for this layer.
3458
+ manual_key : str or `layer_key`
3459
+ The key to show in the manual legend.
3460
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
3231
3461
  sampling : `FeatureSpec`
3232
3462
  Result of the call to the `sampling_xxx()` function.
3233
3463
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -3405,6 +3635,7 @@ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legen
3405
3635
  stat=stat,
3406
3636
  position=position,
3407
3637
  show_legend=show_legend,
3638
+ manual_key=manual_key,
3408
3639
  sampling=sampling,
3409
3640
  tooltips=tooltips,
3410
3641
  orientation=orientation,
@@ -3416,7 +3647,7 @@ def geom_violin(mapping=None, *, data=None, stat=None, position=None, show_legen
3416
3647
  **other_args)
3417
3648
 
3418
3649
 
3419
- def geom_ydotplot(mapping=None, *, data=None, show_legend=None, sampling=None, tooltips=None,
3650
+ def geom_ydotplot(mapping=None, *, data=None, show_legend=None, manual_key=None, sampling=None, tooltips=None,
3420
3651
  orientation=None,
3421
3652
  binwidth=None,
3422
3653
  bins=None,
@@ -3445,6 +3676,9 @@ def geom_ydotplot(mapping=None, *, data=None, show_legend=None, sampling=None, t
3445
3676
  is inherited from the plot data as specified in the call to ggplot.
3446
3677
  show_legend : bool, default=True
3447
3678
  False - do not show legend for this layer.
3679
+ manual_key : str or `layer_key`
3680
+ The key to show in the manual legend.
3681
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
3448
3682
  sampling : `FeatureSpec`
3449
3683
  Result of the call to the `sampling_xxx()` function.
3450
3684
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -3578,6 +3812,7 @@ def geom_ydotplot(mapping=None, *, data=None, show_legend=None, sampling=None, t
3578
3812
  stat=None,
3579
3813
  position=None,
3580
3814
  show_legend=show_legend,
3815
+ manual_key=manual_key,
3581
3816
  sampling=sampling,
3582
3817
  tooltips=tooltips,
3583
3818
  orientation=orientation,
@@ -3594,7 +3829,8 @@ def geom_ydotplot(mapping=None, *, data=None, show_legend=None, sampling=None, t
3594
3829
  **other_args)
3595
3830
 
3596
3831
 
3597
- def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
3832
+ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
3833
+ sampling=None, tooltips=None,
3598
3834
  trim=None, tails_cutoff=None, kernel=None, adjust=None, bw=None, n=None, fs_max=None,
3599
3835
  min_height=None, scale=None, quantiles=None, quantile_lines=None,
3600
3836
  color_by=None, fill_by=None,
@@ -3621,6 +3857,9 @@ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_
3621
3857
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
3622
3858
  show_legend : bool, default=True
3623
3859
  False - do not show legend for this layer.
3860
+ manual_key : str or `layer_key`
3861
+ The key to show in the manual legend.
3862
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
3624
3863
  sampling : `FeatureSpec`
3625
3864
  Result of the call to the `sampling_xxx()` function.
3626
3865
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -3754,6 +3993,7 @@ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_
3754
3993
  stat=stat,
3755
3994
  position=position,
3756
3995
  show_legend=show_legend,
3996
+ manual_key=manual_key,
3757
3997
  sampling=sampling,
3758
3998
  tooltips=tooltips,
3759
3999
  trim=trim,
@@ -3771,7 +4011,8 @@ def geom_area_ridges(mapping=None, *, data=None, stat=None, position=None, show_
3771
4011
  **other_args)
3772
4012
 
3773
4013
 
3774
- def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
4014
+ def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
4015
+ tooltips=None,
3775
4016
  color_by=None, fill_by=None,
3776
4017
  **other_args):
3777
4018
  """
@@ -3794,6 +4035,9 @@ def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legen
3794
4035
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
3795
4036
  show_legend : bool, default=True
3796
4037
  False - do not show legend for this layer.
4038
+ manual_key : str or `layer_key`
4039
+ The key to show in the manual legend.
4040
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
3797
4041
  sampling : `FeatureSpec`
3798
4042
  Result of the call to the `sampling_xxx()` function.
3799
4043
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -3876,13 +4120,15 @@ def geom_ribbon(mapping=None, *, data=None, stat=None, position=None, show_legen
3876
4120
  stat=stat,
3877
4121
  position=position,
3878
4122
  show_legend=show_legend,
4123
+ manual_key=manual_key,
3879
4124
  sampling=sampling,
3880
4125
  tooltips=tooltips,
3881
4126
  color_by=color_by, fill_by=fill_by,
3882
4127
  **other_args)
3883
4128
 
3884
4129
 
3885
- def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
4130
+ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
4131
+ tooltips=None,
3886
4132
  flat=None, color_by=None, fill_by=None,
3887
4133
  **other_args):
3888
4134
  """
@@ -3911,6 +4157,9 @@ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=
3911
4157
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
3912
4158
  show_legend : bool, default=True
3913
4159
  False - do not show legend for this layer.
4160
+ manual_key : str or `layer_key`
4161
+ The key to show in the manual legend.
4162
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
3914
4163
  sampling : `FeatureSpec`
3915
4164
  Result of the call to the `sampling_xxx()` function.
3916
4165
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -3997,6 +4246,7 @@ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=
3997
4246
  stat=stat,
3998
4247
  position=position,
3999
4248
  show_legend=show_legend,
4249
+ manual_key=manual_key,
4000
4250
  sampling=sampling,
4001
4251
  tooltips=tooltips,
4002
4252
  flat=flat,
@@ -4004,7 +4254,8 @@ def geom_area(mapping=None, *, data=None, stat=None, position=None, show_legend=
4004
4254
  **other_args)
4005
4255
 
4006
4256
 
4007
- def geom_density(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
4257
+ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
4258
+ tooltips=None,
4008
4259
  orientation=None,
4009
4260
  trim=None,
4010
4261
  kernel=None,
@@ -4041,6 +4292,9 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
4041
4292
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
4042
4293
  show_legend : bool, default=True
4043
4294
  False - do not show legend for this layer.
4295
+ manual_key : str or `layer_key`
4296
+ The key to show in the manual legend.
4297
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
4044
4298
  sampling : `FeatureSpec`
4045
4299
  Result of the call to the `sampling_xxx()` function.
4046
4300
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -4204,6 +4458,7 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
4204
4458
  stat=stat,
4205
4459
  position=position,
4206
4460
  show_legend=show_legend,
4461
+ manual_key=manual_key,
4207
4462
  sampling=sampling,
4208
4463
  tooltips=tooltips,
4209
4464
  orientation=orientation,
@@ -4213,7 +4468,8 @@ def geom_density(mapping=None, *, data=None, stat=None, position=None, show_lege
4213
4468
  **other_args)
4214
4469
 
4215
4470
 
4216
- def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
4471
+ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
4472
+ sampling=None, tooltips=None,
4217
4473
  kernel=None,
4218
4474
  adjust=None,
4219
4475
  bw=None,
@@ -4225,6 +4481,10 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
4225
4481
  """
4226
4482
  Display density function contour.
4227
4483
 
4484
+ By default, this geom uses `coord_fixed()`.
4485
+ However, this may not be the best choice when the values on the X/Y axis have significantly different magnitudes.
4486
+ In such cases, try using `coord_cartesian()`.
4487
+
4228
4488
  Parameters
4229
4489
  ----------
4230
4490
  mapping : `FeatureSpec`
@@ -4242,6 +4502,9 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
4242
4502
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
4243
4503
  show_legend : bool, default=True
4244
4504
  False - do not show legend for this layer.
4505
+ manual_key : str or `layer_key`
4506
+ The key to show in the manual legend.
4507
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
4245
4508
  sampling : `FeatureSpec`
4246
4509
  Result of the call to the `sampling_xxx()` function.
4247
4510
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -4279,7 +4542,6 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
4279
4542
 
4280
4543
  Notes
4281
4544
  -----
4282
- `geom_density2d()` draws density function.
4283
4545
 
4284
4546
  Computed variables:
4285
4547
 
@@ -4294,8 +4556,9 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
4294
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").
4295
4557
  - size : lines width.
4296
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'.
4559
+ - weight : used by 'density2d' stat to compute weighted density.
4297
4560
 
4298
- |
4561
+ ----
4299
4562
 
4300
4563
  'density2d' statistical transformation combined with parameter value `contour=False`
4301
4564
  could be used to draw heatmaps (see the example below).
@@ -4419,6 +4682,7 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
4419
4682
  stat=stat,
4420
4683
  position=position,
4421
4684
  show_legend=show_legend,
4685
+ manual_key=manual_key,
4422
4686
  sampling=sampling,
4423
4687
  tooltips=tooltips,
4424
4688
  kernel=kernel, adjust=adjust, bw=bw, n=n, bins=bins, binwidth=binwidth,
@@ -4426,7 +4690,8 @@ def geom_density2d(mapping=None, *, data=None, stat=None, position=None, show_le
4426
4690
  **other_args)
4427
4691
 
4428
4692
 
4429
- def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None,
4693
+ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
4694
+ sampling=None,
4430
4695
  tooltips=None,
4431
4696
  kernel=None,
4432
4697
  adjust=None,
@@ -4439,6 +4704,10 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
4439
4704
  """
4440
4705
  Fill density function contour.
4441
4706
 
4707
+ By default, this geom uses `coord_fixed()`.
4708
+ However, this may not be the best choice when the values on the X/Y axis have significantly different magnitudes.
4709
+ In such cases, try using `coord_cartesian()`.
4710
+
4442
4711
  Parameters
4443
4712
  ----------
4444
4713
  mapping : `FeatureSpec`
@@ -4456,6 +4725,9 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
4456
4725
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
4457
4726
  show_legend : bool, default=True
4458
4727
  False - do not show legend for this layer.
4728
+ manual_key : str or `layer_key`
4729
+ The key to show in the manual legend.
4730
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
4459
4731
  sampling : `FeatureSpec`
4460
4732
  Result of the call to the `sampling_xxx()` function.
4461
4733
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -4495,7 +4767,6 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
4495
4767
 
4496
4768
  Notes
4497
4769
  -----
4498
- `geom_density2df()` fills density contours.
4499
4770
 
4500
4771
  Computed variables:
4501
4772
 
@@ -4507,8 +4778,9 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
4507
4778
  - x : x-axis coordinates.
4508
4779
  - alpha : transparency level of a layer. Accept values between 0 and 1.
4509
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").
4781
+ - weight : used by 'density2df' stat to compute weighted density.
4510
4782
 
4511
- |
4783
+ ----
4512
4784
 
4513
4785
  'density2df' statistical transformation combined with parameter value `contour=False`
4514
4786
  could be used to draw heatmaps (see the example below).
@@ -4635,6 +4907,7 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
4635
4907
  stat=stat,
4636
4908
  position=position,
4637
4909
  show_legend=show_legend,
4910
+ manual_key=manual_key,
4638
4911
  sampling=sampling,
4639
4912
  tooltips=tooltips,
4640
4913
  kernel=kernel,
@@ -4646,7 +4919,8 @@ def geom_density2df(mapping=None, *, data=None, stat=None, position=None, show_l
4646
4919
  **other_args)
4647
4920
 
4648
4921
 
4649
- def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
4922
+ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
4923
+ tooltips=None,
4650
4924
  width=None, height=None,
4651
4925
  color_by=None, fill_by=None,
4652
4926
  seed=None,
@@ -4676,6 +4950,9 @@ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legen
4676
4950
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
4677
4951
  show_legend : bool, default=True
4678
4952
  False - do not show legend for this layer.
4953
+ manual_key : str or `layer_key`
4954
+ The key to show in the manual legend.
4955
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
4679
4956
  sampling : `FeatureSpec`
4680
4957
  Result of the call to the `sampling_xxx()` function.
4681
4958
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -4766,6 +5043,7 @@ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legen
4766
5043
  stat=stat,
4767
5044
  position=position,
4768
5045
  show_legend=show_legend,
5046
+ manual_key=manual_key,
4769
5047
  sampling=sampling,
4770
5048
  tooltips=tooltips,
4771
5049
  width=width, height=height,
@@ -4774,7 +5052,8 @@ def geom_jitter(mapping=None, *, data=None, stat=None, position=None, show_legen
4774
5052
  **other_args)
4775
5053
 
4776
5054
 
4777
- def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
5055
+ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
5056
+ tooltips=None,
4778
5057
  distribution=None,
4779
5058
  dparams=None,
4780
5059
  color_by=None, fill_by=None,
@@ -4805,6 +5084,9 @@ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=No
4805
5084
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
4806
5085
  show_legend : bool, default=True
4807
5086
  False - do not show legend for this layer.
5087
+ manual_key : str or `layer_key`
5088
+ The key to show in the manual legend.
5089
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
4808
5090
  sampling : `FeatureSpec`
4809
5091
  Result of the call to the `sampling_xxx()` function.
4810
5092
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -4895,6 +5177,7 @@ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=No
4895
5177
  stat=stat,
4896
5178
  position=position,
4897
5179
  show_legend=show_legend,
5180
+ manual_key=manual_key,
4898
5181
  sampling=sampling,
4899
5182
  tooltips=tooltips,
4900
5183
  distribution=distribution,
@@ -4903,7 +5186,8 @@ def geom_qq(mapping=None, *, data=None, stat=None, position=None, show_legend=No
4903
5186
  **other_args)
4904
5187
 
4905
5188
 
4906
- def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
5189
+ def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
5190
+ tooltips=None,
4907
5191
  color_by=None, fill_by=None,
4908
5192
  **other_args):
4909
5193
  """
@@ -4932,6 +5216,9 @@ def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=N
4932
5216
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
4933
5217
  show_legend : bool, default=True
4934
5218
  False - do not show legend for this layer.
5219
+ manual_key : str or `layer_key`
5220
+ The key to show in the manual legend.
5221
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
4935
5222
  sampling : `FeatureSpec`
4936
5223
  Result of the call to the `sampling_xxx()` function.
4937
5224
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -4997,13 +5284,15 @@ def geom_qq2(mapping=None, *, data=None, stat=None, position=None, show_legend=N
4997
5284
  stat=stat,
4998
5285
  position=position,
4999
5286
  show_legend=show_legend,
5287
+ manual_key=manual_key,
5000
5288
  sampling=sampling,
5001
5289
  tooltips=tooltips,
5002
5290
  color_by=color_by, fill_by=fill_by,
5003
5291
  **other_args)
5004
5292
 
5005
5293
 
5006
- def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
5294
+ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
5295
+ tooltips=None,
5007
5296
  distribution=None,
5008
5297
  dparams=None,
5009
5298
  quantiles=None,
@@ -5035,6 +5324,9 @@ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_lege
5035
5324
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5036
5325
  show_legend : bool, default=True
5037
5326
  False - do not show legend for this layer.
5327
+ manual_key : str or `layer_key`
5328
+ The key to show in the manual legend.
5329
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
5038
5330
  sampling : `FeatureSpec`
5039
5331
  Result of the call to the `sampling_xxx()` function.
5040
5332
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -5121,6 +5413,7 @@ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_lege
5121
5413
  stat=stat,
5122
5414
  position=position,
5123
5415
  show_legend=show_legend,
5416
+ manual_key=manual_key,
5124
5417
  sampling=sampling,
5125
5418
  tooltips=tooltips,
5126
5419
  distribution=distribution,
@@ -5130,7 +5423,8 @@ def geom_qq_line(mapping=None, *, data=None, stat=None, position=None, show_lege
5130
5423
  **other_args)
5131
5424
 
5132
5425
 
5133
- def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
5426
+ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
5427
+ sampling=None, tooltips=None,
5134
5428
  quantiles=None,
5135
5429
  color_by=None,
5136
5430
  **other_args):
@@ -5160,6 +5454,9 @@ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_leg
5160
5454
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5161
5455
  show_legend : bool, default=True
5162
5456
  False - do not show legend for this layer.
5457
+ manual_key : str or `layer_key`
5458
+ The key to show in the manual legend.
5459
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
5163
5460
  sampling : `FeatureSpec`
5164
5461
  Result of the call to the `sampling_xxx()` function.
5165
5462
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -5217,6 +5514,7 @@ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_leg
5217
5514
  stat=stat,
5218
5515
  position=position,
5219
5516
  show_legend=show_legend,
5517
+ manual_key=manual_key,
5220
5518
  sampling=sampling,
5221
5519
  tooltips=tooltips,
5222
5520
  quantiles=quantiles,
@@ -5224,7 +5522,8 @@ def geom_qq2_line(mapping=None, *, data=None, stat=None, position=None, show_leg
5224
5522
  **other_args)
5225
5523
 
5226
5524
 
5227
- def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
5525
+ def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
5526
+ sampling=None, tooltips=None,
5228
5527
  orientation=None,
5229
5528
  color_by=None,
5230
5529
  **other_args):
@@ -5254,6 +5553,9 @@ def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_leg
5254
5553
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5255
5554
  show_legend : bool, default=True
5256
5555
  False - do not show legend for this layer.
5556
+ manual_key : str or `layer_key`
5557
+ The key to show in the manual legend.
5558
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
5257
5559
  sampling : `FeatureSpec`
5258
5560
  Result of the call to the `sampling_xxx()` function.
5259
5561
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -5332,6 +5634,7 @@ def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_leg
5332
5634
  stat=stat,
5333
5635
  position=position,
5334
5636
  show_legend=show_legend,
5637
+ manual_key=manual_key,
5335
5638
  sampling=sampling,
5336
5639
  tooltips=tooltips,
5337
5640
  orientation=orientation,
@@ -5339,7 +5642,8 @@ def geom_freqpoly(mapping=None, *, data=None, stat=None, position=None, show_leg
5339
5642
  **other_args)
5340
5643
 
5341
5644
 
5342
- def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
5645
+ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
5646
+ tooltips=None,
5343
5647
  direction=None,
5344
5648
  color_by=None,
5345
5649
  **other_args):
@@ -5368,6 +5672,9 @@ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=
5368
5672
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5369
5673
  show_legend : bool, default=True
5370
5674
  False - do not show legend for this layer.
5675
+ manual_key : str or `layer_key`
5676
+ The key to show in the manual legend.
5677
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
5371
5678
  sampling : `FeatureSpec`
5372
5679
  Result of the call to the `sampling_xxx()` function.
5373
5680
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -5444,6 +5751,7 @@ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=
5444
5751
  stat=stat,
5445
5752
  position=position,
5446
5753
  show_legend=show_legend,
5754
+ manual_key=manual_key,
5447
5755
  sampling=sampling,
5448
5756
  tooltips=tooltips,
5449
5757
  direction=direction,
@@ -5451,7 +5759,8 @@ def geom_step(mapping=None, *, data=None, stat=None, position=None, show_legend=
5451
5759
  **other_args)
5452
5760
 
5453
5761
 
5454
- def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
5762
+ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
5763
+ tooltips=None,
5455
5764
  map=None, map_join=None, use_crs=None,
5456
5765
  color_by=None, fill_by=None,
5457
5766
  **other_args):
@@ -5475,6 +5784,9 @@ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=
5475
5784
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5476
5785
  show_legend : bool, default=True
5477
5786
  False - do not show legend for this layer.
5787
+ manual_key : str or `layer_key`
5788
+ The key to show in the manual legend.
5789
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
5478
5790
  sampling : `FeatureSpec`
5479
5791
  Result of the call to the `sampling_xxx()` function.
5480
5792
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -5523,13 +5835,13 @@ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=
5523
5835
  - size : lines width.
5524
5836
  - linetype : type of the line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
5525
5837
 
5526
- |
5838
+ ----
5527
5839
 
5528
5840
  The `data` and `map` parameters of `GeoDataFrame` type support shapes `MultiPoint`, `Line`, `MultiLine`, `Polygon` and `MultiPolygon`.
5529
5841
 
5530
5842
  The `map` parameter of `Geocoder` type implicitly invokes `limits()` function.
5531
5843
 
5532
- |
5844
+ ----
5533
5845
 
5534
5846
  The conventions for the values of `map_join` parameter are as follows:
5535
5847
 
@@ -5610,6 +5922,7 @@ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=
5610
5922
  stat=stat,
5611
5923
  position=position,
5612
5924
  show_legend=show_legend,
5925
+ manual_key=manual_key,
5613
5926
  sampling=sampling,
5614
5927
  tooltips=tooltips,
5615
5928
  map=map, map_join=map_join, use_crs=use_crs,
@@ -5617,7 +5930,8 @@ def geom_rect(mapping=None, *, data=None, stat=None, position=None, show_legend=
5617
5930
  **other_args)
5618
5931
 
5619
5932
 
5620
- def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
5933
+ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
5934
+ tooltips=None,
5621
5935
  arrow=None, flat=None, geodesic=None, spacer=None, color_by=None, **other_args):
5622
5936
  """
5623
5937
  Draw a straight line segment between two points.
@@ -5644,6 +5958,9 @@ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_lege
5644
5958
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5645
5959
  show_legend : bool, default=True
5646
5960
  False - do not show legend for this layer.
5961
+ manual_key : str or `layer_key`
5962
+ The key to show in the manual legend.
5963
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
5647
5964
  sampling : `FeatureSpec`
5648
5965
  Result of the call to the `sampling_xxx()` function.
5649
5966
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -5756,6 +6073,7 @@ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_lege
5756
6073
  stat=stat,
5757
6074
  position=position,
5758
6075
  show_legend=show_legend,
6076
+ manual_key=manual_key,
5759
6077
  sampling=sampling,
5760
6078
  tooltips=tooltips,
5761
6079
  arrow=arrow,
@@ -5766,7 +6084,8 @@ def geom_segment(mapping=None, *, data=None, stat=None, position=None, show_lege
5766
6084
  **other_args)
5767
6085
 
5768
6086
 
5769
- def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
6087
+ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
6088
+ tooltips=None,
5770
6089
  arrow=None,
5771
6090
  curvature=None, angle=None, ncp=None,
5772
6091
  spacer=None,
@@ -5796,6 +6115,9 @@ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend
5796
6115
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5797
6116
  show_legend : bool, default=True
5798
6117
  False - do not show legend for this layer.
6118
+ manual_key : str or `layer_key`
6119
+ The key to show in the manual legend.
6120
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
5799
6121
  sampling : `FeatureSpec`
5800
6122
  Result of the call to the `sampling_xxx()` function.
5801
6123
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -5909,6 +6231,7 @@ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend
5909
6231
  stat=stat,
5910
6232
  position=position,
5911
6233
  show_legend=show_legend,
6234
+ manual_key=manual_key,
5912
6235
  sampling=sampling,
5913
6236
  tooltips=tooltips,
5914
6237
  arrow=arrow,
@@ -5918,7 +6241,8 @@ def geom_curve(mapping=None, *, data=None, stat=None, position=None, show_legend
5918
6241
  **other_args)
5919
6242
 
5920
6243
 
5921
- def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, sampling=None, tooltips=None,
6244
+ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, manual_key=None, sampling=None,
6245
+ tooltips=None,
5922
6246
  arrow=None, pivot=None,
5923
6247
  color_by=None, **other_args):
5924
6248
  """
@@ -5939,6 +6263,9 @@ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, samp
5939
6263
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
5940
6264
  show_legend : bool, default=True
5941
6265
  False - do not show legend for this layer.
6266
+ manual_key : str or `layer_key`
6267
+ The key to show in the manual legend.
6268
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
5942
6269
  sampling : `FeatureSpec`
5943
6270
  Result of the call to the `sampling_xxx()` function.
5944
6271
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -6038,6 +6365,7 @@ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, samp
6038
6365
  stat=None,
6039
6366
  position=position,
6040
6367
  show_legend=show_legend,
6368
+ manual_key=manual_key,
6041
6369
  sampling=sampling,
6042
6370
  tooltips=tooltips,
6043
6371
  arrow=arrow,
@@ -6046,7 +6374,8 @@ def geom_spoke(mapping=None, *, data=None, position=None, show_legend=None, samp
6046
6374
  **other_args)
6047
6375
 
6048
6376
 
6049
- def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
6377
+ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
6378
+ tooltips=None,
6050
6379
  map=None, map_join=None, use_crs=None,
6051
6380
  label_format=None,
6052
6381
  na_text=None,
@@ -6079,6 +6408,9 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
6079
6408
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
6080
6409
  show_legend : bool, default=True
6081
6410
  False - do not show legend for this layer.
6411
+ manual_key : str or `layer_key`
6412
+ The key to show in the manual legend.
6413
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
6082
6414
  sampling : `FeatureSpec`
6083
6415
  Result of the call to the `sampling_xxx()` function.
6084
6416
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -6146,13 +6478,13 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
6146
6478
  - angle : text rotation angle in degrees.
6147
6479
  - lineheight : line height multiplier applied to the font size in the case of multi-line text.
6148
6480
 
6149
- |
6481
+ ----
6150
6482
 
6151
6483
  The `data` and `map` parameters of `GeoDataFrame` type support shapes `Point` and `MultiPoint`.
6152
6484
 
6153
6485
  The `map` parameter of `Geocoder` type implicitly invokes `centroids()` function.
6154
6486
 
6155
- |
6487
+ ----
6156
6488
 
6157
6489
  The conventions for the values of `map_join` parameter are as follows:
6158
6490
 
@@ -6255,6 +6587,7 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
6255
6587
  stat=stat,
6256
6588
  position=position,
6257
6589
  show_legend=show_legend,
6590
+ manual_key=manual_key,
6258
6591
  sampling=sampling,
6259
6592
  tooltips=tooltips,
6260
6593
  map=map, map_join=map_join, use_crs=use_crs,
@@ -6266,7 +6599,8 @@ def geom_text(mapping=None, *, data=None, stat=None, position=None, show_legend=
6266
6599
  **other_args)
6267
6600
 
6268
6601
 
6269
- def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
6602
+ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
6603
+ tooltips=None,
6270
6604
  map=None, map_join=None, use_crs=None,
6271
6605
  label_format=None,
6272
6606
  na_text=None,
@@ -6301,6 +6635,9 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
6301
6635
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
6302
6636
  show_legend : bool, default=True
6303
6637
  False - do not show legend for this layer.
6638
+ manual_key : str or `layer_key`
6639
+ The key to show in the manual legend.
6640
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
6304
6641
  sampling : `FeatureSpec`
6305
6642
  Result of the call to the `sampling_xxx()` function.
6306
6643
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -6379,13 +6716,13 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
6379
6716
  - angle : rotation angle in degrees.
6380
6717
  - lineheight : line height multiplier applied to the font size in the case of multi-line text.
6381
6718
 
6382
- |
6719
+ ----
6383
6720
 
6384
6721
  The `data` and `map` parameters of `GeoDataFrame` type support shapes `Point` and `MultiPoint`.
6385
6722
 
6386
6723
  The `map` parameter of `Geocoder` type implicitly invokes `centroids()` function.
6387
6724
 
6388
- |
6725
+ ----
6389
6726
 
6390
6727
  The conventions for the values of `map_join` parameter are as follows:
6391
6728
 
@@ -6489,6 +6826,7 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
6489
6826
  stat=stat,
6490
6827
  position=position,
6491
6828
  show_legend=show_legend,
6829
+ manual_key=manual_key,
6492
6830
  sampling=sampling,
6493
6831
  tooltips=tooltips,
6494
6832
  map=map, map_join=map_join, use_crs=use_crs,
@@ -6504,7 +6842,8 @@ def geom_label(mapping=None, *, data=None, stat=None, position=None, show_legend
6504
6842
  **other_args)
6505
6843
 
6506
6844
 
6507
- def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None, labels=None,
6845
+ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
6846
+ tooltips=None, labels=None,
6508
6847
  map=None, map_join=None, use_crs=None,
6509
6848
  hole=None,
6510
6849
  stroke_side=None,
@@ -6534,6 +6873,9 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
6534
6873
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
6535
6874
  show_legend : bool, default=True
6536
6875
  False - do not show legend for this layer.
6876
+ manual_key : str or `layer_key`
6877
+ The key to show in the manual legend.
6878
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
6537
6879
  sampling : `FeatureSpec`
6538
6880
  Result of the call to the `sampling_xxx()` function.
6539
6881
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -6606,13 +6948,13 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
6606
6948
  - stroke : width of inner and outer arcs of pie sector.
6607
6949
  - color : color of inner and outer arcs of pie sector.
6608
6950
 
6609
- |
6951
+ ----
6610
6952
 
6611
6953
  The `data` and `map` parameters of `GeoDataFrame` type support shapes `Point` and `MultiPoint`.
6612
6954
 
6613
6955
  The `map` parameter of `Geocoder` type implicitly invokes `centroids()` function.
6614
6956
 
6615
- |
6957
+ ----
6616
6958
 
6617
6959
  The conventions for the values of `map_join` parameter are as follows:
6618
6960
 
@@ -6636,8 +6978,6 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
6636
6978
 
6637
6979
  - map_join=['County_name', 'State_Name']
6638
6980
 
6639
- |
6640
-
6641
6981
  Examples
6642
6982
  --------
6643
6983
  .. jupyter-execute::
@@ -6677,10 +7017,9 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
6677
7017
 
6678
7018
  .. jupyter-execute::
6679
7019
  :linenos:
6680
- :emphasize-lines: 5-9
7020
+ :emphasize-lines: 4-8
6681
7021
 
6682
7022
  from lets_plot import *
6683
- from lets_plot.mapping import *
6684
7023
  LetsPlot.setup_html()
6685
7024
  data = {'name': ['a', 'b', 'c', 'd', 'b'], 'value': [40, 90, 10, 50, 20]}
6686
7025
  ggplot(data) + geom_pie(aes(fill=as_discrete('name', order_by='..count..'), weight='value'), \\
@@ -6693,10 +7032,9 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
6693
7032
 
6694
7033
  .. jupyter-execute::
6695
7034
  :linenos:
6696
- :emphasize-lines: 5-7
7035
+ :emphasize-lines: 4-6
6697
7036
 
6698
7037
  from lets_plot import *
6699
- from lets_plot.mapping import *
6700
7038
  LetsPlot.setup_html()
6701
7039
  data = {'name': ['a', 'b', 'c', 'd', 'b'], 'value': [40, 90, 10, 50, 20]}
6702
7040
  ggplot(data) + geom_pie(aes(fill=as_discrete('name', order_by='..count..'), weight='value'), \\
@@ -6732,6 +7070,7 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
6732
7070
  stat=stat,
6733
7071
  position=position,
6734
7072
  show_legend=show_legend,
7073
+ manual_key=manual_key,
6735
7074
  sampling=sampling,
6736
7075
  tooltips=tooltips,
6737
7076
  labels=labels,
@@ -6745,7 +7084,8 @@ def geom_pie(mapping=None, *, data=None, stat=None, position=None, show_legend=N
6745
7084
  **other_args)
6746
7085
 
6747
7086
 
6748
- def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
7087
+ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None,
7088
+ sampling=None, tooltips=None,
6749
7089
  orientation=None,
6750
7090
  dir=None, fatten=None, slope=None, intercept=None,
6751
7091
  color_by=None, fill_by=None,
@@ -6775,6 +7115,9 @@ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_leg
6775
7115
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
6776
7116
  show_legend : bool, default=True
6777
7117
  False - do not show legend for this layer.
7118
+ manual_key : str or `layer_key`
7119
+ The key to show in the manual legend.
7120
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
6778
7121
  sampling : `FeatureSpec`
6779
7122
  Result of the call to the `sampling_xxx()` function.
6780
7123
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -6824,7 +7167,7 @@ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_leg
6824
7167
  - linewidth : stick width.
6825
7168
  - linetype : type of the stick line. Codes and names: 0 = 'blank', 1 = 'solid', 2 = 'dashed', 3 = 'dotted', 4 = 'dotdash', 5 = 'longdash', 6 = 'twodash'.
6826
7169
 
6827
- |
7170
+ ----
6828
7171
 
6829
7172
  When `slope=0`, the baseline cannot be parallel to the lollipop sticks.
6830
7173
  So, in this case, if `dir='h'`, the baseline will becomes vertical, as for infinity slope.
@@ -6885,6 +7228,7 @@ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_leg
6885
7228
  stat=stat,
6886
7229
  position=position,
6887
7230
  show_legend=show_legend,
7231
+ manual_key=manual_key,
6888
7232
  sampling=sampling,
6889
7233
  tooltips=tooltips,
6890
7234
  orientation=orientation,
@@ -6893,7 +7237,8 @@ def geom_lollipop(mapping=None, *, data=None, stat=None, position=None, show_leg
6893
7237
  **other_args)
6894
7238
 
6895
7239
 
6896
- def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend=None, sampling=None, tooltips=None,
7240
+ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend=None, manual_key=None, sampling=None,
7241
+ tooltips=None,
6897
7242
  color_by=None, fill_by=None,
6898
7243
  **other_args):
6899
7244
  """
@@ -6916,6 +7261,9 @@ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend
6916
7261
  'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
6917
7262
  show_legend : bool, default=True
6918
7263
  False - do not show legend for this layer.
7264
+ manual_key : str or `layer_key`
7265
+ The key to show in the manual legend.
7266
+ Specify text for the legend label or advanced settings using the `layer_key()` function.
6919
7267
  sampling : `FeatureSpec`
6920
7268
  Result of the call to the `sampling_xxx()` function.
6921
7269
  To prevent any sampling for this layer pass value "none" (string "none").
@@ -6956,16 +7304,14 @@ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend
6956
7304
  - size : size of the point.
6957
7305
  - stroke : width of the shape border. Applied only to the shapes having border.
6958
7306
 
6959
-
6960
7307
  Examples
6961
7308
  --------
6962
7309
  .. jupyter-execute::
6963
7310
  :linenos:
6964
- :emphasize-lines: 10
7311
+ :emphasize-lines: 9
6965
7312
 
6966
7313
  import numpy as np
6967
7314
  from lets_plot import *
6968
- from lets_plot.mapping import as_discrete
6969
7315
  LetsPlot.setup_html()
6970
7316
  n = 50
6971
7317
  np.random.seed(42)
@@ -6978,11 +7324,10 @@ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend
6978
7324
 
6979
7325
  .. jupyter-execute::
6980
7326
  :linenos:
6981
- :emphasize-lines: 10
7327
+ :emphasize-lines: 9
6982
7328
 
6983
7329
  import numpy as np
6984
7330
  from lets_plot import *
6985
- from lets_plot.mapping import as_discrete
6986
7331
  LetsPlot.setup_html()
6987
7332
  n = 50
6988
7333
  np.random.seed(42)
@@ -6999,6 +7344,7 @@ def geom_count(mapping=None, *, data=None, stat=None, position=None, show_legend
6999
7344
  stat=stat,
7000
7345
  position=position,
7001
7346
  show_legend=show_legend,
7347
+ manual_key=manual_key,
7002
7348
  sampling=sampling,
7003
7349
  tooltips=tooltips,
7004
7350
  color_by=color_by, fill_by=fill_by,
@@ -7011,6 +7357,7 @@ def _geom(name, *,
7011
7357
  stat=None,
7012
7358
  position=None,
7013
7359
  show_legend=None,
7360
+ manual_key=None,
7014
7361
  sampling=None,
7015
7362
  tooltips=None,
7016
7363
  **kwargs):
@@ -7018,11 +7365,13 @@ def _geom(name, *,
7018
7365
  if not (isinstance(mapping, FeatureSpec) and mapping.kind == 'mapping'):
7019
7366
  raise ValueError("Unexpected value for argument 'mapping'. Hint: try to use function aes()")
7020
7367
 
7021
- data, mapping, data_meta = as_annotated_data(data, mapping)
7022
-
7023
7368
  if is_geocoder(data):
7024
7369
  data = data.get_geocodes()
7025
7370
 
7371
+ data = key_int2str(data)
7372
+
7373
+ data, mapping, data_meta = as_annotated_data(data, mapping)
7374
+
7026
7375
  # GDF in a map parameter has higher priority for defining a geo_data_meta
7027
7376
  if is_geo_data_frame(data) and not is_geo_data_frame(kwargs.get('map')):
7028
7377
  data = geo_data_frame_to_crs(data, kwargs.get('use_crs'))
@@ -7034,6 +7383,7 @@ def _geom(name, *,
7034
7383
  mapping=mapping,
7035
7384
  position=position,
7036
7385
  show_legend=show_legend,
7386
+ manual_key=manual_key,
7037
7387
  sampling=sampling,
7038
7388
  tooltips=tooltips,
7039
7389
  **data_meta,