Overview | All Modules | Tutorial | User's Guide | Programming Guide

COVISE Online Documentation


Module category: Mapper



VectorField

VectorField computes lines in a vector field.

VectorFieldModule.png

VectorField is available for all COVISE versions on all supported platforms

Parameters

Name Type Description
length Choice With this parameter the length of the lines can be set.
1*scale scales all lines with the value of the scale parameter.
length*scale means that the amount of the vector is used to compute the length which is then multiplied with scale.
according_to_data scales the lines according to the data from the optional input port.
scale Slider Scale factor which is used when length is set to 1*scale or length*scale.
fasten Choice Point where the vector lines are fastened. Default is on_the_bottom which means, that the lines start at the grid/surface vertices. on_the_middle means that the middle of the line is fastened at the grid/surface vertices.
num_sectors Scalar arrow head is built using num_sectors lines - If you have difficulties in identifying the direction of the vector, you may introduce here a positive value in order to give all vectors an arrow point. This value parametrises the refinement of the graphical representation for the arrow points. In general values of an order of magnitude between 1 and 30 have to be enough for your purposes.

Input Ports

Name Type Description
requiredmeshIn UnstructuredGrid
RectilinearGrid
UniformGrid
Polygons
Lines
UnstructuredGrid
TriangleStrips
The grid or surface on which vector data are available.
requiredvDataIn Vec3
Vec3
Structured_V3D_Normals
Unstructured_V3D_Normals
Vector data. The data have to be vertex based. In case you have cell based data (for example simulation results from StarCD) use CellToVert to convert them to vertex based data.
optionalsDataIn Float
Float
Optional Input Port. When the parameter length is set to according_to_data the scalar data are used to scale the vector lines. The scalar data have to be vertex based.

Output Ports

Name Type Description
outputlinesOut Lines Vector lines.
outputdataOut Float Scalar Data
- no need for additional VectorScal

Example 1

Example 1 is taken from the tutorial maps (tutorial_vel_4.net).

Figure: covise/net/tutorial/tutorial_vel_4.net
VectorFieldMap.png

Displaying vector lines for each grid point point in a 3D volume often leads to very complex visualizations (see covise/net/tutorial/tutorial_vel_3.net). Therefore it is often clearer to display vector lines only on a surface, for example on the outer surface of the geometry or on a plane which cuts through the 3D data. In tutorial_vel_4.net the first RWCovise module reads in the computational grid of a channel with two inlets. The second RWCovise module reads in the velocity field. The module CuttingSurface extracts a plane with the velocity data on the plane. VectorField computes a vector arrow on each polygon vertex of the cutting surface. The module VectorScal computes the amount of the velocity and the module Colors computes colors from the velocity amount data. The colors and the vector lines are combined with the module Collect and displayed in the Renderer.

VectorFieldRenderer.png

Example 2

Example 2 is taken from the example maps (VectorField.net)

Figure: covise/net/examples/VectorField.net
VectorFieldMap2.png

VectorFieldRenderer2.png


Authors: Martin Aumüller, Ruth Lang, Daniela Rainer, Jürgen Schulze-Döbold, Andreas Werner, Peter Wolf, Uwe Wössner
Copyright © 1993-2016 HLRS, 2004-2014 RRZK, 2005-2014 Visenso
COVISE Version 2016.3