HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » other » AMASS » documentation » Viewlin
other:amass:documentation:viewlin

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
other:amass:documentation:viewlin [2024/06/14 17:19] – created sgrangerother:amass:documentation:viewlin [2024/07/17 15:44] (current) – created sgranger
Line 1: Line 1:
-|===== Contents =====\\ \\ \\ \\ * [[#Intorduction|1 Intorduction]]\\ * [[#Main_group_box|2 Main group box]]\\ * [[#Camera_list_box|3 Camera list box]]\\ * [[#Reference_points_box|4 Reference points box]]\\ * [[#Recommended_values|5 Recommended values]]\\ * [[#Control_buttons|6 Control buttons]]|+====== Viewlin ======
  
-===== Intorduction =====+==== Intorduction ====
  
 A report on a successful calibration may be displayed by the //**ViewLin**// utility program. It can be launched by selecting one or more .//cal// files in the AMASS shell **Input files** box and then clicking on the **ViewLin** function button. It will also be automatically started after each calibration provided the **ViewLin** box is checked in the calibration parameters. This program may also be run in stand-alone mode. A report on a successful calibration may be displayed by the //**ViewLin**// utility program. It can be launched by selecting one or more .//cal// files in the AMASS shell **Input files** box and then clicking on the **ViewLin** function button. It will also be automatically started after each calibration provided the **ViewLin** box is checked in the calibration parameters. This program may also be run in stand-alone mode.
  
-[[File:viewlin.jpg|{{/images/8/89/viewlin.jpg?879x620}}]]+{{:viewlin.jpg}}
  
 The main graphics window shows the area of a selected camera’s image that was calibrated, with the grid indicating the lens distortions present for that camera. The camera whose image is to be displayed can be selected in the list box to the right of the graphics window, or by use of **arrow** keys. The main graphics window shows the area of a selected camera’s image that was calibrated, with the grid indicating the lens distortions present for that camera. The camera whose image is to be displayed can be selected in the list box to the right of the graphics window, or by use of **arrow** keys.
Line 12: Line 12:
  
  
-===== Main group box =====+==== Main group box ====
  
   * ****File**** The first line indicates the name of the calibration file.   * ****File**** The first line indicates the name of the calibration file.
Line 33: Line 33:
  
  
-===== Camera list box =====+==== Camera list box ====
  
 This area provides some results for individual cameras, as well as letting the user select the camera whose linearity grid is to be displayed in the main graphics area. This area provides some results for individual cameras, as well as letting the user select the camera whose linearity grid is to be displayed in the main graphics area.
Line 46: Line 46:
  
  
-===== Reference points box =====+==== Reference points box ====
  
 This list box provides a report on the reference markers that were used to define the Global Coordinate System in which all marker trajectories will be expressed. This list box provides a report on the reference markers that were used to define the Global Coordinate System in which all marker trajectories will be expressed.
Line 59: Line 59:
  
  
-===== Recommended values =====+==== Recommended values ====
  
 This section offers some advice on what kind of numbers are acceptable for a good and accurate calibration. Because all distance measures are in physical units the numbers will depend upon the size of the wand and the calibration volume utilized. Here we provide values for the standard 1000mm wand used in a volume of approximately 2 x 2 x 2 meters. The //**Identify**// program now provides a utility that lets you easily view the residuals and camera usage for any segment, providing a very convenient tool for checking system performance. See example output below. This section offers some advice on what kind of numbers are acceptable for a good and accurate calibration. Because all distance measures are in physical units the numbers will depend upon the size of the wand and the calibration volume utilized. Here we provide values for the standard 1000mm wand used in a volume of approximately 2 x 2 x 2 meters. The //**Identify**// program now provides a utility that lets you easily view the residuals and camera usage for any segment, providing a very convenient tool for checking system performance. See example output below.
Line 71: Line 71:
 The first figure shows the residual plot for a marker from a VGA ( 640 x 480 resolution) camera system (Optitrack V100:R2). All calibration SD values were around 0.4 – 0.6 mm. The spikes are the result of markers being partially obscured in a camera view, or marker merges in camera views. The first figure shows the residual plot for a marker from a VGA ( 640 x 480 resolution) camera system (Optitrack V100:R2). All calibration SD values were around 0.4 – 0.6 mm. The spikes are the result of markers being partially obscured in a camera view, or marker merges in camera views.
  
-[[File:R100_resids.jpg|{{/images/b/b4/R100_resids.jpg?816x638}}]]+{{:R100_resids.jpg}}
  
 The next figure shows an equivalent plot from a 832 x 832 pixel system (Optitrack S250e cameras) which produced calibration residuals of approximately 0.2mm. The next figure shows an equivalent plot from a 832 x 832 pixel system (Optitrack S250e cameras) which produced calibration residuals of approximately 0.2mm.
  
-[[File:250e_resids.jpg|{{/images/6/66/250e_resids.jpg?816x638}}]]+{{:250e_resids.jpg}}
  
 The last plot shows results from a 5 camera 2048 x 1148 resolution system covering a considerably larger volume. In this case the SD’s were in the 0.13mm range indicating the very high accuracy that can be produced by the AMASS software. The last plot shows results from a 5 camera 2048 x 1148 resolution system covering a considerably larger volume. In this case the SD’s were in the 0.13mm range indicating the very high accuracy that can be produced by the AMASS software.
Line 83: Line 83:
   * ****% image**** It usually should not be difficult to get these values above 70%. If they are less, then either the wand has not been moved sufficiently or the camera is not placed close enough to the measurement area. Be aware of the fact that for a marker image to be used in one camera it must, as a minimum, also appear in at least one other camera. This factor tends to complicate the cause and effect of calibration discrepancies. To be safe it is best to collect more frames with extensive wand motions to ensure that the maximum possible coverage of the camera image areas is achieved.   * ****% image**** It usually should not be difficult to get these values above 70%. If they are less, then either the wand has not been moved sufficiently or the camera is not placed close enough to the measurement area. Be aware of the fact that for a marker image to be used in one camera it must, as a minimum, also appear in at least one other camera. This factor tends to complicate the cause and effect of calibration discrepancies. To be safe it is best to collect more frames with extensive wand motions to ensure that the maximum possible coverage of the camera image areas is achieved.
  
-===== Control buttons =====+==== Control buttons ====
  
   * ****Close**** Closes the //**ViewLin**// program.   * ****Close**** Closes the //**ViewLin**// program.
Line 93: Line 93:
   * ****Delete**** Deletes the currently displayed calibration file.   * ****Delete**** Deletes the currently displayed calibration file.
  
- 
-Retrieved from "" 
  
  
other/amass/documentation/viewlin.1718385591.txt.gz · Last modified: 2024/06/14 17:19 by sgranger