• Stars
    star
    690
  • Rank 62,727 (Top 2 %)
  • Language
    Kotlin
  • License
    Apache License 2.0
  • Created almost 4 years ago
  • Updated 20 days ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Structured data processing in Kotlin

Kotlin Dataframe: typesafe in-memory structured data processing for JVM

JetBrains incubator project Kotlin component alpha stability Kotlin Dynamic XML Badge Dynamic XML Badge GitHub License Binder

Kotlin Dataframe aims to reconcile Kotlin's static typing with the dynamic nature of data by utilizing both the full power of the Kotlin language and the opportunities provided by intermittent code execution in Jupyter notebooks and REPL.

  • Hierarchical — represents hierarchical data structures, such as JSON or a tree of JVM objects.
  • Functional — data processing pipeline is organized in a chain of DataFrame transformation operations. Every operation returns a new instance of DataFrame reusing underlying storage wherever it's possible.
  • Readable — data transformation operations are defined in DSL close to natural language.
  • Practical — provides simple solutions for common problems and the ability to perform complex tasks.
  • Minimalistic — simple, yet powerful data model of three column kinds.
  • Interoperable — convertable with Kotlin data classes and collections.
  • Generic — can store objects of any type, not only numbers or strings.
  • Typesafe — on-the-fly generation of extension properties for type safe data access with Kotlin-style care for null safety.
  • Polymorphic — type compatibility derives from column schema compatibility. You can define a function that requires a special subset of columns in dataframe but doesn't care about other columns.

Integrates with Kotlin kernel for Jupyter. Inspired by krangl, Kotlin Collections and pandas

Documentation

Explore documentation for details.

You could find the following articles there:

Setup

implementation("org.jetbrains.kotlinx:dataframe:0.13.1")

Optional Gradle plugin for enhanced type safety and schema generation https://kotlin.github.io/dataframe/schemasgradle.html

id("org.jetbrains.kotlinx.dataframe") version "0.13.1"

Check out the custom setup page if you don't need some of the formats as dependencies, for Groovy, and for configurations specific to Android projects.

Getting started

import org.jetbrains.kotlinx.dataframe.*
import org.jetbrains.kotlinx.dataframe.api.*
import org.jetbrains.kotlinx.dataframe.io.*
val df = DataFrame.read("https://raw.githubusercontent.com/Kotlin/dataframe/master/data/jetbrains_repositories.csv")
df["full_name"][0] // Indexing https://kotlin.github.io/dataframe/access.html

df.filter { "stargazers_count"<Int>() > 50 }.print() 

Getting started with data schema

Requires Gradle plugin to work

id("org.jetbrains.kotlinx.dataframe") version "0.13.1"

Plugin generates extension properties API for provided sample of data. Column names and their types become discoverable in completion.

// Make sure to place the file annotation above the package directive
@file:ImportDataSchema(
    "Repository",
    "https://raw.githubusercontent.com/Kotlin/dataframe/master/data/jetbrains_repositories.csv",
)

package example

import org.jetbrains.kotlinx.dataframe.annotations.ImportDataSchema
import org.jetbrains.kotlinx.dataframe.api.*

fun main() {
    // execute `assemble` to generate extension properties API
    val df = Repository.readCSV()
    df.fullName[0]
    
    df.filter { stargazersCount > 50 }
}

Getting started in Jupyter Notebook / Kotlin Notebook

Install Kotlin kernel for Jupyter

Import stable dataframe version into notebook:

%use dataframe

or specific version:

%use dataframe(<version>)
val df = DataFrame.read("https://raw.githubusercontent.com/Kotlin/dataframe/master/data/jetbrains_repositories.csv")
df // the last expression in the cell is displayed

When a cell with a variable declaration is executed, in the next cell DataFrame provides extension properties based on its data

df.filter { stargazers_count > 50 }

Data model

  • DataFrame is a list of columns with equal sizes and distinct names.
  • DataColumn is a named list of values. Can be one of three kinds:
    • ValueColumn — contains data
    • ColumnGroup — contains columns
    • FrameColumn — contains dataframes

Syntax example

Let us show you how data cleaning and aggregation pipelines could look like with DataFrame.

Create:

