Skip to main content
Footage-weighted hand visibility and active-manipulation shares reduced from one stored hand-activity analysis.

Authorizations

Authorization
string
header
required

Capability-bearing token issued by a squash operator. Required for curation, exports, dataset registration, and job control when the deployment runs in gated mode; public reads stay open. GET /api/access reports the capabilities a given credential actually carries.

Query Parameters

dataset
string
required

Dataset or corpus id whose index root holds the analysis.

analysis
string | null

One stored hand-activity run. Omit for the most recent.

Response

Stored hand-activity shares and their denominator

Response of GET /api/quality/hand-activity: footage-weighted shares reduced from one stored hand-activity analysis.

The shares describe only successfully answered footage. Refused and schema-invalid windows are counted separately so a caller can see when the denominator is smaller than the requested corpus.

analysis
string
required

The stored hand-activity run these figures came from — the one asked for, or the most recent when none was named. Opaque, and echoed so two answers a week apart can be told apart: same token means the corpus was not re-measured between them.

clips
integer
required

Stored clip artifacts in the analysis.

Required range: x >= 0
dataset
string
required
measured_seconds
number<double>
required

Successfully answered footage: the denominator of every share.

segments_unassessed
integer
required

Segments that could not be assessed, excluded from measured_seconds.

Required range: x >= 0
segments_unusable
integer
required

Segments whose assessment was unusable, also excluded.

Required range: x >= 0
active_manipulation_share
number<double> | null

Share of measured footage showing active manipulation.

hands_visible_share
number<double> | null

Share of measured footage with at least one camera-wearer hand visible.

two_hands_visible_share
number<double> | null

Share of measured footage with both camera-wearer hands visible.