Thanks Fraser, this really clarifies (I think the spec does not mention 'per second' explicitly hence the confusion about what the units represent).
The remaining questions on this topic I have are:
1) Veolcity Max in the API is 115000
- is there any particular reason why this is 115,000? I can actually drive motor faster by just setting Velocity to a higher value so I am unsure to the logic behind 115,000 - I assume this could be some hardware limitation?
2) Will the controller limit the velocity to what is set as Stepper.Velocity regardless of acceleration? In other words, the controller will not try to accelerate once it reaches the set velocity, correct? I assume this is the case but I have been getting a resonance-like high pitch noise from the motor at various (high) speeds and it felt like velocity going above what was set but I can't be sure so wanted to confirm controller will not exceed velocity