force Plates module

forcePlates

The module contains convenient functions for working with force plate.

check out the script : Tests est_forcePlateMatching.py for examples

pyCGM2.ForcePlates.forceplates.ForcePlateIntegration(ReactionForce, mass, frameInit=0, frameEnd=None, v0=[0, 0, 0], p0=[0, 0, 0], analogFrequency=1000)

integration of the reaction force

Parameters

  • ReactionForce (array[frames,3) – ground reaction force

  • mass (double) – bodymass

  • frameInit (int,Optional[0]) – initial frame of the area of interest

  • frameEnd (int,Optional[None]) – initial frame of the area of interest.

  • v0 (list,Optional[0,0,0]) – initial velocity.

  • p0 (list,Optional[0,0,0]) – initial position.

  • analogFrequency (double,optional[1000]) – analog frequency.

pyCGM2.ForcePlates.forceplates.addForcePlateGeneralEvents(btkAcq, mappedForcePlate)

add maximum force plate as general event

Parameters

  • btkAcq (btk.acquisition) – btk acquisition instance

  • mappedForcePlate (str) – letters indicated foot assigned to a force plate (eg LRX)

pyCGM2.ForcePlates.forceplates.appendForcePlateCornerAsMarker(btkAcq)

update a btk acquisition with force plate corners as marker

Parameters

btkAcq (Btk.Acquisition) – a btk acquisition instance

pyCGM2.ForcePlates.forceplates.correctForcePlateType5(btkAcq)

Correct acquisition with force plate of type 5

Parameters

btkAcq (btk.acquisition) – btk acquisition instance

pyCGM2.ForcePlates.forceplates.matchingFootSideOnForceplate(btkAcq, enableRefine=True, forceThreshold=50, left_markerLabelToe='LTOE', left_markerLabelHeel='LHEE', right_markerLabelToe='RTOE', right_markerLabelHeel='RHEE', display=False, mfpa=None)

Convenient function detecting foot in contact with a force plate

This function firsly assign foot side to FP from minimal distance with the application point of reaction force. A refinement is done subsequently, it confirm if foot side is valid. A foot is invalided if :

  • FP output no data superior to the set threshold

  • Foot markers are not contain in the polygon defined by force plate corner

Parameters

  • btkAcq (Btk.Acquisition) –

  • enableRefine (bool,Optional) – enable refinement from vertical force of the foot assigned from marker position.

  • forceThreshold (double,Optional[50]) – vertical force threshold.

  • left_markerLabelToe (type,Optional[LTOE]) – marker label of the left toe.

  • left_markerLabelHeel (type,Optional[LHEE]) – marker label of the left heel.

  • right_markerLabelToe (type,Optional[RTOE]) – marker label of the right toe.

  • right_markerLabelHeel (type,Optional[RHEE]) – marker label of the right heel.

  • display (bool,Optional[false]) – display n figures (where n is the force plate number) presenting relative distance between mid foot and the orgin of the force plate.

  • mfpa (str,Optional[None]) – force plate manually assigned from Vicon Eclipse.