simparse is a lightweight Rust and Python scanner for simulation project and
case metadata.
| Format | Files |
|---|---|
| STEP Part 21 declarations | .step, .stp |
| COMSOL | .mph |
| Abaqus | .inp, .inc |
| Fluent | .cas.h5, .msh.h5 |
| Ansys Electronics Desktop (HFSS / Icepak) | .aedt, .aedtz |
| Ansys Mechanical | .mechdb, .mechdat |
| Icepak Classic | .tzr |
| Simcenter FloTHERM | .pack, .xml, .floxml |
| Simulink | .slx, .mdl |
| MATLAB data | .mat |
simparse is meant to compose with existing simulation tools, not replace them.
It focuses on lightweight agent workflows: metadata, inventory, quick directory
scans, and deciding when a heavier vendor or Python tool should be called next.
See tool design principles.
The draft AI Infra System IR defines compact inspection manifests
for cooling, advanced packaging and 3D IC, with CAD/CAE dialects and software
extensions. Geometry, meshes and result data stay in referenced artifacts.
JSON inspection results include an additive ir field alongside the existing
format-specific summary. STEP uses the CAD dialect; supported simulation formats
use the CAE dialect. The draft describes observed metadata, not executable models.
cargo run -p simparse-cli -- inspect /path/to/model.mph --json
cargo run -p simparse-cli -- inspect /path/to/assembly.step --json --summary
cargo run -p simparse-cli -- inspect /path/to/thermal-model.xml --json --summary
cargo run -p simparse-cli -- inspect /path/to/model.mph --json --summary
cargo run -p simparse-cli -- scan /path/to/history --jsonlUse --summary for a deterministic, bounded preflight view. It reports total
counts with capped samples and explicit parser limitations. Omit it when the
full shallow inventory is needed.
STEP inspection streams source declarations with bounded metadata retention. It
reports schema names, entity-type counts, selected product names and length-unit
declarations. Counts are source records, not assembly occurrence counts or proof
of valid geometry. Units remain scoped declarations; no global scale is guessed.
Incomplete input or skipped records set truncated. For STEP, --max-text-bytes
limits each retained record, capped at 64 KiB, rather than the entire file read.
FloXML files commonly use the generic .xml suffix. simparse checks their
root element, so directory scans include <xml_case> and <sm_xml_case> files
while skipping unrelated XML.
maturin develop
python -c "import simparse; print(simparse.inspect('/path/to/model.inp', summary=True))"
python -c "import simparse; print(simparse.scan(['/path/to/history'], summary=True))"
python benchmarks/compare.pyThis benchmark models one practical agent path: call one external tool to scan a group of public simulation artifacts. The bars include process startup and library import cost. The JSON artifact also records an in-process Python baseline for context; those numbers are useful for library-level comparison, but are not the primary agent tool-call scenario.
The benchmark downloads public URLs listed in benchmarks/public-artifacts.json
into target/ and writes artifacts/public-benchmark.json plus
artifacts/public-benchmark.svg. Vendor-native parser timings are not included
because they require locally licensed software or APIs.
Apache-2.0