HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » tutorials » real_time » biofeedback » Vicon Nexus
visual3d:tutorials:real_time:biofeedback: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:tutorials:real_time:biofeedback:vicon_nexus [2025/09/22 19:19] – wikisysopvisual3d:tutorials:real_time:biofeedback:vicon_nexus [2025/09/23 18:57] (current) – [Step 5 - Create Graph] wikisysop
Line 3: Line 3:
 ==== Overview ==== ==== Overview ====
  
-Vicon Nexus streams data in real time as it processes incoming frames. Visual3D can either save these streamed frames to a C3D file or directly capture a static trial from the live stream. It's important to note that Visual3D requires Nexus to stream data — Visual3D cannot replace Nexus in this workflow.+[[https://www.vicon.com/software/nexus/|Vicon Nexus]] streams data in real time as it processes incoming frames. Visual3D can either save these streamed frames to a C3D file or directly capture a static trial from the live stream. It's important to note that Visual3D requires Nexus to stream data — Visual3D cannot replace Nexus in this workflow.
  
 Capturing a static trial in Visual3D is ideal when preparing for real-time digitizing or defining functional joints. Visual3D Professional also supports real-time biofeedback and event-triggered data capture, this allows recording automatically the last 'n' seconds of data following an unpredictable event, without needing to start a manual capture in advance. Capturing a static trial in Visual3D is ideal when preparing for real-time digitizing or defining functional joints. Visual3D Professional also supports real-time biofeedback and event-triggered data capture, this allows recording automatically the last 'n' seconds of data following an unpredictable event, without needing to start a manual capture in advance.
Line 15: Line 15:
 **Before streaming in real time, Nexus must be running and the subject calibration trial must be labeled. This allows Nexus to label markers in "Live" mode.** **Before streaming in real time, Nexus must be running and the subject calibration trial must be labeled. This allows Nexus to label markers in "Live" mode.**
  
-|1. Calibrating the capture volume Nexus using the software's standard protocol.\\ \\ 2. Create a subject either using a predefined template in Nexus or creating your own. (image on right)  |  {{:Nexus_Subject.png}}|+|1. Calibrating the capture volume Nexus using the software's standard protocol.\\ 2. Create a subject either using a predefined template in Nexus or creating your own. (image on right)  {{:Nexus_Subject.png?350}}|
  
-|3. Collect a static trial.\\ \\ 4. From data managent, load the static trial and label the marker trajectories.(image on right)  |  {{:Nexus_Marker_Labelling.png}}|+|3. Collect a static trial.\\ \\ 4. From data managent, load the static trial and label the marker trajectories.(image on right)  |  {{:Nexus_Marker_Labelling.png?650}}|
  
-|5. Run the 'Calculate Autolabel Trial Parameters' from the Pipeline menu (image on right). This allows Nexus to label markers in "Live" mode.  |  {{:Nexus_AutoLabel.png}}|+|5. Run the 'Calculate Autolabel Trial Parameters' from the Pipeline menu (image on right). This allows Nexus to label markers in "Live" mode.  |  {{:Nexus_AutoLabel.png?650}}|
  
-|6. Go back to "Live" mode, with the subject in the capture volume to test that Nexus correctly autolabels markers in real-time.\\ \\ 7. Before launching real-time streaming in Visual3D, take note of the system file currently selected. (image on right)  |  {{:Nexus_System.png}}|+|6. Go back to "Live" mode, with the subject in the capture volume to test that Nexus correctly autolabels markers in real-time.\\ \\ 7. Before launching real-time streaming in Visual3D, take note of the system file currently selected. (image on right)  |  {{:Nexus_System.png?350}}|
  
 ==== Step 2 - Apply Model Template in Visual3D ==== ==== Step 2 - Apply Model Template in Visual3D ====
Line 32: Line 32:
 OPTION 2 - You can collect a static trial in Visual3D.\\ OPTION 2 - You can collect a static trial in Visual3D.\\
 \\ \\
-**I recommend using the static trial collected in Nexus (Option 1).**\\+**Its recommended to use the static trial collected in Nexus (Option 1).**\\
 \\ \\
 **OPTION 1 -**\\ **OPTION 1 -**\\
Line 49: Line 49:
 |2. Define the name of the model:\\   |  {{:Model_Name_RT.png}}| |2. Define the name of the model:\\   |  {{:Model_Name_RT.png}}|
  
