# Guide de l’utilisateur SecInterp

## 1. Introduction

Bienvenue dans le plugin SecInterp ! Ce guide vous aidera à commencer à créer des coupes géologiques à partir de vos couches QGIS.

SecInterp vous permet de :

- Créer un profil topographique à partir d’un Modèle Numérique de Terrain (MNT/DEM).

- Projeter des unités géologiques à partir d’une couche de polygones sur le profil.

- Projeter des mesures structurales (ex: pendage et direction) sur le profil.

- Projeter des traces de sondages et des intervalles géologiques sur la section.

- Outil d’Interprétation : Numérisez des interprétations géologiques directement sur la section avec un accrochage intelligent.

- Exportation 3D (PolygonZ) : Exportez vos interprétations 2D en tant que fichiers Shapefile 3D valides.

- Support i18n : Interface principale disponible en 10 langues (Anglais, Espagnol, Français, Allemand, Italien, Portugais, Russe, Chinois, Hindi, Japonais).

- Visualisez un aperçu interactif avec optimisation du niveau de détail (LOD).

- Mesurez les distances et les gradients avec un accrochage automatique aux sommets.

## 2. The Main Window

La boîte de dialogue SecInterp est divisée en trois zones principales :

1. Navigation Latérale (Gauche) : Naviguez entre les différents modules : MNT, Sondages, Géologie, Structure, Paramètres et Aide.

2. Page de Configuration (Centre) : Où vous configurez les paramètres du module sélectionné.

3. Panneau d’Aperçu (Droite) : Un canevas interactif affichant votre coupe en temps réel.

The consolidated v2.9.0 Main Window with Sidebar navigation.

## 3. Step-by-Step Tutorial: Creating a Profile

### Étape 1 : Modèle Numérique de Terrain (MNT)

1. Accédez à la page MNT (DEM) dans la barre latérale.

2. Raster Layer: Select your Digital Elevation Model (Mandatory).

3. Bande : Sélectionnez la bande contenant les valeurs d’élévation (Obligatoire).

4. Resolution: Calculated automatically based on the DEM resolution.

5. Scale 1:1: Calculated automatically based on the DEM resolution.

6. Vert. Exag: Adjust if you want to emphasize topography (e.g., 2.0x).

Digital Elevation Model configuration.

### Étape 2 : Définir la Ligne de Coupe

1. Accédez à la page Ligne de Coupe (Section Line).

2. Couche de Coupe : Sélectionnez la couche de lignes vectorielles représentant vos tracés de coupe (Obligatoire).

3. Dist. Tampon (m) : Définissez une distance de tampon (ex: 50m) pour capturer les données autour de la ligne (Obligatoire).

4. Important: The line must be single line (not multipart, only P1 and P2) in order to calculate 3d section export.

Section Line selection and buffer configuration.

Profile DEM Section Preview.

### Étape 3 : Ajouter des Données Géologiques

1. Accédez à la page Géologie.

2. Couche d’Affleurement : Sélectionnez la couche de polygones contenant votre géologie de surface (optionnel).

3. Champ de Nom : Choisissez le champ contenant les codes ou noms d’unités (Obligatoire si une couche d’affleurement est sélectionnée).

Geology configuration.

Geology Section Preview.

### Étape 4 : Ajouter des Données Structurales

1. Accédez à la page Structure.

2. Couche Structurale : Sélectionnez la couche de polygones contenant vos mesures de pendage (optionnel).

3. Champ de Pendage : Choisissez le champ contenant les valeurs de pendage (Obligatoire si une couche structurale est sélectionnée).

4. Champ de Direction : Choisissez le champ contenant les valeurs de direction (Obligatoire si une couche structurale est sélectionnée).

5. Dip Line Scale: Adjust the scale of the dip lines (e.g., 1.0).

Structural configuration.

Structural Section Preview.

### Étape 5 : Ajouter des Données de Sondage

La page Sondages vous permet de projeter des données de forages sur la section (optionnel). Cette page est divisée en trois sous-onglets :

