Updated README.md and CHANGELOG.md

Author: alshan

CHANGELOG.md

@@ -5,6 +5,81 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres
 to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). All scales should have the 'format' parameter.
 
+
+## [4.3.0] - 2023-03-09
+
+### Added
+
+- `gggrid()` function ([docs](https://lets-plot.org/kotlin/-lets--plot--kotlin/org.jetbrains.letsPlot/gggrid.html)), as a replacement for earlier variant of [gggrid()](https://github.com/JetBrains/lets-plot-kotlin/blob/master/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/gggrid_deprecated.kt).
+  - plots inner area alignment in grid
+  - nested grids
+  - works well with `ggsize()`
+
+  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/plot_grid.ipynb).
+
+
+- `jointPlot()`.
+
+  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/joint_plot.ipynb).
+
+
+- Axis `position` parameter in position scales `scaleX*(), scaleY*()`.
+
+  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/axis_position.ipynb).
+
+
+-  Drawing quantile lines and filling quantile areas in `geomViolin()` and `geomDensity()`.
+
+   See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/quantile_parameters.ipynb).
+
+
+- `angle` parameter in `elementText()` in `theme()`.
+
+  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/axis_text_angle.ipynb).
+
+
+- Additional "color" aesthetics: `paint_a, paint_b, paint_c`.
+
+  These aesthetics are flexible and can be used as either "color" or "fill" as needed.
+
+  See [Multiple Color Scales](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/multiple_color_scales.ipynb) demo.
+
+  Also added a set of related "color scale" functions with the "aesthetic" parameter for configuring of additional color scales.
+
+  See [New "Scale" Functions](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/scale_functions.ipynb) demo.
+
+
+- `density2d` and `density2df` geometry types in `residualPlot()`.
+
+
+### Changed
+
+- [BREAKING] `geomViolin()` no longer supports parameter `drawQuantiles`. Use new `quantileLines` and `quantiles` parameters as needed.
+
+- [BREAKING] `stack` and `fill` position adjustments now stack objects on top of each other only if these objects belong to different **groups**.
+
+  If necessary, use `mode="all"` in `positionStack()` or `positionFill()` to stack objects regardless of their group.
+
+  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/position_stack.ipynb).
+
+- [BREAKING] The deprecation level raised to "ERROR" for all API that was deprecated in v. 4.2.0 and earlier.
+
+- [DEPRECATED] The earlier variant of [gggrid()](https://github.com/JetBrains/lets-plot-kotlin/blob/master/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/gggrid_deprecated.kt).
+
+  From now-on please use new variant added in this release: [new gggrid()](https://lets-plot.org/kotlin/-lets--plot--kotlin/org.jetbrains.letsPlot/gggrid.html).
+
+- Sampling: drastically increased default N for "pick sampling" and for other types of sampling [[#687](https://github.com/JetBrains/lets-plot/issues/687)].
+
+### Fixed
+
+- Tooltip does not reflect `..quantile..` aesthetic change [[#658](https://github.com/JetBrains/lets-plot/issues/658)].
+- 'map_join': variable is lost after "stat" [[#664](https://github.com/JetBrains/lets-plot/issues/664)].
+- Error when tooltip has variable mapped to aesthetic used by stat [[#665](https://github.com/JetBrains/lets-plot/issues/665)].
+- Groups not sorted similarly when `position='stack'` [[#673](https://github.com/JetBrains/lets-plot/issues/673)].
+- Area ridges: fill overlaps geometry borders when colors are repeated [[#674](https://github.com/JetBrains/lets-plot/issues/674)].
+- Sampling: increase the default N for "pick sampling" and for other types of sampling [[#687](https://github.com/JetBrains/lets-plot/issues/687)].
+
+
 ## [4.2.0] - 2022-12-29
 
 ### Added

README.md

@@ -43,7 +43,7 @@
     - [Saving plot to file](#export)
     - [GeoTools support](#geotools)
 
-- [What is new in 4.2.0](#new)
+- [What is new in 4.3.0](#new)
 - [Migrating from v3 to v4](#migrating4)
 
 - [Change log](#change_log)
@@ -266,46 +266,54 @@ Learn more: [GeoTools Support](https://github.com/JetBrains/lets-plot-kotlin/blo
 
 
 <a id="new"></a>
-## What is new in 4.2.0
+## What is new in 4.3.0
 
-- ### New Plot Types
+- ### `gggrid()` ([docs](https://lets-plot.org/kotlin/-lets--plot--kotlin/org.jetbrains.letsPlot/gggrid.html)), as a replacement for earlier variant of [gggrid()](https://github.com/JetBrains/lets-plot-kotlin/blob/master/plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/gggrid_deprecated.kt).
+  <br>
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-23a/images/plot_grid.png" alt="f-23a/images/plot_grid.png" width="400" height="200">
 
-    - #### `residualPlot()`
-      <br>
-      <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-22e/images/residual-light.png" alt="f-22e/images/residual-light.png" width="200" height="133">
-      <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-22e/images/residual-dark.png" alt="f-22e/images/residual-dark.png" width="200" height="133">
+  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/plot_grid.ipynb).
 
-      See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.2.0/residual_plot.ipynb).
 
-    - #### `geomAreaRidges()`
-      <br>
-      <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-22e/images/ridges-dark.png" alt="f-22e/images/ridges-dark.png" width="400" height="130">
+- ### `jointPlot()`
+  <br>
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-23a/images/joint_plot.png" alt="f-23a/images/joint_plot.png" width="400" height="267">
 
-      See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.2.0/ridgeline_plot.ipynb).
+  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/joint_plot.ipynb).
 
-    - #### `geomPie()`
-      <br>
-      <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-22e/images/pie.png" alt="f-22e/images/pie.png" width="379" height="106">
 
-      See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.2.0/geom_pie.ipynb).
+- ### Configuring Axis Position
+  <br>
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-23a/images/axis_position.png" alt="f-23a/images/axis_position.png" width="300" height="200">
 
-    - #### Annotation Labels on Pie-Chart
-      <br>
-      <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-22e/images/pie-labels-explode.png" alt="f-22e/images/pie-labels-explode.png" width="195" height="133">
-      <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-22e/images/pie-labels-titanic.png" alt="f-22e/images/pie-labels-titanic.png" width="366" height="133">
+  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/axis_position.ipynb).
 
-      See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.2.0/annotations_for_pie.ipynb).
 
-    - #### `geomImshow()`
+- ### Showing Quantiles on Density Plots
+  <br>
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-23a/images/density_quantiles.png" alt="f-23a/images/density_quantiles.png" width="400" height="150">
+
+  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/quantile_parameters.ipynb).
+
+
+- ### Additional "color" aesthetics: `paint_a, paint_b, paint_c`.
+  <br>
+  <img src="https://raw.githubusercontent.com/JetBrains/lets-plot/master/docs/f-23a/images/additional_color_aes.png" alt="f-23a/images/additional_color_aes.png" width="400" height="300">
+
+  See [Multiple Color Scales](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/multiple_color_scales.ipynb) demo.
+
+  Also added a set of related "color scale" functions with the "aesthetic" parameter for configuring of additional color scales.
+
+  See [New "Scale" Functions](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/scale_functions.ipynb) demo.
+
+
+- ### Rotation of Axis Tick Labels
+
+  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/axis_text_angle.ipynb).
 
-        See: [image_101](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.2.0/image_101.ipynb),
-  [image_fisher_boat](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.2.0/image_fisher_boat.ipynb),
-  [image_grayscale](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.2.0/image_grayscale.ipynb),
-  [image_extent](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.2.0/image_extent.ipynb)
-                                  
 
 - ### Other improvements and fixes
-  See [CHANGELOG.md](https://github.com/JetBrains/lets-plot-kotlin/blob/master/CHANGELOG.md#410---2022-09-30)
+  See [CHANGELOG.md](https://github.com/JetBrains/lets-plot-kotlin/blob/master/CHANGELOG.md#430---2023-03-09)
   for details.
 
 

README_DEV.md

@@ -84,17 +84,17 @@ repositories {
 
 ```groovy
 dependencies {
-    implementation "org.jetbrains.lets-plot:lets-plot-batik:3.0.0"
-    implementation "org.jetbrains.lets-plot:lets-plot-kotlin-jvm:4.2.0"
+    implementation "org.jetbrains.lets-plot:lets-plot-batik:3.1.0"
+    implementation "org.jetbrains.lets-plot:lets-plot-kotlin-jvm:4.3.0"
 }
 ```
 
 - JVM/Swing/JavaFX application:
 
 ```groovy
 dependencies {
-  implementation "org.jetbrains.lets-plot:lets-plot-jfx:3.0.0"
-  implementation "org.jetbrains.lets-plot:lets-plot-kotlin-jvm:4.2.0"
+  implementation "org.jetbrains.lets-plot:lets-plot-jfx:3.1.0"
+  implementation "org.jetbrains.lets-plot:lets-plot-kotlin-jvm:4.3.0"
 }
 ```
 
@@ -106,16 +106,16 @@ If your JVM app doesn't use either frontend, you can provide just "lets-plot-com
 
 ```groovy
 dependencies {
-  implementation "org.jetbrains.lets-plot:lets-plot-common:3.0.0"
-  implementation "org.jetbrains.lets-plot:lets-plot-kotlin-jvm:4.2.0"
+  implementation "org.jetbrains.lets-plot:lets-plot-common:3.1.0"
+  implementation "org.jetbrains.lets-plot:lets-plot-kotlin-jvm:4.3.0"
 }
 ```
 
 - Kotlin/JS application:
 
 ```groovy
 dependencies {
-  implementation "org.jetbrains.lets-plot:lets-plot-kotlin-js:4.2.0"
+  implementation "org.jetbrains.lets-plot:lets-plot-kotlin-js:4.3.0"
 }
 ```
 
@@ -150,8 +150,8 @@ The following steps describe how to use `Lets-Plot` JVM "backend" in "browser" f
 #### Add dependencies on maven artifacts
 
 ```
-org.jetbrains.lets-plot:lets-plot-common:3.0.0
-org.jetbrains.lets-plot-kotlin:lets-plot-kotlin-jvm:4.2.0
+org.jetbrains.lets-plot:lets-plot-common:3.1.0
+org.jetbrains.lets-plot-kotlin:lets-plot-kotlin-jvm:4.3.0
 ```
 
 #### Implement the `jetbrains.letsPlot.FrontendContext` interface:

docs/README.md

@@ -4,7 +4,7 @@ https://github.com/JetBrains/lets-plot-kotlin/blob/master/docs/examples.md
 
 ### Explore example notebooks in Binder:
 
-https://mybinder.org/v2/gh/JetBrains/lets-plot-kotlin/v4.2.0demos1?filepath=docs/examples/jupyter-notebooks/
+https://mybinder.org/v2/gh/JetBrains/lets-plot-kotlin/v4.3.0demos?filepath=docs/examples/jupyter-notebooks/
 
 ### Browse Lets-Plot Kotlin API:
 

future_changes.md

@@ -1,72 +1,7 @@
-## [4.3.0] - 2023-03-dd
+## [4.3.1] - 2023-mm-dd
 
 ### Added
 
-- `gggrid()` function, as a replacement for the earlier variant of [gggrid()](https://lets-plot.org/kotlin/-lets--plot--kotlin/org.jetbrains.letsPlot/gggrid.html).
-  - sup-plots alignment
-  - nested grids
-  - works well with `ggsize()`
-
-  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/plot_grid.ipynb).
-         
-
-- `jointPlot()`.
-
-  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/joint_plot.ipynb). 
-                                      
-
-- Axis `position` parameter in position scales `scaleX*(), scaleY*()`.
-
-  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/axis_position.ipynb).
-
-
-- `angle` parameter in `elementText()` in `theme()`.
-
-  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/axis_text_angle.ipynb).
-
-
--  Drawing quantile lines and filling quantile areas in `geomViolin()` and `geomDensity()`.
-
-   See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/quantile_parameters.ipynb).
-
-
-- Additional "color" aesthetics: `paint_a, paint_b, paint_c`.
-
-  These aesthetics are flexible and can be used as either "color" or "fill" as needed.
-  
-  See [Multiple Color Scales](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.2.1/multiple_color_scales.ipynb) demo.
-
-  Also added a set of related "color scale" functions with the "aesthetic" parameter for configuring of additional color scales.
-
-  See [New "Scale" Functions](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/scale_functions.ipynb) demo.
-  
-
-- `density2d` and `density2df` geometry types in `residualPlot()`.
-
-
 ### Changed
 
-- [BREAKING] `geomViolin()` no longer supports parameter `drawQuantiles`. Use new `quantileLines` and `quantiles` parameters as needed.
-
-- [BREAKING] `stack` and `fill` position adjustments now stack objects on top of each other only if these objects belong to different **groups**.
-  
-  If necessary, use `mode="all"` in `positionStack()` or `positionFill()` to stack objects regardless of their group.
-  
-  See: [example notebook](https://nbviewer.jupyter.org/github/JetBrains/lets-plot-kotlin/blob/master/docs/examples/jupyter-notebooks/f-4.3.0/position_stack.ipynb).
-
-- [BREAKING] The deprecation level raised to "ERROR" for all API that was deprecated in v. 4.2.0 and earlier.
-
-- [DEPRECATED] The earlier variant of [gggrid()](https://lets-plot.org/kotlin/-lets--plot--kotlin/org.jetbrains.letsPlot/gggrid.html).
-  
-  From now-on please use the variant added in this release: [new gggrid()]( to do ).
-
-- Sampling: drastically increased default N for "pick sampling" and for other types of sampling [[#687](https://github.com/JetBrains/lets-plot/issues/687)].
-
 ### Fixed
-
-- Tooltip does not reflect `..quantile..` aesthetic change [[#658](https://github.com/JetBrains/lets-plot/issues/658)].
-- 'map_join': variable is lost after "stat" [[#664](https://github.com/JetBrains/lets-plot/issues/664)].
-- Error when tooltip has variable mapped to aesthetic used by stat [[#665](https://github.com/JetBrains/lets-plot/issues/665)].
-- Groups not sorted similarly when `position='stack'` [[#673](https://github.com/JetBrains/lets-plot/issues/673)].
-- Area ridges: fill overlaps geometry borders when colors are repeated [[#674](https://github.com/JetBrains/lets-plot/issues/674)].
-- Sampling: increase the default N for "pick sampling" and for other types of sampling [[#687](https://github.com/JetBrains/lets-plot/issues/687)].