// create columns
val fromTo by columnOf("LoNDon_paris", "MAdrid_miLAN", "londON_StockhOlm", "Budapest_PaRis", "Brussels_londOn")
val flightNumber by columnOf(10045.0, Double.NaN, 10065.0, Double.NaN, 10085.0)
val recentDelays by columnOf("23,47", null, "24, 43, 87", "13", "67, 32")
val airline by columnOf("KLM(!)", "{Air France} (12)", "(British Airways. )", "12. Air France", "'Swiss Air'")

// create dataframe
val df = dataFrameOf(fromTo, flightNumber, recentDelays, airline)

// print dataframe
df.print()

Clean:

// typed accessors for columns
// that will appear during
// dataframe transformation
val origin by column<String>()
val destination by column<String>()

val clean = df
    // fill missing flight numbers
    .fillNA { flightNumber }.with { prev()!!.flightNumber + 10 }

    // convert flight numbers to int
    .convert { flightNumber }.toInt()

    // clean 'airline' column
    .update { airline }.with { "([a-zA-Z\\s]+)".toRegex().find(it)?.value ?: "" }

    // split 'fromTo' column into 'origin' and 'destination'
    .split { fromTo }.by("_").into(origin, destination)

    // clean 'origin' and 'destination' columns
    .update { origin and destination }.with { it.lowercase().replaceFirstChar(Char::uppercase) }

    // split lists of delays in 'recentDelays' into separate columns
    // 'delay1', 'delay2'... and nest them inside original column `recentDelays`
    .split { recentDelays }.inward { "delay$it" }

    // convert string values in `delay1`, `delay2` into ints
    .parse { recentDelays }

Aggregate:

clean
    // group by the flight origin renamed into "from"
    .groupBy { origin named "from" }.aggregate {
        // we are in the context of a single data group

        // total number of flights from origin
        count() into "count"

        // list of flight numbers
        flightNumber into "flight numbers"

        // counts of flights per airline
        airline.valueCounts() into "airlines"

        // max delay across all delays in `delay1` and `delay2`
        recentDelays.maxOrNull { delay1 and delay2 } into "major delay"

        // separate lists of recent delays for `delay1`, `delay2` and `delay3`
        recentDelays.implode(dropNA = true) into "recent delays"

        // total delay per destination
        pivot { destination }.sum { recentDelays.colsOf<Int?>() } into "total delays to"
    }

Check it out on Datalore to get a better visual impression of what happens and what the hierarchical DataFrame structure looks like.

Explore more examples here.

Kotlin, Kotlin Jupyter, OpenAPI, Arrow and JDK versions

This table shows the mapping between main library component versions and minimum supported Java versions.

Kotlin DataFrame Version Minimum Java Version Kotlin Version Kotlin Jupyter Version OpenAPI version Apache Arrow version
0.10.0 8 1.8.20 0.11.0-358 3.0.0 11.0.0
0.10.1 8 1.8.20 0.11.0-358 3.0.0 11.0.0
0.11.0 8 1.8.20 0.11.0-358 3.0.0 11.0.0
0.11.1 8 1.8.20 0.11.0-358 3.0.0 11.0.0
0.12.0 8 1.9.0 0.11.0-358 3.0.0 11.0.0
0.12.1 8 1.9.0 0.11.0-358 3.0.0 11.0.0
0.13.1 8 1.9.22 0.12.0-139 3.0.0 15.0.0

Code of Conduct

This project and the corresponding community are governed by the JetBrains Open Source and Community Code of Conduct. Please make sure you read it.

License

Kotlin Dataframe is licensed under the Apache 2.0 License.

More Repositories

1

anko

Pleasant Android application development
Kotlin
15,927
star
2

kotlinx.coroutines

Library support for Kotlin coroutines
Kotlin
12,203
star
3

kotlinx.serialization

Kotlin multiplatform / multi-format serialization
Kotlin
4,951
star
4

dokka

API documentation engine for Kotlin
Kotlin
3,220
star
5

kotlin-examples

Various examples for Kotlin
3,177
star
6

KEEP

Kotlin Evolution and Enhancement Process
Markdown
3,109
star
7

kotlin-koans

Kotlin workshop
Kotlin
2,602
star
8

kotlinx-datetime

KotlinX multiplatform date/time library
Kotlin
2,166
star
9

kmm-production-sample

