starsight 0.1.1

A unified scientific visualization crate for Rust — from zero-config one-liners to GPU-accelerated interactive 3D.
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

//! starsight — a unified scientific visualization crate for Rust.
//!
//! starsight is the only crate users add to `Cargo.toml`. It re-exports types
//! from the seven layer crates underneath through three access patterns:
//!
//! 1. **The prelude** — `use starsight::prelude::*;` for the common types.
//! 2. **By category** — `use starsight::marks::LineMark;`, `use starsight::backends::SkiaBackend;`.
//! 3. **By layer** — `use starsight::components::marks::LineMark;` (Latin layer aliases).
//!
//! ```no_run
//! use starsight::prelude::*;
//!
//! fn main() -> starsight::Result<()> {
//!     plot!(&[1.0, 2.0, 3.0, 4.0], &[10.0, 20.0, 15.0, 25.0]).save("chart.png")
//! }
//! ```

// ── Layer aliases (Latin/Greek-rooted) ───────────────────────────────────────────────────────────

pub use starsight_layer_1 as background;
pub use starsight_layer_2 as modifiers;
pub use starsight_layer_3 as components;
pub use starsight_layer_4 as composition;
pub use starsight_layer_5 as common;
pub use starsight_layer_6 as interactivity;
pub use starsight_layer_7 as export;

// ── Semantic facade modules (by category) ────────────────────────────────────────────────────────

pub mod aesthetics;
pub mod axes;
pub mod backends;
pub mod coords;
pub mod exports;
pub mod figures;
pub mod layouts;
pub mod legends;
pub mod marks;
pub mod paths;
pub mod prelude;
pub mod primitives;
pub mod scales;
pub mod sources;
pub mod statistics;
pub mod ticks;

// ── Top-level convenience aliases ────────────────────────────────────────────────────────────────

/// Workspace `Result<T, StarsightError>` alias.
pub type Result<T> = crate::background::errors::Result<T>;
/// Top-level error enum re-export.
pub use crate::background::errors::StarsightError;

// ── plot! macro ──────────────────────────────────────────────────────────────────────────────────

/// One-liner: `plot!(&[1.0, 2.0, 3.0], &[4.0, 5.0, 6.0]).save("out.png").unwrap();`
#[macro_export]
macro_rules! plot {
    ($x:expr, $y:expr $(,)?) => {{
        $crate::common::Figure::from_arrays(
            $x.into_iter().map(|&v| v as f64),
            $y.into_iter().map(|&v| v as f64),
        )
    }};
}