Skip to content

Main content

Shot Duration Proportion Tool

Calculate shot duration proportion from explicit caller-supplied inputs.

Loading tool…

Description

Use sequenceDuration or sequenceDuration - excludedDuration as denominator according to excludeMarked, then divide shotDuration by it.

Media proportions depend on whether the denominator includes excluded material, inaudible markers, duplicated roles, or only eligible duration. These choices answer different analytical questions.

Use sequenceDuration or sequenceDuration - excludedDuration as denominator according to excludeMarked, then divide shotDuration by it.

When to use this tool

Use Shot Duration Proportion when you need a media-study proportion with an explicit counting basis.

How to use the tool and how it works

  1. Enter shotDuration, sequenceDuration, excludedDuration, excludeMarked. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read denominator, proportion. Use the output convention below.

Use sequenceDuration or sequenceDuration - excludedDuration as denominator according to excludeMarked, then divide shotDuration by it.1

Input fieldMeaning and unitsAccepted input
shotDurationShot DurationRequired. Finite number; minimum 0.
sequenceDurationSequence DurationRequired. Finite number; strictly above 0.
excludedDurationExcluded DurationRequired. Finite number; minimum 0.
excludeMarkedExclude MarkedRequired. Boolean.
Output fieldInterpretationReturned shape
denominatorDenominatorRequired. Finite number.
proportionProportionRequired. Finite number.
json
{
  "input": {
    "shotDuration": 10,
    "sequenceDuration": 100,
    "excludedDuration": 20,
    "excludeMarked": true
  },
  "output": {
    "denominator": 80,
    "proportion": 0.125
  }
}

Limitations and assumptions

  • Shot duration must fit the eligible duration even when exclusions are not applied; this does not identify shots or assess editorial meaning.
  • Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
  • Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.

Alternative or Complementary methods

Review the coding protocol and source material, and report excluded or uncertain annotations separately.

References

  1. Calculation and input contract: media-studies/shot-duration-proportion — tool.io

Similar or alternative tools

  • Quote Source Duration Share

    Divide nonnegative sourceDuration by positive totalQuotedDuration, requiring source duration no greater than total.

  • Broadcast Segment Frame Share

    Sum nonnegative integer segmentFrames with exact integers and subtract excludedFrames from positive programFrames for eligibleFrames.