Circuits

Create circuit inputs from CSV track data for FastSim and circuit analysis workflows.

Circuits are reusable SIM inputs that store track data, map orientation, and circuit metadata. FastSim uses circuits for circuit-based simulation setup. Circuit detail pages also let you inspect the track map and available telemetry preview.

Use circuits when your team needs a track file that can be selected consistently across simulation runs.

Before you start

Select the correct team.
You need module create permission to add a circuit.
Prepare a CSV circuit file with a header row and numeric data rows.
Choose a name and short name before opening the import sheet.

Create a circuit

Open Circuits from the sidebar.
Select New.
Enter Name.
Enter Short Name. Short name is limited to 7 characters.
Add Notes and Tags when useful for event, track version, or source tracking.
Optionally upload a PNG, JPEG, or JPG picture up to 5 MB.
Upload the required Circuit File in CSV format.
Continue to Verify.
Review the parsed map and telemetry preview.
Adjust Start Angle if the map orientation needs correction.
Save the circuit.

After the save finishes, the circuit appears in the Circuits table and can be selected in FastSim setup.

Circuit fields

Field	What it means	Notes
Name	Full circuit name.	Required.
Short Name	Compact label used in tables and selectors.	Required. Max 7 characters.
Notes	Team context for this circuit file or track version.	Optional.
Tags	Labels used for filtering and organization.	Optional.
Picture	Circuit image shown with the circuit.	Optional PNG, JPEG, or JPG up to 5 MB.
Circuit File	CSV data used to build the circuit preview and uploaded circuit.	Required.
Start Angle	Map rotation used when viewing the circuit.	Integer from -180 to 180. Default 0.

CSV preview support

The circuit import preview reads the uploaded CSV before the circuit is saved.

Supported preview behavior:

Comma, semicolon, and tab delimiters.
A header row before numeric samples.
Optional unit or nonnumeric rows after the header.
Old headers such as Time, Dist, VehVelX, and VehAccY.
New headers such as Trk_Time, Trk_Dist, Trk_Veh_Vel_X, and Trk_Veh_Acc_Y.
Track-map channels such as X, Y, Z, and Dist when slim track data is loaded.

The Verify step is available only when name, short name, file, and parsed data are valid.

Review a circuit

Open Circuits.
Select a circuit row.
Use the track viewer to inspect the circuit.
Open the info sheet to review name, short name, notes, track length, average lap time, creator, and created date when those values are available.

If full telemetry data is available, the circuit detail page uses the interactive track viewer. If only slim track data is available, it uses the circuit chart.

Use a circuit in simulations

FastSim setup requires a circuit. The circuit selector can include team circuits and public circuits. OpenSim uses Driver Inputs instead of Circuit.

Troubleshooting

Problem	What to check
New is hidden	Confirm your role has module create permission.
Cannot continue to Verify	Check name, short name, and CSV file. The file must parse to at least one data row.
Short name error	Keep Short Name at 7 characters or fewer.
Start angle error	Use a whole number from -180 to 180.
Circuit detail shows Failed to load circuit data	Retry the load. If it still fails, go back and confirm the circuit file is available.
Circuit is missing from FastSim setup	Confirm the correct team is active or choose an available public circuit.