Streamline generator. More...

#include <vtkGenericStreamTracer.h>

Inheritance diagram for vtkGenericStreamTracer:

Collaboration diagram for vtkGenericStreamTracer:

Classes
struct	IntervalInformation
Public Types
enum	Units { TIME_UNIT, LENGTH_UNIT, CELL_LENGTH_UNIT }
enum	Solvers { RUNGE_KUTTA2, RUNGE_KUTTA4, RUNGE_KUTTA45, NONE, UNKNOWN }
enum	ReasonForTermination { OUT_OF_DOMAIN = vtkInitialValueProblemSolver::OUT_OF_DOMAIN, NOT_INITIALIZED = vtkInitialValueProblemSolver::NOT_INITIALIZED, UNEXPECTED_VALUE = vtkInitialValueProblemSolver::UNEXPECTED_VALUE, OUT_OF_TIME = 4, OUT_OF_STEPS = 5, STAGNATION = 6 }
enum	{ FORWARD, BACKWARD, BOTH }
typedef vtkPolyDataAlgorithm	Superclass
Public Member Functions
virtual int	IsA (const char *type)
vtkGenericStreamTracer *	NewInstance () const
void	PrintSelf (ostream &os, vtkIndent indent)
void	SetSourceConnection (vtkAlgorithmOutput *algOutput)
int	FillInputPortInformation (int port, vtkInformation *info)
void	AddInputData (vtkGenericDataSet *in)
void	SetInterpolatorPrototype (vtkGenericInterpolatedVelocityField *ivf)

virtual void	SetStartPosition (double, double, double)
virtual void	SetStartPosition (double[3])
virtual double *	GetStartPosition ()
virtual void	GetStartPosition (double &, double &, double &)
virtual void	GetStartPosition (double[3])

void	SetSourceData (vtkDataSet *source)
vtkDataSet *	GetSource ()

void	SetIntegrator (vtkInitialValueProblemSolver *)
virtual vtkInitialValueProblemSolver *	GetIntegrator ()
void	SetIntegratorType (int type)
int	GetIntegratorType ()
void	SetIntegratorTypeToRungeKutta2 ()
void	SetIntegratorTypeToRungeKutta4 ()
void	SetIntegratorTypeToRungeKutta45 ()

void	SetMaximumPropagation (int unit, double max)
void	SetMaximumPropagation (double max)
void	SetMaximumPropagationUnit (int unit)
int	GetMaximumPropagationUnit ()
double	GetMaximumPropagation ()
void	SetMaximumPropagationUnitToTimeUnit ()
void	SetMaximumPropagationUnitToLengthUnit ()
void	SetMaximumPropagationUnitToCellLengthUnit ()

void	SetMinimumIntegrationStep (int unit, double step)
void	SetMinimumIntegrationStepUnit (int unit)
void	SetMinimumIntegrationStep (double step)
int	GetMinimumIntegrationStepUnit ()
double	GetMinimumIntegrationStep ()
void	SetMinimumIntegrationStepUnitToTimeUnit ()
void	SetMinimumIntegrationStepUnitToLengthUnit ()
void	SetMinimumIntegrationStepUnitToCellLengthUnit ()

void	SetMaximumIntegrationStep (int unit, double step)
void	SetMaximumIntegrationStepUnit (int unit)
void	SetMaximumIntegrationStep (double step)
int	GetMaximumIntegrationStepUnit ()
double	GetMaximumIntegrationStep ()
void	SetMaximumIntegrationStepUnitToTimeUnit ()
void	SetMaximumIntegrationStepUnitToLengthUnit ()
void	SetMaximumIntegrationStepUnitToCellLengthUnit ()

void	SetInitialIntegrationStep (int unit, double step)
void	SetInitialIntegrationStepUnit (int unit)
void	SetInitialIntegrationStep (double step)
int	GetInitialIntegrationStepUnit ()
double	GetInitialIntegrationStep ()
void	SetInitialIntegrationStepUnitToTimeUnit ()
void	SetInitialIntegrationStepUnitToLengthUnit ()
void	SetInitialIntegrationStepUnitToCellLengthUnit ()

virtual void	SetMaximumError (double)
virtual double	GetMaximumError ()

