SpéléoTopo — Aide utilisateur

1) Démarrage

SpéléoTopo est un éditeur/visualiseur de topographie spéléo basé sur VisualTopo .TROX (XML) et un format projet .stopo (JSON).

Packaging/compilation : utiliser l’entrypoint sans accent (SpeleoTopo.py) pour éviter les soucis de chemins/encodage.

2) Formats & flux de travail

• Import source : .trox (VisualTopo XML) — seul format d’entrée.
• Projet : .stopo — sauvegarde : meta cavité, coordonnées, unités, visées, radiales, scraps, zones, commentaires, etc.
• Exports : SVG (plan), PDF (plan), Therion (.th/.th2/.thconfig).

Conseil : conserver le .trox comme source “autorité” et utiliser .stopo pour l’édition carto.

3) Import .TROX

Menu toolbar : 📥 Import .TROX

• Le fichier doit être un .trox (un .tro n’est pas accepté).
• Après import, l’application construit les stations et calcule les vues PLAN et COUPE DÉVELOPPÉE.
• Les visées radiales sont importées comme radiales (pas de station d’arrivée).

4) Projet .STOPO (.stopo)

Menu toolbar : 📂 Ouvrir .stopo / 💾 Sauver .stopo

• Ouvrir : recharge l’état complet du projet (meta + topo + édition).
• Sauver : enregistre toutes les données du projet courant.

Si tu importes un nouveau .trox d’une cavité déjà éditée, l’approche recommandée est d’ouvrir d’abord le .stopo, puis de gérer explicitement la fusion (fonction à définir si besoin).

5) Unités & conventions

• Distances : mètres (m)
• Angles : degrés décimaux (deg) (gon acceptés à l’import et convertis si nécessaire)
• LRUD / GDHB : distances en mètres, perpendiculaires au point topo choisi (DimPt Dep/Arr)

6) Coordonnées d’entrée

Dans la sidebar :

• Coordonnée X, Coordonnée Y : stockées dans le projet (mètres si projection métrique).
• Type de coord : combo des référentiels courants (ex. UTM WGS84 — zone 31N (m)).

La valeur choisie est sauvegardée et rechargée depuis le .stopo.

7) Vue PLAN

Toolbar : 🗺️ Plan • 🖼️ Ajuster • Graphisme : Grille 5 m / 10 m

• Affichage 1:1 (pas de déformation) + quadrillage sur toute la zone visible.
• Auto-fit centré au chargement d’un .trox ou .stopo (équivalent du bouton Ajuster).
• Parois : LRUD G/D + radiales (si activées).
• Scraps : wall / detail / water (si activés).

8) Vue COUPE DÉVELOPPÉE

Toolbar : 📈 Coupe (développé/Z) • 🖼️ Ajuster • Graphisme : Grille 5 m / 10 m

• Affiche une coupe développée : X = chaînage développé, Y = altitude Z.
• Affichage 1:1 (pas de déformation) + quadrillage.
• Auto-fit centré au changement de vue et au chargement (comme Ajuster).
• Parois en coupe via H/B (Up/Down) + radiales (si activées).

9) Parois GDHB & radiales

Dans Diagnostics :

• Afficher les parois (LRUD + Radiales) : toggle global.

PLAN

• GD : segments perpendiculaires à l’azimut au point topo (Dep/Arr selon DimPt).
• Radiales : segments depuis la station vers l’extrémité paroi (projection horizontale).

COUPE DÉVELOPPÉE

• HB : segments verticaux au point topo (Dep/Arr), dessinés dans l’espace (x_dev, z).

10) Scraps (PLAN & COUPE DÉVELOPPÉE)

Toolbar “Graphisme” : 🧩 Scraps + ⚙

• 🧩 Scraps : affiche les scraps (carto) et active l’outil.
• ⚙ : Mode édition, Type courant (wall/detail/water), Snap (aimant) + tolérance.
• Un champ “Scrap courant” (à côté du menu) indique le scrap sélectionné et le type actif.
• Les scraps sont par vue : ceux créés en PLAN n’apparaissent pas en COUPE DÉVELOPPÉE, et inversement.

Créer un scrap

• Clic gauche + glisser : dessine une polyline freehand.
• Relâcher : le scrap est enregistré dans le projet (.stopo).
• Le type du scrap créé est celui du type courant (wall/detail/water).

Éditer un scrap (mode édition ON)

• Clic gauche sur un scrap : sélection (surbrillance).
• Les poignées (sommets) s’affichent : glisser une poignée pour déplacer un sommet.
• Snap (si activé) : aimantation des sommets sur les guides topo (PLAN) pour stabiliser la carto.

Menu contextuel (clic droit)

• Clic droit (sans glisser) : menu à l’emplacement souris.
• Clic droit + glisser : pan (comportement conservé).
• Entrées typiques : Sélectionner, Déplacer, Ajouter sommet, Supprimer sommet, Supprimer scrap, Inverser, Type.

11) Symboles

Toolbar “Graphisme” : 🧷 Symboles + ⚙

