knuton / elm-visualization

A visualization package for Elm (D3-like)

Elm-Visualization

This project is designed to give you all the tools needed to build data visualizations. It is not a charting library in the sense that you have pre-bundled Excel-style charts, but it should contain all the tools to make building such charts relatively easy. The advantage is that you are free to design and build data visualizations that uniquely suite your needs.

What's included?

Scales

Most of the time you have data that has properties that you want to display on the screen, however these properties typically aren't in pixels. Scales solve this
fundamental problem by giving you convenient ways to transform raw data into positions, sizes, colors, labels and other ways to display data.

Axis

A component that allows you to visualize a Scale. Those little ticks that describe the dimensions of a plot.

Paths

A thin layer that gives a simple DSL for drawing paths.

myPath = begin
       |> moveTo 10 30
       |> lineTo 40 50
       |> arcTo 20 30 12 43 (pi / 2)
       |> close

Shapes

This module gives you ways to draw some fundamental shapes used in data visualization.

Want to create a line chart with smooth curves?

path [d (Shape.line Shape.monotoneInXCurve dataPoints), stroke "2", fill "none"] []

Done.

Utilities

A bag of list processing methods that encapsulate common algorithms.

Acknowledgements

Currently, it is almost a straight port of parts of the D3 library by Mike Bostock. However since Elm provides a great DOM abstraction already, selections are not part of this library.

Contributing

This library is still under active development, so please submit feature requests iff you are also willing to implement them. Bug reports are welcome.

Some things worth working on:

• Scales have a number of stubs in them for other scale types.
• Shape could do with more line generators.