Performance Call Response Lag Term Tool

Description

Return responseStart-minus-callEnd, its wrapped fraction of a cycle and overlap when the signed lag is negative.

Musical timing can be expressed in seconds, pulses, beats and phrase positions. A grid or cycle is an explicit model; calculating its coordinates does not detect onsets, determine a tradition's meter or evaluate a performance.

Return responseStart-minus-callEnd, its wrapped fraction of a cycle and overlap when the signed lag is negative.

When to use this tool

Use Performance Call Response Lag Term when you need a supplied timing-grid, pulse or phrase calculation.

How to use the tool and how it works

Enter callEnd, responseStart, cycleDuration. Use the units and conventions below.
Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
Read lag, cyclePhase, overlap. Inspect overlap before interpreting the associated values.

Require positive cycleDuration. Return responseStart-minus-callEnd, its wrapped fraction of a cycle and overlap when the signed lag is negative.^[1]

Input field	Meaning and units	Accepted input
callEnd	Call End	Required. Finite number.
responseStart	Response Start	Required. Finite number.
cycleDuration	Cycle Duration	Required. Finite number; strictly above 0.

Output field	Interpretation	Returned shape
lag	Lag	Required. Finite number.
cyclePhase	Cycle Phase	Required. Finite number.
overlap	Overlap	Required. Boolean.

json

{
  "input": {
    "callEnd": 10,
    "responseStart": 11,
    "cycleDuration": 4
  },
  "output": {
    "lag": 1,
    "cyclePhase": 0.25,
    "overlap": false
  }
}

Limitations and assumptions

Negative lag can wrap to a positive phase; inspect lag as well. No audio segmentation, interaction meaning or culturally valid interpretation is inferred.
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

Inspect the recording and its relevant musical context for transcription or interpretation. Keep time units, pulse definitions, tempo changes and source annotations explicit.

References

Calculation and input contract: ethnomusicology/performance-call-response-lag-term — tool.io

Similar or alternative tools

Recording Beat Grid Offset
Convert event-minus-origin into beats, round to nearest using Math.round and return event minus that nearest grid point in seconds.
Beat Cycle Onset Position Wrap
Floor-divide onset-minus-origin for cycleIndex and return nonnegative modular position and phase fraction.