RT Plugin Xio

From Visual3D Wiki Documentation
Jump to: navigation, search
Language:  English  • français • italiano • português • español 

Overview

The Xio Plugin is only used in Visual3D Server™; it connects to software for x-IMUs.

Plugin Interface

XioInterface.png

PluginHelpButton.png

The "Plugin Help" button leads to this web page should you need to reference this page in the future.

XioAboutPlugin.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.

Frame Info

XioFrameInfo.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.

Missed frames The missed frames number is on the bottom left (where it is currently blank). Whenever there is a gap in frames sent by the hardware of software system a blank frame is inserted. The dropped frames count keeps a record of both the number of frames which are blank.

Hardware time The hardware time number is on the top, in the centre (where it is currently blank). This time stamp is created by the hardware being used and is how long, in milliseconds, the hardware has been running.

Server time The server time number is on the bottom, in the centre (where it is currently blank). This time stamp is created by the server and is how long, in milliseconds, it has been connected to the hardware or software which is streaming to it.

Hardware latency The hardware latency is on the top right hand side (where it is currently blank). This indicated the delay created by the hardware system.

Server latency The hardware latency is on the top right hand side (where it is currently blank). This indicates any delay introduced by the server.

Hardware

XioHardwareTab.png

Data Rate

This is the rate in Hz which the data is collected. The options are: 32, 64, 128, 256 and 512.

Fusion Algorithm

The fusion algorithm options are IMU (Inertial Measurement Unit) and AHRS (Attitude and Heading Reference System). The IMU algorithm makes use of data from gyroscopes and accelerometers. The AHRS algorithm also makes use of tri-axis magnetometer data, allowing for measurement of the devices orientation relative to the earth's magnetic field.

Beta Gain

The beta gain changes the relative usage of the accelerometer and gyroscope in the fusion algorithm. The beta gains counter should be set between 0 and 10. The number in the counter is ten times the value of the beta gain implemented. So a counter value of 1 will result in a 0.1 beta gain, a counter value of 7 will result in a beta gain of 0.7, etc..

Number of Sensors & Serial Port

The number of sensors tells Visual3DServer how many IMUs to look for. The minimum number that can be entered is 1 and the maximum is 12. The sensors can be selected in the drop down menu and assigned a Serial Port using the serial port counter. Once a serial port is assigned to a sensor it will it will appear next to the sensor number in the drop down menu. The Serial Port numbers range from 0 to 99.

Trigger Threshold

The Trigger Threshold ranges from -20 to 20. Changing the Trigger Threshold results in a voltage change on the "AX0" analog input pin of the sensor unit that will create an input spike in the data streams for later synchronization of multiple sensors.

Table

The Table at the bottom of the hardware tab provides a summary of the Sensors connected as well at their Port number and the Segments with which they are associated.

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.

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

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.























3D View

The right hand side of the screen provides a real-time 3D graphical representation of the data being streamed.

Save 3D View

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.

Copy 3D View to clipboard

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.

Reset camera 3D View

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.

3D View Preferences

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.

Scene
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.
Reset camera view on connect - When this box is selected and you connect or reconnect to hardware the camera view will reset to it's default.
Alpha-blending on - When this box is selected the graphics are slightly transparent and allow you to see what is behind them
Anti-ailiasing on - When this box is selected all the lines in the graphics are smooth. If it is not selected the lines that are not either horizontal or vertical change directions portion by portion.

Background

Color - This allows you to change the background color to anyone you chose.

Floor

When the check box next to the floor is not checked the floor 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 floor is not present.

X-size - This allows you to customize how many panels the floor is composed of in the x direction. the minimum is 1 and maximum is 100. The default size is 5.00.
Y-size - This allows you to customize how many panels the floor is composed of in the y direction. the minimum is 1 and maximum is 100. The default size is 5.00.
X-offset - This allows you to shift the entire floor along the x-axis either in the positive or negative direction. The maximum value allowed is 100 and the minimum value is -100. The default setting is 3.00.
Y-offset - This allows you to shift the entire floor along the y-axis either in the positive or negative direction. The maximum value allowed is 100 and the minimum value is -100. The default setting is 3.00.
Z-offset - This allows you to shift the entire floor along the z-axis either in the positive or negative direction. The maximum value allowed is 100 and the minimum value is -100. The default setting is -0.01.
Color - This allows you to change the floor color to anyone you chose.
Show grid - This allows you to remove the grid lines from the floor by unchecking the checkbox.
Grid line width - This allows you to change the thickness of the gridlines. The minimum value is 1 and the maximum value is 10. The default width is 2.00.
Grid color - This allows you to change the grid line color to anyone you chose.

Axes

When the check box next to the axis is not checked the axis 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 axis is not present.

Line width - This allows you to change the thickness of the axis lines. The minimum value is 1 and the maximum value is 10. The default value is 2.00.
X-Axis Color - This allows you to change the x-axis line color to anyone you chose.
Y-Axis Color - This allows you to change the y-axis line color to anyone you chose.
Z-Axis Color - This allows you to change the z-axis line color to anyone you chose.

Force Plates

When the check box next to the force plates is not checked the force plates 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 force plates are not present.

Plate Color - This allows you to change the force plate color to anyone you chose.
Show labels - This allows you to remove the force plate label, (such as FP1, FP2 . . . etc) from the 3D view.
Label Color - This allows you to change the force plate label color to anyone you chose.
Show forces - When checked the forces will be show in the 3D view using arrows.
Force Type A Color - This allows you to change the color of the raw force arrows to anyone you chose.
Force Type B Color - This allows you to change the color of the force structure arrows to anyone you chose.

Tracking Markers

When the check box next to the tracking markers is not checked the tracking 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 tracking markers are not present.

Radius - This allows you to change the radius of the markers. The maximum value is 0.100 the minimum value is 0.001. The default radius is 0.020.
Marker Color - This allows you to change the color of the marker color to anyone you chose.
Show Labels - This allows you to remove the marker labels from the 3D view.
Label Color - This allows you to change the color of the label to anyone you chose.

Segment Markers
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.

Radius - This allows you to change the radius of the markers. The maximum value is 0.100 the minimum value is 0.001. The default radius is 0.020.
Marker Color - This allows you to change the color of the marker color to anyone you chose.
Show Labels - This allows you to remove the marker labels from the 3D view.
Label Color - This allows you to change the color of the label to anyone you chose.

Segment Lines

When the check box next to the segment lines is not checked the segment lines 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 lines are not present.

Line Width - This allows you to change the thickness of the segment lines. The minimum value is 1 and the maximum value is 10. The default value is 1.00.
Color - This allows you to change the color of the segment lines to anyone you chose.

Segment Geometry

When the check box next to the segment geometry is not checked the segment geometry 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 geometry is not present.

Color - This allows you to change the color of the segment geometry to anyone you chose.

Segment Bones

When the check box next to the segment bones is not checked the segment bones 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 bones are not present.

Color - This allows you to change the color of the segment bones to anyone you chose.

Retrieved from ""