batch_results
Read-onlyIdempotent
Retrieve batch simulation job status and progress, or get per-signal aggregate statistics and per-run data from sweep and Monte Carlo runs.
Instructions
Query a batch simulation job (sweep or Monte Carlo). Without signal: returns job status and progress. With signal: returns aggregate statistics or per-run data for that signal.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | Batch job ID from run_sweep or run_montecarlo | |
| signal | No | Signal name for per-signal stats (e.g., 'V(out)') | |
| filters | No | Filter runs by parameter values (e.g., {'R1': '10k'}). Applies in both aggregate and raw mode (requires signal). | |
| at | No | Optional time (transient) or frequency (AC) point in SPICE notation (e.g., '1k', '100u'). When given, each run is sliced to a single sample at that point before aggregating. Without this, the per-run peak across the full waveform is used, which conflates startup/roll-off with run-to-run variation on AC sweeps. | |
| offset | No | Pagination offset for raw data | |
| limit | No | Max raw data rows to return (server caps at 50; page with offset) | |
| raw | No | Return per-run raw data instead of aggregate stats | |
| format | No | Response format: 'json' for structured data, 'text' for human-readable |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | No | ||
| job_type | No | ||
| status | No | ||
| netlist | No | ||
| total_runs | No | ||
| completed_runs | No | ||
| failed_runs | No | ||
| mode | No | ||
| signal | No | ||
| run_count | No | ||
| stats | No | ||
| max_case_run | No | ||
| min_case_run | No | ||
| runs | No | ||
| pagination | No | ||
| convergence_warnings | No | Per-run convergence-fallback markers (Gmin stepping, source stepping, etc.) detected in the per-run logs. Present only when at least one run hit a fallback. |