https://github.com/rtbo/plotive
https://github.com/rtbo/plotive
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/rtbo/plotive
- Owner: rtbo
- License: mit
- Created: 2025-08-04T06:09:51.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-01-07T17:01:12.000Z (5 months ago)
- Last Synced: 2026-01-08T07:27:25.314Z (5 months ago)
- Language: Rust
- Size: 10.4 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# plotive
_declarative plotting_. A simple data plotting library written in Rust.
[](https://opensource.org/licenses/MIT)
[](https://github.com/rtbo/plotive/actions/workflows/test.yml)
## Overview and features
Plotive decouples figure design from data and from rendering surfaces.
### Supported series types
- XY line plots
- Scatter plots
- Histograms and bar plots
More will come. Don't hesitate to open an issue to request a feature!
### Modular architecture
- **Declarative design** (`plotive::des`)
- Design of figure is entirely declarative and decoupled from data and drawing primitives
- Sensible defaults. Most types that populates design implement carefully crafted `Default` trait.
- Figure units are decorrelated from pixel size for easy scaling
- `.plotive` DSL language for concise figure description.
This DSL is still fairly incomplete, but all examples in the repo are working.
- **Data sources** (`plotive::data`)
- Flexible, column-friendly data source system
- Support for CSV and [polars](https://pola.rs) is included
- **Rendering surfaces** (`plotive::render` and separate crates)
- `plotive-pxl`: Rasterized rendering (PNG, or pixels array)
- `plotive-svg`: SVG rendering
- `plotive-iced`: GUI rendering with [iced](https://iced.rs).
### Automatic Layout
- All the layout is done consistently and automatically.
You can add multiple axes, multiple plots etc.
Everything will be laid-out consistently, leaving enough space for axis ticks labels, legends etc. Your code never need to calculate size of anything.
### Advanced typography
- Automatic font look-up and text shaping
- Rich text
- Automatic right to left layout using unicode-bidirectional algorithm
- vertical layout
### Themes
- Change the theme of your figure with a single line of code (see the bode diagram hereunder)
### Annotations
- Annotate your figures, with labels, infinite lines, markers etc.
- Annotations are placed using data space coordinates
### GUI integration and real-time rendering
- The crate `plotive-iced` provides a `Figure` widget.
Thanks to separation of data from design, redraws of the same figure with different data
is very efficient and compatible with real-time rendering, up to hundreds of redraws per second.
## Gallery
(a few more in the gallery folder)
## Get started
Add `plotive` to your project, as well as one or more of the surface backend crates.
(here `plotive-iced`, a GUI crate for [iced.rs](https://iced.rs))
```
cargo add plotive
cargo add plotive-iced
```
To create a figure, you start by declaring its design with the `des` module, referencing data that will come later.
The design structure is purely declarative, own all its data and very lightweight:
```rust
use plotive::des;
let x_axis = des::Axis::new()
.with_title("x".into())
.with_ticks(
des::axis::Ticks::new()
.with_locator(des::axis::ticks::PiMultipleLocator::default().into()),
)
.with_grid(Default::default());
let y_axis = des::Axis::new()
.with_title("y".into())
.with_ticks(Default::default())
.with_grid(Default::default())
.with_minor_ticks(Default::default())
.with_minor_grid(Default::default());
let series = des::series::Line::new(des::data_src_ref("x"), des::data_src_ref("y"))
.with_name("y=sin(x)")
.into();
let plot = des::Plot::new(vec![series])
.with_x_axis(x_axis)
.with_y_axis(y_axis)
.with_legend(des::plot::LegendPos::InTopRight.into());
let fig = des::Figure::new(plot.into()).with_title("a sine wave".into());
```
Then (or before) you can prepare the data to be plotted with any structure implementing the column-friendly trait `plotive::data::Source`.
```rust
use plotive::data;
let x: Vec = (0..=360).map(|t| t as f64 * PI / 180.0).collect();
let y = x.iter().map(|x| x.sin()).collect();
let data_source = data::TableSource::new()
.with_f64_column("x", x)
.with_f64_column("y", y);
```
Everything is ready. You can use any of the crate providing implementation for `plotive::render::Surface` to either save to an image file, or show it in a GUI:
```rust
use plotive_iced::Show;
fig.show(Arc::new(data_source), Default::default()).unwrap();
```
During execution, the following window shows:
## Crate features
- `data-csv`: enables CSV data source support ([`plotive::data::csv`](https://docs.rs/plotive/latest/plotive/data/csv/index.html))
- `data-polars`: enables [Polars](https://pola.rs) data source support ([`plotive::data::polars`](https://docs.rs/plotive/latest/plotive/data/polars/index.html)).
Pulls in the `polars` dependency, which is quite a beast to compile.
- `dsl`: enables the support for `.plotive` DSL.
- `noto-mono`, `noto-sans`, `noto-sans-italic`, `noto-serif`, `noto-serif-italic`: bundles the corresponding fonts from Google in the final executable, and enables `plotive::bundled_font_db()`.
`noto-sans` is enabled by default
- `time`: enables support for time series, CSV date-time parsing etc. ([`plotive::time`](https://docs.rs/plotive/latest/plotive/time/index.html))
- `utils`: enables various utilities such as `linspace`, `logspace` etc. ([`plotive::utils`](https://docs.rs/plotive/latest/plotive/utils/index.html))