Troubleshooting marker detection

Troubleshooting marker detection

Velogic Studio should be giving you a solid wireframe/skeleton:

... and the Quality Indicators should be showing "Good" for detection. 

If you're not getting that, this page will help you troubleshoot.

Look for red dots - any extra? Any missing?

If Velogic Studio can't find a valid skeleton from 7 (or 8) dots, it will instead show you red dots for the markers it did find.

You can watch as the rider pedals and see if one of the markers is occasionally not being shown as a red dot. If you notice that, adjust the problematic marker so that the camera can see it better. 
If you see additional red dots in the scene (like the one on the front wheel rim above), you may need to obscure it e.g. by covering with masking tape. Note that Velogic Studio can cope with some additional reflections, particularly if they're nowhere near a valid marker position; but if there are many additional reflections, or they are near a valid marker position, you will need to cover it up.

Check marker placement

Refer to our marker placement documentation. The markers need to be placed where the camera can see them directly. Common issues are:
  1. Shoulder marker placed too high
  2. Wrist marker rotated too far away from camera
  3. Heel marker (if used) too far down on the shoe

Check correct number of dots selected (7 or 8)

There's a configuration setting on Step 1 which tells Velogic Studio whether you're using 7 markers, or 8 (including a heel marker). Make sure that the setting matches the actual number of markers you're using.

Look for other reflections highlighted as red dots

  1. Logos or tabs on shorts, jersey and shoes
  1. Shiny parts on the bike
  1. Alloy rims
We have a lot of filtering in the detection process to eliminate the extra reflections and the high grade markers (the material printed on the VF-Tape is night-vision rated) are part of how we distinguish between wanted and unwanted reflections.

Unusually large/small/unusually-proportioned rider?

To help Velogic Studio filter out unwanted reflections, it has some internal rules to make sure that the skeleton formed by the markers could reasonably form a human body. Some of the rules are around proportionality, and some involve sizes of body segments.
Sometimes you may encounter a situation where a rider breaks one of our proportionality rules (more likely with very short or very tall riders). If you are seeing 7 (or 8) red dots, all in the correct place, but Velogic Studio is not producing a wireframe/skeleton, this may be the case for you.
To help us refine the rules, please submit a sample file which we will then investigate and use to tune the rules. See "Submitting a file for us to access" below.

Camera too far away?

If the camera is positioned more than around 8' from the plane of the bike, the dots may be too small for the camera to recognize.

Submitting a sample file for us to assess

If you are having issues with Marker Detection we have a simple process for submitting files for analysis.
Before you begin the process please ensure that the system has been calibrated and the bike measured (this data is saved in the file submitted and will help us troubleshoot).
When ready please click on the dropdown at the top left of the liveview:

Then click “Send a sample”
This popup will appear:

Click “Next” for the consent form. You will need to ask the rider if they consent to their data and image being used in our development process. The files will never be shared outside velogicfit.


Click “Next” to indicate what size upload you wish to provide. Note that the minimal option can sometimes mean that we can’t identify your issue. However, you will not be able to do anything else with the system while it is uploading so do not choose the full sample option if it means you will be waiting for 20mins for the upload to complete.

When you have selected a sample size, click Next and finish the wizard.
If your issue is urgent, please get in touch with us to let us know that you’ve submitted a sample, and what the problem was.
Here’s a video of the “Submit Sample” process:


    • Related Articles

    • Troubleshooting Velogic Studio

      If you can’t get any information at all from the Kinect, or the Kinect is disconnecting: check out our hardware compatibility guide and Kinect camera troubleshooting guide first. Once you're sure that the Kinect is working fine (i.e. the Kinect ...
    • Joint marker placement

      This is best performed with the rider on the bike. Before beginning to place the markers: Explain to customer that you will be placing markers on their joints so some physical contact will be required (this should also be explained in pre-fit ...
    • Webcams: Overview, FAQ, troubleshooting.

      Velogic Studio can show a liveview of, and record video from, any webcams that you have attached to your computer. How to configure webcams Step 1 of Velogic Studio is the configuration step. There's a section in step 1 to help you configure your ...
    • Signing in - troubleshooting

      Velogicfit's windows applications, Velogic Studio and 3D Aero, require you to sign into your Velogicfit account when the application starts. If you're having trouble signing in, this guide will help you to resolve your issue. How does the sign-in ...
    • ANT+ Overview & Troubleshooting

      If you have a ANT+ USB device plugged into your computer, Velogic Studio can use it to communicate with ANT+ sensors close to your computer. What does ANT+ support look like in Velogic Studio? Step 1 of Velogic Studio is the configuration step. ...