Files
Raptor/docs/compiler/options.md
T
NiccoloN a77edafcbf
Validate Operations / validate-operations (push) Has been cancelled
even better more structured throughput scheduling
plot adjustments
validation adjustments
2026-10-27 17:46:46 +01:00

2.6 KiB

Pim compiler options

See the quick start for a complete command and the documentation index for the compilation pipeline.

Pass these to onnx-mlir; --help also lists inherited ONNX-MLIR options. Boolean switches default to off unless stated otherwise.

Option Purpose / default
--maccel=PIM Select the PIM accelerator.
--EmitSpatial, --EmitPim, --EmitPimBufferized, --EmitPimCodegen Stop at a pipeline stage; default: codegen.
--core-count=N, --crossbar-size=N, --crossbar-count=N Required hardware resources; crossbars are square.
--pipeline=N Static queue-aware throughput selection for final codegen with N > 1; intermediate targets retain the original schedule. Default: 1 (latency PEFT).
--pim-target-config=PATH Target cost/topology configuration; resources must match hardware flags. Default: built-in model.
--pim-memory-report=summary|none Memory report at reports/memory_report.txt; default: summary.
--pim-only-codegen Run the codegen tail on bufferized Pim IR.
--pim-emit-json Also emit per-core JSON instructions.
--pim-dump-ir Write diagnostic IR snapshots with elided large constants; default: off.
--pim-periodic-diagnostics Write optional recurrence and Spatial execution-work reports; default: off.
--pim-export-spatial-dataflow=none|spatial1|spatial2|spatial3|spatial4|all Export graph, trivially merged, scheduled, and realized CSV snapshots under reports/; default: none.
--pim-conv-lowering=STRATEGY auto (default), legacy, depthwise, packed-im2col, streamed-patch, streamed-packed, output-channel-tiled, input-k-tiled, or tiled-2d.
--pim-conv-im2col-max-elements=N Global im2col limit before streaming; default: 1048576.
--pim-conv-stream-chunk-positions=N Output positions per streamed chunk; default: 1024.
--pim-report-conv-lowering=true|false Bounded lowering report; default: true.
--pim-disable-spatial-planning Choose each plan's first dense alternative; ONNX rewrites and graph merging remain enabled.
--pim-disable-synchronization Keep the normal selected schedule and omit wait/sync during code generation. Report a separate zero-cost synchronization estimate for ablation. Removes correctness guarantees for buffer reuse and restart.
--pim-detect-communication-deadlock Check expanded blocking send/receive ordering.
--pim-verify-bufferization-copy-freedom Run the expensive pre-bufferization copy-freedom proof.