virtual void	SetMaximumNumberOfSteps (vtkIdType)
virtual vtkIdType	GetMaximumNumberOfSteps ()

virtual void	SetTerminalSpeed (double)
virtual double	GetTerminalSpeed ()

void	SetIntegrationStepUnit (int unit)

virtual void	SetIntegrationDirection (int)
virtual int	GetIntegrationDirection ()
void	SetIntegrationDirectionToForward ()
void	SetIntegrationDirectionToBackward ()
void	SetIntegrationDirectionToBoth ()

virtual void	SetComputeVorticity (int)
virtual int	GetComputeVorticity ()
virtual void	ComputeVorticityOn ()
virtual void	ComputeVorticityOff ()

virtual void	SetRotationScale (double)
virtual double	GetRotationScale ()

virtual char *	GetInputVectorsSelection ()
void	SelectInputVectors (const char *fieldName)
Static Public Member Functions
static int	IsTypeOf (const char *type)
static vtkGenericStreamTracer *	SafeDownCast (vtkObjectBase *o)
static vtkGenericStreamTracer *	New ()
Protected Member Functions
virtual vtkObjectBase *	NewInstanceInternal () const
	vtkGenericStreamTracer ()
	~vtkGenericStreamTracer ()
void	AddInput (vtkDataObject *)
int	RequestData (vtkInformation , vtkInformationVector , vtkInformationVector )
void	Integrate (vtkGenericDataSet input0, vtkPolyData output, vtkDataArray seedSource, vtkIdList seedIds, vtkIntArray integrationDirections, double lastPoint[3], vtkGenericInterpolatedVelocityField func)
void	SimpleIntegrate (double seed[3], double lastPoint[3], double delt, vtkGenericInterpolatedVelocityField *func)
int	CheckInputs (vtkGenericInterpolatedVelocityField &func, vtkInformationVector *inputVector)
void	GenerateNormals (vtkPolyData output, double firstNormal)
virtual void	SetInputVectorsSelection (const char *)
void	SetIntervalInformation (int unit, double interval, IntervalInformation &currentValues)
void	SetIntervalInformation (int unit, IntervalInformation &currentValues)
void	ConvertIntervals (double &step, double &minStep, double &maxStep, int direction, double cellLength, double speed)
void	InitializeSeeds (vtkDataArray &seeds, vtkIdList &seedIds, vtkIntArray *&integrationDirections)

void	CalculateVorticity (vtkGenericAdaptorCell cell, double pcoords[3], vtkGenericAttribute attribute, double vorticity[3])
Static Protected Member Functions
static double	ConvertToTime (IntervalInformation &interval, double cellLength, double speed)
static double	ConvertToLength (IntervalInformation &interval, double cellLength, double speed)
static double	ConvertToCellLength (IntervalInformation &interval, double cellLength, double speed)
static double	ConvertToUnit (IntervalInformation &interval, int unit, double cellLength, double speed)
Protected Attributes
int	GenerateNormalsInIntegrate
char *	InputVectorsSelection
double	StartPosition [3]
double	TerminalSpeed
double	LastUsedTimeStep
IntervalInformation	MaximumPropagation
IntervalInformation	MinimumIntegrationStep
IntervalInformation	MaximumIntegrationStep
IntervalInformation	InitialIntegrationStep
int	IntegrationDirection
vtkInitialValueProblemSolver *	Integrator
double	MaximumError
vtkIdType	MaximumNumberOfSteps
int	ComputeVorticity
double	RotationScale
vtkGenericInterpolatedVelocityField *	InterpolatorPrototype
Static Protected Attributes
static const double	EPSILON

Detailed Description

Streamline generator.

vtkGenericStreamTracer is a filter that integrates a vector field to generate streamlines. The integration is performed using the provided integrator. The default is second order Runge-Kutta.

vtkGenericStreamTracer generate polylines as output. Each cell (polyline) corresponds to one streamline. The values associated with each streamline are stored in the cell data whereas the values associated with points are stored in point data.

Note that vtkGenericStreamTracer can integrate both forward and backward. The length of the streamline is controlled by specifying either a maximum value in the units of length, cell length or elapsed time (the elapsed time is the time each particle would have traveled if flow were steady). Otherwise, the integration terminates after exiting the dataset or if the particle speed is reduced to a value less than the terminal speed or when a maximum number of steps is reached. The reason for the termination is stored in a cell array named ReasonForTermination.

