CHANGELOG.md

lets-plot-kotlin changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning. All scales should have the 'format' parameter.

[3.0.2] - 2021-06-09

Added

• Ordering categories:

  New parameters added to the asDiscrete() function:

  • orderBy - name of the variable by which the ordering will be performed;
  • order - ordering direction: 1 for ascending direction and -1 for descending (default).

  See: as_discrete.

Changed

• Upgraded dependencies:
  • Kotlin: 1.5.21
  • Lets-Plot: 2.1.0 (see Lets-Plot CHANGELOG)
  • Apache Batik: 1.14 [#398]

[3.0.1] - 2021-06-09

Added

• The 'format' parameter in all scales [76].

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].
• Import "lets-plot-common" transitively [#78]

[3.0.0] - 2021-06-04

Added

• In tooltip customization API:

  • layerTooltips(variables) - the new parameter variables defines a list of variable names, which values will be placed in the general multiline tooltip. See: Tooltip Customization.

• lets-plot-mini-apps GitHub repository containing examples of using the Lets-Plot Kotlin API in JVM and Kotlin/JS projects.

Changed

• [BREAKING CHANGE]: The CDN for delivering the Lets-Plot JavaScript library is now JSDELIVR (was CDNJS).

  New URLs:

  • Lets-Plot v2.0.3: https://cdn.jsdelivr.net/gh/JetBrains/lets-plot@v2.0.3/js-package/distr/lets-plot.min.js
  • The latest version: https://cdn.jsdelivr.net/gh/JetBrains/lets-plot/js-package/distr/lets-plot.min.js

• The project has been converted to a "multiplatform" project targeting JVM and JS platforms.

  To use Lets-Plot Kotlin API in your project, include dependencies:

  • JVM: implementation "org.jetbrains.lets-plot:lets-plot-kotlin-jvm:3.0.0"
  • JS: implementation "org.jetbrains.lets-plot:lets-plot-kotlin-js:3.0.0"

  See README_DEV.md for more details.

• [BREAKING CHANGE] The JVM artifact lets-plot-kotlin-api is no longer deployed: replaced with the equivalent lets-plot-kotlin-jvm.

• The artifact lets-plot-kotlin-api-kernel renamed to lets-plot-kotlin-kernel (this change only concerns Kotlin Jupyter Kernel)

Fixed

• Poor font rendering in Swing/Batik. Related to: [#364]
• Exclude slf4j implementation from lets-plot-common [#374]
• geom_boxplot: should be possible to create boxplot without specifying x-series [#325]
• geom_hline: graph plotted outside of coordinate plane visible part [#334]
• Draw geometry only once if layer has no aes mapping specified [#73]
• Can't build plot: "Uncaught SyntaxError: Unexpected string" in a console [#371]

[2.0.1] - 2021-04-19

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].
• Maven artifacts published to Maven Central (due to shutting down of Bintray, JCenter)

[1.3.0] - 2021-03-22

Added

• facet_wrap() function.

• in facet_grid() function:

  • Ascending/descending ordering of faceting values.
  • Formatting of faceting values.

  See: Facets demo

• The format parameter in positional scales: formatting tick labels on X/Y axis. Supported types are number and date/time.

  Example:

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

  Demo: Formatting demo

  See also: Formatting

• The guides() function [#52].

• In tooltip customization API:

  • option color overrides the default tooltip color:

    geom_xxx(tooltips=layer_tooltips().color("red"))
    

  See: Tooltip Customization.

Changed

• Built with Lets-Plot v2.0.1 (was v1.5.6).
• All Java Swing demos were updated to use new plot components (new in Lets-Plot v2.0.1).
• The "Minimal demo" was updated:
  • Main.kt (Batik)
  • Main.kt (JavaFX)

Fixed

• show() should actually show a plot [#51]
• Facet grid truncated in jupyter [#28].

The majority of fixes in the core Lets-Plot vv 2.0.0, 2.0.1 are also applicable to this release.

See the Lets-Plot CHANGELOG.md.

[1.2.0] - 2021-01-15

Added

• Correlation plot builder.

  Example: correlation_plot.ipynb

• The gggrid() plot layout utility

  Example: correlation_plot.ipynb

• In tooltip customization API:

  • options: center and middle (anchor).
  • option 'minWidth'.

  Example: tooltip_config.ipynb

• The naText parameter in geom_text()

Changed

• Built with Lets-Plot v1.5.6 (was v1.5.4).

  See Lets-Plot CHANGELOG.md for changes and fixes in 1.5.5, 1.5.6.

[1.1.0] - 2020-11-20

Added

• GeoTools support (see geotools.md).
• API for tooltip customization ( see tooltips.md).
• geom_map().
• labelFormat parameter in geom_text().
• reverse parameter in scale_x/y_discrete().
• scale_x_discrete_reversed(), scale_y_discrete_reversed()

Changed

• Built with Lets-Plot v1.5.4 (was v1.5.2).

  See Lets-Plot CHANGELOG.md for changes and fixes in 1.5.3, 1.5.4.

Fixed

• ggsave() ignores raster format file extension.
• as_discrete(): if more than one is used in the same mapping block, then all but one of them are ignored.

[1.0.0] - 2020-08-13

Added

• The first public release.

Changed

• Maven artifact group id has changed.
  • was before: org.jetbrains.lets-plot
  • since now : org.jetbrains.lets-plot-kotlin