Wiki Documentation Site

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » third-party » vicon » Vicon Nexus Integration
visual3d:documentation:third-party:vicon:vicon_nexus

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
visual3d:documentation:third-party:vicon:vicon_nexus [2025/11/03 15:05] – wikisysopvisual3d:documentation:third-party:vicon:vicon_nexus [2025/11/05 21:11] (current) – [Step 2 - Visual3D] wikisysop
Line 20: Line 20:
 ---- ----
  
-====Step 1 a - Static Calibration==== +====Step 1a - Static Calibration Trial==== 
-**1. Static Calibration Trial** \\ +**1. Marker Placement** \\ 
-Place the desired markers on the subject and capture a static calibration trial. +  * Place the desired markers on the subject (either a custom marker set or a commonly used community-defined set).  
 +  
 +**2. Capture Static Calibration Trial** \\ 
 +  * Capture a static trial. 
  
-**2. Creating a New Subject from a Labeling Skeleton Template** \\   +**3. Creating a New Subject from a Labeling Skeleton Template** \\   
-Vicon Nexus has a file type called, Vicon Labeling Skeleton Template([[https://help.vicon.com/space/Nexus216/11606780/Create+a+new+subject+from+a+template|VST]]) to describe the relationship between segments, joints, and marker sets. Creating a VST occurs once and provides a generic human template that can be used for any subject wearing the same marker set.  +  * Load the desired Vicon Labeling Skeleton Template([[https://help.vicon.com/space/Nexus216/11606780/Create+a+new+subject+from+a+template|VST]]) (one provided by Vicon or a custom VST) 
 +  * Vicon Labeling Skeleton Template is a Vicon Nexus file type to describe the relationship between segments, joints, and marker sets. 
  
-{{:visual3d:documentation:third-party:vicon:loading_skeleton_with_arrow.png?300}} +{{:visual3d:documentation:third-party:vicon:step1a3.png?300|}} 
  
 Below are two different viewing options in Nexus that visualize the marker set and the VST. The recorded static trial shows markers in both the 3D Perspective and Subject Viewer, containing the markers, segments, and joints defined by Vicon.   Below are two different viewing options in Nexus that visualize the marker set and the VST. The recorded static trial shows markers in both the 3D Perspective and Subject Viewer, containing the markers, segments, and joints defined by Vicon.  
  
-{{:visual3d:documentation:third-party:vicon:vsk.png?850}}+{{:visual3d:documentation:third-party:vicon:step1a32.png?850|}}
  
-**3. Reconstruct the Static Calibration Trial**\\ 
-  * To reconstruct the markers, on the **Tool Bar** click the Reconstruct button.   
  
 +**4. Reconstruct the Static Calibration Trial**\\
 +  * To reconstruct the markers, on the **Tool Bar** click the Reconstruct button or run the **Reconstruct Pipeline**.   
  
-**4. Auto Initialize Labeling Pipeline** \\ + 
 +**5. Auto Initialize Labeling Pipeline** \\ 
   * Run the first step of the pipeline individually (**Auto Label Static Frame**) to assess the labeling quality and correct any incorrect labels.     * Run the first step of the pipeline individually (**Auto Label Static Frame**) to assess the labeling quality and correct any incorrect labels.  
   * Once satisfied, run the following two steps in the pipeline to scale the subject and create a Vicon Labeling Skeleton file([[https://help.vicon.com/space/Nexus216/11602491/Calibrate+a+labeling+skeleton#CalibrateStatic|VSK]]) and to automatically label the markers.     * Once satisfied, run the following two steps in the pipeline to scale the subject and create a Vicon Labeling Skeleton file([[https://help.vicon.com/space/Nexus216/11602491/Calibrate+a+labeling+skeleton#CalibrateStatic|VSK]]) and to automatically label the markers.  
  
-{{:visual3d:documentation:third-party:vicon:pipeline.png?400|}}+{{:visual3d:documentation:third-party:vicon:step1a5.png?400|}} 
  
 +**6. Export as a C3D File** \\  
 +  * From the **Tools** tab, select the appropriate export command. To integrate with Visual3D, export the static trial as a **[[visual3d:tutorials:real_time:biofeedback:c3d|C3D file]]**.
  
-**5. Export as a C3D File** \\   
-From the **Tools** tab, select the appropriate export command. To integrate with Visual3D, export the static trial as a **[[visual3d:tutorials:real_time:biofeedback:c3d|C3D file]]**. 
  
-**Tip:**   
- When exporting from Nexus, verify that all markers are labeled and no gaps exist before creating the C3D file. 
 ---- ----
-====Step 1 b - Dynamic Trial====+====Step 1b - Dynamic Trial====
 **1. Capture Dynamic Trial**\\ **1. Capture Dynamic Trial**\\
-Record the dynamic trials of interest.\\+  * Record the dynamic trials of interest.\\
 **2. Run the Reconstruct and Label Pipeline**\\ **2. Run the Reconstruct and Label Pipeline**\\
 +  * To reconstruct the markers, on the **Tool Bar** click the Reconstruct button or run the **Reconstruct Pipeline**.  
 **3. Gap Filling and Cropping**\\ **3. Gap Filling and Cropping**\\
   * When Nexus reconstructs each marker on a subject, the ideal outcome is a smooth, continuous trajectory throughout the trial. In practice, however, breaks may occur in the trajectories when certain markers cannot be reconstructed. Reference here for more information on how to do this, [[https://help.vicon.com/space/Nexus216/11613642/Fill+gaps+in+trial+data|Filling gaps in trial data.]]   * When Nexus reconstructs each marker on a subject, the ideal outcome is a smooth, continuous trajectory throughout the trial. In practice, however, breaks may occur in the trajectories when certain markers cannot be reconstructed. Reference here for more information on how to do this, [[https://help.vicon.com/space/Nexus216/11613642/Fill+gaps+in+trial+data|Filling gaps in trial data.]]
   * Crop the trial if the subject starts or ends outside the data capture volume. Reference here for more information, [[https://help.vicon.com/space/Nexus216/11611132/Crop+trials|Cropping trials.]]   * Crop the trial if the subject starts or ends outside the data capture volume. Reference here for more information, [[https://help.vicon.com/space/Nexus216/11611132/Crop+trials|Cropping trials.]]
 **4. Export as a C3D File** \\   **4. Export as a C3D File** \\  
-From the **Tools** tab, select the appropriate export command. To integrate with Visual3D, export the static trial as a **[[visual3d:tutorials:real_time:biofeedback:c3d|C3D file]]**.+  * From the **Tools** tab, select the appropriate export command. To integrate with Visual3D, export the static trial as a **[[visual3d:tutorials:real_time:biofeedback:c3d|C3D file]]**. 
 ---- ----
 ===== Step 2 - Visual3D ===== ===== Step 2 - Visual3D =====
- 
- 
 Once the static file has been properly labeled and scaled to the subject, the C3D file can be imported into Visual3D for further processing, analysis, and visualization.   Once the static file has been properly labeled and scaled to the subject, the C3D file can be imported into Visual3D for further processing, analysis, and visualization.  
- 
 ---- ----
  
Line 70: Line 73:
   * From the **Model** menu, select **Create → Hybrid Model from C3D file**.   * From the **Model** menu, select **Create → Hybrid Model from C3D file**.
   * Select *Static.c3d* and click **Open**. \\    * Select *Static.c3d* and click **Open**. \\ 
-{{:CreateStatic.jpg}}+{{:visual3d:documentation:third-party:vicon:step21.png?600|}} 
  
 **2. Build the Model** \\   **2. Build the Model** \\  
   * In the **Model** tab, build the model based on the marker set used.     * In the **Model** tab, build the model based on the marker set used.  
   * In this example, the [[visual3d:tutorials:modeling:plug-in_gait_lower_limb|Plug-In Gait Lower Limb tutorial]] was used as instruction to build the lower body model.   * In this example, the [[visual3d:tutorials:modeling:plug-in_gait_lower_limb|Plug-In Gait Lower Limb tutorial]] was used as instruction to build the lower body model.
- 
- 
  
 **3. Save Model Template (.mdh file)** \\   **3. Save Model Template (.mdh file)** \\  
   * Go to **Model → [[visual3d:documentation:pipeline:model_commands:save_model_template|Save Model Template]]** to save the model as an `.mdh` file.     * Go to **Model → [[visual3d:documentation:pipeline:model_commands:save_model_template|Save Model Template]]** to save the model as an `.mdh` file.  
  
-{{:DSX_KneeMDH_SaveMDH.png?300|}} +{{:visual3d:documentation:third-party:vicon:step23.png?300|}}
  
  
Line 94: Line 95:
 \\ \\
 \\ \\
-{{:visual3d:documentation:third-party:vicon:applytomotionfile.png?300|}}+{{:visual3d:documentation:third-party:vicon:step25.png?300|}}
  
-**6. Analysis** \\  +**6. Validate the Origin Location within a C3D File** \\  
 +Once the dynamic files have been imported, you can verify the file’s origin to ensure it was created in Vicon.\\ 
 +In the [[visual3d:documentation:visual3d_signal_types:data_tree_syntax|Datatree]], under the **Manufacturer** folder, the Company, Software, and Version Label fields are listed for the C3D file. In this example from Nexus, these details confirm that the file originated from Vicon, specifically Vicon Nexus. 
 +{{:visual3d:documentation:third-party:vicon:datatreenew.png?300|}} 
 + 
 +**7. Analysis** \\  
 Analysis can begin once the model template has been applied to the motion files.   Analysis can begin once the model template has been applied to the motion files.  
 Within the **Models** tab, or using the [[visual3d:documentation:pipeline:model_based_data_commands:compute_model_based_data|Compute Model Based Data Pipeline]], computations such as joint angles can be performed (e.g., knee joint angles).   Within the **Models** tab, or using the [[visual3d:documentation:pipeline:model_based_data_commands:compute_model_based_data|Compute Model Based Data Pipeline]], computations such as joint angles can be performed (e.g., knee joint angles).  
Line 129: Line 135:
 |LINK_MODEL_BASED]]. Seen below, the skeletal model beside the calculated right knee signal |LINK_MODEL_BASED]]. Seen below, the skeletal model beside the calculated right knee signal
  
-{{:visual3d:documentation:third-party:vicon:finishedtutorial.png|}}+{{:visual3d:documentation:third-party:vicon:borderfinal.png?850|}}
  
-By following these steps, you can efficiently transition from marker-based data collection in Vicon Nexus to biomechanical modeling and analysis in Visual3D. Ensuring accurate labeling, calibration, and export will produce reliable and reproducible results for your motion capture workflow. 
  
 +
 +By following these steps, you can efficiently transition from marker-based data collection in Vicon Nexus to biomechanical modeling and analysis in Visual3D. Ensuring accurate labeling, calibration, and export will produce reliable and reproducible results for your motion capture workflow.
 ---- ----
  
  
visual3d/documentation/third-party/vicon/vicon_nexus.1762182311.txt.gz · Last modified: by wikisysop