Run Batch Simulations
Create a 4ACE simulation batch from setup inputs, parameter ranges, and generated designs.
Batch Simulations generate multiple simulation runs from one setup and a design space. Use them when you need to compare vehicle or ambient parameter changes across many runs instead of creating each simulation manually.
Choose Full Factorial to generate every combination from parameter ranges, or Batch Configuration to copy a saved design matrix.
Before you start
- Select the correct team.
- Confirm the team has enough credits for the included designs.
- Prepare required setup inputs for FastSim or OpenSim.
- You need the required module permissions to create, edit, duplicate, delete, or queue batches.
- Decide which ambient or vehicle parameters you want to vary.
Create a batch
- Open Batch Simulations from the sidebar.
- Select New.
- In General, choose FastSim or OpenSim.
- Enter a Name. The name must be from 2 to 100 characters.
- Add Notes and Tags if useful.
- Select Next to continue to Setup.
- Select the simulation inputs:
- FastSim: Vehicle, Circuit, Ambient, and Driver.
- OpenSim: Vehicle, Ambient, Driver, and Driver Input.
- Select Next. 4ACE validates Setup, creates the pending draft, and opens Simulation Settings.
- Set the simulation settings.
- Optional: turn on Save settings as team defaults to use these tuning settings for future simulations in the selected team.
- Select Next. 4ACE saves the settings and opens Design Space.
Each Next action saves the work required by the current step before advancing. There is no separate Save action.
Define design space
Choose Full Factorial to generate designs from ranges:
- Open Ambient Parameters or Vehicle Parameters.
- Add a parameter.
- Enter the Lower value.
- Enter the Upper value.
- Enter the number of Levels.
- Repeat for each parameter you want to vary.
- Select Next. 4ACE saves the scenarios, generates the full-factorial design matrix, and opens Simulations.
If generated simulations already exist, confirm before replacing the existing design matrix.
Use a saved configuration
- In Design Space, select Batch Configuration.
- Choose a saved Configuration.
- Select Next to validate it against the batch's vehicle and ambient and copy its designs.
- Resolve any Configuration does not match this batch issues before continuing.
- Confirm replacement if the batch already has designs, then review the Simulations step.
See Batch Configurations to create, import, or edit a matrix.
Parameter scenario fields
| Field | What it means | Validation / Range |
|---|---|---|
| Parameter | Ambient or vehicle parameter selected from available batch parameters. | Required. A parameter can be selected once per parameter group. |
| Unit | Unit from the parameter information. | Read-only. |
| Lower | Low value for generated designs. | Must be less than Upper. |
| Upper | High value for generated designs. | Must be greater than Lower. |
| Levels | Number of values generated between Lower and Upper. | Whole number, at least 2. |
Because the design matrix is full factorial, the number of designs grows as parameter levels multiply. For example, three parameters with two levels each create eight designs.
Review generated simulations
The Simulations step shows the generated design matrix. Use it to:
- Review each parameter value for each design.
- Include or exclude individual designs.
- Confirm at least one design is included.
Selection changes are saved when you confirm the queue action.
Queue the batch
- In Simulations, select Queue Simulations.
- Review the batch name, parameter counts, total designs, included designs, excluded designs, cost, and available credits.
- Select Confirm. 4ACE saves inclusion changes before adding the batch to the queue.
Queueing is blocked when no designs are included or the available credits are lower than the batch cost.
Close a pending batch
Select Close to leave a saved pending batch. The draft remains available from the batch list. If the sheet has unsaved local changes, confirm before discarding them.
Review batch results
Pending batches reopen in the batch sheet. Completed batches open the batch detail page.
Batch statuses include:
| Status | Meaning |
|---|---|
| Pending | Draft batch or waiting to run. |
| Running | Batch simulations are running. |
| Finished | Batch completed successfully. |
| Finished with errors | Batch completed with one or more failed runs. |
| Abandoned | Batch no longer continues. |
The batch detail page can include:
| Tab | Use it for |
|---|---|
| Details | Batch metadata, tags, credits consumed, and simulation settings. |
| Parallel Coordinates | Compare runs across parameters and results. |
| Results Overview | Review selected dimensions together. |
| Cross Plots | Compare dimensions against each other. |
| Main Effect | Inspect main effects across selected parameters. |
| Correlation | Review correlation between dimensions. |
| Results Table | Inspect runs and select runs for deeper analysis. |
| Analysis | Analyze selected simulations after loading them from Results Table. |
Troubleshooting
| Problem | What to check |
|---|---|
| New is hidden or batch is read-only | Confirm your role has required module permissions. |
| Cannot continue from Setup | FastSim requires Circuit. OpenSim requires Driver Input. Both require Vehicle, Ambient, and Driver. |
| Cannot reach Design Space | Return to Setup or Simulation Settings and select Next after fixing validation errors. |
| No designs generated | Add at least one parameter scenario, then select Next in Design Space. |
| Lower or upper validation fails | Lower must be less than Upper. |
| Levels validation fails | Levels must be a whole number of at least 2. |
| Queue button is disabled | Include at least one design and confirm enough credits are available. |
| Batch detail shows no results | Wait for the batch to finish. If all runs failed or timed out, no result charts are available. |