trueno-explain 0.2.0

PTX/SIMD/wgpu visualization and tracing CLI for Trueno
Documentation

trueno-explain: PTX/SIMD/wgpu Visualization and Tracing CLI

A CLI tool that visualizes and traces code generation flows across Trueno's execution targets. Implements the Toyota Way principle of Genchi Genbutsu (Go and See) by making invisible compiler transformations visible.

Features

  • PTX register pressure analysis
  • Memory access pattern detection
  • Warp divergence visualization (Heijunka)
  • Muda (waste) detection and elimination suggestions

Example

use trueno_explain::ptx::PtxAnalyzer;
use trueno_explain::analyzer::Analyzer;

let ptx = r#"
    .entry test() {
        .reg .f32 %f<16>;
        ret;
    }
"#;

let analyzer = PtxAnalyzer::new();
let report = analyzer.analyze(ptx).unwrap();
assert_eq!(report.registers.f32_regs, 16);