| [](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/0GVHiuTrYl5GtALC-screenshot-2025-02-27-at-3-49-39-pm.png) | [](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/RscRGxBPS2wG4mtl-screenshot-2025-02-27-at-3-48-02-pm.png) |
| [](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/jVEV1IIbICgdhr1f-screenshot-2025-02-27-at-3-51-19-pm.png) |
|
To open the Data Logging window, press **Control + D** (**Cmd+D** on MacOS) or click the  button in the Atlas toolbar.
The Atlas Datalogger makes recording and viewing datalogs easy. At a high level, these are the headline features of the Atlas data logging ecosystem and why we think you should use it: - Snappy, hardware-accelerated, optimized data and graphics pipeline based on OpenGL capable of easily presenting and navigating logs in excess of 30 minutes in length at any polling rates. You can load up our data-logger with well over 100,000 data-points on commodity hardware with next-to-zero screen lag on battery power. - Community-friendly unencrypted Atlas Datalog Format (\*.ADL file) that flexibly allows you to share your compressed logs for opinion and review with our community members. - Track grouping and splitting that saves your grouping preferences for future logs. - Easily export CSVs that can be imported into websites like [https://datazap.me/](https://datazap.me/). - End-to-end 64bit nanosecond resolution from the recording, to the saved format (.ADL), to the rendered view. - 32-bit floating point resolution for all parameters. - Automatic unit conversion to your Atlas preferences (see File -> Atlas Settings). - Live viewing while recording is on-going. - Tailored interpolation style for the time axis based on the individual precision of each logged parameter. - Automatic Y axis scaling and grouping for all parameters in a track. Parameters in a track with equivalent units will automatically be scaled relative to each-other, while other units will not. - Strong emphasis on a dark theme and designed to reduce judder and flashing to make it easier on your eyes when you're tuning late at night. - Design & create your own analytical/mathematical formulas to mix any data-logged parameters together, and add them post-recording as their own tracks with full support for all actions across the data logger. - Quickly generate beautiful 3D scatter plots and histograms from any logged data for deeper analysis. #### Main Layout [](https://docs.motorsportsresearch.org/uploads/images/gallery/2025-02/IIRqqMSTDFXi3mYu-screenshot-2025-02-27-at-3-13-41-pm.png)| **Area** | **Description** |
| **Menu** | Access actions in the Data Logging window, such as loading and saving datalogs, exporting CSVs, changing the view of the displayed log, and generate tables and charts. |
| **Toolbar** | Offers quick actions such as recording a new datalog and navigating around the current log. |
| **Time** | Shows the currently shown timespan, in seconds, for the visible portion of the current log, and also a time delta if a marker has been placed. |
| **Tabs** | Allows you to open multiple logs at once and quickly switch between them. Each log occupies its own tab. |
| **Tracks** | A datalog is comprised of parameters in tracks. Tracks are stacked vertically on top of eachother in the datalogger, and by default are sorted alphabetically. These tracks may optionally be grouped together by control + clicking them and right-clicking them to group them. |
| **Hovered** | As the cursor is moved (or "scrubbed") across the log horizontally, a marker is shown that interpolates the value at the hovered location for all tracks. |
| **Clicked** | When an interesting point in the log is identified, click once with your mouse to place down a *marker.* Markers are useful to keep yourself aligned in the datalogger. |
| **Legend** | A legend is shown in each track to indicate which parameters are shown in the track. Each label's vertical position corresponds to the vertical positioning of all values shown next to each marker as you scrub your mouse or place a marker to make it an easy way to reference which value is which in a grouped track. |
| **Ticker** | A ticker is shown at the bottom of the log to help keep you oriented and referenced to the timing of events in your log. All logs start at 0 (zero) seconds and extend for the duration of the recording to the right. |
| **Naming** | **Description** | **Example** |
| *Table* or *Base Table* | The value immediately after performing table lookup and any associated blending has been applied. For example, in the case of Subarus, this would be the result of all associated TGV and AVCS blending has been calculated on a given 4- or 5-dimensional map. | Ignition - Primary - Base Table |
| *Base* *Base Final* *Final* | For different stages of a pipeline, *Base* and its corresponding *Base Final* may be used to distinguish distinct book-ends of a pipeline operation. For example, when combining ignition timing, there may be a "Combine Base" and a corresponding "Combine Final". It is also possible for parameters to be named simply as "Base" and "Base Final" Generally, these values are intended to capture a value **before** (Base) and **after** (Base Final) the ECU performs any of the following calculations: - Switching between two or more inputs corresponding to different possible scenarios (i.e. throttle behaviors such as aggressive start, tip-in, or deceleration) - Compensation (either summing, subtracting, or scaling) due to conditions such as atmospheric effects or driver inputs. - Blocking of certain values based on conditions (i.e. knocking or driver inputs) - Mixing of different values (i.e. averaging or weighing), but not to include blending of higher-dimensional maps such as those using AVCS and TGVs as higher-dimensional axes. | Idle - Target Airflow - Base - Base Idle - Target Airflow - Base - Base Final |
| *Corrected* | For referential data in the ECU, and especially for the Mass Airflow (MAF) sensor, *Corrected* is used to name the corrected value of some base parameter, and is generally used by the ECU instead of a corresponding base parameter for its own calculations. | Airflow - MAF - Mass Airflow Corrected (g/sec, uint) |
| *Primary* *Secondary Alternate A, B, C,* etc. | These are placeholder names that names a parameter whose behaviors and relevance have been yet-uncharacterized. | |
| *Target* | *Target* is used to name a parameter that the ECU will reference through some other proportional/integral control system; this is also knows as the **set-point** in closed loop control systems. Targets are not commanded to the hardware electrically. A target might be, for example, the target **airflow** used to determine the commanded throttle position. Note that in this example, the target isn't commanded to the hardware, but the throttle position references the target and is commanded instead. Another example would be **boost**. Boost pressure cannot be commanded; instead, the waste-gate position is 'Commanded' by using the boost target and target torque as a wastegate position table that is then adjusted through its own closed (or open) loop control system, referencing the 'Main Boost Target' table as the set point. Targets may themselves be split into their own *Target* *Base* and *Target Final* sub-parameters. In these cases, *Target Final* will be the target that is referenced by the ECU for closed loop control, while *Target Base* is left in the definitions for diagnostic purposes and will likely be marked as **advanced**. | Idle - Target Airflow - Target Base (g/sec, ushort) Idle - Target Airflow - Target Final (g/sec, ushort) Fuel - Targets - Closed Loop - Target Final (λ, ushort) |
| *Commanded Final* | For parameters that involve digital to analog conversion (DAC), such as ignition timing and fuel pulse width, *Commanded Final* references the last available value before the ECU physically commands the associated hardware elements to take action. No other modifications or alterations of the value takes place in the pipe-line after this point. In the case of ignition timing, this would be the amount of time referenced to determine a timer delay for ignition spark from the MCU. For direct injection fuel platforms, this would be the pulse width of the signal sent to the injectors through any associated amplification hardware present on the ECU. | Fuel - Pulse - Commanded Final Ignition - Commanded Final Airflow - Turbo - Wastegate - Position Commanded Final |