# plt
[](https://github.com/plt-rs/plt/actions/workflows/ci.yml)
[](https://crates.io/crates/plt)
[](https://docs.rs/plt)
[](https://deps.rs/crate/plt/0.3.1)
A plotting library with a focus on publication level aesthetics and ergonomic control.
## Structure
- Plots are drawn on a `Subplot`.
- One or more subplots are organized in a `Layout`.
- The layout is added to a `Figure`, which is used to draw to a file or directly to a `Backend`.
## Use
To get started, see the [examples](https://github.com/plt-rs/plt/tree/main/plt/examples) directory in the main repository.
### Example
```rust
use plt::*;
// create data
// create subplot
let mut sp = Subplot::builder()
.label(Axes::X, "x data")
.label(Axes::Y, "y data")
.build();
// plot data
sp.plot(&xs, &ys).unwrap();
// make figure and add subplot
let mut fig = <Figure>::default();
fig.set_layout(SingleLayout::new(sp)).unwrap();
// save figure to file
fig.draw_file(FileFormat::Png, "example.png").unwrap();
```

## Dependencies
Currently, the only implemented backend depends on [Cairo](https://www.cairographics.org).
### Debian / Ubuntu
`apt install libcairo2-dev`
### Arch
`pacman -Syu cairo`