HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » definitions » Multisubject
visual3d:documentation:definitions:multisubject

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
visual3d:documentation:definitions:multisubject [2025/02/06 19:53] – sgrangervisual3d:documentation:definitions:multisubject [2025/04/30 14:14] (current) – wikisysop
Line 1: Line 1:
-====== Multisubject ======+===== Multisubject =====
  
-\\ +Support for multisubject C3D files 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).
-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. For the static trial, the multiple subjects can be in the same C3D file, or in multiple static C3D files.
  
-**NOTES:**+==== 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.   * 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.
Line 15: Line 12:
  
   * This documentation refers mostly using the multi-subject workspace with two subjects, however, you can use as many subjects as you would like.   * This documentation refers mostly using the multi-subject workspace with two subjects, however, you can use as many subjects as you would like.
 +
 +==== Important Terms ====
 +
 +**[[visual3d:documentation:definitions:subject_prefixes|Subject Prefix]]**: In the C3D file, there is a parameter to specify the subject prefix. This should be specified by your motion capture system. Subject prefixes can be different from C3D file to C3D file
 +
 +{{:C3DSubjectPrefixes.png}}
 +
 +**[[visual3d:documentation:definitions:subject_tags|Subject Tag]]**: A subject tag associates a generic name to a subject prefix, for example "Ball-carrier" or "Tackler". The active Subject Tag can be set using the [[visual3d:documentation:pipeline:file_commands:select_active_file|Select_Active_File]] pipeline command.
 +
 +{{:SubjectTags.png}}
  
 ==== Model Tab ==== ==== 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  |  {{:multisb.png}}|+Within the [[visual3d:documentation:definitions:model_builder_mode|Model Builder tab]] the user can choose between the following options for active subject: ALL_SUBJECTS, NO_SUBJECT, and any individual subject prefix.
  
-==== Important Terms ==== +{{:multisb.png}}
- +
-|**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  |  {{:C3DSubjectPrefixes.png}}|+
  
-|**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  |  {{:SubjectTags.png}}|+^ Selection ^ Description ^ 
 +| 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. |
  
 ==== Pipeline ==== ==== Pipeline ====
Line 37: Line 45:
  
   * [[Visual3D:Documentation:Pipeline:Model_Commands:Set_Subject_Tag|Set_Subject_Tag]]: Sets subject tags for specific files   * [[Visual3D:Documentation:Pipeline:Model_Commands:Set_Subject_Tag|Set_Subject_Tag]]: Sets subject tags for specific files
- 
   * [[Visual3D:Documentation:Pipeline:File_Commands:Select_Active_File#Subject_Tags|Select_Active_File]]: Use subject tags to precisely specify your active files   * [[Visual3D:Documentation:Pipeline:File_Commands:Select_Active_File#Subject_Tags|Select_Active_File]]: Use subject tags to precisely specify your active files
- 
   * [[Visual3D:Documentation:Pipeline:File_Commands:Modify_C3D_Subjects_Parameters|Modify_C3D_Subjects_Parameters]]: Modify the parameters in the SUBJECTS group in the c3d file   * [[Visual3D:Documentation:Pipeline:File_Commands:Modify_C3D_Subjects_Parameters|Modify_C3D_Subjects_Parameters]]: Modify the parameters in the SUBJECTS group in the c3d file
  
 ==== Examples ==== ==== Examples ====
  
-=== Building Multi-subject Models === +=== Example 1: Building Multi-subject Models ===
- +
- +
-Load video +
- +
-YouTube +
- +
- +
- +
-YouTube might collect personal data. [[https://www.youtube.com/howyoutubeworks/user-settings/privacy/|Privacy Policy]] +
- +
-Continue +
-Dismiss +
- +
- +
- +
- +
- +
-Building a model template is the same for two subjects as it is for one subject. Create one model template for each marker set. You can apply and append model templates to different subjects. +
- +
-\\ +
- +
- +
-=== Computing Model-Based Items for Multi-Subject Data === +
- +
- +
-Load video +
- +
-YouTube +
- +
- +
- +
-YouTube might collect personal data. [[https://www.youtube.com/howyoutubeworks/user-settings/privacy/|Privacy Policy]] +
- +
-Continue +
-Dismiss +
  
 +The compute model-based command works the same for multiple subjects as it always has for single subjects, but now also allows the customer to use [[Visual3D:Documentation:Definitions:Subject_Tags|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). 
-The compute model-based command works the same for multiple subjects as it always has for single subjects, but now also allows the customer to use [[Visual3D:Documentation:Definitions:Subject_Tags|Subject_Tags]] to identify when signals should be calculated for every subject in the model, between subjects, etc.\\ +  * Subject tag: ALL_SUBJECTS 
-\\ +  * Segment A Tag: ALL_SUBJECTS 
-Note: Segment A and Segment B tag refer to the Segment tag, or Reference Segment or Resolution Coordinate System.\\ +  * Segment B Tag: NO_SUBJECT
-\\ +
-**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\\ +
-\\+
  
 +**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
  
  
visual3d/documentation/definitions/multisubject.1738871597.txt.gz · Last modified: 2025/02/06 19:53 by sgranger