Package com.openinventor.meshvizxlm.extractors.streamline

Class MiStreamlineExtractUnstructured

java.lang.Object

com.openinventor.meshvizxlm.extractors.streamline.MiStreamlineExtractUnstructured

All Implemented Interfaces:

MiBaseExtractor, MiStreamlineExtractBase

public abstract class MiStreamlineExtractUnstructured
extends java.lang.Object
implements MiStreamlineExtractBase

Streamline extractor for unstructured meshes.

Builds a list of MiLineMeshCurvilinear interfaces containing streamlines starting from a list of source points and probes the input mesh to compute the values at the streamline nodes (See MiPointProbeUnstructured for settings).
A streamline is a line that is everywhere tangent to a vector field. Streamlines are meaningless for unsteady flow, because time is not taken into account during the computation of the line. Streamlines are integrated from a given set of vectors using a Runge/Kutta method of order 2.

Method Summary

Modifier and Type	Method	Description
abstract java.util.List<MeXScalardSetI>	extractScalarSet(MiScalardSetI inputSet)	Extracts from the mesh a list of scalar sets. The scalars are mapped onto the current extracted streamlines.
abstract java.util.List<MeXLineMeshCurvilinear<MeXTopologyI,MeXGeometryI>>	extractStreamlines(MiVec3dSetI inputDataSet, MiCellFilterI cellFilter, double[]... startPoints)	Builds the topology and geometry of the streamlines starting at the given points in the given dataset.
abstract java.util.List<MeXVec3dSetI>	extractVec3Set(MiVec3dSetI inputSet)	Extracts from the mesh a list of vector sets. The vectors are mapped onto the current extracted streamlines.
abstract java.util.List<MeXLineMeshCurvilinear<MeXTopologyI,MeXGeometryI>>	getExtract()	Returns the result of the extraction as a mesh.
static <C extends MiSurfaceCell,T extends MiSurfaceTopologyExplicitI<C>,G extends MiGeometryI> MiStreamlineExtractUnstructured	getNewInstance(MiSurfaceMeshUnstructured<C,T,G> mesh)	Create an instance of a streamlines extractor for unstructured surface mesh.
static <C extends MiVolumeCell,T extends MiVolumeTopologyExplicitI<C>,G extends MiGeometryI> MiStreamlineExtractUnstructured	getNewInstance(MiVolumeMeshUnstructured<C,T,G> mesh)	Create an instance of a streamlines extractor for unstructured volume mesh.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.openinventor.meshvizxlm.extractors.MiBaseExtractor

setExtractorCallback

Methods inherited from interface com.openinventor.meshvizxlm.extractors.streamline.MiStreamlineExtractBase

setIntegrationDirection, setIntegrationMaxStepNumber, setIntegrationStepLengthFactor, setMaxLength, setMaxLifeTime, setMinSpeed

Method Detail

getNewInstance

public static <C extends MiVolumeCell,T extends MiVolumeTopologyExplicitI<C>,G extends MiGeometryI> MiStreamlineExtractUnstructured getNewInstance(MiVolumeMeshUnstructured<C,T,G> mesh)

Create an instance of a streamlines extractor for unstructured volume mesh.

Parameters:

mesh - the input mesh

Returns:

a streamlines extractor for unstructured volume mesh

getNewInstance

public static <C extends MiSurfaceCell,T extends MiSurfaceTopologyExplicitI<C>,G extends MiGeometryI> MiStreamlineExtractUnstructured getNewInstance(MiSurfaceMeshUnstructured<C,T,G> mesh)

Create an instance of a streamlines extractor for unstructured surface mesh.

Parameters:

mesh - the input mesh

Returns:

a streamlines extractor for unstructured surface mesh

extractStreamlines

public abstract java.util.List<MeXLineMeshCurvilinear<MeXTopologyI,MeXGeometryI>> extractStreamlines(MiVec3dSetI inputDataSet,
                                                                                                           MiCellFilterI cellFilter,
                                                                                                           double[]... startPoints)

Builds the topology and geometry of the streamlines starting at the given points in the given dataset. The resulting streamlines can be retrieved by calling getExtract().

Parameters:

inputDataSet - defines the vector field for the streamlines integration

cellFilter - the cell filter

startPoints - defines the list of start points {x,y,z} for the streamlines integration

Returns:

the extracted streamlines as curvilinear line meshes

extractScalarSet

public abstract java.util.List<MeXScalardSetI> extractScalarSet(MiScalardSetI inputSet)

Extracts from the mesh a list of scalar sets.
The scalars are mapped onto the current extracted streamlines. If the dataset is binded PER_NODE the scalars are interpolated and one scalar is binded per node of the extracted streamlines. Otherwise one scalar is binded per edge of the extracted streamlines.

Parameters:

inputSet - the input scalar set defined on the original volume mesh

Returns:

the output scalar sets defined on the resulting edge meshes

extractVec3Set

public abstract java.util.List<MeXVec3dSetI> extractVec3Set(MiVec3dSetI inputSet)

Extracts from the mesh a list of vector sets.
The vectors are mapped onto the current extracted streamlines. If the dataset is binded PER_NODE the vectors are interpolated and one vector is binded per node of the extracted streamlines. Otherwise one vector is binded per edge of the extracted streamlines.

Parameters:

inputSet - the input vector set defined on the original volume mesh

Returns:

the output vector sets defined on the resulting edge meshes

getExtract

public abstract java.util.List<MeXLineMeshCurvilinear<MeXTopologyI,MeXGeometryI>> getExtract()

Returns the result of the extraction as a mesh.

Returns:

result of the extraction as a mesh