How blaise143/shape-from-shading works
This repository is a command-line Shape-from-Shading application. A user supplies grayscale images and matching masks plus optimization options; the application indexes objects, optimizes surface normals under a Lambertian shading loss, and saves normal and reconstructed-depth artifacts. The graph preserves both normal parameterizations, initialization, optional light/albedo optimization, loss logging, intermediate snapshots, and evaluation/visualization modules. Sampled code supports the main run and artifact flow; connections to the unsampled evaluation module are therefore omitted.
Main entry points: run.py Run coordinator · sfs.py Shading optimizer · main.py Command interface · plotting.py Plotting and exports
Components 17
Input and orchestration
- Command interface
main.py - Image-mask index
src/data_load.py - Run coordinator
src/run.py - Run configuration
src/config.py
SFS optimization
- Shading optimizer
src/sfs.py - Loss and optimizer
src/core_utils.py - Normal initialization
utils/initializations.py - Stereo mapping
utils/stereo_maps.py - Image and device utils
utils/utils.py
Surface reconstruction
- Depth integration
utils/integrator.py - Depth-to-normal conversion
utils/normals_from_depth.py
Results and evaluation
- Plotting and exports
utils/plotting/plotting.py - Plot helpers
utils/plotting/helpers.py - Run artifacts
- Evaluation
src/eval.py
Other components
- CLI user
- Weights & Biases
Connections 16
- CLI user → Command interface: sets options
README.md - Command interface → Image-mask index: builds index
main.py - Command interface → Run coordinator: starts run
main.py - Run coordinator → Image-mask index: selects objects
src/run.py - Run coordinator → Run configuration: builds config
src/run.py - Run coordinator → Shading optimizer: runs optimization
src/run.py - Shading optimizer → Image and device utils: loads image mask
src/sfs.py - Shading optimizer → Normal initialization: initializes normals
src/sfs.py - Shading optimizer → Stereo mapping: maps parameters
src/sfs.py - Shading optimizer → Loss and optimizer: uses losses
src/sfs.py - Shading optimizer → Weights & Biases: logs losses
README.md - Run coordinator → Depth integration: integrates normals
src/run.py - Run coordinator → Plotting and exports: saves plots
src/run.py - Plotting and exports → Plot helpers: uses helpers
utils/plotting/plotting.py - Run coordinator → Run artifacts: writes results
src/run.py - Shading optimizer → Run artifacts: saves snapshots
src/sfs.py