Lets-plot

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

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

Compatibility

Added

Changed

Fixed