inspect3d:tutorials:load_and_view_data [HAS-Motion Software Documentation]

inspect3d:tutorials:load_and_view_data

This is an old revision of the document!

Table of Contents

interact with your data
save the application workspace
navigate tutorials

cmz]] file for each subject/session from [[visual3d:overview:visual3d_overview|visual3d]]. if necessary you can use our [[inspect3d:tutorials:build_cmzs|build cmz feature]] or work through the visual3d tutorial for [[visual3d:tutorials:pipeline:generic_pipeline_to_create_cmz|building a cmz file]]. ===== data ===== this tutorial can be completed with any cmz file. one possibility is a data set from a visual3d workshop at a recent asb meeting: [[https://www.has-motion.com/download/examples/v3d_workshop.zip|v3d workshop @ asb]]. ===== load your library ===== inspect3d_loaded_library.png to start, you need to tell inspect3d where to look for your data. after opening inspect3d: - i3dloadlibrary.png click the load library button on the [[inspect3d:documentation:dialogs:toolbar|toolbar]] to open the library dialog: - click **browse** to open a dialog that allows you to select a file path - select the top level folder/root directory which contains the cmz files note: the cmz files' associated cmx files must also be present for inspect3d to be able to load the library. - click **select folder** - click **load** - once the library is loaded, you will be able to do some initial exploration here in the load library dialog: - verify which cmz files have been loaded in the 3d viewer dropdown box as well as which c3d files are associated with each cmz; - verify which file tags are present in the library; - if you have loaded [[visual3d:documentation:definitions:multisubject|multisubject data]], verify which [[visual3d:documentation:definitions:multisubject#important_terms|subject prefixes]] and [[visual3d:documentation:definitions:multisubject#important_terms|subject tags]] are present in the library; and - animate the data contained in any loaded c3d file. - close the library dialog ===== define queries and group signals ===== populated_queries.png once you have loaded the library, the group definition dialog will be activated. you now have the ability to automatically or manually define queries that will group the signals in your library. to do this: <html><ol></html> <html><li></html>click on the i3dgroups.png **query definitions** icon on the [[inspect3d:documentation:dialogs:toolbar|toolbar]]<html></li></html> <html><li></html>click on i3dgroups.png **query definitions** to define group definitions for the first time and open the [[inspect3d:documentation:dialogs:advanced_query_section|query builder dialog]]<html></li></html> <html><li></html>alternatively, if you have previously saved query definitions, you can click on i3dopengroupdef.png **load query def & compute groups** to load a [[inspect3d:documentation:files:q3d_query_file|.q3d]] file containing query definitions and then automatically calculate the groups for the loaded library.<html></li></html> <html><li></html>either manually create group definitions by <html><ol style="list-style-type: lower-alpha;"></html> <html><li></html>clicking the actionadd48x48.png green addition button to name a new group and add it<html></li></html> <html><li></html>while your new group is selected, click the actionadd48x48.png green addition button to name and define a new sub-group<html></li></html> <html><li></html>repeat these steps until you have created all of your groups<html></li></html><html></ol></html> <html></li></html> <html><li></html><html><p></html>or click **auto-populate groups**<html></p></html> <html><ol style="list-style-type: lower-alpha;"></html> <html><li></html>accept the default settings and click **create**<html></li></html><html></ol></html> <html><p></html>once you have created your query definitions:<html></p></html><html></li></html> <html><li></html>click **calculate all queries** to apply the queries you have defined to the loaded library.<html></li></html> <html><li></html>close the query builder dialog. note that if inspect3d has not finished computing all of the groups then it will ask you if you want it to continue. click **compute groups**.<html></li></html><html></ol></html> |manually create group definitions (video) | |\\ \\ \\ \\ \\ \\ load video\\ \\ local file\\ \\ local file might collect personal data.\\ \\ continue\\ \\ dismiss\\ \\ https://wiki.has-motion.com/file:inspect3dmanuallydefinegroups.mp4 | ===== visualize your data ===== {{signalsandtraces.png

now that the signals in the library have been grouped, it is now possible to visually examine them and begin exploring your data:

select a particular group in the groups widget of the queried data subwindow to determine which signals you would like to view
selecting different workspaces in the queried data subwindow's workspaces widget determines which are displayed. checking the select all workspaces box conveniently displays all of the workspaces associated with your selected group(s)
check the appropriate boxes to plot all sequences, workspace means/standard deviations, and group means/standard deviations.
click refresh plot

the options dialog allows you to modify the plot options to determine what is displayed. for example, you can choose the number and layout of plots to display, change how lines are coloured and styled, and modify axis labels among many other things.

if you have multiple plots, then a gray bounding box will appear around the active plot, identifying which plot is currently being modified.

interact with your data

you can highlight a trace by left-clicking on it. this causes the trace to become more visually prominent than non-highlighted traces and produces a tooltip that includes:

the trace's group name
the trace's workspace name
the name of the specific c3d file for that trace
the trace's frame range from that c3d file
the trace's sub-group name
the x- and y- values of the trace where you left-clicked it

a trace can be excluded from the plot by:

left-clicking on the trace to highlight it; then
right-clicking and selecting exclude > exclude trace (raw data) from the context menu.

you can confirm that the trace has been excluded in the workspaces widget: excluded traces will be marked with a red x and workspaces containing excluded traces will have their checkmark icon replaced by an x.

manually view group definitions (video)

load video

local file

local file might collect personal data.

continue

dismiss

https://wiki.has-motion.com/file:inspect3dplottingdata.mp4

save the application workspace

click i3dsaveworkspaceas.png save workspace as to save the work you've done so far. this saves the application workspace as an .i3d file, which is an xml file.

note: if you have excluded data then your cmz files are out of sync with your inspect3d workspace at this point. this means that if you re-queried the loaded library, you would need to exclude the traces again. to avoid this, click the i3dupdatecmoswithbadevents.png update cmz files icon on the toolbar to update your cmz files at any point.

navigate tutorials

previous: none

inspect3d getting started tutorials

next: tutorial 2: clean your data

}}}}}}}}}}}}}}}}}}}}

inspect3d/tutorials/load_and_view_data.1718804076.txt.gz · Last modified: 2024/06/19 13:34 by sgranger