当前位置：首页 > news >正文

Kandy：Kotlin数据可视化新选择！打造优雅图表的完整指南

news 2026/7/12 23:24:17

Kandy：Kotlin数据可视化新选择！打造优雅图表的完整指南

【免费下载链接】kandyKotlin plotting library.项目地址: https://gitcode.com/gh_mirrors/ka/kandy

你是否正在寻找一款强大且易用的Kotlin数据可视化库？Kandy就是你的终极解决方案！作为JetBrains孵化的开源项目，Kandy为Kotlin开发者提供了现代化的图表绘制体验，让数据可视化变得前所未有的简单和高效。无论你是数据分析师、数据科学家还是应用开发者，Kandy都能帮助你快速创建专业级的数据可视化图表。

🚀 为什么选择Kandy？

Kandy不仅仅是一个图表库，它是一个完整的Kotlin数据可视化生态系统。基于"图形语法"（Grammar of Graphics）理念，Kandy提供了直观的领域特定语言（DSL），让你能够用最少的代码创建最复杂的可视化效果。

核心优势亮点

跨平台兼容性：Kandy在多种Kotlin笔记本平台上无缝工作，包括IntelliJ IDEA的Kotlin Notebook插件、Datalore和Jupyter Notebook。这意味着你可以在不同的开发环境中获得一致的体验！

强大的渲染引擎：Kandy支持多种渲染引擎，包括基于Lets-Plot的kandy-lets-plot模块和基于Apache ECharts的kandy-echarts模块。你可以根据具体需求选择最适合的渲染引擎。

交互式功能：图表支持交互式工具提示，无论是在HTML还是Swing渲染中都能提供动态的用户体验。

多格式导出：轻松将图表导出为SVG、PNG、HTML、JPG/JPEG和TIFF格式，满足各种发布和分享需求。

完美集成：与Kotlin标准集合和Kotlin DataFrame无缝集成，特别适合处理分层数据结构。

📦 快速安装指南

在Kotlin Notebook中使用

在Kotlin Notebook、Datalore或Jupyter中使用Kandy非常简单，只需一行魔法命令：

%use kandy

如果你想使用最新版本，可以这样配置：

%useLatestDescriptors %use kandy

在Gradle项目中集成

对于标准的Kotlin项目，你可以在build.gradle.kts中添加依赖：

dependencies { implementation("org.jetbrains.kotlinx:kandy-lets-plot:$kandy_version") }

确保你的repositories中包含Maven Central：

repositories { mavenCentral() }

🎨 Kandy DSL：优雅的语法结构

Kandy的DSL设计非常直观，遵循层次化结构。让我们通过一个简单的例子来感受它的魅力：

val weatherData = mapOf( "time" to listOf(0, 1, 2, 4, 5, 7, 8, 9), "temperature" to listOf(12.0, 14.2, 15.1, 15.9, 17.9, 15.6, 14.2, 24.3), "humidity" to listOf(0.5, 0.32, 0.11, 0.89, 0.68, 0.57, 0.56, 0.5) ) plot(weatherData) { x("time") y("temperature") { scale = continuous(0.0..25.5) } bars { fillColor("humidity") { scale = continuous(range = Color.YELLOW..Color.RED) } borderLine.width = 0.0 } line { width = 3.0 color = Color.hex("#6e5596") type = LineType.DOTDASH } layout { title = "天气数据可视化示例" size = 700 to 450 } }

🔧 主要功能模块详解

kandy-api模块

这是Kandy的核心API模块，提供了统一的图表创建接口。无论你使用哪个渲染引擎，都可以通过相同的API来创建图表。

kandy-lets-plot模块

基于JetBrains的Lets-Plot库，提供了强大的静态图表渲染能力。这个模块特别适合需要高质量静态图表的场景。

kandy-echarts模块

基于Apache ECharts，提供了丰富的交互式图表功能。如果你需要创建交互式仪表板或需要复杂交互的图表，这是最佳选择。

📊 实际应用场景

数据分析与探索

Kandy与Kotlin DataFrame的深度集成，让你能够直接从数据框创建可视化：

val salesData = dataFrameOf( "month" to listOf("Jan", "Feb", "Mar", "Apr", "May"), "revenue" to listOf(12000, 15000, 18000, 14000, 16000), "expenses" to listOf(8000, 9000, 11000, 8500, 9500) ) salesData.plot { x(month) y(revenue) bars { fillColor = Color.BLUE } layout { title = "月度营收分析" xAxis.title = "月份" yAxis.title = "金额（元）" } }

科学可视化

对于科学计算和工程应用，Kandy提供了丰富的统计图表支持：

val experimentData = mapOf( "trial" to (1..100).toList(), "result" to List(100) { random.nextDouble() * 100 } ) plot(experimentData) { statBin("result") { bars { fillColor = Color.GREEN alpha = 0.7 } } layout { title = "实验结果分布直方图" } }

🎯 高级功能与技巧

自定义主题和样式

Kandy允许你完全控制图表的外观：

plot(data) { // 图表层定义... layout { title = "自定义主题示例" theme { panelGrid { majorLine.color = Color.GRAY minorLine.color = Color.LIGHT_GRAY } axis { line.color = Color.BLACK ticks.color = Color.DARK_GRAY } } } }

多图层组合

你可以轻松组合多个图层创建复杂的可视化：

plot(data) { points { x("x_values") y("y_values") color = Color.BLUE size = 4.0 } line { statSmooth("x_values", "y_values") color = Color.RED width = 2.0 } layout { title = "数据点与趋势线" } }

交互式工具提示配置

Kandy的交互式功能让你可以自定义工具提示：

plot(data) { bars { x("category") y("value") tooltip { title = "类别: {category}" text = "数值: {value}" style { backgroundColor = Color.WHITE borderColor = Color.GRAY } } } }