Tempo Range Ballroom Style Lookup
Screen measured tempo against actual caller ballroom style/rulebook BPM ranges with overlap/absence retained; no universal federation ranges or music-style identification.
Description
Ballroom tempo windows can overlap across styles or rulebooks.
Ballroom tempo windows can overlap across styles or rulebooks. A measured tempo may match several or none.1
Enter aligned nonempty unique style IDs/positive ordered min/max BPM and positive observed BPM. Return every inclusive matching ID and signed margin per style.
When to use Tempo Range Ballroom Style Lookup
Use Tempo Range Ballroom Style Lookup when you need to evaluate the supplied records under the calculation and evidence rules below. No federation ranges, music-style identification or bars-to-beats conversion is supplied.
Prepare the annotated dance, timing, rehearsal or inventory records requested. Supply caller rules, evidence flags and local reference values; distinguish beats, bars, counts and seconds.
How to use Tempo Range Ballroom Style Lookup and understand its results
- Prepare the annotated dance, timing, rehearsal or inventory records requested. Supply caller rules, evidence flags and local reference values; distinguish beats, bars, counts and seconds.
- Enter callerBallroomStyleIds, callerMinimumTempoBpm, callerMaximumTempoBpm, observedTempoBpm using the field table and calculation rules, then run the tool.
- Read callerMatchingStyleIds, signedTempoMarginsToStyleRangesBpm. 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 |
|---|---|---|---|
| callerBallroomStyleIds | Caller ballroom style ids | list of string | Required |
| callerMinimumTempoBpm | Caller minimum tempo bpm | list of number | Required |
| callerMaximumTempoBpm | Caller maximum tempo bpm | list of number | Required |
| observedTempoBpm | Observed tempo bpm | number | Required |
Enter aligned nonempty unique style IDs/positive ordered min/max BPM and positive observed BPM. Return every inclusive matching ID and signed margin per style.
margin_i=min(tempo−minimum_i,maximum_i−tempo) Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.
| Output field | Meaning | Value type |
|---|---|---|
| callerMatchingStyleIds | Caller matching style ids | list of string |
| signedTempoMarginsToStyleRangesBpm | Signed tempo margins to style ranges bpm | list of number |
{
"input": {
"callerBallroomStyleIds": [
"waltz",
"tango"
],
"callerMinimumTempoBpm": [
84,
120
],
"callerMaximumTempoBpm": [
90,
132
],
"observedTempoBpm": 88
},
"output": {
"callerMatchingStyleIds": [
"waltz"
],
"signedTempoMarginsToStyleRangesBpm": [
2,
-32
]
}
}Limitations and assumptions
No federation ranges, music-style identification or bars-to-beats conversion is supplied.
Numeric inputs, where present, must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Numeric lists are limited to 10,000 entries; string lists to 128 strings of at most 128 characters each. The rules above may impose smaller limits. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.
Alternative or Complementary methods
Use Quickstep Bars Per Minute Figure Density: A quickstep figure-start log preserves variable figure spans. Measured bars per minute converts the actual phrase ledger to elapsed time. For a complementary task, use Half Time Double Time Rhythm Feel Classifier: Half/normal/double-time feel compares measured count intervals with an audio beat period. Variable or ambiguous matches remain unclassified.
References
-
Tempo Range Ballroom Style Lookup — tool.io
Similar or alternative tools
- Quickstep Bars Per Minute Figure Density
A quickstep figure-start log preserves variable figure spans. Measured bars per minute converts the actual phrase ledger to elapsed time.
- Half Time Double Time Rhythm Feel Classifier
Half/normal/double-time feel compares measured count intervals with an audio beat period. Variable or ambiguous matches remain unclassified.