plotlars 0.12.0

Plotlars is a Rust library designed to facilitate the integration between the Polars data analysis library and visualization libraries.
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

use plotlars::polars::prelude::*;
use plotlars::{CsvReader, Mode, Plot, Rgb, ScatterGeo, Shape, Text};

fn main() {
    let cities = CsvReader::new("data/us_cities_regions.csv")
        .finish()
        .unwrap()
        .lazy()
        .select([col("city"), col("lat"), col("lon")])
        .limit(5)
        .collect()
        .unwrap();

    ScatterGeo::builder()
        .data(&cities)
        .lat("lat")
        .lon("lon")
        .text("city")
        .plot_title(Text::from("US Major Cities").font("Arial").size(20))
        .build()
        .plot();

    let cities_with_regions = CsvReader::new("data/us_cities_regions.csv")
        .finish()
        .unwrap();

    ScatterGeo::builder()
        .data(&cities_with_regions)
        .lat("lat")
        .lon("lon")
        .mode(Mode::Markers)
        .text("city")
        .group("region")
        .size(20)
        .colors(vec![
            Rgb(255, 0, 0),
            Rgb(0, 255, 0),
            Rgb(0, 0, 255),
            Rgb(255, 165, 0),
        ])
        .shapes(vec![
            Shape::Circle,
            Shape::Square,
            Shape::Diamond,
            Shape::Cross,
        ])
        .plot_title(
            Text::from("US Cities by Region")
                .font("Arial")
                .size(24)
                .x(0.5),
        )
        .legend_title(Text::from("Region").size(14))
        .build()
        .plot();

    // Example 3: ScatterGeo with lines connecting cities (flight paths)
    let flight_path = CsvReader::new("data/flight_path.csv").finish().unwrap();

    ScatterGeo::builder()
        .data(&flight_path)
        .lat("lat")
        .lon("lon")
        .mode(Mode::LinesMarkers)
        .text("city")
        .size(15)
        .color(Rgb(0, 123, 255))
        .line_width(2.0)
        .line_color(Rgb(255, 123, 0))
        .opacity(0.8)
        .plot_title(Text::from("Flight Path: NY to LA").font("Arial").size(20))
        .build()
        .plot();

    // Example 4: World cities with custom styling
    let world_cities = CsvReader::new("data/world_cities.csv").finish().unwrap();

    ScatterGeo::builder()
        .data(&world_cities)
        .lat("lat")
        .lon("lon")
        .mode(Mode::Markers)
        .text("city")
        .group("continent")
        .size(25)
        .opacity(0.7)
        .colors(vec![
            Rgb(255, 0, 0),
            Rgb(0, 255, 0),
            Rgb(0, 0, 255),
            Rgb(255, 255, 0),
            Rgb(255, 0, 255),
            Rgb(0, 255, 255),
        ])
        .plot_title(
            Text::from("Major World Cities by Continent")
                .font("Arial")
                .size(24),
        )
        .legend_title(Text::from("Continent").size(16))
        .build()
        .plot();
}