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

In aaronolsen/StereoMorph: Stereo Camera Calibration and Reconstruction

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

See Also

calibrateCameras, digitizeImages

aaronolsen/StereoMorph documentation built on June 2, 2022, 4:09 a.m.