Kandy 0.7.1

This release adds compatibility with DataFrame v0.14.1.

Compatible version of statistics: 0.3.1.

Fixes

• Fixed axis position (#434).

Kandy 0.7.0

This release was mainly focused on technical debt and internal API improvements. Nevertheless, the result of this was noticeably reflected in the public API - in particular, all internal DSL properties were hidden, which will further improve the quality when working with completion in the IDE and library exploring.

Changed

⚠️ Breaking:

• Global refactoring of Kandy Internal API (#378, #379, #380, #381, #382). The structure of classes and interfaces has been significantly redesigned. This has almost no effect on the Public API (Kandy DSL), except that all internal properties are no longer publicly available (#163). If you have been using Kandy Internal API, we are ready to help you with migration, please contact us.

Added

• Added spacerWidth setting missing in pie charts (#385).
• Added type line parameter for custom styles (#334).

Fixes

• Fixed scale for area and bars (#236).
• Fixed border line type for tiles (#375).
• middle in boxes and y in crossBars are optional (#322).
• Several fixes in Kotlin Notebook:
  • Added theme selector in Save Plot action (#265).
  • Fixed tooltips hover-up (#290).

Documentation

• Added pie chart gallery examples (#424).
• Fixed links in documentation (#383, #386).

Other

• All TODOs were removed from the code by moving them to issues (#398).

We always welcome your contributions. Simple (but no less important) issues are labeled with . You can find them here.

Added

• Added candlestick plot (#149, #278). See documentation (guide and examples).
• Added extensions Plot.toSVG(), Plot.toPNG(), Plot.toHTML() (#293).
• Fixed tooltips behaviour (#156, #266). Now explicitly assigning tooltips removes side tooltips.
• Added boxes new whiskerWidth parameter (#299).
• Added void theme (#310).
• Added margin text parameter (#323).
• Added viridis color scales (#301).
• Added new scales transformations (#311).
• Added scale/axis position option (#306).
• Added extension functions to export plots to JPG and PNG as ByteArray (#325) by @gulshanpatidar.

Changed

⚠️ Breaking:

• Fixed naming of flavor/color scheme/theme (#127). Related properties was renamed:
  • flavor/Flavor -> theme/Theme
  • applyColorScheme -> applyTheme
  • theme/Theme -> style/Style
• hide: Boolean argument in tooltips() was replaced with enable: Boolean with the opposite behavior.

Fixed

• Tooltip bug (#136)

Documentation

• Added candlestick guide and examples (#149, #278).
• Added documentation for api of layers and statistical transformations (#314).
• Added FAQ section to documentation (#281).
• Fixed duplicating links on getting start page (#313) by @TCampbellSL.

Api changes:

• Stabilized core API - plot DSL:
  • plot creation with plot {} and DataFrame.plot {}
  • layers adding with LayerPlotContext.points {} and other layer functions
  • mappings (via function invocation) and settings(via var assignment) API
• Most of internal API in DSL are hidden(#163)
• Statistics was removed from kandy-lets-plot. The statistics have been reworked and separated into the new repository (private yet) and artifact.
• Restructured packages

Documentation

• All public APIs are documented with KDoc.
• New user documentation is written and available on kotlin.github.io/kandy/
• Also new example gallery is available on kotlin.github.io/kandy/examples

Fixes and improvements

• Fix bugs with plot dataset
• Fix web outputs
• Type parameters in scale creation functions are reordered according to arguments(#206)
• Add scale type bound for aes (#96)
• The static SVG view has been improved: it has become scalable and fitting.
• Small API improvements

Note! ⚠️ Some parts of the API have been changed without backwards compatibility, as the API was under active development before version 0.5.0. In case you used kandy before 0.5.0 and you are experiencing difficulties with migration to 0.5.0, please contact us.

New dataset system: by default layer uses global dataset, but if user makes a first mapping from new source whose size differs from the length of the global dataset columns, the leer creates a new dataset

Now lets-plot kandy plots in notebooks are displayed on github in svg format. Check it out:
https://github.com/Kotlin/kandy/blob/main/examples/notebooks/lets-plot/lets_plot_cheatsheet.ipynb

• pie chart (#142)
• alpha range validation (#130)
• required aes validation (#144)
• new LegendType API (#146)
• hLine and vLine fix
• tooltips API changes
• new Brewer colors API