This function reconstructs and unifies landmarks and curves from multiple stereo sets. This function is a wrapper integrating dltReconstruct
, dltMatchCurvePoints
, and unifyLandmarks
.
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)
file path to a folder containing 2D (digitized) shape files, separated by view into different folders.
file path to a folder where the 3D shape files will be saved (if it does not already exist one will be created).
file path to calibration file created by calibrateCameras
.
vector of object or specimen names to be processed by the function. If NULL
(default) all the files in shapes.2d
will be processed.
integer indicating the minimum number of common points required for unification of landmark sets.
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.
logical indicating whether to reconstruct curves.
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.
logical indicating whether function processes should be printed to the console.
logical indicating whether print.progress
should be detailed.
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.
input parameter passed to dltMatchCurvePoints
(see that function's documentation for details).
input parameter passed to dltMatchCurvePoints
(see that function's documentation for details).
input parameter passed to dltMatchCurvePoints
(see that function's documentation for details).
input parameter passed to dltMatchCurvePoints
(see that function's documentation for details).
logical indicating whether curve points should be saved as landmarks (will be added to any existing landmarks).
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'.
NULL
Please see StereoMorph tutorials for step-by-step tutorials on how to use StereoMorph for 2D or 3D shape data collection.