Volume (Voxel) Segmentation

This chapter represents documentation about Volume (Voxel) Segmentation. More...

Classes
struct	MR::VolumeSegmentationParameters
	Parameters for volume segmentation. More...
class	MR::VolumeSegmenter
	Class for voxels segmentation. More...

Functions
MRVOXELS_API Expected< MR::Mesh >	MR::meshFromVoxelsMask (const VdbVolume &volume, const VoxelBitSet &mask)
	Creates mesh from voxels mask.
MRVOXELS_API Expected< MR::Mesh >	MR::segmentVolume (const VdbVolume &volume, const std::vector< std::pair< Vector3f, Vector3f > > &pairs, const VolumeSegmentationParameters &params=VolumeSegmentationParameters())
	Simple segment volume.
MRVOXELS_API Expected< std::vector< Mesh > >	MR::segmentVoxelMaskToInstances (const VdbVolume &mask, size_t minSize=100, ProgressCallback cb={})

Detailed Description

This chapter represents documentation about Volume (Voxel) Segmentation.

Function Documentation

meshFromVoxelsMask()

MRVOXELS_API Expected< MR::Mesh > MR::meshFromVoxelsMask	(	const VdbVolume &	volume,
		const VoxelBitSet &	mask )

Creates mesh from voxels mask.

Parameters

mask	in space of whole volume density inside mask is expected to be higher then outside

segmentVolume()

MRVOXELS_API Expected< MR::Mesh > MR::segmentVolume	(	const VdbVolume &	volume,
		const std::vector< std::pair< Vector3f, Vector3f > > &	pairs,
		const VolumeSegmentationParameters &	params = VolumeSegmentationParameters() )

Simple segment volume.

1. Build paths between points pairs
   
2. Mark paths as inside part seeds
   
3. Mark volume part edges as outside part seeds
   
4. Return mesh from segmented inside part

segmentVoxelMaskToInstances()

MRVOXELS_API Expected< std::vector< Mesh > > MR::segmentVoxelMaskToInstances	(	const VdbVolume &	mask,
		size_t	minSize = 100,
		ProgressCallback	cb = {} )

Given voxel mask, separate it into components using mincut algorithm

Parameters

minSize

Minimum size of a segment (in voxels)