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.

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)

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.