Run your first simulation
Create or select a vehicle, driver, circuit, and ambient, then run a FastSim simulation and open analysis.
Use this tutorial to run a first FastSim simulation in 4ACE. The goal is to move from prepared inputs to a completed simulation result that you can inspect in Summary and Analysis.
Before you start
- Sign in to 4ACE and select the correct team.
- Make sure the team has enough credits. The sidebar Team badge and Team Billing pages show the latest balance.
- Use FastSim for the first run. FastSim is the circuit-based simulation type.
- Prepare these inputs before opening the simulation form:
- Vehicle.
- Driver.
- Circuit.
- Ambient.
OpenSim is also available, but it requires a Driver Input and is not the shortest first-run path.
1. Create or select a vehicle
A vehicle combines setup modules such as body, suspension, steering, brakes, drivetrain, aerodynamics, and tires.
- Open Vehicles from the sidebar.
- Select New.
- Enter Name and Short Name. Short name is limited to 7 characters.
- Add notes, picture, or tags when useful.
- Open Vehicle Assembly.
- Select each required module:
- Body.
- Front suspension.
- Rear suspension.
- Steering.
- Brakes.
- Drivetrain.
- Aerodynamics.
- Front-left, front-right, rear-left, and rear-right tires.
- Save the vehicle.
Use a name that tells the team which baseline this vehicle represents, such as car, class, and setup version.
2. Create or select a driver
- Open Drivers from the sidebar.
- Select New if the driver is not listed.
- Enter Name and Short Name. Short name is limited to 7 characters.
- Add notes or tags when useful.
- Save the driver.
Driver entries help connect simulation runs to the driver or baseline profile used by the team.
3. Create or select a circuit
- Open Circuits from the sidebar.
- Select New if the circuit is not listed.
- Enter Name and Short Name. Short name is limited to 7 characters.
- Add notes, tags, and an optional picture.
- Upload the required Circuit File in CSV format.
- Continue to the verify step.
- Review the parsed circuit map and telemetry preview.
- Adjust Start Angle if the map orientation needs correction.
- Save the circuit.
The circuit picker used by simulations can include team circuits and public circuits.
4. Create or select an ambient
A FastSim run also requires an ambient. Ambients describe the environment and track condition used by the simulation.
- Open Ambients from the sidebar.
- Select New if the ambient is not listed.
- Enter Name.
- Add notes or tags when useful.
- Save the ambient.
- Open the ambient detail page if you need to review or edit condition values such as temperature, pressure, humidity, wind, track temperature, and track grip.
5. Run the simulation
- Open Simulations from the sidebar.
- Select New.
- In General, choose FastSim.
- Add a simulation name, notes, or tags. If you leave the name blank, 4ACE can generate a name from the selected circuit and vehicle.
- Continue to Setup.
- Select Vehicle, Circuit, Ambient, and Driver.
- Continue to Settings.
- Review the credit consumption shown in the sheet header.
- Set simulation settings.
- Optional: turn on Save these settings as team defaults if future simulations for this team should start with these type-specific settings.
- Select Add simulation.
When the simulation is added, it appears in the Simulations table. The table shows simulation name, vehicle, circuit, tags, status, creator, and created time.
Settings reference for the first run
| Setting | What it controls | First-run guidance |
|---|---|---|
| Step Time (s) | Solver step time | Start with the default unless you know you need a different solver frequency. |
| Export Rate (Hz) | Telemetry export rate | Start with the default. Higher export rates create more output detail. |
| Solver Type | Numerical solver | Start with the default unless your team has a solver preference. |
| Start Velocity (km/h) | Vehicle speed at simulation start | Use 0 for a standing start baseline. |
| Start Gear | Gear at simulation start | Must be between 1 and the vehicle's available gears. |
| Simulation Length | Laps or duration | Use laps for a first circuit run. |
| Number of Laps | Laps to simulate | Must be between 1 and 100. |
| Duration (s) | Time to simulate when duration mode is used | Must be between 5 and 7200 seconds for FastSim. |
| Start Position (m) | Start distance around the circuit | Use 0 unless you need an offset start. |
| Brake to Throttle Threshold | Transition threshold for FastSim driving behavior | Must be between 0.1 and 0.99. |
| Brake Point Initial Shift | Initial brake point offset | Must be between 0 and 1000. |
| Throttle Increment (%) | Increment used during throttle search | Must be between 0.1 and 5. |
| Brake Increment (%) | Increment used during brake search | Must be between 0.1 and 5. |
6. Check the result
Open the created simulation from the Simulations table.
The simulation detail page includes:
| Tab | Use it for |
|---|---|
| Summary | Result overview, metadata, resource usage, performance metrics, and lap table when data is available. |
| Analysis | Telemetry charts, lap selection, layout tools, and simulation comparisons. |
| Configuration | Simulation inputs and settings used for the run. |
| Processing | Processing details for the simulation. |
Simulation statuses include Pending, Running, Completed, Failed, Canceled, and Timeout. Performance metrics appear after a simulation completes successfully.
7. Analyze the result
- Open the simulation detail page.
- Select Analysis.
- Wait for telemetry data to load.
- Select laps if no lap is selected.
- Use the analysis layout, channel selector, and chart tools to inspect telemetry.
- Select Add Simulation Comparison when you need to overlay another simulation.
- Filter comparison simulations by circuit, vehicle, creator, date, or tags when needed.
- Select simulations and choose Compare.
Use comparisons to check whether a vehicle setup, ambient condition, or driver profile changed lap time or trace shape in the expected direction.
Troubleshooting
| Problem | What to check |
|---|---|
| Cannot continue from Setup | FastSim requires Vehicle, Circuit, Ambient, and Driver. |
| Credit consumption shows 0 or no estimate | Select required inputs first. Vehicle, circuit, and ambient are needed for FastSim credit estimates. |
| Simulation cannot be submitted | Fix validation errors in General, Setup, or Settings. |
| Performance metrics are missing | Wait for the simulation to reach Completed. Failed, pending, running, canceled, or timed-out runs do not show completed metrics. |
| Analysis opens with no data | Confirm the simulation completed and has telemetry output. |
| Comparison list has no results | Clear filters or increase result range in the Add Simulation Comparison dialog. |
Next steps
- Configure reusable defaults in User preferences.
- Review credit usage in Team credits.
- Review SIM vehicle setup, vehicle submodules, lookup tables, and polynomials.
- Review units and conventions and glossary terms.