#### 1. Collars Tab

Configure l’emplacement des têtes de sondages (points de départ).

- Couche de Colliers : Couche de points avec les emplacements des forages (optionnel).

- Utiliser la Géométrie de la Couche pour les Coordonnées : Gardez coché pour utiliser la géométrie de la couche de points pour les coordonnées X/Y (Optionnel si une couche de colliers est sélectionnée).

- ID du Forage : Identifiant unique pour chaque sondage (Obligatoire si une couche de colliers est sélectionnée).

- East (X): Optional field for collar X coordinate (if not using point layer geometry).

- North (Y): Optional field for collar Y coordinate (if not using point layer geometry).

- Elevation (Z): Optional field for collar elevation (if not using DEM).

- Total Depth: Optional field for maximum depth.

Drillhole Collars configuration.

#### 2. Survey Tab

Configures downhole survey data (deviation).

- Survey Layer: Table or layer with survey measurements (Mandatory if Collar Layer is selected).

- Hole ID: Field linking to the Collar ID (Mandatory if Survey Layer is selected).

- Depth: Distance down the hole (Mandatory if Survey Layer is selected).

- Azimuth: Direction (0-360) (Mandatory if Survey Layer is selected).

- Inclination: Dip (-90 to 90) (Mandatory if Survey Layer is selected).

Drillhole Survey configuration.

#### 3. Intervals Tab

Configures geological or attribute intervals.

- Interval Layer: Table or layer with logging data (optional).

- Hole ID: Field linking to the Collar ID (Mandatory if Interval Layer is selected).

- From / To: Depth ranges for each interval (Mandatory if Interval Layer is selected).

- Lithology: Field containing the rock type or attribute to visualize (Mandatory if Interval Layer is selected).

Drillhole Intervals configuration.

### Step 6: Generate Preview

1. Click the Preview button (bottom right).

2. The section will render in the right-hand panel. Use the mouse wheel to zoom and drag to pan.

3. Use the Show Checkboxes to toggle visibility of topography, geology, structures, drillholes and interpretation polygons.

Section Preview with all layers enabled.

Section Preview with all panels collapsed.

## 4. Advanced Features (v3.0.0)

### 4.1 Outil d’Interprétation (Dessin)

Le nouvel Outil d’Interprétation vous permet de dessiner des polygones géologiques directement sur la section du profil.

1. Enable the tool by clicking the Interpret button in the preview toolbar.

2. Drawing: Left-click to add vertices.

3. Snapping: The cursor will automatically snap to:

   - Topography surface.

   - Drillhole contacts.

   - Existing interpretation vertices.

4. Undo: Right-click to remove the last vertex.

5. Finalize: Double-click (or press Enter) to close the polygon.

6. Properties: A dialog will appear to set the Lithology, Formation, and Color of the new polygon.

Digitizing a new geological unit using the Interpretation Tool.

Digitizing a new geological unit using the Interpretation Tool.

Digitizing a new geological unit using the Interpretation Tool.

### 4.2 Attribute Inheritance

When you digitize a new interpretation polygon, SecInterp attempts to automatically inherit attributes from underlying data:

- Geology Overlap: If the new polygon overlaps with a projected geological outcrop, it will pre-fill the name and units.

- Drillhole Proximity: If the polygon starts or ends near a drillhole interval, it will inherit the lithology/rock unit from that interval (e.g., « Andesite », « Tuff »).

- Manual override: You can always manualy change the inherited color or name in the properties dialog.

### 4.3 Exportation en 3D (PolygonZ)

SecInterp now bridges the gap between 2D sections and 3D modeling. This feature allows you to export your 2D interpretations as real 3D objects.

Workflow:

1. Go to the Advanced tab in the Settings tab and check « Enable 3D Interpretation Export ».

2. Use the Save button (not Export) to generate your data.

3. The plugin will create a PolygonZ Shapefile in your output folder.

4. Every vertex of your interpretation is projected into real-world 3D coordinates based on the section plane and surface elevation.

5. Note: This feature is now standard and available to all users.

