# Guida per l’utente SecInterp

## 1. Introduction

Benvenuti nel plugin SecInterp! Questa guida vi aiuterà a iniziare a creare sezioni geologiche trasversali dai vostri layer QGIS.

SecInterp ti permette di:

- Creare un profilo topografico da un Modello Digitale di Elevazione (DEM).

- Proiettare unità geologiche da un layer poligonale sul profilo.

- Proiettare misure strutturali (es. inclinazione e direzione) sul profilo.

- Project drillhole traces and geological intervals (sondajes) onto the section.

- Interpretation Tool: Digitize geological interpretations directly on the section with smart snapping.

- Esportazione 3D (PolygonZ): Esporta le tue interpretazioni 2D come file Shapefile 3D validi.

- Supporto i18n: Interfaccia principale disponibile in 10 lingue (Inglese, Spagnolo, Francese, Tedesco, Italiano, Portoghese, Russo, Cinese, Hindi, Giapponese).

- View an interactive preview with level-of-detail (LOD) optimization.

- Misurare distanze e pendenze con aggancio automatico ai vertici.

## 2. The Main Window

La finestra SecInterp è divisa in tre aree principali:

1. Navigazione Laterale (Sinistra): Naviga tra i diversi moduli: DEM, Sondaggi, Geologia, Struttura, Impostazioni e Aiuto.

2. Pagina di Configurazione (Centro): Dove configuri i parametri per il modulo selezionato.

3. Pannello di Anteprima (Destra): Un’area interattiva che mostra la tua sezione in tempo reale.

The consolidated v2.9.0 Main Window with Sidebar navigation.

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

### Passo 1: Modello Digitale di Elevazione (DEM)

1. Naviga alla pagina DEM nella barra laterale.

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

3. Band: Select the band containing the elevation values (Mandatory).

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.

### Step 2: Define Section Line

1. Navigate to the Section Line page.

2. Section Layer: Select the vector line layer representing your section traces (Mandatory).

3. Buffer Dist. (m): Set a buffer distance (e.g., 50m) to capture data around the line (Mandatory).

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.

### Step 3: Adding Geological Data

1. Navigate to the Geology page.

2. Outcrop Layer: Select the polygon layer containing your surface geology (optional).

3. Name Field: Choose the field containing the unit codes or names (Mandatory if Outcrop Layer is selected).

Geology configuration.

Geology Section Preview.

### Passo 4: Aggiungere dati strutturali

1. Naviga alla pagina Struttura.

2. Structural Layer: Select the polygon layer containing your dip measurements (optional).

3. Campo Inclinazione: Scegli il campo contenente i valori di inclinazione (Obbligatorio se lo strato strutturale è selezionato).

4. Strike Field: Choose the field containing the strike values (Mandatory if Structural Layer is selected).

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

Structural configuration.

Structural Section Preview.

### Passo 5: Aggiungere dati del sondaggio

The Drillholes page allows you to project borehole data onto the section (optional). This page is divided into three sub-tabs:

#### 1. Collars Tab

Configures the location of drillhole collars (start points).

- Collar Layer: Point layer with hole locations (optional).

- Use Layer Geometry For Coordinates: Keep checked to use the point layer’s geometry for X/Y coordinates (Optional if Collar Layer is selected).

- Hole ID: Unique identifier for each drillhole (Mandatory if Collar Layer is selected).

- 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 Interpretation Tool (Drawing)

The new Interpretation Tool allows you to draw geological polygons directly on the profile section.

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 Exporting to 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.