This is an open-source, mobile, cross-platform application built with Kotlin Multiplatform Mobile. It's a simple RSS reader, and you can download it from the App Store and Google Play. It's been designed to demonstrate how KMM can be used in real production projects.
Kotlin
1,868
star
10

coroutines-examples

Examples for coroutines design in Kotlin
1,465
star
11

kotlindl

High-level Deep Learning Framework written in Kotlin and inspired by Keras
Kotlin
1,373
star
12

kotlin-fullstack-sample

Kotlin Full-stack Application Example
Kotlin
1,218
star
13

kotlinx-kover

Kotlin
1,185
star
14

kotlinx.collections.immutable

Immutable persistent collections for Kotlin
Kotlin
1,064
star
15

kotlin-jupyter

Kotlin kernel for Jupyter/IPython
Kotlin
1,037
star
16

kmm-basic-sample

Example of Kotlin multiplatform project
Kotlin
887
star
17

kotlinx-cli

Pure Kotlin implementation of a generic CLI parser.
Kotlin
886
star
18

kotlinx-io

Kotlin multiplatform I/O library
Kotlin
817
star
19

kotlinx-atomicfu

The idiomatic way to use atomic operations in Kotlin
Kotlin
716
star
20

binary-compatibility-validator

Public API management tool
Kotlin
714
star
21

kotlinconf-spinner

Kotlin
603
star
22

workshop

JetBrains Kotlin Workshop Material
Kotlin
594
star
23

kotlin-interactive-shell

Kotlin Language Interactive Shell
Java
574
star
24

kotlin-frontend-plugin

