How paulden/guitar-fingering-recognition works
This is an experimental OpenCV project for recognizing guitar fingering from photographs. Its main demonstrated workflow loads an image, rotates and crops it to the guitar neck, then detects strings and frets; a separate, currently failing branch attempts hand and fingertip detection. The README presents the test-named scripts as the way to run and view these experiments, so they are shown as user-facing runners. Watershed segmentation is an explicitly unused experiment. Relationships are limited to calls visible in excerpts or capabilities documented in the README.
Main entry points: rotate_crop.py Neck rotate/crop · image.py Image operations · grid_detection.py String/fret detection · rotate_crop_tests.py Rotate/crop runner
Components 12
Image preparation
- Rotate/crop runner
rotate_crop_tests.py - Neck rotate/crop
rotate_crop.py
Neck detection
- Grid runner
grid_detection_tests.py - String/fret detection
grid_detection.py - String-line data
strings.py - Hand-detection runner
finger_detection_tests.py - Hand/fingertip detection
finger_detection.py - Watershed experiment
watershed.py
Shared image tools
- Image operations
image.py - Image helpers
functions.py
Other components
- User
- Guitar photos
pictures
Connections 20
- User → Rotate/crop runner: runs
README.md - User → Grid runner: runs
README.md - User → Hand-detection runner: runs
README.md - Guitar photos → Rotate/crop runner: loads images
rotate_crop_tests.py - Guitar photos → Grid runner: loads images
grid_detection_tests.py - Guitar photos → Hand-detection runner: loads images
finger_detection_tests.py - Rotate/crop runner → Image operations: creates images
rotate_crop_tests.py - Rotate/crop runner → Neck rotate/crop: calls
rotate_crop_tests.py - Neck rotate/crop → Image operations: uses
rotate_crop.py - Neck rotate/crop → Image helpers: uses helpers
rotate_crop.py - Grid runner → Neck rotate/crop: calls
grid_detection_tests.py - Grid runner → String/fret detection: calls
grid_detection_tests.py - String/fret detection → Image operations: uses
grid_detection.py - String/fret detection → String-line data: creates
grid_detection.py - String/fret detection → Image helpers: uses helpers
grid_detection.py - Hand-detection runner → Neck rotate/crop: calls
finger_detection_tests.py - Hand-detection runner → Hand/fingertip detection: calls
finger_detection_tests.py - Hand/fingertip detection → Image operations: uses
finger_detection.py - Watershed experiment → Neck rotate/crop: uses
watershed.py - Watershed experiment → Image operations: uses
watershed.py