compute_velocity#

movement.kinematics.compute_velocity(data)[source]#

Compute velocity array in cartesian coordinates.

The velocity array is the first time-derivative of the position array. It is computed by applying the second-order accurate central differences method on the position array.

Parameters:: data (xarray.DataArray) – The input data containing position information, with time and space (in Cartesian coordinates) as required dimensions.
Returns:: An xarray DataArray containing velocity vectors in cartesian coordinates.
Return type:: xarray.DataArray

Notes

For the position array of a poses dataset, the velocity array will hold the velocity vectors for every keypoint and every individual.

For the position array of a bboxes dataset, the velocity array will hold the velocity vectors for the centroid of every individual bounding box.