aprender-cbtop 0.63.0

Compute Block Top - Real-time load testing and hardware monitoring TUI
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

//! Bottleneck analyzer using Roofline model

use crate::brick::{Brick, BrickAssertion, BrickBudget, BrickVerification};
use std::any::Any;

/// Roofline model analysis
pub struct BottleneckAnalyzerBrick {
    peak_flops: f64,
    peak_bandwidth: f64,
}

impl BottleneckAnalyzerBrick {
    pub fn new(peak_flops: f64, peak_bandwidth: f64) -> Self {
        Self {
            peak_flops,
            peak_bandwidth,
        }
    }

    pub fn analyze(&self, achieved_flops: f64, operational_intensity: f64) -> BottleneckResult {
        // Roofline: achieved_perf <= min(peak_flops, peak_bandwidth * op_intensity)
        let memory_roof = self.peak_bandwidth * operational_intensity;
        let is_compute_bound = memory_roof > self.peak_flops;
        let theoretical_peak = memory_roof.min(self.peak_flops);
        let efficiency = achieved_flops / theoretical_peak;

        BottleneckResult {
            is_compute_bound,
            operational_intensity,
            achieved_flops,
            theoretical_peak,
            efficiency,
            bottleneck: if is_compute_bound {
                Bottleneck::Compute
            } else {
                Bottleneck::Memory
            },
        }
    }

    pub fn reset(&mut self) {}
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Bottleneck {
    Compute,
    Memory,
    Unknown,
}

#[derive(Debug, Clone)]
pub struct BottleneckResult {
    pub is_compute_bound: bool,
    pub operational_intensity: f64,
    pub achieved_flops: f64,
    pub theoretical_peak: f64,
    pub efficiency: f64,
    pub bottleneck: Bottleneck,
}

impl Default for BottleneckAnalyzerBrick {
    fn default() -> Self {
        // Default: 10 TFLOPS, 500 GB/s
        Self::new(10e12, 500e9)
    }
}

impl Brick for BottleneckAnalyzerBrick {
    fn brick_name(&self) -> &'static str {
        "bottleneck_analyzer"
    }

    fn assertions(&self) -> Vec<BrickAssertion> {
        vec![
            BrickAssertion::custom("roofline_valid", |_| true),
            BrickAssertion::max_latency_ms(1),
        ]
    }

    fn budget(&self) -> BrickBudget {
        BrickBudget {
            collect_ms: 1,
            layout_ms: 0,
            render_ms: 0,
        }
    }

    fn verify(&self) -> BrickVerification {
        let mut v = BrickVerification::new();
        for assertion in self.assertions() {
            v.check(&assertion);
        }
        v
    }

    fn as_any(&self) -> &dyn Any {
        self
    }
}