Author Topic: MaxTM - A telemetry tool for GPB, MXB, WRS and KRP  (Read 12555 times)

HornetMaX

  • Hero Member
  • *****
  • Posts: 5616
    • View Profile
MaxTM - A telemetry tool for GPB, MXB, WRS and KRP
« on: May 28, 2014, 11:16:51 PM »
MaxTM is a telemetry tool for GPB, MXB, WRS and KRP: it allows to display graphs of the telemetry data exposed by GPB/MXB/WRS/KRP. It has two main components:
  • A GPB/MXB/WRS/KRP plugin: in charge to generate the telemetry data files.
  • A viewer application: in charge of displaying graphically the telemetry files saved by the plugin.


DOWNLOAD v1.16:  <<-- THIS if for GPB beta11, WRS beta11, KRP beta16 and MXB beta6


INSTALLATION
  • Download the archive from the link above and extract it somewhere. Inside the main folder you should have 4 extra folders: one for the plugin(s), one for the viewer and 2 folders with sample data.
  • Take the viewer folder (MaxTM_Viewer-vX.Y) and the 2 sample foders and put them somewhere (Desktop, Documents, wherever you have write rights). DON'T PUT THEM IN Program Files OR SIMILAR. The viewer is a portable app: it does not write anything in the registry, it requires no installation (in the Windows sense) and it won't ask you if you want to install a stupid toolbar.
  • Now run the viewer application (MaxTM_Viewer.exe and check it starts without issues. If it complains for missing dlls, you may need to install  Microsoft Visual C++ 2015 Redistributable Package (x86): once you press Download, select the x86 version "vcredist_x86.exe".
  • If you want to generate telemetry data from GPB/MXB/WRS/KRP you have to install the plugin: in the plugin folder (MaxTM_Plugin-vX.Y) you have 4 .dlo files (one each for GPB/MXB/WRS/KRP) and a folder named MaXTM_data. Just copy the appropriate .dlo and the MaXTM_data to the GPB/MXB/WRS/KRP plugins folder.
  • Restarting GPB/MXB/WRS/KRP and going to the track you should hear a heartbeat sound each time you start a run: this confirm that the telemetry logging is active.
  • You can also press 'Z' to see is if logging is currently ON or OFF, and CTRL+Z to toggle it ON/OFF. You can change the key in the .ini file of the plugin (MaxTM.ini, in the GPB/MXB/WRS/KRP data folder).
  • Telemetry log data will be saved (2 files per run) in folder MaxTM under GPB/MXB/WRS/KRP data directory (e.g. C:\Users\MaX\Documents\PiBoSo\GP Bikes).

IMPORTANT:
  • The telemetry file can be relatively big if you ride a lot. Remember to clean-up the MaxTM folder from time to time.
  • If you want to disable the plugin (for whichever reason), you simply rename it from .dlo to .dlo.off (or to .pizza) or edit the .ini file of the plugin (MaxTM.ini, in the GPB/MXB/WRS/KRP data folder) and set 'active' to false.

USAGE:
I'll briefly describe the main features here: there is no user manual yet (and maybe there will never be one), but the viewer is not too complicate.
  • The main areas of the main window have tooltips (i.e. little text explanations that appear when you leave the mouse still on them for a while): READ THEM.
  • The main areas of the main window have tooltips (i.e. little text explanations that appear when you leave the mouse still on them for a while): READ THEM (intentional repetition)
  • Seriously, read the tooltips: in particular the ones of the graphs and track map, as they explain how to interact with the graphs using the mouse. I could resume the thing here, but if I do it then you won't read the freakin' tooltips, so I won't do it  :P
  • On most areas a context menu is available: just right-click with the mouse.
  • The worst thing you could do with the viewer is delete some telemetry file: it's not a dangerous app, don't be afraid to try things around.
  • The general idea is:
    • You can open an arbitrary number of telemetry files at the same time. Each telemetry file will appear as a Run containing some Laps.
    • On the left you have the Runs/Laps as seen via the telemetry data, along with their lap times (as seen by the telemetry).
    • On the right (in the panel named Timings you have the same Runs and more or less the same Laps, with more or less the same lap times (as seen by GPB/MXB/WRS/KRP) and their split times.
    • Telemetry lap times come in two flavours: column "Lap Time" is based on GPB/MXB/WRS/KRP timing, column "Lap Time (w)" is based on an external timer which turns out to be more precise (I think it's some sort of bug, but I have no feedback on it from Piboso).
    • The telemetry lap times should more or less match the "official" lap times (the one in the Timings panel). Small errors are normal (up to 0.1-0.2 sec I'd say), larger ones are not.
    • The number of laps between the Runs/Laps panel and the Timings panel may not be identical: typically due to not completed laps, out of pits laps and so on. It's not too hard to see which lap in Runs/Laps corresponds to which lap in Timings.
    • In Runs/Laps you can select up to 4 laps (each one has a specific color): the 1st lap you you select will be the reference lap.
    • On the right you have (by default) one Graphs panel: here you can have the telemetry data plotted. You can have multiple graphs panels.
  • In each graphs panel, using the context menu (right-click), you can:
    • customize the number of graphs (as an N by M grid) and their appearance (axis labels, tick labels).
    • customize the each individual graph: delta plot (see later on), join/mark data points, show/position the legend etc.
    • customize what to plot on each graph on the X and Y axes (the variable on the X axis is the same for all the graphs in the panel)
    • Save the current layout of the graphs panel, so that you can reload it next time.
  • Delta graphs: a delta graph is simply a graph where instead of plotting (let's say) the speed against the position on the track (centerline) of the selected laps, you plot the difference in speed between the 1st selected lap (the reference lap) and the other selected laps. So if you have 4 selecte dlaps, on a normal plot you'll have 4 lines while on a delta plot you'll have 3 lines, each of them being the speed difference between selected lap 1 and selected laps 2, 3 and 4.
  • The viewer app comes with 2 themes: the default "bright" one (almost white background) and a darker one I find very handy at night (did I told you I average 4-5hrs of sleep per day ?).

I'll open another topic to gather your feedback on this: please try to keep this topic clean (just for new versions etc).

MaX.
« Last Edit: June 19, 2017, 08:42:20 PM by HornetMaX »

HornetMaX

  • Hero Member
  • *****
  • Posts: 5616
    • View Profile
Re: MaxTM - A telemetry tool for GPB and WRS
« Reply #1 on: May 29, 2014, 02:57:26 PM »
v1.1 out (that was a quckie):
  • Fix a silly bug leading to no lap recorded (kind of annoying) :)

MaX.

HornetMaX

  • Hero Member
  • *****
  • Posts: 5616
    • View Profile
Re: MaxTM - A telemetry tool for GPB and WRS
« Reply #2 on: June 05, 2014, 01:20:36 PM »
v1.2 out:
  • Now works for KRP too !
  • You can now toggle data logging ON/OFF in game: CTRL+Z to toggle ON/OFF, Z to show current status. The 'Z' can be changed to any letter, in the plugin .ini file.
  • A few misc bug fixes and changes (panels positioning, menu actions, menu names and shortcuts).

MaX.

janaucarre

  • Global Moderator
  • Hero Member
  • *****
  • Posts: 924
    • View Profile
Re: MaxTM - A telemetry tool for GPB, WRS and KRP
« Reply #3 on: June 05, 2014, 07:20:06 PM »
thx

Hawk

  • Hero Member
  • *****
  • Posts: 5881
  • MOD Team: CAWS / GP-Team: Horizon GP #7
    • View Profile
Re: MaxTM - A telemetry tool for GPB, WRS and KRP
« Reply #4 on: June 05, 2014, 07:25:22 PM »
Wow! You are quick on the draw Max! I haven't even had chance to play with your two previous versions yet. Hehe

Nice work... Well done mate!  ;D 8)

Alibaskins

  • Full Member
  • ***
  • Posts: 169
    • View Profile
    • www.motonline-france.com
Re: MaxTM - A telemetry tool for GPB and WRS
« Reply #5 on: June 06, 2014, 03:34:54 PM »
v1.2 out:
  • Now works for KRP too !
  • You can now toggle data logging ON/OFF in game: CTRL+Z to toggle ON/OFF, Z to show current status. The 'Z' can be changed to any letter, in the plugin .ini file.
  • A few misc bug fixes and changes (panels positioning, menu actions, menu names and shortcuts).

MaX.

Thks ;)

Même si sans maîtrise la puissance n'est rien, sans puissance, la maîtrise ne fait pas tout !

HornetMaX

  • Hero Member
  • *****
  • Posts: 5616
    • View Profile
Re: MaxTM - A telemetry tool for GPB, WRS and KRP
« Reply #6 on: June 14, 2014, 12:59:28 AM »
v1.3 out:
  • Fix a nasty bug on Close/Delete unselected runs (it was closing/deleting the selected ones ...  :-[ )

MaX.

HornetMaX

  • Hero Member
  • *****
  • Posts: 5616
    • View Profile
Re: MaxTM - A telemetry tool for GPB, WRS and KRP
« Reply #7 on: June 21, 2014, 12:53:15 AM »
v1.4 out:
  • Updated for GPB beta5 (no changes for WRS and KRP).

MaX.

HornetMaX

  • Hero Member
  • *****
  • Posts: 5616
    • View Profile
Re: MaxTM - A telemetry tool for GPB, WRS and KRP
« Reply #8 on: September 08, 2014, 09:41:00 PM »
v1.5 out:
  • Updated for WRS beta5 (no changes for GPB and KRP).

MaX.

HornetMaX

  • Hero Member
  • *****
  • Posts: 5616
    • View Profile
Re: MaxTM - A telemetry tool for GPB, WRS and KRP
« Reply #9 on: September 14, 2014, 06:31:46 PM »
v1.6 out:
  • Fix bug when track name contains a "." (thanks to Desteban for reporting)

MaX.

HornetMaX

  • Hero Member
  • *****
  • Posts: 5616
    • View Profile
Re: MaxTM - A telemetry tool for GPB, WRS and KRP
« Reply #10 on: September 15, 2014, 10:42:44 PM »
v1.7 out:
  • Fix bug affecting WRS only (no changes for GPB and KRP)

MaX.

janaucarre

  • Global Moderator
  • Hero Member
  • *****
  • Posts: 924
    • View Profile
Re: MaxTM - A telemetry tool for GPB, WRS and KRP
« Reply #11 on: September 19, 2014, 05:17:43 PM »
Thank you very much.

HornetMaX

  • Hero Member
  • *****
  • Posts: 5616
    • View Profile
Re: MaxTM - A telemetry tool for GPB, WRS and KRP
« Reply #12 on: December 16, 2014, 07:21:44 PM »
v1.8 out:
  • Updated for GPB beta6.
  • Switched to QCustomPlot 1.3beta (soved a nasty bug in TrackMap).
  • Better handling of "strange" cases (data files with diferent fields).
  • Better handling of tooltips.
  • Graph title instead of X/Y axes legends.
  • Customizable title & legend position.
  • Axes tick labels can be shown also on right/top axes and can be shown inside of the plot.
  • Various bug fixes.

MaX.

Hawk

  • Hero Member
  • *****
  • Posts: 5881
  • MOD Team: CAWS / GP-Team: Horizon GP #7
    • View Profile
Re: MaxTM - A telemetry tool for GPB, WRS and KRP
« Reply #13 on: December 16, 2014, 07:28:02 PM »
v1.8 out:
  • Updated for GPB beta6.
  • Switched to QCustomPlot 1.3beta (soved a nasty bug in TrackMap).
  • Better handling of "strange" cases (data files with diferent fields).
  • Better handling of tooltips.
  • Graph title instead of X/Y axes legends.
  • Customizable title & legend position.
  • Axes tick labels can be shown also on right/top axes and can be shown inside of the plot.
  • Various bug fixes.

MaX.

Thank you Max!!.... A brilliant job as usual mate. Appreciated!  ;) ;D

Hawk.

doubledragoncc

  • Hero Member
  • *****
  • Posts: 4384
  • If it dont fit HIT it!!!!!!!!!
    • View Profile
    • GPBOC Live Streams
Re: MaxTM - A telemetry tool for GPB, WRS and KRP
« Reply #14 on: December 17, 2014, 09:19:49 PM »
Thanks Max your a diamond m8

DD
GPBOC Live Streams: https://www.youtube.com/c/IASystemsComputerControls

Teamspeak: Server IP: 82.43.148.211  user password "yougetin"

i5 7600 5.0GHz z270 ASUS Maximus Code Mobo 16GB 3866MHz DDR4 RAM ASUS Strix GTX1050Ti OC 4GB DDR5 Kraken X62 AIO Cooler