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/06/19 12:55] – sgrangervisual3d:tutorials:real_time:biofeedback:vicon_nexus [2024/07/17 15:47] (current) – created sgranger
Line 1: Line 1:
-{{{{{{{{{{{{{{{{{{{{{{{{{{{{===== overview =====+====== Vicon Nexus ======
  
-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.+==== Overview ====
  
-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.+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.
  
-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.+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.
  
-  * rt biofeedback is available only in visual3d professional.+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.
  
-===== step 1 - subject calibration in nexus =====+  * RT Biofeedback is available only in Visual3D Professional.
  
-**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.**+==== Step 1 - Subject Calibration in Nexus ====
  
-|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|+**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.**
  
-|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|+|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}}|
  
-|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|+|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}}|
  
-|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|+|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}}|
  
-===== step 2 - apply model template in visual3d =====+|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}}|
  
-**to create the segments in visual3d, you must first load a static trial into visual3d and apply a model template (.mdh).\\+==== Step 2 - Apply Model Template in Visual3D ==== 
 + 
 +**To create the segments in Visual3D, you must first 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, you can either:**\\ 
-option 1 - load the static trial you collected in nexus during step 1\\ +OPTION 1 - Load the static trial you collected in Nexus during Step 1\\ 
-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).**\\+**I recommend using the static trial collected in Nexus (Option 1).**\\
 \\ \\
-**option 1 -**\\+**OPTION 1 -**\\
 \\ \\
  
  
-|**1.** go to the **models tab** of visual3d\\ **2.** go to **model -> create (add static calibration file) -> hybrid model from c3dfile** and browse to the c3d file which was collected in nexus.\\ **3.** go to **model -> apply model template** and browse to your model template (.mdh)\\   |+|**1.** Go to the **Models tab** of Visual3D\\ **2.** Go to **Model -> Create (Add Static Calibration File) -> Hybrid Model from C3DFile** and browse to the C3D file which was collected in Nexus.\\ **3.** Go to **Model -> Apply Model Template** and browse to your model template (.mdh)\\   |
  
 \\ \\
-**option 2 -**\\+**OPTION 2 -**\\
 \\ \\
-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}}|
  
-|**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)\\+1. Launch V3D (V3D main screen)\\
  
  
 \\ \\
-v3d_main_screen.jpg\\+{{:V3D_main_screen.jpg}}\\
  
  
 \\ \\
-2. select the real-time capture tab\\+2. Select the Real-time capture TAB\\
  
  
-3. a) in the dialog box you should see your plug in %%__%%%%__%%%%__%%.dlls click vicon_nexus_rt.\\+3. a) In the dialog box you should see your plug in %%__%%%%__%%%%__%%.dlls Click Vicon_Nexus_RT.\\
  
  
 \\ \\
-rt_v3d_vicon.png\\+{{: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\\+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\\+{{:RT_Dialog_Vicon.png}}\\
  
  
 \\ \\
-streaming data from nexus is continuous. **note:** streaming status in lower left+Streaming data from Nexus is continuous. **Note:** streaming status in lower left
  
-**it is very important that nexus automatic labelling 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.**+**It is very important that Nexus automatic labelling 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.**
  
-after streaming for a long period of time, the labeling in nexus may start to fail. in nexus, clicking ctrl+r may improve the labeling.+After streaming for a long period of time, the labeling in Nexus may start to fail. In Nexus, clicking CTRL+R may improve the labeling.
  
-===== step 4 - compute model based item: rt pipeline =====+==== Step 4 - Compute model based item: RT pipeline ====
  
-**the rt pipeline is available only in visual3d professional**+**The RT Pipeline is available only in Visual3D Professional**
  
-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> +<HTML><ol></HTML> 
-<html><li></html>open up //model based data computation// under the **real-time pipeline**<html></li></html> +<HTML><li></HTML>Open up //Model Based Data Computation// under the **Real-Time Pipeline**<HTML></li></HTML> 
-<html><li></html>double click //compute_model_based_data//<html></li></html> +<HTML><li></HTML>Double click //Compute_Model_Based_Data//<HTML></li></HTML> 
-<html><li></html>click **edit**\\ +<HTML><li></HTML>Click **Edit**\\ 
-rtpipeline_cmbd.jpg<html></li></html> +{{:RTPipeline_CMBD.jpg}}<HTML></li></HTML> 
-<html><li></html>change the corresponding:\\+<HTML><li></HTML>Change the corresponding:\\
  
-**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\\
  
-capture_model_based_data.jpg<html></li></html> +{{:Capture_Model_Based_Data.jpg}}<HTML></li></HTML> 
-<html><li></html>click **done**<html></li></html><html></ol></html>+<HTML><li></HTML>Click **Done**<HTML></li></HTML><HTML></ol></HTML>
  
-===== step 5 - create graph =====+==== Step 5 - Create Graph ====
  
-<html><ol></html> +<HTML><ol></HTML> 
-<html><li></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}}<HTML></li></HTML> 
-<html><li></html>click **ok**<html></li></html><html></ol></html>+<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\\ 
  
 +Remember to save the Graph and RT Pipeline
  
-remember to save the graph and rt pipeline 
  
  
-}}}}}}}}}}}}}}}}}}}}}}}}}}}} 
visual3d/tutorials/real_time/biofeedback/vicon_nexus.1718801707.txt.gz · Last modified: 2024/06/19 12:55 by sgranger