Wiki Documentation Site

User Tools

Site Tools

You are here: Main Page » visual3d » tutorials » real_time » biofeedback » Vicon Nexus Real-Time Integration
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/11/18 15:49] – wikisysopvisual3d:tutorials:real_time:biofeedback:vicon_nexus [2025/12/02 14:46] (current) – wikisysop
Line 4: Line 4:
 Visual3D streams data in real time as [[https://www.vicon.com/software/nexus/|Vicon Nexus]]  processes incoming frames. During streaming, Visual3D can either save the incoming frames to a C3D file or capture a static trial directly from the live stream. It’s important to remember that Visual3D depends on Nexus for data streaming—Visual3D cannot replace Nexus in this workflow. Visual3D streams data in real time as [[https://www.vicon.com/software/nexus/|Vicon Nexus]]  processes incoming frames. During streaming, Visual3D can either save the incoming frames to a C3D file or capture a static trial directly from the live stream. It’s important to remember that Visual3D depends on Nexus for data streaming—Visual3D cannot replace Nexus in this workflow.
  
-Capturing a static trial within Visual3D is especially useful when preparing for real-time digitizing or defining functional joints. Visual3D Professional also supports real-time biofeedback and event-triggered data capture. This allows the system to automatically record the last n seconds of data following an unexpected event, without requiring a manual capture to be initiated beforehand. +Capturing a static trial within Visual3D is especially useful when preparing for real-time digitizing or defining functional joints. Before starting the stream, in Nexus 2, make sure that a static trial is captured, and then have performed the labeling calibration to ensure auto-labelling in live mode is functional.
- +
-Before starting the stream, in Nexus 2, make sure that you have captured a static trial, and then have performed the labeling calibration to ensure that you are able to auto-label in live mode.+
  
  
Line 19: Line 17:
  
 **1. Calibrating the Capture Volume**\\ **1. Calibrating the Capture Volume**\\
-  * Calibrating the capture volume Nexus using the software's standard protocol.+  * Calibrate the capture volume based on Nexus's [[https://help.vicon.com/space/Nexus216/11606902/Calibrate+a+Vicon+system|standard protocol]].
  
-**2. Verify Session Folder**\\ +**2. Create the Session Folder**\\ 
-  * Ensure that the appropriate session folder has been selected before capturing motion capture data. +  * Ensure that the appropriate session folder has been selected before capturing motion capture data. Seen below, the grey circle in the Data Management indicates that the session folder is being used.  
-  * Ensure Live mode is on before capturing data. +{{:visual3d:tutorials:real_time:biofeedback:sessionfolder.png?500|}} 
 +  * Ensure Live Mode is enabled before capturing data. The top of the screen will indicate the status—if the system is offline, it will display ‘No Trial’ or the current trial name.  
 +{{:visual3d:tutorials:real_time:biofeedback:livemode.png?500|}} 
 +  * If unsure how to create the session folder, refer to [[ https://www.youtube.com/watch?v=rZh-R7eHwcg|Vicon's tutorial]]. 
  
 **3. Creating a New Subject from a Labeling Skeleton Template**\\ **3. Creating a New Subject from a Labeling Skeleton Template**\\
Line 31: Line 32:
 {{:visual3d:documentation:third-party:vicon:step1a3.png?300|}}  {{:visual3d:documentation:third-party:vicon:step1a3.png?300|}} 
  
-**4. Capture Static Calibration Trial** \\+**4. Capture Static Calibration Trial (Ensure Live Mode is on)** \\
   * Capture a static trial.    * Capture a static trial. 
 +  * Return to the session folder and load the static calibration trial that was just previously captured.
  
 **5. Reconstruct the Static Calibration Trial**\\ **5. Reconstruct the Static Calibration Trial**\\
-  * To reconstruct the markers, on the **Tool Bar** click the Reconstruct button or run the **Reconstruct Pipeline**.   +  * To reconstruct the markers, on the **Tool Bar** click the Reconstruct button highlighted in red on the top left of the application or run the **Reconstruct Pipeline** seen on the right. 
 +   {{:visual3d:tutorials:real_time:biofeedback:reconstruct.png?600|}}
  
 **6. Auto Initialize Labeling Pipeline** \\  **6. Auto Initialize Labeling Pipeline** \\ 
 +  * Select the **Auto Initialize Labeling Pipeline** in the dropdown under Current 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.  
Line 44: Line 48:
  
 **7. Verify Labeling in Live Mode**\\ **7. Verify Labeling in Live Mode**\\
-  * Go back to "Live" mode, with the subject in the capture volume to test that Nexus correctly autolabels markers in real-time.\\+  * Go back to "Live" mode, with the subject in the capture volume to test that Nexus correctly auto labels the markers in real-time.\\
  
 ---- ----
Line 53: Line 57:
 ---- ----
  
-To create the segments in Visual3D, you must first load a static trial into Visual3D and apply a model template (.mdh).\\+To create the segments in Visual3D, load a static trial into Visual3D and apply a model template (.mdh).\\
  
-**To load the static trial, you can either:**\\ +**To load the static trial:**\\ 
-**Option 1** - Load the static trial you collected in Nexus during Step 1\\ +**Option 1** - Load the static trial collected in Nexus during Step 1.\\ 
-**Option 2** - You can collect a static trial in Visual3D.\\+**Option 2** - Collect a static trial in Visual3D.\\
 Its recommended to use the static trial collected in Nexus (Option 1).\\ Its recommended to use the static trial collected in Nexus (Option 1).\\
  
Line 70: Line 74:
  
 **2. Apply the Model Template**\\ **2. Apply the Model Template**\\
 +  * Go to **Model -> Apply Model Template** and browse to necessary model template (.mdh)\\  
 {{:visual3d:tutorials:real_time:biofeedback:modelapply.png?250|}} {{:visual3d:tutorials:real_time:biofeedback:modelapply.png?250|}}
  
Line 81: Line 86:
  
 **2. Define the name of the model**\\ **2. Define the name of the model**\\
 +  * Define the name of the model template.
 {{:Model_Name_RT.png?400}} {{:Model_Name_RT.png?400}}
  
-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. +**3. Verify Settings**\\ 
 +  * Select the correct real-time system from the drop down menu and click start streaming.  
 +  * When prompted, specify the 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.\\  +**4. Collect Static Calibration Trial**\\ 
-{{:Model_Snapshot_RT.png?650}}+  *  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?400}}
  
-**5.** Go to **Model -> Apply Model Template** and browse to your model template (.mdh)\\  +**5. Apply the Model Template**\\ 
 +  * Go to **Model -> Apply Model Template** and browse to necessary model template (.mdh)\\  
  
 ---- ----
Line 100: Line 112:
  
 **3. Data Streaming in Nexus** \\ **3. Data Streaming in Nexus** \\
-  * In the dialog box you should see your plug in %%__%%%%__%%%%__%%.dlls Click Vicon_Nexus_RT. +  * In the dialog box the plug in will be visible %%__%%%%__%%%%__%%.dlls Click Vicon_Nexus_RT. 
-  * 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\+  * A dialog box will appear to select the current Nexus System file. When using standard Nexus file structure, the system file should be located under: C:\ProgramData\Vicon\Nexus\Configurations\Systems\
 {{:RT_V3D_Vicon.png?550}} {{:RT_V3D_Vicon.png?550}}
 {{:RT_Dialog_Vicon.png}} {{:RT_Dialog_Vicon.png}}
Line 140: Line 152:
 **Data:** LINK_MODEL_BASED::ORIGINAL::Ankle\\ **Data:** LINK_MODEL_BASED::ORIGINAL::Ankle\\
  
-{{:GraphDef.jpg?500}}\\+{{:GraphDef.jpg?400}}\\
  
-Your result should show a Real-Time stream that looks like the picture below+The result should show a Real-Time stream that looks like the picture below.
  
-{{:Final_Graph_RT.png?650}}\\+{{:Final_Graph_RT.png?400}}\\
  
  
 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.**+**Important Reminder: 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 real-time data.**
  
  
visual3d/tutorials/real_time/biofeedback/vicon_nexus.1763480973.txt.gz · Last modified: by wikisysop