Skip to content

Commit fa061e4

Browse files
committed
docs(perturbation-sim): correct SIMD labels — AVX-512 (v4) yes, AMX no
The ndarray-simd Walsh-Hadamard path uses AVX-512 under x86-64-v4 — NOT AMX. AMX is int8/bf16 tile-GEMM (ndarray::hpc::amx_matmul); this crate's WHT is f32 and its field tier f64, neither of which maps to AMX tiles. Corrected the loose 'AVX-512/AMX' wording in Cargo.toml/README/METHODS §10; noted the int8 AMX path (matmul_i8_to_i32) as a possible-but-unwired future option.
1 parent 29c797d commit fa061e4

3 files changed

Lines changed: 7 additions & 3 deletions

File tree

crates/perturbation-sim/Cargo.toml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,8 @@ description = "Spectral + edge-propagation outage simulator: models the perturba
1111
# cargo run --manifest-path crates/perturbation-sim/Cargo.toml --example simulate
1212
[features]
1313
# Route the Morton/Walsh pyramid transform through ndarray's SIMD
14-
# (AVX-512/AMX, x86-64-v4) Walsh–Hadamard. Default OFF → the crate stays
14+
# (AVX-512 under x86-64-v4) Walsh–Hadamard. AMX is int8/bf16 tile-GEMM and is
15+
# NOT used (this crate's WHT is f32, its field tier f64). Default OFF → stays
1516
# zero-dep with the scalar `fwht` fallback. Build accelerated with:
1617
# RUSTFLAGS='-C target-cpu=x86-64-v4' cargo … --features ndarray-simd
1718
# (or target-cpu=native locally). All SIMD comes from `ndarray::simd` per the

crates/perturbation-sim/METHODS.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -327,7 +327,10 @@ turning a modeling assumption into a testable claim.
327327

328328
### `ndarray-simd` feature (the Morton-pyramid transform, accelerated)
329329
The pyramid's Walsh–Hadamard transform routes through **`ndarray::simd::wht_f32`**
330-
(AVX-512/AMX under `target-cpu=x86-64-v4`) — the one workspace-sanctioned SIMD
330+
(AVX-512 under `target-cpu=x86-64-v4`; **AMX is NOT used** — AMX is int8/bf16
331+
tile-GEMM, whereas the WHT is f32 and the field tier f64. An int8 AMX path
332+
(`ndarray::simd::matmul_i8_to_i32`) for a quantized resistance sketch is a
333+
possible future wiring, not present) — the one workspace-sanctioned SIMD
331334
source (never raw intrinsics here). Default **OFF** → scalar `fwht`, zero-dep;
332335
**ON** via `--features ndarray-simd` (ndarray fork as a git/path dep, `["std"]`).
333336
Both paths pass the same tests. Deeper *tile-specific* ndarray targets, to wire

crates/perturbation-sim/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ method:
1515
| **Data-shaped scoping** | run on today's data; `assess_capability` gates which outputs are valid; missing variables modeled as uniform constants (provably free for relative results); `AgeModel` = Uniform null vs DensityProxy Gegenhypothese (topology-only) vs ModernizationSpend (official planning data). | `model.rs` |
1616

1717
> **SIMD:** the Morton/Walsh pyramid transform optionally routes through
18-
> `ndarray::simd::wht_f32` (AVX-512/AMX) via `--features ndarray-simd`
18+
> `ndarray::simd::wht_f32` (AVX-512 under x86-64-v4; AMX not used — f32 WHT, not int8 tile-GEMM) via `--features ndarray-simd`
1919
> (`RUSTFLAGS='-C target-cpu=x86-64-v4'`); default is the zero-dep scalar path.
2020
> All SIMD comes from `ndarray::simd` (workspace rule). See `METHODS.md §10`.
2121

0 commit comments

Comments
 (0)