User Tools

Site Tools


other:amass:documentation:viewlin

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:amass:documentation:viewlin [2024/06/18 13:25] sgrangerother:amass:documentation:viewlin [2024/07/17 15:44] (current) – created sgranger
Line 1: Line 1:
-===== Intorduction =====+====== Viewlin ====== 
 + 
 +==== 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.
  
-{{viewlin.jpg}}+{{: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 10: 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 31: 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 44: 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 57: 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 69: 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.
  
-{{R100_resids.jpg}}+{{: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.
  
-{{250e_resids.jpg}}+{{: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.
  
-{{sd_resids.JPG}}+[[File:sd_resids.JPG|{{/images/4/46/sd_resids.JPG?808x627}}]]
  
   * ****% 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.
other/amass/documentation/viewlin.1718717110.txt.gz · Last modified: 2024/06/18 13:25 by sgranger