Intro

The user interface is a web application built around Bokeh that provides various graphs and statistics commonly used for suspension setup purposes.

The title bar shows the name and start time of the currently loaded session, while the main area is used to display various graphs / plots for it.

Sessions can be loaded by clicking on the "hamburger" icon in the upper left corner.

Toolbar

The upper right corner has a toolbar with the following buttons:

• Login: Right now the application has a simple authorization system. You are either logged in, and can import / delete / modify sessions, create bike setups and import GPX tracks, or not, and can only load sessions / videos. So there are no per-user sessions as of now.
• Load video: MP4 videos can be loaded in the browser (they are not stored on the server), and they are synced to the session based on timestamps. Sync might not be perfect, so you can use the z and x keys to decrease / increase delay. The Space bar can be used to start / stop the video.
• GPX import: GPS tracks can be imported as GPX files, which are also synced to the session based on timestamps. Unlike videos, GPS data is stored on the server, and if one GPX file overlaps with multiple sessions, you only need to import once. Requires authentication.
• Normalized session import: You can import sessions from CSV files containing normalized suspension movement data. Requires authentication.
• New bike setup: You can create new bike setups here by providing frame information and sensor calibration data. Requires authentication.

The bike setup and session import forms will be described in more detail in the getting started chapter.

Graphs / plots

Time - Travel

This graph gives an overall picture of suspension movement overthe recorded session. Head angle for the front, and leverage ratio for the rear suspension is considered, so the travel displayed is the vertical component of movement. You can select a portion of the graph, which updates all other graphs to include only the selected period.

Periods spent in the air are indicated with a red overlay, and are excluded from any statistics calculations.

Time - Velocity

This graph simply shows suspension velocity. Pan and zoom are synced with the travel graph.

Spring rate tab

This tab contains plots that need to be considered for setting spring rate.

Travel histograms show what percentage of the total time was spent in a given 5% long travel range. This graph can be used to evaluate and adjust suspension spring rate and progression. Knowing the average and maximum travel helps this assessment, so they are shown on the graph too, along with the number of bottom-outs.

Frequency diagrams display the Fourier-transformation of the time - travel data. I do not think this graph is really useful for a full run, but when filtered for e.g. a few bounces, it can show spring rate difference between the front and back, and it also might be useful when changing suspension (you can aim for a frequency that was good for the previous one).

Damping tab

Damping relates to shaft velocity, so in this tab we display velocity-related plots.

Similarly to their travel counterparts, Speed histograms display what percentage of the total time was spent in a given 100 mm/s velocity range, and also show the average and maximum shaft velocity for both compression (positive values, bottom half of the graph) and rebound (negative values, top half of the graph).

Bar colors represent travel range percentages for a given velocity range (so they are basically another histogram). The main goal here is to make the graph as symmetric as possible - this is the reason the normal distribution curve is overlayed (dashed red line) as a sort of visual aid.

Next to these plots are zoomed-in Low-speed histograms that display information about shaft velocities below 200 mm/s with a 15 mm/s step.

Knowing what time percentage was spent in the HSR, LSR, LSC and HSC ranges is also useful. The Speed zones bars next to the histograms does exactly this. One thing to note here is that the low speed - high speed threshold is set to 200 mm/s based on my observations and information online, but I have no idea how close it is to the value suspension designers aim for.

Balance tab

The last pair of graphs are present only when a session has data from both the front and rear sensors. The reason is, that these Velocity balance graphs aim to show the balance between the front and rear for compression and rebound. I have first seen in a forum post that a travel - velocity graph could be very useful for this purpose, and then I found a bit more information in a MotionIQ blog post. Each dot represent a compression or a rebound event, the vertical axis showing the maximum velocity during the event, and the horizontal axis showing the at what travel percentage that maximum velocity occured. The lines are trend lines fitted on the dots, and the closer they are to each other, the more balanced the front and rear suspension is.

Miscellaneous information

A Leverage ratio and a Shock - Wheel movement graph is also displayed on the dashboard as well as the sessions's name and a textbox with arbitrary notes. The name, notes and suspension settings can be edited here if you are logged in.