Skip to content

Results Upload (Telemetry)

Upload Dialog

The Results Upload feature lets you import real-world telemetry data from your data logging system into ARD. Once uploaded, telemetry can be overlaid with simulation results in the Trace View for correlation, validation, and driver analysis.


Overview

Telemetry upload is a guided, multi-step process that takes you from a raw data file to a fully mapped result in ARD. The system handles:

  • File parsing — Reads CSV, Excel, and other tabular formats (including multi-sheet workbooks), plus native AiM .xrk and .xrz logs
  • Channel detection — Automatically identifies common channels (speed, distance, g-force, etc.) from column names
  • Unit mapping — Lets you specify the unit for each column so ARD can convert to its internal SI representation
  • Postprocessing — Options for lap selection, distance zeroing, and data cleaning
  • Track creation — Optionally generates a track layout from the uploaded telemetry

How Racing Teams Use It

  • Simulation correlation — Upload logged data from a test day and overlay it with simulation results to validate the vehicle model
  • Driver analysis — Import telemetry to view speed traces, g-g diagrams, and ride height data alongside simulation predictions
  • Track creation — Generate a track layout from GPS or curvature data in the telemetry, avoiding manual track entry
  • Baseline comparison — Upload a reference lap and compare it against simulated setups to quantify improvements
  • Data archiving — Store telemetry alongside simulation results in the same folder structure for easy retrieval

Supported File Formats

Format Extensions Notes
CSV .csv Comma-separated values
TSV .tsv, .txt Tab-separated values
Excel .xls, .xlsx Multi-sheet support — select which sheet to use
PRN .prn Fixed-width or space-separated
Racelogic VBOX CSV .csv VBOX exports are normalized automatically, including inline units, degree-minute GPS coordinates, and lap information when available
AiM native log .xrk, .xrz Upload the logger file directly, with no Race Studio CSV export. Channels are mapped like an AiM CSV export, and a Lap column is built from the logger's lap markers so you can select laps. Channels the logger didn't record, such as Race Studio math channels, won't be present

The maximum file size is 50 MB. Large files are uploaded in chunks with a progress indicator.

Time column parsing

Telemetry uploads support standard numeric time values, clock-style values such as 1:20.612, and logger exports where a colon is used as the decimal separator, such as 1:005. If a mapped column contains a value that cannot be parsed as a number, the upload error names the affected column.

Decimal separator

Files that use a comma as the decimal separator (194,5) are detected and converted automatically on import, so exports from European loggers and spreadsheet settings upload without a re-export. Periods (194.5) work as they always have.


Upload Workflow

The upload is five steps in one dialog: Files, Map channels, Review, and an optional Result setup and Video. The step indicator in the header shows where you are, and Back never discards work — files keep uploading and the mapping keeps every edit.

Step 1: Files

File Selection

Drag and drop one or more files onto the dialog, or click to browse. A single file uploads, is analysed and opens the mapping step by itself. Several files (or an Excel workbook) stay on the file list while they upload and analyse in the background, so you can name each result, pick sheets, or keep adding files while bytes are in flight. Each row shows its size, column count and row count once analysed, with controls to retry or remove an individual file without abandoning the batch. Back from the mapping step returns to this list to add files to a single-file upload.

You can upload a whole batch in one session — each file becomes its own result, and an Excel workbook expands into a checkbox per sheet so you can pick which sheets to bring in; sheets with no numeric columns are left unchecked.

If a sheet has none of the columns you mapped, the upload for that file stops with a message naming the sheet. Map at least one of its columns, or untick the sheet, and submit again — the file does not need to be re-uploaded.

If a file's columns look nothing like the rest of the batch, the step says so and blocks it — that file belongs in its own session. A file that merely differs by a column or two is allowed through with a warning naming what will be left unmapped.

Importing from Google Drive or SharePoint

Import from Google Drive or OneDrive / SharePoint

Files kept in Google Drive, OneDrive or SharePoint don't need downloading first. Under the drop zone, Or import from offers Google Drive and OneDrive / SharePoint. Pick one and sign in to that account (only the first time in a session), then choose files in its own file browser. They join the upload just as dropped files do. Shared drives and SharePoint document libraries can be browsed too, and the next import opens in the folder the last one came from.

The same buttons sit under every other upload in ARD: tracks, .tir files, curve tracer images and onboard videos. Import JSON buttons, such as the one in the setup selector, offer them in a menu.

The Import JSON menu

