Lets-plot

Added

- Plot subtitle and caption [[417](https://github.com/JetBrains/lets-plot/issues/417)]:
`subtitle` parameter in `ggtitle()` and `labs()`,
`caption` parameter in `labs()`,
`plot_subtitle` and `plot_caption` parameters in `theme()`.

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

- The 'newline' character (`\n`) now works as `line break` in plot title, subtitle, caption and in legend title.

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

- New in tooltip customization API:
- The `title()` option defines a tooltip "title" text which will always appear above the rest of the tooltip content.
- The 'newline' character (`\n`) now works as `line break` in tooltips.
- Automatic word wrap: occurs when the length of a text value in tooltip exceeds the 30 characters limit.

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

- Parameter `scales` in `facet_grid()/facet_wrap()` [[451](https://github.com/JetBrains/lets-plot/issues/451),
[479](https://github.com/JetBrains/lets-plot/issues/479)].

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

- New in `geom_livemap()`:
- The `Reset` button: returns the map widget to its initial zoom/location state.
- Parameters `data_size_zoomin, const_size_zoomin`: allow configuring how zooming-in of the map widget increases size of geometry objects (circles, lines etc.) on map.
- Parameter `ontop` that controls z-index of the `geom_livemap` layer.
- Parameter `show_coord_pick_tools` to show "copy location" and "draw geometry" buttons.

- New geometries:
- `geom_violin()`

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

- `geom_dotplot()`

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

- `geom_ydotplot()`

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


Changed

- New tooltip style: rounded corners, bold label, colored marker inside the tooltip.
- Deprecated tooltip customization API:
function `color()` will be removed in one of the future releases.
- 'Auto shrink': plots automatically shrink when necessary to fit width of the output (notebook) cell [[488](https://github.com/JetBrains/lets-plot/issues/488)].

Fixed

- LiveMap, Swing-batik: legend is not visible when overlapping map [[496](https://github.com/JetBrains/lets-plot/issues/496)].
- CVE-2021-23792 in org.jetbrains.lets-plot:lets-plot-image-export2.2.1 [[497](https://github.com/JetBrains/lets-plot/issues/497)].
- Color in tooltip does not correspond to the color of marker on map [[227](https://github.com/JetBrains/lets-plot/issues/227)].
- tooltip on livemap: hide tooltip when the cursor is over the controls [[335](https://github.com/JetBrains/lets-plot/issues/335)].
- Automatic detection of DateTime series [[99](https://github.com/JetBrains/lets-plot-kotlin/issues/99)].
- Fix tooltips for `geom_histogram(stat='density')`.
- The axis tooltip overlaps the general tooltip [[515](https://github.com/JetBrains/lets-plot/issues/515)].
- The multi-layer tooltip detection strategy will only be used if more than one layer provides tooltips.
- scaleColorManual Divide by Zero with 1 mapping [[506](https://github.com/JetBrains/lets-plot/issues/506)].
- LinearBreaksHelper$Companion.computeNiceBreaks out of memory error [[105](https://github.com/JetBrains/lets-plot-kotlin/issues/105)].

Added

- `scale_x_time()` and `scale_y_time()` [[468](https://github.com/JetBrains/lets-plot/issues/468)].

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

- `plot_background, legend_background` parameters in `theme()` [[485](https://github.com/JetBrains/lets-plot/issues/485)].
- `axis_ontop, axis_ontop_x, axis_ontop_y` parameters in `theme()`

Fixed

- Coord system limits do not work with x/y scale with transform [[474](https://github.com/JetBrains/lets-plot/issues/474)].
- Provide 0-23 hour formatting [[469](https://github.com/JetBrains/lets-plot/issues/469)].
- No tooltip shown when I'm trying to add an empty line [[382](https://github.com/JetBrains/lets-plot/issues/382)].
- `coord_fixed()` should adjust dimensions of "geom" panel accordingly [[478](https://github.com/JetBrains/lets-plot/issues/478)].
- The tooltip dependence on number of factors works separately by layers [[481](https://github.com/JetBrains/lets-plot/issues/481)].
- Tooltip on y-axis looks wrong [[393](https://github.com/JetBrains/lets-plot/issues/393)].
- Is kotlin-reflect really needed for lets-plot? [[471](https://github.com/JetBrains/lets-plot/issues/471)].

Added

- `coord_flip()`.

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

- Date-time formatting support:
- tooltip format() should understand date-time format pattern [[387](https://github.com/JetBrains/lets-plot/issues/387)];
- scale_x_datetime should apply date-time formatting to the breaks [[392](https://github.com/JetBrains/lets-plot/issues/392)].

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

- Pre-configured themes:
- Standard ggplot2 themes: `theme_grey(), theme_light(), theme_classic(), theme_minimal()`;
- Other themes: `theme_minimal2()` - the default theme, `theme_none()`.

- Theme modification: more parameters were added to the `theme()` function.

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

> Note: fonts size, family and face still can not be configured.

- `corr_plot()` function now also accepts pre-computed correlation coefficients. I.e. the following two expressions are equivalent:
python
corr_plot(iris_df).points().labels().build()
corr_plot(iris_df.corr()).points().labels().build() new


Changed

- The size of fonts on plot was slightly increased all across the board.
- The default plot size was increased by 20%, it's now 600x400 px.
- **Deprecated API**: `stat_corr()` and "correlation stat" will be removed in one of the future releases.
Please use the `corr_plot()` plot builder object instead.

Fixed

- Ordering facets - the "order" value 0 disables facet ordering [[454](https://github.com/JetBrains/lets-plot/issues/454)].
- Tooltips for discrete variables: add the dependence of the tooltip on the number of factors.
The X-axis tooltip is always shown for discrete data.
- map_join doesn't work when join variables with same names without mappings [[428](https://github.com/JetBrains/lets-plot/issues/428)].
- Zoom without clipping breaks tooltips [[373](https://github.com/JetBrains/lets-plot/issues/373)].
- Unreadable breaks on axis [[430](https://github.com/JetBrains/lets-plot/issues/430)].
- Map rendering is broken when browser uses scaling [[450](https://github.com/JetBrains/lets-plot/issues/450)].
- corr_plot() error for data with zero variation [[329](https://github.com/JetBrains/lets-plot/issues/329)].
- Misleading error message [[271](https://github.com/JetBrains/lets-plot/issues/271)].

Added

- Ordering categories. New parameters in the `as_discrete` function:
* `order_by` (string) - the name of the variable by which the ordering will be performed;
* `order` (int) - the ordering direction - 1 for ascending direction and -1 for descending (default value).

See: [as_discrete](https://lets-plot.org/pages/as_discrete.html).

- Basemap tiles configuring:
- Subdomains parameter `{s}` for XYZ raster tiles.
- Solid color tiles: `maptiles_solid()`.
- Builtin configurations for some 3rd party maptile services. The `lets_plot.tilesets` module.

See: [Configuring basemap tiles](https://lets-plot.org/pages/basemap_tiles.html).

Changed

- Upgraded Apach Batik version to 1.14 (was 1.12) [[398](https://github.com/JetBrains/lets-plot/issues/398)].
- Upgraded Kotlin version to 1.5.21 (was 1.4.21)
- Upgraded Gradle version to 7.1.1 (was 6.8.3)

Fixed

- geom_livemap: properly handle `max_zoom` pamareter in `maptiles_zxy()`.
- Strange looking legend for tiles [[245](https://github.com/JetBrains/lets-plot/issues/245)].
- Need to skip "bad" values during scale transformation [[301](https://github.com/JetBrains/lets-plot/issues/301)].
- NPE on negative value in data and scale_xxx(trans='log10') [[292](https://github.com/JetBrains/lets-plot/issues/292)].
- Legend is broken when using scale_fill_brewer with 'trans' parameter [[284](https://github.com/JetBrains/lets-plot/issues/284)].
- Scale breaks should be distributed evenly on 'sqrt' scale. [[407](https://github.com/JetBrains/lets-plot/issues/407)].
- Wrong tooltip formatting when used with log10 scales [[406](https://github.com/JetBrains/lets-plot/issues/406)].
- Bad axis labels when using both plot and layer data [[327](https://github.com/JetBrains/lets-plot/issues/327)].
- Plot layout looks wrong [[403](https://github.com/JetBrains/lets-plot/issues/403)].
- map_join is not working correctly when `map=geocoder` [[380](https://github.com/JetBrains/lets-plot/issues/380)]
- Tooltip default formatting should not change after adding other variables to tooltip [[388](https://github.com/JetBrains/lets-plot/issues/388)].
- Tooltip on axis: increase the font size. [[399](https://github.com/JetBrains/lets-plot/issues/399)].
- Tooltip format for variable is not working [[401](https://github.com/JetBrains/lets-plot/issues/401)].
- Wrong direction in colorbars (legend) [[204](https://github.com/JetBrains/lets-plot/issues/204)].
- geom_jitter: show axis tooltips (same as geom_point) [[412](https://github.com/JetBrains/lets-plot/issues/412)].
- Outlier tooltips: the spout sometime is too long (boxplot) [[358](https://github.com/JetBrains/lets-plot/issues/358)].
- Faceted plot is broken by geom with "constant" aesthetics [[391](https://github.com/JetBrains/lets-plot/issues/391)].
- Interactive maps in AWT (PyCharm plugin):
- Memory leaks in PyCharm caused by `dispose()` method in PlotPanel.
- While showing map in PyCharm CPU is busy all the time, even when nothing is changing on screen.
- Click events detection.

Changed

- Upgraded `kotlinx.html` version to 0.7.3 (was 0.7.2)
> In JVM projects it's no longer necessary to add `https://maven.pkg.jetbrains.space/public/p/kotlinx-html/maven` repository
> to the project configuration.

Fixed

- Multilayer plots are corrupted [[385](https://github.com/JetBrains/lets-plot/issues/385)].

Added

- In tooltip customization API:
- `layer_tooltips(variables)` - the new parameter `variables` defines a list of variable names, which values will be placed line by line in the general tooltip.
See: [Tooltip Customization](https://lets-plot.org/pages/tooltips.html).

Changed

- CDN: Lets-Plot JavaScript library is now served via [JSDELIVR](https://www.jsdelivr.com/?docs=gh) (was CDNJS):
> https://cdn.jsdelivr.net/gh/JetBrains/lets-plotv2.0.3/js-package/distr/lets-plot.min.js

Fixed

- Removed the last dependency on bintray JCenter ([commit](https://github.com/JetBrains/lets-plot/commit/7bcd38e000a4952b83269ef4ebac0b7d826dea6a)).
- geom_boxplot: should be possible to create boxplot without specifying x-series [[325](https://github.com/JetBrains/lets-plot/issues/325)]
- geom_hline: graph plotted outside of coordinate plane visible part [[334](https://github.com/JetBrains/lets-plot/issues/334)]
- Draw geometry only once if layer has no aes mapping specified [[73](https://github.com/JetBrains/lets-plot/issues/73)]
- map: calif.housing [[140](https://github.com/JetBrains/lets-plot/issues/140)]
- Can't build plot: "Uncaught SyntaxError: Unexpected string" in a console [[371](https://github.com/JetBrains/lets-plot/issues/371)]
- All scales should have the 'format' parameter [[347](https://github.com/JetBrains/lets-plot/issues/347)].
- Poor font rendering in Swing/Batik. Related to: [[364](https://github.com/JetBrains/lets-plot/issues/364)]
- Exclude slf4j implementation from lets-plot-common [[374](https://github.com/JetBrains/lets-plot/issues/374)]