Reports and metrics

Reports & Metrics for Sample Timing Contract focuses on aperture budget compliance, sample alignment error, control-loop jitter. The goal is to connect observed symptom to boundary mechanism, ownership, and signoff risk.

Reports convert aperture budget compliance, sample alignment error, control-loop jitter into release decisions. A single average metric is insufficient; use tails, mode breakdowns, and trend under controlled conditions.

Metric movement

METRIC GRAPH — aperture budget compliance, sample alignment error, control-loop jitter

health / margin
  ^
  |                         target
  |                       - - - - - - -
  |                  o post-fix
  |              o
  |         o baseline
  |    o failing run
  +--------------------------------------> debug iteration
    repro setup    root-cause proof    release candidate

Readout:
  - compare only equivalent mode, payload, clock, and environment tags
  - separate symptom stabilization from true mechanism closure

Distribution view

METRIC DISTRIBUTION — Sample Timing Contract

occurrence
  |      ***
  |    *******
  |  ***********
  |*************  <- left tail (worst boundary excursions)
  +--------------------> margin / stability / error metric
  bad                 nominal

Fix the tail first; average value can hide integration escapes.

• Track aperture budget compliance, sample alignment error, control-loop jitter by mode and stress condition.

• Report p95/p99 or worst-case tail when intermittent escapes matter.

• Store metric with exact artifact and configuration tags.

• Separate symptom stabilization from mechanism closure.

AMS deep dive

Wrapper and sampling contracts determine data trustworthiness.

Concept diagram

CONVERTER DATA FLOW

sampling clock -> wrapper -> sync boundary -> system consumer

Metric graph

INVALID SAMPLE BURSTS

time --->  _|¯¯|__|¯¯¯|____|¯|_

Reports and artifacts

• sample validity ratio

• calibration convergence

• CDC audit

• overflow/stale sample counters

Mini case study

Mode transition changed sample phase and invalidated wrapper framing assumptions.

Debug branches

• Sample timing contract

• Calibration hook behavior

• Wrapper CDC integrity

Senior review question

Ask: what boundary condition proves this topic is actually closed?

Key takeaways

• State boundary, mode, and evidence tag with every claim.

• Always align analog, digital, and physical owners before signoff decisions.

Common pitfalls

• Fixing averages while tails still fail.

• Skipping package/supply evidence in jitter or SerDes issues.

• Shipping with waivers that lack owner and expiration criteria.

Reading reports