Skip to content

File Viewer

File Viewer Page

The File Viewer is your central hub for browsing, organising, and managing all simulation results and uploaded telemetry. It provides a folder-based file system with search, filtering, sorting, and bulk operations — making it easy to find the right result and load it onto the simulation desk for analysis.


Overview

Every simulation you run and every telemetry file you upload is stored as a result file in the File Viewer. Files are organised in a folder hierarchy that you create and manage, similar to a desktop file explorer. From here you can:

  • Browse results in a folder tree with breadcrumb navigation
  • Search across all files by name
  • Filter by track, vehicle, lap time range, or simulation type
  • Sort by any column (name, lap time, date, status, etc.)
  • Select files to stage in the Staging Area, move, rename, delete, or compare
  • Upload telemetry data from external logging systems

How Racing Teams Use It

  • Session management — Create folders for each test day, event, or development phase to keep results organised
  • Quick retrieval — Use filters and search to find a specific run from hundreds of results
  • Staging — Select results and add them to the Staging Area for viewing in the Trace View or Metrics page
  • Setup recreation — Recreate the exact vehicle setup that produced a result, useful when revisiting an earlier configuration
  • Comparison — Select multiple results and compare their vehicle configurations side by side
  • Bulk operations — Move, rename, or delete multiple files at once to keep the workspace tidy

Folder Structure

The File Viewer uses a folder hierarchy. Double-click a folder to open it, and use the breadcrumb trail at the top to navigate back up to any parent folder.

  • Click any segment in the breadcrumb to jump directly to that folder
  • Click the New Folder button (folder icon with plus) to create a subfolder in the current location

Search Bar

Use the search bar at the top to find results by name across all folders. Type your query and press Enter to search. The breadcrumb is replaced by Search results for “…” while a search is active, and the filter bar is hidden. New Folder stays visible but is disabled during a search ("Clear the search to add a folder"), since search results belong to no folder. The command bar stays available, so you can select search results and stage, move or delete them straight away. Clear the search to return to folder browsing.

Starred

Hover a result, sweep or folder and click the star beside its name (or use Add to starred in its menu) to star it. The Starred button beside the breadcrumb lists everything starred, from every folder, with a Location column; click it again to go back to the folder you were in. Starring does not move an item or change its order in its own folder.

Stars are shared by the whole team, so everyone sees the same Starred view. Members with the Viewer role cannot star items.

Filtering

Filter Bar

The filter bar below the breadcrumb provides targeted filtering options:

Filter Description
Track Show only results for a specific track (populated from your available tracks)
Vehicle Show only results for a specific vehicle configuration
Lap Time Set a minimum and/or maximum lap time range to narrow results
Simulation Type Show only a specific type (Lap Time, Sweep, Straight Line, Cornering, Ride, Handling (YMD), Kinematics, or Uploaded)
User Show only results launched by a specific team member — the dropdown shows each member's avatar and display name, and is searchable

Each filter has a clear button to remove it individually, and a Clear All option resets all filters at once. Filters persist as you navigate between folders, and when no results match, the table shows an empty state with a one-click Clear All.

Filter option lists may populate when you first open or interact with the filter controls. This lets large folders show their initial file list sooner while still keeping the full filter workflow available.

Sorting

Click any column header to sort the table by that column. Click again to reverse the sort direction (ascending/descending), and a third click removes the sort. The active sort column is highlighted with a directional arrow.

Resizing Columns

Drag the divider between any two column headers to resize a column; the new width is saved and persists across page reloads. Double-click a divider to reset that column to its default width. When the columns are wider than the available space, the table scrolls horizontally so no data is hidden.

The default sort is by Age / recent activity, with the most recently updated files and folders first.


The Results Table

The table displays one row per file or folder with the following columns:

