Skip to content

Main content

Public Meter Additive Group Duration Tool

Calculate public meter additive group duration from explicit caller-supplied inputs.

Loading tool…

Description

Sum pulses, return total seconds and each group's duration.

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.

Sum pulses, return total seconds and each group's duration.

When to use this tool

Use Public Meter Additive Group Duration when you need a supplied timing-grid, pulse or phrase calculation.

How to use the tool and how it works

  1. Enter groupPulses, secondsPerPulse. 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 totalPulses, totalSeconds, groupSeconds. Use the output convention below.

Require a nonempty list of positive integer group pulses and positive secondsPerPulse. Sum pulses, return total seconds and each group's duration.1

Input fieldMeaning and unitsAccepted input
groupPulsesGroup PulsesRequired. Array of safe integer; maximum items 256.
secondsPerPulseSeconds Per PulseRequired. Finite number; strictly above 0.
Output fieldInterpretationReturned shape
totalPulsesTotal PulsesRequired. Safe integer.
totalSecondsTotal SecondsRequired. Finite number.
groupSecondsGroup SecondsRequired. Array of finite number; maximum items 256.
json
{
  "input": {
    "groupPulses": [
      2,
      2,
      3
    ],
    "secondsPerPulse": 0.25
  },
  "output": {
    "totalPulses": 7,
    "totalSeconds": 1.75,
    "groupSeconds": [
      0.5,
      0.5,
      0.75
    ]
  }
}

Limitations and assumptions

  • Pulse duration is constant and supplied. The list may describe additive grouping but the tool does not identify a tradition, meter, accent or actual tempo.
  • 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

  1. Calculation and input contract: ethnomusicology/public-meter-additive-group-duration — tool.io

Similar or alternative tools