The quality of integration can be controlled by setting integration step (InitialIntegrationStep) and in the case of adaptive solvers the maximum error, the minimum integration step and the maximum integration step. All of these can have units of length, cell length or elapsed time.

The integration time, vorticity, rotation and angular velocity are stored in point arrays named "IntegrationTime", "Vorticity", "Rotation" and "AngularVelocity" respectively (vorticity, rotation and angular velocity are computed only when ComputeVorticity is on). All point attributes in the source data set are interpolated on the new streamline points.

vtkGenericStreamTracer integrates through any type of dataset. As a result, if the dataset contains 2D cells such as polygons or triangles, the integration is constrained to lie on the surface defined by the 2D cells.

The starting point of traces may be defined in two different ways. Starting from global x-y-z "position" allows you to start a single trace at a specified x-y-z coordinate. If you specify a source object, a trace will be generated for each point in the source that is inside the dataset.

See also:: vtkRibbonFilter vtkRuledSurfaceFilter vtkInitialValueProblemSolver vtkRungeKutta2 vtkRungeKutta4 vtkRungeKutta45

Tests:: vtkGenericStreamTracer (Tests)

Definition at line 85 of file vtkGenericStreamTracer.h.

Member Typedef Documentation

typedef vtkPolyDataAlgorithm vtkGenericStreamTracer::Superclass

Reimplemented from vtkPolyDataAlgorithm.

Definition at line 88 of file vtkGenericStreamTracer.h.

Member Enumeration Documentation

enum vtkGenericStreamTracer::Units

Enumerator:

TIME_UNIT
LENGTH_UNIT
CELL_LENGTH_UNIT

Definition at line 118 of file vtkGenericStreamTracer.h.

enum vtkGenericStreamTracer::Solvers

Enumerator:

RUNGE_KUTTA2
RUNGE_KUTTA4
RUNGE_KUTTA45
NONE
UNKNOWN

Definition at line 125 of file vtkGenericStreamTracer.h.

enum vtkGenericStreamTracer::ReasonForTermination

Enumerator:

OUT_OF_DOMAIN
NOT_INITIALIZED
UNEXPECTED_VALUE
OUT_OF_TIME
OUT_OF_STEPS
STAGNATION

Definition at line 134 of file vtkGenericStreamTracer.h.

anonymous enum

Enumerator:

FORWARD
BACKWARD
BOTH

Definition at line 264 of file vtkGenericStreamTracer.h.

Constructor & Destructor Documentation

vtkGenericStreamTracer::vtkGenericStreamTracer ( ) [protected]

vtkGenericStreamTracer::~vtkGenericStreamTracer ( ) [protected]

Member Function Documentation

static int vtkGenericStreamTracer::IsTypeOf ( const char * name ) [static]

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkPolyDataAlgorithm.

virtual int vtkGenericStreamTracer::IsA ( const char * name ) [virtual]

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkPolyDataAlgorithm.

static vtkGenericStreamTracer* vtkGenericStreamTracer::SafeDownCast ( vtkObjectBase * o ) [static]

Reimplemented from vtkPolyDataAlgorithm.

virtual vtkObjectBase* vtkGenericStreamTracer::NewInstanceInternal ( ) const [protected, virtual]

Reimplemented from vtkPolyDataAlgorithm.

vtkGenericStreamTracer* vtkGenericStreamTracer::NewInstance ( ) const

Reimplemented from vtkPolyDataAlgorithm.

void vtkGenericStreamTracer::PrintSelf	(	ostream &	os,
		vtkIndent	indent
	)		`[virtual]`

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkPolyDataAlgorithm.

static vtkGenericStreamTracer* vtkGenericStreamTracer::New ( ) [static]

Construct object to start from position (0,0,0), integrate forward, terminal speed 1.0E-12, vorticity computation on, integration step length 0.5 (unit cell length), maximum number of steps 2000, using 2nd order Runge Kutta and maximum propagation 1.0 (unit length).

Reimplemented from vtkPolyDataAlgorithm.

