# Tempo Ramp Planner (Speed Trainer)

> Plan a speed-building ramp: +N BPM every M bars up to your goal, as a table and click track. Build a piece up to speed step by step: choose a start tempo, a target, the step in BPM and how many bars each tempo lasts. You get the plan with the time each stage starts, the total practice time, a song map for the Tonegrid metronome and the whole ramp as a MIDI file and a WAV click track. Works for slowing down too.

Part of usefulweb.app (https://usefulweb.app/). Part of [Tonegrid](https://tonegrid.usefulweb.app/) (ownerApp: tonegrid). Results are deterministic calculations from the inputs and the listed assumptions; the API returns exactly what the web page shows.

## Use it
- Human interface: https://tonegridtemporamp.usefulweb.app/ (interactive tool at https://tonegridtemporamp.usefulweb.app/tool)
- JSON API: POST https://tonegridtemporamp.usefulweb.app/api/v1/calculate with a JSON object of inputs (schema: https://tonegridtemporamp.usefulweb.app/api/v1/tool)
- OpenAPI: https://tonegridtemporamp.usefulweb.app/openapi.json
- MCP (Streamable HTTP): https://tonegridtemporamp.usefulweb.app/mcp - tool `tonegrid_tempo_ramp`

## Inputs
- start (number): Start tempo (BPM)
- target (number): Target tempo (BPM)
- step (number): Change per stage (BPM)
- every (integer): Bars per stage
- meter (text): Meter
- groups (text): Accent groups (optional) - Numbers joined by + that add up to the beats per bar; empty = accent only on beat 1.
- sub (select): Subdivision
- hold (integer): Extra bars at the target
- sound (select): Click sound
- countIn (integer): Count-in bars
- audio (boolean): Render a WAV click track as well

## Method
- Stages run from the start tempo towards the target in steps of the chosen size; the last stage is exactly the target and lasts the stage bars plus the extra bars. Each stage becomes one section of a song map, so the same plan plays in Tonegrid’s metronome (Practice view) and in the Click Track Maker.
- Stage times add up bar lengths (beats × 60 / tempo). The MIDI file carries a tempo change at every stage; the WAV click track uses the same click timeline sample by sample.
- Practising slowly and raising the tempo in small steps once a passage is clean is a common teaching approach; the step size and bars per stage are your choice.

## Limits
- Practice aid only. Take breaks and stop if your hands or arms hurt.