Differences

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

--- visual3d:tutorials:typical_processing_session [2024/06/11 13:12] – wikisysop
+++ visual3d:tutorials:typical_processing_session [2024/06/14 16:14] (current) – removed sgranger
@@ Line 1: / Line 1: @@
-This tutorial covers the basic processing steps starting from C3D files through to report generation. None of these steps will be described in detail, but we will provide links to pages with more detailed descriptions.
-As a starting point, we will assume that you have:
-  * a model template (MDH)
-  * a signal processing pipeline (V3S)
-  * a report template (RGT)
-  * a static trial (C3D)
-  * multiple movement trials (C3D)
-If you don't have these templates or pipelines, you can download the sample files or follow the links to documentation on how to create them.
-You can download sample C3D files to use with this tutorial **here**.
-=====Creating a model=====
-To create the model, make sure that Visual3D is started by selecting ** Start -> Programs -> C-Motion -> Visual3D**
-  - Load the static C3D file by going to **Model -> Create (Add Static Calibration File) -> Hybrid Model from C3D file**. **Note:** Your screen may look slightly different. {{visual3d:tutorials:hybridmodelfromC3Dfiles.png}}
-  - Select "LowerBodyStaticTrial01.c3d." Click **Open**. {{visual3d:tutorials:staticfile.png}}
-=====Applying a model template=====
-In this section, you will apply a previously constructed model template. If you don't have a **model template** (.mdh file) for this standing trial, please complete the [[Building a 6 DOF Model|Model Building Tutorial]] which describes the process for building a model and creating a template.
-If you have a model template, then:
-Visual3D will switch to Model Building mode automatically. The 3D viewer will display the average value of the marker locations from the standing file. The dialog bar to the left of the screen will contain a list of segments, which by default will contain only a segment representing the Laboratory (e.g. Motion Capture Volume).
-{{visual3d:tutorials:model.png}}
-  - **Apply the model template:**
-    - Go to Model -> Apply Model Template
-    - In the dialog, select the model template
-  - **Set the subject height/weight:**
-    - In the models tab, go to Subject Data/Metrics
-    - Double click on the value next to Mass listed under Expression
-    - Double click on the value next to Height listed under Expression
-====Using a Pipeline Command====
-Pipeline commands can be used to apply the model template and set the subject height/weight. These commands can be edited to look for specific files, or if parameters are left blank, they will prompt the user for relevant information.
-  - Apply Model Template command
-  - Set Subject Height command
-  - Set Subject Weight command
-A great example of applying a model template can be found on the following pages Pipeline Processing Example 1 and Pipeline Processing Example 2.
-=====Opening movement files=====
-This section will open/add the movement files to the model that was created in the previous sections on this page.
-If you were able to successfully load the static trial and apply the model template by following the steps above, the static trial should appear in the Workspace tab.
-{{visual3d:tutorials:modelloaded.png}}
-This means you are ready to continue onto the next step.
-. **Load the dynamic trials**
-a. File -> Open/Add...
-b. Select **Insert new files into your currently open workspace**
-c. Select "WalkingTrial_01.c3d"
-{{visual3d:tutorials:open file.png}}
-**Verify** - Verify the model file named WalkingTrial_01.c3d appears in the column labeled **Motion Files**. Visual3D displays the active file in the Motion Files column, but not directly beside the static trial file.
-{{visual3d:tutorials:movementfileloaded.png}}
-**Verify** - Click on the Signal and Event Processing Tab. The viewing area will open. At this point, the movement trial has not been associated (or mapped) to the model trial. In the viewing area, only the markers will be animated.
-**Note:** If no image appears, verify that there is a single active file in the file name box.
-To activate the animation, click on the arrowhead PLAY button at the bottom of the screen. The marker figure should walk across the screen. However, no bones will appear.
-{{visual3d:tutorials:movementfile.png}}
-====Using a Pipeline Command====
-The dynamic trials can be opened using the File_Open command.
-A great example of assigning models to motion files can be found on the following pages File Open.
-=====Assigning movement files to a model=====
-In the previous sections, the movement files were added and the model template was applied to the static standing trial. These movement files need to be associated or assigned with static standing model file. When movement files are assigned to a model, the pose (position and orientation) of each segment and landmarks in the model are computed for the motion file. To assign the movement files to a model, follow these steps:
-. **Assign model to motion trial**
-a. Model -> Assign Model to Motion Files
-b. Select the checkbox next to WalkingTrial_01.c3d
-c. Click OK
-{{visual3d:tutorials:assignmodel.png}}
-**Verify** - The 3D Animation Viewer should now display a skeleton of the lower body that has been associated with your movement data. You can animate the skeleton by clicking the PLAY button in the VCR controls at the bottom of your screen.
-====Pipeline command for assigning a model====
-The model can be assigned to the movement trials using the Assign_Model_File command.
-A great example of assigning models to motion files can be found on the following page Assign_Model_File.
-=====Basic Signal Processing=====
-Signal Processing is accomplished typically through pipeline commands. For more detail, a tutorial describing Signal Processing is available.
-This section assumes that you have worked through the previous sections on this page. The following are steps for Interpolating and Filtering the TARGET data.
-**Make sure you are in the Signals and Events tab for the Processing section**
-. Interpolate TARGET signals:
-a. Signals and Events tab
-b. Expand the TARGET folder
-c. Right click on the ORIGINAL folder
-d. Click Processing >
-e. Click Interpolate
-f. Click Done
-See Signal Processing for an explanation of the default command parameters.
-Note that a **PROCESSED** folder has appeared under the **TARGET** folder in the data tree.
-{{visual3d:tutorials:interpolate.png}}
-. Filter TARGET signals:
-a. Expand the TARGET folder
-b. Right click on the PROCESSED folder
-c. Click Processing >
-d. Click Filter
-e. Click Done
-See Processing for an explanation of the default command parameters.
-Note that only a **PROCESSED** folder exists under the **TARGET** folder in the data tree (e.g. a new PROCESSED folder wasn't created). By default Visual3D uses only one PROCESSED folder, which contains the most recent processing done to a signal.
-{{visual3d:tutorials:lowpass.png}}
-. Review Processing History:
-a. Expand the TARGET folder
-d. Expand the PROCESSED folder
-c. Left click on signal "LAS"
-d. In the Data View Dialog, select Signal Processing History tab
-{{visual3d:tutorials:signalproccessinghistory.png}}
-====Pipeline commands for Basic Signal Processing====
-Signals can be interpolated and filtered using the Interpolate and Lowpass_Filter commands.
-Refer to Tutorial:_Command_Pipeline#Pipeline_SIGNAL_PROCESSING for an example.
-=====Check Force Assignments=====
-. Go to Force -> view/edit Segment to Force assignments
-{{visual3d:tutorials:forceassignmentsmenu.png}}
-. Review the segments assigned to each force vector. Edit if necessary. **Note:** Make sure only one file is active to view the assignments.
-{{visual3d:tutorials:forceassignments.png}}
-=====Creating Event Labels=====
-An Event is simply an occurrence of interest that correlates to a motion capture frame, i.e. to a particular time point within a movement. The key events for gait studies (e.g., heel strike, toe-off) are now so well standardized that Visual3D can detect and mark them automatically . For other applications, you can define your own events, either manually (using the mouse to double-click on significant points on any graph) or computationally. After you have worked through the steps in this section, refer to Tutorial:_Event_Processing for more information about creating event labels. In addition, go to Event Labels for more examples.
-====Entering an Event manually====
-Events can be added to the data file manually by selecting a frame in a graph in **SIGNAL AND EVENT PROCESSING** mode. Follow these steps:
-. Plot the signal as an Interactive Graph:
-a. In the Signal and Events tab
-b. Expand the TARGET folder
-c. Expand the PROCESSED folder
-d. Right click on the LAS target
-e. Select "Graph X, Y and Z" >
-f. Click New Graph
-Select the graph by clicking with the Left Mouse Button on the graph. When the graph is selected you will see the handles (little rectangles) on the graph.
-When the graph is selected you can change the scale for the X and Y axes.
-You can also view a vertical line which is associated with the current frame.
-. Manually create a new Event Label
-a. Double click with the Left Mouse button at the location you want the event to be added
-b. In the dialog, specify the event label name
-Note that the name of the Event Label can be the same as an existing label in the data tree because more than one occurrence of an Event is allowed.
-The buttons << and >> allow you to move the Event forward or backward through the frames.
-After an Event has been created it can be edited using the Edit Events Dialog. The process of Editing an Event is explained elsewhere.
-====Entering an Event manually via the pipeline=====
-This example created an explicit event which can also be done using the Event_Explicit command.
-If you are processing gait, you will want to use the Automatic_Gait_Events command.
-Users can create events specific to their task (different types of motion, EMG processing, etc.) by using any combination of signal processing in conjunction with the many Event commands.