Getting Started
Edit pageLast modified: 02 December 2024You can utilize Kandy both in Kotlin projects and in interactive editors. For detailed instructions, refer to the respective pages:
Kotlin Notebook
Datalore
Jupyter Notebook
Gradle ConfigurationGetting Kandy
note
With Kotlin Notebook, you can enjoy an unparalleled experience in data analysis and visualization. While this platform offers a premier user experience, rest assured that Kandy maintains a high standard of functionality and support across all other editors as well.
How to Install Kotlin Notebook?
You can find detailed instructions here.
Install IntelliJ IDEA Ultimate if you don't already have it.
Open your IDE and press to open the IDE settings.
Select Plugins from the menu and install the Kotlin Notebook plugin.
Click Ok to apply the changes and restart your IDE if prompted.
Create a new Kotlin Notebook file.
Run this cell:
%use kandy // If you are using dataframe as data %use dataframe
Congratulations, you now have access to the Kandy library in Kotlin Notebook.
How to Use Datalore?
You can find detailed instructions here.
Open Datalore.
Register if you don't have an account.
Create a new notebook.
Select the Kotlin Kernel.
Run this cell:
%use kandy // If you are using dataframe as data %use dataframe
Congratulations, you now have access to the Kandy library in Datalore.
How to Install Jupyter with Kotlin?
You can find detailed instructions here.
Install Jupyter.
Install the Kotlin Kernel using one of the following methods:
pip
pip install kotlin-jupyter-kernelconda
conda install -c jetbrains kotlin-jupyter-kernelRun Jupyter by executing the following command in the terminal:
jupyter notebookCreate a new notebook by selecting the Kotlin kernel.
Run this cell in the notebook:
%use kandy // If you are using dataframe as data %use dataframe
Congratulations, you now have access to the Kandy library in Jupyter Notebook.
Gradle Configuration
You can find detailed instructions here.
Create a JVM project with Kotlin in your IDE.
Add the Kandy dependency to your build.gradle.kts file:
dependencies { implementation("org.jetbrains.kotlinx:kandy-lets-plot:0.8.0") }
Congratulations, you now have access to the Kandy library in your Kotlin project.
Plotting a Simple Example
tip
In interactive notebooks, the Kotlin DataFrame library employs an on-the-fly generation mechanism for extension properties that correspond to the columns of a data frame. In IntelliJ IDEA, there is a Gradle plugin available for generating properties based on CSV or JSON files. In cases where this mechanism is not utilized, you can still access the columns by passing the column names as string variables.
Let's create data that will be used to construct the plot. This data will represent the average annual temperatures in various cities. When working in interactive notebooks, it is advisable to divide the data creation and plot construction into two separate cells. This approach ensures that extension properties are generated for our columns in the DataFrame, allowing us to reference them easily.
First, create a DataFrame containing data on the average temperatures in different cities as follows:
// Create a DataFrame with data on average temperatures in various cities
val averageTemperature = dataFrameOf(
"city" to listOf("New York", "London", "Berlin", "Yerevan", "Tokyo"),
"average temperature" to listOf(12.5, 11.0, 9.6, 11.5, 16.0)
)Next, construct a simple plot using the data from the DataFrame:
// Construct a plot using the data from the DataFrame
averageTemperature.plot {
// Add bars to the plot
// Each bar represents the average temperature in a city
bars {
x(city) // Set the cities' data on the X-axis
y(`average temperature`) { // Set the temperatures' data on the Y-axis
axis.name = "Average Temperature (°C)" // Assign a name to the Y-axis
}
}
// Set the title of the plot
layout.title = "Kandy Getting Started Example"
}
This supplementary schema outlines the key elements of Kandy's DSL, providing a quick reference to assist you in building your visualizations.
plot
For more examples, please see the Examples section.