This is a functioning plotting library. It supports, line (with fill below), scatter (with errors), bar , histogram, heatmap, candlestick and combinations of those plot types. More standard types can be added on request.
Internally, it serializes typed
nim datastructures to JSON that matches what plotly expects.
See a collection of real-world examples in the wiki
import plotly import chroma var colors = @[Color(r:0.9, g:0.4, b:0.0, a: 1.0), Color(r:0.9, g:0.4, b:0.2, a: 1.0), Color(r:0.2, g:0.9, b:0.2, a: 1.0), Color(r:0.1, g:0.7, b:0.1, a: 1.0), Color(r:0.0, g:0.5, b:0.1, a: 1.0)] var d = Trace[int](mode: PlotMode.LinesMarkers, `type`: PlotType.Scatter) var size = @[16.int] d.marker =Marker[int](size:size, color: colors) d.xs = @[1, 2, 3, 4, 5] d.ys = @[1, 2, 1, 9, 5] d.text = @["hello", "data-point", "third", "highest", "<b>bold</b>"] var layout = Layout(title: "testing", width: 1200, height: 400, xaxis: Axis(title:"my x-axis"), yaxis:Axis(title: "y-axis too"), autosize:false) var p = Plot[int](layout:layout, traces: @[d]) p.show()
show call opens a browser pointing to a plot like above, but the actual plot will
The library supports both the
C as well as
Nim. In case of the
C target, the data and layout is statically
parsed and inserted into a template Html file, which is stored in
/tmp/x.html. A call to the default browser is made, which loads said
file. The file is deleted thereafter.
This static nature has the implication that it is not possible to
update the data in the plots. However, thanks to Nim's ability to
compiling to the
JS target the native plotly functions are
restyle, which allow to change the
data and / or layout of a plot defined in a
div container. See the
fig8_js_interactive.nim for such an example.
Starting from version
v0.3.0 of plotly, WSL is supported. This
requires the user to define the
BROWSER environment variable and
assumes the user wishes to use a normal Windows browser.
When setting the
BROWSER variable, make sure to handle the possible
spaces (e.g. if browser installed in
Program Files) by either
escaping spaces and parenthesis with a backslash or just putting the
whole path into quotation marks. E.g:
export BROWSER="/mnt/c/Program Files (x86)/MyBrowserCompany/Browser.exe"
to set the variable for the local session.
%procs into macros so I don't have to re-write the same code over and over.