# Guía de Usuario de SecInterp

## 1. Introduction

¡Bienvenido al plugin SecInterp! Esta guía te ayudará a comenzar a crear secciones geológicas transversales a partir de tus capas de QGIS.

SecInterp te permite:

- Crear un perfil topográfico a partir de un Modelo Digital de Elevación (DEM).

- Proyectar unidades geológicas desde una capa de polígonos sobre el perfil.

- Proyectar medidas estructurales (ej: buzamiento y dirección) sobre el perfil.

- Proyectar trazas de sondajes e intervalos geológicos sobre la sección.

- Herramienta de Interpretación: Digitaliza interpretaciones geológicas directamente en la sección con snapping inteligente.

- Exportación 3D (PolygonZ): Exporta tus interpretaciones 2D como Shapefiles 3D válidos.

- Soporte i18n: Interfaz principal disponible en 14 idiomas (incluyendo Español, Francés, Alemán, Ruso, Polaco, Holandés, Finlandés, etc.).

- Visualizar una previsualización interactiva con optimización de nivel de detalle (LOD).

- Medir distancias y gradientes con snapping automático a vértices.

## 2. The Main Window

El diálogo de SecInterp se divide en tres áreas principales:

1. Navegación Lateral (Izquierda): Navega entre diferentes módulos: DEM, Sondajes, Geología, Estructural, Ajustes y Ayuda.

2. Página de Configuración (Centro): Donde configuras los parámetros para el módulo seleccionado.

3. Panel de Previsualización (Derecha): Un lienzo interactivo que muestra tu sección transversal en tiempo real.

La Ventana Principal consolidada v2.9.0 con navegación lateral.

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

### Paso 1: Modelo Digital de Elevación (DEM)

1. Navega a la página DEM en la barra lateral.

2. Capa Ráster: Selecciona tu Modelo Digital de Elevación (Obligatorio).

3. Banda: Selecciona la banda que contiene los valores de elevación (Obligatorio).

4. Resolución: Calculada automáticamente basada en la resolución del DEM.

5. Escala 1:1: Calculada automáticamente basada en la resolución del DEM.

6. Exag. Vert.: Ajusta si quieres enfatizar la topografía (ej: 2.0x).

Configuración del Modelo Digital de Elevación.

### Paso 2: Definir Línea de Sección

1. Navega a la página Línea de Sección.

2. Capa de Sección: Selecciona la capa vectorial de líneas que representa tus trazas de sección (Obligatorio).

3. Dist. de Buffer (m): Establece una distancia de buffer (ej: 50m) para capturar datos alrededor de la línea (Obligatorio).

4. Importante: La línea debe ser una línea simple (no multipart, solo P1 y P2) para poder calcular la exportación de sección 3D.

Selección de Línea de Sección y configuración de buffer.

Profile DEM Section Preview.

### Paso 3: Añadir Datos Geológicos

1. Navega a la página Geología.

2. Capa de Afloramientos: Selecciona la capa de polígonos que contiene tu geología de superficie (opcional).

3. Campo de Nombre: Elige el campo que contiene los códigos o nombres de las unidades (Obligatorio si se selecciona una Capa de Afloramientos).

Configuración de Geología.

Previsualización de Sección Geológica.

### Paso 4: Añadir Datos Estructurales

1. Navega a la página Estructural.

2. Capa Estructural: Selecciona la capa que contiene tus medidas de buzamiento (opcional).

3. Campo de Buzamiento: Elige el campo que contiene los valores de buzamiento (Obligatorio si se selecciona una Capa Estructural).

4. Campo de Dirección: Elige el campo que contiene los valores de dirección/strike (Obligatorio si se selecciona una Capa Estructural).

5. Escala de Línea de Buzamiento: Ajusta la escala de las líneas de buzamiento (ej: 1.0).

Structural configuration.

Structural Section Preview.

### Paso 5: Añadir Datos de Sondajes

La página de Sondajes te permite proyectar datos de pozos sobre la sección (opcional). Esta página se divide en tres pestañas:

#### 1. Collars Tab

Configura la ubicación de los collares de los sondajes (puntos de inicio).

- Capa de Collares: Capa de puntos con las ubicaciones de los pozos (opcional).

- Usar Geometría de Capa para Coordenadas: Mantener marcado para usar la geometría de la capa de puntos para las coordenadas X/Y (Opcional si se selecciona una Capa de Collares).

- ID de Pozo: Identificador único para cada sondaje (Obligatorio si se selecciona una Capa de Collares).

- 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

Configura los datos de trayectoria/desviación del pozo.

- 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

Configura los intervalos geológicos o de atributos.

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

### Paso 6: Generar Previsualización

1. Click the Preview button (bottom right).

2. La sección se renderizará en el panel de la derecha. Usa la rueda del ratón para hacer zoom y arrastra para desplazarte.

3. Usa las Casillas de Verificación de Mostrar para alternar la visibilidad de la topografía, geología, estructuras, sondajes y polígonos de interpretación.

Section Preview with all layers enabled.

Section Preview with all panels collapsed.

## 4. Advanced Features (v3.0.0)

### 4.1 Herramienta de Interpretación (Dibujo)

La nueva Herramienta de Interpretación te permite dibujar polígonos geológicos directamente sobre la sección del perfil.

1. Habilita la herramienta haciendo clic en el botón Interpretar en la barra de herramientas de previsualización.

2. Drawing: Left-click to add vertices.

3. Snapping: El cursor se ajustará automáticamente a:

   - 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 Exportación a 3D (PolygonZ)

SecInterp ahora cierra la brecha entre las secciones 2D y el modelado 3D. Esta función te permite exportar tus interpretaciones 2D como objetos 3D reales.

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

Es importante entender la diferencia entre Guardar y Aceptar:

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

Usa esto cuando quieras compartir tus datos o usarlos en otro software.

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

- Exporta:

  - Perfil Topográfico (LineString)

  - Contactos Geológicos (Puntos)

  - Datos Estructurales (Puntos con Buzamiento/Dirección)

  - Trazas e Intervalos de Sondaje (3D `LineStringZ` / `PolygonZ`)

  - Interpretaciones 3D (PolygonZ, si está habilitado en Ajustes)

### Botón «Aceptar» (Persistencia Interna)

Usa esto cuando quieras guardar tu progreso y cerrar el diálogo, pero continuar trabajando en 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.

- Cierra la ventana.

### Botón «Cancelar»

- Descarta los cambios no guardados en los parámetros.

- Cierra la ventana.