Struct EnergyViolation 

pub struct EnergyViolation {
    pub kind: EnergyViolationKind,
    pub budget: f64,
    pub estimated: f64,
    pub budget_span: Span,
    pub code_span: Span,
    pub confidence: f64,
    pub message: String,
    pub callee_chain: Vec<(String, f64)>,
}

Energy violation detected during compile-time analysis.

This is returned when energy estimation determines that a function’s estimated energy consumption exceeds its declared budget.

Fields

kind: EnergyViolationKind

The kind of violation

budget: f64

The declared budget value

estimated: f64

The estimated actual value

budget_span: Span

Source span where the budget was declared

code_span: Span

Source span of the violating code (e.g., function body)

confidence: f64

Confidence level of the estimate (0.0 to 1.0)

message: String

Human-readable description of the violation

callee_chain: Vec<(String, f64)>

Callee chain showing where the energy went: (callee_name, cost_joules) Populated only for transitive budget violations

Implementations

impl EnergyViolation

pub fn format_joules(joules: f64) -> String

Format a joule value with appropriate SI prefix for readability. Values >= 0.001J use plain joules; smaller values use mJ/uJ/nJ/pJ.

pub fn joules( budget: f64, estimated: f64, budget_span: Span, code_span: Span, confidence: f64, ) -> Self

Create a new joule budget violation

pub fn watts( budget: f64, estimated: f64, budget_span: Span, code_span: Span, confidence: f64, ) -> Self

Create a new power budget violation

pub fn temp_delta( budget: f64, estimated: f64, budget_span: Span, code_span: Span, confidence: f64, ) -> Self

Create a new temperature budget violation

pub fn excess_percentage(&self) -> f64

Get the percentage by which the estimate exceeds the budget

Trait Implementations

impl Clone for EnergyViolation

fn clone(&self) -> EnergyViolation

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EnergyViolation

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for EnergyViolation

fn eq(&self, other: &EnergyViolation) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for EnergyViolation