@data2viz/d2v-hierarchy

Data2viz hierarchy module


Keywords
Kotlin, JavaScript, data2viz, data-visualization, dataviz
License
Apache-2.0
Install
npm install @data2viz/d2v-hierarchy@0.8.17

Documentation

Data2viz

Build Status GitHub License

Build JS Build JS Build JS Build JS

Isomorphic dataviz

Data2viz is a data visualization toolbox for Kotlin Multiplatform.

You can pick what you need in the different modules and use them independently in the following environments: Android, JavaScript(IR and Legacy), and JavaFX (iOS to come).

Your code produces the same results and rendering on each platform.

A lot of algorithms come from d3js modules.

This module exposes some basics elements like Circle, Rect, Path, and also some parts of DSL (percent, angles, etc.).

This module provides algorithms to create, modify, and convert colors through differents spaces (RGB, HCL, HSL, Lab). It also manage linear and radial color gradients. You can easily use it outside of data2viz.

Algorithms to generate paths: symbols, curves, ...

Different ways to convert data to sizes.

Functions to perform interpolation of various elements (numbers, colors, points, curves)

Algorithms to generate random data.

Helper module to create axis for charts, using scales.

This module is a high performant algorithm to compute the Voronoi diagram. You should use it in many use cases to find the closest point of interest to the pointer position.

This module contains a collection of easing functions to manage acceleration inside animations.

dsv

Minimal way of parsing CSV, TSV files using Kotlin.

Use physics to animate your visualizations.

Different ways of formating numbers and currencies.

Some multiplatform classes to manage time and dates in visualizations.

Extend formatting to time and dates.

Separation of space through the quadtree algorithm.

Fortune's algorithm implementation of the Voronoi diagram. You should probably use Delaunay instead.

geo

A collection of mechanisms and functions to project GeoJson elements (points, lines, polygons) on a screen using different implementations of projections.

A useful way of aggregating data using hexagons. You can represent data through the fill color or the area.

A generator for sankey charts.

A generator for hierarchical charts.

An internal module used to simplify multiplatform testing with a higher DSL.

A multiplatform implementation to manage animations through shared frames.

viz

Multiplatorm API and implementation of rendering and events management.

Data2viz allows you to develop data visualizations through a fully typed DSL. It simplifies the creation of complex visualizations via the IDE’s context-based suggestions.

Where should I start?

Documentation

All data2viz documentation is located in a distinct documentation project. You should start there and follow the first JavaFX tutorial.

Data2viz Playground

You can also play with the API without installing anything. Data2viz playground is a website where you can browse existing sample, modify them online and immediately see the result.

Using in your projects

Note that the library is experimental, and the API is subject to change.

The library is published to data2viz space repository.

Gradle

  • In multiplatform projects, add a dependency to the commonMain source set dependencies
kotlin {
    sourceSets {
        commonMain {
             dependencies {
                 implementation("io.data2viz.d2v:d2v-axis:0.10.7")
                 implementation("io.data2viz.d2v:d2v-chord:0.10.7")
                 implementation("io.data2viz.d2v:d2v-color:0.10.7")
                 implementation("io.data2viz.d2v:d2v-contour:0.10.7")
                 implementation("io.data2viz.d2v:d2v-delaunay:0.10.7")
                 implementation("io.data2viz.d2v:d2v-dsv:0.10.7")
                 implementation("io.data2viz.d2v:d2v-ease:0.10.7")
                 implementation("io.data2viz.d2v:d2v-force:0.10.7")
                 implementation("io.data2viz.d2v:d2v-format:0.10.7")
                 implementation("io.data2viz.d2v:d2v-geo:0.10.7")
                 implementation("io.data2viz.d2v:d2v-hexbin:0.10.7")
                 implementation("io.data2viz.d2v:d2v-hierarchy:0.10.7")
                 implementation("io.data2viz.d2v:d2v-quadtree:0.10.7")
                 implementation("io.data2viz.d2v:d2v-random:0.10.7")
                 implementation("io.data2viz.d2v:d2v-scale:0.10.7")
                 implementation("io.data2viz.d2v:d2v-shape:0.10.7")
                 implementation("io.data2viz.d2v:d2v-tile:0.10.7")
                 implementation("io.data2viz.d2v:d2v-time:0.10.7")
                 implementation("io.data2viz.d2v:d2v-timer:0.10.7")
                 implementation("io.data2viz.d2v:d2v-viz:0.10.7")
             }
        }
    }
}
  • To use the library in a single-platform project, add a dependency to the dependencies block.
dependencies {
    implementation("io.data2viz.d2v:d2v-axis:0.10.7")
    implementation("io.data2viz.d2v:d2v-chord:0.10.7")
    implementation("io.data2viz.d2v:d2v-color:0.10.7")
    implementation("io.data2viz.d2v:d2v-contour:0.10.7")
    implementation("io.data2viz.d2v:d2v-delaunay:0.10.7")
    implementation("io.data2viz.d2v:d2v-dsv:0.10.7")
    implementation("io.data2viz.d2v:d2v-ease:0.10.7")
    implementation("io.data2viz.d2v:d2v-force:0.10.7")
    implementation("io.data2viz.d2v:d2v-format:0.10.7")
    implementation("io.data2viz.d2v:d2v-geo:0.10.7")
    implementation("io.data2viz.d2v:d2v-hexbin:0.10.7")
    implementation("io.data2viz.d2v:d2v-hierarchy:0.10.7")
    implementation("io.data2viz.d2v:d2v-quadtree:0.10.7")
    implementation("io.data2viz.d2v:d2v-random:0.10.7")
    implementation("io.data2viz.d2v:d2v-scale:0.10.7")
    implementation("io.data2viz.d2v:d2v-shape:0.10.7")
    implementation("io.data2viz.d2v:d2v-tile:0.10.7")
    implementation("io.data2viz.d2v:d2v-time:0.10.7")
    implementation("io.data2viz.d2v:d2v-timer:0.10.7")
    implementation("io.data2viz.d2v:d2v-viz:0.10.7")
}

Current status and roadmap

APIs are mostly stabilized now, but there may still be some breaking changes before v1.0.

Inspirations

  • d3js: a lot of modules and algorithms come from d3js.
  • paperjs: another source of inspiration for viz hierarchy and simple API.
  • chromajs: smart library for managing colors easily.
  • delaunator: a really fast JavaScript library for Delaunay triangulation of 2D points.
  • kotlinx.html: isomorphic html rendering.
  • kotlintest: nice DSL for testing (partly ported in test).