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 [2024/07/16 19:34] – created sgrangervisual3d:tutorials:real_time:biofeedback:vicon_nexus [2025/09/23 18:57] (current) – [Step 5 - Create Graph] wikisysop
Line 1: Line 1:
-====== Vicon_Nexus ======+====== Vicon Nexus ======
  
 ==== Overview ==== ==== Overview ====
  
-This tutorial shows is step-by-step guide to stream real-time data from a Nexus (Vicon) to Visual3D to take advantage of the real-time data processing and biofeedback* capabilities.+[[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.
  
-Nexus streams out the data it receives as it processes them. Visual3D can save the streamed frames out to a C3D file, or directly capture a static trial from the data streaming in.+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 data in Visual3D is desirable for capturing a static trial in preparation for real-time digitizing or functional joints. Our real-time biofeedback (part of Visual3D Professional) will also support capturing data on an event trigger, which is also a unique way of capturing the last 'n' seconds of data when an event happens which you can't predict ahead of time to start a manual capture. You would probably want to use Nexus to capture other times in order to prevent loss of data or to customize the parameter section of the C3D file being captured.+Before streaming, ensure that Nexus is running with a calibrated subject and a completed static trial. This enables marker labeling in "Live" mode.
  
-  * RT Biofeedback is available only in Visual3D Professional.+This tutorial provides a step-by-step guide to streaming real-time data from Vicon Nexus to Visual3D, allowing users to take full advantage of Visual3D’s real-time processing and biofeedback features.
  
 ==== Step 1 - Subject Calibration in Nexus ==== ==== Step 1 - Subject Calibration in Nexus ====
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 45: Line 45:
 Collect a short static trial using the following process: Collect a short static trial using the following process:
  
-|1. From the **Model** menu, select //Create (Add Static Calibration File)//, then //Hybrid Model from RealTime Streaming//.\\   |  {{Create_Model_RT.png}}|+|1. From the **Model** menu, select //Create (Add Static Calibration File)//, then //Hybrid Model from RealTime Streaming//.\\   |  {{:Create_Model_RT.png}}|
  
-|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}}\\
  
  
 Remember to save the Graph and RT Pipeline Remember to save the Graph and RT Pipeline
  
 +**It is very important that Nexus automatic labeling works properly in "Live" mode and identifies markers correctly. If the markers aren't correctly identified in Nexus, Visual3D can not process any realtime data.**
  
  
visual3d/tutorials/real_time/biofeedback/vicon_nexus.1721158474.txt.gz · Last modified: 2024/07/16 19:34 by sgranger