### 4.3 Settings Page

The Settings page manages export configurations and advanced features. It is organized into three sub-tabs:

#### 1. Default Tab (Export Selection)

Control exactly what gets generated when you click Save.

- Topographic Profile: Exports the surface line (CSV/SHP).

- Geological Profile: Exports projected contacts (CSV/SHP).

- Structural Data: Exports projected structural measurements (CSV/SHP).

- Drillhole Data: Exports traces (`LineStringZ`) and interval cylinders (`PolygonZ`) as 3D Shapefiles.

- Interpretations (2D): Exports your drawn polygons (SHP).

Default settings showing Export Selection.

#### 2. Advanced Tab

- Enable 3D Interpretation Export: Toggles the generation of PolygonZ Shapefiles for your interpretations. This creates true 3D geometries based on the section plane.

Advanced settings with 3D Export feature.

#### 3. Plugin Information Tab

Displays version information, credits, and contact details for SecInterp.

Plugin Information.

## 5. Preview Panel & Tools

The right-hand panel acts as an interactive canvas for your cross-section. It includes a toolbar and specific controls to manage visualization and performance.

### 5.1 Toolbar Buttons

Located at the top of the preview panel:

- Preview: Triggers a refresh of the rendering based on the current configuration in the Settings/Data tabs.

- Measure: Activates the interactive ruler. Click on the canvas to measure distances and gradients.

- Interpret: Activates the digitization tool for drawing geological polygons completely.

- Export (Image): Saves the current view as an image file (PNG, JPG, PDF, SVG). Note: To export SHP/CSV data, use the main SAVE button.

### 5.2 Visualization Controls (LOD)

These settings optimize performance for high-resolution datasets:

- Max Points: Manually limits the number of vertices rendered for profile lines. Lower values improve zoom/pan speed.

- Auto: When checked, the plugin automatically calculates the optimal `Max Points` based on your current window size and resolution.

- Adaptive: Enables intelligent sampling algorithm. It preserves key details in complex areas (steep topography, folds) while simplifying flat or linear sections.

### 5.3 Layer Visibility

Use the `Show **` checkboxes to toggle specific data layers on or off without reloading data:

- Show Topography: The topographic profile line derived from the DEM.

- Show Geology: Projected geological contacts from surface mapping.

- Show Structures: Structural measurements (dip/strike) projected onto the plane.

- Show Drillholes: Borehole traces and geological interval cylinders.

- Show Interpretations: Polygons and units digitized by the user.

### 5.4 Using the Tools

#### Measure Tool

- Snap-to-Vertex: Measurements automatically anchor to real data points (DEM or Drillholes).

- Multi-Segment: Click multiple times to measure a polyline path.

- Result Panel: Displays Total Distance (3D), Horizontal Distance, and Vertical Delta.

Figure 7: Measuring distance along a drillhole trace.

#### Interpretation Tool

- Draw: Left-click to add vertices for a new geological unit.

- Edit: Vertices snap to existing lines to ensure topological consistency.

- Finish: Double-click to close the polygon and assign attributes (Lithology, Formation).

## 6. Closing & Saving

It is important to understand the difference between Save and OK:

### « Save » Button (Export to Disk)

Use this when you want to share your data or use it in other software.

- Generates physical files (Shapefiles, CSV) in your select Output Folder.

- Exports:

  - Topographic Profile (LineString)

  - Geological Contacts (Points)

  - Structural Data (Points with Dip/Strike)

  - Drillhole Traces and Intervals (3D `LineStringZ` / `PolygonZ`)

  - 3D Interpretations (PolygonZ, if enabled in Settings)

### « OK » Button (Internal Persistence)

Use this when you want to save your progress and close the dialog, but continue working in QGIS.

- Saves the current state of the plugin (selected layers, parameters, window size) into the QGIS Project configuration.

- Saves your drawn interpretations internally in the `.qgs` project file so they reappear when you reopen the plugin.

- Closes the window.

### « Cancel » Button

- Discards unsaved changes to parameters.

- Closes the window.