A Google Sheet comes in as an Excel workbook, so each of its sheets can become a result. ARD only reads the files you pick. Nothing is linked to your ARD account, and signing out of ARD makes it forget both sign-ins.

Google Drive in Firefox

If the Google Drive window says "The API developer key is invalid", Firefox's tracking protection is blocking Google's cookies inside ARD. Click the shield icon to the left of the address bar, turn off Enhanced Tracking Protection for ARD, and try again. Browsers that block third-party cookies, such as Safari, may need the same.

Resuming Incomplete Uploads

If you have incomplete upload sessions from the last 24 hours, they appear above the drop zone before you add any files. Click Resume to continue where you left off — your channel mappings and unit selections are preserved. Click the × to discard a session permanently.

Step 2: Map channels

Column Mapping

Every column in your file is matched to an ARD channel and a unit. Auto-detection has already run by the time the step opens, so the job is to review — and the Values column is what you review against.

One mapping covers the whole batch

When you upload several files in one session, a single column mapping is applied across all of them, matched by column name. Every file in a session must therefore follow the same column layout. A column present in only some files is left unmapped for the others (you are warned which); a file that shares no columns with the rest has to be uploaded separately.

The Mapping Table

Each row represents one column from your file:

Column Description
Source column The header as written in your file. A column auto-detection could not decide is marked with the number of candidates it found
Channel The ARD channel this column becomes (e.g. vCar for speed, sRun for distance). Opens a searchable list showing every channel's unit and description, with the best candidates for this column at the top
Unit The unit the source data is in. ARD converts to SI on import
Flip / Zero Invert the sign, or subtract the first value so the channel starts at zero
Values A sparkline of the analysed rows with their minimum, maximum and mean. This is how you tell km/h from m/s, or a lap counter from lap distance, at a glance. Click the sparkline to open the column as a full plot

Auto-detection

Column headers are matched to channels by meaning, not by spelling. Vendor prefixes (A_, M_), processing suffixes (Corrected, LPF), corner and axle grammars (FL, LF, Front Left, Front) and the usual synonyms (RH for ride height, SWA for steering wheel angle, pot for damper) are all understood, and the file's own unit text and value range are used to keep look-alike quantities apart — a column in bar is never offered as an angle, and a column that does not increase is never sRun.

  • A channel is pre-selected only when the match is confident. Otherwise the column stays unmapped and the channel list shows the candidates it considered, with the reason for each.
  • When two channels fit equally well (a "3rd element load" could be the heave spring or the heave damper force), nothing is pre-selected and the row is marked 2 candidates — the choice is yours.
  • A channel is never pre-selected for two columns. A low-pass-filtered copy of a column loses to the raw one and stays unmapped.

Units

The unit text in your file is read in any common spelling (deg, °, kph, mph, m/s2, rpm, G, degC…). The border of the unit box tells you where the unit came from:

Border Meaning
Plain Read from the file
Dashed Inferred or assumed — the file declared no unit. Where the value range settles it (an acceleration peaking at 3 is in g; a ride height of 0.04 is in metres) the unit is inferred from the values; otherwise the channel's default is assumed. Either way, check it against the Values column
Amber The file declared a unit we could not read (hover to see the text). You must confirm the unit before continuing
Red The unit cannot be converted for this channel. You must change it before continuing

Changing a column's channel re-reads its unit from the file, so a hand-picked unit never survives onto a different quantity.

Custom channels

A column with no ARD equivalent — an oil cooler temperature, a fuel rail pressure — can be kept as a custom channel instead of skipped. Map to an ARD channel whenever one fits: only ARD channels line up with simulation results.

  1. Open the column's channel list and click Not an ARD channel? Create a custom channel at the bottom.
  2. Check the name. It starts as the column header with anything but letters, digits and underscores removed (Oil Temp (Cooler) becomes OilTempCooler). The form also points out the closest ARD channel if there is a good one.
  3. Pick its unit in the unit column. Every unit is offered, with search. The values are converted to SI like any channel's, and the unit you pick is the one the channel is shown in.

A name cannot be an ARD channel's (in any capitalisation), a word the math channel language uses (max, x, if, …), or the name of one of your team's math channels — expressions read custom channels by name, so those would hide it.

Custom channels belong to your team. Later uploads list them under Custom channels, above the ARD channels in the channel list, and a column with the same name (spaces, punctuation and case aside) is mapped to one automatically. Two custom channels cannot differ only in case. Mapping to an existing custom channel offers only units of its quantity, so every result stores it the same way.

