# PrepaComp

PrepaComp 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 quant à la qualité des observations effectuées. PrepaComp est conçu autour d’un éditeur de texte auquel des fonctionnalités propres au nivellement ont été ajoutées.

## 1 - Fichier

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

- l'ouverture d'un fichier d'observations issu d'un niveau numérique (.GSI de Leica ou .DAT de Trimble)
- l'enregistrement du ou des fichier(s) ouvert(s) dans l'éditeur de PrepaComp.
- la fermeture des fichiers ouverts dans l'éditeur de PrepaComp.

## 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, ou avec le raccourci clavier Ctrl+S.

### 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 - 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 - Repondérer

Cet outil permet d'ajuster les pondérations d'un fichier .obs.
On peut activer cette fonctionnalité soit en cliquant sur le bouton représentant des poids de balance, soit avec le raccourci clavier Ctrl+W.

### 2.6 - 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 relâcher 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.

## 3 - Nivellement

### 3.1 - Outil Convertir

PrepaComp 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 lisibles, la première étape est de convertir ces données vers un format de type "carnet" (extension *.carnet).
PrepaComp crée alors un nouveau fichier carnet que l'on peut ouvrir et éditer dans PrepaComp 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é.
Le raccourci clavier Ctrl+T permet d'activer l'outil Convertir

### 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.
Le raccourci clavier Ctrl+Shift+R permet d'activer l'outil Supprimer les crapauds

### 3.3 - Outil Vérifier fermeture aller-retour

Cet outil permet de vérifier automatiquement la fermeture des différents cheminements en aller-retour (ou en doublon) dans un fichier obs. Si il y a plus que deux cheminements, l'outil fera toutes les comparaisons possibles entre les différents cheminements.
- L'outil qualifie la qualité à chaque fermeture de la manière suivante :
  - Mauvais: fermeture ⩾ tolérance2
  - Passable: tolérance2 > fermeture ⩾ tolérance1
  - Bon: fermeture < tolérance1
Avec :
- Tolérance1 = Seuil1*σ
- Tolérance2 = Seuil2*σ
- Seuil1 = 1.96
- Seuil2 = 2.56
La probabilité que la valeur moyenne d'une observation se situe entre -1.96σ et 1.96σ (Seuil1) est de 95%.
La probabilité que la valeur moyenne d'une observation se situe entre -2.56σ et 2.56σ (Seuil2) est de 99%.
Ces intervalles de confiance nous disent donc que 5% des observations doivent dépasser le seuil1, 1% doivent dépasser le seuil2.
Autrement dit, une valeur dont la fermeture normalisée dépasse le seuil2 a une probabilité de 99% d'être fausse.
Afin de suivre les règles de l'art, il est conseillé de ne faire des reprises que pour les observations dont la fermeture dépasse la tolérance2, c'est-à-dire lorsque la fermeture normalisée dépasse le seuil2.
Le seuil1 vaut pour information.
Se référer à l'outil 3.5 - Outil Configuration pour le paramétrage du sigma.
L'outil crée un fichier au format .AR dans lequel toutes les comparaisons et les informations correspondantes sont stockées.
Le raccourci clavier Ctrl+Shift+B permet d'activer l'outil Vérifier fermeture aller-retour

### 3.4 - Outil Comparaison des dénivelées du fichier obs avec les altitudes d'un fichier cor

L'outil demande un fichier de coordonnées au format .cor. A partir des altitudes présentes dans le fichier .cor l'outil calcule les dénivelées entre les points du fichier .cor et les comparer avec celles dans le fichier .obs. L'outil crée un fichier .dn dans lequel toutes les comparaisons et les informations correspondantes sont stockées.
Le raccourci clavier Ctrl+Shift+D permet d'activer l'outil Comparaison des dénivelées du fichier obs avec les altitudes d'un fichier cor

### 3.5 - 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.
  - Les dénivelées effectuées dans un cheminement Cholesky simple (ChSp) peuvent être réduites de différentes manières :
    - Deux portées indépendantes, écart-type d'une portée simple
    - 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.
  - Il est possibe de configuer un deuxième intervalle de numérotation des crapauds.
  - Il est possible d'ajouter un préfixe et suffixe pour la détection des crapauds. Prepacomp détectera les crapauds avec ou sans le préfixe et le suffixe donné.
  - Exemple : J'ai donné comme intervalle de crapaud : 700000 à 799999, comme préfixe : R et comme suffixe : B. Le point R700100B sera détecté comme un crapaud. Le point 700100 sera aussi détecté comme un crapaud.

Le raccourci clavier Ctrl+Shift+C permet d'activer l'outil Configuration

## 4 - Multi-époques

Les outils de ce menu permettent de préparer un calcul multi-époques puis d'extraire après le calcul les précisions relatives d'un même point à 2 époques.

### 4.1 - Ajouter un suffixe

Cet outil permet d'ajouter un suffixe de date pour du calcul multi-époques. 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 fichier comp.
- Choisir un suffixe.
- Charger un fichier d'exceptions 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 choisi est créé. Il contient une copie du dossier initial avec les suffixes rajoutés sur les fichiers obs et cor appelés en cascade.

### 4.2 - Extraction des précisions relatives

A partir d'un fichier de précisions relatives exporté par Comp3D, cet outil extrait les précisions relatives des points à 2 époques différentes. Pour cela :

- Renseigner le suffixe des 2 époques.
- Charger le fichier de précisions relatives.
- Choisir la dimension à extraire.

Un fichier csv est créé contenant la précision relative des points présents aux 2 époques.