Struct BenchReport 

pub struct BenchReport {
    pub spec: BenchSpec,
    pub samples: Vec<BenchSample>,
    pub phases: Vec<SemanticPhase>,
    pub timeline: Vec<HarnessTimelineSpan>,
}

Complete benchmark report with all timing samples.

Contains the original specification and all collected samples. Can be serialized to JSON for storage or transmission.

Example

use mobench_sdk::timing::{BenchSpec, run_closure};

let spec = BenchSpec::new("example", 50, 5)?;
let report = run_closure(spec, || {
    std::hint::black_box(42);
    Ok(())
})?;

// Calculate statistics
let samples: Vec<u64> = report.samples.iter()
    .map(|s| s.duration_ns)
    .collect();

let min = samples.iter().min().unwrap();
let max = samples.iter().max().unwrap();
let mean = samples.iter().sum::<u64>() / samples.len() as u64;

println!("Min: {} ns, Max: {} ns, Mean: {} ns", min, max, mean);

Fields

spec: BenchSpec

The specification used for this benchmark run.

samples: Vec<BenchSample>

All collected timing samples.

The length equals spec.iterations. Samples are in execution order.

phases: Vec<SemanticPhase>

Optional semantic phase timings captured during measured iterations.

Defaults to an empty vector when deserializing reports produced by older mobench versions that did not emit phase data.

timeline: Vec<HarnessTimelineSpan>

Exact harness timeline spans in execution order.

Defaults to an empty vector when deserializing reports produced by older mobench versions that did not emit timeline data.

Implementations

impl BenchReport

pub fn mean_ns(&self) -> f64

Returns the mean (average) duration in nanoseconds.

pub fn median_ns(&self) -> f64

Returns the median duration in nanoseconds.

pub fn std_dev_ns(&self) -> f64

Returns the standard deviation in nanoseconds (sample std dev, n-1).

pub fn percentile_ns(&self, p: f64) -> f64

Returns the given percentile (0-100) in nanoseconds.

pub fn min_ns(&self) -> u64

Returns the minimum duration in nanoseconds.

pub fn max_ns(&self) -> u64

Returns the maximum duration in nanoseconds.

pub fn cpu_total_ms(&self) -> Option<u64>

Returns the total measured CPU time in milliseconds across all iterations.

pub fn cpu_median_ms(&self) -> Option<u64>

Returns the median measured CPU time in milliseconds across all iterations.

pub fn peak_memory_kb(&self) -> Option<u64>

Returns the maximum baseline-adjusted peak memory growth in kilobytes.

This is the legacy accessor for the serialized peak_memory_kb sample field. It does not report absolute process or device peak memory.

pub fn peak_memory_growth_kb(&self) -> Option<u64>

Returns the maximum baseline-adjusted peak memory growth in kilobytes.

This is an explicit alias for BenchReport::peak_memory_kb to make the growth semantics clear while preserving the legacy wire field.

pub fn process_peak_memory_kb(&self) -> Option<u64>

Returns the maximum process resident memory peak in kilobytes.

This reports the current benchmark process peak sampled during measured iterations. It excludes BrowserStack/session-level provider memory.

pub fn summary(&self) -> BenchSummary

Returns a statistical summary of the benchmark results.

Trait Implementations

impl Clone for BenchReport

fn clone(&self) -> BenchReport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BenchReport

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BenchReport

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<BenchReport> for BenchReportFfi

fn from(report: RunnerReport) -> Self

Converts to this type from the input type.

impl From<BenchReport> for BenchReportTemplate

fn from(report: RunnerReport) -> Self

Converts to this type from the input type.

impl Serialize for BenchReport

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.