Enables simple access to Plotly functionality, facilitating the creation and rendering of interactive plots and charts. Supports HTML export, dynamic updates via Ktor server, JavaFX browser integration, Jupyter notebooks, and direct image rendering.
Plotly-kt is now developed as a part of VisionForge project and changed maven coordinates
New github location: https://github.com/SciProgCentre/visionforge/tree/main/plotly-kt
New development location: https://git.sciprog.center/kscience/visionforge/src/branch/main/plotly-kt
New maven coordinates: plotly-kt instead of plotlykt. Verstion now follows VisionForge versioning.
Dev builds and intermediate artifacts are available via https://repo.kotlin.link maven repository.
The current $version version of the library is compatible with kotlin 1.4 with JS-IR and kotlinx-serialization 1.1.0. The JVM part requires JVM 11 to run.
See examples. See original library samples to understand capabilities.
This project is developed to allow simple access to plotly functionality from kotlin-multiplatform. The API allows to create plotly configuration and render it as a plotly chart.
The library supports three drawable plot objects:
Plot itself stands for a stand-alone plot frame. It requires external infrastructure to load appropriate JavaScript libraries.PlotFragment is an HTML fragment possibly including several plots. The API for html is provided by kotlinx-html library.PlotlyPage is a complete page, including body fragment and page headers (needed to load JavaScript part of Plotly).The work with plotly graphs could be rendered in following modes:
(JVM and native) Export plot or page in a standalone html file, using CDN distribution or local JS file (JVM only). This mode does not support updates.
See staticPlot and
customPage for examples.
(JVM only) A Ktor CIO server with full multi-page and update capabilities.
See simpleServer and
dynamicServer for examples.
Plotly is a JavaScript library, yet it is convenient to have a type-safe API when using in with Kotlin-JS. The sample application is available in js-demo module. One should node that Plotly.kt for JS is not a zero-cost wrapper like TypeScript definitions, it maintains its own object structure, could generate stand-alone models and some internal optimizations.
Plotly.kt could be run in a JavaFX browser. An example project is presented in fx-demo.
Plotly.kt comes with (beta-version) support for integration with Kotlin Jupyter kernel. See details here.
The examples of the notebooks are shown in notebooks directory. Plotly.kt uses Kotlin jupyter notebook API for integration (available in kernel version 0.8.3.236 and later). In order to load the library together with automatic imports one need to simply load a library in a following way:
@file:Repository("https://repo.kotlin.link")
@file:DependsOn("space.kscience:plotlykt-jupyter:$version")
//@file:DependsOn("space.kscience:plotlykt-server:$version") // Use this one for sever integration.
The module plotly allows rendering static plots in Jupyter. Jupyter lab is currently supported. Jupyter notebook (classic) is able to render only PlotlyPage objects, so one must convert plots to pages to be able to use notebook (see demo notebook).
The module plotly-server adds server capabilities and allows to render dynamic plots in notebooks (see demo notebook). One must note that for dynamic pages, one must pass renderer parameter explicitly to plot like it is done in examples.
IMPORTANT: By default, Plotly-kt jupyter integration is configured to work with Jupyter Lab frontend, which renders all cells in the same page. Jupyter classic notebook and DataLore use cell isolation with iframes, so you will see blanks instead of plots. It could be fixed by switching into a notebook mode by running Plotly.jupyter.notebook() in a cell after plotly library is loaded.
Plotly Orca application allows direct rendering of plots (not fragments or pages) to raster of vector images.
Plot.export extension could be used to call it. It requires for orca to be installed in the system and available on the system path.
It is possible to separate script logic into stand-alone plotly.kts script file and generate an html from the command line. See plotlykt-script module for details.
Plotly model now fully supports Kotlin/Native. It means that you can use it to create a proper Plotly-based HTML file. You will still need browser to view it. You can use native-demo example.
There are three ways to solve it:
In order to use the library, one needs to use following gradle.kts configuration:
plugins {
kotlin("jvm")
}
repositories {
maven("https://repo.kotlin.link")
}
dependencies {
implementation("space.kscience:plotlykt-server:$version")
}
If you do not need the server, then use plotlykt-core instead.
The library keeps original Plotly API naming wherever it is possible. There are some usability shortcuts, usually provided via kotlin extensions, included in order to simplify user interaction. For example, text and shape extensions in the top level API.
Keeping the original naming sometimes causes clashes with Kotlin code style. For example enum names are unorthodox.
0.2 release.The project was partially founded by JetBrains Research grant.
Surfaced from shared tags and platforms — no rankings paid for.