On the results desk, custom channels are on the Custom tab of the channel picker. It lists the custom channels of the results you have staged, plus any already on your layout. A result without that channel shows no data for it. They can be referenced in math channels and are included in exports.

To change a custom channel's unit or delete it, open Visualization Settings on the traces page and go to Custom Channels. Values are stored in SI, so a change within the same quantity (°C to °F) only changes how they are shown. A change to a different quantity (unitless to bar) makes results already uploaded with that channel show bad data. Re-upload them after the change.

Deleting a custom channel leaves its values in the results that have it, but they no longer list it. Deleting results never deletes a custom channel.

Where the mapping comes from

A line above the table says what auto-detection managed ("Auto-detected 34 of 42 columns") and offers the alternatives:

Action Description
Use that mapping Shown when an earlier upload of the same format exists: the one covering most of this batch's columns is named, with the count it covers. One click copies its channel and unit assignments. Nothing is applied without the click, and the choice is remembered so the button leads next time
Use a previous mapping… / Other uploads… Choose any earlier upload from a searchable list, each scored by how many columns it covers
Re-detect Re-runs detection over the whole batch and replaces your edits
Clear all Starts from an empty table

Suggest with AI

When enabled on your server, Suggest with AI sends the columns auto-detection could not place — the header, declared unit, value range and first 6 values of each, nothing else from the file — to Anthropic's Claude together with the channel catalogue, and returns one suggestion per column. Anthropic does not train its models on this data. Suggestions appear on the rows as a highlighted proposal with a confidence and a one-line reason; nothing is applied until you click Accept (or Accept all on the bar above the table). Columns that already have a channel are never sent, and a channel already in use is never suggested.

The first time you click it, ARD shows what will be sent and asks before sending anything: Send to Claude or Turn off AI suggestions. Turning it off hides the button; switch it back on under Settings → User Settings → AI channel suggestions. Each user can make 20 requests a minute and 300 a day (a request covers up to 40 columns).

Filters and Bulk Operations

  • All / Unmapped / Needs attention — Filter the table. Needs attention collects columns with an unconvertible unit, a channel mapped twice, an unreadable unit text, an undecided auto-detection or a pending AI suggestion
  • Search — Filter rows by source column name or mapped channel name
  • Sort — Click Source column or Channel to sort
  • Select — Tick rows (Shift-click for ranges) and Skip selected to clear their mappings at once
  • Channel reference — Opens the naming convention guide listing every channel with its unit and description

Keyboard Navigation

Key Action
Arrow Up/Down Move focus between rows
Enter Open the channel list for the focused row
Space Toggle row selection
Shift + Click Select a range of rows

Warnings

Problems are listed in a strip above the table, each a click away from the row it concerns:

  • Mapped twice — Two columns share a channel. Click the channel name to show only those rows. One column per channel; you cannot proceed until it is resolved
  • Unit can't be converted — A column's unit is not one the converter can apply to its channel. Pick another unit
  • Unit text not recognised — The file declared a unit we could not read. Confirm the unit (the assumed one included) before continuing
  • No distance, time or speed channel — Without sRun, tRun or vCar the result is hard to plot. You can still upload
  • Lap column without distance — A column is mapped to NLap but nothing to sRun; the column may actually hold lap distance. NLap must be a lap counter (1, 1, 2, 2, …)

Step 3: Review

Finalize Step

This step names the result, chooses laps and shows a preview. Click Next to continue to the result setup. The preview is decimated to chart resolution but always spans the whole file, so a 4.5 km lap plots as 4.5 km.

Result Name

Enter a name for the uploaded result. This is how it will appear in the File Viewer. When the batch holds more than one file, each has its own name, and a file switcher lets you review every file's preview before uploading. If two results would end up with the same name, the step flags it and offers a one-click Make names unique fix. If a name is already used by a result you uploaded earlier, the upload of that file stops and you can either rename it or tick Overwrite the existing result (or Overwrite all for every clash) and upload again. Overwriting deletes the old result and replaces it with the new one. Locked results and results delivered through a bundle can't be overwritten, only renamed around.

Summary

File name and size, the number of rows the result will hold after processing, and the channels it will contain (expandable).

Laps & processing

  • Start distance at 0 — Subtract the first distance value (recommended for clean overlay with simulation data)
  • Lap selection — Choose which laps to keep. The fastest lap is highlighted. The laps you keep stay together in one result, keeping their numbers: the File Viewer lists them under it, and the Staging Area can show the whole session or each lap on its own, so there is nothing to decide about splitting here

