Lets-plot

Added
- `coordPolar()`

The polar coordinate system is most commonly used for pie charts, but </br>
it can also be used for constructing **Spider or Radar charts** using the `flat` option.

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

- In the `theme()` function:
- `panelInset` parameter - primarily used for plots with polar coordinates.

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

- `panelBorderOntop` parameter - enables the drawing of panel border on top of the plot geoms.
- `panelGridOntop, panelGridOntopX, panelGridOntopY` parameters - enable the drawing of grid lines on top of the plot geoms.

- `geomCurve()`

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

- [**UNIQUE**] Visualizing graph-like data with `geomSegment()` and `geomCurve()`.

- Aesthetics `sizeStart, sizeEnd, strokeStart` and `strokeEnd` enable better alignment of</br>
segments/curves with nodes of the graph by considering the size of the nodes.

- The `spacer` parameter allows for additional manual fine-tuning.

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

- `alphaStroke` parameter in `geomLabel()` to enable the applying of `alpha` to `color` [[1029](https://github.com/JetBrains/lets-plot/issues/1029)].

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

Changed

- Parameter `axisOntop` in `theme()` is now `true` by default.

Fixed

- Bug with Tooltips in Swing/Batik [[LPK-225](https://github.com/JetBrains/lets-plot-kotlin/issues/225)].
- coordMap() should distort tiles size to account for different unit size at different latitudes [[331](https://github.com/JetBrains/lets-plot/issues/331)].
- geomErrorbar(): wrong positioning of tooltips [[992](https://github.com/JetBrains/lets-plot/issues/992)].
- geomPath(): tooltip position interpolation [[855](https://github.com/JetBrains/lets-plot/issues/855)].
- Stacked bar-chart annotation: labels go out of the plot when zooming-in using coord_cartesian(xlim, ylim) [[981](https://github.com/JetBrains/lets-plot/issues/981)].
- Facets: "free scales" options are ignored by discrete axis [[955](https://github.com/JetBrains/lets-plot/issues/955)].
- Bar width is too large when x-domain is defined via x-scale limits [[1013](https://github.com/JetBrains/lets-plot/issues/1013)].
- How to hide only main tooltip? [[LPK-232](https://github.com/JetBrains/lets-plot-kotlin/issues/232)].
- Make middle strip in `geomCrossbar()` optional [[LPK-233](https://github.com/JetBrains/lets-plot-kotlin/issues/233)].
- Can't set `null` for coord limit [[486](https://github.com/JetBrains/lets-plot/issues/486)].
- Scale limits don't work for bars/area [[LPK-219](https://github.com/JetBrains/lets-plot-kotlin/issues/219)], [[#978](https://github.com/JetBrains/lets-plot/issues/978)].
- No gridlines when axisOntop=True [[1012](https://github.com/JetBrains/lets-plot/issues/1012)].
- Displaying tooltips on a multilayer plot [[1030](https://github.com/JetBrains/lets-plot/issues/1030)].
- Make segment geometry better suited for graphs visualization [[572](https://github.com/JetBrains/lets-plot/issues/572)].

Added

Changed

Fixed

Fixed

- macOS: incorrect system libraries linkage that may lead to Lets-Plot import failure:<br>
libc++abi: Terminating due to typed operator new being invoked before its static initializer in libcxx has been executed.


- `geom_livemap()`: map zoom freezes after multiple rapid clicks on +/- buttons [[1315](https://github.com/JetBrains/lets-plot/issues/1315)].
- Misleading warnings when using CARTO 'base-midnight', 'base-antique' and 'base-flatblue' tilesets in livemap.

Changed

- [**BREAKING**] the `height` and `height_unit` parameters have been deprecated for the `geom_errorbar`.

- the minimum distance between axis labels was reduced to avoid unsuitable layouts.

Fixed

- `geom_errorbar()`: the plot domain is always stretched to zero, regardless of the data.

- overlapped axis labels when using `hjust/vjust` or multiline text.

Added

- Grouping plots:
- `ggbunch()` function: combining plots with custom layout.

See demos:
- [Indonesia Volcanic Activity](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/ggbunch_indonesia.ipynb).
- [Magnifier Inset Effect](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/magnifier_inset.ipynb).

- Support for plot **title, subtitle, caption, margins** and **insets** in `gggrid()` and `ggbunch()`.

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

See: [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/geom_hex.ipynb).

- Parameters `width_unit` and `height_unit` in `geom_errorbar()`, `geom_boxplot()`, `geom_crossbar()`, `geom_tile()` and `geom_hex()` [[1288](https://github.com/JetBrains/lets-plot/issues/1288)]:

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/param_width_unit.ipynb).

- Parameters `start` and `direction` in `geom_pie()` [[1280]](https://github.com/JetBrains/lets-plot/issues/1280).

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/geom_pie_params.ipynb).

- Texts and labels:
- `hjust` and `vjust` parameters for axis labels [[1227](https://github.com/JetBrains/lets-plot/issues/1227)],[[#1230](https://github.com/JetBrains/lets-plot/issues/1230)].

See: [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/axis_label_justification.ipynb).

- multiline support for axis labels [[948](https://github.com/JetBrains/lets-plot/issues/948)].

See: [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/multiline_axis_labels.ipynb).

- Markdown support for plot **title**, **subtitle**, **caption**, and axis labels [[1256](https://github.com/JetBrains/lets-plot/issues/1256)].

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/markdown.ipynb).

- In the `nudge` position adjustment -
the ability to specify absolute shift values for `nudge`:
- `unit` parameter in `position_nudge()`.
- `nudge_unit` parameter in `geom_text()` and `geom_label()`

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/position_nudge_unit.ipynb).

- Theme:
- Parameters `legend_ticks` and `legend_ticks_length` for fine-grained control over colorbar tick marks [[1262](https://github.com/JetBrains/lets-plot/issues/1262)].

See: [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-25a/theme_legend_ticks.ipynb).

- Parameter `spacer` in `image_matrix()` function.

- `transparent`/`blank`/`''` color [[1281](https://github.com/JetBrains/lets-plot/issues/1281)].

Changed

- [**DEPRECATED**] class `GGBunch` is deprecated. Please use `ggbunch()` function instead.
- Axis breaks: changed default `lower_exp_bound` to -7 and `upper_exp_bound` to 6 (same as in `theme(...)`).
- Axis labels: changed default justification for rotated labels.
- Axis labels: changed orientation of automatic vertical labels.
- [**BREAKING**] geoms `tile, bin2d, contour, contourf, density2d, density2df` : default coordinate system changed from 'fixed' to 'cartesian'.
- [**BREAKING**] tiles in `geom_bin2d()` are sized according to the `binwidth` value, not the maximum possible.
- [**BREAKING**] only Lets-Plot/JS users: signature of "buildPlotFromXXX" functions changed, see current Kotlin/JS declarations:
- [`buildPlotFromRawSpecs()`](https://github.com/JetBrains/lets-plot/blob/38d0b24ecb3c74420814da8a66a91819d84bedd7/js-package/src/jsMain/kotlin/MonolithicJs.kt#L81)
- [`buildPlotFromProcessedSpecs()`](https://github.com/JetBrains/lets-plot/blob/38d0b24ecb3c74420814da8a66a91819d84bedd7/js-package/src/jsMain/kotlin/MonolithicJs.kt#L158)
- [**BREAKING**] Maven artifacts (doesn't affect Python users):
- artifacts `platf-awt`, `platf-batik`, `platf-jfx-swing` are no longer published with a "-jvm" suffix.
Before, these artifacts could be used in dependencies either with or without the "-jvm" suffix. Now only without suffix.
- artifact "org.jetbrains.lets-plot:deprecated-in-v4-jvm" is removed.

Fixed
- Incorrectly rendered Area chart [[1295](https://github.com/JetBrains/lets-plot/issues/1295)].
- Tooltip should not cover and hide the geometry that it provides info for [[1275](https://github.com/JetBrains/lets-plot/issues/1275)].
- General purpose `scale_continuous`: can't use the `expand` parameter [[1285](https://github.com/JetBrains/lets-plot/issues/1285)].
- Error when using `stat='summary'` if the data contains NaN values [[1301](https://github.com/JetBrains/lets-plot/issues/1301)].
- Broken `plot_background` in `gggrid` [[1124](https://github.com/JetBrains/lets-plot/issues/1124)].
- `plot_background` not inheriting from `rect` [[1278](https://github.com/JetBrains/lets-plot/issues/1278)]
- `gggrid`: allow title and other labels for the entire figure [[715](https://github.com/JetBrains/lets-plot/issues/715)].
- `ggbunch`: overall title [[321](https://github.com/JetBrains/lets-plot/issues/321)].
- Expand discrete axis according to tile size with `geom_tile` [[1284](https://github.com/JetBrains/lets-plot/issues/1284)].
- `geom_bin2d` implodes when the disparity in axes units is large [[1303](https://github.com/JetBrains/lets-plot/issues/1303)].
- Livemap: parameters nudge_x and nudge_y have no effect on `geom_text` or `geom_label` [[1048](https://github.com/JetBrains/lets-plot/issues/1048)].
- Livemap: Add zooming-in for `geom_text()/geom_label()` [[1059](https://github.com/JetBrains/lets-plot/issues/1059)].

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)].