-|3. Select the correct real-time system from the drop down menu and click start streaming.\\ \\ \\ When prompted, specify your sampling frequency\\ \\ When prompted, specify the IP address as the local host, 127.0.0.1 and port as 801\\ \\ 4. While the subject is standing still, collect a static trial by either clicking **Create Snapshot (Static Trial)** to save the static trial in the workspace or **Save Static File to Disk** to save the static trial as a C3D file.\\ \\ Please note that closing the //Real Time Model Building// dialog box will stop the real time streaming and remove the markers from the 3D viewer. After closing this dialog, if the static trial does not appear in the 3D viewer, switch to the Workspace tab and back to the Models tab.\\   |  {{:Model_Snapshot_RT.png}}|+|3. Select the correct real-time system from the drop down menu and click start streaming.\\ \\ \\ When prompted, specify your sampling frequency\\ \\ When prompted, specify the IP address as the local host, 127.0.0.1 and port as 801\\ \\ 4. While the subject is standing still, collect a static trial by either clicking **Create Snapshot (Static Trial)** to save the static trial in the workspace or **Save Static File to Disk** to save the static trial as a C3D file.\\ \\ Please note that closing the //Real Time Model Building// dialog box will stop the real time streaming and remove the markers from the 3D viewer. After closing this dialog, if the static trial does not appear in the 3D viewer, switch to the Workspace tab and back to the Models tab.\\   |  {{:Model_Snapshot_RT.png?650}}|
  
 |**4.** Go to **Model -> Apply Model Template** and browse to your model template (.mdh)\\   | |**4.** Go to **Model -> Apply Model Template** and browse to your model template (.mdh)\\   |
  
 ==== Step 3 - Visual3D Real-Time Set Up ==== ==== Step 3 - Visual3D Real-Time Set Up ====
 +|1. Launch V3D (V3D main screen).|{{:V3D_main_screen.jpg?650}}|\\
  
-1. Launch V3D (V3D main screen)\\+|2. Select the Real-time capture TAB|\\
  
  
-\\ +|3. a) In the dialog box you should see your plug in %%__%%%%__%%%%__%%.dlls Click Vicon_Nexus_RT.|{{:RT_V3D_Vicon.png?650}}|\\
-{{:V3D_main_screen.jpg}}\\ +
- +
- +
-\\ +
-2. Select the Real-time capture TAB\\ +
- +
- +
-3. a) In the dialog box you should see your plug in %%__%%%%__%%%%__%%.dlls Click Vicon_Nexus_RT.\\ +
- +
- +
-\\ +
-{{:RT_V3D_Vicon.png}}\\ +
- +
- +
-\\ +
-3. b) A dialog box will appear to select your current Nexus System file. When using standard Nexus file structure, the system file should be located under: C:\ProgramData\Vicon\Nexus\Configurations\Systems\\ +
- +
- +
-{{:RT_Dialog_Vicon.png}}\\+
  
 +|3. b) A dialog box will appear to select your current Nexus System file. When using standard Nexus file structure, the system file should be located under: C:\ProgramData\Vicon\Nexus\Configurations\Systems\|{{:RT_Dialog_Vicon.png}}|\\
  
 \\ \\
Line 93: Line 76:
 After having created or loaded a model, and established connection with the system back in the Real-Time tab, it is then possible to compute any model based item through the real-time pipeline. After having created or loaded a model, and established connection with the system back in the Real-Time tab, it is then possible to compute any model based item through the real-time pipeline.
  
-<HTML><ol></HTML> +  -Open up: Model Based Data Computation under the **Real-Time Pipeline** 
-<HTML><li></HTML>Open up //Model Based Data Computation// under the **Real-Time Pipeline**<HTML></li></HTML> +  -Double click, Compute_Model_Based_Data 
-<HTML><li></HTML>Double click //Compute_Model_Based_Data//<HTML></li></HTML> +  -Click **Edit** 
-<HTML><li></HTML>Click **Edit**\\ +{{:RTPipeline_CMBD.jpg}}\\ 
-{{:RTPipeline_CMBD.jpg}}<HTML></li></HTML> +Change the corresponding: 
-<HTML><li></HTML>Change the corresponding:\\ +\\ 
 +<code>
 **Data Name:** Ankle **Data Name:** Ankle
 **Folder:** ORIGINAL **Folder:** ORIGINAL
 **Model Based Item Properties:** JOINT_ANGLE **Model Based Item Properties:** JOINT_ANGLE
 **Segment:** Right Foot **Segment:** Right Foot
-**Reference Segment:** Right Shank\\+**Reference Segment:** Right Shank 
 +</code>
  
-{{:Capture_Model_Based_Data.jpg}}<HTML></li></HTML> +{{:Capture_Model_Based_Data.jpg}}\\ 
-<HTML><li></HTML>Click **Done**<HTML></li></HTML><HTML></ol></HTML>+ 
 +Click **Done**\\
  
 ==== Step 5 - Create Graph ==== ==== Step 5 - Create Graph ====
  
-<HTML><ol></HTML> +  -Click **Add** in the **Real-Time Graphs** section, and enter the following:\\
-<HTML><li></HTML>Click **Add** in the **Real-Time Graphs** section, and enter the following:\\+
  
 **Data to:** LINK_MODEL_BASED::ORIGINAL::Ankle\\ **Data to:** LINK_MODEL_BASED::ORIGINAL::Ankle\\
  
-{{:GraphDef.jpg}}<HTML></li></HTML> +{{:GraphDef.jpg?650}}\\
-<HTML><li></HTML>Click **OK**<HTML></li></HTML><HTML></ol></HTML>+
  
-\\ 
 Your result should show a Real-Time stream that looks like the picture below Your result should show a Real-Time stream that looks like the picture below
  
-{{:Final_Graph_RT.png}}\\+{{:Final_Graph_RT.png?650}}\\
  
  
visual3d/tutorials/real_time/biofeedback/vicon_nexus.1758568783.txt.gz · Last modified: 2025/09/22 19:19 by wikisysop