Differences

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

--- other:inspect3d:documentation:definitions:subject [2024/07/16 17:01] – removed sgranger
+++ other:inspect3d:documentation:definitions:subject [2024/12/17 18:58] (current) – wikisysop
@@ Line 1: / Line 1: @@
+====== Subject ======
+A subject is an individual participant for whom motion capture data exists within the [[Visual3D:Documentation:Definitions:CMO_Library_|CMO library]]. Whereas previously Inspect3D assumed that every [[Visual3D:Documentation:Definitions:File_Formats:CMZ_Format_|CMZ file]] was associated with one subject, the advent of multisubject motion capture collection invalidated this assumption. See the Visual3D wiki for its perspective on analyzing [[Visual3D:Documentation:Definitions:Multisubject|multisubject data]].
+===== Identifying Subjects =====
+Subjects can be identified in one of two ways: by a particular prefix and by a set of [[visual3d:documentation:definitions:subject_tags|subject tags]].
+==== Subject Prefixes ====
+A subject prefix is a set of characters, like "S001" or "S002", that is prepended to the beginning of signal names in order to distinguish between two signals with the same anatomical meaning for different subjects within a single [[Visual3D:Documentation:C3D_Signal_Types:C3D_Format|.c3d file]]. Adding this subject prefix ensures that, for example, if the signal AnkleMoment_X exists for two subjects within a single .c3d file then the signal names "S001:AnkleMoment_X" and "S002:AnkleMoment_X" are unambiguous for both Inspect3D and the human user.
+==== Subject Tags ====
+A [[visual3d:documentation:definitions:subject_tags|subject tag]] is a generic name that can be associated with a subject in the way that [[Visual3D:Documentation:Definitions:Tag|file tags]] can be used to group files with particular characteristics. For example, within a single [[Other:Inspect3D:Documentation:Definitions:Directory_Structure_for_Input_Data#Study|study]] there could be many subjects with the Pitcher tag and many subjects with the Batter tag. Or, there could be many Ballcarrier subjects and many Tackler subjects.
+===== Querying based on Subject =====
+If Inspect3D detects that your [[Visual3D:Documentation:Definitions:CMO_Library_|CMO library]] contains multisubject data (via the presence of subject prefixes and tags) then you will be able to use these in your [[Other:Inspect3D:Documentation:Dialogs:Advanced_Query_Section|query definitions]]. In addition to the [[visual3d:documentation:definitions:subject_tags|subject tags]] found in the [[Visual3D:Documentation:Definitions:CMO_Library_|CMO library]], you can also use the "meta-tags" NO_SUBJECT or ALL_SUBJECTS to define which signals you want your query to return.
+[[File:Inspect3D-Multisubject-AutopopulateGroups.PNG|{{:inspect3d-multisubject-autopopulategroups.png?200x284|"The auto-populate groups dialog allows queries to be defined according to subject tags."}}]]\\
+The auto-populate groups dialog allows queries to be defined according to [[visual3d:documentation:definitions:subject_tags|subject tag]].
+===== Exploring Multisubject Queried Data =====
+Auto-building groups will append the [[visual3d:documentation:definitions:subject_tags|subject tag]] used to the end of the group name within the [[Other:Inspect3D:Documentation:Pages:Queried_Data|Queried Data]] subwindow. [[Other:Inspect3D:Documentation:Definitions:Workspace|Workspaces]] in the Queried Data subwindow will have the relevant subject prefix appended as well.
+[[File:Inspect3D-Multisubject-QueriedData.PNG|{{:inspect3d-multisubject-querieddata.png?400x473|"For multisubject data, the Queried Data subwindow will display subject tags in group names and subject prefixes in workspace names."}}]]\\
+For multisubject data, the Queried Data subwindow will display [[visual3d:documentation:definitions:subject_tags|subject tags]] in group names and subject prefixes in workspace names.