JarCasting
JarCasting JarCasting

SPlot

Scala library for data visualization

License

License
GroupId

GroupId

com.github.piotr-kalanski
ArtifactId

ArtifactId

splot
Last Version

Last Version

0.2.0
Release Date

Release Date
Type

Type

jar
Description

Description

SPlot
Scala library for data visualization
Project URL

Project URL

https://github.com/piotr-kalanski/SPlot
Source Code Management

Source Code Management

https://github.com/piotr-kalanski/SPlot/tree/master

Download splot

Filename Size
splot-0.2.0.pom
splot-0.2.0.jar 297 KB
splot-0.2.0-sources.jar 23 KB
splot-0.2.0-javadoc.jar 601 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.piotr-kalanski/splot/ -->
<dependency>
    <groupId>com.github.piotr-kalanski</groupId>
    <artifactId>splot</artifactId>
    <version>0.2.0</version>
</dependency>
// https://jarcasting.com/artifacts/com.github.piotr-kalanski/splot/
implementation 'com.github.piotr-kalanski:splot:0.2.0'
// https://jarcasting.com/artifacts/com.github.piotr-kalanski/splot/
implementation ("com.github.piotr-kalanski:splot:0.2.0")
'com.github.piotr-kalanski:splot:jar:0.2.0'
<dependency org="com.github.piotr-kalanski" name="splot" rev="0.2.0">
  <artifact name="splot" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.github.piotr-kalanski', module='splot', version='0.2.0')
)
libraryDependencies += "com.github.piotr-kalanski" % "splot" % "0.2.0"
[com.github.piotr-kalanski/splot "0.2.0"]

Dependencies

compile (1)

Group / Artifact Type Version
org.knowm.xchart : xchart jar 3.2.2

test (2)

Group / Artifact Type Version
org.scalatest : scalatest_2.11 jar 3.0.1
junit : junit jar 4.10

Project Modules

There are no modules declared in this project.

SPlot

SPlot is Scala library for data visualization.

Build Status codecov.io License

Table of contents

Goals

Currently project is NOT focused on:

  • Performance
  • Rich possibilities for customization

Getting started

Include dependency:

"com.github.piotr-kalanski" % "splot" % "0.2.0"

or

<dependency>
    <groupId>com.github.piotr-kalanski</groupId>
    <artifactId>splot</artifactId>
    <version>0.2.0</version>
</dependency>

Import implicits, which adds methods to Scala collection enabling plotting:

import com.datawizards.splot.api.implicits._

Basic example

To plot bar chart using Scala sequence you need to call one method:

import com.datawizards.splot.api.implicits._

Seq(1.0, 4.0, 9.0).plotBar()

API possibilities

SPlot provides two API's for displaying plots:

Additional methods on collections

First API enrich Scala collections providing additional methods for plotting charts.

Examples:

val data = Seq((1,1),(2,2))

// Plot bar chart:
data.plotBar()

// Plot line chart:
data.plotLine()

// Plot scatter chart:
data.plotScatter()

// Start building plot:
data.buildPlot()

Providing independently axis values

Second API provides possibility to independently provide x and y values.

Examples:

// Plot bar chart:
SPlot.plotBar(Seq(1,2), Seq(1,4))

// Plot line chart:
SPlot.plotLine(Seq(1,2), Seq(1,4))

// Plot scatter chart:
SPlot.plotScatter(Seq(1,2), Seq(1,4))

// Start building plot:
SPlot.buildPlot(Seq(1,2), Seq(1,4))

Supported charts

Please note that all below examples require importing:

import com.datawizards.splot.api.implicits._

Please also note that most of below examples are based on randomly generated data!

Bar

Bar chart for sequence of numbers

val data = Seq(1.0, 4.0, 9.0)
data.plotBar()

Bar chart for sequence of case class

case class Person(name: String, age: Int)

val data = Seq(
    Person("p1", 45),
    Person("p2", 85),
    Person("p3", 78)
)

data.plotBar(_.age)

Bar chart for categorical data

val populationByCountry = Seq(
    ("DE", 81),
    ("TR", 72),
    ("FR", 63),
    ("UK", 62),
    ("IT", 61),
    ("ES", 46),
    ("UA", 45),
    ("PL", 38),
    ("RO", 19),
    ("NL", 17),
    ("GR", 11),
    ("PT", 11),
    ("BE", 10),
    ("CZ", 10),
    ("HU", 10)
  )

populationByCountry
    .buildPlot()
    .bar(_._1, _._2)
    .titles("Population by country [millions]", "Country", "Population")
    .size(1200, 300)
    .legendVisible(false)
    .display()

Scatter

Scatter chart for sequence of numbers

val data = Seq(
    (1.0, 1.0),
    (2.0, 4.0),
    (3.0, 9.0)
)

data.plotScatter()

Scatter chart for sequence of case class

case class AgeIncome(age: Int, income: Double)

val data = Seq(
    AgeIncome(20, 1000.0),
    AgeIncome(25, 2000.0),
    AgeIncome(30, 2500.0),
    AgeIncome(35, 3000.0),
    AgeIncome(40, 3500.0),
    AgeIncome(45, 3000.0),
    AgeIncome(50, 2500.0)
)

