Lets-plot

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

Added
- Facilities for customization of tooltip contents and its position (see [Tooltip Customization](https://lets-plot.org/pages/tooltips.html)).
- `attribution` and other new parameters in the `maptiles_zxy()` function.
- `label_format` parameter in the `geom_text()` function.
- `scale_x_discrete_reversed()` / `scale_y_discrete_reversed()`
- `ggsave()` function (only SVG, HTML)

Fixed
- Mercator's projection computes coordinates incorrectly (`geom_map(), coord_map()`)
- Handling of `xlim,ylim` in `coord_fixed(), coord_map()`
- Colorbars: take in account limits defined in continuous color/fill scales.
- `scale_color_hue` incorrectly interprets chroma range [[206](https://github.com/JetBrains/lets-plot/issues/206)].
- `scale_color_brewer` shouldn't fail if 'type' is not specified [[203](https://github.com/JetBrains/lets-plot/issues/203)].
- `scale_fill_discrete` should not replace the default discrete scale (Brewer) with 'HUE' scale [[172](https://github.com/JetBrains/lets-plot/issues/172)].

Changed
- Lets-plot vector map-tiles are configured by default.
- PACIFIC_BLUE color (118ED8) replaced DARK_BLUE as a default color/fill value on plots.
- Default discrete color scheme is now ColorBrewer's Set2 (was Dark2)

Deprecated
- Function `gg_image_matrix()`. The new function is: `image_matrix()` in the `lets_plot.bistro.im` module.
The new function is not any longer displaying matrix by itself but returns a GGBunch object instead.
Unlike the depricated `gg_image_matrix()` function, it is not imported by `from lets_plot import *` statement.

Usage:

from lets_plot.bistro.im import image_matrix
image_matrix()

Fixed
- map_titanic.ipynb : UnboundLocalError: local variable 'map_join' referenced before assignment [[182](https://github.com/JetBrains/lets-plot/issues/182)]
- Add the `map_join` parameter to all geoms which support `map` parameter (py) [[183](https://github.com/JetBrains/lets-plot/issues/183)]