> For the complete documentation index, see [llms.txt](https://docs.velogicfit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.velogicfit.com/fr/section-02-utiliser-velogic-studio/troubleshooting-marker-detection.md).

# Dépannage de la détection des marqueurs

Guide complet de dépannage des problèmes courants de détection des marqueurs dans Velogic Studio

Velogic Studio devrait vous afficher un squelette/maquette filaire solide :

{% embed url="<https://ik.imagekit.io/vfframes/docs/George%20skeleton_D-74O6nry.mp4>" %}

et les indicateurs de qualité devraient afficher « Good » pour la détection :

![Indicateurs de qualité montrant un statut de détection « Good » pour une reconnaissance correcte des marqueurs](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-228659437abda88d137f68f93eb5b8d8ae54c2a9%2Ftroubleshooting-marker-detection.png?alt=media)

Si ce n’est pas ce que vous obtenez, cette page vous aidera à résoudre le problème.

> **Problème connu :** certains rouleaux de ruban marqueur produits depuis début 2026 ne sont pas entièrement rétro-réfléchissants, ce qui fait disparaître les marqueurs lorsqu’ils ne font pas face à la caméra bien de face. Si un marqueur continue de disparaître alors qu’il est correctement placé, voir [Problème de réflectivité des marqueurs](/fr/section-02-utiliser-velogic-studio/marker-reflectivity-issue.md).

## Repérez les points rouges : y en a-t-il en trop ? En manque-t-il ?

Si Velogic Studio ne parvient pas à trouver un squelette valide à partir de 7 (ou 8) points, il affichera à la place des points rouges pour les marqueurs qu’il a détectés.

![Points rouges affichés lorsque Velogic Studio ne peut pas former un squelette valide à partir des marqueurs détectés](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-0acc728aa3146b4837fa02004334d9bd464d7cbb%2Ftroubleshooting-marker-detection-1.png?alt=media)

Vous pouvez observer le cycliste pendant qu’il pédale et voir si l’un des marqueurs n’apparaît pas parfois sous forme de point rouge. Si vous remarquez cela, ajustez le marqueur problématique afin que la caméra le voie mieux.

Si vous voyez des points rouges supplémentaires dans la scène (comme des reflets sur la jante de la roue avant), vous devrez peut-être les masquer, par exemple en les recouvrant de ruban de masquage. Notez que Velogic Studio peut gérer certains reflets supplémentaires, en particulier s’ils ne sont pas du tout proches d’une position de marqueur valide ; mais s’il y a de nombreux reflets supplémentaires, ou s’ils sont proches d’une position de marqueur valide, vous devrez les masquer.

## Vérifiez le placement des marqueurs

Reportez-vous à notre [documentation sur le placement des marqueurs](/fr/section-02-utiliser-velogic-studio/joint-marker-placement.md). Les marqueurs doivent être placés là où la caméra peut les voir directement. Les problèmes courants sont :

* Marqueur d’épaule placé trop haut
* Marqueur de poignet trop tourné à l’opposé de la caméra
* Marqueur de talon (si utilisé) placé trop bas sur la chaussure

## Vérifiez que le bon nombre de points est sélectionné (7 ou 8)

Il existe un paramètre de configuration à l’étape 1 qui indique à Velogic Studio si vous utilisez 7 marqueurs ou 8 (y compris un marqueur de talon). Assurez-vous que ce paramètre correspond au nombre réel de marqueurs que vous utilisez.

## Recherchez d’autres reflets mis en évidence sous forme de points rouges

* Logos ou étiquettes sur le cuissard, le maillot et les chaussures
* Parties brillantes du vélo
* Jantes en alliage

Nous effectuons beaucoup de filtrage dans le processus de détection pour éliminer les reflets supplémentaires, et les marqueurs de haute qualité (le matériau imprimé sur le VF-Tape est conçu pour la vision nocturne) font partie de la manière dont nous distinguons les reflets souhaités des reflets indésirables.

## Cycliste anormalement grand/petit/aux proportions inhabituelles ?

Pour aider Velogic Studio à filtrer les reflets indésirables, il dispose de certaines règles internes afin de s’assurer que le squelette formé par les marqueurs puisse raisonnablement correspondre à un corps humain. Certaines règles concernent les proportions, et d’autres impliquent la taille des segments du corps.

Il peut arriver qu’un cycliste ne respecte pas l’une de nos règles de proportionnalité (plus probable avec des cyclistes très petits ou très grands). Si vous voyez 7 (ou 8) points rouges, tous au bon endroit, mais que Velogic Studio ne produit pas de maquette filaire/squelette, c’est peut-être votre cas.

Pour nous aider à affiner les règles, veuillez soumettre un fichier d’exemple que nous examinerons ensuite et utiliserons pour ajuster les règles. Voir « Soumettre un fichier pour que nous y accédions » ci-dessous.

## Caméra trop éloignée ?

Si la caméra est positionnée à plus d’environ 8 pieds du plan du vélo, les points peuvent être trop petits pour que la caméra les reconnaisse.

Voir aussi : [Configuration de la zone d’ajustement](/fr/section-01-pour-commencer/setting-up-fit-area.md)

## Soumettre un fichier d’exemple à évaluer

Si vous rencontrez des problèmes de détection des marqueurs, nous avons un processus simple pour [soumettre des fichiers à l’analyse](/fr/section-01-pour-commencer/sharing-with-support.md) (voir la section « Partage de fichiers de relecture » sur cette page).

Voici une vidéo du processus « Soumettre un échantillon » :

{% embed url="<https://vimeo.com/377229580>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.velogicfit.com/fr/section-02-utiliser-velogic-studio/troubleshooting-marker-detection.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
