Differences

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

--- visual3d:documentation:opensim:visual3d_to_opensim_demo [2024/07/17 15:22] – sgranger
+++ visual3d:documentation:opensim:visual3d_to_opensim_demo [2024/10/25 16:17] (current) – Big clean-up. wikisysop
@@ Line 1: / Line 1: @@
-====== Visual3D to OpenSim Demo ======
+===== Visual3D to OpenSim Demo =====
-[[https://www.has-motion.com/download/OpenSim/Visual3DtoOpenSim_4_0.zip|OpenSim related files that are used in these examples for download]].
+This example is for exporting a standard OpenSim "gait" model, such as gait2392_simbody.osim or gait2354_simbody.osim, from Visual3D.
-\\
+==== Downloads ====
-This example is for a standard OpenSim "gait" model (such as gait2392_simbody.osim or gait2354_simbody.osim).
-What Visual3d does is:
+Different OpenSim-related files are required depending on the version of OpenSim that you are using:
+  - [[https://www.has-motion.com/download/OpenSim/Visual3dtoOpenSim_1_9_and_earlier.zip|Visual3DtoOpenSim]] for OpenSim 1.9.1 and earlier
+  - [[https://www.has-motion.com/download/OpenSim/Visual3dtoOpenSim_2_0_to_2_2.zip|Visual3DtoOpenSim]] for OpenSim 2.0 to 2.2
+  - [[https://www.has-motion.com/download/OpenSim/Visual3dtoOpenSim_2.4.zip|Visual3DtoOpenSim]] for OpenSim 2.4.0
+  - [[https://www.has-motion.com/download/OpenSim/Visual3dtoOpenSim_3_2.zip|Visual3DtoOpenSim]] for OpenSim 3.2.0
+  - **[[https://www.has-motion.com/download/OpenSim/Visual3DtoOpenSim_4_0.zip|Visual3DtoOpenSim]] for OpenSim 4.0.0**
-Step 1) Scales the model to fit the subject. (The scaling is written to a _ScaleSet.xml file called Visual3d_ScaleSet.xml.)
+==== Overview ====
-Step 2) It then computes the center of pressure in the foot coordinate system and stores this in memory.
+Visual3D performs the following steps to export the OpenSim "gait" model:
+  - Scales the model to fit the subject. (The scaling is written to a _ScaleSet.xml file called Visual3d_ScaleSet.xml.)
+  - Computes the center of pressure in the foot coordinate system and stores this in memory.
+  - Performs its own [[visual3d:documentation:kinematics_and_kinetics:inverse_kinematics|Inverse Kinematics]] so you do not have to use the OpenSim IK.
+  - After the inverse kinematics, the center of pressure is transferred back from the foot coordinate system into lab space so the relationship between the center of pressure and the model is maintained. Visual3D should handle the center of pressure data seamlessly.
+  - Exports the model's degrees of freedom (pelvis motion and joint angles), the ground reaction forces and the center of pressure to a single *.mot file. (File name Visual3d_SIMM_input.mot).
-Step 3) Next does its own Inverse Kinematics so you do not have to use the OpenSim IK.
+With the process no trc files are needed and all the kinematics, ground reaction forces and center of pressure are contained in a single .mot file.
-Step 4) After the inverse kinematics, the center of pressure is transferred back from the foot coordinate system into lab space so the relationship between the center of pressure and the model is maintained. Visual3d should handle the center of pressure data seamlessly.
+**NOTE**: There are [[visual3d:documentation:kinematics_and_kinetics:opensim|a number of considerations]] to keep in mind when exporting Visual3D models into OpenSim.
-Step 5) Visual3d then exports the model's degrees of freedom (pelvis motion and joint angles), the ground reaction forces and the center of pressure to a single *.mot file. (File name Visual3d_SIMM_input.mot).
+==== Instruction for Exporting from Visual3D to OpenSim ====
-With the process no trc files are need and all the kinematics, ground reaction forces and center of pressure are contained in a single .mot file.
+=== Part 1 – Creating the motion file for OpenSim ===
-\\
+  - Start Visual3D and create a Visual3D hybrid model containing the following segments: right foot (RFT), right shank (RSK), right thigh (RTH), left foot (LFT), left shank (RSK), left thigh (RTH), pelvis and a trunk (RTA)
-=== Instruction for Running Visual3d to OpenSim Integration ===
-== Part 1 – Creating the motion file for OpenSim ==
-  - Start Visual3d and create a Visual3d hybrid model containing the following segments: right foot (RFT), right shank (RSK), right thigh (RTH), left foot (LFT), left shank (RSK), left thigh (RTH), pelvis and a trunk (RTA)
   - If the subject is not walking in the +Y with +Z as vertical create a v3d_lab segment as outlined in the Appenddix
-  - Go to File and select ExportExport OpenSim Motion File. Alternatively the user could export the file using ExportExport OpenSim Motion File without Cleanup. (The only difference between the two method is that if the method without Cleanup is selected then the OpenSim Inverse Kinematics remains applied to the model after export and the resulting position state variables get written to the “DERIVEDInverse Kinematics” folder of Visual3d “Signal and Events” data tree.)
+  - Go to File and select Export->Export OpenSim Motion File. Alternatively the user could export the file using Export->Export OpenSim Motion File without Cleanup. (The only difference between the two method is that if the method without Cleanup is selected then the OpenSim Inverse Kinematics remains applied to the model after export and the resulting position state variables get written to the “DERIVED Inverse Kinematics” folder of Visual3D “Signal and Events” data tree.)
   - Enter the data range and click the OK button.
-  - Visual3d now needs the required Visual3d_Scale_ScaleSet.xml file and will bring up a File Selection Dialog to help the user make sure that Visual3d will update the correct file.
+  - Visual3D now needs the required Visual3d_Scale_ScaleSet.xml file and will bring up a File Selection Dialog to help the user make sure that Visual3D will update the correct file.
-  - After selecting the ScaleSet file, Visual3d now applies the Inverse Kinematics process to the gait data. (This can take several minutes.)
+  - After selecting the ScaleSet file, Visual3D now applies the Inverse Kinematics process to the gait data. (This can take several minutes.)
-Once steps 1-6 are completed, Visual3d will have updated the Visual3d_Scale_ScaleSet.xml file and have created a Visual3d_SIMM_input.mot file which can be loaded into OpenSim.
+Once steps 1-6 are completed, Visual3D will have updated the Visual3d_Scale_ScaleSet.xml file and have created a Visual3d_SIMM_input.mot file which can be loaded into OpenSim.
-== Part 2 – Scaling and Viewing the motion file for OpenSim ==
+=== Part 2 – Scaling and viewing the motion file for OpenSim ===
   - Start OpenSim and load the file openSim model. (This will be either gait2392_simbody.osim or gait2392_simbody.osim)
@@ Line 51: / Line 53: @@
 At this point the users should be ready to run the OpenSim Residual Reduction Algorithm by loading the file: Visual3d_Setup_RRA.xml. OpenSim CMC and Forward Simulation can subsequently be run by using the files Visual3d_Setup_CMC.xml and Visual3d_Setup_Foward.xml.