Skip to content

Latest commit

 

History

History
246 lines (200 loc) · 7.67 KB

working-with-data.md

File metadata and controls

246 lines (200 loc) · 7.67 KB
Raw

Working with data

Available data

The data that is available depends on your measurement. Typically there will be marker and skeletal data.

Calqulus can import the following kinds of data from your measurements:

  • Marker
  • Skeletal (accessible via segments)
  • EMG
  • Kinetics (accessible via joints)
  • Force plate
  • Events

Importing data

To access data in a Calqulus pipeline you can either reference it by name directly or use a step node to explicitly import it, for example using the import step.

Examples

The following examples shows how you can work with segments in three different ways.

Using segment step.

- parameter: segmentUsingSegmentStep
  steps:
   - segment: LeftLeg => shank
   - segment: LeftUpLeg => thigh
   - angle: [shank, thigh]

Using import step.

- parameter: segmentImportStep
  steps:
   - import: LeftLeg
     output: shank
   - import: LeftUpLeg
     output: thigh
   - angle: [shank, thigh]

Using direct reference.

- parameter: segmentByName
  steps:
   - angle: [LeftLeg, LeftUpLeg]

Just like with segments, you can access joints using import or by directly refering to the joint by name.

- parameter: jointImportStep
  steps:
   - import: [RightKnee]
     output: knee
   - multiply: [knee.fx, knee.fy]
- parameter: jointByName
  steps:
   - multiply: [RightKnee.fx, RightKnee.fy]

See Segment and joint names for a complete reference of available segment & joint names.

Importing kinetic data

Kinetic data is accessible on joints when one or more measurement includes force plates.

Examples

Importing forces.

- parameter: LeftAnkleForce
  steps:
    - import: [[LeftAnkle.fx, LeftAnkle.fy, LeftAnkle.fz]]

Importing moments.

- parameter: LeftAnkleMoment
  steps:
    - import: [[LeftAnkle.mx, LeftAnkle.my, LeftAnkle.mz]]

Importing power (scalar).

- parameter: LeftAnklePower
  steps:
    - import: [[LeftAnkle.p]]

Importing center of pressure.

- parameter: LeftFootCop
  steps:
    - import: [[LeftFootContact.x, LeftFootContact.y, LeftFootContact.z]]

Importing ground reaction force.

- parameter: LeftGrf
  steps:
    - import: [[LeftFootContact.fx, LeftFootContact.fy, LeftFootContact.fz]]

See Segment and joint names for a complete reference of available segment & joint names.

Components

You can access components of your data using dot (.) notation.

Example of multiplying the x and y component of a marker.

- parameter: xy
  steps:
   - multiply: [MyMarker.x, MyMarker.y]

Available components

Marker

Position

  • x, y, z

Segment

Position

  • x, y, z

Orientation

  • rx, ry, rz, rw

Joint

Position

  • x, y, z

Force

  • fx, fy, fz

Moment

  • mx, my, mz

Power

  • p

Force plate

Center of pressure

  • x, y, z

Force

  • fx, fy, fz

Moment

  • mx, my, mz

Properties

A similar concept to components are "properties". A property can be any type of data while components are series of data, where each component has the same length. Properties are not included when a signal is imported into a step and are not automatically exported, but can be explicitly imported into a pipeline.

Properties are accessed in the same way as components, using the dot (.) notation.

Example of creating LON and LOFF events from the LeftFootContact.events.on and LeftFootContact.events.off properties.

- event: LON
  steps:
   - import: LeftFootContact.events.on

- event: LOFF
  steps:
   - import: LeftFootContact.events.off

Available properties

Joint

  • events.on
  • events.off

The on and off events indicate the frames where the foot has started and stopped being assigned to a force plate. This event filters out cycles where the foot is already assigned to the force plate at the immediate beginning or end of the measurement.

Note: Only available on LeftFootContact and RightFootContact joints.

  • events.loadStart
  • events.loadEnd

The loadStart and loadEnd events indicate the frames where the foot has started and stopped being assigned to a force plate. This event includes cycles where the foot is already assigned to the force plate at the immediate beginning or end of the measurement.

Note: Only available on LeftFootContact and RightFootContact joints.

Quick reference

Segments

Left Unilateral Right
Head
Neck
LeftShoulder RightShoulder
LeftArm RightArm
LeftForeArm RightForeArm
LeftHand RightHand
Spine2
Spine1
Spine
Hips
LeftUpLeg RightUpLeg
LeftLeg RightLeg
LeftFoot RightFoot
LeftToeBase RightToeBase

Joints

Left Unilateral Right
LeftHip RightHip
LeftKnee RightKnee
LeftAnkle RightAnkle
LeftFootContact* RightFootContact*

* These are virtual joints where the external forces and moments will be applied to one or more segment extremities. It is used during the inverse dynamics procedure. For example in gait, this Contact joint is the center of pressure where the foot is in contact with the force plate. It is useful if one wants to access the force plate data such as center of pressure, force and free moment.

Markers (Sports marker set)

Left Unilateral Right
HeadFront
HeadL HeadR
Chest
WaistLFront WaistRFront
SpineThoracic2
SpineThoracic12
WaistBack
WaistLFront WaistRFront
WaistL WaistR
LShoulderTop RShoulderTop
LElbowOut RElbowOut
LElbowIn RElbowIn
LWristIn RWristIn
LWristOut RWristOut
LThighFrontLow RThighFrontLow
LKneeOut RKneeOut
LKneeIn RKneeIn
LShinFrontHigh RShinFrontHigh
LAnkleOut RAnkleOut
LForefoot5 RForefoot5
LForefoot2 RForefoot2
LArm RArm
LHand2 RHand2
LHeelBack RHeelBack
LHeelBack RHeelBack