Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/igiagkiozis/plotly
Plotly for Rust
https://github.com/igiagkiozis/plotly
barchart candlestick-chart chart data-visualization data-vizualisation financial financial-analysis plot plotly plotlyjs rust scatter scatterplot statistics
Last synced: 3 months ago
JSON representation
Plotly for Rust
- Host: GitHub
- URL: https://github.com/igiagkiozis/plotly
- Owner: plotly
- License: other
- Created: 2020-01-26T10:57:20.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2024-05-17T03:52:29.000Z (6 months ago)
- Last Synced: 2024-05-22T03:14:02.242Z (6 months ago)
- Topics: barchart, candlestick-chart, chart, data-visualization, data-vizualisation, financial, financial-analysis, plot, plotly, plotlyjs, rust, scatter, scatterplot, statistics
- Language: Rust
- Homepage: https://docs.rs/plotly
- Size: 45.3 MB
- Stars: 978
- Watchers: 31
- Forks: 94
- Open Issues: 37
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE-MIT
Awesome Lists containing this project
- awesome-yew - Plotly.rs - Rust bindings for the popular [Plotly](https://plotly.com/javascript/) charting library. (Crates / Javascript Library Ports)
README
# Table of Contents
* [Introduction](#introduction)
* [Basic Usage](#basic-usage)
* [Exporting an Interactive Plot](#exporting-an-interactive-plot)
* [Exporting a Static Image](#exporting-a-static-image)
* [Usage Within a Wasm Environment](#usage-within-a-wasm-environment)
* [Crate Feature Flags](#crate-feature-flags)
* [Contributing](#contributing)
* [License](#license)
# Introduction
A plotting library for Rust powered by [Plotly.js](https://plot.ly/javascript/).
Documentation and numerous interactive examples are available in the [Plotly.rs Book](https://plotly.github.io/plotly.rs/content/getting_started.html), the [examples/](https://github.com/plotly/plotly.rs/tree/main/examples) directory and [docs.rs](https://docs.rs/crate/plotly).
For changes since the last version, please consult the [changelog](https://github.com/plotly/plotly.rs/tree/main/CHANGELOG.md).
# Basic Usage
Add this to your `Cargo.toml`:
```toml
[dependencies]
plotly = "0.9.0"
```
## 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.
```rust
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:
```rust
// <-- 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.
```rust
// <-- 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:
```toml
# Cargo.toml
[dependencies]
plotly = { version = "0.9.0", 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](https://github.com/plotly/Kaleido/releases). 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:
```rust
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:
```toml
# Cargo.toml
[dependencies]
plotly = { version = "0.9.0", features = ["wasm"] }
```
First, make sure that you have the Plotly JavaScript library in your base HTML template:
```html
```
A simple `Plot` component would look as follows, using `Yew` as an example frontend framework:
```rust
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! {
}
}
```
More detailed standalone examples can be found in the [examples/](https://github.com/plotly/plotly.rs/tree/main/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](https://github.com/rust-ndarray/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](https://github.com/plotly/plotly.rs/issues).
* Pull requests are welcome, see the [contributing guide](https://github.com/plotly/plotly.rs/tree/main/CONTRIBUTING.md) for more information.
# License
`Plotly.rs` is distributed under the terms of the MIT license.
See [LICENSE-MIT](https://github.com/plotly/plotly.rs/tree/main/LICENSE-MIT), and [COPYRIGHT](https://github.com/plotly/plotly.rs/tree/main/COPYRIGHT) for details.
