Documentation
Definitions and field notes for the ShotMetrics static data prototype.
Basic Concepts
Shot: a continuous segment between two cuts.
Metrics: measurable formal features.
These metrics are intermediate formal variables. They do not directly prove cultural meanings or narrative intentions.
Core Variables
- ASL: Average Shot Length for the film. This is a film-level field repeated in each CSV row.
- Filtered_ASL: Filtered Average Shot Length for the film. This is also film-level and should be deduplicated before film comparison.
- Shot_Duration: Duration of each shot in seconds.
- Log_Duration: Log-transformed shot duration for long-tailed distribution analysis.
- CIELAB_Brightness: Shot-level brightness feature.
- CIELAB_Warmth: Shot-level warm/cool color feature.
- HSV_Saturation: Shot-level saturation feature.
- Character_Shot_Scale: Categorical proxy for character shot scale.
- Remarks: Sparse quality or review note, currently used for Low Confidence / Check records.
- QC Flags: Records with non-empty Remarks, such as "Low Confidence / Check". They are quality-control notes rather than film-form metrics.
Usage Notes
Use Shot_Start as the default timeline axis when plotting shot-level variables. Avoid using ASL and Filtered_ASL as per-shot variables because they repeat the same film-level value on every row. Avoid using Stratum as a primary chart variable in the current dataset because it is always 0.
The Plot Studio currently focuses on a concise metric set: shot rhythm, CIELAB brightness, CIELAB warmth, HSV saturation, and Character_Shot_Scale. Face-derived fields remain in the raw CSV because they support Character_Shot_Scale, but they are not exposed as primary plotting metrics in this prototype.