Differences

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

--- inspect3d:documentation:definitions:directory_structure_for_input_data [2024/06/18 20:20] – sgranger
+++ inspect3d:documentation:definitions:directory_structure_for_input_data [2024/07/12 13:26] (current) – removed sgranger
@@ Line 1: / Line 1: @@
-there is a basic directory structure for inspect3d's input data that aligns with some useful concepts from the experiments that produced the data. this directory structure organizes the [[visual3d:documentation:definitions:file_formats:cmz_format_|cmz files]] and [[visual3d:documentation:c3d_signal_types:c3d_format|c3d files]] that contain the information relevant for analysis. this structure has 5 levels, from root folder to deepest leaf they are:
-  - study
-  - group
-  - session
-  - task
-  - trial
-===== study =====
-although the name of this directory level suggests that the data it contains is only used for one study, this is not necessary. as a top-level concept this is the largest, most general database that is stored in one location. this could be specific to a study, or it could be specific to a project, researcher, lab, or consortium. in these latter cases it is possible to define [[inspect3d:documentation:dialogs:advanced_query_section|queries]] to extract the specific signals that are desired for an individual study.
-===== group =====
-this level of the directory structure is optional, but it allows the researcher to divide c3d files according to desired parameters, e.g., women - men, old - young. if this level is omitted from the structure then individual c3d files can be [[visual3d:documentation:definitions:tag|tagged]] with the necessary parameters to allow for their specific selection.
-===== session =====
-this directory level can be conceived as a single day (or single effort) of data collection within the database. this is the most important level as this is where the [[visual3d:documentation:definitions:file_formats:cmz_format_|cmz file]] and log files get stored. this is also the level of the directory where static models are stored for all subjects involved in the session.
-===== task =====
-this level of the directory allows the researcher to divide c3d files according to the desired activity, e.g., walking, running, jumping, etc. as with group-level parameters, c3d files can be coded with these different tasks by using [[visual3d:documentation:definitions:tag|tags]].
-===== trial =====
-at this level of the directory structure we have individual trials. this means that we have the individual c3d files that are recorded by the motion capture system.