🧠 MODELOSCOPE

Modeloscope is a project for analyzing, visualizing, and inspecting 3D meshes. It is light weight, performance efficient and supports file formats such as .stl, .off, .ply, obj, .gltf and .glb.

• Topology analysis
• Geometry analysis
• Statistics metrics
• Distributions metrics
• Integrity metrics

• Flat render
• Shaded render
• Wireframe render
• Pointcloud render

• Duplicate vertices inspection
• Non manifold edges inspection
• Sharp edges inspection
• Degenerate faces inspection
• Flipped normals inspection

• Generate and Export analysis report
• Custom rendering pipeline using VisPy
• Smooth camera controls (rotate, zoom, reset)
• Highlight heatmap regions on inspection

Modeloscope/
│
├── functions/       # Functional logics
├── interfaces/      # Interfaces logics
├── analyzers/       # Analyzing logics
├── renderers/       # Rendering logics
├── inspectors/      # Inspection logics
└── launch.py        # Entry point

1. Download the latest release

2. Run:

Modeloscope.exe

1. Clone the repository:

git clone https://github.com/GJO37/Modeloscope.git
cd Modeloscope   

2. Create virtual environment:

python -m venv venv

3. Activate virtual environment:

venv\Scripts\activate

4. Install dependencies:

pip install -r requirements.txt

5. Run the application:

python launch.py

1. Launch the application

2. Use different interfaces:

   • Analyze → compute metrics
   • Render → visualize mesh
   • Inspect → highlight features

3. Load an 3D mesh

4. Analyze, Render or Inspect

• Python 3.13
• NumPy – Numerical computations
• Trimesh – Mesh processing
• VisPy – GPU-based rendering
• Tkinter – User interface

• New analysis modes
• New inspection modes
• Various improvements

• Overlay loading
• Altered inspection modes
• Altered model support

• Screen scaling
• Screen layout
• Cursor feedback
• Updated libraries

• Added threading
• Async behaviour
• Flow changes

• Changed clear Button
• Various improvements
• State handling
• Quality additions

• Added new renderer
• New camera movement
• Exception handeling
• Fxied hidden bugs
• Quality additions

• Pipeline standardization
• Better error handling
• Fixed hidden bugs

• Introduced inspection pipeline
• Visual inspection system

• Removed SciPy dependency
• Reduced build size
• Architectural uverhaul
• Improved UI experience

• Changed viewport background
• Improved shaded rendering
• Improved pointcloud rendering
• Fixed packaging issues

• Introduced 3D renderer
• Supports different visuals

• Introduced analysis pipeline
• Contains multiple analysis