mesh_area: Computes mesh surface area

In cornelmpop/Lithics3D: A toolbox for 3D analysis of archaeological lithics

Computes mesh surface area

Description

Calculates the surface area of an arbitrary triangular mesh by adding up the areas of individual constituent triangles. Please ensure that the mesh is clean (e.g. no non-manifold vertices, etc)

Usage

mesh_area(mesh, par_exec = FALSE, max_cores = NA)

Arguments

mesh	a clean mesh3d object for which area will be computed
par_exec	boolean indicating whether par_exec processing is to be used. Set to FALSE by default
max_cores	maximum number of cores to use if parallel processing is requested. Requesting more cores than are physically available will simply result in all cores being used.

Value

Numeric value of the computed area or NA in case of bad input.

Note

For small meshes it may be faster to use a single thread due to the overhead associated with starting the processing cluster.

Examples

data(demoSurface)
# Non-parallel execution:
mesh_area(demoSurface)
# Parallel execution with a maximum of 2 cores.
mesh_area(demoSurface, par_exec = TRUE, max_cores = 2)

cornelmpop/Lithics3D documentation built on Feb. 10, 2024, 11:54 p.m.