Column Description
Type Simulation type icon and label (Lap Time, Sweep, Straight Line, Cornering, Ride, or Uploaded)
Name File or folder name. Names in bold indicate files currently loaded in the Staging Area
Vehicle The vehicle configuration used for this simulation
Track The track used, with a version badge showing which version of the track setup produced the result (hover to see the full name if truncated)
Lap Time The simulation lap time, formatted as mm:ss.sss
Warnings Warning count with hover card showing details by severity
Errors Error count with hover card showing error messages
Status Simulation status — preparing (sweeps building their vehicle variants), in progress (with pulsing indicator), completed, partial success, or failed
Age Relative age of the file or folder. Folder age updates when new simulation results are added inside it (hover to see the full timestamp)
Ambient Ambient conditions setup used for the simulation, with a version badge, showing temperature, pressure, and wind. Hidden by default — toggle on via the column visibility menu
Notes Simulation notes or sweep configuration summary (hover to see full details). Folders can carry notes too, edited the same way. A sweep's header row shows and edits the note for the whole sweep, and each run underneath carries its own note alongside its swept values. Editing a run's note shows the sweep's note above it for reference

Selecting Files

Click a row to select it. Selected rows are highlighted in purple.

Action Behaviour
Click Select a single row (deselects others)
Ctrl/Cmd + Click Toggle a row's selection without affecting others
Shift + Click Select a range from the last selected row to the clicked row
Select All Button above the table selects all files in the current folder, including files you haven't scrolled to, in one step
Escape Clears all selections

The Command Bar

Command Bar

When one or more rows are selected, the filter bar is replaced by a command bar showing the selection count and available actions:

Action Description
Compare Compare the vehicle setups of the selected results (see below). To compare their performance, stage them instead — see Comparing Simulation Results
New Folder Create a new folder in the current location
Upload Open the telemetry upload dialog
Stage Sim Load the selected files into the Staging Area for analysis
Download Download selected files as a zip (works for folders and multi-file selections)
Add Video Add one onboard video to the selected uploaded laps of a run, cut into a clip for each lap (see below)
Rename Rename the selected item (single selection only)
Move Move selected items to a different folder
Delete Delete selected files and/or folders with confirmation

File Actions

Staging Results

The Staging Area is the workspace where you load results for analysis. There are two ways to stage files:

  • Double-click a file to toggle it in/out of the Staging Area
  • Select files and click the Stage Sim button in the command bar

Staged files are shown with their name in bold in the file viewer. Once staged, switch to the Trace View, Metrics, or Parallel Coordinates pages to analyse them.

Each staged row also carries a note icon, so you can add or edit a result's notes while you are comparing it rather than returning to the Notes column here. It opens the same editor, and changes save immediately and appear in both places.

Staging a Sweep

Sweep runs are grouped under a header row showing the sweep's name and its run count, for example 45 runs and "3 failed". Click the run count to list its runs. The traces of every run are ready as soon as the sweep finishes — there is nothing to fetch before they appear in the Trace View.

The button on the header row stages the whole sweep in one go. Its label tells you what it will do:

Label Meaning
Stage all Stage every run of the sweep
Stage N successful Some runs failed; stage the N that succeeded
No successful runs Nothing in this sweep can be staged
Unstage The sweep is staged; remove its runs from the Staging Area

Double-clicking the header row also stages it. Staging covers every successful run, including runs you have not scrolled to yet. The header's ⋮ menu offers Stage successful runs / Unstage sweep, Select successful runs only to select just the runs that succeeded (for example, to move or compare them), and Export N successful runs to export them (see Exporting Results).

While a sweep still has runs in progress, the header shows an in-progress count and staging is blocked until it finishes.

The Stage Simulations picker in the Staging Area groups sweeps the same way: each sweep sits under one collapsible header, closed by default, showing its name and run count. Click the chevron to show its runs. Click the header to select its successful runs, or double-click to stage them. A sweep with runs still in progress cannot be staged whole until it finishes.

Multi-lap Results

A result holding more than one lap — a session upload, or a simulation run over several laps — is one row, with a lap count in front of its name (for example 20 laps) and the time of its fastest full lap. Click the lap count to open its lap table under it, one row per lap with its lap time; the fastest full lap is highlighted, and a lap much shorter than the others is labelled Out lap or In lap (or Partial in the middle of a session). Labelled laps are only labelled: they are listed, staged and compared like any other, but a session's time is its fastest full lap.

