SecInterp (Section Interpreter) is a professional QGIS plugin designed for industrial-grade extraction and visualization of geological data. It empowers geologists to generate high-fidelity topographic profiles, project outcrops with structural integrity, and perform complex 3D drillhole analysis within a unified 2D cross-section environment.
SecInterp v3.7.0: i18n Quality Gate & UX Improvements.
Patch: Qt6 / QGIS 4 Enum Compatibility
- 114 findings resolved: Migrated all flat enum usages to their fully scoped form (
Qgis.Critical→Qgis.MessageLevel.Critical,Qt.NoPen→Qt.PenStyle.NoPen,QgsWkbTypes.LineString→QgsWkbTypes.Type.LineString, and more), clearing every Qt6 compatibility finding reported by the QGIS plugin repository. - CI gate: Wired
make qt6-check(the samepyqgis4-checkertool used on upload) into the release pipeline to prevent regressions.
Phase: Internationalization Quality Gate & Preview UX
- AST-Based Translation Hygiene: Developed
verify_i18n_hygiene.py, a static analyzer that scans UI components for untranslated strings and enforcesself.tr()wrapping with near-zero false positives. - Dialog Title Coverage: Wrapped 9 untranslated error dialog titles (
Export Error,Preview Error,Geology Error,Drillhole Error) and the results"ID:"label inself.dialog.tr().
- Decluttered Workspace: Grouped the preview action buttons, LOD controls, and layer checkboxes into a collapsible
QgsCollapsibleGroupBox("Controls"), keeping the map canvas and status bar always visible for a cleaner interpretation experience.
- Lean Distribution: Excluded AI/agent tooling directories (
.codewhale,.continue,.deepseek,artifacts) from the distributable ZIP, ensuring a plugin-only package.
See CHANGELOG.md for complete details.
- Real-time Visualization: Instantly view topography, geology, and structures along any drawn section line.
- Performance: Uses Parallel Processing to handle complex geological intersections without freezing QGIS.
- Adaptive Level of Detail (LOD): Automatically adjusts data density based on zoom level for smooth navigation.
- Measurement Tools: Measure distances and calculate slopes/gradients directly on the profile view with automatic Snapping to vertices.
- Drillhole Support: Project 3D drillhole traces and geological intervals (sondajes) onto the 2D cross-section plane.
Fig 1. Main interface showing topography and projected geology.
- Topography: Extracts elevation profiles from any DEM raster.
- Geology: Projects polygon outcrops onto the section line, respecting valid lithological boundaries.
- Structure: Projects dip/strike measurements with configurable buffer zones and apparent dip calculations.
- Interactive Drawing: Draw interpretation polygons directly on the profile view.
- Smart Snapping: Accurately snap vertices to existing topographic or geological features.
- Auto-Color: Automatically assigns vivid colors to distinguish new interpretations.
- Undo/Redo: Flexible editing with right-click undo support during drawing.
- Formats: Export directly to SHP, CSV, DXF, PDF, SVG, or PNG.
- Layout: Results are ready for CAD integration or reporting.
Before installing SecInterp, ensure your system meets the following requirements:
- QGIS: 3.28 LTR or superior (including QGIS 4.x).
- Python: 3.10 or superior (included with QGIS).
- Dependencies: The plugin uses standard QGIS and PyQt libraries (fully compatible with both Qt5 and Qt6 via
qgis.PyQt). Advanced analysis and development tools (like the QGIS Plugin Analyzer tool, executed via theqgis-analyzercommand, andai-context-core) are only required for developers and auditors.
- Open QGIS.
- Go to Plugins > Manage and Install Plugins.
- Search for
SecInterp. - Click Install Plugin.
- Download the latest
sec_interp_v3.7.0.zipfrom releases. - Open QGIS.
- Go to Plugins > Manage and Install Plugins > Install from ZIP.
- Select the file and click Install.
For detailed instructions, please see the User Guide.
-
Prepare Data: Load your DEM (Raster), Geology (Polygons), and Structure (Points) layers in QGIS.
-
Launch Plugin: Click the SecInterp icon in the toolbar.
-
Configure Layers:
-
DEM: Select your elevation raster and band.
-
Cross-section: Select the line layer that defines your profile.
-
Geology: Select the outcrop layer and the lithology attribute field.
-
Structure: Select the point layer and dip/strike fields.
-
Drillholes (Optional): Configure Collars, Survey, and Intervals in the Drillholes page to project 2D drillhole traces.
-
-
Preview: Click Preview Profile. The view will update asynchronously.
- Tip: Use the scroll wheel to zoom in/out. The detail level will adapt automatically.
- Tip: Colapse panels to the left, and Results colapse down to save space.
-
Export: Use the Export button in the preview toolbar or go to the Settings page for batch export configuration.
This plugin is open-source and welcomes contributions.
- Source Code: GitHub Repository
- Documentation:
- User Guide: How to use the plugin.
- Architecture: Technical design and patterns.
- Development Guide: Code standards and setup.
- Maintenance Log: Changelog and release procedures.
- Technical Compendium: Geophysical research and details.
- Development Setup: Use the
Makefileand the Development Guide. - Testing with Docker (Recommended):
Esta suite ejecuta los tests del proyecto dentro de un contenedor QGIS oficial (
qgis/qgis:latest), garantizando un entorno reproducible y libre de conflictos de dependencias locales.make docker-build # Build the test image make docker-test # Run the full test suite inside a container
This project is licensed under the GNU General Public License v3.0. See LICENSE for details.