run_simulation
Run SPICE simulations on netlist files, automatically handling raw/log outputs and returning parsed results or a job ID for longer runs.
Instructions
Run a SPICE simulation on a netlist file. Sets the right batch flags, handles the ngspice headerless-raw dialect, routes the raw/log artifacts, and parses the results — so you never hand-parse a rawfile. Automatically runs synchronously for short simulations (<=30s timeout) or asynchronously for longer ones. Use wait=true to force synchronous execution. Returns raw/log file paths and simulation summary on completion, or a job ID for async tracking.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Force synchronous execution. Blocks until completion or hard timeout. | |
| format | No | Response format: 'json' for structured data, 'text' for human-readable | |
| netlist | Yes | Path to the netlist file (.cir, .net, .asc) | |
| timeout | No | Timeout in seconds (defaults to the server's configured default, 300s). Simulations exceeding 30s run asynchronously unless wait=true. With wait=true the effective limit is min(this timeout, 600s): 600s is a hard ceiling, not a floor — pass a larger timeout to use the full 600s. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | ||
| range | No | ||
| errors | No | ||
| job_id | No | ||
| status | No | ||
| fourier | No | ||
| netlist | No | ||
| signals | No | ||
| duration | No | ||
| log_file | No | ||
| raw_file | No | ||
| sim_type | No | ||
| warnings | No | ||
| simulator | No | ||
| step_count | No | ||
| meas_errors | No | ||
| point_count | No | ||
| measurements | No | ||
| observations | No | ||
| failed_measurements | No |