Lets-plot

Changed

- Number formatting:
- We have aligned our specifications with D3.js (rather than Python): `g` format type with `~` (e.g. `~g`) now truncates trailing zeros, and without `~` it doesn't.
- The default number formatter now respects `theme(exponent_format=...)` settings and does not use 's' format type for large numbers.
- Legends with more than 200 items are now not rendered.

Fixed
- Bad precision in the default tooltip format when using coord limits [[1134](https://github.com/JetBrains/lets-plot/issues/1134)].
- Display integer values without fractional part in tooltips [[1186](https://github.com/JetBrains/lets-plot/issues/1186)].
- Suboptimal tooltip positioning in facets [[1187](https://github.com/JetBrains/lets-plot/issues/1187)].
- Incorrect Y-axis layout with facets and panel_inset [[1194](https://github.com/JetBrains/lets-plot/issues/1194)].
- Grouped plot hits the limit of 1000 and doesn't render with not-friendly exception [[1224](https://github.com/JetBrains/lets-plot/issues/1224)].
- Kandy toPNG reports NullPointerException [[1228](https://github.com/JetBrains/lets-plot/issues/1228)]
- lets_plot_kotlin_bridge is unable to locate libc++.1.dylib, I am using Mac m2 [[1234](https://github.com/JetBrains/lets-plot/issues/1234)].
- Wrong formatting when type='g' for small values [[1238](https://github.com/JetBrains/lets-plot/issues/1238)].
- Formatting when type='g' for large values throws exception [[1239](https://github.com/JetBrains/lets-plot/issues/1239)].
- Wrong formatting when type='s' with explicit precision [[1240](https://github.com/JetBrains/lets-plot/issues/1240)].
- Extra trim in formatted number when type='g' [[1241](https://github.com/JetBrains/lets-plot/issues/1241)].
- Axis breaks are badly formatted if explicitly set [[1245](https://github.com/JetBrains/lets-plot/issues/1245)].
- Badly formatted zero break for the "~g" format [[1246](https://github.com/JetBrains/lets-plot/issues/1246)].
- How to adjust the vertical position of geom_text when using position_dodge [[1248](https://github.com/JetBrains/lets-plot/issues/1248)].
- Incorrect result for format(9.999, ".2f") [[1251](https://github.com/JetBrains/lets-plot/issues/1251)].
- Tooltips overlapping when not enough vertical space for them [[1254](https://github.com/JetBrains/lets-plot/issues/1254)].
- Plot limited to 1000 lines (Internal error: IllegalStateException : Too many groups: 1099) [[1261](https://github.com/JetBrains/lets-plot/issues/1261)].
- Nice to have tooltip to inherit formatting configured for axis [[LPK-229](https://github.com/JetBrains/lets-plot-kotlin/issues/229)].

Changed

- Interact refinement:
* Dragging the plot or Livemap disables the pinned tooltip mode.
* Double-clicking the plot or Livemap disables the pinned tooltip mode.
* Ctrl + double-clicking the Livemap zooms in without the blinking fade-in effect.

Fixed

- Buttons alignment in the toolbar.
- Wheel zooming-out a plot with log positional scales crashes fast.

Added

- Python 3.13 support

- `ggtb()`: enable **zoom/pan** interactivity on plot [[983](https://github.com/JetBrains/lets-plot/issues/983)],[[#1019](https://github.com/JetBrains/lets-plot/issues/1019)]

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/interact_pan_zoom.ipynb).

- Interactive **links** in tooltips/labels/texts [[1091](https://github.com/JetBrains/lets-plot/issues/1091)].

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/interactive_links.ipynb).

- Formatting:
- **LaTeX** support: superscript, subscript ([[861](https://github.com/JetBrains/lets-plot/issues/861)]) and Greek letters ([[#960](https://github.com/JetBrains/lets-plot/issues/960)]).

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/dev/notebooks/latex_support.ipynb).

- Scientific notation: **compact form**. Enable the compact form using the `exponent_format` parameter in `theme()` [[1071](https://github.com/JetBrains/lets-plot/issues/1071)].

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/superscript_exponent.ipynb).

[**WARNING**] Subscripts and superscripts are not supported in PDF and PNG exports.

- In `theme()`:
- `legend_margin, legend_spacing, legend_spacing_x, legend_spacing_y, legend_box, legend_box_just, legend_box_spacing` parameters [[1180](https://github.com/JetBrains/lets-plot/issues/1180)].

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/theme_legend_margins.ipynb).

- `legend_key, legend_key_size, legend_key_width, legend_key_height, legend_key_spacing, legend_key_spacing_x, legend_key_spacing_y` parameters [[1181](https://github.com/JetBrains/lets-plot/issues/1181)].

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/theme_legend_key.ipynb).

- `strip_background_x, strip_background_y, strip_text_x, strip_text_y` parameters [[1195](https://github.com/JetBrains/lets-plot/issues/1195)].

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/theme_facet_strip_xy.ipynb).

- Custom `linetype` patterns [[1198](https://github.com/JetBrains/lets-plot/issues/1198)]:
- a list specifying the pattern of dashes and gaps used to draw the line: `[dash, gap, dash, gap, ...]`;
- a list with a specified offset: `[offset, [dash, gap, dash, gap, ...]]`;
- a string of an even number (up to eight) of hexadecimal digits specifying the lengths in consecutive positions in the string.

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/linetype_custom.ipynb).

- Geometries:
- `geom_blank()` [[831](https://github.com/JetBrains/lets-plot/issues/831)].

- `base` parameter in `waterfall_plot()` [[1159](https://github.com/JetBrains/lets-plot/issues/1159)].

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/waterfall_plot_base.ipynb).

- `check_overlap` parameter in `geom_text()` and `geom_label()`.

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/check_overlap.ipynb).

- `marginal` parameter in `qq_plot()`:

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/qq_plot_marginal.ipynb).

- `inherit_aes` parameter in layers [[1172](https://github.com/JetBrains/lets-plot/issues/1172)].

- `expand_limits()` [[820](https://github.com/JetBrains/lets-plot/issues/820)].

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-24g/expand_limits.ipynb).

- Support for 3-character hex color codes


Changed

- Parameters `labwidth` in `facet_wrap()`, `x_labwidth, y_labwidth` in `facet_grid()`: the maximum label length is applied after splitting at `\n` separators, if present.

- Use `theme_light()` as the default theme in `qq_plot()`.

- [**BREAKING**] For API deprecated in v4.0 the deprecation level raised to "Error" (only relevant for Kotlin clients).

- [**BREAKING**] The 'base-midnight', 'base-antique' and 'base-flatblue' tilesets are deprecated (no longer served by CARTO) and will be removed in future releases.

Fixed

- Better Marimo Support (via [PR-2084](https://github.com/marimo-team/marimo/pull/2084)) [[#1018](https://github.com/JetBrains/lets-plot/issues/1018)].
- Support layering `aes()` multiple times [[822](https://github.com/JetBrains/lets-plot/issues/822)].
- waterfall_plot: faceting doesn't work without a measure mapping [[1152](https://github.com/JetBrains/lets-plot/issues/1152)].
- waterfall_plot: tooltips don't work with column names from original dataset [[1153](https://github.com/JetBrains/lets-plot/issues/1153)].
- Legend icon background is not transparent when `legend_background` is set to "blank" in `theme` [[1167](https://github.com/JetBrains/lets-plot/issues/1167)].
- Unable to display or save graph when using geom_path [[1168](https://github.com/JetBrains/lets-plot/issues/1168)].
- Legend icon background should inherit the fill color of the plot panel (i.e. grey when `theme_grey` is used).
- Vertex sampling uses different tolerances for objects within the same plot [[1174](https://github.com/JetBrains/lets-plot/issues/1174)].
- sampling_vertex_vw doesn't work as expected [[1175](https://github.com/JetBrains/lets-plot/issues/1175)].
- sampling_vertex_dp may break rings [[1176](https://github.com/JetBrains/lets-plot/issues/1176)].
- ggmarginal: bottom boxplot is broken [[1189](https://github.com/JetBrains/lets-plot/issues/1189)].
- Offscreen cells are sometimes not rendered in JupyterLab.
- The legend_justification parameter doesn't work if the legend_position='top' [[1031](https://github.com/JetBrains/lets-plot/issues/1031)].
- coord_polar: geom_point tooltips should take in account point size [[1214](https://github.com/JetBrains/lets-plot/issues/1214)].

Added

- `geomCount()`/`statSum()` [[821](https://github.com/JetBrains/lets-plot/issues/821)].
See: [example notebook](https://nbviewer.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.3/geom_count.ipynb).
- `plotMessage` parameter in `theme(...)` [[863](https://github.com/JetBrains/lets-plot/issues/863)].
See: [example notebook](https://nbviewer.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.3/theme_plot_message.ipynb).
- KDocs for the stats.

Changed

- If layer transparency is set via the alpha-channel in the colors RGBA specification and via the `alpha` aesthetic, \
then the `alpha` aesthetic overrides the alpha-channel in the color. Previousely it was the opposite.

- `geomPie()` defaults:
- "stroke" is visible and `strokeSide="both"` (was `strokeSide="outer"`).
- the "hole" is not created automatically when `strokeSide = "both"/"inner"` (was created automatically).

- `geomBar()` now has solid outline color by default (was transparent).

- `geomTile()`, `geomBin2D()` now have solid outline color by default (was transparent).
- however, by default the `size` is 0 (i.e. tiles outline initially is not visible).

- [DEPRECATED] Function `statCount2d` has been renamed to `statCount2D`. The old name is deprecated.

Fixed

- `themeVoid()` + `flavorXxx()`: no expected plot background [[858](https://github.com/JetBrains/lets-plot/issues/858)].
- `geomTile()`, `geomBin2D()` : the `alpha` aesthetic is applied to the tiles outline.
- `scaleXDateTime()`: error building plot for early dates [[346](https://github.com/JetBrains/lets-plot/issues/346)].
- Inconsistent color in legend when using `paint_a/paint_b/paint_c` [[867](https://github.com/JetBrains/lets-plot/issues/867)].

Added

- Flavor-aware colors: **pen**, **brush** and **paper**
- By default, all geometries utilize new flavor-aware colors.
- Theme `geom` parameter allows redefinition of "geom colors": `theme(geom = elementGeom(pen, brush, paper))`.

See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.2/geom_theme_colors.ipynb).


- Support for variadic line width and/or color in `geom_line()` and `geom_path()` [[LP-313](https://github.com/JetBrains/lets-plot/issues/313)].

Ses: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.2/aes_size_color_variadic_lines.ipynb).


- `themeVoid()`:
[example notebook](https://nbviewer.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.2/theme_void.ipynb)

- `statECDF()` :
[example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.2/stat_ecdf.ipynb).

- `geomFunction()` :
[example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.2/geom_function.ipynb).

- `statSummary()`:
[example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.2/stat_summary.ipynb).

- `statSummaryBin()`:
[example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.2/stat_summary_bin.ipynb).

- `Stat.sum()` statistic:
[example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.2/stat_sum.ipynb).

- `Stat.boxplotOutlier()` statistic:
[example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.2/stat_boxplot_outlier.ipynb).


- In tooltip customization API:\
`disableSplitting()` function [[189](https://github.com/JetBrains/lets-plot-kotlin/issues/189)].

[example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.2/tooltips_disable_splitting.ipynb).


- In `geomPie()`:
- `stroke` and `color` aesthetics - the width and color of pie sector arcs.
- `strokeSide` parameter - which arcs to show (inner, outer, both).
- `spacerWidth` and `spacerColor` parameters - lines between sectors.

See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.2/geom_pie_stroke_and_spacers.ipynb).

- `sizeUnit` parameter : [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.2/geom_pie_size_unit.ipynb).


Changed

> Note: Due to major package refactoring in the main Lets-Plot library, this version (4.4.2) of the Kotlin API\
> is not compatible with versions of Lets-Plot library v3.2.0 and earlier.

- The default qualitative color palette is now [Color Brewer "Set1"](https://colorbrewer2.org/#type=qualitative&scheme=Set1&n=9) (was ["Set2"](https://colorbrewer2.org/#type=qualitative&scheme=Set2&n=8))
- Geometries default colors are now flavor-dependent: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.4.2/geom_theme_colors.ipynb).
- Geometries default size/line-width is now slightly bigger.
- Point size is adjusted to match the width of a line of the same "size".

- [BREAKING] Kotlin/JS **LEGACY** apps are no longer supported.

- [BREAKING] `geomPie()` no longer supports parameter `strokeColor`.
- [BREAKING] `geomBoxplot()` no longer support parameter `sampling`.
- [BREAKING] `geomPointRange()`: size aesthetic shouldn't affect line width [[751](https://github.com/JetBrains/lets-plot/issues/751)]:\
`linewidth` aesthetic is now used for the line width, `size` - for mid-point size only.

- `geomBoxplot()`: `size` and `stroke` parameters now affect outlier shapes.


Fixed
- ggsave: saving geomImshow() to SVG produces fuzzy picture [[188](https://github.com/JetBrains/lets-plot-kotlin/issues/188)].
- `geomCrossbar()` aesthetics take `middle` argument instead of `y` [[804](https://github.com/JetBrains/lets-plot/issues/804)].
- `geomBoxplot()` doesn't apply alpha to outliers [[754](https://github.com/JetBrains/lets-plot/issues/754)].
- `geomBoxplot()`: outliers do not show tooltips.
- `geomBoxplot()`: some strange outliers drawn here [[143](https://github.com/JetBrains/lets-plot-kotlin/issues/143)].
- `geomStep()`: no tooltips.
- `geomStep()`: add 'tooltips' parameter [[195](https://github.com/JetBrains/lets-plot-kotlin/issues/195)].
- `geomStep()`: toggle the behavior of the `direction` parameter when the orientation is changed.
- `geomRibbon()`: not all tooltips are shown on a multi-layer plot [[847](https://github.com/JetBrains/lets-plot/issues/847)].
- Bug in empty plot: IndexOutOfBoundsException [[194](https://github.com/JetBrains/lets-plot-kotlin/issues/194)].
- How to remove side tooltips without anchor? [[189](https://github.com/JetBrains/lets-plot-kotlin/issues/189)].

Added

- New variables computed by `'bin'` statistic: `'..sumprop..'`, `'..sumpct..'` [[1155](https://github.com/JetBrains/lets-plot/issues/1155)].

See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot/blob/master/docs/f-24f/new_stat_bin_vars.ipynb).

Fixed
- "cmapmpl" color scale doesn't show the entire range of colors in continuous cmap. [[1149](https://github.com/JetBrains/lets-plot/issues/1149)].
- `geom_histogram`: wrong plot area when `y='..density..'` [[1157](https://github.com/JetBrains/lets-plot/issues/1157)].