Spec-Zone.ru › Kotlin 2

Визуализация данных с помощью Lets-Plot для Kotlin

Lets-Plot для Kotlin (LPK) — это мультиплатформенная библиотека для построения графиков, переносящая библиотеку ggplot2 для R в Kotlin. LPK предоставляет богатый возможностями API ggplot2 в экосистеме Kotlin, что делает её подходящей для учёных и статистиков, которым нужны расширенные возможности визуализации данных.

LPK поддерживает различные платформы, включая Kotlin/JS, Swing для JVM, JavaFX и Compose Multiplatform. Кроме того, LPK легко интегрируется с IntelliJ, DataGrip, DataSpell и PyCharm.

Lets-Plot

В этом руководстве показано, как создавать диаграммы разных типов с помощью библиотек LPK и Kotlin DataFrame в IntelliJ IDEA.

Перед началом работы

Начиная с IntelliJ IDEA 2026.2, Kotlin Notebook больше не будет поставляться в комплекте со средой разработки и официально поддерживаться JetBrains. Исходный код останется доступен на GitHub.

Подробнее читайте в публикации в блоге.

Создайте Kotlin Notebook для работы с Lets-Plot:

  1. Выберите Файл | Создать | Kotlin Notebook.

  2. Импортируйте библиотеки LPK и Kotlin DataFrame в ноутбук, выполнив следующую команду:

    %use lets-plot
    %use dataframe
    

Чтобы следовать руководству, вы также можете добавить DataFrame в качестве зависимости Gradle или Maven.

Подготовка данных

Создадим DataFrame, в котором хранятся смоделированные значения среднемесячной температуры в трёх городах: Берлине, Мадриде и Каракасе.

Используйте функцию dataFrameOf() из библиотеки Kotlin DataFrame, чтобы создать DataFrame. Вставьте и выполните следующий фрагмент кода:

// The months variable stores a list with 12 months of the year
val months = listOf(
    "January", "February",
    "March", "April", "May",
    "June", "July", "August",
    "September", "October", "November",
    "December"
)
// The tempBerlin, tempMadrid, and tempCaracas variables store a list with temperature values for each month
val tempBerlin =
    listOf(-0.5, 0.0, 4.8, 9.0, 14.3, 17.5, 19.2, 18.9, 14.5, 9.7, 4.7, 1.0)
val tempMadrid =
    listOf(6.3, 7.9, 11.2, 12.9, 16.7, 21.1, 24.7, 24.2, 20.3, 15.4, 9.9, 6.6)
val tempCaracas =
    listOf(27.5, 28.9, 29.6, 30.9, 31.7, 35.1, 33.8, 32.2, 31.3, 29.4, 28.9, 27.6)

// The df variable stores a DataFrame of three columns, including monthly records, temperature, and cities
val df = dataFrameOf(
    "Month" to months + months + months,
    "Temperature" to tempBerlin + tempMadrid + tempCaracas,
    "City" to List(12) { "Berlin" } + List(12) { "Madrid" } + List(12) { "Caracas" }
)
df.head(4)

Как видно, DataFrame содержит три столбца: месяц, температура и город. В первых четырёх строках DataFrame записаны значения температуры в Берлине с января по апрель:

Dataframe exploration

Чтобы создать диаграмму с помощью библиотеки LPK, необходимо преобразовать данные (df) в тип Map, который хранит данные в виде пар «ключ — значение». Преобразовать DataFrame в Map можно с помощью функции .toMap():

val data = df.toMap()

Создание точечной диаграммы

Создадим точечную диаграмму с помощью библиотеки LPK.

Когда данные будут представлены в формате Map, используйте функцию geomPoint() из библиотеки LPK, чтобы построить точечную диаграмму. Можно указать значения для осей X и Y, а также определить категории и их цвета. Кроме того, можно настроить размер диаграммы и форму точек в соответствии со своими потребностями:

// Specifies X and Y axes, categories and their color, plot size, and plot type
val scatterPlot =
    letsPlot(data) { x = "Month"; y = "Temperature"; color = "City" } + ggsize(600, 500) + geomPoint(shape = 15)
