Access AiM Data Files with a DLL¶
Click here to download for a downloadable (and nicer) pdf copy of this page.
We’ve had requests in the recent past to open xrz/xrk files in order to access the data recorded by our devices using external software. It works (beta version) also with drk files. Most of the requests received till now were for MatLab(TM) or custom developed software.
We developed a DLL (32 and 64 bit) that lets users accomplish this task in a very easy way. You can download two complete examples to understand how to use the DLL.
Visual Studio 2022¶
Click here to download the example project.
Unzip the file content on your hard disk, then identify the "TestMatLabXRK.sln" file and open it with Visual Studio 2022. Compile it and run it, you should see a simple dialog window that lets you test all DLL functions.
All DLL functions are documented directly in the "MatLabXRK.h" file supplied. Few quick example hints are given in the following lines.
“DLL Version” has to be used to verify the DLL build time and date, that are prompted to you as soon as you click.
“Lap Times” are, as well as all other timing information, given in seconds.
“Vehicle”, “Racer”, “Championship” and “Venue Type” refer to data set by users into AiM loggers before the on track session, “Track” is automatically identified by the AiM loggers among all the tracks previously sent to them using RaceStudio 3, “Date & Time” refers to start acquisition and is managed by the loggers themselves.
Channels data values are available on a session timing base, or a lap timing base.
Logged channels are “according to device configuration”.
GPS raw channels are: “ECEF position_Y”, “ECEF position_Z”, “ECEF velocity_X”, “ECEF velocity_Y”, “ECEF velocity_Z”, “N Satellites”.
GPS channels are computed by the DLL upon GPS raw channels: “GPS_Speed”, “GPS_Nsat”, “GPS_LatAcc”, “GPS_LonAcc”, “GPS_Slope”, “GPS_Heading”, “GPS_Gyro”, “GPS_Altitude”, “GPS_PosAccuracy”, “GPS_SpdAccuracy”, “GPS_FreqAccuracy”, “GPS_East”, “GPS_North”.
MatLab (TM)¶
Click here to download the example project.
This example has been developed by:
Michael Metzner metzner software engineering https://www.metzner-se.com
Unzip the file content on your hard disk, then load/run the “XrkAccessExample.m” file to see an example of how the dll works.
- When calling the example script without any filename you’ll be asked
to select a XRK/XRZ file. Two sample files are supplied.
After loading the file you’ll have to select a lap, in a list that’s prompted to you.
After lap selection you’ll be prompted a list in which you have to select a data channel and the corresponding data are plotted.
Afterwards you’ll be asked to select a GPS channel and the corresponding data are plotted.
Finally you’ll be prompted to select a GPS raw data channel and the corresponding data are plotted.
Release History¶
October 12th, 2023¶
Added data recovery for GPS channels “Latitude” and “Longitude”.
Fixed bug recovering data for GPS raw channels “N_Satellites” and “ITOW”.
September 8th, 2023¶
Added function to initialize sampling time intervals for GPS computations.
September 6th, 2023¶
Fixed GPS channels sample rate at 10 Hz instead of 100 Hz.
Added function to get session duration.
September 5th, 2023¶
Improved error messages upon a bad opening of an xrk file.
Switch to usage of default temp directory to improve reliability of the dll when hooked up into MatLab (TM).