Differences

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

--- sift:application:query_builder_dialog [2024/09/12 18:43] – [Combine Sides] wikisysop
+++ sift:application:query_builder_dialog [2024/11/15 16:04] (current) – wikisysop
@@ Line 1: / Line 1: @@
 ====== Query Builder Dialog ======
-The Query Builder 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.
+The {{:sift_query_builder.png?30x30}}Query Builder 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. This dialog is available when there is a [[sift:tutorials:load_and_view_data#load_library|loaded library]] in Sift.
-{{:sift_query_builder_whole.png}}\\
+{{:sift_query_builder_whole.png}}
   * **Auto-Populate Queries**: Opens the Auto Populate Query Dialog.
@@ Line 10: / Line 9: @@
   * {{:sift_load_queries.png?30x30}}**Load Query Definitions**: Load a previously saved list of definitions.
   * {{:sift_save.png?30x30}}**Save Query Definitions**: Save the current list of definitions for later use.
+  * **Queries**: A list of the current queries in Sift.
+    * **+**: The plus button begins adding a new query.
+  * **Conditions**: A list of the conditions for the selected query.
+    * **+**: The plus button begins adding a new condition to the currently selected query.
   * **Calculate Selected Queries**: Calculate only the queries that are currently selected in the Queries Box.
   * **Calculate All Queries**: Calculate all generated queries.
@@ Line 15: / Line 18: @@
 ===== Manual Query Definition =====
-Manual query definition allows users to exactly specify which signals and metrics they want to pull out of the loaded library by creating conditions for each  definition of signals.
+Manual query definition allows users to exactly specify which signals and metrics they want to pull out of the loaded library by creating conditions for each  definition of signals. This is broken into several distinct tabs:
-==== Signals ====
-{{:sift_manual_queries.png}}\\
 **Query Name**: The title displayed for the defined query
 **Condition Name**: The title of the condition to be added to the query
+----
+==== Signals ====
+This section allows you to select the signal being queried from the loaded library.
+{{ :sift_manual_queries.png}}
 **Type**: The type of signal used for the query definition.
@@ Line 34: / Line 41: @@
 **Negate Signal**: If checked the defined signal will be negated
+----
 ==== Events ====
-{{:sift_query_builder_events.png}}
+This section allows you to section the queried signal, based on events that are found in the loaded library files.
+{{ :sift_query_builder_events.png}}
 **All Events Boxs**: A list of all events defined in the library
-**Event Sequence**: All events selected for the queries sequence of events**Excluded Events**: All events to be excluded for the query
+**Event Sequence**: All events selected for the queries sequence of events. Queried signals will begin and end at the beginning and end of this sequence
+**Excluded Events**: All events to be excluded for the query
 **>**: Move the selected event into the Event Sequence or Excluded Events widgets
@@ Line 52: / Line 64: @@
 **Number of Points**: The number of points to which traces will be time normalized. If 0 is chosen then the queried traces will NOT be time normalized.
-**Spline Type**: Choose between a Cubic or Linear spline.
+**Spline Type**: Choose between a Cubic or Linear spline. Used for normalization
+----
 ==== Refinement ====
-{{:sift_query_builder_manual_refinement.png}}
+This section allows you to refine the queried signal, based on tags or events found in the loaded library files.
+{{ :sift_query_builder_manual_refinement.png}}
 **Refine using tag**: If checked query will be refined using the selected tags
@@ Line 72: / Line 86: @@
 **Negate selected signals**: If checked selected signals will be negated, it will refine the query to signals WITHOUT the selected tag
+----
 === Signal Refinement Dialog ===
-{{:sift_query_builder_refinement_generater.png}}
+{{ :sift_query_builder_refinement_generater.png}}
 **Refinement Name**: The title displayed for the created refinement.
+**Global Value (across trial metric)**: If the signal is trial-specific value.
 **Type**: The Type of signal used for the refinement.
@@ Line 95: / Line 113: @@
 {{:sift_apply.png?30x30}}**Save**: Close the Refinement Builder and save the generated refinement to the signals list.
+----
 ===== Auto Populate Queries =====
 The Auto Populate Queries button opens up a dialog that will allow you to customize the signals the auto generated query will pull from.
-{{:sift_query_builder_auto_builder.png}
+{{ :sift_query_builder_auto_builder.png}}
 {{:sift_browser.png?30x30}}**Auto-populate Settings File**: This can be used to load in auto-population settings that have been previously saved.
@@ Line 107: / Line 127: @@
 {{:sift_apply.png?30x30}}**Create**: Will auto generate queries based on the parameters provided.
+----
 ==== Signals ====
 The signals tab is used to specify what signals to use when creating a query.<
-{{:sift_query_builder_signals.png}}
+{{ :sift_query_builder_signals.png}}
 **Signal Type**: Refers to the type of signal being queried e.g. LINK_MODEL_BASED, DERIVED, METRIC etc.
@@ Line 119: / Line 142: @@
 **Signal Names**: All the signals found of the given type in the specified folder.
-==== Combine Sides ====
+----
+==== Combine Sides ====
 Provides options for combining signals together based on, side, tags etc.
@@ Line 126: / Line 150: @@
 {{:sift_query_builder_combine_sides.png}}
+----
 ==== Refinements ====
 The refinements tab allows you to refine the queries generated based on tags or even specific signal values.
-{{:sift_query_builder_refinements.png}}
+{{ :sift_query_builder_refinements.png}}
 **Tags**: The Tag multi-selector selects which tags to be included in the query.
@@ Line 137: / Line 162: @@
 **Add Signal**: Opens the signal refinement dialog.
+----
 ===== Queries and Conditions Widgets =====
@@ Line 142: / Line 169: @@
 All generated queries and their associated conditions are displayed in the Queries and Conditions widget.
-{{:sift_query_builder_quey_condition_box.png}}
+{{ :sift_query_builder_quey_condition_box.png}}
+==== Queries ====
 {{:sift_action_add.png?30x30}}**Add Query / Condition**: Adds a new query or condition.
@@ Line 149: / Line 178: @@
 **Context Menu (Queries)**: Right click on a query to open the context menu.
+**Calculate**: Calculate the currently selected queries.
 {{:sift_modify.png?30x30}}**Edit** Modify the selected query
@@ Line 156: / Line 187: @@
 **Duplicate**: Create a copy of the selected query.
-**Reflect**: Create an inverted copy of the selected condition e.g. if selecting right ankle angle x, the copy will be left ankle angle x.
+==== Conditions ====
 **Context Menu (Conditions)**: Right click on a condition to open the context menu.
-**Calculate**: Calculate the currently selected queries.
+{{:sift_modify.png?30x30}}**Edit** Modify the selected condition
-{{:sift_modify.png?30x30}}**Edit** Modify the selected query
+{{:sift_action_remove.png?30x30}}**Remove** Delete the selected conditions.
-{{:sift_action_remove.png?30x30}}**Remove** Delete the selected queries.
-**Duplicate**: Create a copy of the selected query.
+**Duplicate**: Create a copy of the selected condition.
+**Reflect**: Create an inverted copy of the selected condition e.g. if selecting right ankle angle x, the copy will be left ankle angle x.