Lets-plot

Changed

- Due to shutting down of [Bintray, JCenter](https://jfrog.com/blog/into-the-sunset-bintray-jcenter-gocenter-and-chartcenter/):
- The Lets-Plot JS library is now delivered via [CDNJS](https://cdnjs.com/libraries/lets-plot).
- JVM Maven artifacts are now published at [Maven Central](https://search.maven.org/search?q=lets-plot).

Changed

- **[BREAKING CHANGE]**: The **groupId** of all maven artifacts is now **"org.jetbrains.lets-plot"** (was "
org.jetbrains.lets-plot-kotlin")
- Built with Lets-Plot v2.0.2 (was v2.0.2).
- All **snake_case** symbols were deprecated and replaced with equivalent **camelCase**
symbols [[53](https://github.com/JetBrains/lets-plot-kotlin/discussions/53)].
- Maven artifacts published to [Maven Central](https://search.maven.org/search?q=lets-plot) (due to shutting down
of [Bintray, JCenter](https://jfrog.com/blog/into-the-sunset-bintray-jcenter-gocenter-and-chartcenter/))

Added

- Python 3.9 support on all platforms.
- `facet_wrap()` function [[238](https://github.com/JetBrains/lets-plot/issues/238)]
- In facets:
- Ascending/descending ordering of faceting values.
- Formatting of faceting values.

See: [Facets demo](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-docs/blob/master/source/examples/cookbook/facets.ipynb)


- In tooltip customization API:
- option `color` overrides the default tooltip color:
python
geom_xxx(tooltips=layer_tooltips().color('red'))


See: [Tooltip Customization](https://lets-plot.org/pages/tooltips.html).


- Crosshair cursor when tooltip is in fixed position specified by the `anchor` option.
- Scale `format` parameter: formatting tick labels on X/Y axis. Supported types are `number` and `date/time`.

Example:
python
scale_x_datetime(format="%b %Y")
scale_x_continuous(format='is {.2f}')


Demo: [Formatting demo](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-docs/blob/master/source/examples/cookbook/formatting_axes_etc.ipynb)

See also: [Formatting](https://lets-plot.org/pages/formats.html)

Changed

- [**breaking change**] New Geocoding API!

Since Lets-Plot v2.0.0 the peviouse Geocoding API is no longer working (hence we bumped the version to 2.0.0).

The old version of the Geocoding backend remains on-line for a couple of release cycles
to continue support of prior versions of Lets-Plot.

To learn more about Geocoding API see: [Geocoding](https://lets-plot.org/pages/geocoding.html).


- The project upgraded to Kotlin v1.4.21 (was v1.4.10).

Fixed

- Kernel density estimate computation is too slow.
- Serialize NaN and other special values as None (CRITICAL for the "Lets-Plot in SciView" PyCharm plugin) [[282](https://github.com/JetBrains/lets-plot/issues/282)].
- Error in plot building: 'trans' parameter not compatible with None values in data [[287](https://github.com/JetBrains/lets-plot/issues/287)].
- LOESS smoothing fails on small (<3) number points.
- Facet grid truncated in jupyter [[28](https://github.com/JetBrains/lets-plot-kotlin/issues/28)].
- The `reverse` parameter on discrete scale with 'limits' [[303](https://github.com/JetBrains/lets-plot/issues/289)].
- Geocoder's `allow_ambiguous()` doesn't prevent "ValueError: Multiple objects.." [[174](https://github.com/JetBrains/lets-plot/issues/174)].
- Fix tooltip for overlapping objects [[230](https://github.com/JetBrains/lets-plot/issues/230)].
- Fix duplicate values in tooltip [[280](https://github.com/JetBrains/lets-plot/issues/280)].
- geom_histogram should not try to handle geometries in GeoDataFrame [[281](https://github.com/JetBrains/lets-plot/issues/281)].
- Error building plot: Layer 'MAP' is not supported on Live Map. [[285](https://github.com/JetBrains/lets-plot/issues/285)].
- Align title to the left of the plot geom area [[289](https://github.com/JetBrains/lets-plot/issues/289)].
- Tooltip on `geom_ribbon()`.

Fixed
- “Symbol not found: _NSGenericException” error on macOS [[276](https://github.com/JetBrains/lets-plot/issues/276)].

Added
- Correlation plot.

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

- 'No Javascript' mode.

Support for notebook renderers that don't execute Javascript.

See: ['No Javascript' mode](https://lets-plot.org/pages/no_js_and_offline_mode.html#no-javascript-mode)

- In tooltip customization API:
- options: `center` and `middle` (anchor).
- option 'minWidth'.

See: [Tooltip Customization](https://lets-plot.org/pages/tooltips.html).

- 'na_text' parameter in 'geom_text'

Changed
- Tooltip customization API:
- The `anchor` option moved from `theme` to `layer`:
python
geom_xxx(tooltips=layer_tooltips().anchor(anchor_value))

where `anchor_value`:
`['top_right'|'top_center'|'top_left'|'bottom_right'|'bottom_center'|'bottom_left'|'middle_right'|'middle_center'|'middle_left']`.

See: [Tooltip Customization](https://lets-plot.org/pages/tooltips.html).

Fixed
- Tooltip should appear when the mapped data is continuous [[241](https://github.com/JetBrains/lets-plot/issues/241)]
- Tooltip 'null' displayed for undefined vals [[243](https://github.com/JetBrains/lets-plot/issues/243)]
- Y-tooltip should be aligned with a tile center [[246](https://github.com/JetBrains/lets-plot/issues/246)]
- With `facet_grid` tooltip shows data from last plot on all plots [[247](https://github.com/JetBrains/lets-plot/issues/247)]

Changed
- [**breaking change**] In functions `format(field, format)` and `line(template)` in
tooltip builder, the '$' symbol is no longer used in aesthetic reference. It was replaced by the '^' (hat) symbol
(see the udated doc: [Tooltip Customization](https://lets-plot.org/pages/tooltips.html)).
- The project upgraded to Kotlin v1.4.10 (was v1.3.72).

Fixed
- No tooltip on v-line [[229](https://github.com/JetBrains/lets-plot/issues/229)]