# run_inputs

What a run is built for and captured under: the typed fixture that pins a model's input bytes and declares its outputs, the tensors' element types and quantization, how the run is timed, the prepared runtime a build links, the board guard a capture answers to, the model analysis that lists a model's inputs and outputs, and the targets and IO types this heliaPROFILER builds.

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

**API tier:** `experimental`

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

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

IO tensor element types a fixture can declare.

**API tier:** `experimental`

`dataclass`

A file pinned by its SHA-256; :meth:`read` refuses bytes that no longer match.

**API tier:** `experimental`

What the timed span covers.

``INVOKE_ONLY`` brackets each invocation; ``RESTORE_AND_INVOKE`` brackets
the timed loop, so restoring the fixed inputs before each invocation is
inside the span.

**API tier:** `experimental`

Read a LiteRT model's public inputs and outputs without selecting an engine.

**API tier:** `experimental`

Internal state behavior; input restoration is independent of this policy.

**API tier:** `experimental`

Role of one fixture tensor; outputs are always ``SIGNAL``.

**API tier:** `experimental`

`dataclass`

**API tier:** `experimental`

`dataclass`

Select input-restoration timing and, optionally, the internal-state policy.

Carry initializes the engine once, then retains internal state through
warmups and measurements. It is how fixtures always run, so a build of a
model with internal state records it when no policy is given. Fixed external
inputs are still restored each invocation; no internal reset or
source-initializer equivalence is implied.

**API tier:** `experimental`

`dataclass`

**API tier:** `experimental`

Read a model's public inputs and outputs as *engine*'s fixture integration admits them.

**API tier:** `experimental`

`dataclass`

One named model input or output with its dtype, shape and quantization.

**API tier:** `experimental`

`dataclass`

One model input with its fixed bytes, or one output with its expected bytes.

**API tier:** `experimental`

`dataclass`

One complete output declaration, without a reference answer.

**API tier:** `experimental`

`dataclass`

A model's public inputs and outputs in model order, with its graph facts.

**API tier:** `experimental`

`dataclass`

Fixed input bytes and complete ordered outputs for a model.

Outputs are descriptors, or legacy ``FixtureIO`` references. Reference
bytes are not needed for measurement; legacy identities remain unchanged.

**API tier:** `experimental`

---

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