How zz1ww/triniscan works
TriniScan is a laser-line triangulation scanner that turns rotating-table camera captures into a closed 3D mesh and volume measurement. The main workflow is configured and launched through the CLI or Tkinter UI; the pipeline loads camera, laser, and axis calibration, scans views, extracts laser centers, triangulates and registers point clouds, then reconstructs and closes a mesh before computing volume. Calibration tools and single-frame preview are supporting workflows. The firmware has two documented alternative MCU implementations for the serial-controlled turntable. Relationships among unsampled subsystems follow README descriptions; source excerpts show only selected calls.
Main entry points: pipeline.py Scan pipeline · app.py GUI · centerline.py Centerline extraction · main.py CLI
Components 27
User entry
- CLI
software/triniscan/core/main.py - Configuration
software/triniscan/core/config.py - GUI
software/triniscan/ui/app.py - Config panels
software/triniscan/ui/panels.py - Preview panel
software/triniscan/ui/preview.py - Background worker
software/triniscan/ui/worker.py
Calibration
- Camera calibration
software/triniscan/calibration/camera_calib.py - Laser calibration
software/triniscan/calibration/laser_calib.py - Axis calibration
software/triniscan/calibration/axis_calib.py
Capture and extraction
- Scan pipeline
software/triniscan/core/pipeline.py - Camera capture
software/triniscan/camera/capture.py - Turntable controller
software/triniscan/turntable/controller.py - Centerline extraction
software/triniscan/extraction/centerline.py - Steger method
software/triniscan/extraction/_steger.py
Reconstruction and volume
- Triangulation
software/triniscan/reconstruction/triangulate.py - View registration
software/triniscan/reconstruction/register.py - Mesh reconstruction
software/triniscan/reconstruction/mesh.py - Mesh closure
software/triniscan/volume/close_mesh.py - Volume calculation
software/triniscan/volume/volume.py - Measurement result
Turntable firmware
- HAL firmware main
firmware/mcu_stm32_cubeide/Core/Src/main.c - HAL command handler
firmware/mcu_stm32_cubeide/Core/Src/cmd.c - HAL motor driver
firmware/mcu_stm32_cubeide/Core/Src/motor.c - SPL firmware main
firmware/mcu_stm32_spl/User/main.c - SPL command handler
firmware/mcu_stm32_spl/User/cmd.c - SPL motor driver
firmware/mcu_stm32_spl/User/motor.c
Other components
- Operator
Connections 30
- Operator → CLI: runs scan
README.md - CLI → Configuration: loads settings
software/triniscan/core/main.py - CLI → Scan pipeline: starts measurement
software/triniscan/core/main.py - Operator → GUI: uses interface
README.md - GUI → Config panels: renders
software/triniscan/ui/app.py - GUI → Preview panel: renders
software/triniscan/ui/app.py - GUI → Background worker: dispatches tasks
software/triniscan/ui/app.py - GUI → Scan pipeline: starts measurement
software/triniscan/ui/app.py - GUI → Camera capture: captures preview
software/triniscan/ui/app.py - GUI → Centerline extraction: extracts preview
software/triniscan/ui/app.py - Scan pipeline → Camera calibration: loads calibration
software/triniscan/core/pipeline.py - Scan pipeline → Laser calibration: loads calibration
software/triniscan/core/pipeline.py - Scan pipeline → Axis calibration: loads calibration
software/triniscan/core/pipeline.py - Scan pipeline → Turntable controller: controls rotation
README.md - Scan pipeline → Camera capture: captures views
README.md - Scan pipeline → Centerline extraction: extracts centers
software/triniscan/core/pipeline.py - Centerline extraction → Steger method: delegates method
software/triniscan/extraction/centerline.py - Scan pipeline → Triangulation: triangulates pixels
software/triniscan/core/pipeline.py - Scan pipeline → View registration: registers views
software/triniscan/core/pipeline.py - Scan pipeline → Mesh reconstruction: reconstructs mesh
README.md - Scan pipeline → Mesh closure: closes mesh
software/triniscan/core/pipeline.py - Scan pipeline → Volume calculation: computes volume
software/triniscan/core/pipeline.py - Scan pipeline → Measurement result: produces result
software/triniscan/core/pipeline.py - Laser calibration → Centerline extraction: extracts calibration line
software/triniscan/calibration/laser_calib.py - Turntable controller → HAL command handler: serial protocol
README.md - HAL firmware main → HAL command handler: runs command handling
- HAL command handler → HAL motor driver: controls motor
- Turntable controller → SPL command handler: serial protocol
README.md - SPL firmware main → SPL command handler: runs command handling
- SPL command handler → SPL motor driver: controls motor
firmware/mcu_stm32_spl/User/cmd.c