SimPilot
DocumentationExamplesAPI Reference
Sign in

Search Documentation

Find pages across the documentation

Getting Started

IntroductionQuickstartHow It Works

Core Concepts

AI AgentSimulation WorkflowEngineering PipelineKnowledge BaseArchitecture

Features

OverviewChat InterfaceCanvas & ArtifactsSharing & CollaborationExports & ReportsVoice InputMulti-Model AIProjectsTemplates & WorkflowsFile UploadsDeep ResearchWeb SearchCode ExecutionImage GenerationMCP ConnectorsInteractive DashboardsParallel ExecutionURL RetrievalFreeCAD CADSimulationsTemplatesConvergence Monitoring

Simulation

OverviewSupported TypesMesh GenerationError RecoveryBatch & SweepsResults Comparison

Studies & Analysis

OverviewDOE & Parametric SweepsOptimizationComparison

Validation & Reviews

OverviewBaselines & VersioningEngineering ReviewsRegulatory Compliance

3D Viewer

OverviewVisualization ToolsKeyboard Shortcuts

Enterprise

OverviewAdmin PanelOrganizationsKnowledge ManagementMethod Packs

Account

Getting StartedSettingsBilling

Examples

OverviewAerodynamicsPipe FlowHeat TransferStructural
  1. Docs
  2. Simulation
  3. Batch & Parameter Sweeps

Batch & Parameter Sweeps

Run up to 20 simulations in parallel with automated comparison.

SimPilot can run multiple simulations concurrently, either as independent batch jobs or as structured parameter sweeps. When all jobs complete, the system automatically compares results and surfaces the key differences.

Batch simulation

A batch groups 1 to 20 simulations into a single coordinated run. Each simulation in the batch is a fully independent workflow -- with its own case setup, mesh generation, solver execution, and error recovery.

How it works

Batch creation

The system creates a batch to coordinate and track all the runs.

Concurrent execution

Individual simulation workflows are spawned with bounded concurrency. Each workflow runs the full simulation pipeline independently.

Progress streaming

The batch system streams real-time progress updates to the chat interface: which jobs are running, which have completed, and which have failed -- with failure reasons.

Automatic comparison

When all jobs finish (or the batch reaches a terminal state), the system automatically compares results to extract metrics from every completed job, build comparison tables, and detect regressions.

Sweep caps by plan

The maximum number of parameter combinations in a single sweep depends on your subscription tier:
PlanSweep cap
Free20
Pro100
Enterprise500
Chunking beyond batch size
Individual batches run up to 20 simulations. For larger sweeps, jobs are automatically chunked into sequential batches. Simulations within each batch run concurrently with bounded concurrency.

Cancellation and retry

  • Cancellation: You can cancel a running batch at any time. The system checks the batch status before launching each new job -- if the batch is marked as cancelled, remaining jobs are skipped.
  • Per-job recovery: Each simulation within a batch has its own error recovery flow. A single job failing does not cancel the entire batch.
  • Terminal status: When all jobs complete, the batch resolves to one of: completed (all succeeded), partial (some succeeded), failed (none succeeded), or cancelled.

Parameter sweeps

For systematic studies, SimPilot supports single-variable and multi-variable parameter sweeps that automatically expand parameter combinations into batch jobs.

Single-variable sweep

Vary one parameter while holding everything else constant:
"Run this pipe flow simulation at velocities 5, 10, 15, and 20 m/s"
This creates 4 simulations, each with a different inlet velocity. The base requirement is augmented with the parameter value for each job (e.g., "...with velocity=5 m/s").

Multi-variable sweep

Vary multiple parameters simultaneously:
"Sweep Reynolds numbers 1000, 5000, 10000 and turbulence models k-epsilon, k-omega-SST"
SimPilot computes the Cartesian product of all parameter values. In this example, that produces 3 x 2 = 6 combinations. Each combination becomes an independent simulation.

Chunking

When the total number of combinations exceeds 20 (the maximum batch size), SimPilot chunks the sweep into multiple sequential batches of up to 20 jobs each. Each chunk runs as a separate batch with its own comparison step.
Sweep size limits
The total number of sweep combinations is capped by your subscription plan. If the Cartesian product exceeds your plan's sweep cap, the system returns an error with the total count and cap, so you can reduce the parameter space.

Batch dashboard UI

The chat interface displays a live batch progress card with:
  • Summary counters: Total, completed, failed, running, and cancelled job counts
  • Per-simulation status cards: Each job shows its label, current status, and error reason (if failed)
  • Failure reasons: When jobs fail, the specific error messages are surfaced in the progress updates
  • Comparison results: After completion, the comparison table and rankings are displayed inline
All progress updates stream in real time -- you can watch jobs complete as they finish without waiting for the entire batch.
PreviousError RecoveryNextResults Comparison

On this page

Batch simulationHow it worksSweep caps by planCancellation and retryParameter sweepsSingle-variable sweepMulti-variable sweepChunkingBatch dashboard UI