Plotly for Rust

A plotting library for Rust powered by Plotly JS.

Usage

Add this to your Cargo.toml:

toml [dependencies] plotly = "0.3.0"

Plotly in action

Line and Scatter plot

```rust extern crate plotly; use plotly::charts::{Mode, Scatter}; use plotly::Plot;

fn lineandscatter_plot() { let trace1 = Scatter::new(vec![1, 2, 3, 4], vec![10, 15, 13, 17]) .name("trace1") .mode(Mode::Markers); let trace2 = Scatter::new(vec![2, 3, 4, 5], vec![16, 5, 11, 9]) .name("trace2") .mode(Mode::Lines); let trace3 = Scatter::new(vec![1, 2, 3, 4], vec![12, 9, 15, 12]).name("trace3");

let mut plot = Plot::new();
plot.add_trace(trace1);
plot.add_trace(trace2);
plot.add_trace(trace3);
plot.show();

}

fn main() -> std::io::Result<()> { lineandscatterplot(); Ok(()) } ```

```rust extern crate plotly; use plotly::charts::{Line, LineShape, Legend, Font}; use plotly::charts::Layout; use plotly::charts::{Mode, Scatter}; use plotly::Plot;

fn lineshapeoptionsforinterpolation() { let trace1 = Scatter::new(vec![1, 2, 3, 4, 5], vec![1, 3, 2, 3, 1]) .mode(Mode::LinesMarkers) .name("linear") .line(Line::new().shape(LineShape::Linear)); let trace2 = Scatter::new(vec![1, 2, 3, 4, 5], vec![6, 8, 7, 8, 6]) .mode(Mode::LinesMarkers) .name("spline") .line(Line::new().shape(LineShape::Spline)); let trace3 = Scatter::new(vec![1, 2, 3, 4, 5], vec![11, 13, 12, 13, 11]) .mode(Mode::LinesMarkers) .name("vhv") .line(Line::new().shape(LineShape::Vhv)); let trace4 = Scatter::new(vec![1, 2, 3, 4, 5], vec![16, 18, 17, 18, 16]) .mode(Mode::LinesMarkers) .name("hvh") .line(Line::new().shape(LineShape::Hvh)); let trace5 = Scatter::new(vec![1, 2, 3, 4, 5], vec![21, 23, 22, 23, 21]) .mode(Mode::LinesMarkers) .name("vh") .line(Line::new().shape(LineShape::Vh)); let trace6 = Scatter::new(vec![1, 2, 3, 4, 5], vec![26, 28, 27, 28, 26]) .mode(Mode::LinesMarkers) .name("hv") .line(Line::new().shape(LineShape::Hv));

let mut plot = Plot::new(); let layout = Layout::new() .legend(Legend::new().y(0.5).trace_order("reversed") .font(Font::new().size(16))); plot.add_layout(layout); plot.add_trace(trace1); plot.add_trace(trace2); plot.add_trace(trace3); plot.add_trace(trace4); plot.add_trace(trace5); plot.add_trace(trace6); plot.show();

}

fn main() -> std::io::Result<()> { lineshapeoptionsforinterpolation(); Ok(()) } ```

```rust extern crate plotly; use plotly::charts::{Line, LineShape, Legend, Font, DashType}; use plotly::charts::Layout; use plotly::charts::{Mode, Scatter}; use plotly::Plot;

fn line_dash() { let trace1 = Scatter::new(vec![1, 2, 3, 4, 5], vec![1, 3, 2, 3, 1]) .mode(Mode::LinesMarkers) .name("solid") .line(Line::new().dash(DashType::Solid)); let trace2 = Scatter::new(vec![1, 2, 3, 4, 5], vec![6, 8, 7, 8, 6]) .mode(Mode::LinesMarkers) .name("dashdot") .line(Line::new().dash(DashType::DashDot)); let trace3 = Scatter::new(vec![1, 2, 3, 4, 5], vec![11, 13, 12, 13, 11]) .mode(Mode::LinesMarkers) .name("dash") .line(Line::new().dash(DashType::Dash)); let trace4 = Scatter::new(vec![1, 2, 3, 4, 5], vec![16, 18, 17, 18, 16]) .mode(Mode::LinesMarkers) .name("dot") .line(Line::new().dash(DashType::Dot)); let trace5 = Scatter::new(vec![1, 2, 3, 4, 5], vec![21, 23, 22, 23, 21]) .mode(Mode::LinesMarkers) .name("longdash") .line(Line::new().dash(DashType::LongDash)); let trace6 = Scatter::new(vec![1, 2, 3, 4, 5], vec![26, 28, 27, 28, 26]) .mode(Mode::LinesMarkers) .name("longdashdot") .line(Line::new().dash(DashType::LongDashDot));

let mut plot = Plot::new(); let layout = Layout::new() .legend(Legend::new().y(0.5).trace_order("reversed") .font(Font::new().size(16))) .xaxis(Axis::new().range(vec![0.95, 5.05]).auto_range(false)) .yaxis(Axis::new().range(vec![0.0, 28.5]).auto_range(false)); plot.add_layout(layout); plot.add_trace(trace1); plot.add_trace(trace2); plot.add_trace(trace3); plot.add_trace(trace4); plot.add_trace(trace5); plot.add_trace(trace6); plot.show();

}

fn main() -> std::io::Result<()> { linedash(); Ok(()) } ```

