Description Usage Arguments Details Value Author(s) References See Also Examples

View source: R/dltTestCalibration.R

This function uses a set of grid points, ideally other than those used in stereo camera calibration, to test calibration accuracy. Results of both distance-based and position-based accuracy tests are returned.

1 2 3 4 5 | ```
dltTestCalibration(cal.coeff, coor.2d, nx, sq.size,
reciprocal = TRUE, align.princomp = FALSE)
## S3 method for class 'dltTestCalibration'
summary(object, print.tab = '', ...)
``` |

`cal.coeff` |
a matrix of DLT calibration coefficients. The columns correspond to each camera view and the column order should match the camera view order in the fourth dimension of the |

`coor.2d` |
a four-dimensional array of grid points. The first two dimensions correspond to each matrix of grid points, the third corresponds to each grid position/orientation and the fourth corresponds to each camera view. These can be read in from file by |

`nx` |
the number of points along the first dimension (e.g. this would be the number of points in each row if points in |

`sq.size` |
the size of the grid squares in real-world units (e.g. millimeters). |

`reciprocal` |
a logical indicating whether epipolar distance should be calculated reciprocally and then averaged. |

`align.princomp` |
a logical indicating whether checkerboard corners should be aligned along principal coordinate axes prior to error testing (serves to describe error along axes that may be more physically meaningful than the initial, arbitrary coordinate system). |

`object` |
a list of class |

`print.tab` |
Tabs preceding lines printed to console. |

`...` |
further arguments passed to or from other methods. |

Although the RMS errors reported by `dltCalibrateCameras`

can be used to assess the accuracy of a stereo camera setup, these represent how well the DLT parameters fit the calibration point set and not the reconstruction accuracy per se. It has been argued that in order to obtain a true estimation of reconstruction accuracy, an independent assessment criterion is required (Challis & Kerwin 1992). With the StereoMorph package, this is best accomplished by photographing a grid not used in the calibration and of a different square size (to test for proper scaling). These images are taken and the internal corners extracted just as in the calibration step (see `dltCalibrateCameras`

), again ensuring that the test images fully sample the calibration volume and that the extracted point orders correspond between the two views. The input format of `coor.2d`

to `dltTestCalibration()`

is the same format as the `coor.2d`

input to `dltCalibrateCameras`

.

`dltTestCalibration()`

measures the calibration accuracy using two approaches: a distance-based approach and a position-based approach. For the distance-based approach (e.g. Tashman & Anderst 2003; Brainerd et al. 2010), random pairs of grid points are chosen (without resampling), reconstructed and the distance between the reconstructed points is compared with the actual distance. The deviations from the true distance (interpoint distance error or IPD error) for each pair of points are returned in the `ipd.error`

vector. `dltTestCalibration()`

also measures IPD error of only adjacent points, returned in the vector `adj.pair.ipd.error`

. With a sufficient number of grid points, adjacent points are close enough that one can test how IPD error varies as a function of the distance from the approximate center of the calibrated volume (`adj.pair.centroid.dist`

) or along a particular dimension (`adj.pair.mean.pos`

).

One challenge in interpreting the IPD error, however, is that each deviation represents error in the x, y and z position of two points. This makes it difficult to assess the accuracy of a particular point or along a particular dimension. Since we do not know the 3D coordinates of a test grid placed at an arbitrary orientation in the calibration volume, we must find the best fit 3D position in order to assess positional accuracy. For the position-based approach, `dltTestCalibration()`

takes an ideal grid of the same square size and dimensions and optimally aligns it with the reconstructed test points using `findOptimalPointAlignment`

. The reconstructed test points can then be compared with their corresponding reference points. These errors are returned in the matrix `aitr.error`

(aligned ideal to reconstructed point position). This approach has the disadvantage that best fit alignment will tend to align the reference grid where the error is highest so as to minimize differences. This can decrease error where it is in actuality relatively high and vice versa.

a list of class `"dltTestCalibration"`

with the following elements:

`num.grids` |
the number of test calibration grids used in accuracy assessment. |

`epipolar.error` |
the epipolar error (distance) for every test calibration point. This is the reciprocal epipolar distance if |

`epipolar.rmse` |
the root-mean-square error of |

`ipd.error` |
a vector of the deviations from the true distance between random pairs of points (without resampling). |

`pair.dist` |
a vector of the true distances between the random pairs of points in |

`ipd.rmse` |
the root-mean-square error of |

`adj.pair.ipd.error` |
a vector of the deviations from the true distance between random pairs of adjacent points (without resampling). |

`adj.pair.mean.pos` |
a three-column matrix of the mean position (midpoint) of the adjacent pairs of points in |

`adj.pair.centroid.dist` |
a vector of the distances from each point in |

`aitr.error` |
a three-column matrix of the x, y and z position errors for the reconstructed test calibration points relative to optimally aligned ideal grid points. |

`aitr.dist.error` |
a vector of the distances between the reconstructed test calibration points and the optimally aligned ideal grid points. Note that ideally this distance should be zero so all values in this vector are positive. |

`aitr.dist.rmse` |
the RMS error (or deviation) of |

`aitr.rmse` |
a vector of the RMS error (or deviation) of |

`aitr.pos` |
a three-column matrix of the ideal grid points after best fit alignment to the reconstructed grid points. |

`aitr.centroid.dist` |
a vector of the distances between each AITR point and the centroid of all AITR points. |

Aaron Olsen

Challis, J.H. and Kerwin, D.G. (1992). Accuracy assessment and control point configuration when using the DLT for photogrammetry. *Journal of Biomechanics*, **25** (9), 1053–1058.

Tashman, S. and Anderst, W. (2003). *In Vivo* Measurement of Dynamic Joint Motion Using High Speed Biplane Radiography and CT: Application to Canine ACL Deficiency. *Transactions of the ASME*, **125**, 238–245.

Brainerd, E.L., Baier, D.B., Gatesy, S.M., Hedrick, T.L., Metzger, K.A., Gilbert, S.L and Crisco, J.J. (2010). X-ray reconstruction of moving morphology (XROMM): Precision, accuracy and applications in comparative biomechanics research. *Journal of Experimental Zoology*, **313A**, 262–279.

For a general overview of DLT: http://kwon3d.com/theory/dlt/dlt.html

`dltCalibrateCameras`

,
`dltCoefficients`

,
`readCheckerboardsToArray`

,
`dltEpipolarDistance`

,
`findCheckerboardCorners`

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 | ```
## SET NUMBER OF INTERNAL ROWS AND COLUMNS
nx <- 21
ny <- 14
## GET THE FILE DIRECTORY FOR EXTRA R PACKAGE FILES
fdir <- paste0(path.package("StereoMorph"), "/extdata/")
## SET FILE PATH TO CHECKERBOARD CORNERS FROM TEST CALIBRATION IMAGE SET
file <- matrix(c(paste0(fdir, "test_cal_a", 1:11, "_v1.txt"),
paste0(fdir, "test_cal_a", 1:11, "_v2.txt")), ncol=2)
## READ IN CHECKERBOARD CORNERS
coor.2d <- readCheckerboardsToArray(file=file, nx=nx, ny=ny, col.reverse=FALSE)
## SET GRID SIZE OF TEST CHECKERBOARDS (IN MM)
sq.size <- 4.2218
## LOAD CALIBRATION COEFFICIENTS
cal.coeff <- as.matrix(read.table(file=paste0(fdir, "cal_coeffs.txt")))
## TEST CALIBRATION ACCURACY
## USE ONLY A SUBSET (FIVE) OF TEST CALIBRATION IMAGES
## IN THE TUTORIAL POINTS, UNITS NOT IN PIXELS ARE MILLIMETERS
dlt_test <- dltTestCalibration(cal.coeff=cal.coeff, coor.2d=coor.2d[, , 1:5, ], nx=nx,
sq.size=sq.size)
## RUN TEST ON ALL TEST CALIBRATION IMAGES
## Not run:
dlt_test <- dltTestCalibration(cal.coeff=cal.coeff, coor.2d=coor.2d, nx=nx,
sq.size=sq.size)
## End(Not run)
## PRINT SUMMARY
summary(dlt_test)
## PLOT A HISTOGRAM OF THE INTERPOINT DISTANCE ERROR
hist(dlt_test$ipd.error)
## PLOT ADJACENT POINT DISTANCE ERROR AS A FUNCTION OF POSITION ALONG THE Y-AXIS
dev.new()
plot(dlt_test$adj.pair.ipd.error, abs(dlt_test$adj.pair.mean.pos[, 2, ]))
## PLOT POSITION-BASED ERROR AS A FUNCTION OF POSITION ALONG THE X-AXIS
dev.new()
plot(dlt_test$aitr.pos[, 1, ], abs(dlt_test$aitr.error[, 1, ]))
``` |

```
dltTestCalibration Summary
Number of aspects: 11
Number of views: 2
Square size: 4.2218
Number of points per aspect: 294
Aligned ideal to reconstructed (AITR) point position errors:
AITR RMS Errors (X, Y, Z): 0.01904878 , 0.01572781 , 0.01902457
Mean AITR Distance Error: 0.029093
AITR Distance RMS Error: 0.03155632
Inter-point distance (IPD) errors:
IPD RMS Error: 0.02624494
IPD Mean Absolute Error: 0.0211525
Mean IPD error: -0.007189577
Adjacent-pair distance errors:
Mean adjacent-pair distance error: 0.0003479705
Mean adjacent-pair absolute distance error: 0.01470141
SD of adjacent-pair distance error: 0.01708464
Epipolar errors:
Epipolar Mean RMS Error: 1.653774 px
Epipolar Mean Error: 1.653774 px
Epipolar Max Error: 2.886627 px
SD of Epipolar Error: 0.3609428 px
95% of epipolar errors are less than: 2.213753 px
Reconstruction errors:
Mean RMS Reconstruction Error: 1.208265 px
Max RMS Reconstruction Error: 2.07599 px
95% of reconstruction errors are less than: 1.637496 px
dev.new(): using pdf(file="Rplots1.pdf")
```

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.