# results

What a profiling run produces: the run result, its per-layer and PMU detail, and the firmware and run metadata that say how it was measured.

Every name on this page is imported from `helia_profiler`.

**API tier:** `stable`

Generated from the `src/helia_profiler` tree `fe269596788d6ab1604cf433559e96b5f48c1d13`.

[Machine-readable model](https://ambiqai.github.io/helia-profiler/reference/api/helia_profiler/results.json)

`dataclass`

Profiling result for a single model layer (averaged across iterations).

``source_index`` is the ORIGINAL tflite operator index this measured
layer corresponds to, when the op label carries one (#218). ``id`` is
the firmware's execution position, which on AOT engines is NOT the
original index — helia-aot skips ops without renumbering.

**API tier:** `stable`

`dataclass`

Results for a single PMU counter preset (e.g. ``basic_cpu``).

**API tier:** `stable`

`dataclass`

Metadata reported by the profiler firmware at startup.

All fields are optional because older firmware versions may not report
every field.

**API tier:** `stable`

``model_size`` when it is a usable byte count, else ``None``.

The wire parser keeps an unparseable ``HPX_MODEL_SIZE`` as the raw
string it received, so a corrupted or foreign line reaches consumers
as text. Anything that needs a number asks here instead of assuming;
the raw value stays on ``model_size`` so diagnostics can still quote
what the device actually said (#281).

`dataclass`

Complete PMU profiling result across all presets.

**API tier:** `stable`

`dataclass`

Accumulated run metadata — enriched by stages, consumed by reports.

**API tier:** `stable`

`dataclass`

Complete profiling result — the public return type of ``hpx.profile()``.

This is the one object a programmatic user needs.  It carries everything:
PMU data, optional power data, run metadata, and report file paths.

**API tier:** `stable`

Merged per-layer results across all PMU presets.

---

Machine-readable: [`results.json`](https://ambiqai.github.io/helia-profiler/reference/api/helia_profiler/results.json) · [`results.md`](https://ambiqai.github.io/helia-profiler/reference/api/helia_profiler/results.md), complete and lossless.