Preview

The chart plots one mapped channel against distance, time or speed, in the same units the results desk uses — the axis label is a promise about the upload, not a restatement of the file. If the preview looks wrong, the unit on the mapping step is wrong; go back and fix it there. The preview updates as you change laps and options.

Non-Sequential Distance

If the data contains rows where distance values go backwards (e.g., from a logger reset), the summary shows how many rows will be dropped. This ensures clean, monotonically increasing distance data. Distance logged in whole metres at several samples per metre is not dropped: the repeated values are spread evenly (by time where the file has it) up to the next step. If more than a fifth of the file would be dropped, the step warns you outright — that usually means the column mapped to sRun is not cumulative distance.

Step 4: Result setup (optional)

The last step asks What was this logged with? Link the library Vehicle, Track and Ambient conditions the data was recorded with — for every result in the upload when you are uploading several files. Linked results carry that setup alongside them, and a track that has been placed on a map turns on the satellite overview.

Click Upload (or Upload N files for a batch) to upload with the links, or Skip to upload without any. Both are fine — you can set or change the links later from the file list; see Linking Uploaded Results to a Setup.

If part of a batch has already landed with these links, the rest use them too and Skip is not offered.

Step 5: Video (optional)

Once the results exist, each uploaded file is listed with Add video, for the onboard video it was logged alongside. Pick the video of the whole run and line it up with the data once, on the same timeline as adding a video to a result.

When the file holds more than one lap, the timeline shows the whole run with its laps marked, and the upload cuts the video into a clip for each lap the video covers — the lap plus a few seconds either side — so every lap plays its own part of the video in sync, whether the session is shown whole or lap by lap. A lap the video doesn't reach, or holds only the last few seconds of, is shaded on the timeline and gets no clip.

Click Done to finish, or Close — the results are already uploaded either way.

Done

Upload Complete

Once the upload finishes, the dialog lists every result created — one per file, or more where a workbook was split by sheet. For a single result whose channels allow it, a track can be created from the data here; tracks are otherwise managed from the track setup pages.

Creating a Track

When the upload produced a single result, a Create a track from this data panel appears with a Create track button. It takes you to the Track page's upload wizard with your file already selected — the same wizard as New track → Upload your data — where you map, preview and create the track. Excel workbooks and AiM .xrk/.xrz logs, which the track upload can't read, use the result's stored channels instead, as Create Track from Data in the results library does; a result carries only mapped channels, so columns such as elevation don't come along that way. It is offered when the mapped channels include any one of:

Channels Track built from
xCar and yCar Position
sRun and cRaceLine Distance and curvature
sRun, vCar and gLat (or nYaw) Distance, speed and lateral acceleration

You can also create one later from the result's ⋮ menu in the results library with Create Track from Data.

Create a Track While You're Here

If you plan to simulate on this circuit and don't already have a track setup, creating one from telemetry is the fastest way. The generated track captures the actual circuit layout including elevation and curvature, which is more accurate than manual entry. When the file has GPS latitude and longitude, the track is placed at its real location on the map, so satellite imagery lines up straight away. Unless you picked a track during the upload, the new track is also linked to the uploaded result it came from, so you don't need to set it again in the file list.


Tips & Best Practices

Consistent Naming

Use a consistent naming convention for uploaded results — for example, include the driver, session, and date (e.g., "Driver A - FP1 - 2024-03-15"). This makes results easy to find later in the File Viewer.

Map the X-Axis Channel

Always map at least one x-axis channel (sRun for distance, tRun for time, or vCar for speed). Without one of these, the data cannot be plotted in the Trace View.

Check Units Carefully

The most common upload issue is incorrect units. If speed is in km/h but mapped as m/s, all values will be off by a factor of 3.6. Read the Values column against the unit — a speed column with a maximum of 300 is km/h, one with a maximum of 85 is m/s — and give dashed (assumed) units a second look.

Reuse Previous Mappings

If you regularly upload files from the same logging system, use Start from → A previous upload on the mapping step. This reuses the channel and unit assignments from a prior upload of the same format.

Resume If Interrupted

If you close the browser or navigate away during an upload, your session is preserved for 24 hours. Return to the upload dialog to resume where you left off.

Use the alignment tool

If your telemetry and a simulation result look shifted against each other when overlaid, use the Align button in the Trace View toolbar — see Distance Alignment.