HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » other » visual3dserver » plugins » RT Plugin MAC Cortex
other:visual3dserver:plugins:rt_plugin_mac_cortex

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
other:visual3dserver:plugins:rt_plugin_mac_cortex [2024/07/16 19:23] – created sgrangerother:visual3dserver:plugins:rt_plugin_mac_cortex [2024/07/17 15:44] (current) – created sgranger
Line 1: Line 1:
-====== RT_Plugin_MAC_Cortex ======+====== RT Plugin MAC Cortex ======
  
 ==== Overview ==== ==== Overview ====
Line 7: Line 7:
 ==== Plugin Interface ==== ==== Plugin Interface ====
  
-{{MacCortexInterface2.png}}+{{:MacCortexInterface2.png}}
  
 There are four sets of tabs on the left hand side of the screen. These tabs are [[#Hardware|Hardware]], [[#Signals|Signals]], [[#C3D_Params|C3D Params]], and [[#Force_Platform|Force Plates]]. Each of these tabs controls a different portion of the plugins functionality. On the right hand side of the window is a [[#3D_View|3D view screen]] which shows a graphical representation of the data the server is receiving from the MAC Cortex hardware. There are four sets of tabs on the left hand side of the screen. These tabs are [[#Hardware|Hardware]], [[#Signals|Signals]], [[#C3D_Params|C3D Params]], and [[#Force_Platform|Force Plates]]. Each of these tabs controls a different portion of the plugins functionality. On the right hand side of the window is a [[#3D_View|3D view screen]] which shows a graphical representation of the data the server is receiving from the MAC Cortex hardware.
  
-{{PluginHelpButton.png}}+{{:PluginHelpButton.png}}
  
 The "Plugin Help" button leads to this web page should you need to reference this page in the future. The "Plugin Help" button leads to this web page should you need to reference this page in the future.
  
-{{MacCortexAboutPlugin.png}}+{{:MacCortexAboutPlugin.png}}
  
 The "About Plugin" button has details on the plugin being used including version, release date, copy right, support contact information and the hardware SDK version. The "About Plugin" button has details on the plugin being used including version, release date, copy right, support contact information and the hardware SDK version.
Line 21: Line 21:
 === Frame Info === === Frame Info ===
  
-|{{MacCortexFrameInfo.png}}|+|{{:MacCortexFrameInfo.png}}|
  
 **Current frame** The current frame number on the top left hand side on the screen (where it is currently blank) keeps a count of the current frame which is assigned by the hardware or software system. **Current frame** The current frame number on the top left hand side on the screen (where it is currently blank) keeps a count of the current frame which is assigned by the hardware or software system.
Line 37: Line 37:
 === Hardware === === Hardware ===
  
-|== IP Address ==\\ \\ In order to connect with the data that is being broadcast for the server the ServerIP address must be entered into the dialogue box at the top of the plugin tab. The IP address used in the image above is 192.168.1.102. MAC Cortex™ does not allow for the "localhost" or 127.0.0.1 shortcuts to be used. You will need to use your actual IP address. See [[Other:Visual3DServer:Documentation:Visual3DServer_Troubleshooting#Finding_your_ServerIP_Address|Trouble Shooting]] for how to check your IP address.\\ \\ == Calibration File ==\\ \\ The Cal file box is for systems which use force plates. The calibration file indicates where the force platforms are located relative to the lab coordinate system. This file is required in order for force data to be included in the graphics and in the data which is streamed to Visual3D server. Consult your MAC Cortex™ documentation for instructions on how to generate a calibration file. You should generate and keep a calibration file every time that the force plates may have been moved. Files can be selected using the Browse button and can be removed using the Remove button.\\ \\ == Gen Scale ==\\ \\ The bits and volts drop down menus tell the server how to process the force data that it receives. If you insert the wrong bits or volts values your calculations and data will be erroneous. The bits and volts were determined when the force platforms were set up; see your documentation or the person responsible for the set up to get these values.|{{MacCortexHW.png}}|+|== IP Address ==\\ \\ In order to connect with the data that is being broadcast for the server the ServerIP address must be entered into the dialogue box at the top of the plugin tab. The IP address used in the image above is 192.168.1.102. MAC Cortex™ does not allow for the "localhost" or 127.0.0.1 shortcuts to be used. You will need to use your actual IP address. See [[Other:Visual3DServer:Documentation:Visual3DServer_Troubleshooting#Finding_your_ServerIP_Address|Trouble Shooting]] for how to check your IP address.\\ \\ == Calibration File ==\\ \\ The Cal file box is for systems which use force plates. The calibration file indicates where the force platforms are located relative to the lab coordinate system. This file is required in order for force data to be included in the graphics and in the data which is streamed to Visual3D server. Consult your MAC Cortex™ documentation for instructions on how to generate a calibration file. You should generate and keep a calibration file every time that the force plates may have been moved. Files can be selected using the Browse button and can be removed using the Remove button.\\ \\ == Gen Scale ==\\ \\ The bits and volts drop down menus tell the server how to process the force data that it receives. If you insert the wrong bits or volts values your calculations and data will be erroneous. The bits and volts were determined when the force platforms were set up; see your documentation or the person responsible for the set up to get these values.|{{:MacCortexHW.png}}|
  
 === Signals === === Signals ===
  
-|{{dataTable.png}}      |The table in the signals tab holds all of the numerical data from various sources which is being streamed to the program. This data may include, but is not limited to, marker co-ordinates, force data, EMG readings, accelerometer data, etc. The first column entitled "Label" has the number or name which has been assigned to the source of the data. The following four columns are all entitled "Value"; they have the numerical data associated with the source. For markers it is the x, y, and z, coordinates and then the residual. For force data there is only one value associated, which is the magnitude of the force.| +|{{:dataTable.png}}      |The table in the signals tab holds all of the numerical data from various sources which is being streamed to the program. This data may include, but is not limited to, marker co-ordinates, force data, EMG readings, accelerometer data, etc. The first column entitled "Label" has the number or name which has been assigned to the source of the data. The following four columns are all entitled "Value"; they have the numerical data associated with the source. For markers it is the x, y, and z, coordinates and then the residual. For force data there is only one value associated, which is the magnitude of the force.| 
-|{{signalsGraph.png}}|The signals graph allows you to see a graphical representation of the values in the table. Selecting one of the rows in the table will cause the graph to record the values in real time. The x axis has the frame numbers and the y axis has the numbers in the value column. If more than one column has data there will be multiple lines drawn. The graph uses the MKS system of units.                                                                                                                                                                                                                                            |+|{{:signalsGraph.png}}|The signals graph allows you to see a graphical representation of the values in the table. Selecting one of the rows in the table will cause the graph to record the values in real time. The x axis has the frame numbers and the y axis has the numbers in the value column. If more than one column has data there will be multiple lines drawn. The graph uses the MKS system of units.                                                                                                                                                                                                                                            |
  
 === C3D Params === === C3D Params ===
  
-|{{c3dParamsALLPLUGINS.png}}|When this tab is viewed in Visual3D Server it gives additional details regarding the data that is being collected by the server and streamed to a client. This allows you to check details such as force plate types and locations.\\ \\ The top table contains a list of the parameters and their subsections. By expanding the parameters and selecting one of the subsections the data from the subsection will be presented in the table at the bottom of the tab.|+|{{:c3dParamsALLPLUGINS.png}}|When this tab is viewed in Visual3D Server it gives additional details regarding the data that is being collected by the server and streamed to a client. This allows you to check details such as force plate types and locations.\\ \\ The top table contains a list of the parameters and their subsections. By expanding the parameters and selecting one of the subsections the data from the subsection will be presented in the table at the bottom of the tab.|
  
 === Force Platform === === Force Platform ===
  
-|{{ForcePlateTabALLPLUGINS50.png}}|The minimum force management box is for screening out unwanted noise from the force platforms. The default value is 20.00 N meaning that any force equal to or lower than 50.00 N will not be displayed by the system. It does not affect forces that are greater than the specified limit. The minimum force may be set at any value between 0 and 9,999.90 N.\\ \\ The baseline force measurement tool allows you to determine the average amount of noise present in your force platform system and remove it from the forces displayed by the system and sent to any client programs such as a biofeedback software. The baseline frame number is set at 10 which means that the baseline function will take a sample of 10 consecutive frames. The frame number may be set at any whole number from 1 to 9,999. When you click the "Measure Baseline" button it will take a sample of frames (as many or as little as indicated by the baseline frame number box.) The average force will be calculated for these frames. This value will subsequently be subtracted from all of the following frames. The graphics displayed and the data passed on to any client programs will be the initial value minus the calculated average. When the "Zero Baseline" button is pressed the forces will no longer have the baseline number subtracted and the forces displayed and given to any client programs will be the value taken from the force plate.\\ \\ Both force management tools may be used at the same time.\\ \\ The "Use force structure" checkbox controls the force structure, which is the amalgamation of multiple forces. If the checkbox is not selected then the force structure will not be calculated. This means that the force structure will not appear in the graphics and that the data for a force structure will not be available for any client programs.|+|{{:ForcePlateTabALLPLUGINS50.png}}|The minimum force management box is for screening out unwanted noise from the force platforms. The default value is 20.00 N meaning that any force equal to or lower than 50.00 N will not be displayed by the system. It does not affect forces that are greater than the specified limit. The minimum force may be set at any value between 0 and 9,999.90 N.\\ \\ The baseline force measurement tool allows you to determine the average amount of noise present in your force platform system and remove it from the forces displayed by the system and sent to any client programs such as a biofeedback software. The baseline frame number is set at 10 which means that the baseline function will take a sample of 10 consecutive frames. The frame number may be set at any whole number from 1 to 9,999. When you click the "Measure Baseline" button it will take a sample of frames (as many or as little as indicated by the baseline frame number box.) The average force will be calculated for these frames. This value will subsequently be subtracted from all of the following frames. The graphics displayed and the data passed on to any client programs will be the initial value minus the calculated average. When the "Zero Baseline" button is pressed the forces will no longer have the baseline number subtracted and the forces displayed and given to any client programs will be the value taken from the force plate.\\ \\ Both force management tools may be used at the same time.\\ \\ The "Use force structure" checkbox controls the force structure, which is the amalgamation of multiple forces. If the checkbox is not selected then the force structure will not be calculated. This means that the force structure will not appear in the graphics and that the data for a force structure will not be available for any client programs.|
  
 ==== 3D View ==== ==== 3D View ====
Line 61: Line 61:
 == Save 3D View == == Save 3D View ==
  
-{{Save3DView2.png}}+{{:Save3DView2.png}}
  
 This button allows you to save what is currently being displayed in the 3D view graphics area. The image can be saved in a number of standard formats, such as .bmp, .ico, .jpeg, .jpg, .pbm, .pgm, .png, .ppm, .tif, .tiff, .wbmp, .xbm, or .xpm. This function is ideal for producing graphics for papers or presentations. Saved images can be edited with 3rd party graphics programs if needed. This button allows you to save what is currently being displayed in the 3D view graphics area. The image can be saved in a number of standard formats, such as .bmp, .ico, .jpeg, .jpg, .pbm, .pgm, .png, .ppm, .tif, .tiff, .wbmp, .xbm, or .xpm. This function is ideal for producing graphics for papers or presentations. Saved images can be edited with 3rd party graphics programs if needed.
Line 67: Line 67:
 == Copy 3D View to clipboard == == Copy 3D View to clipboard ==
  
-{{Copy3DViewToClipboardSmall2.png}}+{{:Copy3DViewToClipboardSmall2.png}}
  
 This button allows you to copy what is currently being displayed in the 3D view graphics area to the clipboard. This allows you to paste the image into any program that supports copy and paste. This is useful for working with presentation or graphics editing software. This button allows you to copy what is currently being displayed in the 3D view graphics area to the clipboard. This allows you to paste the image into any program that supports copy and paste. This is useful for working with presentation or graphics editing software.
Line 73: Line 73:
 == Reset camera 3D View == == Reset camera 3D View ==
  
-{{ResetCamera3DViewColor2.png}}+{{:ResetCamera3DViewColor2.png}}
  
 This button brings the 3D viewer back to it's beginning position. You may find that having used the rotation, translation, and zooming capabilities of the 3D view you have lost track of where you are in the graphics, which can make returning to a proper view of your data challenging. The reset view button removes this frustration and reorients you. This button brings the 3D viewer back to it's beginning position. You may find that having used the rotation, translation, and zooming capabilities of the 3D view you have lost track of where you are in the graphics, which can make returning to a proper view of your data challenging. The reset view button removes this frustration and reorients you.
Line 79: Line 79:
 == 3D View Preferences == == 3D View Preferences ==
  
-{{3DViewPreferences.png}}+{{:3DViewPreferences.png}}
  
 This button allows you to change how the graphics that are presented to you. Changes happen in real time. At the bottom is the "Restore Defaults" button which resets all of the options to their standard setting. This button allows you to change how the graphics that are presented to you. Changes happen in real time. At the bottom is the "Restore Defaults" button which resets all of the options to their standard setting.
Line 85: Line 85:
 = Scene = = Scene =
  
-|{{3DViewSettings.png}}|+|{{:3DViewSettings.png}}|
  
 Lighting on - When selected graphics that are suppose to be 3 dimensional have shadows to help simulate shape. When not selected objects are one solid color.\\ Lighting on - When selected graphics that are suppose to be 3 dimensional have shadows to help simulate shape. When not selected objects are one solid color.\\
Line 147: Line 147:
 = Segment Markers = = Segment Markers =
  
-|{{ColourDialogBox.png}}|+|{{:ColourDialogBox.png}}|
  
 When the check box next to the segment markers is not checked the segment markers will not appear in the 3D View. In this case all the bellow options will be greyed out as they will have no effect if the segment markers are not present. When the check box next to the segment markers is not checked the segment markers will not appear in the 3D View. In this case all the bellow options will be greyed out as they will have no effect if the segment markers are not present.
other/visual3dserver/plugins/rt_plugin_mac_cortex.1721157796.txt.gz · Last modified: 2024/07/16 19:23 by sgranger