```rust extern crate plotly; use plotly::charts::{Layout, RgbColor, Line, Color, Dim, Marker, Mode, Scatter, Title}; use plotly::Plot;

fn coloredandstyledscatterplot() { let trace1 = Scatter::new(vec![52698, 43117], vec![53, 31]) .mode(Mode::Markers) .name("North America") .text(vec!["United States".toowned(), "Canada".toowned()]) .marker(Marker::new() .color(Dim::Scalar(Color::Rgb(RgbColor::new(164, 194, 244)))) .size(Dim::Scalar(12)) .line(Line::new().color(Color::White).width(0.5))); let trace2 = Scatter::new(vec![39317, 37236, 35650, 30066, 29570, 27159, 23557, 21046, 18007], vec![33, 20, 13, 19, 27, 19, 49, 44, 38]) .mode(Mode::Markers) .name("Europe") .text(vec!["Germany".toowned(), "Britain".toowned(), "France".toowned(), "Spain".toowned(), "Italy".toowned(), "Czech Rep.".toowned(), "Greece".toowned(), "Poland".toowned()]) .marker(Marker::new() .color(Dim::Scalar(Color::Rgb(RgbColor::new(255, 217, 102)))) .size(Dim::Scalar(12))); let trace3 = Scatter::new(vec![42952, 37037, 33106, 17478, 9813, 5253, 4692, 3899], vec![23, 42, 54, 89, 14, 99, 93, 70]) .mode(Mode::Markers) .name("Asia/Pacific") .text(vec!["Australia".toowned(), "Japan".toowned(), "South Korea".toowned(), "Malaysia".toowned(), "China".toowned(), "Indonesia".toowned(), "Philippines".toowned(), "India".toowned()]) .marker(Marker::new() .color(Dim::Scalar(Color::Rgb(RgbColor::new(234, 153, 153)))) .size(Dim::Scalar(12))); let trace4 = Scatter::new(vec![19097, 18601, 15595, 13546, 12026, 7434, 5419], vec![43, 47, 56, 80, 86, 93, 80]) .mode(Mode::Markers) .name("Latin America") .text(vec!["Chile".toowned(), "Argentina".toowned(), "Mexico".toowned(), "Venezuela".toowned(), "Venezuela".toowned(), "El Salvador".toowned(), "Bolivia".to_owned()]) .marker(Marker::new() .color(Dim::Scalar(Color::Rgb(RgbColor::new(142, 124, 195)))) .size(Dim::Scalar(12)));

let layout = Layout::new() .title(Title::new("Quarter 1 Growth")) .xaxis(Axis::new().title(Title::new("GDP per Capita")).show_grid(false).zero_line(false)) .yaxis(Axis::new().title(Title::new("Percent")).show_line(false)); let mut plot = Plot::new(); plot.add_trace(trace1); plot.add_trace(trace2); plot.add_trace(trace3); plot.add_trace(trace4); plot.add_layout(layout); plot.show();

}

fn main() -> std::io::Result<()> { coloredandstyledscatterplot(); Ok(()) } ```

For more examples see scatterandlineplotexamples.rs.

Bar plot

```rust extern crate plotly; use plotly::charts::Layout; use plotly::charts::{Bar, BarMode, ErrorData, ErrorType}; use plotly::Plot;

fn barchartwitherrorbars() { let trace1 = Bar::new( vec![ "Trial 1".toowned(), "Trial 2".toowned(), "Trial 3".toowned(), ], vec![3, 6, 4], ) .name("Control") .errory(ErrorData::new(ErrorType::Data).array(vec![1.0, 0.5, 1.5]));

let trace2 = Bar::new( vec![ "Trial 1".to_owned(), "Trial 2".to_owned(), "Trial 3".to_owned(), ], vec![4, 7, 3], ) .name("LA Zoo") .error_y(ErrorData::new(ErrorType::Data).array(vec![0.5, 1.0, 2.0])); let layout = Layout::new(); let mut plot = Plot::new(); plot.add_trace(trace1); plot.add_trace(trace2); plot.add_layout(layout); plot.show();

}

fn main() -> std::io::Result<()> { barchartwitherrorbars(); Ok(()) } ```

For more examples see barplotexamples.rs.

Histogram plot

