U S E R G U I D E - O D V 3 D D o c u m e n t V e r s i o n : 1. 1 B E N E F I T S S Y S T E M R E Q U I R E M E N T S Analog data visualization Force vector representation 2D and 3D plot Data Logging Easy to use CPU: Intel Core i5 (or equivalent) RAM: 2GB Operating systems: Windows 7 Windows 8 Linux (64 bit, Tested on Ubuntu 14.04) OpenGL 1.2 or greater HDD space: 500 MB OptoForce 2016 page 1
U S E R G U I D E - O D V 3 D STARTING THE APPLICATION ( WINDOWS) STARTING THE APPLICATION ( LINUX) After installation, you can find the link of the program on your desktop You may need to start the application as administrator (right click on the icon and choose Run as Administrator ) in order to use the recording to file function After unpacking the archive, you need to go through these steps: 1. Open a new Terminal 2. Change directory where you unpacked the application 3. Start the application: sudo./odv3d 4. If you do not want to start the application with sudo all the time, you need to use the following command: sudo usermod -a -G dialout $USER Do a logout/login to apply the setting. OptoForce 2016 page 2
C o n n e c t i o n T a b M a iin F e a t u r e s Up to four sensors connection Auto recognition and connection to the available DAQs Hardware configuration such as read out speed, digital filtering can be user specified Support for sensor data recording into file Easy to use OptoForce 2016 page 3
C o n n e c t i o n T a b 1 2 3 10 11 4 5 6 7 12 8 9 13 14 1. Select the appropriate tab to see the Connection settings or Plots tab to see the data plot chart and the 3D vector representation. The About tab shows the version information of the application. 2. The number of detected DAQs are displayed. 3. In case of connected DAQ the communication can be stared by using the Open All button. By default Auto Open is enabled, thus if a DAQ is connected or removed the program will automatically open or close the communication. 4. Select the appropriate port where the OMD DAQ is connected, in the current version up to four DAQs can be simultaneously plugged in to a PC. 5. The selected DAQ connection can be Closed or Opened. 6. Individual Zero or Rezero of the OMD sensor, where each sensor signal will be set to zero, if Auto Zero is enabled (default) and a DAQ is connected for the first time one-time automatic zero will be executed. This function can also be achieved by the Zero All button. OptoForce 2016 page 4
C o n n e c t i o n T a b 7. Status of the sensor: Sensor is Ok: No error with sensor no connection: No DAQ connected to the computer Overload in X, Y, Z dir: Mechanical overload in the given direction Sensor Failure: Error of sensor Connection Failure: Error in DAQ Sensor connection No sensor is connected: No sensor connected to the DAQ SPS: (Samples Per Second) number of data transferred in every second X,Y,Z: numerical representation of the read force vectors (in counts), if an nc is displayed no DAQ is connected or the data is not valid Speed /Filter/Mode shows the current DAQ configuration (see 8.) 8. The following DAQ parameters can be specified, and changed during operation: Speed: the user specified sapling rate ( 30Hz / 100Hz [default] / 333Hz / 1000Hz ) Filter: cut-off frequency of the implemented digital low pass filter ( 15Hz [default] / 50Hz / 150Hz / no filter) Mode: cannot be used, changing of the value has no effect on the output 9. With the Send to All button the selected DAQ configuration (see 8.) is send to the connected DAQs, the status information (see 7.) will change accordingly. Note: if you have more than one DAQ connected to your PC you only can send the same configuration to all of them. 10. The sensor s data is displayed as binary values by default, in order to convert it to force the Binary To Force (BTF) checkbox must be checked, the sensor signal will be multiplied with the given constant to represent force in millinewton (mn). The appropriate BTF constant can be obtained by using dead weight calibration. 11. The version information of the connected DAQ OptoForce 2016 page 5
C o n n e c t i o n T a b 12. Set the desired file name where the sensor data will be written. The recorded file is a text file and will contain the comma separated data (CSV) generated by the up to four connected DAQ, if less DAQ is connected an na value will be displayed in the appropriate column. 13. Start/stop the data recording with the Write to File button. The file will be saved into the Logs folder in the current directory. (If the application is placed into the Program Files directory it may require administrator privilege in order to use the Write to File option. ) 14. Displays how many lines have been recorded to the file. OptoForce 2016 page 6
P l o t s T a b M a i n F e a t u r e s 3D Force vector representation with different views Real-time data visualization Multiple signal selection and display Supports up to four DAQs OptoForce page 7 2016
P l o t s T a b 1 2 3 6 7 8 9 10 4 11 5 12 13 14 1. The current mode of the sensor 2. With the Hide 2D plot settings button the Set Plot (1,2,3) (see 4) panel can be hidden. 3. Easy control over the 2D Plot settings where the following Preset options are available: CH1..CH4: If you connect more than one 1 Channel DAQ then you can select which one to be plotted. If you connect one 4 Channel DAQ then you can select which channel to be plotted. With the zoom threshold the minimum range of the Y axis can be set on each Plot. Sample number can be used to set how many data points needs to be shown in the X axis on each Plot. OptoForce page 8 2016
P l o t s T a b 4. Each data plot can be binded to any sensor (from Sensor 1 to Sensor 4) Set Plot (1,2,3) can be used to select which sensor s (see connection tab 5) data will be displayed on the appropriate Plot (1,2,3). (Multiple values can be selected.) X,Y,Z: components of the force vector (Fx,Fy,Fz) Plot(1,2,3) shows the selected data signals, where one signal can be selected to show its current Value, Min/Max and Delta (difference between the maximum and minimum value) in the range of the given sample number. 5. The selected data signal is displayed (see 4), where the horizontal axis is time (exact time depends on the sampling speed see configuration tab label 8 ), and the vertical axis represents the signal s magnitude. 6. With the Pause/Resume button the signal update on the plot tab can be paused or resumed. 7. Hide 3D plot button will hide the 3D vector representation. 8. Set the X,Y,Z axis range in the 3D Plots. 9. The view of 3D Plots can be changed to Perspective / X-Y(Top) / X-Z(Left) / Y-Z(Right). 10. In case of more sensors, here can be selected which sensor signal should be displayed in 3D. 11. The force vector can be alternatively represented as a cone, which height is proportional with the force magnitude (Fz) and its base diameter is proportional with the length of the 3D vector. 12. Fy vector component visualization. 13. Fx vector component visualization. 14. Display mode setting to select between Cone and/or Vector representation. OptoForce page 9 2016
About T a b 1 2 This tab shows the version informations of the application 1. The version and build number of the application 2. The version and build number of the API used by the application When experiencing errors or problems and you want to send us feedback about it, please provide us these two informations too! OptoForce page 10 2016
R e c o r d e d F i l e F o r m a t Recorded file format The recorded file is a simple text file and will contain the data generated by the four connected DAQ. Each connected DAQ will appear as a separate sensor in the ODV software and the appropriate saved txt file can be located in the LOGS folder. The first line of the file is always the header. From the second line the values are the following: Timestamp: The timestamp of the current line (writing time) Force vectors (X, Y, Z) The line is closed with \r\n Each value is separated with a comma (CSV), thus it makes it suitable and easy to open it even in Excel for further data processes and display. Recorded sample Line1: TimeStamp X Y Z Line2: 14:10:19.801 10 60 30 OptoForce page 11 2016