Multisubject: Difference between revisions

From Software Product Documentation
Jump to navigation Jump to search
Line 78: Line 78:


[https://youtu.be/lT6syqzs2OQ Link to YouTube video]
[https://youtu.be/lT6syqzs2OQ Link to YouTube video]


{| class="wikitable mw-collapsible mw-collapsed" width="100%"
{| class="wikitable mw-collapsible mw-collapsed" width="100%"
Line 88: Line 87:


|}
|}
===Compute Model Based Command===
===Compute Model Based Command===



Revision as of 15:08, 4 April 2022

Language:  English  • français • italiano • português • español 

Introduction

The multi-subject option allows users to easily work with datasets that include more than one subject in a dynamic trial. For example, two people sparring or dancing within the capture volume.

It's expected that subject prefixes are used in the C3D files. For example, a target is named "S001:LMK" where "S001:" is the subject prefix and "LMK" is the target name (note: most camera manufacturers already support this option).

For the static trial, the multiple subjects can be in the same C3D file, or in multiple static C3D files.

NOTES:

  • If only collecting data with one subject in the volume, nothing about your processing procedure should change and you should not export C3D files with subject prefixes from your camera manufacturer.
  • This documentations refers mostly using the multi-subject workspace with two subjects, however, you can use as many subjects as you would like.

Model Tab

ALL_SUBJECTS, NO_SUBJECT, subject prefixes

  • ALL_SUBJECTS
    • Allows you to view all segments with subject prefixes
  • NO_SUBJECT
    • Allows you to view all segments not associated with a subject prefix (ex. LAB)
  • Subject prefixes
    • Allows you to view all segments associated with that subject prefix

Important Terms

Subject Prefix: In the C3D file, there is a parameter to specify the subject prefix.

  • This should be specified by your motion capture system.
  • The subject prefixes can be different from C3D file to C3D file

Subject Tag: A subject tag associates a generic name to a subject prefix.

  • Model -> Add/Modify Subject Tags
  • Can be set using Select_Active_File

Pipeline

  • The first step to writing a pipeline is to assign a subject tag to a subject prefix using the Set_Subject_Tag command. This is important since a subject prefix can be different for each data collection (ex. "S001:", "S002:"). The subject tag should be something general (ex. "Pitcher", "Catcher").
  • Once the subject tags have been defined, you can use the subject tags the same as you would a file tag using the Select Active File command.
  • The resulting pipelines will work on the active subject tags that were specified in the Select Active File command

Important Pipeline Commands

Example

Model Building

Link to YouTube video

Model Building Information

Building a model template should be the same when using one subject, or two. Create one model template for each marker set. You can apply and append model templates to different subjects.

Compute Model Based Command

Link to YouTube video

Compute Model Based Data Information

The compute model based functionality works the same as it always has, but also allows the customer to use Subject_Tags to identify when signals should be calculated for every subject in the model, between subjects, etc.

Note: Segment A and Segment B tag refer to the Segment tag, or Reference Segment or Resolution Coordinate System.

Case 1:
Signal created for all subjects. Ex. RKneeAngle
Subject tag: ALL_SUBJECTS
Segment A Tag: ALL_SUBJECTS
Segment B Tag: ALL_SUBJECTS

Case 2:
Signal created for all subjects relative to a segment that is only created in NO_SUBECT (ex. subject's foot relative to generic segment BOX).
Subject tag: ALL_SUBJECTS
Segment A Tag: ALL_SUBJECTS
Segment B Tag: NO_SUBJECT

Case 3:
Signal created for one subject between segments that exist in that subject.
Subject tag: SUBJECT_TAG_NAME
Segment A Tag: SUBJECT_TAG_NAME
Segment B Tag: SUBJECT_TAG_NAME

Case 4:
Signal created for one subject relative to another subject.
Subject tag: SUBJECT_TAG_NAME
Segment A Tag: SUBJECT_TAG_NAME
Segment B Tag: DIFFERENT_SUBJECT_TAG_NAME

Retrieved from ""