Learn R Programming

StereoMorph (version 1.6.7)

reconstructStereoSets: 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'.

Value

NULL

Details

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

See Also

calibrateCameras, digitizeImages