vcgSample: Subsamples points on a mesh surface

Description

Subsamples surface of a triangular mesh and returns a set of points located on that mesh

Usage

vcgSample(
  mesh,
  SampleNum = 100,
  type = c("km", "pd", "mc"),
  MCsamp = 20,
  geodes = TRUE,
  strict = FALSE,
  iter.max = 100,
  threads = 0
)

Value

sampled points

Arguments

mesh: triangular mesh of class 'mesh3d'
SampleNum: integer: number of sampled points (see details below)
type: character: seclect sampling type ("mc"=MonteCarlo Sampling, "pd"=PoissonDisk Sampling,"km"=kmean clustering)
MCsamp: integer: MonteCarlo sample iterations used in PoissonDisk sampling.
geodes: logical: maximise geodesic distance between sample points (only for Poisson Disk sampling)
strict: logical: if type="pd" and the amount of coordinates exceeds SampleNum, the resulting coordinates will be subsampled again by kmean clustering to reach the requested number.
iter.max: integer: maximum iterations to use in k-means clustering.
threads: integer number of threads to use for k-means clustering

Details

Poisson disk subsampling will not generate the exact amount of coordinates specified in SampleNum, depending on MCsamp the result will contain more or less coordinates.

Examples

Run this code


data(humface)
ss <- vcgSample(humface,SampleNum = 500, type="km",threads=1)
if (FALSE) {
require(rgl)
points3d(ss)
}