How makarandtapaswi/video_shotthread_scenedetect works
This MATLAB video-analysis toolkit turns an initialized episode into shot-similarity scores, shot threads, and scene-break locations, with HTML visualizations for the latter results. Its documented workflow assumes shot detection and frame reading already exist; episode-specific setup is provided through initializers. The graph preserves the separate threading and dynamic-programming scene-detection branches. The README establishes the example call sequence, but most implementation files were not sampled, so internal calls and the visualization handoff are not inferred where they are undocumented.
Main entry points: shot_similarity.m Shot similarity · similarity_to_threads.m Thread assignment · visualize_threads_via_htmlrender.m Thread visualization · visualize_scenes_via_htmlrender.m Scene visualization
Components 16
Episode setup
- Episode setup
initializers/BBT.m - Analysis parameters
initializers/initParams.m - Frame access
- Shot events
data/shot_boundaries
Video analysis
- Shot similarity
threading/shot_similarity.m - Image comparison
threading/are_images_similar.m - ND histogram MEX
ext/imhist_nd_fast/imhist_nd_fast.cpp - Scene detection
scenes/dp_scenes.m
Shot threading
- Thread assignment
threading/similarity_to_threads.m - Maximal cliques
utilities/maximalCliques.m
Result visualization
- Thread visualization
visualization/visualize_threads_via_htmlrender.m - Scene visualization
visualization/visualize_scenes_via_htmlrender.m - HTML renderer
visualization/gen_html.py - Thread template
visualization/render_templates/threading.html - Scene template
visualization/render_templates/scenes.html
Other components
- Analyst
Connections 17
- Analyst → Episode setup: initializes video
README.md - Analyst → Analysis parameters: initializes parameters
README.md - Analyst → Shot similarity: computes similarity
README.md - Analyst → Thread assignment: converts similarity
README.md - Analyst → Scene detection: computes scenes
README.md - Analyst → Frame access: provides frame access
README.md - Shot similarity → Thread assignment: returns scores for
README.md - Thread assignment → Thread visualization: visualizes threads
README.md - Scene detection → Scene visualization: visualizes scene breaks
README.md - Shot events → Episode setup: episode shot data
- Shot similarity → Image comparison: uses image comparison
- Shot similarity → Frame access: reads frames
- Thread assignment → Maximal cliques: finds cliques
- Thread visualization → HTML renderer: renders through
- Scene visualization → HTML renderer: renders through
- Thread visualization → Thread template: uses template
- Scene visualization → Scene template: uses template