Rvcg (version 0.24)

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

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