• 🧷 Symboles : affiche les symboles et active l’outil de pose/édition.
• ⚙ : choix du symbole courant, taille d’insertion, activation du mode édition.
• Une zone “Symbole courant” à côté du menu affiche le symbole sélectionné / actif (pour réinsérer plusieurs fois le même sans repasser par la liste).
• Couleur : réglage via 🎨 Couleurs → section “— Symboles —”. Par défaut : marron foncé (#4B2E1F).

Pose (mode édition OFF)

• Clic gauche : insère le symbole courant à la position souris.

Édition (mode édition ON)

• Clic gauche sur un symbole : sélection.
• Glisser sur le symbole : déplacement.
• R : rotation du symbole sélectionné (+15°).
• Suppr : suppression du symbole sélectionné.

Menu contextuel (clic droit)

• Clic droit (sans glisser) : menu à l’emplacement souris — Sélection, Déplacer, Rotation, Ajouter, Supprimer.
• Clic droit + glisser : pan (comportement conservé).

12) Diagnostics boucles

Toolbar : 📋 Diag

• Afficher la liste : montre/masque le tableau des boucles.
• Afficher noms des stations : labels sur la vue.
• Masquer le tracé et points Topo : masque réseau/stations (pratique pour carto).

Le module diagnostics calcule les fermetures et propose des métriques (erreur 3D, ratio ‰, etc.).

13) Exports

• SVG (PLAN) — léger
  • Contenu : Scraps + Symboles uniquement (fichier volontairement peu chargé).
  • Ajout : cartouche (cavité, club, altitude, X/Y, système, unités, déclinaison), Nord, échelle graphique.
  • Génère 4 fichiers : _A4V, _A4H, _A3V, _A3H.
• PDF (PLAN)
  • Export papier en 4 formats : _A4V, _A4H, _A3V, _A3H.
  • Le contenu exporté suit l’export PDF existant (réseau / parois / scraps / etc. selon options).
• Therion
  • .th : fichier principal (centerline + map).
  • .th2 : dessin (scraps + symboles) en plan, exploitable dans Therion/XTherion.
  • .thconfig : configuration de build (source/select/export).

Note : la grille (5/10 m) est une aide à l’écran, elle n’est pas exportée.

14) Préférences (couleurs/polices)

• Couleurs : réglage des traits (cheminement, parois, scraps…)
• Polices : titre, meta, cartouche

Les préférences sont persistées localement (fichier de prefs).

15) Raccourcis souris / clavier

• Zoom : molette
• Pan : clic droit + glisser
• Menu contextuel : clic droit (sans glisser) sur le canvas (selon l’outil actif / ce qu’il y a sous la souris)
• Ajuster : bouton 🖼️ Ajuster (PLAN / COUPE)

Symboles

• Pose : clic gauche
• Édition : sélection + glisser pour déplacer
• R : rotation (+15°) • Suppr : supprimer

Scraps

• Dessin : clic gauche + glisser (PLAN / COUPE DÉVELOPPÉE)
• Édition (mode édition ON) : poignées sur sommets, glisser pour déplacer

16) Dépannage

Le logiciel se ferme sans message

• Le plus fréquent : exception Python non visible (mode exe). Relancer depuis un terminal si possible, ou activer un log si disponible.
• Vérifier que le .stopo est bien un fichier JSON valide (si modifié manuellement).

Je ne vois pas les parois

• Vérifier la case Afficher les parois (LRUD + Radiales).
• En PLAN : seules G/D sont affichées. En COUPE : seules H/B.

Je peux zoomer mais pas me déplacer

• Pan = clic droit + glisser.
• Cliquer d’abord dans la zone de dessin (canvas) pour lui donner le focus.

Je ne peux pas dessiner / éditer un scrap

• Activer 🧩 Scraps.
• Pour déplacer des sommets : activer ⚙ → Mode édition.
• Si le menu contextuel ne s’affiche pas : clic droit sans glisser (un drag déclenche le pan).

17) Note sur l’auteur

Pascal Mouneyrat est un informaticien (Windev, Python, PHP, JavaScript…), aujourd’hui à la retraite. Spéléologue depuis 1976, il pratique également la plongée souterraine depuis 1995.

18) L’association ARIS

Pascal Mouneyrat est le webmaster du site spelebase.fr, site de l’ARIS (Association de Recherche et d’Inventaire Spéléologique).

Le site centralise des ressources techniques et met à disposition plusieurs logiciels développés par l’auteur pour la spéléologie, regroupés dans une rubrique dédiée “Logiciels / Applications”.

Le logiciel SpeleoTopo est disponible sur ce site en téléchargement, ainsi que ce document d’aide.

19) Remerciements

Je tiens à souligner les informations recueillies qui m’ont permis de proposer ce logiciel en m’inspirant de plusieurs logiciels, ressources et auteurs :

• Éric David pour le format TROX de son logiciel VISUAL TOPO.
• Jean‑Pierre Cassou (GH Cave Draw) pour ses conseils et des extraits de code que j’ai analysés.
• Stacho Mudrak et Martin Budaj (THERION) pour les formats permettant un export compatible Therion.

20) Participer aux tests