Gradle Kotlin (http://kotlinlang.org) plugin for frontend development
Kotlin
570
star
25

multik

Kotlin
550
star
26

dukat

Converter of <any kind of declarations> to Kotlin external declarations
Kotlin
535
star
27

kdoctor

Environment analysis tool
Kotlin
509
star
28

kotlin-spark-api

This projects gives Kotlin bindings and several extensions for Apache Spark. We are looking to have this as a part of Apache Spark 3.x
Kotlin
435
star
29

kandy

Kotlin plotting library.
Kotlin
429
star
30

kotlin-by-example

The sources of Kotlin by Example.
396
star
31

kotlin-wasm-examples

Examples with Kotlin/Wasm
Kotlin
395
star
32

kotlinx-benchmark

Kotlin multiplatform benchmarking toolkit
Kotlin
387
star
33

kotlin-spec

Kotlin Language Specification:
Kotlin
358
star
34

kotlin-in-action

Code samples from the "Kotlin in Action" book
Kotlin
343
star
35

ts2kt

ts2kt is officially deprecated, please use https://github.com/Kotlin/dukat instead. // Converter of TypeScript definition files to Kotlin external declarations
Kotlin
320
star
36

kotlin-numpy

Kotlin bindings for NumPy
Kotlin
312
star
37

kotlin-style-guide

Work-in-progress notes for the Kotlin style guide
289
star
38

kotlinx-knit

Kotlin source code documentation management tool
Kotlin
287
star
39

anko-example

A small application built with Anko DSL
Kotlin
285
star
40

full-stack-web-jetbrains-night-sample

Full-stack demo application written with Kotlin MPP
Kotlin
271
star
41

kotlin-script-examples

Examples of Kotlin Scripts and usages of the Kotlin Scripting API
Kotlin
262
star
42

kotlinx-nodejs

Kotlin external declarations for using the Node.js API from Kotlin code targeting JavaScript
Kotlin
212
star
43

kotlin-eclipse

Kotlin Plugin for Eclipse
Kotlin
185
star
44

kotlinx.reflect.lite

Lightweight library allowing to introspect basic stuff about Kotlin symbols
Kotlin
150
star
45

api-guidelines

Best practices to consider when writing an API for your library
143
star
46

kotlin-benchmarks

This is the project to verify and investigate performance issues in Kotlin and standard library.
Kotlin
136
star
47

kotlin-libs-publisher

Gradle plugin for publishing of Kotlin libs
Kotlin
114
star
48

KMP-App-Template

Kotlin Multiplatform app template with shared UI
Kotlin
100
star
49

kotlinx-browser

Kotlin browser API
Kotlin
100
star
50

kotlindl-app-sample

This repo demonstrates how to use KotlinDL for neural network inference on Android devices.
Kotlin
96
star
51

kotlin-koans-edu

Kotlin Koans for Educational Plugin and play.kotl.in
Kotlin
93
star
52

grammar-tools

Tokenization and parsing Kotlin code using the ANTLR Kotlin grammar
Kotlin
83
star
53

kmm-integration-sample

Kotlin
76
star
54

kmm-with-cocoapods-sample

This project represents the case when Cocoapods dependencies are added in Kotlin and there is no existing Xcode project
Kotlin
57
star
55

kotlin-koans-edu-obsolete

Obsolete: check https://github.com/Kotlin/kotlin-koans-edu for the latest version.
Kotlin
55
star
56

kotlin-native-calculator-sample

55
star
57

kotlinx.support

Extension and top-level functions to use JDK7/JDK8 features in Kotlin 1.0
Kotlin
54
star
58

js-externals

External declarations for Kotlin/JS
53
star
59

coroutines-workshop

Materials for a full-day workshop on Kotlin Coroutines
Kotlin
42
star
60

kotlin-playground-wp-plugin

WordPress plugin which allows to embed interactive Kotlin playground to any post via [kotlin] shortcode
PHP
35
star
61

io2019-serverside-demo

E2E Sample
Kotlin
31
star
62

kotlin-jupyter-libraries

Library descriptors for Kotlin kernel for Jupyter
23
star
63

kmm-with-cocoapods-multitarget-xcode-sample

This project is intended to demonstrate how to connect Kotlin library to Xcode project with several targets: iOS, macOS, tvOS, watchOS
Swift
23
star
64

KMP-App-Template-Native

Kotlin Multiplatform app template with native UI
Kotlin
22
star
65

kmp-native-wizard

A mostly-empty template to get started creating a Kotlin/Native project.
Kotlin
22
star
66

xcode-compat

AppCode helper for Kotlin/Native and Xcode
Kotlin
21
star
67

kotlin-in-action-2e

Code samples for the second edition of "Kotlin in Action".
Kotlin
20
star
68

kotlinx.dom

Kotlin
17
star
69

dokka-plugin-template

Dokka plugin quickstart template with pre-configured dependencies and publishing
Kotlin
13
star
70

kotlin-wasm-benchmarks

Kotlin Multiplatform Collection of Benchmarks focused on Kotlin/Wasm performance
Kotlin
12
star
71

kotlinx.team.infra

Kotlin
10
star
72

multiplatform-library-template

Kotlin
10
star
73

kotlin-js-inspection-pack-plugin

Adds useful inspections, intentions, and quick-fixes for working with Kotlin/JS projects.
Kotlin
10
star
74

kotlin-wasm-compose-template

A template repository for Compose Multiplatform with Kotlin/Wasm target
Kotlin
9
star
75

obsolete-kotlin-swing

Experimental library providing some helper functions and extensions for creating Swing user interfaces.
Kotlin
8
star
76

kotlin-in-action-2e-jkid

Sample project accompanying the second edition of "Kotlin in Action". JSON serialization/deserialization library for Kotlin data classes
Kotlin
8
star
77

obsolete-kotlin-jdbc

Experimental library providing some helper functions and extensions for working with JDBC in Kotlin.
Kotlin
7
star
78

kotlin-grammar-gpl2

Kotlin grammar ANTLR sources (under GPLv2)
ANTLR
6
star
79

community-project-gradle-plugin

Kotlin
6
star
80

website-grammar-generator

Kotlin ANTLR grammar converter to XML for the Kotlin website or text file
Kotlin
6
star
81

kotlin-spark-shell

Kotlin Language support for Apache Spark
Kotlin
5
star
82

web-site-samples

Examples repository for kotlinlang.org
4
star
83

kotlin-wasm-browser-template

A template repository for Kotlin/Wasm on browser
HTML
4
star
84

kotlin-cocoapods-spec

Ruby
3
star
85

kotlin-build-report-sample

Kotlin
3
star
86

spec-tests-relinking-recommender

Tool for relinking recommendation of the Kotlin compiler spec tests, that are inconsistent to the latest Kotlin specification
Python
1
star
87

kmm-with-cocoapods-xcode-two-kotlin-libraries-sample

This project is intended to demonstrate the connection of two Kotlin libraries to existing Xcode project through Cocoapods
Kotlin
1
star
88

kotlin-wasm-wasi-template

A template repository for Kotlin/Wasm with WASI
Kotlin
1
star