Releases: adririquelme/DSEPy
Release list
DSEpy v1.0.1 - Minor Fixes and Enhancements
What's Changed
- Stereonet Density Normalization: Replaced deprecated integration methods with
numpy.trapezoidfor modern Python compatibility. - Error Handling & GUI: Refactored error handling logic in
analyze_normal_spacingfor improved execution stability.
Full Changelog: 1.0.0...1.0.1
DSEpy v1.0.0 - Initial Official Release
DSEpy v1.0.0 — Initial Official Release
We are pleased to announce the first official release of DSEpy (v1.0.0), a Python-based implementation and evolution of the Discontinuity Set Extractor (DSE) software originally developed in MATLAB.
DSEpy integrates directly into CloudCompare through its Python plugin interface, providing a streamlined graphical user interface (GUI), enhanced performance, and multi-language support for rock mass discontinuity analysis on 3D point clouds.
🌟 Key Features & Workflow
DSEpy provides a complete semi-automatic workflow for rock mass characterisation:
- Normal Colour Optimisation & Visualisation: Advanced color-coding options (HSV, CIELAB, CIELCH, OKLCH, HSLuv, etc.) for intuitive visual inspection of discontinuity orientations.
- Principal Poles Identification: Automated stereonet density analysis to identify main discontinuity sets.
- Discontinuity Set (DS) Classification: Classification of point cloud normals according to set orientations.
- Spatial Clustering & Discontinuity Extraction:
- Normal spacing computation
- Persistence estimation
- Fisher orientation statistics
- Extraction of individual cluster facets
- Internationalization (i18n): Multi-language UI support (English, Spanish, Catalan, German, Arabic, and more).
👥 Authors
- Adrián Riquelme Guill — Universidad de Alicante
- Roberto Tomás Jover — Universidad de Alicante
- Antonio Abellán Fernández -- Grupo de Investigación INTERES
📄 How to Cite
If you use DSEpy in academic research or technical projects, please cite this release using the repository CITATION.cff file or refer to the project documentation in docs/.
🛠️ Requirements & Installation
Requirements
- CloudCompare (v2.12 or higher recommended) with the Python plugin enabled.
- Dependencies:
numpy,scipy,matplotlib,Pillow(Optional:colorcet,pyvista).
Quick Start
- Download
DSEPy-v1.0.0.zipfrom the Assets section below and extract it (or clone this repository). - Open CloudCompare and activate the Python console/plugin.
- Run
main_gui_v100.pyto start the DSEpy interface.
📜 License
DSEpy is distributed under the GNU General Public License v3.0 (GPL-3.0), compatible with the CloudCompare ecosystem.