markersToArray#

pyCGM2.Tools.btkTools.markersToArray(acq: btkAcquisition, markers: List[str] | None = None, gathercolumn: bool = False)#

Converts marker position data from a BTK acquisition to a numpy array.

Parameters:
  • acq (btk.btkAcquisition) – BTK acquisition instance.

  • markers (List[str], optional) – List of marker labels to include. If None, includes all markers. Defaults to None.

  • gathercolumn (bool) – gather axis. return array is organized as [mark0_X,…markN_X, mark0_Y,…markN_Y, mark0_Z,…markN_Z,]

Returns:

np.ndarray – Array of marker trajectories with dimensions [n_frames, n_markers * 3].