Home

Welcome to the DSEpy Wiki

DSEpy is an open-source Python plugin for CloudCompare designed for semi-automatic rock mass discontinuity set extraction, spacing analysis, persistence estimation, and 3D facet generation from point clouds.

---

🚀 Quick Links & Navigation

• 📥 Download Latest Release
• 📦 Main Repository Page
• ⚙️ Installation Guide

📚 User Manual & Core Modules

• 🔄 Workflow Overview
• 🎨 Color Optimization
• 📈 Stereonet & Poles
• 🏷️ Set Classification
• 🧩 Clustering & Facets
• 📏 Normal Set Spacing
• 📐 Discontinuity Persistence

---

🛠️ Main Features Overview

1. Normal Vector Coloration: Color-code normal vectors using advanced color spaces (HSV, CIELAB, OKLCH, HSLuv) for visual orientation analysis.
2. Interactive Stereonets: Spherical density estimation and automated principal pole identification.
3. Point Cloud Classification: Orientation-based normal classification into structural discontinuity sets.
4. Spatial Analysis & Metrics: Coplanarity evaluation, normal/apparent spacing computation, persistence estimation, and 3D mesh facet extraction.

---

👥 Authors & Academic Citation

Developed at Universidad de Alicante by:

• Adrián Riquelme
• Roberto Tomás
• Antonio Abellán

If you use DSEpy in academic research or technical reporting, please cite the foundational methodology paper:

Riquelme, A. J., Abellán, A., Tomás, R., & Jaboyedoff, M. (2014). A new approach for semi-automatic rock mass joints recognition from 3D point clouds. Computers & Geosciences, 68, 38–52. https://doi.org/10.1016/j.cageo.2014.03.014

For software-specific citation formats (BibTeX, RIS), refer to the CITATION.cff file in the main repository.