Documentation‎ > ‎User Manual‎ > ‎

Sources Menu



The Sources menu contains various sources that can be used to create datasets within ParaViewGeo. The options that appear on the Properties tab of the Object Inspector for the various sources are covered below. Once the properties are filled in, the Apply button must be clicked to make the object appear in the View Manager.

The sources can be selected from the Sources menu, or you can use Ctrl+Space to open a Search dialog where you can search for a source or filter. In the image, the search term "ell" (shown at the top) provided the results shown.

Grayed-out sources and filters are not available with the selected pipeline object. Select the source you want to create from the list that appears, using the mouse or the arrow keys so it appears in the button at the top, then press Enter; the source will be added to the pipeline and you will need to apply it in the Object Inspector.

Use the Esc key to cancel the search, and press it again to close the window.





Contents

2D Glyph



Creates a two dimensional object without depth. The output type is polygonal data.
  • Glyph Type - Select the glyph to create
  • Vertex
  • Dash
  • Cross
  • Thick Cross
  • Triangle
  • Square
  • Circle
  • Diamond
  • Arrow
  • Thick Arrow
  • Hooked Arrow
  • Edge Arrow
  • Filled - Place a check-mark in the box to fill the object, or leave blank to create an outline only
  • Center - Specify the X, Y and Z coordinates to identify where in space the center of the object should be located



3D Text

Creates a two dimensional text object without depth in the render window (the text can be rotated and zoomed together with the other objects visible in the render view). The output type is polygonal mesh.
  • Text - Enter the text to display


Annotate Time



Shows the animation time as a text annotation in the view (the annotation cannot be zoomed or rotated).
  • Format - Specify the format used to display the input time (using printf style)


Arrow


Creates a three dimensional arrow. The output type is polygonal mesh.
  • Tip Resolution - Specify the number of faces on the arrow head
  • Tip Radius - Specify the radius of the widest part of the arrow head
  • Tip Length - Specify the length of the arrow head
  • Shaft Resolution - Specify the number of faces on the arrow shaft
  • Shaft Radius - Specify the radius of the arrow shaft


Axes

Creates three lines representing the X, Y and Z axes. The output type is polygonal mesh.
  • Scale Factor - Enter the length of the axes lines, the default is 1
  • Origin - Enter the X, Y and Z coordinates of the origin of the axes
  • Symmetric - While unchecked, the axes extend only in the positive direction; when checked, the axes extend in both the positive and negative directions


Box


Creates a three dimensional box. The output type is polygonal mesh.
  • X Length - Specify the box length in the X direction
  • Y Length - Specify the box length in the Y direction
  • Z Length - Specify the box length in the Z direction
  • Center - Specify the X, Y and Z coordinates for the center of the box


Cone


Creates a three dimensional cone. The output type is polygonal mesh.
  • Resolution - Specify the number of faces/divisions on the cone (the higher the number, the more closely the object will resemble a cone)
  • Radius - Specify the radius of the widest part of the cone
  • Height - Specify the length of the cone
  • Center - Specify the X, Y and Z coordinates of the center
  • Capping - When checked, the bottom of the cone is filled; when unchecked, the bottom of the cone is left open


Cylinder



Creates a cylinder. The output type is polygonal mesh.
  • Resolution - Specify the number of faces on the cylinder
  • Height - Specify the length of the cylinder
  • Radius - Specify the radius of the cylinder
  • Center - Specify the X, Y and Z coordinates for the center of the cylinder
  • Capping - When checked, the ends of the cylinder are filled; when unchecked, the ends of the cylinder are left open


Data Object Generator



Produces simple data sets for testing.
  • Program - Enter the string to determine the structure of the data object produced
    • ID1 - vtk Image Data
    • UF1 - vtk Uniform Grid
    • RD1 - vtk Rectilinear Grid
    • SD1 - vtk Structured Grid
    • PD1 - vtk Poly Data
    • UG1 - vtk Unstructured Grid
    • MB{} - will create a vtk Multi Block Data Set
    • HD - will create a vtk Hierarchical Data Set
    • HB[] - will create a vtk Hierarchical Box Data Set


Disk Source


Creates a shape with a hollow center. The output type is polygonal mesh.
  • Outer Radius - Specify the distance from the center to the outer edge
  • Inner Radius - Specify the distance from the center to the inner edge
  • Radial Resolution - Specify the number of lines between the inner and outer edge (visible in wireframe view)
  • Circumferential Resolution - Specify the number of edges/faces on the shape (1-3 creates a triangle, the larger the number, the more closely the shape resembles a circular disk)


Ellipsoid



Creates a three dimensional elliptical sphere. The output type is polygonal mesh.
  • Translate - Specify the X, Y and Z coordinates of the ellipsoid
  • Rotate About - Specify the angle of rotation in the X, Y and Z planes
  • Scale - Specify the X, Y and Z dimensions


Elliptic


Creates a two dimensional ellipse without any depth. The output type is polygonal mesh.
  • Translate - Specify the X, Y and Z coordinates for the center
  • Rotate About - Specify the angle of rotation in the X, Y and Z planes
  • Scale - Specify the X and Y dimensions for length and height


