Swing Ratio Percentage Classifier

Classify measured paired subdivision timing and exact share/ratio under caller straight tolerance; does not infer tempo dependence or prescribe fixed 2:1 swing.

Description

Swing timing compares durations within a two-event pair.

Swing timing compares durations within a two-event pair. A straight-timing tolerance makes near-equality explicit.^[1]

Enter positive pair durations and tolerance from 0 inclusive to 0.5 exclusive. Return ratio/share; inclusive distance from 0.5 within tolerance is straight, otherwise classify long-short or reverse-short-long.

When to use Swing Ratio Percentage Classifier

Use Swing Ratio Percentage Classifier when you need to evaluate the supplied records under the calculation and evidence rules below. No timing is measured from audio and no preferred swing ratio, tempo dependence or articulation is imposed.

Enter the written notes, explicit grouping, pitch observations or supported chord tokens requested. Keep scientific octaves, accidentals and caller evidence consistent.

How to use Swing Ratio Percentage Classifier and understand its results

Enter the written notes, explicit grouping, pitch observations or supported chord tokens requested. Keep scientific octaves, accidentals and caller evidence consistent.
Enter measuredLongSubdivisionMs, measuredShortSubdivisionMs, callerStraightShareTolerance using the field table and calculation rules, then run the tool.
Read firstSubdivisionSharePercent, longToShortSubdivisionRatio, swingTimingClass. The explanation below defines the units, signs, ordering and any flags or placeholder values.
If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.

Input field	Meaning	Value type; see rules below	Requirement
measuredLongSubdivisionMs	Measured long subdivision ms	number	Required
measuredShortSubdivisionMs	Measured short subdivision ms	number	Required
callerStraightShareTolerance	Caller straight share tolerance	number	Required

firstShare=first/(first+second); ratio=first/second

Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.

Output field	Meaning	Value type
firstSubdivisionSharePercent	First subdivision share percent	number
longToShortSubdivisionRatio	Long to short subdivision ratio	number
swingTimingClass	Swing timing class	string

json

{
  "input": {
    "measuredLongSubdivisionMs": 200,
    "measuredShortSubdivisionMs": 100,
    "callerStraightShareTolerance": 0.01
  },
  "output": {
    "firstSubdivisionSharePercent": 66.66666666666666,
    "longToShortSubdivisionRatio": 2,
    "swingTimingClass": "long-short-swing"
  }
}

Limitations and assumptions

No timing is measured from audio and no preferred swing ratio, tempo dependence or articulation is imposed.

Numeric inputs, where present, must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.

Alternative or Complementary methods

Use Duple/Triple/Quadruple Meter Classifier: Pulse count and beat subdivision answer different meter questions. Unequal groups can form an additive meter under the same signature. For a complementary task, use Simple/Compound Time Signature Classifier: Meter subdivision describes the units within each declared beat. The signature numerator alone does not establish the grouping.

References

Swing Ratio Percentage Classifier — tool.io

Similar or alternative tools

Duple/Triple/Quadruple Meter Classifier
Pulse count and beat subdivision answer different meter questions. Unequal groups can form an additive meter under the same signature.
Simple/Compound Time Signature Classifier
Meter subdivision describes the units within each declared beat. The signature numerator alone does not establish the grouping.