Centre d’aide

Comment pouvons-nous vous aider ?

    Dépannage

    Les problèmes courants, expliqués.

    La plupart des problèmes viennent de l’installation, du système de coordonnées ou d’un résultat exact qui ressemble à une erreur. Chaque fiche décrit ce que vous voyez, pourquoi cela arrive et quoi faire.

    L’extension QGIS ne se charge pas

    Symptôme : pas de menu ni de barre d’outils Tractrix, ou pas de fournisseur Tractrix dans la boîte à outils de traitements.

    1. Vérifiez la version de QGIS dans Aide → À propos : la 3.34 ou ultérieure est requise.
    2. Ouvrez Extensions → Installer/Gérer les extensions → Installées et assurez-vous que Tractrix for QGIS (OpenAirside) est cochée.
    3. Si vous avez construit le ZIP vous-même, il doit contenir le dossier openairside/ à sa racine, avec metadata.txt à l’intérieur — et non le dépôt entier.
    4. Ouvrez Vue → Panneaux → Journal des messages et consultez les onglets Erreur Python et Extensions. Copiez toute trace d’erreur dans votre signalement.
    5. Si la boîte à outils de traitements est totalement absente, activez l’extension de base Traitements.

    « Engine not found » dans AutoCAD ou Revit

    Symptôme : une commande TX s’arrête avec « The Tractrix engine (tractrix-engine) was not found » et une liste de chemins explorés.

    Avec le moteur local, le complément cherche tractrix-engine dans : le chemin défini dans TXSETTINGS ; la variable d’environnement TRACTRIX_ENGINE ; %ProgramData%\Tractrix\engine\ ; le dossier engine du complément ; et le PATH.

    1. Réinstallez le complément : le programme d’installation place le moteur fourni dans le dossier engine du complément.
    2. Si un antivirus a mis tractrix-engine.exe en quarantaine, restaurez-le et ajoutez une exception.
    3. Si vous avez installé le moteur avec pip, indiquez son chemin complet dans TXSETTINGS ou dans TRACTRIX_ENGINE.
    4. Ou basculez TXSETTINGS sur le moteur cloud.

    Le dépassement de braquage expliqué

    Symptôme : une anomalie de type steering_limit, avec une valeur supérieure à la limite.

    Pour suivre votre ligne, la roue avant devrait braquer plus que l’angle maximal de l’aéronef. Le moteur calcule l’angle à partir de la variation du cap le long de la trajectoire, δ = arctan(L dθ/ds), et signale le point le plus défavorable. Le plus souvent, la courbe est trop serrée pour cet aéronef, ou la ligne présente un angle vif.

    1. Cherchez sur la ligne un sommet aigu ou un petit zigzag de numérisation ; remplacez les angles par des arcs de rayon réaliste.
    2. Comparez avec le rayon de virage minimal de l’aéronef dans Rayons de virage et demi-tour à 180°.
    3. Vérifiez steer_source dans la bibliothèque : si une limite par défaut (60° ou 65°) a été utilisée, recherchez la valeur du constructeur et saisissez-la en remplacement.
    4. Pour le repoussage, la limite est celle du remorquage, pas le braquage maximal de l’aéronef.

    L’empiètement sur la marge au bord expliqué

    Symptôme : une anomalie de type edge_margin, ou une marge minimale au bord négative.

    Un pneu extérieur de l’atterrisseur principal s’approche du bord de la chaussée plus près que la marge roue–bord de la norme — 3 m pour un A320 selon l’OACI, par exemple. Une valeur négative signifie que le pneu sort de la chaussée. En virage, c’est généralement l’atterrisseur principal qui coupe à l’intérieur de la courbe : la chaussée a besoin d’une surlargeur.

    1. Vérifiez que le bon point de guidage est utilisé : le poste de pilotage pour la conception des voies de circulation.
    2. Vérifiez que la couche de chaussée couvre tout l’itinéraire et qu’il s’agit d’un polygone valide.
    3. Lancez Surlargeur / chaussée nécessaire pour dessiner la chaussée dont l’aéronef a besoin.
    4. La vérification commence quand le point de guidage est sur la ligne : les premiers mètres ne sont donc pas testés.

    SCR et données géographiques

    Symptôme : résultats au mauvais endroit ou à la mauvaise taille, ou enveloppes de quelques centimètres.

    • QGIS : les couches dans un SCR géographique (degrés, p. ex. EPSG:4326) sont calculées dans la zone UTM locale et les sorties sont écrites dans ce SCR UTM. QGIS les reprojette à la volée ; pour un travail exact, utilisez un SCR projeté en mètres pour tout le projet.
    • Un SCR projeté en pieds est traité comme non métrique et également calculé en UTM.
    • CAO : définissez les unités du dessin (INSUNITS). Un dessin sans unité utilise le réglage mètres par unité.
    • Cloud : le GeoJSON doit être en mètres dans un plan ; les unités DXF sont lues dans $INSUNITS, et un DXF sans unité est lu en mètres, avec un avertissement.

    Problèmes de connexion et de jetons Cloud

    Symptôme : connexion impossible, lien de vérification expiré, ou l’API renvoie 401, 402, 403 ou 503.

    • Lien de vérification expiré (au bout de 24 heures) : demandez-en un nouveau depuis la page de connexion. Les liens de réinitialisation du mot de passe sont valables 60 minutes.
    • Trop de tentatives : la connexion est limitée en fréquence ; attendez une minute et réessayez.
    • 401 : le jeton est erroné, révoqué ou expiré. Créez-en un nouveau ; les jetons commencent par tx_. Vérifiez-le avec GET /api/v1/whoami.
    • 403 « Viewers cannot run simulations » : demandez le rôle de membre à un administrateur.
    • 402 : l’organisation a atteint une limite de sa formule ; le message la nomme.
    • 503 service occupé : réessayez après le nombre de secondes indiqué dans Retry-After. 504 : la simulation a duré plus de 30 s ; raccourcissez la trajectoire ou lancez le calcul depuis l’interface web.
    • En CAO, un jeton enregistré sur un autre ordinateur ou un autre compte Windows ne peut pas être déchiffré : collez-le à nouveau dans TXSETTINGS.

    Signaler un bogue

    Aidez-nous à le reproduire.

    Ouvrez un ticket sur Downloads (account required). Un problème que nous pouvons reproduire est généralement corrigé rapidement. Merci d’indiquer :

    1. Le produit et sa version : p. ex. Tractrix for QGIS 0.2.0, ainsi que la version de l’application hôte (QGIS, AutoCAD ou Revit) et le système d’exploitation.
    2. Ce que vous avez fait : l’outil ou la commande, et ses paramètres. Dans QGIS, le bouton Avancé → Copier comme commande Python de la boîte de dialogue les capture exactement.
    3. Les données d’entrée : la ligne de trajectoire et, le cas échéant, la chaussée et les obstacles — un petit GeoJSON, GeoPackage ou DXF, ou la requête tractrix/1.
    4. Ce que vous attendiez et ce qui s’est passé : pour un écart numérique, la valeur publiée et sa source (document, page, tableau).
    5. Les messages : le journal, l’enveloppe d’erreur ou la trace d’erreur Python.

    Ne joignez pas de plans d’aéroport confidentiels à un ticket public. Réduisez le cas à une ligne synthétique qui reproduit le problème, ou demandez-nous un canal privé.

    Canaux d’assistance

    Questions
    Downloads (account required) — utilisation, méthodes, idées
    Bogues
    Downloads (account required) — problèmes reproductibles, corrections de données
    Sécurité
    Signalez les vulnérabilités en privé par e-mail à REAT Global, pas dans un ticket public
    Commercial
    dawit@reat-global.com — formules, Enterprise, accès à la préversion

    État des services

    • Téléchargements (versions GitHub)Voir l’état de GitHub
    • Tractrix Cloud (préversion)Page d’état à venir
    • API CloudPage d’état à venir

    Une page d’état publique sera publiée à la sortie de préversion de Tractrix Cloud. Les produits de bureau et le moteur local ne dépendent d’aucun service en ligne.