Plotly
| Project Name | Stars | Downloads | Repos Using This | Packages Using This | Most Recent Commit | Total Releases | Latest Release | Open Issues | License | Language |
|---|---|---|---|---|---|---|---|---|---|---|
| Umami | 15,961 |  | 1 | 17 hours ago | 2 | July 24, 2020 | 111 | mit | JavaScript | |
| Umami is a simple, fast, privacy-focused alternative to Google Analytics. | ||||||||||
| Excelize | 15,221 | 186 | a day ago | 177 | August 20, 2022 | 102 | bsd-3-clause | Go | ||
| Go language library for reading and writing Microsoft Excel™ (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets | ||||||||||
| Analytics | 15,028 | 15 hours ago | 43 | agpl-3.0 | Elixir | |||||
| Simple, open-source, lightweight (< 1 KB) and privacy-friendly web analytics alternative to Google Analytics. | ||||||||||
| Tablesaw | 3,241 | 14 | 16 | a day ago | 78 | April 02, 2022 | 119 | apache-2.0 | Java | |
| Java dataframe and visualization library | ||||||||||
| Plotly | 727 | | 6 | 2 months ago | 9 | January 01, 2022 | 10 | other | Rust | |
| Plotly for Rust | ||||||||||
| Maloja | 624 | 16 days ago | 139 | May 07, 2022 | 18 | gpl-3.0 | Python | |||
| Self-hosted music scrobble database to create personal listening statistics and charts | ||||||||||
| Scale8 Tag Manager And Analytics | 254 | 10 months ago | 7 | agpl-3.0 | TypeScript | |||||
| Website analytics, JavaScript error tracking + analytics, tag manager, data ingest endpoint creation (tracking pixels). GDPR + CCPA compliant. | ||||||||||
| Gerritstats | 156 | 2 years ago | 22 | mit | JavaScript | |||||
| Tool for creating statistics from a Gerrit repository | ||||||||||
| Tennis Crystal Ball | 150 | a year ago | 53 | apache-2.0 | Java | |||||
| Ultimate Tennis Statistics and Tennis Crystal Ball - Tennis Big Data Analysis and Prediction | ||||||||||
| Appliedstats | 134 | 8 months ago | 26 | HTML | ||||||
| :bar_chart: Methods of Applied Statistics Course Textbook Repository | ||||||||||
Table of Contents
Introduction
A plotting library for Rust powered by Plotly.js.
Documentation and numerous interactive examples are available in the Plotly.rs Book, the examples/ directory and docs.rs.
For changes since the last version, please consult the changelog.
Basic Usage
Add this to your Cargo.toml:
[dependencies]
plotly = "0.8.3"
Exporting an Interactive Plot
Any figure can be saved as an HTML file using the Plot.write_html() method. These HTML files can be opened in any web browser to access the fully interactive figure.
use plotly::{Plot, Scatter};
let mut plot = Plot::new();
let trace = Scatter::new(vec![0, 1, 2], vec![2, 1, 0]);
plot.add_trace(trace);
plot.write_html("out.html");
By default, the Plotly JavaScript library will be included via CDN, which results in a smaller filesize, but slightly slower first load as the JavaScript library has to be downloaded first. To instead embed the JavaScript library (several megabytes in size) directly into the HTML file, the following can be done:
// <-- Create a `Plot` -->
plot.use_local_plotly();
plot.write_html("out.html");
If you only want to view the plot in the browser quickly, use the Plot.show() method.
// <-- Create a `Plot` -->
plot.show(); // The default web browser will open, displaying an interactive plot
Exporting a Static Image
To save a plot as a static image, the kaleido feature is required:
# Cargo.toml
[dependencies]
plotly = { version = "0.8.3", features = ["kaleido"] }
With this feature enabled, plots can be saved as any of png, jpeg, webp, svg, pdf and eps. Note that the plot will be a static image, i.e. they will be non-interactive.
The Kaleido binary is downloaded for your system's architecture at compile time from the official Kaleido release page. This library currently supports x86_64 on Linux and Windows, and both x86_64 and aarch64 on macOS.
Exporting a simple plot looks like this:
use plotly::{ImageFormat, Plot};
let mut plot = Plot::new();
let trace = Scatter::new(vec![0, 1, 2], vec![2, 1, 0]);
plot.add_trace(trace);
plot.write_image("out.png", ImageFormat::PNG, 800, 600, 1.0);
Usage Within a Wasm Environment
Using Plotly.rs in a Wasm-based frontend framework is possible by enabling the wasm feature:
# Cargo.toml
[dependencies]
plotly = { version = "0.8.3", features = ["wasm"] }
First, make sure that you have the Plotly JavaScript library in your base HTML template:
<!-- index.html -->
<!doctype html>
<html lang="en">
<head>
<!-- snip -->
<script src="https://cdn.plot.ly/plotly-2.14.0.min.js"></script>
</head>
<!-- snip -->
</html>
A simple Plot component would look as follows, using Yew as an example frontend framework:
use plotly::{Plot, Scatter};
use yew::prelude::*;
#[function_component(PlotComponent)]
pub fn plot_component() -> Html {
let p = yew_hooks::use_async::<_, _, ()>({
let id = "plot-div";
let mut plot = Plot::new();
let trace = Scatter::new(vec![0, 1, 2], vec![2, 1, 0]);
plot.add_trace(trace);
async move {
plotly::bindings::new_plot(id, &plot).await;
Ok(())
}
});
use_effect_with_deps(move |_| {
p.run();
|| ()
}, (),
);
html! {
<div id="plot-div"></div>
}
}
More detailed standalone examples can be found in the examples/ directory.
Crate Feature Flags
The following feature flags are available:
kaleido
Adds plot save functionality to the following formats: png, jpeg, webp, svg, pdf and eps.
plotly_image
Adds trait implementations so that image::RgbImage and image::RgbaImage can be used more directly with the plotly::Image trace.
plotly_ndarray
Adds support for creating plots directly using ndarray types.
wasm
Enables compilation for the wasm32-unknown-unknown target and provides access to a bindings module containing wrappers around functions exported by the plotly.js library.
Contributing
-
If you've spotted a bug or would like to see a new feature, please submit an issue on the issue tracker.
-
Pull requests are welcome, see the contributing guide for more information.
License
Plotly.rs is distributed under the terms of the MIT license.
See LICENSE-MIT, and COPYRIGHT for details.
