# PyPrepaComp

PyPrepaComp est un logiciel permettant de prétraiter les observations de nivellement avant de les intégrer dans le logiciel de calcul Comp3D. La philosophie générale de l’outil est d’être plutôt strict quand à la qualité des observations effectuées. PyPrepaComp est conçu autour d’un éditeur de texte auquel on a ajouté des fonctionnalités propres au nivellement.

## 1 - Ouvrir et sauvegarder un fichier

L'onglet Fichier contient les outils de gestion des fichiers :

- l'ouverture d'un fichier au format GSI issu d'un niveau Leica
- et l'enregistrement du fichier ouvert dans l'éditeur de PyPrepaComp.

## 2 - Edition

L'onglet Edition propose quelques outils d'édition de texte.

### 2.1 - Copier/Couper/Coller

- Copier le texte sélectionné.
- Couper le texte sélectionné.
- Coller le contenu du presse-papiers à l'emplacement du curseur.

Sauvegarder le fichier qui a été édité à l'aide de l'outil Fichier/Sauvegarder.

### 2.2 - Concaténer

Cet outil crée un nouveau fichier qui concatène le contenu de tous les sous-fichiers du fichier chargé.

- Charger un fichier obs ou un fichier cor.
- Cliquer sur l'icône de concaténation.

Un fichier de même nom avec le suffixe "_concat" est créé. Il contient les données de tous les sous-fichiers.

### 2.3 - Ajouter un suffixe

Cet outil permet d'ajouter un suffixe de date pour du calcul multi-époque. Le suffixe est ajouté à tous les points (et aussi dans les fichiers appelés en cascade). Seront modifiés les fichiers de nivellement, d'équation de centrage, de topométrie, de laser, de tracker laser et de lignes de bases GNSS.

- Choisir un suffixe.
- Charger un fichier obs.
- Charger un fichier d'exception au format texte. Ce fichier peut être vide.

Au niveau précédent de l'arborescence, un dossier de même nom avec le suffixe "_concat" est créé. Il contient une copie du dossier initial avec les suffixes rajoutés.

## 3 - Nivellement

### 3.1 - Outil Convertir

PyPrepaComp gère en entrée le format GSI issu des niveaux Leica. Ce format n'étant pas facilement lisible, on commence par convertir ces données vers un format de type "carnet" (extension *.carnet). PyPrepaComp crée alors un nouveau fichier carnet que l'on peut ouvrir et éditer dans PyPrepaComp pour corriger les éventuelles erreurs dans les données. On peut également convertir directement le fichier au format GSI vers le format "observations" (extension *.obs) qui est le format des observations topométriques en entrée des calculs de Comp3D. Un fichier *.carnet est alors créé en plus du fichier *.obs demandé. Dans le fichier *.obs, un écart moyen quadratique maximal (EMQmax) est calculé pour chaque dénivelée et indiqué en commentaire. Cet EMQmax correspond au maximum des écarts moyens quadratiques des lectures (2 si RA ou 4 si RAAR) de la dénivelée.

### 3.2 - Outil Supprimer les crapauds

Cet outil permet de calculer la dénivelée totale entre deux points pérennes, et d'en calculer l'écart-type ainsi qu'un écart moyen quadratique maximal (EMQmax). Cet EMQmax correspond au maximum des EMQmax des dénivelées qui composent la dénivelée totale, les EMQmax des dénivelées étant eux-mêmes les maximums des EMQ de chaque lecture les composants (lecture arrière et lecture avant). Pour utiliser cet outil, il faut se trouver dans un fichier carnet (sélectionner le fichier carnet dans la barre d'onglets des fichiers ouverts). Les paramètres de cet outil peuvent être modifiés grâce à l'outil Nivellement/Configuration.

### 3.3 - Outil Configuration

Cet outil permet de choisir les paramètres de traitement des observations de nivellement.

- Les écarts-types (σ) sont par défaut calculés en fonction du nombre de portées n et bien sûr de l'écart-type sur une portée σref (σ = σref √n). On peut choisir de les calculer en fonction de la distance parcourue, d, exprimée en km (σ = σref √d) ou encore de laisser la valeur calculée par le niveau (option "sigma mesuré").
- On peut choisir d'automatiquement supprimer les crapauds lors d'une conversion vers le format .carnet.
- On peut choisir d'alléger le fichier .obs en n'y écrivant pas les commentaires détaillés.
- L'écart-type de référence en mm (σref) est l'écart-type sur une portée de nivellement. Il s'estime avec les paramètres du niveau utilisé et peut s'affiner en fonction des résultats du calcul sous Comp3D, à condition d'avoir sufisamment de redondance dans les observations.
- Les observations de nivellement sont des dénivelées. Or différents points de départs peuvent être choisis pour calculer la dénivelée vers un point rayonné : le dernier coup arrière ou bien le dernier point visé. D'où le choix de méthode de réduction des points rayonnés. La méthode choisie impactera les écarts-types calculés.
- Les crapauds sont automatiquement détectés dans l'outil de suppression des crapauds grâce à leur numéro ; par défaut les crapauds portent des numéros entre 700000 et 799999 mais il est possible de modifier les bornes de cet intervalle.