Lets-plot

This release is 100% compatible with Lets-Plot [v 4.5.1](https://github.com/JetBrains/lets-plot/releases/tag/v4.5.1),

This release is 100% compatible with Lets-Plot [v 4.5.1](https://github.com/JetBrains/lets-plot/releases/tag/v4.5.1).

Added

- `ggtb()`: enable **zoom/pan** interactivity on plot [[38](https://github.com/JetBrains/lets-plot-kotlin/issues/38)],[[#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-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.9.0/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-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.9.0/lp_verse.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-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.9.0/latex_support.ipynb).

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

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

- In `theme()`:
- parameters `legendMargin, legendSpacing, legendSpacingX, legendSpacingY, legendBoxSpacing`,

and functions `legendBoxHorizontal/Vertical(), legendBoxJustificationLeft/Right/Top/Bottom/Center()` [[1180](https://github.com/JetBrains/lets-plot/issues/1180)].

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

- parameters `legendKey, legendKeySize/Width/Height/Spacing/SpacingX/SpacingY`[[1181](https://github.com/JetBrains/lets-plot/issues/1181)].

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

- parameters `stripBackgroundX/Y, stripTextX/Y` [[1195](https://github.com/JetBrains/lets-plot/issues/1195)].

See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.9.0/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: `listOf(dash, gap, dash, gap, ...)`;
- a list with a specified offset: `listOf(offset, listOf(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-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.9.0/linetype_custom.ipynb).

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

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

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

- `checkOverlap` parameter in `geomText()` and `geomLabel()`.

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

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

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

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

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

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

- Support for 3-character hex color codes


Changed

- Parameters `labwidth` in `facetWrap()`, `xLabwidth, yLabwidth` in `facetGrid()`: the maximum label length is applied after splitting at `\n` separators, if present.

- `themeLight()` is now the default theme in `qqPlot()`.

- [**BREAKING**] For API deprecated in v4.0 the deprecation level raised to "Error".


Fixed

- waterfallPlot: faceting doesn't work without a measure mapping [[1152](https://github.com/JetBrains/lets-plot/issues/1152)].
- waterfallPlot: 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 `legendBackground` is set to "blank" in `theme` [[1167](https://github.com/JetBrains/lets-plot/issues/1167)].
- Unable to display or save graph when using geomPath [[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 `themeGrey()` is used).
- Vertex sampling uses different tolerances for objects within the same plot [[1174](https://github.com/JetBrains/lets-plot/issues/1174)].
- `samplingVertexVW()` doesn't work as expected [[1175](https://github.com/JetBrains/lets-plot/issues/1175)].
- `samplingVertexDP()` 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.
- `legendJustification()` doesn't work if `legendPositionTop()` [[1031](https://github.com/JetBrains/lets-plot/issues/1031)].
- coordPolar: geomPoint tooltips should take in account point size [[1214](https://github.com/JetBrains/lets-plot/issues/1214)].

This release is 100% compatible with Lets-Plot [v 4.4.0](https://github.com/JetBrains/lets-plot/releases/tag/v4.4.0), [v 4.4.1](https://github.com/JetBrains/lets-plot/releases/tag/v4.4.1).

Added

- Waterfall plot [[975](https://github.com/JetBrains/lets-plot/issues/975)]:

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

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

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

- Custom legends [[774](https://github.com/JetBrains/lets-plot/issues/774)]:
- `manualKey` parameter in plot layer
- `layerKey()` function

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

- In legends:
- `title` parameter in `guideLegend()` and `guideColorbar()` functions

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

- override aesthetics in the `guideLegend()` function [[807](https://github.com/JetBrains/lets-plot/issues/807)]:

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

- `plotTitlePosition` and `plotCaptionPosition` parameters in `theme()` [[1027](https://github.com/JetBrains/lets-plot/issues/1027)].

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

- `threshold` parameter in `geomHistogram()` [[1122](https://github.com/JetBrains/lets-plot/issues/1122)].

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

Changed

- The triangular point shape is now anchored to the data point via the centroid

Fixed

- ggsave (.svg) transforms geom_text integer to float [[626](https://github.com/JetBrains/lets-plot/issues/626)].
- Int DataFrame column names are being converted to float string representation [[901](https://github.com/JetBrains/lets-plot/issues/901)].
- `linetype` = 0 ("blank") should make lines invisible [[712](https://github.com/JetBrains/lets-plot/issues/712)].
- `geomDensity2D, geomDensity2DFilled`: support weight aesthetic [[791](https://github.com/JetBrains/lets-plot/issues/791)].
- Discrete axis labels unnecessarily rotate 90 degrees when applying coord system limits.
- Axis title via `labs()` breaks the date-time scale [[1113](https://github.com/JetBrains/lets-plot/issues/1113)].
- JavaFX IllegalArgumentException: Unsupported attribute `display` in Pane.

This release is 100% compatible with [Lets-Plot v 4.3.3](https://github.com/JetBrains/lets-plot/releases/tag/v4.3.3).

Added

- Support for `angle` aesthetic in `geomPoint()` [[736](https://github.com/JetBrains/lets-plot/issues/736)].
See [example notebook](https://nbviewer.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.7.3/geom_point_angle.ipynb).

Fixed

- Undesired vertical scroller when displaying `gggrid` in Jupyter notebook.
- Memory leak in SVG observable model (thanks to [contribution](https://github.com/JetBrains/lets-plot/commit/9c85d1ef39e3d6022880f068ce68e97b1b7ba2f1) by Ilya Muradyan).
- GeoJson structure breaks if the ring start label occurs several times [[1086](https://github.com/JetBrains/lets-plot/issues/1086)].
- `theme`: left margin doesn't work for the `plot_title` parameter [[1101](https://github.com/JetBrains/lets-plot/issues/1101)].
- Improve border line type experience [[LPK-220](https://github.com/JetBrains/lets-plot-kotlin/issues/220)].

This release is 100% compatible with [Lets-Plot v 4.3.2](https://github.com/JetBrains/lets-plot/releases/tag/v4.3.2).

Fixed

- LP occasionally crashes when drawing polygons [[1084](https://github.com/JetBrains/lets-plot/issues/1084)].
- Regression of issue [[966](https://github.com/JetBrains/lets-plot/issues/966)].
- Linetype doesn't work for `geomTile()` [[LPK-241](https://github.com/JetBrains/lets-plot-kotlin/issues/241)].

This release is 100% compatible with [Lets-Plot v 4.3.1](https://github.com/JetBrains/lets-plot/releases/tag/v4.3.1).

Added

- Parameter `labWidth` in `facetWrap()` and `xLabWidth/yLabWidth` in `facetGrid()` [[LPK-237](https://github.com/JetBrains/lets-plot-kotlin/issues/237)].

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

- Parameter `linetype` in `elementLine()` and `elementRect()` in `theme()` [[LPK-235](https://github.com/JetBrains/lets-plot-kotlin/issues/235)].

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

- Parameter `arrow` in `geomSpoke()` [[986](https://github.com/JetBrains/lets-plot/issues/986)].

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

- Parameter `sizeUnit` in `geomPoint()`, `geomText()` and `geomLabel()`.

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

- Auto-detection of `orientation="y"` in bar-chart etc. [[558](https://github.com/JetBrains/lets-plot/issues/558)].

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

- Parameter `plotInset` in `theme()`.

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


Changed

- `LetsPlot.theme` global property now accepts a sum of theme/flavor features [[657](https://github.com/JetBrains/lets-plot/issues/657)].

Fixed

- ggmarginal(): broken coloring [[760](https://github.com/JetBrains/lets-plot/issues/760)].
- Incorrect 'plot_background' area (with empty space capture) [[918](https://github.com/JetBrains/lets-plot/issues/918)].
- geom_density2df: uneven borders [[941](https://github.com/JetBrains/lets-plot/issues/941)].
- Line segments in geom_density2df() do not get interpolated when used with coord_polar() [[1037](https://github.com/JetBrains/lets-plot/issues/1037)].
- arrow on segment: reduce arrow size for short segments [[1040](https://github.com/JetBrains/lets-plot/issues/1040)].
- arrow on curve sometimes looks weird [[1041](https://github.com/JetBrains/lets-plot/issues/1041)].
- Error when build geom_smooth() with se=False [[1050](https://github.com/JetBrains/lets-plot/issues/1050)].
- Add tooltips for `geom_curve()` [[1053](https://github.com/JetBrains/lets-plot/issues/1053)].
- Incorrect position for bar annotations when specifying `scale_x_reverse()/scale_y_reverse()` [[1057](https://github.com/JetBrains/lets-plot/issues/1057)].
- Missing outer bar annotations when specifying `scale_x_reverse()/scale_y_reverse()` [[1058](https://github.com/JetBrains/lets-plot/issues/1058)].
- Plot layout breaks when marginal layers are used [[1074](https://github.com/JetBrains/lets-plot/issues/1074)].
- Discrete scale doesn't work for datetime data [[LPK-231](https://github.com/JetBrains/lets-plot-kotlin/issues/231)].
- Add `linetype` parameter in `elementLine()` and `elementRect()` [[LPK-235](https://github.com/JetBrains/lets-plot-kotlin/issues/235)].
- Any way to line-wrap facet labels? [[LPK-237](https://github.com/JetBrains/lets-plot-kotlin/issues/237)].
- Missing marginal gridlines.
- Cryptic error message on geom_boxplot with orientation="y" [[600](https://github.com/JetBrains/lets-plot/issues/600)].