scatterPlot

Результат:

Scatter plot

Создание ящичной диаграммы

Визуализируем данные с помощью ящичной диаграммы. Используйте функцию geomBoxplot() из библиотеки LPK для построения диаграммы и функцию scaleFillManual(), чтобы настроить цвета:

// Specifies X and Y axes, categories, plot size, and plot type
val boxPlot = ggplot(data) { x = "City"; y = "Temperature" } + ggsize(700, 500) + geomBoxplot { fill = "City" } +
    // Customizes colors        
    scaleFillManual(values = listOf("light_yellow", "light_magenta", "light_green"))
boxPlot

Результат:

Box plot

Создание двумерной диаграммы плотности

Теперь создадим двумерную диаграмму плотности, чтобы визуализировать распределение и концентрацию случайных данных.

Подготовка данных для двумерной диаграммы плотности

  1. Импортируйте зависимости для обработки данных и построения диаграммы:

    %use lets-plot
    
    @file:DependsOn("org.apache.commons:commons-math3:3.6.1")
    import org.apache.commons.math3.distribution.MultivariateNormalDistribution
    
  2. Вставьте и выполните следующий фрагмент кода, чтобы создать наборы двумерных точек данных:

    // Defines covariance matrices for three distributions
    val cov0: Array<DoubleArray> = arrayOf(
        doubleArrayOf(1.0, -.8),
        doubleArrayOf(-.8, 1.0)
    )
    
    val cov1: Array<DoubleArray> = arrayOf(
        doubleArrayOf(1.0, .8),
        doubleArrayOf(.8, 1.0)
    )
    
    val cov2: Array<DoubleArray> = arrayOf(
        doubleArrayOf(10.0, .1),
        doubleArrayOf(.1, .1)
    )
    
    // Defines the number of samples
    val n = 400
    
    // Defines means for three distributions
    val means0: DoubleArray = doubleArrayOf(-2.0, 0.0)
    val means1: DoubleArray = doubleArrayOf(2.0, 0.0)
    val means2: DoubleArray = doubleArrayOf(0.0, 1.0)
    
    // Generates random samples from three multivariate normal distributions
    val xy0 = MultivariateNormalDistribution(means0, cov0).sample(n)
    val xy1 = MultivariateNormalDistribution(means1, cov1).sample(n)
    val xy2 = MultivariateNormalDistribution(means2, cov2).sample(n)
    

    В приведённом выше коде переменные xy0, xy1 и xy2 содержат массивы двумерных точек данных (x, y).

  3. Преобразуйте данные в тип Map:

    val data = mapOf(
        "x" to (xy0.map { it[0] } + xy1.map { it[0] } + xy2.map { it[0] }).toList(),
        "y" to (xy0.map { it[1] } + xy1.map { it[1] } + xy2.map { it[1] }).toList()
    )
    

Построение двумерной диаграммы плотности

Используя Map из предыдущего шага, создайте двумерную диаграмму плотности (geomDensity2D) с точечной диаграммой (geomPoint) на заднем плане, чтобы лучше визуализировать точки данных и выбросы. Для настройки цветовой шкалы можно использовать функцию scaleColorGradient():

val densityPlot = letsPlot(data) { x = "x"; y = "y" } + ggsize(600, 300) + geomPoint(
    color = "black",
    alpha = .1
) + geomDensity2D { color = "..level.." } +
        scaleColorGradient(low = "dark_green", high = "yellow", guide = guideColorbar(barHeight = 10, barWidth = 300)) +
        theme().legendPositionBottom()
densityPlot

Результат:

2D density plot

Что дальше

  • Посмотрите примеры других диаграмм в документации Lets-Plot для Kotlin.

  • Изучите справочник по API Lets-Plot для Kotlin.

  • Узнайте о преобразовании и визуализации данных с помощью Kotlin в документации библиотек Kotlin DataFrame и Kandy.

2 февраля 2026 г.
Визуализация данных с помощью KandyБиблиотеки Kotlin и Java для анализа данных

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/lets-plot.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API