Skip to content

docs: framing matrix complete — a distribution property, not quantization - #214

Merged
ronaldtse merged 1 commit into
mainfrom
docs/framing-matrix
Sep 12, 2026
Merged

ronaldtse merged 1 commit into
mainfrom
docs/framing-matrix

Conversation

@ronaldtse

Copy link
Copy Markdown
Contributor

The framing test run at every endpoint (same machine, ORT 1.23, 5 golden rows x 96 steps):

runtime precision single==batched
Python ORT fp32 480/480
Python ORT dynamic int8 480/480
Python ORT static int8 480/480
onnxruntime-node fp32 101/485
onnxruntime-node dynamic int8 97/485
onnxruntime-node static int8 89/485

The instability is a property of the onnxruntime-node kernel paths (batch-shape-dependent numerics at fp32, before quantization enters), absent from the Python build at every precision. Static activation scales - the pre-registered fix - do not repair it; TODO.impl/11 closes with that negative plus a positive byproduct (static int8 is quality-clean on sample and ~8% faster than dynamic on CPU; candidate for the export path on its own merits, gated by full-set DER).

Paper C 5.1 carries the final scoping. Shipped paths are single-framing by construction, so published byte parity is unaffected; framing is the parity variable of mixed-shape serving (why the speculative tier degraded and was pulled).

…tion

The single-vs-batched test run at every endpoint: Python ORT 480/480
at fp32, dynamic int8, AND static int8; onnxruntime-node 89-101/485 at
every precision including fp32. Static scales do not repair the node
build - its kernels differ across batch shapes before quantization
enters. Shipped paths are single-framing so published byte parity is
unaffected; framing is the parity variable of mixed-shape serving.
Paper C 5.1 carries the final scoping; static int8 stays a candidate
for the export path on speed and quality, decided by full-set DER.
@ronaldtse
ronaldtse merged commit 8d75cc4 into main Sep 12, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant