Getting Started
Analyze OBD2 telemetry log files generated by FORScan for Ford, Lincoln, and Mazda vehicles. All calculations and rendering run entirely offline in your browser.
1
Load your CSV: Drag a log file into the sidebar drop zone or click it to upload. Example logs are available under the data/ folder (e.g. scan1.csv).
2
Toggle Parameter Streams: Once loaded, check parameters in the sidebar to plot them on the timeline.
3
Simulate Playback: Click the Play (▶️) button at the top to watch indicators animate dynamically.
CSV File Formatting Rules
FORScan Dive matches FORScan's standard export format. CSV files must follow these structure guidelines:
- Delimiter: Semicolon (
;) is required.
- First Column: Must be named
time(ms) representing timestamp offsets in milliseconds.
- Headers: Column names must match the format
PID(UNIT). For example: RPM(1/min), VSS(mph), CPP(%).
- Null Data: Missing samples must be indicated by a hyphen (
-) or empty field.
Example Valid Header Structure:
time(ms);RPM(1/min);VSS_CD_ABS(mph);CPP(%);FRP_ABS(psi)
0;750;0;0;38.4
100;1250;5;0;-
Telemetry Playback & Scrubbing
Walk through drive sessions and trace physical telemetry events frame-by-frame:
- Play & Pause: Click the circular Play/Pause button in the main control bar or press space.
- Speed Controls: Adjust simulation speed from 0.25x (for detailed shift tracing) up to 25x (for fast forwarding).
- Timeline Scrubbing: Drag the scrubber track directly to move the playhead across the drive.
- Chart Clicking: Click anywhere directly on the main chart area to jump the playhead to that exact millisecond.
Interactive Multi-Axis Charting
The main stream chart dynamically plots telemetry using stacked axes:
- Unit Axes: Sensors are auto-grouped onto separate Y-axes according to their units. Different scales (RPM, Voltages, Percentages) remain clean and legible.
- Pan Mode (✋): Drag left or right inside the chart to slide the window. Scroll the mouse wheel to zoom in/out.
- Zoom Box Mode (🔍): Click and drag a selection rectangle to zoom instantly into a specific window of interest.
- Reset: Click "Reset Zoom" in the chart header or double-click inside the chart to view the full log.
Configuring Gauges & Exporting Data
Leverage the gauges and statistics panel to extract deep insight from specific timeframes:
- Customize Gauges: Click the Gear (⚙️) on any of the 4 gauges. Select any numeric PID from the dropdown. The gauge dial, scale, bounds, and values update automatically.
- Recalculating Stats: Active Parameter Statistics (Min, Max, Avg) automatically recalculate to show only values inside your current zoomed timeline chart window.
- Cropped CSV Export: Zoom into a specific window (e.g. a dyno run) and click Export Zoomed CSV. This downloads a cropped, valid log file containing only the records in the zoomed window.