# 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é, en cliquant sur l'icone ou avec le clavier Ctrl+C.
- Couper le texte sélectionné, en cliquant sur l'icone ou avec le clavier Ctrl+X.
- Coller le contenu du presse-papiers à l'emplacement du curseur, en cliquant sur l'icone ou avec le clavier Ctrl+V.

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

### 2.2 - Rechercher

Cet outil permet de rechercher un mot dans le fichier chargé.
On peut activer cette fonctionnalité soit en cliquant sur la loupe, soit avec le raccourci clavier Ctrl+F.

### 2.3 - Rechercher et Remplacer

Cet outil permet de rechercher un mot dans le fichier chargé et de le remplacer par un nouveau mot.
On peut activer cette fonctionnalité soit en cliquant sur la loupe stylisée, soit avec le raccourci clavier Ctrl+H.

### 2.4 - Edition en colonne

Cet outil permet de sélectionner plusieurs lignes pour réaliser des modifications en parallèle sur ces différentes lignes.
Pour activer cette fonctionnalité, appuyer sur Alt, cliquer sur le texte et monter ou descendre la souris en maintenant le clic pour sélectionner les lignes sur lesquelles écrire. Il est possible de relacher le clic, sauter des lignes puis recliquer.
Autre manière d'activer cette fonctionnalité : appuyer sur Alt, puis appuyer sur les flèches haut et bas pour étendre la sélection.
Relacher le clic puis pianoter avec les flèches directionnelles permet de déplacer la sélection.
Pour désactiver la sélection, appuyer sur Echap ou Enter ou cliquer dans le fichier.

### 2.4 - 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.5 - 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 et le format DAT issu des niveaux Trimble.
Ces formats 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/DAT 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é.

### 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.

- Paramètres de réduction :
  - 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é").
  - 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 dénivelées en tour d'horizon, aussi appelées dénivelées RAAR, peuvent être réduites de différentes manières :
    - Deux portées, aller et retour : les deux dénivelées simples composant le tour d'horizon sont traitées comme deux dénivelées simples, avec les écarts-types correspondants.
    - Une portée moyenne, écart-type de deux portées indépendantes : l'écart-type associé à la moyenne des deux dénivelées est plus faible que celui d'une dénivelée simple.
    - Une portée moyenne, écart-type d'une portée simple : cela revient à considérer que les deux portées sont complètement corrélées.
- Options d'interface :
  - On peut choisir d'automatiquement supprimer les crapauds lors d'une conversion vers le format .obs.
  - Au moment de calculer la fermeture des aller-retours, on peut choisir d'afficher toutes les dénivelées dans le fichier AR résultant, ou seulement les dénivelées qui ont été mesurées plusieurs fois (aller retour, ou deux allers...)
  - On peut choisir d'alléger le fichier .obs en n'y écrivant pas les commentaires détaillés.
  - On peut choisir le nombre de décimales à afficher sur les distances dans les commentaires.
- Intervalle de numérotation des crapauds :
  - 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.