Options
SessionState Options Screen
The Options screen lets you view and change various ATLAS settings. These settings apply at a system level and are stored with the ATLAS installation, not on a Workbook basis.
To view the Options screen select Tools > Options.
General#
| Option Name | Description | Area | Default/Notes |
|---|---|---|---|
| Function Folder(s) | Specifies the directory where all user-defined Functions are loaded from and saved to. You can edit this path directly or browse to a folder. Changing this affects where ATLAS looks for and stores custom function scripts, which are used for data processing or automation. | Functions | C:\Users\USERNAME\Documents\McLaren Electronic Systems\SQL Race\Functions |
| Constants Folder Location | Sets the folder for loading and saving Constants, which are reusable values or parameters used in calculations or scripts. Like the Functions folder, this can be edited or browsed to. Ensures all constants are centralised for easier management and sharing. | Functions | C:\Users\USERNAME\Documents\McLaren Applied Technologies\ATLAS 10\Constants |
| Resolve without App Name | When enabled, allows parameters to be loaded from sources that use different Application Groups, so you can see and use channels even if the application names don’t match exactly. Useful for working with data from multiple sources or legacy systems. | Data | Off by default |
| Parameter Properties in Compare mode | Determines how parameter properties (such as units, scaling, etc.) are inherited when comparing multiple sessions: • Primary Session: Secondary sessions inherit properties from the primary session. • User Defined: Local changes to secondary session properties are retained. • Default Data: Properties stored within each session are loaded. Useful for ensuring consistency or flexibility in data comparison. |
Data | User selects mode |
| Recent Workbook Max Count | Sets the maximum number of recent Workbooks shown in the File > Recent Workbooks menu, making it easier to quickly reopen frequently used files. | Workbook | 15 |
| Load Sessions with Workbooks | If enabled, when you open a Workbook, all sessions that were loaded when it was last closed are automatically reloaded. This helps restore your previous working context. | Workbook | Checkbox |
| Open Last Workbook when Starting | When enabled, ATLAS will automatically reopen the last opened or saved Workbook at startup, streamlining workflow continuity. | Workbook | Checkbox |
| Auto Fit Laps | In Compare Sets with multiple laps, this option aligns the start and end of each lap on the X-axis in the Waveform Display, making it easier to visually compare laps of different durations. | Workbook | Checkbox |
| Auto Fit Limit % | Sets the maximum percentage difference between laps that Auto Fit will stretch data to match. Prevents excessive distortion when aligning laps. Default is 5%. | Workbook | 5% |
| Load Recorders From | Determines whether saved Recorder configurations are loaded from the Workbook (unique to each file) or from a Local Configuration file (shared across all Workbooks). Useful for managing how recording setups are reused. | Workbook | LocalConfiguration |
| Remove set when last session unloaded | If enabled, deletes the current set when the last session is removed from it (except the final set). Helps keep the workspace tidy by removing empty sets. | Workbook | Checkbox |
| Workbook Folder Enabled | Allows you to specify a dedicated folder for storing Workbook files, improving organisation and backup management. | Workbook | Checkbox |
| Workbook Backups Enabled | Enables automatic, regular backups of your Workbook files to a specified folder, providing data recovery in case of corruption or accidental changes. | Workbook | Checkbox |
| Workbook Backups Folder | Sets the directory where Workbook backup files are stored. You can edit or browse to this folder. Ensures backups are kept in a known, safe location. | Workbook | C:\Users\USERNAME\Documents\McLaren Applied Technologies\ATLAS 10\Automatic Workbook Backups |
| Number of backups to keep per workbook | Specifies how many backup copies of each Workbook are retained. When the limit is exceeded, the oldest backups are deleted. Helps manage disk space while ensuring recovery options. | Workbook | 5 |
| Waveform Data Request | Sets the frequency (in Hz) at which data is requested for Waveform displays. Higher rates provide more real-time updates but may use more resources. | Performance | 0.5–10 Hz (default 5 Hz) |
| Backfill Request | Determines the time window (in seconds) for backfilling gaps in live telemetry data on the Waveform. Ensures continuity in data display during brief interruptions. | Performance | 1–10 sec (default 3 sec) |
| Statistics Data Request | Sets the update rate for statistics (Lap, Display, Session, Reference). Options are Low, Medium, or High, balancing performance and responsiveness. | Performance | Medium |
| Waveform Display Refresh | Controls how often the Waveform Display is refreshed (in Hz). Higher rates give smoother updates but may impact performance. | Performance | 10–20 Hz (default 15 Hz) |
| Scatterplot Data Request | Sets the frequency (in Hz) for requesting data for Scatterplot displays. Balances update speed and resource usage. | Performance | 0.5–5 Hz (default 2.5 Hz) |
| Scatterplot Display Refresh | Determines how often the Scatterplot Display is refreshed (in Hz). | Performance | 10–20 Hz (default 10 Hz) |
| Renderer | Selects the rendering mode for ATLAS: • Hardware Accelerated: Uses GPU for best performance. • Balanced: Mix of performance and compatibility. • Software: CPU rendering, recommended for virtual machines or systems without suitable GPU. |
Performance | Hardware Accelerated/Balanced/Software |
| Tcp Port Number | Sets the TCP port for the Automation API server, which allows external clients to connect and control ATLAS programmatically. Change if the default port is in use. | Automation Service | 9089 |
| Authorization Port Number | For users with an RTA License, sets the OAuth 2.0 port for authentication. Adjust if needed for network or security requirements. | Service Connections | 59511 |
| Tab Side | Changes which side of the screen the workbook page tabs are displayed (e.g., top, bottom, left, right), allowing for custom workspace layouts. | Appearance | - |
| Tab Overflow | Determines how workbook page tabs behave when there are too many to fit on the screen: • Menu: Overflow tabs in a dropdown. • Shrink: Shrinks tabs to fit. • ShrinkWithMenu: Shrinks tabs and uses a menu for overflow. • Scroll: Adds scroll arrows. • ScrollWithMenu: Combines scroll and menu. |
Appearance | - |
| Extension | Defines the file extension for text files imported as sessions (e.g., .csv, .txt, .asc). Must include the dot. | Text Session Format | - |
| Total Header Line | Sets the number of header lines in the imported text file. Must be at least one; extra lines can contain metadata or comments. | Text Session Format | - |
| Parameter Line | Specifies the line number where parameter definitions start in the text file. | Text Session Format | - |
| Group Line | Indicates the line number for parameter groups. Set to 0 if not used. | Text Session Format | 0 if not used |
| Date Exists | Specifies whether each data line includes a date column. If enabled, the first column is the date, second is the timestamp. | Text Session Format | - |
| Time Format | Sets the format for timestamps in imported text files (e.g., DateTime, Milliseconds, Seconds, Time). | Text Session Format | - |
| Delimiter | Sets the character used to separate columns in the text file (Tab, Space, Comma, Semicolon). | Text Session Format | - |
| Unit | Specifies the line number where units are defined in the text file. | Text Session Format | - |
| Lap Marker | Sets the parameter name used to identify laps in the text file. When the value changes, ATLAS creates a lap marker. | Text Session Format | - |
| Mapping Mode | Lets you manage the mapping mode for the X-axis in Waveform Displays (e.g., Time or Distance). Plugins can add new modes. You can reorder, add, or remove mapping plugins. | X Axis Mapping | Controlled by plugins |
| Crash Report Folder | Sets the directory where crash reports are saved. You can edit or browse to this folder. Used for diagnostics and troubleshooting. | Crash Reports | C:\Users\USERNAME\Documents\McLaren Applied Technologies\ATLAS 10\Crash Reports |
| Number of crash reports to keep | Specifies how many crash reports are retained in the folder. Oldest reports are deleted when the limit is exceeded. | Crash Reports | 10 |
| Watchdog TCP Port | Sets the TCP port for the ATLAS Watchdog, which monitors application health and can generate crash reports. | Crash Reports | 9092 |
Diagnostics#
| Option Name | Description | Area | Default/Notes |
|---|---|---|---|
| Application Insights (Allow collection of Metrics and Error data) | When enabled, this option allows ATLAS to share performance metrics and logged exceptions with McLaren Applied for product improvement and troubleshooting. No personally identifiable information (PII) is shared. This helps McLaren Applied monitor application health and usage trends, but preserves user privacy. | Metrics | Off by default. Toggle as needed for support or analytics. |
| ATLAS Logging Level | Sets the level of detail for log messages written to ATLAS log files. Each level includes all levels below it: • Trace: Extremely detailed logs, including code execution paths and algorithm steps. Intended for development or deep troubleshooting. • Debug: Detailed logs for debugging, including variable states and configuration. • Info: Logs significant events indicating normal operation (e.g., service start/stop). • Warn: Logs events that could become issues if not addressed (e.g., high resource use). • Error: Logs significant problems that affect operations but do not stop the application (e.g., failed API calls). • Off: Disables logging entirely. |
Logging | Default is Info. Trace is only recommended for support/development. |
| Logfile Path | Specifies the folder where ATLAS log files are stored. You can set this to any accessible directory. Useful for organising logs or directing them to a monitored location for support. | Logging | User-defined. |
| Max Archive Files | Sets the maximum number of archived log files to keep alongside the current active log file. When the limit is reached, the oldest archives are deleted. This helps manage disk space while retaining recent log history for troubleshooting. | Logging | Default is 9. |
| Archive Above Size | Sets the file size threshold (in bytes) at which a log file is archived and a new log file is started. Prevents log files from growing too large. Default is 10MB (10,485,760 bytes). | Logging | Default is 10MB (10485760 bytes). |
| SQL Race Logging Level | Sets the logging level specifically for SQL Race data, using the same levels as ATLAS Logging Level (Trace, Debug, Info, Warn, Error, Off). Allows for separate control of logging detail for SQL Race operations, which may be useful for diagnosing database-related issues. | Logging | Default is Info. Trace is only recommended for support/development. |
Plugins#
| Option Name | Description | Area | Default / Limits / Notes |
|---|---|---|---|
| Alarm library | Folder location of the alarm library used by ATLAS. | Alarms | Default: C:\Users\[username]\Documents\McLaren Applied Technologies\ATLAS 10\Alarms. Editable path. |
| Additional Alarm File | Path to an extra alarm definition file to load alongside the main alarm library. | Alarms | Editable file path. |
| Alarm Popup Mode | Controls how alarm pop‑ups are shown: Per Alarm, Per Occurrence, or Shared. | Alarms | Choose one of the three modes. |
| Delayed Range | Sets the look‑back time window for alarms “behind the leading edge.” | Alarms | Default 3 s; min 2 s; max 5 min. Note: Increasing above default can degrade live telemetry performance. |
| Should Auto‑Refresh | Enables/disables automatic refresh of the Session Browser’s session list. | Session Browser | Disabled by default. |
| Auto Refresh Interval (seconds) | Interval, in seconds, for automatic Session Browser refresh when enabled. | Session Browser | Default 300 s. |
| Filters Display Limit | Maximum number of filter results returned in Session Browser. | Session Browser | Default 100. |
| Session Query Result Limit (Sessions) | Maximum number of sessions returned when databases/folders are selected in Session Browser. | Session Browser | Default 1000. |
| Circuits Location | Directory containing circuit definition files (*.ckt/*.cktx). |
Circuit Display | Editable directory; example shown T:\Circuits. |
| X‑Axis Mapping | Which X‑axis mapping the Circuit Display uses (e.g., time/distance); mappings are configured under Options → X Axis Mapping. | Circuit Display | Example shown: DistanceModeMapping (sLap). |
| Circuit Location Parameter Name | Parameter used to define circuit location. | Circuit Display | Default: NEventLocation. |
| End of Straight Parameter | Parameter used for “End of Straight” calculations. | Circuit Display | Default: vCar:Chassis. |
| Global Circuit Definition | Choose a specific global circuit definition from the Circuits location, or allow automatic selection on session load. | Circuit Display | Auto/manual selection. |
| Circuit Generator — Parameters | Parameters the generator uses to infer circuit size/shape. | Circuit Display | Defaults: vCar:Chassis (speed) and gLat:Chassis (lateral‑G). |
| Circuit Generator — Shape/Invert/Rotation | Controls for the generated circuit’s shape (e.g., circle/figure eight/open), inversion, rotation. | Circuit Display | Editable controls. |
| Circuit Generator — Generation Settings | Gain and Offset applied to generated circuits. | Circuit Display | Tunable numeric values. |
| Bit Configuration File | File path to the Bit Display configuration file used by the Bit Display plugin. | Bit Display | Editable file path. |
| Maximum Number of Parameters | Caps the number of parameters that can be added to a Scatterplot Display. | Scatterplot Display | Recommended: 24. Increasing may cause performance issues. |
| Session Details Tooltip Limit | Max number of session‑detail properties that can be selected/saved for the F1 Timeline’s Session Details tooltip. | F1 Timeline | Default 5; min 0; max 20. |
| Snapshots Directory | Directory where Summary Display snapshot images (from the Snapshot generator) are stored. | Summary Display | Editable directory. |
| Hide Windows cursor when dragging waveform | Hides the Windows cursor while left‑click + dragging the time/distance cursor on the Waveform Display. | Waveform Display | Toggle option. |
| Enable Grid Scrolling | Waveform gridlines scroll with the leading edge during live or historical replay. | Waveform Display | Toggle option. |
| Event Tracking Mask | Selects an event for use with Next/Previous event keyboard shortcuts on the Waveform. | Waveform Display | Choose event parameter. |
| Maximum Number of Parameters | Caps parameters that can be added to a Waveform Display. | Waveform Display | Recommended: 100. Increasing may cause performance issues. |
| Date / Data Notation | For sessions spanning multiple days, controls how the date appears in the Waveform title bar (e.g., “Day 1” vs DD/MM/YYYY). |
Waveform Display | Example default shown: DayNumber. |
| Context Menu & Key Shortcut Statistic Level | Sets whether Right‑click and keyboard‑shortcut statistics apply at Lap, Session, or Display level. | Waveform Display | Example default shown: Lap. |
| Override … for Reference Cursor | Allows the Reference Cursor level (applied with R) to override the chosen Context Menu/Shortcut statistics level. |
Waveform Display | Toggle option. |
| Raw Files Path | Folder path for RAW files used by the PCU Dash Display. | PCU Dash Display | Example shown: T:\PCU8. |
| LED Status Light parameter name | Parameter used by PCU Dash for the LED Status Light. | PCU Dash Display | Example shown: NLEDStatusAll. |
| Auto map CAN parameters (by name) | Automatically maps CAN parameters by matching names, simplifying setup. | PCU Dash Display | Toggle option. |
| CAN Bus Identifier | Identifier number for the CAN bus used by the PCU Dash Display. | PCU Dash Display | Example shown: 7. |
Recorders#
| Option Name | Description | Area | Default / Notes |
|---|---|---|---|
| Server Listener IP | IP address for the SQLRace database server listener, used for remote access and live data recording. | SQLRace | Default: 127.0.0.1 |
| Server Listener Port | Port number for the SQLRace database server listener. | SQLRace | Default: 7381 |
| Data Server buffer size (MB) | Size of the storage buffer in the client for incoming data. Larger values help prevent data loss if network communications are poor. | Recording | Default: 20MB |
| Data Server connection timeout (ms) | Time ATLAS waits for data from a data server before stopping recording. | Recording | Default: 20000ms |
| Data Server retries enabled | Allows the client to retry loading data from the network if enabled. | Recording | Default: Unchecked |
| Data Servers | List of ATLAS Data Server names and corresponding ports (format: {Server:Port}). | Recording | Default: Empty |
| Server auto-refresh frequency (ms) | Interval between refreshing the list of current data servers (0 disables). | Recording | Default: 2000ms |
| Server auto-refresh reply timeout (ms) | Time before a data server is deemed offline if no activity is detected. | Recording | Default: 100ms |
| Server Reply Timeout (ms) | Time ATLAS waits for a reply from a data server. | Recording | Default: 3000ms |
| Timeout for searching for Data Servers (ms) | Time allowed to find data servers. | Recording | Default: 3000ms |
| Wide Band local address | Specifies which network card to use for sending/receiving data; shows all available IP addresses. | Recording | Default: ANY |
| Auto-Dismiss Config Search Box | Automatically closes the config search box if checked. | General | Default: Checked |
| Auto Increment Run Number | Automatically increments the session number for sequential recordings (e.g., R1, R2, ...). | General | Default: Unchecked |
| Auto Record Connection Check Interval (ms) | Time ATLAS waits before stopping automatic recording. | General | Default: 1000ms |
| Default disabled 'Still Processing Parameters' to continue | If enabled, ATLAS will auto-select continue/cancel if a recording is running when closing and the dialog is disabled. | General | Default: Unchecked |
| DTV offload exclusion list | Comma-separated list of DTVs to exclude from offload at end of recording. Supports formats: application-name, unit-name.application-name, unit-name.* | General | Default: Blank |
| DTV rename cached files | If checked, cached DTV files not uploaded will include "_Cached" in the filename. | General | Default: Unchecked |
| Enable 'still processing parameters' dialog | Warns if parameter processing from config files is incomplete when recording ends prematurely. | General | Default: Checked |
| Enable FTP Download | Enables offloading PGVs from FTP server as part of Ethernet Multi-Session Offload. | General | Default: Unchecked |
| Enable Logging CAN Data | Enables CAN data logging in live recordings. | General | Default: Unchecked |
| Enable Pre-build Configuration | Enables fast start by ignoring pre-cached PGVs. | General | Default: Unchecked |
| Low Disk Space Warning Threshold (MB) | Warns when free disk space drops within this threshold of the minimum disk space. | General | Default: 100MB |
| Minimum Disk Space (MB) | Minimum free disk space required during recording. Recording stops if below this value. | General | Default: 500MB (minimum allowed) |
| PGV exclusion list | Comma-separated list of PGVs to exclude from processing at start of recording. Same formats as DTV exclusion. | General | Default: Blank |
| PGV inclusion list | Comma-separated list of PGVs to include in processing at start of recording. Takes priority over exclusion list. | General | Default: Blank |
| PGV stand-alone list (HEX) | List of stand-alone PGVs in hexadecimal format. | General | Default: Blank |
| Polling Frequency to check available space (s) | How often to check available disk space. | General | Default: 5 seconds |
| Quad sources excluded from lap trigger | Streams (comma-separated) to exclude from lap trigger detection. | General | Default: Blank |
| Record only LIVE data | If checked, recording stops as soon as telemetry is uploaded. Requires "Enable Update Progress on clients" to be checked. | General | Default: Unchecked |
| Record telemetry data from start | If checked, session includes data from start of Data Server recording; otherwise, only from when ATLAS recording starts. | General | Default: Unchecked |
| Recording event script | Script executed on recording events (LIVE_STARTED, LIVE_STOPPED, OFFLOAD_STARTED, OFFLOAD_STOPPED). Format: 'script.exe EventId Argument'. | General | Default: Blank |
| Separate vTAG Session | Splits incoming DST recording with master and VTS data into two sessions. | General | Default: Unchecked |
| Temporary directory for recording files | Directory for temporary storage of session files during recording. If blank, files are written directly to data path. | General | Default: Blank |
| Unload unused PGVs on start recording | Removes PGVs from cache when recording starts. | General | Default: Unchecked |
| Virtual memory block size (KB) | Virtual memory slot size for memory mapping. | General | ATLAS: 5120KB, ADS: 1024KB |
| Warn When Config is Missing | Warns if logging config is missing for loaded session. | General | Default: Checked |
| Wideband minimum lap time | Minimum allowed time between lap triggers (>0s). | General | Default: 10 seconds |
| Live data feed retrieval path | Directory for storing intermediate LDR files when using LDF. | Live Data Feed | Default: <Drive>:\Users\<user>\Documents\My Documents\McLaren Electronic Systems\ATLAS 9\LDS\ |
| PGV request timeout (s) | Max time to wait for requested PGV files via LDF. | Live Data Feed | Default: 30s |
| Log file folder | Directory for log files. | Logging | Default: <Drive>:\Users\<user>\Documents\McLaren Electronic Systems\ATLAS 9\log |
| Message log file size (MB) | Log file size limit; new file created when limit reached. 0MB = unlimited. | Logging | Default: 0MB |
| Message log level (for debugging) | Logging level for developer/debugging diagnostics. | Logging | Default: 'Not Logging' |
| Raw data logging | Saves raw data received during recording for telemetry diagnostics (.raw and .raw_tm files). | Logging | Default: Unchecked |
| Raw data root folder | Default folder for raw data logging files. In addition, if the session folder path in the recorder is not blank then it will also append that session folder name on to the default raw data root folder. e.g. Raw data root folder = C:\Server\Data and the recorder's Session folder is C:\Recorder then the path used will be C:\Server\Data\Recorder | Logging | Default: Blank |
| Sequence number anti-wrap time (hours) | Threshold for unwrapping sequence numbers if packet time is much earlier than latest. | Telemetry | Default: 0 (Disabled) |
| Telemetry guard filter length | Synchronisation length for telemetry guard. | Telemetry | Default: 10 |
| Telemetry guard time (s) | Rejects data if timestamp difference between packets exceeds this value. | Telemetry | Default: 0 seconds |
| Unit Comms Default Timeout (ms) | Default timeout for unit communications. | Telemetry | Default: 200ms |
| Ethernet buffer size (MB) | Local cache size for Direct Ethernet Wirelink. | Telemetry | Default: 5MB |
| Ethernet offload connection retries | Number of times to retry reconnecting during offload if connection lost. | Telemetry | Default: 10 |
| Ethernet receive timeout (ms) | Time to wait before retrying a receive message. | Telemetry | Default: 500ms |
| Ethernet retries | Number of times to retry a message before aborting and displaying a warning. | Telemetry | Default: 1 |
| Ethernet send timeout (ms) | Time to wait before retrying a send message. | Telemetry | Default: 500ms |
| Ethernet upload config unique response | Must match client-specific BIOS configurations. | Telemetry | Default: Unchecked |
| Ethernet upload message extended timeout (ms) | Time before Quad Ethernet Telemetry offload times out. | Telemetry | Default: 500ms |
| Ethernet upload message interval timeout (ms) | Time before Quad Ethernet Telemetry data is re-requested during upload. Auto-extends if data is received outside this timeout. | Telemetry | Default: 3ms |
| System Monitor base folder | Folder for System Monitor files. Multiple paths allowed (separated by semicolon). | System Monitor Folders | Editable |
| Logging configuration folder | Folder for logging configuration files (must be ATLAS\Config\Logging\AutoConfig). Multiple paths allowed. | System Monitor Folders | Editable |
| Car definitions file | Location and filename for car definitions, which define network communication for cars. | System Monitor Folders | Editable |
| Ancillary parameters folder | Folder for Logging Configurations created in System Monitor. Controls which parameters are logged and how. | System Monitor Folders | Editable |
| Parameter Unlock List folder | Folder where ATLAS searches for Parameter Unlock Lists. | System Monitor Folders | Editable |
| Custom PGV folder | Folder where ATLAS stores received PGV files. | System Monitor Folders | Editable |
| Configuration Folder | Folder for MAT.Atlas.TCPRecorder if using TCP listener recorder. | Folders | Editable |
| Default Data Path | Default path where sessions are stored unless overridden. | Folders | Editable |
| Decode DLLs (per stream) | Path to decode DLL for each of 16 streams (00–15) for processing generic data sources. Can browse or reset to default (AtlasApiDecoder64.dll). | Decode DLLs | Default: CustomDLLs\AtlasApiDecoder64.dll |
| Debug Decode DLL | Allows decode DLL to crash and generate a memory dump for debugging. | Decode DLLs | Checkbox |
| Stream Server Configurations | List of Stream Server configurations for the Stream Recorder. | Stream Recorder | Editable |
| Friendly Name | Name for the Stream Server configuration. | Stream Recorder | User-defined |
| Broker URL | URL and port of the broker for the Stream Server. | Stream Recorder | User-defined |
| Stream Port | Port of the Stream Server. | Stream Recorder | User-defined or default |
| Stream Creation Strategy | Strategy for stream creation in the broker: TopicBased (each stream is a topic) or PartitionBased (streams are partitions in one topic). Must match broker. | Stream Recorder | TopicBased or PartitionBased |
| Partition Mapping | Maps streams to partition numbers (only for PartitionBased strategy). Must match broker mapping. | Stream Recorder | User-defined |