Skip to content

Releases: adririquelme/DSEPy

DSEpy v1.0.1 - Minor Fixes and Enhancements

Choose a tag to compare

@adririquelme adririquelme released this 15 Sep 08:54
7155e3b

What's Changed

  • Stereonet Density Normalization: Replaced deprecated integration methods with numpy.trapezoid for modern Python compatibility.
  • Error Handling & GUI: Refactored error handling logic in analyze_normal_spacing for improved execution stability.

Full Changelog: 1.0.0...1.0.1

DSEpy v1.0.0 - Initial Official Release

Choose a tag to compare

@adririquelme adririquelme released this 13 Sep 15:58

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:

  1. Normal Colour Optimisation & Visualisation: Advanced color-coding options (HSV, CIELAB, CIELCH, OKLCH, HSLuv, etc.) for intuitive visual inspection of discontinuity orientations.
  2. Principal Poles Identification: Automated stereonet density analysis to identify main discontinuity sets.
  3. Discontinuity Set (DS) Classification: Classification of point cloud normals according to set orientations.
  4. Spatial Clustering & Discontinuity Extraction:
    • Normal spacing computation
    • Persistence estimation
    • Fisher orientation statistics
    • Extraction of individual cluster facets
  5. 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

  1. Download DSEPy-v1.0.0.zip from the Assets section below and extract it (or clone this repository).
  2. Open CloudCompare and activate the Python console/plugin.
  3. Run main_gui_v100.py to start the DSEpy interface.

📜 License

DSEpy is distributed under the GNU General Public License v3.0 (GPL-3.0), compatible with the CloudCompare ecosystem.