Package gov.nih.mipav.view.renderer.J3D.model.structures

Class ModelSurfaceExtractor

java.lang.Object

WildMagic.LibImagics.Extraction.ExtractSurfaceTetra

gov.nih.mipav.view.renderer.J3D.model.structures.ModelSurfaceExtractor

All Implemented Interfaces:

java.io.Serializable

public class ModelSurfaceExtractor
extends WildMagic.LibImagics.Extraction.ExtractSurfaceTetra

A level surface extractor that is based on decomposing voxels into tetrahedra, assuming a linear interpolation on the tetrahedra, and extracting triangular level sets for those tetrahedra. The resulting level surface is a triangle mesh. A detailed discussion of the algorithm is found in Level Set Extraction

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class WildMagic.LibImagics.Extraction.ExtractSurfaceTetra

WildMagic.LibImagics.Extraction.ExtractSurfaceTetra.Triangle, WildMagic.LibImagics.Extraction.ExtractSurfaceTetra.Vertex

Field Summary

Fields

Modifier and Type	Field	Description
private TransMatrix	dicomMatrix	DOCUMENT ME!
private int[]	direction	DOCUMENT ME!
private float	m_fXDelta	DOCUMENT ME!
private float	m_fYDelta	DOCUMENT ME!
private float	m_fZDelta	DOCUMENT ME!
private float[]	startLocation	DOCUMENT ME!

Fields inherited from class WildMagic.LibImagics.Extraction.ExtractSurfaceTetra

m_aiData, m_iNextIndex, m_iXBound, m_iXYProduct, m_iXYZProduct, m_iYBound, m_iZBound, m_kCentroid, m_kE0, m_kE1, m_kGradient, m_kN, m_kTSet, m_kV0, m_kV1, m_kV2, m_kVMap

Constructor Summary

Constructors

Constructor	Description
ModelSurfaceExtractor(int iXBound, int iYBound, int iZBound, int[] aiData, float fXDelta, float fYDelta, float fZDelta, int[] direction, float[] startLocation, TransMatrix dicomMatrix)	Create a level surface extractor for a 3D image.

Method Summary

Modifier and Type	Method	Description
ModelTriangleMesh	get(float iLevel, ViewJProgressBar progressBar)	Construct a level surface from the 3D image managed by the extractor.

Methods inherited from class WildMagic.LibImagics.Extraction.ExtractSurfaceTetra

addTriangle, addVertex, ExtractContour, ExtractContour, getFunction, getGradient, processTetrahedron

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

dicomMatrix

private TransMatrix dicomMatrix

DOCUMENT ME!

direction

private int[] direction

DOCUMENT ME!

m_fXDelta

private float m_fXDelta

DOCUMENT ME!

m_fYDelta

private float m_fYDelta

DOCUMENT ME!

m_fZDelta

private float m_fZDelta

DOCUMENT ME!

startLocation

private float[] startLocation

DOCUMENT ME!

Constructor Detail

ModelSurfaceExtractor

public ModelSurfaceExtractor(int iXBound,
                             int iYBound,
                             int iZBound,
                             int[] aiData,
                             float fXDelta,
                             float fYDelta,
                             float fZDelta,
                             int[] direction,
                             float[] startLocation,
                             TransMatrix dicomMatrix)

Create a level surface extractor for a 3D image. The delta input values are important when the voxels are not cubic. For example, a typical MRI might have z-slice spacing about 5 times that of the x and y spacing. In this case, dx = 1, dy = 1, and dz = 5. The idea is that 1 is a 'voxel unit' and the z-slices are spaced by 5 voxel units.

Parameters:

iXBound - the number of columns in the 3D image

iYBound - the number of rows in the 3D image

iZBound - the number of slices in the 3D image

aiData - The image data stored in order of slice indices, each slice stored in row-major order. That is, slice z=0 is stored first, slice z=1 is stored next, and so on. In slice z=0, the y=0 row is stored first, the y=1 row is stored next, and so on.

fXDelta - the relative voxel x-size (in voxel units)

fYDelta - the relative voxel y-size (in voxel units)

fZDelta - the relative voxel z-size (in voxel units)

direction - array of direction factors == 1 or -1.

startLocation - array of startLocation

dicomMatrix - DOCUMENT ME!

Method Detail

get

public ModelTriangleMesh get(float iLevel,
                             ViewJProgressBar progressBar)

Construct a level surface from the 3D image managed by the extractor.

Parameters:

iLevel - the desired level value, in [min(image),max(image)]

progressBar - DOCUMENT ME!

Returns:

a triangle mesh that represents the level surface