Lets-plot

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

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

Added

- The `alpha` parameter for lines [[139](https://github.com/JetBrains/lets-plot/issues/139)].
- Tooltips for `geom_segment()` [[296](https://github.com/JetBrains/lets-plot/issues/296)].
- The `guides()` function [[52](https://github.com/JetBrains/lets-plot/issues/52)].
- New Java **Swing plot components** to enable embedding Lets-Plot charts into JVM applications.
- See: `vis-swing-common, vis-swing-batik, vis-swing-jfx` modules.

Fixed

- Fix auto-detection of PyCharm env to enable plotting in SciView while using remote interpreter [[348](https://github.com/JetBrains/lets-plot/issues/348)]
- Fix tooltips appearing outside the specified x/y limits.
- Clippath in accordance to the given limits [[189](https://github.com/JetBrains/lets-plot/issues/189)].
- Treat a data as DataFrame if both data and map are GeoDataFrames [[343](https://github.com/JetBrains/lets-plot/issues/343)].
- Removed the restriction on tooltips for small polygons [[298](https://github.com/JetBrains/lets-plot/issues/298)].
- The x/y axis labels are derived from x/y aesthetics only [[333](https://github.com/JetBrains/lets-plot/issues/333)].
- Merge 'theme' settings [[147](https://github.com/JetBrains/lets-plot/issues/147)].
- Add axis tooltips for `geom_bin2d`.
- Outlier tooltips for `geom_ribbon()`.
- Fix tooltip crosshair [[309](https://github.com/JetBrains/lets-plot/issues/309)].

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()`.