Tree View¶
The Tree View provides a hierarchical overview of your entire vehicle model, showing all components and their relationships at a glance. It's your roadmap for navigating through the various subsystems of your vehicle setup.

What is the Tree View?¶
The Tree View displays your currently selected vehicle configuration as a compact, flat list of rows with indentation and guide lines showing the hierarchy. Each row can be:
- Folded or unfolded with a single click, to hide or reveal its child components and the setups loaded in them
- Opened with a double-click (or the ↗ button) to go to that component's page
- Used to switch setups by opening the Setup Selector from the setup row underneath it
Quick Navigation
The Tree View is the fastest way to jump between different vehicle subsystems without using the navigation bar menus.
How to Use the Tree View¶
Navigating to Components¶
Top-level rows (Initialization, Race Conditions, Chassis, Aerodynamics, Kinematics, Tyre Sets, Suspension, Powertrain, Brakes, Track) have their own page.
- Double-click the row, or click the ↗ arrow button at the right of the row, to open that component's page
- Click the row once to fold or unfold it. The chevron on the right shows whether it is open
- The row for the page you are on is highlighted. Opening a page only highlights its row; it does not unfold it
Nested rows (for example Corner Springs or Anti-Roll Bars under Suspension) are grouping rows only. They fold and unfold but have no page of their own.
Fold State¶
- Expand all / Collapse all - the button next to the filter box (double chevron icon) unfolds or folds every row at once
- Remembered - which rows are unfolded is remembered in your browser, so the tree looks the same after you reload the page
- Filter parts - type in the filter box to show only matching rows and their parents (it matches row titles and the names and types of the loaded parts). Clear it with the x button
Opening the Setup Selector¶
Each unfolded row lists the setups loaded in it (for example FL, FR, RL, RR springs). Use the setup name and folder button on one of these rows to open the Setup Selector for that specific component. This is faster than navigating to the component first and then opening the selector.
Parent-Child Navigation¶
The Tree View shows the parent-child relationships between components:
- Parent components (e.g., Suspension) contain multiple child components
- Child components (e.g., Corner Springs, Dampers) are nested under their parent
- Click a parent row to expand/collapse it
Keyboard Navigation¶
The tree can be used from the keyboard: Up/Down move between rows, Right/Left unfold or fold the focused row (Left on a closed row moves to its parent), and Enter or Space folds/unfolds a row, or opens the page for a row that has nothing to unfold.
Warnings¶
Rows for components that are validated show a small status indicator before their name: a green tick when all checks pass, a warning icon (hover for details) when there are warnings, a red cross with "Won't run" when the vehicle has an error affecting that component, or a grey help icon when the component could not be checked because validation failed on another component first. Rows with nothing to validate show no indicator. If the vehicle has errors, the vehicle name in the page header turns red with an error icon beside it, even when the tree is collapsed; hover the icon for the error and click it for the details. A red panel at the top of the tree also lists them with a See Details button (see Tracing Vehicle Errors).
Vehicle Component Structure¶
Your vehicle model is organized into the following main components:
Core Components¶
Initialization¶
Base vehicle parameters and initial conditions: Camber, Toe, Ride heights, Gaps, Pressure, Mass
Chassis¶
Vehicle geometry, inertia, and compliance
Aerodynamics¶
Aerodynamic maps, coefficients, and balance - Aerodynamic Offsets - Wing offsets, or aerodynamic polynomial offsets
Kinematics¶
Pickup-point geometry and motion characteristics
Tyre Set¶
Tire configuration and models - Tyre Models - Individual tire characteristics and parameters
Suspension System¶
The suspension tree contains all spring, damper, and anti-roll bar components:
- Corner Springs - Front left, front right, rear left, rear right
- Heave Springs - Front and rear heave springs
- Corner Dampers - Individual damper settings
- Heave Dampers - Front and rear heave dampers
- Corner Bump Stops - Compression limiters
- Heave Bump Stops - Heave bump stop settings
- Anti-Roll Bars - Front and rear ARB configurations
Powertrain¶
Different powertrain components appear based on your vehicle type:
For ICE (Internal Combustion Engine) vehicles: - Engine - Power, torque, and engine maps - Gears - Transmission ratios - Efficiency - Powertrain efficiencies - Differential - Differential settings and maps
For EV (Electric Vehicle) vehicles: - Battery - Battery capacity and characteristics - Motor - Electric motor specifications - Gears - Transmission ratios (if applicable) - Efficiency - Motor and drivetrain efficiency - Differential - Differential settings
Brakes¶
Braking system configuration - Calipers - Brake caliper specifications
Track¶
Track selection and configuration for simulations - Ambient Conditions - Temperature, humidity, and air pressure; warns if the conditions give an implausible air density (for example a pressure in the wrong unit) - Track Layout - Track geometry
Common Workflows¶
Reviewing Your Setup¶
Use the Tree View to quickly scan which components have custom configurations:
- Click Expand all next to the filter box
- Look for components with custom names (indicating modified setups) and for warning indicators
- Double-click a row, or click its ↗ button, to review or modify
Tracing Vehicle Errors¶
When a vehicle has a validation error, you can trace it back to the exact change that introduced it. Open the error details from the red error panel at the top of the tree (See Details, or click an individual error) to launch the "When did this error first appear?" view, which scans the vehicle's version history to find the source.
The view shows:
- The version where the error was introduced — including when it was saved and who edited it — next to the last working version.
- What changed — a side-by-side comparison between the last working version and the first failing version, so you can see exactly which values changed.
- All active errors — if the vehicle has more than one error, each is listed so you can investigate them individually.
Best-guess attribution
If the source of an error cannot be pinned down with certainty, the view marks the result as a best guess and shows an "attribution may not be exact" note. Use the comparison to confirm the change yourself.