# SecInterp Benutzerhandbuch

## 1. Introduction

Willkommen beim SecInterp-Plugin! Diese Anleitung hilft Ihnen beim Einstieg in die Erstellung geologischer Querschnitte aus Ihren QGIS-Layern.

SecInterp ermöglicht es Ihnen:

- Erstellen eines topografischen Profils aus einem Digitalen Geländemodell (DGM/DEM).

- Projizieren von geologischen Einheiten aus einem Polygon-Layer auf das Profil.

- Projizieren von Strukturmessungen (z. B. Einfallen und Streichen) auf das Profil.

- Projizieren von Bohrlochspuren und geologischen Intervallen auf den Schnitt.

- Interpretations-Werkzeug: Digitalisieren Sie geologische Interpretationen direkt im Schnitt mit intelligentem Snapping.

- 3D-Export (PolygonZ): Exportieren Sie Ihre 2D-Interpretationen als valide 3D-Shapefiles.

- i18n-Unterstützung: Kernoberfläche in 10 Sprachen verfügbar (Englisch, Spanisch, Französisch, Deutsch, Italienisch, Portugiesisch, Russisch, Chinesisch, Hindi, Japanisch).

- Anzeigen einer interaktiven Vorschau mit Detailgrad-Optimierung (LOD).

- Messen von Entfernungen und Gradienten mit automatischem Snapping an Stützpunkte.

## 2. The Main Window

Der SecInterp-Dialog ist in drei Hauptbereiche unterteilt:

1. Seitenleisten-Navigation (Links): Navigation zwischen verschiedenen Modulen: DEM, Bohrlöcher, Geologie, Struktur, Einstellungen und Hilfe.

2. Konfigurationsseite (Mitte): Hier konfigurieren Sie die Parameter für das ausgewählte Modul.

3. Vorschaufenster (Rechts): Legt eine interaktive Leinwand fest, die Ihren Querschnitt in Echtzeit anzeigt.

The consolidated v2.9.0 Main Window with Sidebar navigation.

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

### Schritt 1: Digitales Geländemodell (DGM/DEM)

1. Navigieren Sie zur DEM-Seite in der Seitenleiste.

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.

### Schritt 2: Schnittlinie definieren

1. Navigieren Sie zur Seite Schnittlinie.

2. Schnitt-Layer: Wählen Sie den Vektorlinien-Layer aus, der Ihre Schnittspuren darstellt (Obligatorisch).

3. Pufferabstand (m): Legen Sie einen Pufferabstand fest (z. B. 50 m), um Daten um die Linie herum zu erfassen (Obligatorisch).

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.

### Schritt 3: Geologische Daten hinzufügen

1. Navigieren Sie zur Seite Geonomie.

2. Ausbiss-Layer: Wählen Sie den Polygon-Layer aus, der Ihre Oberflächengeologie enthält (Optional).

3. Namensfeld: Wählen Sie das Feld aus, das die Einheitenkürzel oder -namen enthält (Obligatorisch, wenn der Ausbiss-Layer ausgewählt ist).

Geology configuration.

Geology Section Preview.

### Schritt 4: Strukturdaten hinzufügen

1. Navigieren Sie zur Seite Struktur.

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

3. Dip Field: Choose the field containing the dip values (Mandatory if Structural Layer is selected).

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.

### Step 5: Adding Drillhole Data

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 Interpretations-Werkzeug (Zeichnen)

Das neue Interpretations-Werkzeug ermöglicht es Ihnen, geologische Polygone direkt im Profilschnitt zu zeichnen.

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.