# ATLAS Product Suite > Comprehensive technical documentation for Motion Applied ATLAS. Covering custom displays, data integration, APIs, and developer tools This file follows the llms.txt convention (https://llmstxt.org/). It maps the public documentation so language models can locate any topic without crawling the rendered HTML site. Source repository: https://github.com/mat-docs/ATLAS.Site Full text: https://atlas.motionapplied.com/llms-full.txt ## Introduction - [Overview](https://atlas.motionapplied.com/introduction/): ATLAS (Advanced Telemetry Linked Acquisition System) is more than just a telemetry tool—it's a modular, open, and scalable data ecosystem built to meet the evolving demands of motorsport and high-perf - [Use Cases in Motorsport and Engineering](https://atlas.motionapplied.com/introduction/use-cases/): The ATLAS ecosystem is a powerful telemetry and data intelligence platform designed to support high-performance environments. Whether you're tuning a race car or validating aerospace systems, ATLAS pr - [Eco-System Overview](https://atlas.motionapplied.com/introduction/eco-system/): The ATLAS ecosystem is Motion Applied’s advanced telemetry and data management platform, purpose-built for high-performance motorsport engineering and adaptable to wider industries. It brings together - [Ecosystem Guide](https://atlas.motionapplied.com/introduction/ecosystem-guide/): Not sure where to start? This guide will help you find the right ATLAS components for what you're trying to do. No prior knowledge of the software needed. ## Getting Started - [Quick Start](https://atlas.motionapplied.com/getting-started/quick-start/): This page contains quick access to getting started with different component in the ATLAS ecosystem. - [Security](https://atlas.motionapplied.com/getting-started/security/): One of the key mechanisms used to protect customer data is RDA (Restricted Data Access). This system ensures that sensitive telemetry and operational data is only accessible to authorised users, maint - [System Requirements](https://atlas.motionapplied.com/getting-started/sysreqs/): Windows 11 Professional or Enterprise (64 bit) ## User Guides - [Overview](https://atlas.motionapplied.com/key-functionality/): ATLAS (Advance Telemetry Linked Acquisition System) is a powerful software platform used to collect, process, and visualise data—especially in high-performance environments like motorsport. But don’t - **Configuration** - **System Monitor** - [Overview](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/): System Monitor is a software application for interfacing with Electronic Control Units (ECUs) and related systems. It supports trackside support, unit optimisation, dyno testing, development, and prod - **Getting Started** - [Overview](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/getting-started/): This guide helps you install and start using System Monitor. Below are the minimum and recommended system requirements: - [RDA](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/getting-started/rda/): The Reduced Data Access feature of System Monitor lets teams restrict sharing of data and setups between engine and chassis applications. Access is determined by the team's licence and can be one of t - **Using System Monitor** - [Overview](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/using-sm/): System Monitor is a software tool used for real-time data monitoring, parameter editing, and logging in motorsport applications. It interfaces with ECUs and other data sources to provide engineers wit - [Menus](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/using-sm/menus/): Options to manage files and projects. - [Windows and Parameters](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/using-sm/windows-parameters/): System Monitor supports multiple window types for displaying and interacting with parameters. - [Configuration and Advanced Settings](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/using-sm/advanced/): System Monitor allows users to customise the desktop layout, window behaviour, and display settings. - **Projects** - [Overview](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/projects/): System Monitor has various safeguards to ensure that only the correct data and programs are transferred to an ECU. This is done either by using the Customer Base, which links the ASAP project to the f - **Project Setup** - [Customer Base](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/projects/project-setup/): A Customer Base links an ASAP project to the file directories used by System Monitor. It ensures that only files associated with the specified ECU are used. - [Unit.Def Files](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/projects/unit-def/): Unit.Def files are XML-based configuration files that define project options. They replace the legacy Multi-Application and Customer Base structure. There can be one Unit.Def file per folder and it is - **Program and Data Versions** - [Creating Versions](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/projects/program-data-versions/): Each ECU contains one or more controllers, which require programming before use. The ECU manufacturer usually programs the controllers before despatch, however System Monitor can reprogram the ECU. Sy - [File Types](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/projects/file-types/): System Monitor uses several different files in the following categories: - [Application Management](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/projects/applications/): Applications represent functional areas of the ECU system, such as: - [Data Version Development](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/projects/data-version-development/): When a project is Created a Base Data Version is allocated to each Application in the project. The Base Data Version contains a full set of Editable Parameters with values that should enable the vehic - [Data Wizard](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/projects/data-wizard/): Data Wizard compares the contents of the Edit Buffer with one or more previously created Data Versions, known as Candidate Data Versions. Using the Merge facility parameters in the current Data Versio - [ECU Connection](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/projects/ecu-communication/): The Connections tab is used to view and modify the way System Monitor is connected to the ECU. To open the Connections tab select: File > Properties > Connections or use the ECU Menu. - [File Operations](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/projects/file-operations/): System Monitor uses various file types for ECU configuration, logging, and tuning. - **Displays** - [Overview](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/using-sm/display/): The System Monitor is a data display tool designed to provide feedback during tuning by visualising Measurement Parameters. While it offers basic display capabilities, more advanced analysis is availa - [Numeric](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/using-sm/display/numeric/): The Numeric Display shows one or more Measurement Parameters in a tabular format. Each parameter is displayed in a row with descriptive text. - [Bar](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/using-sm/display/bar/): The Bar Graph Display visualises one or more Measurement Parameters as bars. Each bar's height and colour reflect the parameter's value and status. - [Error](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/using-sm/display/error/): The Error Display shows diagnostic error flags from the ECU. Each error is represented by a special Measurement Parameter. - [Event](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/using-sm/display/event/): Events report status changes in the control system and include a timestamp. They are defined by the Event File in the Program Version. - [Grid](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/using-sm/display/grid/): - Editable Parameters can be highlighted using a different background colour. - Values not included in the Live Logging Configuration are shown as a dash. - Appearance controls are available via the W - [Oscilloscope](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/using-sm/display/oscilloscope/): The Oscilloscope Display plots one or more Measurement Parameters against time. It consists of a Plot Area and a Parameter Info Box. - [Signal Sampling](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/using-sm/display/signal/): A signal sampling display can be added to a page by selecting Desktop > Window > Signal Sampling. - [Alarms](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/using-sm/display/alarms/): The Alarm Display window shows active alarms triggered by defined conditions. It appears automatically when an alarm message is triggered, or can be opened manually via: Desktop > Window > Alarms - **Data Acquisition** - [Overview](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/data-acquisition/): System Monitor is a configuration and monitoring tool used in TAG systems to manage how Electronic Control Units (ECUs) and other data logging devices acquire and store data. It supports both live and - **Logging** - [Overview](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/data-acquisition/logging/): System Monitor supports three main logging methods: - [Live Logging](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/data-acquisition/logging/live-logging/): Live Logging is the process by which System Monitor obtains data from a connected ECU. The Live Logging Configuration serves two purposes in System Monitor: - [Remote Logging](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/data-acquisition/logging/remote-logging/): Remote Logging is the process by which an ECU, stores data in DATALab Memory while not connected to System Monitor. - [Burst Logging](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/data-acquisition/logging/burst-logging/): Burst Logging is the process by which an ECU stores data in Burst Memory while not connected to System Monitor. In some types of ECU, the content of the Burst Memory can be transmitted at intervals us - [Remote Configuration Compare](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/data-acquisition/logging/config-compare/): Remote Configuration Compare is the process that allows the comparison of the existing project remote logging configuration to an additional existing configuration file. - [Logging Configuration](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/data-acquisition/logging/logging-config/): Session Details identify the Session and include information to assist in the analysis of session data. Session details are required for Live Logging, Remote Logging, and Burst Logging. - **CAN** - [Overview](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/data-acquisition/can/): System Monitor includes tools to configure Controller Area Network (CAN) messages for data logging. These messages can be transmitted to external units or received and logged internally using CAN buff - [CAN Configurations](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/data-acquisition/can/configuration/): With Customer Bus selected in the explorer, the configurable options available affect all Buffers and their associated CAN messages. - **Sensors** - [Overview](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/data-acquisition/sensors/): Configure and calibrate sensors in TAGtronic systems to convert physical properties into electrical signals for logging and analysis. - [External Configuration](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/data-acquisition/sensors/external/): The External Inputs Configuration Tool allows sensor inputs to be configured and calibration data to be applied to sensors connected to the ECU. - [Software Calibrated Sensors](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/data-acquisition/sensors/software-calibrated-sensors/): The output of many sensors is inherently non-linear (the output is not proportional to the input). A linear output is often achieved by limiting the sensor range and adding complex compensation circui - [Sensors and Actuators](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/data-acquisition/sensors/sensors-and-actuators/): Sensors & Actuators allows you to apply calibration data to sensors, enable and disable individual sensors, and enter values for sensor constants. It operates on sensors and actuators defined in the P - [Obtaining Sensor Calibration Data](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/data-acquisition/sensors/sensor-calibration-data/): Sensors and actuators supplied by Motion Applied are tested at multiple points in their operating range to produce a calibration table. This table is saved as an ASCII format file with the .dat extens - **Tuning** - [Overview](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/tuning/): Tuning is the process of optimising vehicle performance by adjusting the values of Editable Parameters within the ECU (Engine Control Unit). These adjustments can be made in several modes depending on - [Editable Parameters](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/tuning/editable-parameters/): Editable Parameters are values within the ECU that can be modified to optimise engine performance. These parameters are defined in the ASAP file by the ECU manufacturer and may be edited depending on - [Changing Values](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/tuning/changing-values/): Each Parameter is defined in the ASAP file by the ECU manufacturer. The ASAP file either permits or prevents System Monitor from changing the values of an Editable Parameter. If the Editable Parameter - [Graphical Maps](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/tuning/graphical-maps/): 1-axis and 2-axis maps can be displayed in several graphical formats. Select the view format from the System menu for the Window or step through the options with the View Mode button on the Map Bar. - [Live Tune](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/tuning/live-tune/): When Live Tune is on, the Edit Buffer and the ECU RAM are kept synchronised — any changes in the Edit Buffer are downloaded to the ECU as soon as they occur. - **PUMA Integration** - [Overview](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/testbed/): The System Monitor can be integrated with an AVL PUMA testbed system to enable unattended tuning. Communication between the PUMA system and System Monitor is established via a serial port using the AS - [Testbed Operations](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/testbed/system-monitor-puma/): - Configure — Opens the Testbed Properties dialog box (Shortcut CTRL+SHIFT+F5) - Enable Link — Switches the Testbed Link on and off (Shortcut CTRL+SHIFT+F6) - Message Window — Opens the Testbed Messag - [Testbed Properties](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/testbed/testbed-properties/): System Monitor must be configured to operate with the testbed. To open the Testbed Properties dialog box select: Tools > Testbed > Configure. - [PUMA Commands](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/testbed/puma-commands/): System Monitor supports a subset of commands from the AVL PUMA protocol V2.0. Commands from V1.0 or its sub-versions are not supported. - **ECU Control** - [Overview](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/ecu-control/): The ECU Control System Monitor allows programming and monitoring of the ECU via the ECU Menu commands. The program is loaded into System Monitor during the creation of a Program Version. Security feat - [ECU Operations](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/ecu-control/ecu-operations/): An Application in System Monitor corresponds to a set of ECU Memory locations. Most ECU Control commands operate on the Active Applications. - [ECU Memory](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/ecu-control/ecu-memory/): Electronic Control Units (ECUs) used in motorsport contain one or more controllers with access to two types of memory - [Programming Data](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/ecu-control/programming-data/): The changes made during Tuning are stored as a Data Version in the Edit Buffer. - [Diagnostics Status](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/ecu-control/diagnostics-status/): This section covers tools and views that help users inspect ECU status, synchronize files, and verify program and data versions. - [Hardware](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/hardware/): The Adjustment Board is a box with four high‑precision rotary switches. System Monitor can map each switch to a Measurement Parameter (used as an Index Parameter in a 1‑axis or 2‑axis map) or to a sca - [Developer Functions](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/developer-functions/): System Monitor includes various features available for experienced operators. These come under the following categories: - **History Report** - [Overview](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/history-report/): During its operation the ECU generates various statistics about the operation of the vehicle that it is controlling. History Report extracts these statistics and displays them. System Monitor can also - [Details](https://atlas.motionapplied.com/key-functionality/configure/system-monitor/history-report/history-details/): The History Report files are stored in the \HistReps\ sub-directory of the Multi-Application Base. The default name for the History Report is XXXXXnnn.hrs, where: - **Store** - [Overview](https://atlas.motionapplied.com/key-functionality/store/): Organise and retain vast telemetry datasets in a structured, scalable format. - **SQL Race** - [Overview](https://atlas.motionapplied.com/key-functionality/store/sqlrace/): SQL Race is the session data access layer used by ATLAS to manage telemetry data. It provides a structured way to store, retrieve and manipulate session data, supporting both real-time and historical - [Getting Started](https://atlas.motionapplied.com/key-functionality/store/sqlrace/installation/): This guide will cover the process of installing SQL Server, setting up a SQL Race Database, and connecting your database to ATLAS ready to start reading and writing data. - [Performance Guide](https://atlas.motionapplied.com/key-functionality/store/sqlrace/performance/): This guide covers settings on how to get the most out of your SQL Race installation by adjusting settings for better performance. - [SQL Race, SQLite & SSN2](https://atlas.motionapplied.com/key-functionality/store/sqlrace/comparison/): This document provides a clear comparison between SQL Race Database, SQLite and SSN2, focusing on their roles within motorsport telemetry and general data management. - **Stream** - [Overview](https://atlas.motionapplied.com/key-functionality/stream/): Distribute live telemetry seamlessly across multi‑client workflows. - **Data Server** - [Overview](https://atlas.motionapplied.com/key-functionality/stream/ads/): ATLAS Data Server is a core component of the ATLAS ecosystem, providing a robust and scalable solution for storing and managing large volumes of telemetry data. It is designed to handle high-throughpu - [Getting Started](https://atlas.motionapplied.com/key-functionality/stream/ads/installation/): This guide walks you through installing and configuring the ATLAS Data Server (ADS) to manage and store telemetry data. - [Recorders](https://atlas.motionapplied.com/key-functionality/stream/ads/recorders/): In ADS, a “recorder” is the configured input/output endpoint that defines how data enters ADS (protocol/device/source) and how/where it gets stored/offloaded/distributed. - [Options](https://atlas.motionapplied.com/key-functionality/stream/ads/options/): To access the options dialog box, go to Tools > Options in ATLAS Data Server (ADS). - [ATLAS.ini File](https://atlas.motionapplied.com/key-functionality/stream/ads/atlas-ini/): ATLAS.ini is a plain text file that sets ATLAS Data Server (ADS) configuration without using the GUI. Any setting normally changed in Tools > Options can be written into this file instead, which is wh - [RDS](https://atlas.motionapplied.com/key-functionality/stream/ads/rds/): The Remote Data Server enables listening to another ADS server across different networks over WAN connections. This functionality is essential for distributed teams, allowing factory floor personnel t - **Open Streaming** - [Overview](https://atlas.motionapplied.com/key-functionality/stream/open_streaming_architecture/) - **Enrich** - [Overview](https://atlas.motionapplied.com/key-functionality/enrich/): Tooling to add upon existing raw data to augment and enrich for more advanced simulation - **vTAG Server** - [Overview](https://atlas.motionapplied.com/key-functionality/enrich/vtag/): vTAG Server is part of the ATLAS ecosystem and provides a way to run Simulink‑based logic on real data—either live telemetry or historical sessions—without requiring a physical ECU or embedded unit. T - [Getting Started](https://atlas.motionapplied.com/key-functionality/enrich/vtag/getting-started/): This guide provides the fastest, simplest path to building and running your first vTAG Server application — from a blank Simulink model to live outputs in ATLAS. - [Operating vTAG Server](https://atlas.motionapplied.com/key-functionality/enrich/vtag/operating-vtag/): vTAG Server contains 6 tabs plus a bottom control section showing Process State and Progress. All vTAG Server settings are saved within the workbook. - [Live & Historical Usage](https://atlas.motionapplied.com/key-functionality/enrich/vtag/complete-system/): vTAG Server can operate in two ways depending on the data source: - **Virtual Parameter Service** - [Overview](https://atlas.motionapplied.com/key-functionality/enrich/vps/): The Virtual Parameter Service (VPS) simplifies the calculation of virtual parameters — parameters defined as FDL (Function Definition Language) functions in ECU logging configurations. Traditionally c - [Getting Started](https://atlas.motionapplied.com/key-functionality/enrich/vps/setup-guide/): This guide walks through deploying the Virtual Parameter Service using Docker (recommended) or running it manually. - **Configuration** - [AppConfig Reference](https://atlas.motionapplied.com/key-functionality/enrich/vps/configuration/appconfig-reference/): The VPS is configured via a single JSON file — AppConfig.json. This page documents every section and setting. - [Environment Variables](https://atlas.motionapplied.com/key-functionality/enrich/vps/configuration/environment-variables/): The Virtual Parameter Service supports configuration via environment variables, which are particularly useful when deploying with Docker or Docker Compose. - [Logging](https://atlas.motionapplied.com/key-functionality/enrich/vps/configuration/logging/): The Virtual Parameter Service uses Serilog for structured logging and the standard ASP.NET Core logging framework for host-level messages. - [Troubleshooting & FAQ](https://atlas.motionapplied.com/key-functionality/enrich/vps/troubleshooting/): Common issues and their solutions when working with the Virtual Parameter Service. - **Analyse** - [Overview](https://atlas.motionapplied.com/key-functionality/analyse/): Visualise, compare, and understand high‑frequency telemetry — live or post‑run. - **Viewer** - [Overview](https://atlas.motionapplied.com/key-functionality/analyse/viewer/): The ATLAS Viewer is a core component of the ATLAS ecosystem, designed for the visualisation and analysis of telemetry data. It enables users to interact with both live and historical data streams, off - [Getting Started](https://atlas.motionapplied.com/key-functionality/analyse/viewer/quick-start/): To start ATLAS, if installed in the default location: - **System Operation** - [Mouse Actions](https://atlas.motionapplied.com/key-functionality/analyse/viewer/system-operation/mouse/): A mouse with a scroll-wheel is recommended, though many actions have Keyboard Shortcuts. - [Keyboard Shortcuts](https://atlas.motionapplied.com/key-functionality/analyse/viewer/system-operation/keyboard/): The command to switch a page group to the 10th compare set (++ctrl+shift+0++) may not work on some Windows 11 systems due to a system-level language hotkey using the same combination. To restore the s - [Options](https://atlas.motionapplied.com/key-functionality/analyse/viewer/system-operation/options/): SessionState Options Screen - [Workbooks](https://atlas.motionapplied.com/key-functionality/analyse/viewer/system-operation/workbook/): Workbooks in ATLAS define your workspace layout and the arrangement of elements on the screen. Every ATLAS session contains at least one Workbook, which can hold multiple Pages, and each Page can disp - [Toolbar](https://atlas.motionapplied.com/key-functionality/analyse/viewer/system-operation/toolbar/): Toolbars provide quick access to various ATLAS commands. By default, they are docked along the top edge of the Main Window. - **Time and Position** - [Overview](https://atlas.motionapplied.com/key-functionality/analyse/viewer/time-and-position/): ATLAS provides powerful tools for visualising data over time using Timebases and Graphical Timelines. Each Display has a Timebase, defined by a start and end time (duration) and a current position. Ti - [Timebase and Timeline](https://atlas.motionapplied.com/key-functionality/analyse/viewer/time-and-position/time/): Each Display in ATLAS has a Timebase, defined by: - [Go To](https://atlas.motionapplied.com/key-functionality/analyse/viewer/time-and-position/go-to/): The Go To feature in ATLAS 10 allows users to quickly navigate to specific laps, markers, or exact positions (by time or distance) within a session. This feature streamlines data exploration and analy - **Handling Data** - **Recorders** - [USB Recorder](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/recorders/usb-logger/): This guide provides a step-by-step overview of how to use a USB Logger system to collect, transfer, and visualise sensor data efficiently. It covers setup on the vehicle, data offloading procedures, a - [NASCAR Telemetry Recorder](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/recorders/nascar-telemetry-recorder/): ATLAS can be used for receiving and visualising Telemetric data from NASCAR’s Event Racing Data Platform. It is designed to connect to the data feed delivered live via JSON messages published from NAT - [Data Server Telemetry Recorder](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/recorders/data-server/): Connects to a live telemetry stream from an ATLAS Data Server over a network. - [File Telemetry Recorder](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/recorders/file-telemetry/): Replays previously recorded raw telemetry data for diagnostics or analysis. - [Ethernet File Telemetry](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/recorders/ethernet-file/): Streams live data from ECUs connected via Ethernet (e.g. TAG-310). - [Ethernet Multi Session Offload](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/recorders/ethernet-mso/): Offloads multiple stored sessions from ECUs that support multi-session memory (e.g. TAG-310). - [Ethernet Offload](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/recorders/ethernet-offload/): Offloads the most recent session from an Ethernet-connected ECU. - [Stream Recorder](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/recorders/stream-recorder/): For more info, look at Kafka Security. - **Sessions** - [Overview](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/sessions/): Live, via telemetry (wireless transmission), or Offline, via a wirelink (physical connection). Each Session is automatically created and stored in an SQL Race database as it is recorded. This database - [Session Browser](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/sessions/browser/): The Session Browser is the primary interface in ATLAS for managing telemetry data Sessions. It allows users to: - [Loading Sessions](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/sessions/loading-sessions/): A Recorder in ATLAS is a tool that captures live telemetry data from a vehicle and stores it in an SQL Race database. Recorders are configured and managed through the Session Browser. - [Importing CSV and TXT Files](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/sessions/csv-txt-import/): - Your licence must include CSV/ASCII Import. - The source file must use a supported extension, such as csv or txt. - The file must be in a delimited text format that ATLAS can describe with the avail - [Changing Properties](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/sessions/properties/): The Session Properties Panel in ATLAS provides detailed metadata for each Session. This information is essential for identifying, organising, and aligning Sessions for analysis. Some properties are ed - [Database Connection Manager](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/sessions/database-connection/): This guide explains how to manage database connections in ATLAS using the Database Connection Manager. You will learn how to add, remove, and view properties of database connections. - [Service Connection Manager](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/sessions/service-connection/): The Service Connection Manager allows users with an RTA License to manage RTA hosts containing sessions in their indexed sources. This guide explains how to add, remove, edit, import, and export servi - **Laps and Markers** - [Markers](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/laps-markers/markers/): Markers define specific points or ranges of time within a session and are fully customizable. Each marker can include annotations and labels to describe its purpose. - [Laps](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/laps-markers/laps/): In ATLAS, a Lap is a defined segment of time within a telemetry session—typically corresponding to a vehicle completing a circuit. But laps are not just for motorsport. They are a powerful structuring - **Parameters** - [Overview](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/parameters/): Parameters are physical properties that are measured during a Session. Typically, a parameter value is the conditioned signal output of a sensor. Each parameter generates data which is available for d - [Using Parameters](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/parameters/using-parameters/): The Parameter Browser allows you to select and manage Parameters for the currently selected Display. The available Parameters depend on those recorded in the loaded Session. - **Exporting** - [Overview](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/export/): You can export sessions in multiple ways to suit your workflow. - [Export Manager](https://atlas.motionapplied.com/key-functionality/analyse/viewer/handling-data/export/export-manager/): The Export Manager helps you extract and save session data for analysis, reporting, or sharing. Use it to customize what data you export, how it's formatted, and where it's saved. - **Functions** - [Overview](https://atlas.motionapplied.com/key-functionality/analyse/viewer/functions/): Functions in ATLAS are user-defined calculations that operate on Session data. They allow users to extend the capabilities of ATLAS by performing custom computations, automating data processing, and e - [Function Editor](https://atlas.motionapplied.com/key-functionality/analyse/viewer/functions/function-editor/): The Function Editor in ATLAS allows users to create, edit, and view Functions, which are used similarly to Parameters for data manipulation and display. Functions are written in the Function Definitio - [Processors](https://atlas.motionapplied.com/key-functionality/analyse/viewer/functions/processing/): Processors are compiled pre-defined routines. - [Using DLLs](https://atlas.motionapplied.com/key-functionality/analyse/viewer/functions/using-dlls/): For complex logic, you can write functions in .NET languages like C# and import them as DLLs. - **Alarms** - [Overview](https://atlas.motionapplied.com/key-functionality/analyse/viewer/alarms/): Alarms in ATLAS let you define conditions over live or historical data; when a condition is met, ATLAS takes one or more actions (e.g., log, warn, pop‑up, or set a marker). Alarms evaluate on every in - [Using Alarms](https://atlas.motionapplied.com/key-functionality/analyse/viewer/alarms/using-alarms/): On the alarm itself you can define behaviour, conditions and actions. - **Displays** - [Overview](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/): ATLAS Viewer displays are visual components that show telemetry data from your sessions. Each display specialises in presenting data in a specific format — from time-series waveforms to numeric readou - [Working with Displays](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/essentials/): This guide covers the core concepts and workflows that apply across all display types in ATLAS Viewer. Understanding these will help you work efficiently with any display. - [Bar](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/bar/): Instantaneous value of selected parameters as vertical bars with numeric readouts. Updates in real time with telemetry. Up to 12 parameters. Double‑click a bar to edit that parameter’s properties. - [Bit](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/bit/): Status bits of one or more parameters, with configurable On/Off colours, labels, and captions per bit. You can pick which bits are active for each parameter. - [Block](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/block/): Minimal single‑parameter bar—quick, graphic visualization without numeric clutter. Optional gradient colour and conditional colouring using parameter warning/critical thresholds. - [Circuit](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/circuit/): Track map from a Circuit Definition file, with cursor‑synchronised car position indicator and optional sectors/segments; a shaded Timebase Region on the map mirrors the Waveform timebase. - [Countdown](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/countdown/): A configurable countdown clock (or Time Offset from now) with custom text pre‑ and post‑expiry. - [Error](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/error/): ECU errors during live connection. Columns include Status (Forthcoming/Current/Logged, with colours), Name, Description, Timestamp. Double‑clicking an error jumps the timeline cursor to first occurren - [Event](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/event/): ECU Events (from program version files defined in Options), with Priority (High/Medium/Low), Timestamp, Group, Id, Description, and parameter snapshots at the event time. Tabs allow quick filtering by - [Histogram](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/histogram/): Distribution of a single parameter against time or distance, either Spectral (time/distance in each bin) or Cumulative (≤ each bin). X‑axis range comes from the parameter’s Display Min/Max. Optional % - [Loadmap](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/loadmap/): Pseudo‑3D heatmap of time spent in ranges of one parameter vs. another (e.g., gear vs. speed). Grid squares show in‑range value to nearest 1%; bucket counts control resolution. Refresh per lap in Live - [Map](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/map/): Satellite map centered on the current location (with zoom control and scale). - [Notepad](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/notepad/): Free text notes for checklists and session details; useful to park instructions alongside data. - [Numeric](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/numeric/): The Numeric Display shows instant numeric readouts for up to 150 parameters at the cursor position. Text auto-sizes to fit the display window, and colours can reflect warning/critical thresholds. Doub - [Dash](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/pcu/): A simulator of the Motion Applied PCU Dash (as fitted to steering wheels). Supports multiple dash product types; auto‑loads a raw file if present (per Options). Positioning/alignment controls help fit - [Scatterplot](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/scatterplot/): The Scatterplot is a two-dimensional (X-Y) plot of one parameter against another, optionally colour-mapped by a third Z parameter. It's designed to reveal relationships and trends across sessions, wit - [Summary](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/summary/): Lap‑based statistics for selected parameters as a table or as a plot. First columns are fixed: Lap #, Lap Name, Lap Time. For each parameter, you can add stats columns such as Min, Max, Mean, Start, E - [Surface Map](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/surface/): The Surface Map Display provides an interactive 3D visualization using a .3d map definition. It pairs two parameters (such as throttle and engine speed) and interpolates a third value. The display sho - [Video](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/video/): Related video (e.g., in‑car camera) played alongside session data. - [Waveform](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/waveform/): The Waveform Display plots multiple parameters as traces against time or distance. It's the most versatile display in ATLAS, supporting live telemetry and historical sessions, fast zooming, and rich f - [Web Display](https://atlas.motionapplied.com/key-functionality/analyse/viewer/displays/web/): An embedded browser—useful for live camera feeds, weather, or other web‑based information. - **Integrate** - [Overview](https://atlas.motionapplied.com/key-functionality/integrate/): Extend ATLAS capabilities by connecting with third‑party systems and custom workflows. - **RTA** - [Overview](https://atlas.motionapplied.com/key-functionality/integrate/rta/): ATLAS Remote Telemetry Architecture (RTA) defines web services to let you load telemetry directly from your existing storage: - [Architectures](https://atlas.motionapplied.com/key-functionality/integrate/rta/introduction/architectures/): The RTA API Specification does not require any specific architecture or technology stack — but there are some common patterns. - [Data Services](https://atlas.motionapplied.com/key-functionality/integrate/rta/introduction/data-services/): Data Services read samples and events from a telemetry store, and serve them to ATLAS. - [Sessions](https://atlas.motionapplied.com/key-functionality/integrate/rta/introduction/sessions/): Sessions are a logical way to organise telemetry — like a file system. - [Configuration](https://atlas.motionapplied.com/key-functionality/integrate/rta/introduction/configuration/): ATLAS is data-driven: it uses Configuration to describe the telemetry. - **APIs** - [Overview](https://atlas.motionapplied.com/key-functionality/integrate/apis/): ATLAS APIs are designed with an API-first strategy, enabling seamless integration with third-party tools and cloud-native platforms. ATLAS APIs are a suite of extensibility interfaces designed to inte ## Developer Resources - [Overview](https://atlas.motionapplied.com/developer-resources/): Welcome to the Developer Resources section! This area provides everything you need to get started and succeed when integrating with the ATLAS platform. Here you'll find: - **NuGet Packages** - [Overview](https://atlas.motionapplied.com/developer-resources/atlas/nuget/): McLaren NuGet libraries are available from our GitHub packages feed. A free GitHub account is required. - [Setup Guide](https://atlas.motionapplied.com/developer-resources/atlas/nuget/setup/): First, Create a Personal Access Token (PAT) including the read:packages scope. You'll need a free GitHub account. - **System Monitor** - **Configuration API** - [Overview](https://atlas.motionapplied.com/developer-resources/system-monitor/configuration_api/): The configuration API is a new multi-platform API for ECU programming and monitoring, which makes it easier to handle multiple units, and to integrate across the network with clients written in langua - [Protobuf](https://github.com/mat-docs/System.Monitor.Configuration.API.Client.Sample/tree/main/Protos) - [Example](https://github.com/mat-docs/System.Monitor.Configuration.API.Client.Sample/tree/main) - [Protocol Documentation](https://atlas.motionapplied.com/developer-resources/system-monitor/configuration_api/docs/): - Protos/systemmonitorcommon.proto - AppParametersFileRequest - AppParametersRequest - AppRequest - ConversionRequest - FileRequest - ParameterRequest - ParametersFileRequest - ParametersRequest - Ret - **Active X** - [Overview](https://atlas.motionapplied.com/developer-resources/system-monitor/active-x/): System Monitor includes an ActiveX/OLE Automation interface, which exposes programmable System Monitor objects to other applications. This allows external applications to control or request informatio - [Methods](https://atlas.motionapplied.com/developer-resources/system-monitor/active-x/methods/) - [Error Codes](https://atlas.motionapplied.com/developer-resources/system-monitor/active-x/error/): The following error codes are returned by API functions. Use the macros SMAPISUCCEEDED(Status) to check if a return code indicates success (>= 0), or SMAPIFAILED(Status) to check for failure (< 0). - **Examples** - [Using SendMessage() to send a Read RAM message to the ECU](https://atlas.motionapplied.com/developer-resources/system-monitor/active-x/examples/example-1/): Sub Main 'Get access to System Monitor API Set SmApi = CreateObject("System Monitor API") - [Getting and Setting the Value of a Scalar Editable Parameter](https://atlas.motionapplied.com/developer-resources/system-monitor/active-x/examples/example-2/): Sub Main 'Get access to System Monitor API Set SmApi = CreateObject("System Monitor API") - [Getting Values From a 1-Axis Map, Axis, Array and 2-Axis Map](https://atlas.motionapplied.com/developer-resources/system-monitor/active-x/examples/example-3/): Sub Main Set SmApi = CreateObject("System Monitor API") Dim szIdent As String Dim lErr As Long - [Manipulating the Values in a 1-Axis Map](https://atlas.motionapplied.com/developer-resources/system-monitor/active-x/examples/example-4/): Sub Main 'Get access to System Monitor API Set SmApi = CreateObject("System Monitor API") 'Param to retrieve Dim szIdent As String 'Error return code Dim lErr As Long 'Variables which are to receive m - [Demonstrating functions GetValue2AxisMap and SetValue2AxisMap](https://atlas.motionapplied.com/developer-resources/system-monitor/active-x/examples/example-5/): Sub Main ' Get access to System Monitor API Set SmApi = CreateObject("System Monitor API") - **Open Streaming** - [Getting Started](https://atlas.motionapplied.com/developer-resources/secu4/getting-started/): This guide walks you through getting ATLAS Open Streaming data flowing from source to screen. Whether you are writing telemetry from your own systems into Kafka, or reading live sessions inside the AT - **Stream API** - [Overview](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/): The Stream API is a component that manages real-time data streaming to and from Kafka brokers as part of the Open Streaming Architecture. It provides a gRPC-based interface that enables any programmin - **Getting Started** - [Overview](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/getting-started/overview/): Welcome to the Motion Applied Stream API getting started guide. This section provides everything you need to begin working with our high-performance streaming platform. - [Quick Start](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/getting-started/quick-start/): Get up and running with the Motion Applied Stream API in minutes. This guide walks you through setting up your first data streaming application. - [Installation](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/getting-started/installation/): This guide covers installing the Stream API client libraries and setting up your development environment. - **Services** - [Session Management](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/services/session-management/): The Session Management Service handles the complete lifecycle of data sessions, including creation, monitoring, and termination. - [Connection Management](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/services/connection-management/): The Connection Management Service handles client connections to sessions in the broker. - [Packet Writer](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/services/packet-writer/): The Packet Writer Service enables high-performance data publishing to Kafka topics with support for both individual packets and batch operations. - [Packet Reader](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/services/packet-reader/): The Packet Reader Service provides high-performance data consumption from Kafka topics with support for real-time streaming and historical data replay. - [Data Format Management](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/services/data-format-management/): The Data Format Management Service handles registering and getting data formats for parameter and event packets. - **Configuration** - [Server Configuration](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/configuration/server-config/): The MA Streaming API provides a flexible way to stream data using Kafka as the messaging backbone. The API supports two streaming strategies: Topic-Based and Partition-Based, each suited for different - [Kafka Security](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/configuration/kafka-security/): Configure the Stream API to connect to a secured Kafka broker — SASL authentication, TLS encryption, or both. If your broker accepts unauthenticated plaintext connections, you can skip this page entir - [Kafka Broker Tuning](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/configuration/kafka-broker-tuning/): Optional JSON files let you tune the underlying Kafka producer and consumer the Stream API uses, without touching code. Most deployments never need this page — the built-in defaults below are sensible - [Docker Setup](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/configuration/docker-setup/): Deploy the Stream API using Docker containers for development and production environments. - **Examples** - [Telemetry Example](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/examples/telemetry-example/): This example demonstrates how to build a complete telemetry data streaming application using the Stream API. - [Custom Messages](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/examples/custom-messages/): This guide demonstrates how to implement and use custom message types with the Stream API. While the API uses Protocol Buffers internally for the packet structure, you can serialize your custom messag - **Reference** - [API Reference](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/reference/api-reference/): Complete reference for the Stream API gRPC services and message types based on ma.streaming.api.v1. - [Error Handling](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/reference/error-handling/): Guide to handling errors in the Stream API. - [Troubleshooting](https://atlas.motionapplied.com/developer-resources/secu4/stream_api/reference_docs/reference/troubleshooting/): Common issues, diagnostic steps, and solutions for the Stream API. - [Protocol Documentation](https://atlas.motionapplied.com/developer-resources/secu4/docs/): - ma/streaming/api/v1/api.proto - AddAssociateSessionRequest - AddAssociateSessionResponse - CloseConnectionRequest - CloseConnectionResponse - Connection - ConnectionDetails - CreateSessionRequest - - **Bridge Service** - [Overview](https://atlas.motionapplied.com/developer-resources/secu4/bridge_service/): Bridge service uses the name of the ADS as the DataSource name. This can be configured within the ADS on Setup | General | General Network Settings | Name. - [Configuration Guide](https://atlas.motionapplied.com/developer-resources/secu4/bridge_service/configuration-guide/): The MA DataPlatforms Bridge service uses multiple configuration sections to control various aspects of data streaming, processing, and integration. This guide provides comprehensive documentation for - **Broadcast Service** - [Overview](https://atlas.motionapplied.com/developer-resources/secu4/broadcast_service/): Broadcast Service gives your live telemetry feed highly-available replication to multiple downstream consumers, so a downstream restart, network blip, or slow consumer never costs you data — every dow - [Getting Started](https://atlas.motionapplied.com/developer-resources/secu4/broadcast_service/getting-started/): This walks through running a first Broadcast Service instance with the smallest config that starts successfully, and confirming it's forwarding data. - [Configuration Guide](https://atlas.motionapplied.com/developer-resources/secu4/broadcast_service/configuration-guide/): Task-by-task guidance for the changes you're most likely to make to AppConfig.json. For the full field-by-field list, defaults, and validation rules, see the Configuration Reference. - [Configuration Reference](https://atlas.motionapplied.com/developer-resources/secu4/broadcast_service/configuration-reference/): Field-by-field reference for the BroadcastConfig section of AppConfig.json. For task-based how-tos (adding a target, tuning WAL compaction, and so on), see the Configuration Guide. - [Troubleshooting](https://atlas.motionapplied.com/developer-resources/secu4/broadcast_service/troubleshooting/): Symptom: the process exits at startup with an error beginning Invalid broadcast configuration:, followed by one or more problems joined together. - **Support Library** - [Overview](https://atlas.motionapplied.com/developer-resources/secu4/support_library/reference_docs/): The MA DataPlatforms Streaming Support Library is a .NET library designed to facilitate real-time and historical data streaming for telemetry and data analysis applications. The library provides a mod - **Core Modules** - [Session Manager](https://atlas.motionapplied.com/developer-resources/secu4/support_library/reference_docs/session-manager/): The Session Manager Module is one of the two independent core modules in the Support Library. It provides session lifecycle management, including session creation, metadata management, session associa - [Data Format Manager](https://atlas.motionapplied.com/developer-resources/secu4/support_library/reference_docs/data-format-manager/): The Data Format Manager Module is the second independent core module in the Support Library. It manages data format definitions for parameters and events, automatically generating and caching unique f - **Data Flow Modules** - [Writer Module](https://atlas.motionapplied.com/developer-resources/secu4/support_library/reference_docs/writer-module/): The Writer Module (Packet Writing Module) provides API for publishing data packets and session information to the streaming broker (Kafka). It handles the serialization and transmission of telemetry d - [Reader Module](https://atlas.motionapplied.com/developer-resources/secu4/support_library/reference_docs/reader-module/): The Reader Module (Packet Reading Module) provides API for consuming data packets from the streaming broker. It supports both live session monitoring and historical session playback, with configurable - [Essential Module](https://atlas.motionapplied.com/developer-resources/secu4/support_library/reference_docs/essentials-module/): The Essentials Module provides a streamlined API for reading essential session packets from the streaming broker. Essential packets contain critical session information such as configuration data, dat - [Buffering Module](https://atlas.motionapplied.com/developer-resources/secu4/support_library/reference_docs/buffering-module/): The Buffering Module, also known as the Sample Reader Module, is a component that pipelines with the Packet Reader Module. It buffers incoming packets, merges data segments, and extracts time-aligned - [Interpolation Module](https://atlas.motionapplied.com/developer-resources/secu4/support_library/reference_docs/interpolation-module/): The Interpolation Module, also known as the Data Reader or Data API Module, provides data by subscribing to parameters at custom frequencies and performing automatic interpolation or decimation. This - **Reference** - [API Reference](https://atlas.motionapplied.com/developer-resources/secu4/support_library/reference_docs/api-reference/): This document provides a comprehensive reference for all public APIs, interfaces, and types in the MA DataPlatforms Streaming Support Library. - [Kafka Configuration](https://atlas.motionapplied.com/developer-resources/secu4/support_library/reference_docs/kafka-configuration/): The Support Library connects to Kafka through the embedded Stream API. From release 2.1.4.22 (July 2026), StreamingApiConfiguration lets you do two things that previously required changes on the broke - **Indexing Services** - [Overview](https://atlas.motionapplied.com/developer-resources/secu4/indexing_services/): A microservice solution for file and configuration indexing, designed specifically for Motion Applied's data platform infrastructure. - [Service Overview](https://atlas.motionapplied.com/developer-resources/secu4/indexing_services/service-overview/): This document provides a brief description of each service in the MA.DataPlatforms.Indexing solution. - [API Documentation](https://atlas.motionapplied.com/developer-resources/secu4/indexing_services/api-documentation/): This document provides comprehensive API documentation for both the MA.DataPlatforms.Indexing.Files and MA.DataPlatforms.Indexing.Configs projects. - [Configuration Guide](https://atlas.motionapplied.com/developer-resources/secu4/indexing_services/appsettings-configuration/): This document provides comprehensive information about configuration options for both the MA.DataPlatforms.Indexing.Files and MA.DataPlatforms.Indexing.Configs projects. - **ATLAS** - [Overview](https://atlas.motionapplied.com/developer-resources/atlas/): This section includes detailed guides for automating and enhancing your ATLAS Client workflows using various APIs defined. - **Automation API** - [Overview](https://atlas.motionapplied.com/developer-resources/atlas/automation-api/): The Automation API is a WCF-based interface that enables seamless interaction with ATLAS and its data ecosystem. It supports reading and writing data, updating session metadata, and automating the cre - [Extracting Sessions](https://atlas.motionapplied.com/developer-resources/atlas/automation-api/getting-started/): One of the fundamental operations in the ATLAS Automation API is retrieving an already loaded session from ATLAS. - [Loading Sessions](https://atlas.motionapplied.com/developer-resources/atlas/automation-api/loading-sessions/): Sessions can be programmatically loaded and unloaded into ATLAS, including associate sessions. Additional sessions can be appended. - [Working With Displays](https://atlas.motionapplied.com/developer-resources/atlas/automation-api/working-with-displays/): This guide explains how to interact with Displays in a workbook using the provided service clients. You'll learn how to retrieve displays, filter them, and modify their properties such as color. - [Timebase and Cursor Point](https://atlas.motionapplied.com/developer-resources/atlas/automation-api/timebase-cursor/): The TimeBaseServiceClient class is used to interact with time-based automation services. It provides a rich set of methods for manipulating time bases and cursors in ATLAS. Both the cursor and the Tim - [Working With Data](https://atlas.motionapplied.com/developer-resources/atlas/automation-api/working-with-data/): The ParameterDataAccessServiceClient class is the entry point for accessing parameter data from a session. It provides a variety of methods to retrieve, navigate, and analyze time-series data. - [Transient Parameters](https://atlas.motionapplied.com/developer-resources/atlas/automation-api/writing-transient-parameters/): This guide demonstrates how to add a transient parameter to an ATLAS session, retrieve data from an existing parameter, perform a transformation, and write the result to the new transient parameter. - **SQL Race API** - [Overview](https://atlas.motionapplied.com/developer-resources/atlas/sql-race/): The ATLAS Data layer is provided by the SQL Race API, which provides: - [Getting Started](https://atlas.motionapplied.com/developer-resources/atlas/sql-race/integration/): Visual Studio 2022 or later (for C#) MATLAB 2020b or later (for MATLAB) Python 3.7 or later (for Python) Python IDE such as PyCharm or Visual Studio Code (for Python) .NET 8 or later ATLAS 10 installe - [API Reference](https://mat-docs.github.io/Atlas.SQLRaceAPI.Documentation/api/index.html) - [Object Model](https://atlas.motionapplied.com/developer-resources/atlas/sql-race/object-model/): The SQL Race API is organised around a Session — the container for time-series data, its configuration, and the structure (laps, markers, events) layered on top. The interactive map below shows - **Worked Examples** - [Create Session](https://atlas.motionapplied.com/developer-resources/atlas/sql-race/examples/create-session/): This guide walks you through the process of creating a new session file (.ssn2) using the SQLRace API. You'll learn how to initialize the environment, create a session, add metadata, generate paramete - [Synchro Data](https://atlas.motionapplied.com/developer-resources/atlas/sql-race/examples/synchro-data/): Synchro (engine-synchronous) channels store one sample per engine event — typically once per revolution or once per firing cycle — rather than at a fixed clock rate. Because engine speed v - [Functions](https://atlas.motionapplied.com/developer-resources/atlas/sql-race/examples/functions/): There different ways to work with functions in the SQLRace API. Existing FDL functions can be exposed through the API as FunctionParameters. Functions can also be defined from scratch in code. In addi - [Parameter Data Access](https://atlas.motionapplied.com/developer-resources/atlas/sql-race/examples/parameter-data-access/): ParameterDataAccess objects (PDAs) are used to defines how parameter values are sampled or interpolated via SQL Race. - [Session Export](https://atlas.motionapplied.com/developer-resources/atlas/sql-race/examples/session-export/): Sessions can be exported to local SSN2 files using the SQLRace API and the SessionManager object. - [Session Loading](https://atlas.motionapplied.com/developer-resources/atlas/sql-race/examples/session-loading/): The SQLRace API can load sessions either locally, from an SSNDB, or from an SQLRace database. - **Display API** - [Introduction](https://atlas.motionapplied.com/developer-resources/atlas/display-api/): ATLAS ships with a range of standard displays such as: Waveform, Scatterplot and Numeric to name a few. - [Getting Started](https://atlas.motionapplied.com/developer-resources/atlas/display-api/overview/): This section is a detailed guide to the Display API. - **Tutorials** - [Create Custom Display Plugin from Scratch](https://atlas.motionapplied.com/developer-resources/atlas/display-api/devguide/createfromscratch/): The following steps demonstrate how to create a custom display plugin from scratch. - [Enhanced Diagnostic display](https://atlas.motionapplied.com/developer-resources/atlas/display-api/devguide/diagnostic/): A useful way to explore the features of the Display API is to create a diagnostic display to exercise various aspects of the API and log information when interacting with the display and view the resu - [Numeric Compare display](https://atlas.motionapplied.com/developer-resources/atlas/display-api/devguide/numericcompare/): This tutorial demonstrates the use of Composite Data Requests for Compare Sets. - [Graphical display](https://atlas.motionapplied.com/developer-resources/atlas/display-api/devguide/graphical/): This tutorial demonstrates how to create a display with interactive graphics, as the saying goes "a picture is worth a thousand words". - [Gauge display](https://atlas.motionapplied.com/developer-resources/atlas/display-api/devguide/gauge/): Many displays just need to visualize the current value (at the cursor) of one or more display parameters. - [Deployment Script](https://atlas.motionapplied.com/developer-resources/atlas/display-api/devguide/deploymentscript/): To aid development efficiency, automatically copy the custom display plugin DLL to ATLAS program files after each successful build. - [Display Plugin Library](https://atlas.motionapplied.com/developer-resources/atlas/display-api/devguide/displaypluginlibrary/): The display plugin library provides base and utility classes that reduce the overall effort needed to create a custom display. - **Enhancing Displays** - [Factories and Services](https://atlas.motionapplied.com/developer-resources/atlas/display-api/factoriesandservices/): The following are the factories and services provided by the Display API - [Initialization, state and notifications](https://atlas.motionapplied.com/developer-resources/atlas/display-api/initialization/): The following methods and properties of DisplayPluginViewModel provide display initialization, state and notifications - [Working with Display Properties](https://atlas.motionapplied.com/developer-resources/atlas/display-api/displayprops/): Display properties can be edited within the properties window and/or persisted to the workbook. - [Working with Sessions](https://atlas.motionapplied.com/developer-resources/atlas/display-api/sessions/): A Session is a collection of data samples obtained from a data source. - [Working with Timebase and Cursor](https://atlas.motionapplied.com/developer-resources/atlas/display-api/timebasecursor/): The timebase is the currently visible timestamp range that determines the extent of parameter values displayed by various standard displays such as Waveform, Scatterplot, Histogram etc. - [Working with Display Parameters](https://atlas.motionapplied.com/developer-resources/atlas/display-api/parameters/): By default, display parameters cannot be added to the display. - [Working with Data](https://atlas.motionapplied.com/developer-resources/atlas/display-api/data/): The following services are required to retrieve parameter data - [Good Citizenship](https://atlas.motionapplied.com/developer-resources/atlas/display-api/goodcitizenship/): A custom display should be written to look, behave and act just like the standard displays shipped with ATLAS. - **Further Information** - [Core API](https://atlas.motionapplied.com/developer-resources/atlas/display-api/coreapi/): The display API shares some core functionality with ATLAS internal APIs - [API Limitations](https://atlas.motionapplied.com/developer-resources/atlas/display-api/limitations/): The Display API currently has the following limitations - [Model-View-ViewModel (MVVM)](https://atlas.motionapplied.com/developer-resources/atlas/display-api/mvvm/): MVVM is a popular software architecture pattern commonly used with WPF applications - [Display API prerequisites](https://atlas.motionapplied.com/developer-resources/atlas/display-api/prerequisites/): - Visual Studio 2019 with the .NET desktop development workload installed - [API Reference](https://mat-docs.github.io/Atlas.DisplayAPI.Documentation/index.html) - **Migration Guides** - [.NET 6 Upgrade](https://atlas.motionapplied.com/developer-resources/atlas/migration/net6-upgrade/): From ATLAS (11.4.4.349-W47) and SQL RACE (2.1.25308.1-ci) please see .NET 8 Upgrade - [.NET 8 Upgrade](https://atlas.motionapplied.com/developer-resources/atlas/migration/net8-upgrade/): The ATLAS client (11.4.4.349-W47) and SQL RACE (2.1.25308.1-ci) is now updated to .NET 8. - **RTA** - [Introduction](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/): This section is a detailed guide to the RTA API, Toolkit Services and their gRPC APIs. - **Services Reference** - [Overview](https://atlas.motionapplied.com/developer-resources/rta/services/): These services provide turn-key implementations for RTA functionality. - **Server** - [README](https://atlas.motionapplied.com/developer-resources/rta/services/rta-server/): This service is part of the RTA Toolkit Services suite. - [gRPC APIs](https://atlas.motionapplied.com/developer-resources/rta/services/rta-server/grpc/): rta-server packages up three capabilities into a single process: - **Session Service** - [README](https://atlas.motionapplied.com/developer-resources/rta/services/rta-sessionsvc/): This service is part of the RTA Toolkit Services suite. - [gRPC API](https://atlas.motionapplied.com/developer-resources/rta/services/rta-sessionsvc/grpc/): The service provides this private gRPC API to create and manage sessions. - **Config Service** - [README](https://atlas.motionapplied.com/developer-resources/rta/services/rta-configsvc/): This service is part of the RTA Toolkit Services suite. - [gRPC API](https://atlas.motionapplied.com/developer-resources/rta/services/rta-configsvc/grpc/) - **Data Service** - [README](https://atlas.motionapplied.com/developer-resources/rta/services/rta-datasvc/): This service is part of the RTA Toolkit Services suite. - [gRPC API](https://atlas.motionapplied.com/developer-resources/rta/services/rta-datasvc/grpc/) - **Gateway Service** - [README](https://atlas.motionapplied.com/developer-resources/rta/services/rta-gatewaysvc/): This service is part of the RTA Toolkit Services suite. - **Stream Service** - [README](https://atlas.motionapplied.com/developer-resources/rta/services/rta-streamsvc/): This service is part of the RTA Toolkit Services suite. - **Schema Mapping Service** - [README](https://atlas.motionapplied.com/developer-resources/rta/services/rta-schemamappingsvc/): This service is part of the RTA Toolkit Services suite. - [gRPC API](https://atlas.motionapplied.com/developer-resources/rta/services/rta-schemamappingsvc/grpc/) - **Influx Data Service** - [README](https://atlas.motionapplied.com/developer-resources/rta/services/rta-influxdatasvc/): This service is part of the RTA Toolkit Services suite. - **Worked Guide** - **Tutorials** - [Prerequisites](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/tutorials/prerequisites/): Before completing these tutorials, you'll need a few things. - **01: Quick-Start** - [Walkthrough](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/tutorials/quick-start/): This tutorial creates a simple data environment for ATLAS to connect to. - [Review](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/tutorials/quick-start/review/): Complete the Walkthrough first. - **02: Microservices** - [Walkthrough](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/tutorials/microservices/): This tutorial converts the Quick-Start Tutorial deployment from RTA Server into microservices. - [Review](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/tutorials/microservices/review/): Complete the Walkthrough first. - **03: InfluxDB Data Adapter** - [Walkthrough](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/tutorials/influx/): This tutorial stores and serves data directly from InfluxDB, using the microservices architecture introduced in Tutorial 02. - [Review](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/tutorials/influx/review/): Complete the Walkthrough first. - **04: Live Streaming** - [Walkthrough](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/tutorials/live/): This tutorial demonstrates live streaming to ATLAS, using InfluxDB, and building on the architecture from Tutorial 03. - [Review](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/tutorials/live/review/): Complete the Walkthrough first. - **05: Custom Data Adapter** - [Walkthrough](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/tutorials/data-adapter/): This tutorial demonstrates creating a Data Adapter service, to support a custom data source. - [Review](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/tutorials/data-adapter/review/): Complete the Walkthrough first. - **Working with Sessions** - [Session Basics](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/sessions/): Sessions are a logical way to organise telemetry — like a file system. - [Session Model](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/sessions/model/): This page describes all the properties on the RTA JSON Session model. This is the representation in the OpenAPI specification and consumed by ATLAS. - [Session Service](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/sessions/session-service/): Explore the gRPC API using gRPC UI. - [Relationships](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/sessions/relationships/): Child sessions[^1] are additional data sets that can be loaded together with a parent session. - [Listing and Queries](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/sessions/queries/): The RTA API provides paginated session listing, with sorting and filtering. - [Folders](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/sessions/folders/): RTA can represent sessions in a virtual folder structure. - [Session Metamodel](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/sessions/metamodel/): The metamodel[^1] enables the service to describe what session properties are available and what values they can take. - [Data Bindings](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/sessions/data-bindings/): When deploying Microservices, you need to create a binding linking sessions to data. - **Working with Configuration** - [Configuration Basics](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/configuration/): ATLAS/RTA Configuration is a rich schema decribing the telemetry. - [Channels and Parameters](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/configuration/channels-parameters/): Parameters are the abstraction for accessing sampled data. - [Parameter Groups (tree)](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/configuration/parameter-groups/): Parameters can be arranged in a tree. - [Conversions](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/configuration/conversions/): Conversions are rules for transforming raw data into calibrated engineering data. - [Event Definitions](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/configuration/event-defs/): Instantaneous changes are captured using Events. - [Serializing JSON/FFC](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/configuration/serializing/): RTA provides two configuration formats: - [Publishing to the Config Service](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/configuration/publishing/): The gRPC API provides two service calls to publish configuration: - **Working with Data** - [Data Basics](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/data/): RTA supports four data representations: - [Schema Mappings](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/data/schema-mappings/): Schema Mappings describe transformations from a data store schema to the RTA domain model. - [Chunks](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/data/chunks/): The RTA API streams data to the client in Chunks. - **Live-Streaming Data** - [Live-Streaming Basics](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/live/): RTA live streaming enables a client to follow the leading edge of a live session without polling. - [WebSocket Protocol](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/live/websockets/): The ATLAS client opens a dedicated WebSocket connection for each Session in the #!json "open" state. - [Streaming to Redis](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/live/redis/): Redis Streams provides a buffer between telemetry ingest and the Stream Service implementing the WebSocket protocol. - **Protobuf Schemas** - [Overview](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/protobuf/): RTA models size/performance-sensitive data in Google Protocol Buffers. - [model_data.proto](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/protobuf/model_data/): This IDL describes all the types described in Data Basics. - [net_chunks.proto](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/protobuf/net_chunks/): This IDL is used as part of the protocol for downloading data from the REST API. - [net_stream.proto](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/protobuf/net_stream/): This IDL is used in WebSocket communications for live streaming data from the Stream Service. - **Useful Utilities** - [Overview](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/utilities/): gRPC UI is exceptionally useful for exploring the Toolkit Services. - [Downloads](https://atlas.motionapplied.com/developer-resources/rta/downloads/): These services provide an implementation toolkit covering some or all of the functionality in the RTA API Specification. - **REST API** - [Overview](https://atlas.motionapplied.com/developer-resources/rta/api/) - [FAQ](https://atlas.motionapplied.com/developer-resources/rta/worked-guide/faq/): No — the API Specification is language-neutral. The Toolkit Services communicate via gRPC, so they are also language-neutral. - [ATLAS Dev Community](https://github.com/atlas-dev-hub) ## News and Release Notes - [News and Release Notes](https://atlas.motionapplied.com/blog/) - **Archive** - [2026](https://atlas.motionapplied.com/blog/archive/2026/) - [2025](https://atlas.motionapplied.com/blog/archive/2025/) - **Categories** - [Announcement](https://atlas.motionapplied.com/blog/category/announcement/) - [Blog](https://atlas.motionapplied.com/blog/category/blog/) - [Releases](https://atlas.motionapplied.com/blog/category/releases/) ## Downloads - [Downloads](https://portal.motionapplied.com/) ## Support - **Troubleshooting** - [Profiling](https://atlas.motionapplied.com/key-functionality/analyse/viewer/troubleshooting/profiling/): From version 11.2.3.460 onwards, ATLAS application now includes Jet Brains dotTrace and dotMemory profilers, which can be accessed via the Tools menu. This function allows users to take snapshots, whi - [Portal](https://portal.motionapplied.com/Tickets/New)