kuva 0.1.6

Scientific plotting library in Rust with various backends.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

//! Pie chart documentation examples.
//!
//! Generates canonical SVG outputs used in the kuva documentation.
//! Run with:
//!
//! ```bash
//! cargo run --example pie
//! ```
//!
//! SVGs are written to `docs/src/assets/pie/`.

use kuva::plot::{PiePlot, PieLabelPosition};
use kuva::backend::svg::SvgBackend;
use kuva::render::render::{render_pie, render_multiple};
use kuva::render::layout::Layout;
use kuva::render::plots::Plot;

const OUT: &str = "docs/src/assets/pie";

fn main() {
    std::fs::create_dir_all(OUT).expect("could not create docs/src/assets/pie");

    basic();
    donut();
    percent();
    outside_labels();
    legend();

    println!("Pie SVGs written to {OUT}/");
}

/// Simple pie chart — four slices, default Auto label positioning.
fn basic() {
    let pie = PiePlot::new()
        .with_slice("Rust",   40.0, "steelblue")
        .with_slice("Python", 30.0, "tomato")
        .with_slice("R",      20.0, "seagreen")
        .with_slice("Other",  10.0, "gold");

    let plots = vec![Plot::Pie(pie.clone())];
    let layout = Layout::auto_from_plots(&plots).with_title("Pie Chart");

    let svg = SvgBackend.render_scene(&render_pie(&pie, &layout));
    std::fs::write(format!("{OUT}/basic.svg"), svg).unwrap();
}

/// Donut chart — same slices with a hollow center.
fn donut() {
    let pie = PiePlot::new()
        .with_slice("Rust",   40.0, "steelblue")
        .with_slice("Python", 30.0, "tomato")
        .with_slice("R",      20.0, "seagreen")
        .with_slice("Other",  10.0, "gold")
        .with_inner_radius(60.0);

    let plots = vec![Plot::Pie(pie.clone())];
    let layout = Layout::auto_from_plots(&plots).with_title("Donut Chart");

    let svg = SvgBackend.render_scene(&render_pie(&pie, &layout));
    std::fs::write(format!("{OUT}/donut.svg"), svg).unwrap();
}

/// Percentage labels — appends the percentage to each slice label.
fn percent() {
    let pie = PiePlot::new()
        .with_slice("Rust",   40.0, "steelblue")
        .with_slice("Python", 30.0, "tomato")
        .with_slice("R",      20.0, "seagreen")
        .with_slice("Other",  10.0, "gold")
        .with_percent();

    let plots = vec![Plot::Pie(pie.clone())];
    let layout = Layout::auto_from_plots(&plots).with_title("Pie Chart – Percentages");

    let svg = SvgBackend.render_scene(&render_pie(&pie, &layout));
    std::fs::write(format!("{OUT}/percent.svg"), svg).unwrap();
}

/// Outside labels — explicit leader lines, useful when slices vary widely in size.
fn outside_labels() {
    let pie = PiePlot::new()
        .with_slice("Apples",  30.0, "seagreen")
        .with_slice("Oranges", 25.0, "darkorange")
        .with_slice("Bananas", 20.0, "gold")
        .with_slice("Grapes",  12.0, "mediumpurple")
        .with_slice("Mango",    8.0, "coral")
        .with_slice("Kiwi",     5.0, "olivedrab")
        .with_label_position(PieLabelPosition::Outside);

    let plots = vec![Plot::Pie(pie.clone())];
    let layout = Layout::auto_from_plots(&plots).with_title("Outside Labels");

    let svg = SvgBackend.render_scene(&render_pie(&pie, &layout));
    std::fs::write(format!("{OUT}/outside_labels.svg"), svg).unwrap();
}

/// Legend instead of slice labels — use render_multiple so the legend renders.
fn legend() {
    let pie = PiePlot::new()
        .with_slice("Apples",  40.0, "seagreen")
        .with_slice("Oranges", 35.0, "darkorange")
        .with_slice("Grapes",  25.0, "mediumpurple")
        .with_legend("Fruit")
        .with_percent()
        .with_label_position(PieLabelPosition::None);

    let plots = vec![Plot::Pie(pie)];
    let layout = Layout::auto_from_plots(&plots).with_title("Pie with Legend");

    let svg = SvgBackend.render_scene(&render_multiple(plots, layout));
    std::fs::write(format!("{OUT}/legend.svg"), svg).unwrap();
}