Documentation
Definitions and field notes for the ShotMetrics static data prototype. The project is currently in development, so this documentation is still being organized and edited.
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.
Data Origins
Every analysis run records where its data came from. The origin is shown in the Database, on each Film Detail page and in Plot Studio.
- Legacy · FADE 3.0 All data currently published. Produced by the earlier FADE 3.0 scripts, before FADEx. The variables below describe this data.
- FADEx Reserved for data imported from verified FADEx
.fadepackages. None has been published yet.
The two origins use different definitions: FADEx places cuts differently, samples frames per second of shot duration, measures loudness, speech and music, and does not compute Filtered_ASL or the legacy Character_Shot_Scale rule. Metrics defined only for legacy data are computed only for legacy films, and cross-film charts show different origins as separate series.
Core Variables (Legacy · FADE 3.0)
- 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.