Lets-plot

Added

- In tooltip customization API:
- `layerTooltips(variables)` - the new parameter `variables` defines a list of variable names, which values will be
placed in the general multiline tooltip.
See: [Tooltip Customization](https://github.com/JetBrains/lets-plot/blob/master/docs/tooltips.md#variables).


- [lets-plot-mini-apps](https://github.com/alshan/lets-plot-mini-apps) GitHub repository containing examples of using
the Lets-Plot Kotlin API in JVM and Kotlin/JS projects.

Changed

- **[BREAKING CHANGE]**: The CDN for delivering the Lets-Plot JavaScript library is
now [JSDELIVR](https://www.jsdelivr.com/?docs=gh)
(was CDNJS).

New URLs:
- Lets-Plot v2.0.3: https://cdn.jsdelivr.net/gh/JetBrains/lets-plotv2.0.3/js-package/distr/lets-plot.min.js
- The latest version: https://cdn.jsdelivr.net/gh/JetBrains/lets-plot/js-package/distr/lets-plot.min.js


- The project has been converted to a "multiplatform" project targeting JVM and JS platforms.

To use Lets-Plot Kotlin API in your project, include dependencies:
- JVM: `implementation "org.jetbrains.lets-plot:lets-plot-kotlin-jvm:3.0.0"`
- JS: `implementation "org.jetbrains.lets-plot:lets-plot-kotlin-js:3.0.0"`

See [USAGE_SWING_JFX_JS.md](https://github.com/JetBrains/lets-plot-kotlin/blob/master/USAGE_SWING_JFX_JS.md) for more details.


- **[BREAKING CHANGE]** The JVM artifact `lets-plot-kotlin-api` is no longer deployed: replaced with the
equivalent `lets-plot-kotlin-jvm`.


- The artifact `lets-plot-kotlin-api-kernel` renamed to `lets-plot-kotlin-kernel` (this change only concerns Kotlin
Jupyter Kernel)

Fixed

- 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)]
- 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)]
- Can't build plot: "Uncaught SyntaxError: Unexpected string" in a
console [[371](https://github.com/JetBrains/lets-plot/issues/371)]

Added

- `geom_text(), geom_label()`:

- the 'newline' character (`\n`) now works as `line break` ([[605](https://github.com/JetBrains/lets-plot/issues/605)])
- `lineheight` aesthetic ([[324](https://github.com/JetBrains/lets-plot/issues/324)])
- `nudge_x, nudge_y` parameters ([[324](https://github.com/JetBrains/lets-plot/issues/324)])
- special text alignments (`vjust` and `hjust`): `"inward"` and `"outward"` ([[324](https://github.com/JetBrains/lets-plot/issues/324)])

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

- `vjust` parameter in `position_stack()` and `position_fill()` [[323](https://github.com/JetBrains/lets-plot/issues/323)].

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

- `use_crs` parameter in `geom_map()` and other geoms, working with `GeoDataFrame`

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

- `geom_imshow()` (former `geom_image()`):

- `extent` parameter

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

- `vmin, vmax, cmap` parameters

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

- `image_matrix()`:

- `vmin, vmax, cmap` parameters

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


Changed

- `geom_image()` renamed to `geom_imshow()`

See updated examples: [image 101](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-22d/image_101.ipynb),
[Fisher's boat](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-22d/image_fisher_boat.ipynb).

- `geom_boxplot()`: default value for parameter `whisker_width` is 0.5.

- Upgraded Kotlin version to 1.7.20 (was 1.6.21).


Fixed

- element_blank() has no effect in theme legend_title [[608](https://github.com/JetBrains/lets-plot/issues/608)].
- `geom_livemap()`: add support of geom_label parameters [[601](https://github.com/JetBrains/lets-plot/issues/601)].
- Tooltip: different formats for same aesthetic Y [[579](https://github.com/JetBrains/lets-plot/issues/579)].
- Positioning with "constant" x/y doesn't work on axis with log10 transform [[618](https://github.com/JetBrains/lets-plot/issues/618)].
- Positional "constant" doesn't honor axis limits [[619](https://github.com/JetBrains/lets-plot/issues/619)].
- Parameter `norm` in `geom_imshow()`.
- Several issues leading to crush in Swing/Batik apps. Related to [[discussions](https://github.com/JetBrains/lets-plot-kotlin/discussions/138)]
- Text labels got trimmed occasionally, when symbols `-`, `/`, `\` or `|` present.
- `geom_livemap()` doesn't load vector tiles inside `iframe` with certain security policies.

Added

- New theme: `theme_bw()` [[554](https://github.com/JetBrains/lets-plot/issues/554)].

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

- Color schemes (flavors) applicable to existing themes:
- `flavor_darcula()`
- `flavor_solarized_light()`
- `flavor_solarized_dark()`
- `flavor_high_contrast_light()`
- `flavor_high_contrast_dark()`

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

- Viridis color scales: `scale_color_viridis()`, `scale_fill_viridis()`.

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

- New parameters in `element_text()` [[562](https://github.com/JetBrains/lets-plot/issues/562)]:
- `size, family`
([example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot/blob/master/docs/f-22c/font_size_and_family.ipynb))
- `hjust, vjust` for plot title, subtitle, caption, legend and axis titles
([example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot/blob/master/docs/f-22c/hjust_vjust.ipynb))
- `margin` for plot title, subtitle, caption, axis titles and tick labels
([example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot/blob/master/docs/f-22c/text_margins.ipynb))

- The 'newline' character (`\n`) now works as `line break` in axis title.

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

- Parameter `whisker_width` in `geom_boxplot()` [[549](https://github.com/JetBrains/lets-plot/issues/549)].

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

- New geometry `geom_label()` [[557](https://github.com/JetBrains/lets-plot/issues/557)].

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

- Auto-detection of **Databricks** and **NextJournal** environments [[602](https://github.com/JetBrains/lets-plot/issues/602)].

- Python wheels for manylinux arm64 architecture [[581](https://github.com/JetBrains/lets-plot/issues/581)].


Changed

- New tooltip style after applying `coord_flip()` [[580](https://github.com/JetBrains/lets-plot/issues/580)].

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

- In Lets-Plot for Java/Swing, Apache Batik upgraded to v.1.15 [[604](https://github.com/JetBrains/lets-plot/issues/604)]

Fixed

- Density and area geoms: preserve the z-order when grouping [[552](https://github.com/JetBrains/lets-plot/issues/552)].
- Allow to import all 'bistro' functions just by '*' [[551](https://github.com/JetBrains/lets-plot/issues/551)].
- Boxplot, violin, crossbar: position dodge width=0.95 should be used by default [[553](https://github.com/JetBrains/lets-plot/issues/553)].
- Tooltip is shown not for the nearest object [[574](https://github.com/JetBrains/lets-plot/issues/574)].
- Tooltip is not displayed for the object on the plots border [[575](https://github.com/JetBrains/lets-plot/issues/575)].
- The plot caption overlaps with the legend [[587](https://github.com/JetBrains/lets-plot/issues/587)].
- Unclear size unit of width [[589](https://github.com/JetBrains/lets-plot/issues/589)].
- Specify size units in docstrings [[597](https://github.com/JetBrains/lets-plot/issues/597)].
- No tooltips for geom_boxplot with zero height [[563](https://github.com/JetBrains/lets-plot/issues/563)].
- geom_text: wrong label alignment with `hjust` 0 and 1 [[592](https://github.com/JetBrains/lets-plot/issues/592)].
- Error when using lets-plot in streamlit [[595](https://github.com/JetBrains/lets-plot/issues/595)].
- Documentation for the `breaks` parameter in scales [[507](https://github.com/JetBrains/lets-plot/issues/507)].

Added

- Python 3.10 support [[505](https://github.com/JetBrains/lets-plot/issues/505)].

- Python 3.9: a Python wheel for macOS arm64 architecture (Apple Silicon).


- `LetsPlot.set_theme()` - configuring a default plot theme.

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


- Quantile-Quantile (Q-Q) plot:
- geometries:
- `geom_qq()`
- `geom_qq_line()`
- `geom_qq2()`
- `geom_qq2_line()`
- quick Q-Q : the `qq_plot()` function in the `bistro` module.

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


- Marginal plots: the `ggmarginal()` function [[200](https://github.com/JetBrains/lets-plot/issues/200)],
[[384](https://github.com/JetBrains/lets-plot/issues/384)].

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


- Parameter `orientation` in geoms: `bar, boxplot, density, histogram, freqpoly, smooth, violin`.

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


- New in *plot theme*:
- `face` parameter in `element_text()`.

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

- `panel_border` parameter in `theme()` [[542](https://github.com/JetBrains/lets-plot/issues/542)].

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

- Tooltip theme options, new parameters in `theme()`:
- `tooltip` - tooltip rectangle options;
- `tooltip_text, tooltip_title_text` - tooltip text options;
- `axis_tooltip_text, axis_tooltip_text_x, axis_tooltip_text_y` - axis tooltip text options.

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



- `scale_color_gradientn()` and `scale_fill_gradientn()` functions [[504](https://github.com/JetBrains/lets-plot/issues/504)].

See: [example notebook](https://nbviewer.org/github/JetBrains/lets-plot/blob/master/docs/f-22b/scale_%28color_fill%29_gradientn.ipynb).



Changed

- `geom_livemap` [**breaking change**] : `symbol="point"` now should be specified explicitly
to enable the "livemap" layer to handle provided
"point" aesthetics directly. This change doesn't affect "points" layers added via
the `geom_point()` geometry layer.
- New style of tooltip color marker (two sidebars with a stroke color)
and symbols in legend (rectangle with a stroke instead of a slash-line).
- New type of general tooltip for `geom_boxplot`: displayed under the cursor.
- Default sampling type for `geom_violin` switched from `systematic` to `pick`.

Fixed

- `geom_livemap`: support of the `arrow` parameter in `geom_segment` [[131](https://github.com/JetBrains/lets-plot/issues/131)].
- Differences in tooltip color marker for plots with and without livemap.
- Labels out of plot when axis_text_y='blank' [[525](https://github.com/JetBrains/lets-plot/issues/525)].
- NPE in corr_plot with null coefficients.
- Outliers are not shown when boxplot' alpha=0.
- Support for polars.DataFrame [[526](https://github.com/JetBrains/lets-plot/issues/526)].
- JFX rendering issue that causes tooltips to stuck [[539](https://github.com/JetBrains/lets-plot/issues/539)].
- Support trim parameter in density and ydensity stats [[62](https://github.com/JetBrains/lets-plot/issues/62)].
- Unexpected point geometries on geom_livemap() [[547](https://github.com/JetBrains/lets-plot/issues/547)].
- `geom_violin`: add missing parameters `kernel`, `bw`, `adjust`, `n`, `fs_max` to signature and docstring.

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