vtkGenericStreamTracer Class Reference

#include <vtkGenericStreamTracer.h>

Inheritance diagram for vtkGenericStreamTracer:

[legend]

Collaboration diagram for vtkGenericStreamTracer:

[legend]

List of all members.

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 84 of file vtkGenericStreamTracer.h.


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 const char *	GetClassName ()
virtual int	IsA (const char *type)
void	PrintSelf (ostream &os, vtkIndent indent)
int	FillInputPortInformation (int port, vtkInformation *info)
void	AddInput (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	SetSource (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 ()

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 (vtkObject *o)
static vtkGenericStreamTracer *	New ()
Protected Member Functions
	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
Classes
struct	IntervalInformation

Member Typedef Documentation

typedef vtkPolyDataAlgorithm vtkGenericStreamTracer::Superclass

Reimplemented from vtkPolyDataAlgorithm.

Definition at line 87 of file vtkGenericStreamTracer.h.

Member Enumeration Documentation

enum vtkGenericStreamTracer::Units

Enumerator:

TIME_UNIT
LENGTH_UNIT
CELL_LENGTH_UNIT

Definition at line 113 of file vtkGenericStreamTracer.h.

enum vtkGenericStreamTracer::Solvers

Enumerator:

RUNGE_KUTTA2
RUNGE_KUTTA4
RUNGE_KUTTA45
NONE
UNKNOWN

Definition at line 120 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 129 of file vtkGenericStreamTracer.h.

anonymous enum

Enumerator:

FORWARD
BACKWARD
BOTH

Definition at line 248 of file vtkGenericStreamTracer.h.

Constructor & Destructor Documentation

vtkGenericStreamTracer::vtkGenericStreamTracer ( ) [protected]

vtkGenericStreamTracer::~vtkGenericStreamTracer ( ) [protected]

Member Function Documentation

virtual const char* vtkGenericStreamTracer::GetClassName ( ) [virtual]

Reimplemented from vtkPolyDataAlgorithm.

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 ( vtkObject * o ) [static]

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::SetSource ( vtkDataSet * source )

Specify the source object used to generate starting points.

vtkDataSet* vtkGenericStreamTracer::GetSource ( )

Specify the source object used to generate starting points.

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 151 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 153 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 155 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 167 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 169 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 171 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 184 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 186 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 188 of file vtkGenericStreamTracer.h.

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