Benchmarking is an important part of writing efficient Kotlin code. The kotlinx-benchmark library helps you measure and compare performance across different implementations or hardware configurations.

However, raw text results only take you so far. Sometimes you need to visualize your data, not just read it. That’s where Kotlin notebooks come in.

Kotlin notebooks combine the expressiveness of Kotlin with the interactivity of notebook-style development. They give you one convenient place where you can:

1. Load results as structured data.
2. Explore results using the DataFrame API.
3. Visualize results with charts.

Comparing benchmark results

Kotlin notebooks make it easy to analyze and plot results from one or more benchmark runs.

For example, you can:

1. Read benchmark JSON files generated by kotlinx-benchmark.
2. Convert the results into typed DataFrames.
3. Compute metrics such as percentage improvements.
4. Plot the results with Kandy charts.
5. Account for confidence intervals to perform statistically rigorous comparisons.

Several benchmark examples are available in the examples folder of the kotlinx-benchmark repository.

Generating and sharing notebooks

Once your notebook is ready, you can:

1. Create a GitHub gist to share results quickly.
2. Commit the notebook to your project for reproducible performance tracking.
3. Publish it with JetBrains Datalore for interactive viewing online.

This workflow makes benchmark results easier to understand and share with your team.

Learn more

1. kotlinx-benchmark examples
2. Kotlin Notebook documentation