Troubleshooting Velogic Studio

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 Configuration Verifier is stable and giving 29-30 FPS), this this guide will help you troubleshoot application issues.

Wireframe does not appear automatically

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.
Check the placement of the markers:
  1. Check you have all 7 markers placed (see: Joint marker placement)
  2. Shoulder marker too high so it points upwards
  1. Wrist angling away from camera
  1. Foot marker point down
  1. Elbow marker folded over
Sometimes you may encounter a situation where a rider breaks one of our proportionality rules (more likely with very short or very tall riders) in which case we need you to submit a file so we can refine the rules (see "Submitting a file for us to access" below).

Framerate is low

If you are trying to achieve the best environmental conditions (to improve the framerate) there are some things to check for.
  1. If this is the first time you have run Velogic Studio, or you have just upgraded to a new version - Windows may still be busy optimising the application for your computer. Please leave it to run for a few minutes and then close and restart.
  1. Strong light sources (window, door, light bulb) behind the rider, in view of the Kinect will lead to worsened frame rate and a blurry image (though this does not affect the measurement - just the colour image).
  1. Poor lighting conditions can mean a dimly lit area, or only overhead. Any lighting situation that creates a gradient across the rider (ex. bright at the top and dark at the bottom) or hot spots (shining directly at one of the markers) will harm the lighting score.

Liveview isn't live (freezes after one frame)

This is a known problem with Intel Iris Xe graphics drivers, see this thread
You can either update your drivers to the Intel versions, or set this dword flag in Registry Editor:
 HKCU\SOFTWARE\Microsoft\Avalon.Graphics\DisableHWAcceleration : 1
 

Submitting a 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:
Send Sample wizard
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.
Send Sample permission
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.
Send Sample sizeSend Sample size
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:

Occasional random crashes

Velogic Studio is a very stable application, but if you experience occasionally crashes, read on for possible solutions.

Update display drivers

Velogic Studio uses functionality from your video drivers. If the video drivers are buggy, this can cause instability in Velogic Studio.
Follow this guide from Microsoft, but in Device Manager choose "Display adaptor" instead of the example given in the article:
Device Manager - Display adaptorsDevice Manager - Display adaptors

Change "Video format" to "AVI"

Click the "Settings" link on the first step of Velogic Studio, click on "Video format" and change to "AVI":

AVI can result in bigger files, but it's more stable because it doesn't rely on a Windows subsystem to generate the video clips.

Tell antivirus not to check the files saved by Velogic Studio

If Velogic Studio is "freezing up" for you when you save a capture, this might help . Windows has a built-in antivirus which scans every file saved to disk. Sometimes we think it mis-identifies a video being saved as a virus, and will halt Velogic Studio without any error report being sent. 
You can avoid these false positives, and also reduce the time taken to save the results of each capture, by telling Windows to ignore the directory where Velogic Studio fit data is saved:
  1. Click "Start" and type in "Virus", click on "Virus & threat protection"
  2. Click "Manage settings" on "Virus & threat protection settings":
  3. Click "Add or remove exclusions:
  4. Click "Add an exclusion" and then "Folder":

  5. Choose the folder where Velogic Studio saves fit data (usually this will be "Documents\Velogic Studio fits", but you may have changed it in Velogic Studio's settings)
  6. Restart Velogic Studio

Check for other applications using LibUSB

Some customers have reported issues with Velogic Studio freezing when other applications which use LibUSB are installed on the same computer. One example of such an application is the EBike management software. 
You can check for LibUSB by looking in Driver Manager:
LibUSB
If you find LibUSB is present on the computer, try removing any other USB dongles from the computer. If Velogic Studio is still unstable, try remove libUSB from the computer (right-click on the entry in Device Manager and choose "Uninstall Device")

Application generally feels sluggish, videos are laggy

Velogic applications should always feel "snappy" and have good performance on reasonable hardware. If you have hardware that exceeds our minimum specs, and you're not getting the performance you're expecting, here are some things you can check.

Try unplugging webcam

We have had reports from users that some webcams take a lot of CPU themselves, leaving not enough for Velogic apps to do their work. Try disconnecting your webcam, and if the performance is noticeably better, use a different webcam. 

Use Process Explorer to find the bottleneck

Process Explorer is a free utility from Microsoft (part of the free Sysinternals toolset).
You can download or run directly from the Process Explorer webpage. Simply find the Velogic process in the process list, then right-click and choose "Properties". Leave that running while you perform some activities in Velogic Studio, then examine the graphs. Here is an example:
Process Explorer graphGraph showing performance for Velogic application

The example above is taken from a very high-performance machine, so your results may look different. But you can look at:
  1. CPU usage - in the example, CPU usage is low, which is good. (High CPU usage is not necessarily bad, unless you're unhappy with the overall performance of the application)
  2. "Private Bytes" - this is memory usage, and should remain fairly constant as somewhere around 500-700MB. If it is continually and rapidly climbing, you may be experiencing a memory leak - please contact us and send a copy of your graph (you can screenshot it with [Shift]-[Windows]-[s] key combo)
  3. I/O - in the example above the IO peaks during the Capture period, when the app is writing video to disk. IO is low aside from that. Interestingly, the CPU peak over the Capture period is quite small, so the CPU isn't working too hard encoding the videos.
We are happy to help diagnose any performance issues that you're having with our software. Please get in touch with as much information as you have - ideally including a screenshot like the above from Process Explorer.

    • Related Articles

    • Velogic Studio Legal Notices

      Your usage of Velogic Studio is governed by the Velogic Terms of Use and Terms of Trade.  This page lists additional notices specific to the Velogic Studio product. Video codecs THIS PRODUCT IS LICENSED UNDER THE AVC PATENT PORTFOLIO LICENSE FOR THE ...
    • Velogic Studio Purchasing FAQ

      This page will answer all your questions about how to get started with Velogic Studio. If you have any other questions after reading this, please get in touch. How do I purchase the software? All velogic software is purchased through our website, ...
    • Kinect camera troubleshooting guide

      Our Velogic Studio and 3D Aero products utilize the Microsoft Kinect for Xbox One camera. If you're having trouble with the camera - e.g. disconnecting or freezing - the first step is to determine whether the problem lies in Velogic software (Velogic ...
    • 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 ...
    • Velogic Studio vs 3D Motion

      Introduction We're proud to announce that our next-generation bike fit application, Velogic Studio, is available now. Existing customers of 3D Motion can automatically transition to Velogic Studio at no extra cost. This article outlines the ...