#

PlotKit

Plots made easy.

##

Features

- 2D line and scatter plots
- Multiple axes
- Custom tick marks

##

Usage

To start using **PlotKit** quickly use the `plotPoints`

helper function. It takes a list of points and returns a view that you can use in your app:

<div class="highlight highlight-source-swift position-relative" data-snippet-clipboard-copy-content="import PlotKit

// Generate some data to plot

let count = 1024

let t = (0..<count).map({ 2*M_PI * Double($0) / Double(count-1) })

let y = t.map({ sin($0) })

// Create a PlotView

let plotView1 = plotPoints((0..

import PlotKit
// Generate some data to plot
let count = 1024
let t = (0..<count).map({ 2*M_PI * Double($0) / Double(count-1) })
let y = t.map({ sin($0) })
// Create a PlotView
let plotView1 = plotPoints((0..<count).map{ Point(x: t[$0], y: y[$0]) }, hTicks: .fit(6), vTicks: .fit(4))

###

Multiple point sets

You can have multiple curves or scatter plots in the same `PlotView`

.

let plotView = PlotView()
let pointSet1 = PointSet(values: values1)
pointSet1.pointType = .disk(radius: 2)
pointSet2.pointColor = .red
pointSet1.lineColor = nil
plotView.addPointSet(pointSet1)
let pointSet2 = PointSet(values: values2)
pointSet2.pointType = .none
pointSet2.lineColor = .blue
plotView.addPointSet(pointSet2)

###

Axes

You can customize your plot axes. You can have as many axis lines as you want on the same plot.

let plotView = PlotView()
var xaxis = Axis(orientation: .horizontal, ticks: .fit(5))
xaxis.position = .value(0)
xaxis.color = .blue
xaxis.labelAttributes = [NSForegroundColorAttributeName: NSColor.blue]
plotView.addAxis(xaxis)
var yaxis = Axis(orientation: .vertical, ticks: .distance(1))
yaxis.lineWidth = 2
plotView.addAxis(yaxis)

You can specify ticks in one of three ways:

`fit(n)`

: Say how many tick marks you want. **PlotKit** will space them evenly.
`distance(d)`

: Say how far appart to place tick marks.
`list(l)`

: Specify exactly the tick marks you want. This is the most flexible. You get to decide where to put the tick marks and also what their labels, line length and line thickness are.

##

Using PlotKit with Storyboards

If you want to use a PlotView in a Storyboard add an `NSView`

and then change the class name and module like so

##

License

PlotKit is available under the MIT license. See the LICENSE file for more info.

## GitHub

https://github.com/alejandro-isaza/PlotKit