data.plotScatter(_.age, _.income)

Line

Line chart for sequence of numbers

val data = Seq(
    (1.0, 1.0),
    (2.0, 4.0),
    (3.0, 9.0)
)

data.plotLine()

Line chart for sequence of case class

case class AgeIncome(age: Int, income: Double)

val data = Seq(
    AgeIncome(20, 1000.0),
    AgeIncome(25, 2000.0),
    AgeIncome(30, 2500.0),
    AgeIncome(35, 3000.0),
    AgeIncome(40, 3500.0),
    AgeIncome(45, 3000.0),
    AgeIncome(50, 2500.0)
)

data.plotLine(_.age, _.income)

Line chart for timeseries data

timeseriesData2017.plotLine()

Histogram

Histogram for sequence of numbers

val rand = new Random()
val gaussians = for(i <- 1 to 10000) yield rand.nextGaussian()
gaussians.plotHistogram(100)

Histogram for categorical data

people
    .buildPlot()
    .histogramForCategories(_.education)
    .size(400, 300)
    .titles("People by education", "Education", "Count")
    .legendVisible(false)
    .display()

Bubble chart

  Seq(
    (1, 1, 9.0),
    (1, 2, 40.0),
    (3, 2, 60.0),
    (2, 2, 90.0),
    (1, 3, 30.0),
    (2, 3, 40.0)
  )
  .buildPlot()
  .bubble(_._1, _._2, _._3)
  .display()

Pie

Seq(
    ("DE", 81),
    ("TR", 72),
    ("FR", 63),
    ("UK", 62),
    ("IT", 61)
  )
  .plotPie()

Area

Seq(
    (1.0, 1.0),
    (2.0, 4.0),
    (3.0, 9.0)
  )
  .plotArea()

Multiple series

people
    .buildPlot()
    .scatter(_.age, _.income)
    .seriesBy(_.education)
    .size(500, 400)
    .titles("Age and income by education", "age", "income")
    .display()

Multiple charts

Grouping by cols

Scatter plot

people
    .buildPlot()
    .scatter(_.age, _.income)
    .colsBy(_.country)
    .display()

Histogram

people
    .buildPlot()
    .colsBy(_.education)
    .histogram(_.age, 50)
    .size(1200, 400)
    .display()

Grouping by rows

people
    .buildPlot()
    .scatter(_.age, _.income)
    .rowsBy(_.education)
    .display()

Grouping by cols and/or rows

Scatter plot

people
    .buildPlot()
    .scatter(_.age, _.income)
    .colsBy(_.country)
    .rowsBy(_.education)
    .display()

Bar plot

val groupedPeopleByCountryEducation = people
    .groupBy(p => (p.country, p.education))
    .mapValues(pv => pv.size)

groupedPeopleByCountryEducation
    .buildPlot()
    .colsBy(_._1._1)
    .bar(x => x._1._2, x => x._2)
    .size(1200, 300)
    .display()

Multiple columns and series

people
    .buildPlot()
    .scatter(_.age, _.income)
    .size(1200, 300)
    .colsBy(_.country)
    .seriesBy(_.education)
    .display()

Aggregation functions

SPlot enables aggregating your data before displaying chart.

To start using functions you need to import:

import com.datawizards.splot.functions._

Currently supported aggregation functions:

  • count
  • mean
  • sum

Calculating count

  people
    .buildPlot()
    .barWithAggregations(_.education, count())

Calculating mean

  people
    .buildPlot()
    .barWithAggregations(_.country, mean(_.income))

Calculating sum

  people
    .buildPlot()
    .barWithAggregations(_.country, sum(_.income))

Saving plot to file

To save plot to file you need to call method save() instead of calling display().

import com.datawizards.splot.model.ImageFormats

Seq(1.0, 4.0, 9.0)
    .buildPlot()
    .bar()
    .save("chart.png", ImageFormats.PNG)

Currently supported image formats:

  • BMP
  • PNG
  • JPG
  • GIF
  • EPS
  • PDF
  • SVG

Customizations

Change chart title

val data = Seq(1.0, 4.0, 9.0)

data
    .buildPlot()
    .bar()
    .titles("Example bar chart", "x values", "y values")
    .display()

Change chart size (width, height)

val data = Seq(1.0, 4.0, 9.0)

data
    .buildPlot()
    .bar()
    .size(1600, 1200)
    .display()

Change series name

Seq(1.0, 4.0, 9.0)
    .buildPlot()
    .bar()
    .seriesName("custom name")
    .display()

Hide legend

Seq(1.0, 4.0, 9.0)
    .buildPlot()
    .bar()
    .legendVisible(false)
    .display()

Chart themes

Currently supported themes:

To change theme you need to call method theme():

data
    .buildPlot()
    .bar()
    .theme(PlotTheme.GGPlot2)
    .display()

Annotations

Seq(1, 4, 9)
    .buildPlot()
    .bar()
    .showAnnotations(true)
    .display()

Bugs

Please report any bugs or submit feature requests to SPlot Github issue tracker.

Credits

Library Category License
XChart Graphing Apache 2.0

Contact

[email protected]

Versions

Version
0.2.0
0.1.0