Differences

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

--- visual3d:documentation:reports:2d_interactive_graphs [2024/06/19 12:53] – sgranger
+++ visual3d:documentation:reports:2d_interactive_graphs [2024/07/17 15:46] (current) – created sgranger
@@ Line 1: / Line 1: @@
-{{{{{{{{{{{{{{{{{{{{{{{{the quickview function available by left-clicking on any signal in the data tree can provide you with simple graphs. to look more closely, you can add up to five graphs in the graphs display area at the right side of the signal and event processing page. the functions to create graphs are available on the pop-up context menu which appears when you right-click on the signal of interest in the data tree. when a signal is selected for graphing, its data-tree icon temporarily changes to a little graph, as shown in the following illustration.
+====== 2D Interactive Graphs ======
-dgraphs.png\\
+The quickview function available by left-clicking on any signal in the Data Tree can provide you with simple graphs. To look more closely, you can add up to five graphs in the graphs display area at the right side of the Signal and Event Processing page. The functions to create graphs are available on the pop-up context menu which appears when you right-click on the signal of interest in the data tree. When a signal is selected for graphing, its data-tree icon temporarily changes to a little graph, as shown in the following illustration.
+{{:2Dgraphs.png}}\\
-visual3d’s graphing capabilities are quite extensive. three aspects are worthy of note here. first, the x, y and z coordinate values of point-valued signals are normally plotted separately (as shown in the illustration above), but you can choose to overlay the graphs of two or more such signals. second, graphs in the graphs display area are interactive&emdash;you can use the mouse to zoom in on specific areas. third, you can define events (see below) by clicking with the mouse at appropriate points on any graph.
-==== quickview ====
+Visual3D’s graphing capabilities are quite extensive. Three aspects are worthy of note here. First, the x, y and z coordinate values of point-valued signals are normally plotted separately (as shown in the illustration above), but you can choose to overlay the graphs of two or more such signals. Second, graphs in the graphs display area are interactive&emdash;you can use the mouse to zoom in on specific areas. Third, you can define events (see below) by clicking with the mouse at appropriate points on any graph.
-**the quick view graphs are only available when a single file is active in the workspace.** this is because the quickview graphs contain the processing history of the selected signal, and it would be challenging to display the processing history for multiple files simultaneously.
+=== QuickView ===
-=== to open and use data view ===
-  - in the data tree on the left:
+**The quick view graphs are only available when a single file is active in the Workspace.** This is because the QuickView graphs contain the processing history of the selected signal, and it would be challenging to display the processing history for multiple files simultaneously.
-    - click the + sign next to **target** folder to open the inner folders.
+== To Open and Use Data View ==
-    - click the + sign next to **original** subfolder. this reveals the contents of the original c3d data file. the red dots are the original signals as labeled by the capture system.
-  - click on the marker labeled //lft2.// with the left mouse button the //data view// dialog box will open to the **data values** tab. here you can see raw data or to export to an ascii file\\
-tutorial2_10.png tutorial2_10(2).png\\
-  - on the **data values** tab scroll down to the 24th frame. this is where the data capture system began to collect data for this segment. no data was recorded for this segment in the previous 23 frames. this is not abnormal but it is good to be aware that some markers will not have data for every frame. the reasons for this vary but in this particular case the left foot was not in view of the cameras until the 24 frame. if you see blank frame in the middle of a data set it may be an indication of an erroneous result.
+  - In the data tree on the left:
-  - open the **data graph** tab to view analog graphs. a quickview can help you to locate obviously incorrect or noisy data.
+    - Click the + sign next to **TARGET** folder to open the inner folders.
-  - open the **signal processing history** tab. although this tab is currently empty, you can view the processing history of signals here. visual3d has a command pipeline which allows the user to prepare scripts for processing data. typically these commands create new data that is derived or interpolated from their original data. determining the distance between 2 points would be an example of such deriving data. the **signal processing history** tab will tell you what events if any took place on the data.
+    - Click the + sign next to **ORIGINAL** subfolder. This reveals the contents of the original c3d data file. The red dots are the original signals as labeled by the capture system.
-  - close the graph by clicking on the **x** in the top right-hand corner of the //data view// dialog box.
+  - Click on the marker labeled //LFT2.// with the Left Mouse Button The //Data View// dialog box will open to the **Data Values** tab. Here you can see raw data or to export to an ASCII file\\
+{{:Tutorial2_10.png}} {{:tutorial2_10(2).png}}\\
-note: the data view can only be used for one active file at a time. if you select all_files or a tag, the left mouse button click will not do anything.
+  - On the **Data Values** tab scroll down to the 24th frame. This is where the data capture system began to collect data for this segment. No data was recorded for this segment in the previous 23 frames. This is not abnormal but it is good to be aware that some markers will not have data for every frame. The reasons for this vary but in this particular case the left foot was not in view of the cameras until the 24 frame. If you see blank frame in the middle of a data set it may be an indication of an erroneous result.
+  - Open the **Data Graph** tab to view analog graphs. A Quickview can help you to locate obviously incorrect or noisy data.
+  - Open the **Signal Processing History** tab. Although this tab is currently empty, you can view the processing history of signals here. Visual3D has a command pipeline which allows the user to prepare scripts for processing data. Typically these commands create new data that is derived or interpolated from their original data. Determining the distance between 2 points would be an example of such deriving data. The **Signal Processing History** tab will tell you what events if any took place on the data.
+  - Close the graph by clicking on the **X** in the top right-hand corner of the //Data View// dialog box.
-an exception to this rule is that metric signals will be displayed for more than one active file.
+NOTE: The Data View can only be used for one Active file at a time. If you select ALL_FILES or a TAG, the Left Mouse Button click will not do anything.
-==== displaying a signal graph ====
+An exception to this rule is that Metric signals will be displayed for more than one active file.
-there is another way to view signal graphs which is different from signal data graphs in the data view window. these are "interactive" and offer different viewing options of the data which we will explore later. when activated, signal graphs appear on the right-side of the screen and can be used to visualize or add event labels.
+=== Displaying a Signal Graph ===
-=== to activate an interactive signal graph ===
+There is another way to view signal graphs which is different from signal data graphs in the Data View window. These are "interactive" and offer different viewing options of the data which we will explore later. When activated, signal graphs appear on the right-side of the screen and can be used to visualize or add event labels.
-  - in the data tree on the left, if it's not open already open the **target** folder.
+== To activate an interactive signal graph ==
-  - in the **original** subfolder, right-click the target //lft2.//
-  - open **graph x, y and z, and residual** and select **new graph.** a set of graphs will open on the right side of the screen.\\
-tutorial2_11.png\\
-  - place the mouse on any point of one of the graph lines and wait.\\
+  - In the data tree on the left, if it's not open already open the **TARGET** folder.
-**note:** the technique used here is called a mouse over. when you hold the mouse still long enough a yellow tool tip window will appear which displays information about that point on the graph. this corresponds to one frame of data in the motion capture.\\
+  - In the **ORIGINAL** subfolder, right-click the target //LFT2.//
-tutorial2_11a.jpg\\
+  - Open **Graph X, Y and Z, and Residual** and select **New Graph.** A set of graphs will open on the right side of the screen.\\
+{{:tutorial2_11.png}}\\
+  - Place the mouse on any point of one of the graph lines and wait.\\
+**Note:** The technique used here is called a mouse over. When you hold the mouse still long enough a yellow tool tip window will appear which displays information about that point on the graph. This corresponds to one frame of data in the motion capture.\\
+{{:tutorial2_11a.jpg}}\\
-==== control and shift keys ====
-if the **control key** is pressed when the **left mouse button** selects a signal, the 2d graphs are deleted and replaced with all components of the selected signal
+=== Control and Shift Keys ===
-if the **shift key** is pressed when the **left mouse button** selects a signal, all components of the selected signal are added to the existing graphs
-note that the functionality of **shift and control keys** is related to the **interactive graphs**, not the **quick graphs**, so this will function regardless of the number of **active files.**
-==== formatting interactive graphs ====
-dgraph1.jpg
+If the **Control Key** is pressed when the **Left Mouse Button** selects a signal, the 2D graphs are deleted and replaced with all components of the selected signal
-click on a graph to activate the interactive features. small boxes will be displayed around the graph when the graph has been selected.
+If the **Shift Key** is pressed when the **Left Mouse Button** selects a signal, all components of the selected signal are added to the existing graphs
-dgraph2.jpg
+Note that the functionality of **Shift and Control keys** is related to the **Interactive Graphs**, not the **Quick Graphs**, so this will function regardless of the number of **active files.**
-holding the lmb down and moving the cursor up and down scales the graph and moving the cursor left and right pans the graph.
+=== Formatting Interactive Graphs ===
-as the range of data is changed the scaling of the vertical axis changes to reflect the data displayed automatically.
-clicking the rmb will bring up a context menu of options for manipulating the graphs.
-dgraph3.jpg
-**note: signals are drawn for individual files or for all files. if the signal to be drawn exists in only one file of the set of opened files, and that file is not selected, the graph area for that file is left blank. because of the limit of five graphs simultaneously, it is possible that a file is selected for which no signals are drawn and the entire interactive view is left blank. attempting to add a new graph will result in an error message saying that there is no more room for an additional grant. the only solution is access the graph menu using the right mouse button and remove one or more graphs from the list.**
+{{:2DGraph1.jpg}}
+Click on a graph to activate the interactive features. Small boxes will be displayed around the graph when the graph has been selected.
+{{:2DGraph2.jpg}}
+Holding the LMB down and moving the cursor up and down scales the graph and moving the cursor left and right pans the graph.
+As the range of data is changed the scaling of the vertical axis changes to reflect the data displayed automatically.
+Clicking the RMB will bring up a context menu of options for manipulating the graphs.
+{{:2DGraph3.jpg}}
+**Note: Signals are drawn for individual files or for all files. If the signal to be drawn exists in only one file of the set of opened files, and that file is not selected, the graph area for that file is left blank. Because of the limit of five graphs simultaneously, it is possible that a file is selected for which no signals are drawn and the entire interactive view is left blank. Attempting to add a new graph will result in an error message saying that there is no more room for an additional grant. The only solution is access the graph menu using the Right Mouse Button and Remove one or more graphs from the list.**
 \\
-==== formatting and animating a signal graph ====
+=== Formatting and Animating a Signal Graph ===
-  - from the **view menu**, click on **view graph animation frame line.** this will create a line on the graph to correspond to a point in an animation. then click play in the vcr control panel to activate the animation. the vertical line on the signal graph will move along with the 3d figure.\\
+  - From the **View menu**, click on **View Graph Animation Frame Line.** This will create a line on the graph to correspond to a point in an animation. Then click PLAY in the VCR control panel to activate the animation. The vertical line on the signal graph will move along with the 3D figure.\\
-**note:** this may already be up by default.
+**Note:** This may already be up by default.
-  - to format the signal graph, right-click anywhere on the graph to open an options menu. select **format graph.**\\
+  - To format the signal graph, right-click anywhere on the graph to open an options menu. Select **Format Graph.**\\
-**note:** you can also select multiple graphs first using the ctrl key on your keyboard. any changes you make will apply to each graph you select.\\
+**Note:** You can also select multiple graphs first using the CTRL key on your keyboard. Any changes you make will apply to each graph you select.\\
-tutorial2_12.png\\
+{{:tutorial2_12.png}}\\
-  - enter your desired changes and click **apply.** not all of the options apply to the **signal and events processing** tab. below are some of the options that do apply. other options will be covered later in the **reporting** tab.
+  - Enter your desired changes and click **Apply.** Not all of the options apply to the **Signal and Events Processing** tab. Below are some of the options that do apply. Other options will be covered later in the **Reporting** tab.
-  * **show grids:** adds the number of x and or y grid lines you specify.
+  * **Show Grids:** Adds the number of X and or Y grid lines you specify.
-  * **tics:** add or subtract tic marks to the axes.
+  * **Tics:** Add or subtract tic marks to the axes.
-  * **proportional units:** makes width units equal to length units.
+  * **Proportional Units:** Makes width units equal to length units.
-  * **show points:** shows a small box for each frame on the graph.
+  * **Show Points:** Shows a small box for each frame on the graph.
-  * **show baseline:** shows a line at zero.
+  * **Show BaseLine:** Shows a line at zero.
-  * **apply to all selected:** applies the changes to multiple graphs if you have more than one selected.
+  * **Apply to All Selected:** Applies the changes to multiple graphs if you have more than one selected.
-  * **apply to primary selection only:** applies the changes to only the first graph you selected if you have multiple graphs selected.
+  * **Apply to Primary Selection Only:** Applies the changes to only the first graph you selected if you have multiple graphs selected.
-==== 2d graphs context menu ====
+=== 2D Graphs Context Menu ===
-clicking the rmb will bring up a context menu of options for manipulating the graphs:\\
+Clicking the RMB will bring up a context menu of options for manipulating the graphs:\\
-=== x-axis control ===
+== X-Axis Control ==
-allows scaling and movement along the x-axis when checked\\
+Allows scaling and movement along the X-Axis when checked\\
-=== y-axis control ===
+== Y-Axis Control ==
-allows scaling and movement along the y-axis when checked\\
+Allows scaling and movement along the Y-Axis when checked\\
-=== auto-range ===
+== Auto-Range ==
-automatically scales the y axis to the current range of frames when checked.
+Automatically scales the Y axis to the current range of frames when checked.
-=== recalculate ===
+== Recalculate ==
-=== format graph ===
+== Format Graph ==
-displays a dialog box containing options for modifying the format of the graphs\\
+Displays a dialog box containing options for modifying the format of the graphs\\
-=== select all ===
+== Select All ==
-selects all of the displayed graphs reset selected resets all selected graphs back to their original scales and ranges\\
+Selects all of the displayed graphs Reset Selected Resets all selected graphs back to their original scales and ranges\\
-=== reset all ===
+== Reset All ==
-resets all graphs back to their original scales and ranges\\
+Resets all graphs back to their original scales and ranges\\
-=== reset selected ===
+== Reset Selected ==
-reset the selected graph(s)
+Reset the selected graph(s)
-=== export ===
+== Export ==
-exports one or all graphs to a variety of formats
+Exports one or all graphs to a variety of formats
-dgraph4.jpg
+{{:2DGraph4.jpg}}
-=== copy ===
+== Copy ==
-dgraph5.jpg
+{{:2DGraph5.jpg}}
-=== remove all graphs ===
+== Remove All Graphs ==
-removes all graphs remove a graph displays a dialog box to allow removal of individual graphs\\
+Removes all graphs Remove a Graph Displays a dialog box to allow removal of individual graphs\\
-=== remove a graph ===
+== Remove A Graph ==
-a popup dialog allows the user to remove a graph.
+A popup dialog allows the user to remove a graph.
-dgraph6.jpg
+{{:2DGraph6.jpg}}
-=== save graph layout ===
+== Save Graph Layout ==
-saves the current graph layout to to a layout template\\
+Saves the current graph layout to to a layout template\\
-=== load graph layout replaces ===
+== Load Graph Layout Replaces ==
 the current graph layout with a saved graph layout\\
-==== the graph layout template ====
+=== The Graph Layout Template ===
+**Note:** as a shortcut it is possible to save the interactive graph layout to a file. For example, remove all graphs then click with the RMB in the graph view and graph layout fp1fp2rft1.grt. This will load three graphs; Force platform1, Force platform 2, and one foot trajectory target.
-**note:** as a shortcut it is possible to save the interactive graph layout to a file. for example, remove all graphs then click with the rmb in the graph view and graph layout fp1fp2rft1.grt. this will load three graphs; force platform1, force platform 2, and one foot trajectory target.
-}}}}}}}}}}}}}}}}}}}}}}}}