Hierarchical Fractal


Creates a hierarchical fractal using the Mandelbrot source. The output is an AMR dataset.
  • Dimensions - Specify the X, Y and Z dimensions of a block
  • Fractal Value - The value entered is mapped to 0.5 for use as a volume fraction
  • Maximum Level - Specify the levels of refinement of the fractal
  • Ghost Levels - When checked, overlapping ghost levels are generated at the processor boundaries
  • Two Dimensional - When checked, the fractal is two dimensional; when unchecked, the fractal is three dimensional
  • Asymmetric - When checked, some blocks will have larger X dimensions; when unchecked, the blocks are all the same size
  • Rectilinear Grids - When checked, the dataset contains rectilinear grids; when unchecked, the dataset contains uniform grids
  • Time Step - Specify the time step to use for the dataset


Line


Creates a line between two points. The output type is polygonal mesh.
  • Show Line - when checked, the line appears in the View Manager; when unchecked, the line is not visible
  • Point 1 - Specify the X, Y and Z coordinates of one end of the line
  • Point 2 - Specify the X, Y and Z coordinates of the other end of the line
  • Reset Bounds - Switches Point 1 with Point 2
  • X Axis - Moves the line along the X axis using the X coordinates
  • Y Axis - Moves the line along the Y axis using the Y coordinates
  • Z Axis - Moves the line along the Z axis using the Z coordinates
  • Resolution - Specify the number of line segments in the output line (this does not increase the accuracy of the line; it only increases the number of collinear line segments defining the line)

Note: The end points of the line can be moved by clicking and dragging with the mouse (the point will change to green), or by moving the mouse cursor in the 3D space and pressing 'p' on the keyboard, which will rotate between changing Point 1 and Point 2. The whole line can be moved by clicking and dragging on the line between the points (the line will change to green).


Mandelbrot


Creates a Mandelbrot representation (opens in a 2D render window). The output type is image (uniform rectilinear grid).
  • Whole Extent - Specify the minimum and maximum X, Y and Z extents
  • Projection Axes - Specify the projection from the 4D space used by the Mandelbrot set to the axes of the 3D volume. All values must be between 0 and 3
    • 0 = real component of C
    • 1 = imaginary component of C
    • 2 = real component of X
    • 3 = imaginary component of X
  • Origin CX - Indicate the real and imaginary components of C and the real and imaginary components of the initial value of X
  • Size CX - Specify the length of the output in each of the four dimensions (real and imaginary components of C and X)
  • Maximum Number of Iterations - Specify the maximum number of iterations that will be performed
  • Subsample Rate - Specify the rate at which to subsample the volume - the extent of each dataset in each dimension is divided by this value

The equation used is z = z2 + C (where z and C are complex).


Octree Fractal



Creates an octree from a Mandelbrot fractal. The output type is hyper-octree.
  • Dimension - Specify the number of dimensions; 1D, 2D, 3D
  • Maximum Level - Specify the maximum refinement level
  • Minimum Level - Specify the minimum refinement level
  • Projection Axes - Specify the projection from the 4D space used by the Mandelbrot set to the axes of the 3D volume. All values must be between 0 and 3
    • 0 = real component of C
    • 1 = imaginary component of C
    • 2 = real component of X
    • 3 = imaginary component of X
  • Origin CX - Indicate the real and imaginary components of C and the real and imaginary components of the initial value of X
  • Size CX - Specify the length of the output in each of the four dimensions (real and imaginary components of C and X)
  • Maximum Number of Iterations - Specify the maximum number of iterations that will be performed
  • Threshold - Specify a threshold value to determine when a leaf node is subdivided


Outline


Creates an outline based on the bounds specified. The output type is polygonal mesh.
  • Bounds Bold text- Enter the minimum and maximum X, Y and Z coordinates for the outline


Plane


Creates a parallelogram using an origin and two points. The output type is polygonal mesh.
  • Origin - Specify the X, Y and Z coordinates for the origin (one corner) of the plane
  • Point 1 - Specify the X, Y and Z coordinates for the first point (second corner) on the plane
  • Point 2 - Specify the X, Y and Z coordinates for the second point (third corner) on the plane
  • X Resolution - Specify the number of divisions along the X Axis (visible with points or wireframe representation)
  • Y Resolution - Specify the number of divisions along the Y Axis (visible with points or wireframe representation)


Point Source


Creates a point cloud. The output type is polygonal mesh.
  • Show Point - When checked, the center point is visible in the View Manager
  • Center on Bounds - Recalculates the center of the point cloud and the radius based on the visible points
  • Point - Specify the center for the point cloud
  • Number of Points - Specify the number of points in the point cloud
  • Radius - Specify the radius of the point cloud


Programmable Source

