retistruct (version 0.5.12)

ReconstructedOutline: Reconstruct outline into spherical surface

Description

Reconstruct outline into spherical surface. Reconstruction proceeds in a number of stages:

Usage

ReconstructedOutline(o, n = 500, alpha = 8, x0 = 0.5, report = print,
  plot.3d = FALSE, dev.flat = NA, dev.polar = NA)

Arguments

o

AnnotatedOutline object, containing the following information:

P

outline points as N-by-2 matrix

V0

indices of the apex of each tear

VF

indices of the forward vertex of each tear

VB

indices of the backward vertex of each tear

i0

index of the landmark on the rim

phi0

latitude of rim of partial sphere

lambda0

longitude of landmark on rim

n

Number of points in triangulation.

alpha

Area scaling coefficient

x0

Area cutoff coefficient

report

Function used to report progress.

plot.3d

Whether to show 3D picture during optimisation.

dev.flat

Device to plot grid onto. Value of NA (default) means no plotting.

dev.polar

Device display projection. Value of NA (default) means no plotting.

Value

reconstructedOutline object containing the input information and the following modified and extra information:

P

New set of points in flattened object

gf

New set of forward pointers in flattened object

gb

New set of backward pointers in flattened object

phi

latitude of new points on sphere

lambda

longitude of new points on sphere

Tt

New triangulation

Details

1. The flat object is triangulated with at least n triangles. This can introduce new vertices in the rim.

2. The triangulated object is stitched.

3. The stitched object is triangulated again, but this time it is not permitted to add extra vertices to the rim.

4. The corresponding points determined by the stitching process are merged to form a new set of merged points and a new triangulation.

5. The merged points are projected roughly to a sphere.

6. The locations of the points on the sphere are moved so as to minimise the energy function.