```rust extern crate plotly; use plotly::charts::Layout; use plotly::charts::{BarMode, Color, Dim, Histogram, Marker}; use plotly::Plot;

fn overlaidhistogram() { let samples1 = samplenormal_distribution(500, 0.0, 1.0); let trace1 = Histogram::new(samples1) .name("trace 1") .opacity(0.5) .marker(Marker::new().color(Dim::Scalar(Color::Green)));

let samples2 = sample_normal_distribution(500, 0.0, 1.0); let trace2 = Histogram::new(samples2) .name("trace 2") .opacity(0.6) .marker(Marker::new().color(Dim::Scalar(Color::Red))); let mut plot = Plot::new(); plot.add_trace(trace1); plot.add_trace(trace2); let layout = Layout::new().bar_mode(BarMode::Overlay); plot.add_layout(layout); plot.show();

}

fn main() -> std::io::Result<()> { overlaidhistogram(); Ok(()) } ```

For more examples see histogramplotexamples.rs.

Candlestick plot

```rust extern crate plotly; use plotly::charts::Candlestick; use plotly::Plot;

fn simplecandlestickchart() { let x = vec![ "2017-01-04","2017-01-05","2017-01-06","2017-01-09","2017-01-10","2017-01-11","2017-01-12", "2017-01-13","2017-01-17","2017-01-18","2017-01-19","2017-01-20","2017-01-23","2017-01-24", "2017-01-25","2017-01-26","2017-01-27","2017-01-30","2017-01-31","2017-02-01","2017-02-02", "2017-02-03","2017-02-06","2017-02-07","2017-02-08","2017-02-09","2017-02-10","2017-02-13", "2017-02-14","2017-02-15",]; let open = vec![ 115.849998, 115.919998, 116.779999, 117.949997, 118.769997, 118.739998, 118.900002, 119.110001, 118.339996, 120.0, 119.400002, 120.449997, 120.0, 119.550003, 120.419998, 121.669998, 122.139999, 120.93, 121.150002, 127.029999, 127.980003, 128.309998, 129.130005, 130.539993, 131.350006, 131.649994, 132.460007, 133.080002, 133.470001, 135.520004, ]; let high = vec![ 116.510002, 116.860001, 118.160004, 119.43, 119.379997, 119.93, 119.300003, 119.620003, 120.239998, 120.5, 120.089996, 120.449997, 120.809998, 120.099998, 122.099998, 122.440002, 122.349998, 121.629997, 121.389999, 130.490005, 129.389999, 129.190002, 130.5, 132.089996, 132.220001, 132.449997, 132.940002, 133.820007, 135.089996, 136.270004, ]; let low = vec![ 115.75, 115.809998, 116.470001, 117.940002, 118.300003, 118.599998, 118.209999, 118.809998, 118.220001, 119.709999, 119.370003, 119.730003, 119.769997, 119.5, 120.279999, 121.599998, 121.599998, 120.660004, 120.620003, 127.010002, 127.779999, 128.160004, 128.899994, 130.449997, 131.220001, 131.119995, 132.050003, 132.75, 133.25, 134.619995, ]; let close = vec![ 116.019997, 116.610001, 117.910004, 118.989998, 119.110001, 119.75, 119.25, 119.040001, 120.0, 119.989998, 119.779999, 120.0, 120.080002, 119.970001, 121.879997, 121.940002, 121.949997, 121.629997, 121.349998, 128.75, 128.529999, 129.080002, 130.289993, 131.529999, 132.039993, 132.419998, 132.119995, 133.289993, 135.020004, 135.509995, ];

let trace1 = Candlestick::new(x, open, high, low, close); let mut plot = Plot::new(); plot.add_trace(trace1); plot.show();

}

fn main() -> std::io::Result<()> { simplecandlestickchart(); Ok(()) } ```

For more examples see candlestickplotexamples.rs.

OHLC plot