A Programmable Source executes a python script to produce data. This can be used to load data if a file type is not supported.

  • Output Data Set - Select the dataset type for the output
  • Same as Input
  • vtk Poly Data
  • vtk Structured Grid
  • vtk Rectilinear Data
  • vtk Unstructured Data
  • vtk Image Data
  • Script - Enter the python text to run
  • Script (Request Information) - Enter the script that will be executed during the Request Information pipeline pass - used to provide information to the pipeline downstream
  • Python Path - Enter a list of directories (separated by ;) to be added to the python library search path


Ruler


Creates a line that acts as a ruler to measure the distance between two points.
  • Distance - Displays the distance between the two points
  • Show Line - When checked, the line is visible in the View Manager
  • Point 1 - Identifies the X, Y and Z coordinates of the one end of the line
  • Point 2 - Identifies the X, Y and Z coordinates of the other end of the line
  • Reset Bounds - No changes are made
  • X Axis - Moves the ruler along the X axis, using the mid-point of the Y and Z coordinates and retaining the distance
  • Y Axis - Moves the ruler along the Y axis, using the mid-point of the X and Z coordinates and retaining the distance
  • Z Axis - Moves the ruler along the Z axis, using the mid-point of the X and Y coordinates and retaining the distance

Note: The end points of the line can be moved by clicking and dragging with the mouse, or by moving the mouse cursor in the 3D space and pressing 'p' on the keyboard, same as for the Line source. To correctly determine the distance between two points on a 3D object, it will be necessary to rotate the object to correctly place the end of the ruler on the correct spot for the measurement, or it may be easiest to use the Select Points options to get the specific coordinates to enter them into the Point 1 and Point 2 fields.


Sphere


Creates a three dimensional sphere. The output type is polygonal mesh.
  • Center - Specify the X, Y and Z coordinates of the center of the sphere
  • Radius - Specify the radius of the sphere
  • Theta Resolution - Specify the number of divisions between the start theta and end theta around the sphere (the higher the number, the more rounded the sphere - similar to longitude lines)
  • Start Theta - Specify the number of degrees where the sphere begins (for a complete sphere, use 0)
  • End Theta - Specify the number of degrees where the sphere ends (for a complete sphere, use 360)
  • Phi Resolution - Specify the number of divisions between the start phi and end phi around the sphere (the higher the number, the more rounded the sphere - similar to latitude lines)
  • Start Phi - Specify the starting angle in the latitudinal direction (for a complete sphere, use 0)
  • End Phi - Specify the angle where the sphere ends in the latitudinal direction (for a complete sphere, use 180)


Superquadric


Creates a superquadric shape. The output type is polygonal mesh.
  • Center - Specify the X, Y and Z coordinates of the center of the superquadric
  • Scale - Specify the length, height and width
  • Theta Resolution - Specify the number of divisions in the longitudinal (theta) direction
  • Phi Resolution - Specify the number of divisions in the latitudinal (phi) direction
  • Thickness - Specify the thickness of the superquadric, where 0 is thin with a large hole and 1 is thick with a very small hole (assuming Toroidal is checked)
  • Theta Roundness - Specify the roundness in the longitudinal (theta) direction where 0 is rectangular, 1 is circular and values greater than 1 produce higher order shapes
  • Phi Roundness - Specify the roundness in the latitudinal (phi) direction where 0 is rectangular, 1 is circular and values greater than 1 produce higher order shapes
  • Size - Specify the isotropic size
  • Toroidal - When checked, the superquadric contains a hole; when unchecked, the superquadric is ellipsoidal


Text


Creates a text box on top of the render window - the text box will not rotate or zoom, but can be dragged anywhere on the window.
  • Text - Enter the text to display

Note: Continuous text will run off the screen, manual returns are required for formatting. The font features can be changed on the Display tab, which also contains options for the text box location.


Time Source

Produces a sine wave over time. The output type is image (uniform rectilinear grid).

  • Analytic - When checked, this causes the time source to produce discrete steps of an analytic sine wave
  • X Amplitude - Specify how far the data set moves along X over time
  • Y Amplitude - Specify how far the data set moves along Y over time
  • Growing - Causes the time source to grow and shrink over time


Wavelet


Creates a rectilinear grid containing a wavelet. The output type is image (uniform rectilinear grid).
  • Whole Extent - Specify the minimum and maximum values for the X, Y and Z indices
  • Center - Specify the X, Y and Z coordinates of the center of the dataset
  • Maximum - Specify the maximum value of the function
  • X Freq - Specify the natural frequency for X
  • Y Freq - Specify the natural frequency for Y
  • Z Freq - Specify the natural frequency for Z
  • X Mag - Specify the wave amplitude for X
  • Y Mag - Specify the wave amplitude for Y
  • Z Mag - Specify the wave amplitude for Z

The equation used is: OS = M * G * (XM * sin(XF * x) + YM * sin(YF * y) + ZM * cos(ZF * z)) where OS is the output scalar, M represents the maximum value, G represents the Gaussian, XM, YM and ZM are the X, Y and Z magnitude values and XF, YF and ZF are the X, Y and Z frequency values.


Next Section Previous Section Return To
Displaying Datasets The State File User Manual
Comments