R: 3D reconstruction of landmark and curves from stereo...

reconstructStereoSets {StereoMorph}

R Documentation

3D reconstruction of landmark and curves from stereo coordinates

Description

This function reconstructs and unifies landmarks and curves from multiple stereo sets. This function is a wrapper integrating dltReconstruct, dltMatchCurvePoints, and unifyLandmarks.

Usage

reconstructStereoSets(shapes.2d, shapes.3d, cal.file, set.names = NULL, 
     min.common = 3, unify = TRUE, reconstruct.curves = TRUE, 
     even.spacing = NULL, print.progress = TRUE, verbose = FALSE, 
     update.only = FALSE, min.direct.tangency = 25, min.fill.tangency = 10, 
     epi.err.weight = 0, rec.err.weight = 1, curves.as.landmarks = FALSE, 
     curve.name.width = 5)

Arguments

`shapes.2d`	file path to a folder containing 2D (digitized) shape files, separated by view into different folders.
`shapes.3d`	file path to a folder where the 3D shape files will be saved (if it does not already exist one will be created).
`cal.file`	file path to calibration file created by `calibrateCameras`.
`set.names`	vector of object or specimen names to be processed by the function. If `NULL` (default) all the files in `shapes.2d` will be processed.
`min.common`	integer indicating the minimum number of common points required for unification of landmark sets.
`unify`	logical indicating whether to unify different aspects of the same object or specimen. If sets are to be unified, the filenames should end in '_a#' (e.g. '_a1', '_a2', etc.) to indicate different aspects of the same object.
`reconstruct.curves`	logical indicating whether to reconstruct curves.
`even.spacing`	specifies the number of evenly spaced points to be on each curve. This can be an integer (if the number of points for all curve(s) is the same), a list (in which the names of the list elements correspond to the curve names), or a .txt file containing a two column matrix of curve names and the number of points on each curve, separated by tabs and without quotes.
`print.progress`	logical indicating whether function processes should be printed to the console.
`verbose`	logical indicating whether `print.progress` should be detailed.
`update.only`	logical indicating whether function should only reconstruct sets for which the 2D data has been modified. If `TRUE` the function will not process all files in `shapes.2d`, only those which have been modified since the last function call.
`min.direct.tangency`	input parameter passed to `dltMatchCurvePoints` (see that function's documentation for details).
`min.fill.tangency`	input parameter passed to `dltMatchCurvePoints` (see that function's documentation for details).
`epi.err.weight`	input parameter passed to `dltMatchCurvePoints` (see that function's documentation for details).
`rec.err.weight`	input parameter passed to `dltMatchCurvePoints` (see that function's documentation for details).
`curves.as.landmarks`	logical indicating whether curve points should be saved as landmarks (will be added to any existing landmarks).
`curve.name.width`	integer indicating the width of numbers added to the curve name in generating curve-to-landmark names. If `curves.as.landmarks` is `TRUE`, curve landmarks will be created by adding numbers to the end of the curve name. For example, a `curve.name.width` value of 5 would be 'curve_name00001'.

Details

Please see StereoMorph tutorials for step-by-step tutorials on how to use StereoMorph for 2D or 3D shape data collection.

Value

NULL

Author(s)

Aaron Olsen