virtual void vtkGenericStreamTracer::SetStartPosition	(	double	,
		double	,
		double
	)		`[virtual]`

Specify the start of the streamline in the global coordinate system. Search must be performed to find initial cell to start integration from.

virtual void vtkGenericStreamTracer::SetStartPosition ( double [3] ) [virtual]

Specify the start of the streamline in the global coordinate system. Search must be performed to find initial cell to start integration from.

virtual double* vtkGenericStreamTracer::GetStartPosition ( ) [virtual]

Specify the start of the streamline in the global coordinate system. Search must be performed to find initial cell to start integration from.

virtual void vtkGenericStreamTracer::GetStartPosition	(	double &	,
		double &	,
		double &
	)		`[virtual]`

Specify the start of the streamline in the global coordinate system. Search must be performed to find initial cell to start integration from.

virtual void vtkGenericStreamTracer::GetStartPosition ( double [3] ) [virtual]

Specify the start of the streamline in the global coordinate system. Search must be performed to find initial cell to start integration from.

void vtkGenericStreamTracer::SetSourceData ( vtkDataSet * source )

Specify the source object used to generate starting points.

vtkDataSet* vtkGenericStreamTracer::GetSource ( )

Specify the source object used to generate starting points.

void vtkGenericStreamTracer::SetSourceConnection ( vtkAlgorithmOutput * algOutput )

Specify the source object used to generate starting points (seeds). New style.

int vtkGenericStreamTracer::FillInputPortInformation	(	int	port,
		vtkInformation *	info
	)		`[virtual]`

Fill the input port information objects for this algorithm. This is invoked by the first call to GetInputPortInformation for each port so subclasses can specify what they can handle.

Reimplemented from vtkPolyDataAlgorithm.

void vtkGenericStreamTracer::SetIntegrator ( vtkInitialValueProblemSolver * )

Set/get the integrator type to be used in the stream line calculation. The object passed is not actually used but is cloned with NewInstance in the process of integration (prototype pattern). The default is 2nd order Runge Kutta. The integrator can also be changed using SetIntegratorType. The recognized solvers are: RUNGE_KUTTA2 = 0 RUNGE_KUTTA4 = 1 RUNGE_KUTTA45 = 2

virtual vtkInitialValueProblemSolver* vtkGenericStreamTracer::GetIntegrator ( ) [virtual]

Set/get the integrator type to be used in the stream line calculation. The object passed is not actually used but is cloned with NewInstance in the process of integration (prototype pattern). The default is 2nd order Runge Kutta. The integrator can also be changed using SetIntegratorType. The recognized solvers are: RUNGE_KUTTA2 = 0 RUNGE_KUTTA4 = 1 RUNGE_KUTTA45 = 2

void vtkGenericStreamTracer::SetIntegratorType ( int type )

Set/get the integrator type to be used in the stream line calculation. The object passed is not actually used but is cloned with NewInstance in the process of integration (prototype pattern). The default is 2nd order Runge Kutta. The integrator can also be changed using SetIntegratorType. The recognized solvers are: RUNGE_KUTTA2 = 0 RUNGE_KUTTA4 = 1 RUNGE_KUTTA45 = 2

int vtkGenericStreamTracer::GetIntegratorType ( )

Set/get the integrator type to be used in the stream line calculation. The object passed is not actually used but is cloned with NewInstance in the process of integration (prototype pattern). The default is 2nd order Runge Kutta. The integrator can also be changed using SetIntegratorType. The recognized solvers are: RUNGE_KUTTA2 = 0 RUNGE_KUTTA4 = 1 RUNGE_KUTTA45 = 2

void vtkGenericStreamTracer::SetIntegratorTypeToRungeKutta2 ( ) [inline]

Set/get the integrator type to be used in the stream line calculation. The object passed is not actually used but is cloned with NewInstance in the process of integration (prototype pattern). The default is 2nd order Runge Kutta. The integrator can also be changed using SetIntegratorType. The recognized solvers are: RUNGE_KUTTA2 = 0 RUNGE_KUTTA4 = 1 RUNGE_KUTTA45 = 2

Definition at line 156 of file vtkGenericStreamTracer.h.

void vtkGenericStreamTracer::SetIntegratorTypeToRungeKutta4 ( ) [inline]