The lap table's columns follow AiM Race Studio's: each lap shows its time as a percentage of the fastest full lap (100.0% for the fastest), and its slowest (min), average (avg: lap distance over lap time) and fastest (max) speed, in the unit your Trace View shows speed in. Speeds need a speed channel (vCar); the average also needs distance.

  • Double-click the result (or drag it onto the Staging Area) to stage it as its laps, every lap shown — or, for a long session, as many as the Trace View can draw beside what you already have shown (ten traces in all), full laps first. Tick the others in the Staging Area to swap them in. Switch it to Session in the Staging Area to see it as one trace.
  • Double-click a lap (or click the eye on its row) to stage the result with just that lap shown. Do the same to other laps to add them; hiding its last lap unstages the result.
  • Click a lap to select it like any other row (Ctrl/Cmd-click or Shift-click to select more), then click Stage Sim in the command bar to show the selected laps. Laps can also be exported from the command bar.

In the Staging Area a multi-lap result has a Session | Laps switch:

  • Session draws it as one trace, every lap end to end, with its laps marked along the x-axis. Where laps were left out at upload, the trace breaks over the gap instead of joining the laps either side.
  • Laps lists every lap under the result, each with a checkbox to show it. A shown lap is drawn as a result of its own, starting from 0 m and 0 s, so laps overlay: each has its own colour, can be the reference for Δ time, appears on the track map and in the Metrics table (with its own lap time and math metrics; the run's solver metrics belong to the whole run, not one lap), and exports as its own CSV.

Runs of a sweep aren't split in the file viewer, but a staged run can be switched to Laps the same way. The Stage Simulations picker in the Staging Area lists a result's laps the same way: click laps to select them for Stage, or double-click one.

Results uploaded with the old One result per lap option stay as they were: one result per lap.

Sharing Results with Your Team

To send a result to a teammate, hover its row and click Copy Link (or select files and use Copy Link in the command bar). A sweep's header row offers Copy link to sweep, and the Staging Area's ⋮ menu offers Copy link to staged. Anyone in your team who opens the link has those results staged and lands on the Trace View — or the Sweep page, for a sweep link. Links only work for members of the team that owns the results.

Exporting Results

Hover over any file row to reveal the Download button (download icon). Click it to export all data channels for that result as a file for external analysis. You can export in the standard ARD CSV format or a MoTeC-compatible CSV format for workflows that continue in external data analysis tools.

To download multiple files or an entire folder at once, select them and click the Download button in the command bar — everything is packaged into a named zip file, with a metrics.csv summarising every result beside the per-result trace CSVs.

A folder is exported with its subfolders, and the zip keeps the same folder structure. Subfolders more than 5 levels below the folder you selected are left out and listed when the export finishes; select one of them and export it on its own to get its contents. One export can include up to 5,000 results.

To export a whole sweep, choose Export N successful runs from its header row's ⋮ menu once it has finished running. This exports every successful run of the sweep — including runs you have not scrolled to yet — with either the visible channels or all of them, in ARD or MoTeC CSV format. Once a sweep is staged, Export all staged in the Staging Area's ⋮ menu does the same for everything staged, not just the results shown in Trace View.

By default (Units: User defined), channels are exported in the units you've set for them in Trace View, so a speed you've switched to mph is exported in mph. To export in SI units instead, set Units to SI at the bottom of any export menu. The choice is remembered and also applies to the Download buttons. Temperatures are always exported in °C.

A MoTeC CSV is resampled to a constant time step, so MoTeC's timeline and lap time match ARD's. Pick the rate with MoTeC rate (50, 100 or 200 Hz; 50 Hz by default) at the bottom of any export menu. Channels are interpolated between samples, except gear, lap, sector and on/off channels, which hold their last value. Where there is no data, such as laps left out of the export, the rows are left empty. Standard writes the result's own samples instead, which are evenly spaced in distance, not in time, so MoTeC's timeline is only approximate.

A notification shows the export's progress and lets you cancel it. In Chrome and Edge you choose where to save the zip before the export starts. Other browsers can't export more than about 1 GB at once — if you hit that limit, export fewer channels or results, or use Chrome or Edge. Results that are still running, or that have no channel data to export, are left out and listed when the export finishes.

Visible math channels are included in exports, so calculated channels you create in Trace View can be carried into offline analysis. They are calculated for every exported result, over the same laps and x-axis as Trace View, and written in the unit you gave them. If a math channel can't be calculated for a result, the export finishes without it and tells you which channel was left out.

Creating Tracks from Results

If a result contains enough track information, you can create a Track setup directly from the result file. This is useful when telemetry or imported data already contains the circuit geometry and you want to run simulations on that same layout.

Create Track from Data in an uploaded result's ⋮ menu opens the Track page's upload wizard with the result's channels already selected, so you map, preview and create the track exactly as for any other upload. The new track is linked to the result if it has no track yet.

It works when the result includes one of the supported channel combinations:

  • Distance and curvature (sRun and cRaceline)
  • X and Y position (xCar and yCar)
  • Speed, distance, and lateral acceleration (vCar, sRun, and gLat)

Recreating a Vehicle Setup

Hover over a file row to reveal the Recreate Setup button (plus + car icon). This creates a new vehicle configuration that exactly matches the setup used when the simulation was run. This is useful when:

  • You want to return to a previous configuration after making changes
  • You want to use a known-good setup as a starting point for further development

This action is not available for uploaded telemetry, since there is no vehicle setup behind an upload to recreate.

Recreating a Simulation Configuration

Select a single finished result and click the Recreate Simulation button (line chart icon) in the command bar, the row hover actions, or the right-click context menu (also available from the Staging Area). This takes you straight to the correct simulation page — Lap Time, Sweep, Straight Line, and so on — with the configuration pre-filled exactly as it was when that result was produced, including its name, parameters, target folder, and the exact vehicle, track, and ambient conditions used at the time. You can then tweak and relaunch a follow-up run without rebuilding the setup by hand.

This action is not available for uploaded telemetry, since there is no simulation configuration behind an upload to recreate.

Older sweep formats

A small number of older sweep results use a legacy configuration format that cannot be rebuilt. For these, a warning is shown instead of applying a broken configuration, so you can reconfigure the sweep manually.

Linking Uploaded Results to a Setup

Uploaded telemetry has no vehicle behind it, but you can link it to the library Vehicle, Track and Ambient conditions it was logged with. You can set this during the upload (Step 4: Result setup) or afterwards from the file list:

  • Single result — open the row's ⋮ menu and choose Set Result Setup
  • Several results — select uploaded results and click the Set setup button (link icon) in the command bar

Pick a component for each field, or clear it with the ×. When the selected results disagree on a field it reads Mixed — unchanged, and it stays as it is unless you pick something else. Linking a track that has been placed on a map turns on the satellite overview for the result. Creating a track from an uploaded result (see above) links the new track to that result automatically.

Adding a Video to an Uploaded Result

An uploaded result can carry an onboard video, which plays in sync with its data in the Trace View's video cell. Open the result's ⋮ menu and choose Add Video. Once it has one, the same menu offers Re-sync Video, Replace Video, Download Video (the file as it was uploaded, under its own name) and Remove Video, and a video icon beside its Upload badge plays it.

A multi-lap result gets a clip per lap: Add Video on the result takes one video of the whole session, lined up once, and cuts it into a clip for each lap it covers. Each lap's row then has its own ⋮ menu — Play, Re-sync, Replace, Download and Remove Video for that lap's clip, or Add Video for a lap without one, so laps can have clips from different videos (a camera that split the recording, or footage of only some laps). To give several laps clips from one video, select those laps and click the camera in the command bar: the video is lined up once against the session and cut into a clip for each selected lap. A camera icon on a lap's row plays its clip, as it does on the result's own row. The result's own menu offers Replace Videos and Remove Videos for all of its clips at once.

Adding a video takes three steps, all in your browser until the last:

  1. Pick a video: MP4, MOV or WebM, of any length. There's no need to cut it first.
  2. Line it up with the data on the timeline — see below.
  3. Upload the part of it you kept, up to 4 GB (for a run, up to 4 GB a lap).

Results uploaded earlier with the old One result per lap option are a result per lap: to add one video to every lap of such a run, select its laps and click Add Video in the command bar. The laps are placed where they were in the run they were split from, so they can be any laps of the same upload (Run 1 - Lap 3, Lap 5 and Lap 9, say), with the laps left out as gaps on the timeline. Laps uploaded before this was recorded are placed end to end instead, so for those they must be laps in a row. You line the video up once and every lap it covers gets its own clip; a lap that already has a video gets the new one instead.

Lining a Video Up

The timeline works like a DAW lining up two tracks. The data runs along the top lane — pick any channel of the result from the list above it, with each lap marked — and the video sits in the lane below as a clip, drawing the pitch of the engine heard in it — a line that rises and falls with the RPM trace when the two are lined up. The playhead moves both together.

Auto sync listens to the engine in the soundtrack, matches its pitch against both nEngine and the gear changes in NGear, and places the clip by whichever of the two stands out more, since a logger's RPM channel isn't always the engine's own. It runs as soon as the timeline opens and takes a few seconds, or up to a minute for a long video. The timeline waits for it while it runs, so a clip you place meanwhile isn't moved under you. To line it up yourself instead, choose Line it up by hand instead: its answer then waits until you choose Use it. Play it back to check.

When no match stands out clearly enough to trust, auto sync says how close its best guess came and offers Try it. The line under the timeline reads Not lined up yet in amber until the clip is placed, and turns green once it is.

To line it up by hand, drag the clip along the data until a moment you can spot in both lines up — a gear change, a braking point, the start line — then play it back to check, and nudge it if it's a frame or two out.

Control Does
Drag the clip Slides the video against the data
Nudge video buttons The same, by ±1 s, ±0.1 s or one frame (1/30 s)
Click or drag the ruler or the data Moves the playhead, and the video with it
Scroll / sideways scroll Zooms the timeline / pans it; the Overview strip below shows all of it, and dragging its box moves along
Drag anything to the timeline's edge Scrolls the timeline, faster the further out you go
The clip's edge handles Choose what to keep: by default the data plus 3 seconds either side. The part cut off is hidden until you drag the edge back out over it. An edge snaps to the start or end of the data, a lap's start and the playhead
Space · ← / → · ⌥ + ← / → Play or pause · step the playhead a frame (Shift: 1 s) · nudge the video a frame (Shift: 0.1 s). They work wherever the focus is in the dialog

The sync is saved as the point in the video where the data starts, shown as, for example, "Data starts at 0:05.502 in the video". Choose another video goes back a step; keeping the same video there keeps the clip where you placed it. Re-sync Video opens the timeline on the uploaded video, without the cut. Auto sync there downloads the uploaded video to listen to it, so it is offered for videos up to 1 GB; line a larger one up by hand.

Videos count toward your team's result storage. A video that would take your team past its limit is refused before it uploads, and checked again once it has, in case other uploads filled the space meanwhile.

Permissions

Only uploaded results can have a video. Team viewers can play videos but not add, change or remove them.

Moving Files

Select one or more items and click Move to open the move dialog. Navigate the folder hierarchy using breadcrumbs, then confirm the destination. The system prevents circular moves (you cannot move a folder inside itself or its children). After moving, a toast notification shows the exact destination path — for example, "Moved folder 'Q1 Setup' into Root/Event 2026/Silverstone".

Renaming

Select a single item and click Rename to change its name. The dialog shows the current name and lets you type a new one.

Deleting

Select items and click Delete to remove them. A confirmation dialog appears before deletion.

Deleting simulations or folders that are in the Staging Area also removes them from it.

Folder Deletion

Deleting a folder also deletes all files and subfolders inside it. This cannot be undone.

Result Storage

Your plan includes a fixed amount of result storage, shared by everyone in your team. The meter at the top of the File Viewer shows how much your team's results take up and how much your plan allows.

The meter turns amber at 80% and red, with Storage full, at the limit. Hover it for an explanation. It refreshes when you press Refresh, when a simulation completes, when you delete results and when you add or remove a video.

When storage is full, new simulations are blocked until you delete some results or upgrade your plan. A simulation that is already running, including a large sweep, always finishes, even if it takes you over the limit — it is the next one you start that is blocked, with a message such as You have reached your result storage limit of 10.0 GB. Delete some results or upgrade your plan to run more simulations. Deleting results frees space immediately.

Only results that store trace data count toward storage, along with any videos attached to uploaded results. Ride, Handling (YMD), Kinematics and vehicle-properties results use none. A typical lap simulation stores about 1 MB; an onboard video is usually hundreds of MB.

A video's size is known before it uploads, so unlike a simulation, a video that would take your team over the limit is refused before it starts. Replacing a video frees the space of the one it replaces.

Plan Result storage
Free 25 MB
Trial 250 MB
Consultant 10 GB
Team 25 GB
Team+ 50 GB
Enterprise 250 GB
Formula Student 50 GB

Comparing Simulation Results

To compare how two (or more) simulations performed — lap time, speed traces, ride heights, tyre loads:

  1. Add each result to the Staging Area (double-click it, or select them and click Stage Sim)
  2. Open the Traces tab (or click View Traces in the Staging Area) to overlay their channels and enable Time Delta — see Comparing Two Simulations
  3. Open the Metrics tab to compare lap time and other scalar metrics in a table — see Metrics

The Compare button does something different: it compares the vehicle setups the results were run with, not their outputs (see below).


Comparing Configurations

Vehicle Compare

Select one or more results and click the Compare button to open the vehicle configuration comparison view. This answers what was different about the cars — use the Staging Area and Trace View to see how differently they performed. This is covered in detail on the Vehicle Compare page.

When comparing multiple results, the view highlights only the differences between configurations, making it easy to spot what changed between runs.


Warnings and Errors

Warnings

Warnings Hover Card

The Warnings column shows a count of simulation warnings. Each warning states what it means and how to address it. Hover over the column to see a summary listing each warning's severity (critical, warning, or info), its warning code, and the exact field it relates to. Click the copy icon on any warning to copy its details to your clipboard, or click the expand button to open a full-screen view with all warning details.

Warnings indicate situations where the simulation completed but encountered conditions worth reviewing — for example, a tyre operating beyond its validated slip angle range, or a bump stop that engaged unexpectedly.

Errors

The Errors column shows a count of simulation errors. Hover to see the error messages. Errors indicate conditions that prevented part of the simulation from completing normally.


Infinite Scroll

The file viewer loads results in pages as you scroll. A status bar at the bottom shows how many results are loaded out of the total (e.g., "Showing 50 of 237 results"). Scroll down to load more automatically.

Select All selects every file in the folder in one step, including files you haven't scrolled to, so it stays fast on large folders. Stage selected still skips runs that failed.


Tips & Best Practices

Organise by Event

Create a folder structure that mirrors your testing calendar — for example, a top-level folder per event, with subfolders for each session (Practice, Qualifying, Race setup). This makes it easy to find results months later.

Use Notes

Add notes when running simulations to record why you ran them and what you expected. The notes appear in the file viewer and in the Staging Area — where you can also edit them — and make it much easier to understand old results when you revisit them.

Staging a sweep

Use the button on the sweep's header row rather than selecting runs by hand. It stages every successful run — failed runs are skipped — and works however far you have scrolled.

Double-Click to Stage or Drag to Stage

The fastest way to view a result is to double-click it in the file viewer or drag it into the Staging Area. This stages it and you can immediately switch to the Trace View or Metrics page.

Recreate Setup for Baseline

Before making experimental changes, use Recreate Setup on your current best result to create a snapshot of the configuration. This gives you a clean baseline to return to if the experiment does not improve performance.

Filter by Lap Time Range

When reviewing a large number of sweep results, use the lap time filter to hide outliers and focus on the competitive window. This is faster than sorting and scrolling through hundreds of rows.