Differences

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

--- inspect3d:documentation:dialogs:advanced_query_section [2024/06/18 20:20] – sgranger
+++ inspect3d:documentation:dialogs:advanced_query_section [2024/07/12 13:26] (current) – removed sgranger
@@ Line 1: / Line 1: @@
-{{{{{{{{{{{{{{\\
-the query builder dialog is used to define the queries that will extract signals from the loaded cmz library. the dialog also allows you to group specific signals together based on a number of possible features, e.g. right/left or intact/affected.
-querybuilder.png
-===== auto-populate queries =====
-inspect3d has the convenient ability to automatically define queries based on common signals and groupings. this feature saves the user from the tedious task of manually defining common queries. more information about auto-populating groups can be found [[inspect3d:documentation:dialogs:auto-populate_groups|here]].
-===== query definition file =====
-i3dadvancedqueriesdialogueloadsave.png
-inspect3d also allows users to save time by saving queries definitions to a [[inspect3d:documentation:files:q3d_query_file|.q3d file]] so that they can be easily re-used during future analysis. this capability is at its most useful when using the load group def & compute groups option in the group definitions drop-down menu.
-===== queries and conditions =====
-|you can define groups and sub-groups for the signals in the cmz library.\\ \\ * an example **group** is "anklemoment_x"\\ * example **sub-groups** for "anklemoment_x" are "lanklemoment_x" and "ranklemoment_x"\\ * a group can have as many sub-groups as necessary (1-n)\\ \\ names for queries and conditions can include spaces and special characters. note, however, that some special characters can cause difficulty for updating cmz libraries with exclusions. condition names can be repeated between different queries but not within a single query.  |  i3dadvancedqueriesdialoguequeryname2.png|
-===== condition definition =====
-the condition definition lets you define the signals you want to query. query results are defined according to the signals you want from the cmz library, the events or event sequences to which you want to time normalize the signals, and any further refinements that you want to apply, e.g., threshold values.
-==== signals ====
-|i3d_groupdef_signals.png  |this tab allows the user to select a signal according to how it is specified in the [[visual3d:documentation:visual3d_signal_types:data_tree_summary_|visual3d data tree]]. this specification includes four components with an additional option to negate the results.\\ \\ * type\\ * folder\\ * name\\ * component\\ * negate results  |
-==== events ====
-|i3d_groupdef_events.png  |this tab allows user to specify the events to which the data will be normalized, which event sequences should be excluded, and how the data should be normalized.\\ \\ * **event sequence:** events to normalize data to\\   * typically kinematic signals are normalized from r/lhs to r/lhs\\   * typically kinetic signals are normalized from r/lon to r/lhs\\ * **exclude events:**\\   * event sequences that data should not be included\\ * **number of points:** typically a gait cycle is normalized to 101 data points\\ * **spline type:** cubic or linear - you should use a cubic spline to normalize the data  |
-==== refinement ====
-|i3d_groupdef_refinement.png  |this tab permits signal selection to be refined according to additional conditions that must be met. there are two broad types of refinements:\\ \\ * **refine using tag:** any tags that exist in the workspace can be selected\\   * **use and logic:** determines how to treat refinements based on more than one tag. if checked, then the query will only include trials that contain all of the selected tags. if unchecked then the query will include trials that contain any of the selected tags.  |
-\\
-\\
-|* **refine using signal:** these refinements allow users to specify additional criteria that must be met before a signal in brought into the group you define. these criteria are defined using the following information:\\   * **refinement name:** each refinement in a sub-group requires a unique name\\   * **signal definition:** specify the signal you want to work with as it is referenced in the [[visual3d:documentation:visual3d_signal_types:data_tree_summary_|visual3d data tree]], i.e., type, folder, name, and component.\\   * **value must be:** there are 6 types of criteria that can be specified for a refinement.\\     * **less than**: the signal must be less than the specified threshold to be included\\     * **greater than**: the signal must be greater than the specified threshold to be included\\     * **equal to**: the signal must be equal to the specified threshold to be included\\     * **not equal to**: the signal must not be equal to the specified threshold to be included\\     * **between**: the signal must be between the two specified values to be included\\     * **manual**: the signal must satisfy the specified [[visual3d:documentation:pipeline:expressions:overview|visual3d expression]]  |i3d_groupdef_refinementdialog.png  |
-}}}}}}}}}}}}}}