```rust extern crate plotly; use plotly::charts::Ohlc; use plotly::Plot;

fn simpleohlcchart() { let x = vec![ "2017-01-04","2017-01-05","2017-01-06","2017-01-09","2017-01-10","2017-01-11","2017-01-12", "2017-01-13","2017-01-17","2017-01-18","2017-01-19","2017-01-20","2017-01-23","2017-01-24", "2017-01-25","2017-01-26","2017-01-27","2017-01-30","2017-01-31","2017-02-01","2017-02-02", "2017-02-03","2017-02-06","2017-02-07","2017-02-08","2017-02-09","2017-02-10","2017-02-13", "2017-02-14","2017-02-15",]; let open = vec![ 115.849998, 115.919998, 116.779999, 117.949997, 118.769997, 118.739998, 118.900002, 119.110001, 118.339996, 120.0, 119.400002, 120.449997, 120.0, 119.550003, 120.419998, 121.669998, 122.139999, 120.93, 121.150002, 127.029999, 127.980003, 128.309998, 129.130005, 130.539993, 131.350006, 131.649994, 132.460007, 133.080002, 133.470001, 135.520004, ]; let high = vec![ 116.510002, 116.860001, 118.160004, 119.43, 119.379997, 119.93, 119.300003, 119.620003, 120.239998, 120.5, 120.089996, 120.449997, 120.809998, 120.099998, 122.099998, 122.440002, 122.349998, 121.629997, 121.389999, 130.490005, 129.389999, 129.190002, 130.5, 132.089996, 132.220001, 132.449997, 132.940002, 133.820007, 135.089996, 136.270004, ]; let low = vec![ 115.75, 115.809998, 116.470001, 117.940002, 118.300003, 118.599998, 118.209999, 118.809998, 118.220001, 119.709999, 119.370003, 119.730003, 119.769997, 119.5, 120.279999, 121.599998, 121.599998, 120.660004, 120.620003, 127.010002, 127.779999, 128.160004, 128.899994, 130.449997, 131.220001, 131.119995, 132.050003, 132.75, 133.25, 134.619995, ]; let close = vec![ 116.019997, 116.610001, 117.910004, 118.989998, 119.110001, 119.75, 119.25, 119.040001, 120.0, 119.989998, 119.779999, 120.0, 120.080002, 119.970001, 121.879997, 121.940002, 121.949997, 121.629997, 121.349998, 128.75, 128.529999, 129.080002, 130.289993, 131.529999, 132.039993, 132.419998, 132.119995, 133.289993, 135.020004, 135.509995, ];

let trace1 = Ohlc::new(x, open, high, low, close); let mut plot = Plot::new(); plot.add_trace(trace1); plot.show();

}

fn main() -> std::io::Result<()> { simpleohlcchart(); Ok(()) } ```

For more examples see ohlcplotexamples.rs.

Surface plot

```rust use plotly::charts::{Surface, Lighting, PlaneContours, PlaneProject, SurfaceContours}; use plotly::charts::Layout; use plotly::Plot;

fn spectralsurfaceplot() { let mut x: Vec = Vec::new(); let mut y: Vec = Vec::new(); let mut z: Vec> = Vec::new(); let N = 100;

for i in 0..N { x.push(i as f64 / N as f64); y.push(i as f64 / N as f64); } for xi in 0..N { let mut iz: Vec<f64> = Vec::new(); for yi in 0..N { let xf = (xi as f64) / N as f64; let yf = (yi as f64) / N as f64; let cz = (2.0 * xf * std::f64::consts::PI).sin() * (4.0 * yf * std::f64::consts::PI).cos(); iz.push(cz); } z.push(iz); } let trace = Surface::new(z).x(x).y(y).visible(true) .hide_surface(false).lighting(Lighting::new()) .contours(SurfaceContours::new().z(PlaneContours::new() .show(true).use_colormap(true).project(PlaneProject::new().z(true)))); let mut plot = Plot::new(); plot.add_layout(Layout::new()); plot.add_trace(trace); plot.show();

}

fn main() -> std::io::Result<()> { spectralsurfaceplot();

Ok(())

} ```

For more examples see surfaceplotexamples.rs.

Save plots

At present it is only possible to save plots in PNG, JPG and HTML format with the help of the browser. For example the following code:

```rust extern crate plotly; use plotly::charts::{Mode, Scatter}; use plotly::Plot;

fn lineandscatter_plot() { let trace1 = Scatter::new(vec![1, 2, 3, 4], vec![10, 15, 13, 17]) .name("trace1") .mode(Mode::Markers); let trace2 = Scatter::new(vec![2, 3, 4, 5], vec![16, 5, 11, 9]) .name("trace2") .mode(Mode::Lines); let trace3 = Scatter::new(vec![1, 2, 3, 4], vec![12, 9, 15, 12]).name("trace3");

let mut plot = Plot::new(); plot.add_trace(trace1); plot.add_trace(trace2); plot.add_trace(trace3); // The following will generate the plot in PNG format (width: 1024, height: 680) and display it in the browser. plot.show_png(1024, 680); // Similarly to the above line but with a JPG format output. plot.show_jpg(1024, 680); // Save the resulting plot in `filename.html` plot.to_html("filename.html"); plot.show();

}

fn main() -> std::io::Result<()> { lineandscatter_plot(); Ok(()) } ``will open 3 tabs in the browser with the first two containing the *PNG* and *JPG* outputs respectively. Then these must be saved manually by right clicking and selectingSave As...` in the context menu of the browser. This is somewhat cumbersome, however, I haven't found a more elegant solution. Suggestions are most welcome!

At present the method to_html is the only available way to persist the plots programmatically.

License

Plotly for Rust is distributed under the terms of both the MIT license.

See LICENSE-MIT, and COPYRIGHT for details.