Set/get the integrator type to be used in the stream line calculation. The object passed is not actually used but is cloned with NewInstance in the process of integration (prototype pattern). The default is 2nd order Runge Kutta. The integrator can also be changed using SetIntegratorType. The recognized solvers are: RUNGE_KUTTA2 = 0 RUNGE_KUTTA4 = 1 RUNGE_KUTTA45 = 2

Definition at line 158 of file vtkGenericStreamTracer.h.

void vtkGenericStreamTracer::SetIntegratorTypeToRungeKutta45 ( ) [inline]

Set/get the integrator type to be used in the stream line calculation. The object passed is not actually used but is cloned with NewInstance in the process of integration (prototype pattern). The default is 2nd order Runge Kutta. The integrator can also be changed using SetIntegratorType. The recognized solvers are: RUNGE_KUTTA2 = 0 RUNGE_KUTTA4 = 1 RUNGE_KUTTA45 = 2

Definition at line 160 of file vtkGenericStreamTracer.h.

void vtkGenericStreamTracer::SetMaximumPropagation	(	int	unit,
		double	max
	)

Specify the maximum length of the streamlines expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2

void vtkGenericStreamTracer::SetMaximumPropagation ( double max )

Specify the maximum length of the streamlines expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2

void vtkGenericStreamTracer::SetMaximumPropagationUnit ( int unit )

Specify the maximum length of the streamlines expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2

int vtkGenericStreamTracer::GetMaximumPropagationUnit ( )

Specify the maximum length of the streamlines expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2

double vtkGenericStreamTracer::GetMaximumPropagation ( )

Specify the maximum length of the streamlines expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2

void vtkGenericStreamTracer::SetMaximumPropagationUnitToTimeUnit ( ) [inline]

Specify the maximum length of the streamlines expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2

Definition at line 172 of file vtkGenericStreamTracer.h.

void vtkGenericStreamTracer::SetMaximumPropagationUnitToLengthUnit ( ) [inline]

Specify the maximum length of the streamlines expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2

Definition at line 174 of file vtkGenericStreamTracer.h.

void vtkGenericStreamTracer::SetMaximumPropagationUnitToCellLengthUnit ( ) [inline]

Specify the maximum length of the streamlines expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2

Definition at line 176 of file vtkGenericStreamTracer.h.

void vtkGenericStreamTracer::SetMinimumIntegrationStep	(	int	unit,
		double	step
	)

Specify the minimum step used in the integration expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2 Only valid when using adaptive integrators.

void vtkGenericStreamTracer::SetMinimumIntegrationStepUnit ( int unit )

Specify the minimum step used in the integration expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2 Only valid when using adaptive integrators.

void vtkGenericStreamTracer::SetMinimumIntegrationStep ( double step )

Specify the minimum step used in the integration expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2 Only valid when using adaptive integrators.

int vtkGenericStreamTracer::GetMinimumIntegrationStepUnit ( )

Specify the minimum step used in the integration expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2 Only valid when using adaptive integrators.

double vtkGenericStreamTracer::GetMinimumIntegrationStep ( )

Specify the minimum step used in the integration expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2 Only valid when using adaptive integrators.

void vtkGenericStreamTracer::SetMinimumIntegrationStepUnitToTimeUnit ( ) [inline]

Specify the minimum step used in the integration expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2 Only valid when using adaptive integrators.

Definition at line 189 of file vtkGenericStreamTracer.h.

void vtkGenericStreamTracer::SetMinimumIntegrationStepUnitToLengthUnit ( ) [inline]

Specify the minimum step used in the integration expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2 Only valid when using adaptive integrators.

Definition at line 191 of file vtkGenericStreamTracer.h.

void vtkGenericStreamTracer::SetMinimumIntegrationStepUnitToCellLengthUnit ( ) [inline]

Specify the minimum step used in the integration expressed in one of the: TIME_UNIT = 0 LENGTH_UNIT = 1 CELL_LENGTH_UNIT = 2 Only valid when using adaptive integrators.

Definition at line 193 of file vtkGenericStreamTracer.h.

void vtkGenericStreamTracer::SetMaximumIntegrationStep	(	int	unit,
		double	step
	)