Difference between revisions of "ParaView/Users Guide/List of filters"

From KitwarePublic
Jump to navigationJump to search
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==AMR Contour==


==AMR Connectivity==


Fragment Identification


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 9: Line 10:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
| '''Capping'''<br>''(Capping)''
|
If this property is on, the the boundary of the data set is capped.
| 1
|
Only the values 0 and 1 are accepted.


|-
|-
| '''Degenerate Cells'''<br>''(DegenerateCells)''
|'''Input''' (Input)
|
|
If this property is on, a transition mesh between levels is created.
This property specifies the volume input of the
 
filter.
| 1
|
|
Only the values 0 and 1 are accepted.


|-
| '''Input'''<br>''(Input)''
| This property specifies the input of the filter.
|
|
|
The selected object must be the result of the following: sources (includes readers), filters.
Accepts input of following types:
 
* vtkNonOverlappingAMR
 
The dataset must contain a field array (cell)
The dataset must contain a cell array with 1 components.
 
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkCompositeDataSet.


with 1 component(s).


|-
|-
| '''Merge Points'''<br>''(MergePoints)''
|'''SelectMaterialArrays''' (SelectMaterialArrays)
|
|
Use more memory to merge points on the boundaries of blocks.
This property specifies the cell arrays from which the
 
analysis will determine fragments
| 1
|
|
Only the values 0 and 1 are accepted.


|-
| '''Multiprocess Communication'''<br>''(MultiprocessCommunication)''
|
|
If this property is off, each process executes independantly.
An array of scalars is required.
 
| 1
|
Only the values 0 and 1 are accepted.
 
 
|-
|-
| '''Select Material Arrays'''<br>''(SelectMaterialArrays)''
|'''Volume Fraction Value''' (VolumeFractionSurfaceValue)
|
|
This property specifies the cell arrays from which the contour filter will
This property specifies the values at which to compute
compute contour cells.
the isosurface.
 
|
|
0.1
|
|
An array of scalars is required.


|-
|-
| '''Skip Ghost Copy'''<br>''(SkipGhostCopy)''
|'''Resolve Blocks''' (Resolve Blocks)
|
|
A simple test to see if ghost values are already set properly.
Resolve the fragments between blocks.
 
|
| 1
1
|
|
Only the values 0 and 1 are accepted.
Accepts boolean values (0 or 1).
 
 
|-
|-
| '''Triangulate'''<br>''(Triangulate)''
|'''Propagate Ghosts''' (Propagate Ghosts)
|
|
Use triangles instead of quads on capping surfaces.
Propagate regionIds into the ghosts.
 
| 1
|
|
Only the values 0 and 1 are accepted.
0
 
 
|-
| '''Volume Fraction Value'''<br>''(VolumeFractionSurfaceValue)''
|
|
This property specifies the values at which to compute the isosurface.
Accepts boolean values (0 or 1).
 
| 0.1
|
The value must be greater than or equal to 0 and less than or equal to 1.
 


|}
|}


==AMR Contour==


==AMR Dual Clip==
Iso surface cell array.
 
 
Clip with scalars. Tetrahedra.
 


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 119: Line 72:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
| This property specifies the input of the filter.
|
|
This property specifies the input of the
filter.
|
|
The selected object must be the result of the following: sources (includes readers), filters.


|
Accepts input of following types:
* vtkCompositeDataSet
The dataset must contain a field array (cell)


The dataset must contain a cell array with 1 components.
with 1 component(s).
 
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkCompositeDataSet.
 


|-
|-
| '''Internal Decimation'''<br>''(InternalDecimation)''
|'''SelectMaterialArrays''' (SelectMaterialArrays)
|
This property specifies the cell arrays from which the
contour filter will compute contour cells.
|
|
If this property is on, internal tetrahedra are decimation


| 1
|
|
Only the values 0 and 1 are accepted.
An array of scalars is required.
 
 
|-
|-
| '''Merge Points'''<br>''(MergePoints)''
|'''Volume Fraction Value''' (VolumeFractionSurfaceValue)
|
|
Use more memory to merge points on the boundaries of blocks.
This property specifies the values at which to compute
 
the isosurface.
| 1
|
0.1
|
|
Only the values 0 and 1 are accepted.


|-
|-
| '''Multiprocess Communication'''<br>''(MultiprocessCommunication)''
|'''Capping''' (Capping)
|
If this property is on, the the boundary of the data set
is capped.
|
1
|
Accepts boolean values (0 or 1).
|-
|'''DegenerateCells''' (DegenerateCells)
|
If this property is on, a transition mesh between levels
is created.
|
1
|
Accepts boolean values (0 or 1).
|-
|'''MultiprocessCommunication''' (MultiprocessCommunication)
|
If this property is off, each process executes
independantly.
|
1
|
Accepts boolean values (0 or 1).
|-
|'''SkipGhostCopy''' (SkipGhostCopy)
|
A simple test to see if ghost values are already set
properly.
|
|
If this property is off, each process executes independantly.
1
 
| 1
|
|
Only the values 0 and 1 are accepted.
Accepts boolean values (0 or 1).
 
 
|-
|-
| '''Select Material Arrays'''<br>''(SelectMaterialArrays)''
|'''Triangulate''' (Triangulate)
|
|
This property specifies the cell arrays from which the clip filter will
Use triangles instead of quads on capping
compute clipped cells.
surfaces.
 
|
|
1
|
|
An array of scalars is required.
Accepts boolean values (0 or 1).
 
 
|-
|-
| '''Volume Fraction Value'''<br>''(VolumeFractionSurfaceValue)''
|'''MergePoints''' (MergePoints)
|
Use more memory to merge points on the boundaries of
blocks.
|
|
This property specifies the values at which to compute the isosurface.
1
 
| 0.1
|
|
The value must be greater than or equal to 0 and less than or equal to 1.
Accepts boolean values (0 or 1).
 


|}
|}


==AMR CutPlane==


==Annotate Time Filter==
Planar Cut of an AMR grid datasetThis filter
 
creates a cut-plane of the
 
Shows input data time as text annnotation in the view.
 
The Annotate Time filter can be used to show the data time in a text annotation.<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 200: Line 173:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Format'''<br>''(Format)''
|'''Input''' (Input)
|
This property specifies the input for this
filter.
|
|
The value of this property is a format string used to display the input time. The format string is specified using printf style.


| Time: %f
|
|
Accepts input of following types:
* vtkOverlappingAMR
|-
|-
| '''Input'''<br>''(Input)''
|'''UseNativeCutter''' (UseNativeCutter)
|
|
This property specifies the input dataset for which to display the time.
This property specifies whether the ParaView's generic
 
dataset cutter is used instead of the specialized AMR
cutter.
|
0
|
Accepts boolean values (0 or 1).
|-
|'''LevelOfResolution''' (LevelOfResolution)
|
Set maximum slice resolution.
|
|
0
|
|
The selected object must be the result of the following: sources (includes readers), filters.


|-
|-
| '''Scale'''<br>''(Scale)''
|'''Center''' (Center)
|
|
The factor by which the input time is scaled.


| 1
|
|
0.5 0.5 0.5
|
|-
|-
| '''Shift'''<br>''(Shift)''
|'''Normal''' (Normal)
|
|
The amount of time the input is shifted (after scaling).


| 0
|
|
|}
0 0 1
|




==Append Attributes==
|}


==AMR Dual Clip==


Copies geometry from first input.  Puts all of the arrays into the output.
Clip with scalars. Tetrahedra.
 
The Append Attributes filter takes multiple input data sets with the same geometry and merges their point and cell attributes to produce a single output containing all the point and cell attributes of the inputs. Any inputs without the same number of points and cells as the first input are ignored. The input data sets must already be collected together, either as a result of a reader that loads multiple parts (e.g., EnSight reader) or because the Group Parts filter has been run to form a collection of data sets.<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 247: Line 231:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
This property specifies the input of the
filter.
|
|
This property specifies the input to the Append Attributes filter.


|
|
|
Accepts input of following types:
The selected object must be the result of the following: sources (includes readers), filters.
* vtkCompositeDataSet
The dataset must contain a field array (cell)


with 1 component(s).


The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.
|-
|'''SelectMaterialArrays''' (SelectMaterialArrays)
|
This property specifies the cell arrays from which the
clip filter will compute clipped cells.
|


|
An array of scalars is required.
|-
|'''Volume Fraction Value''' (VolumeFractionSurfaceValue)
|
This property specifies the values at which to compute
the isosurface.
|
0.1
|
|-
|'''InternalDecimation''' (InternalDecimation)
|
If this property is on, internal tetrahedra are
decimation
|
1
|
Accepts boolean values (0 or 1).
|-
|'''MultiprocessCommunication''' (MultiprocessCommunication)
|
If this property is off, each process executes
independantly.
|
1
|
Accepts boolean values (0 or 1).
|-
|'''MergePoints''' (MergePoints)
|
Use more memory to merge points on the boundaries of
blocks.
|
1
|
Accepts boolean values (0 or 1).


|}
|}


==AMR Fragment Integration==


==Append Datasets==
Fragment Integration
 
 
Takes an input of multiple datasets and output has only one unstructured grid.
 
The Append Datasets filter operates on multiple data sets of any type (polygonal, structured, etc.). It merges their geometry into a single data set. Only the point and cell attributes that all of the input data sets have in common will appear in the output. The input data sets must already be collected together, either as a result of a reader that loads multiple parts (e.g., EnSight reader) or because the Group Parts filter has been run to form a collection of data sets.<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 276: Line 304:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
This property specifies the volume input of the
filter.
|
|
This property specifies the datasets to be merged into a single dataset by the Append Datasets filter.


|
|
|
Accepts input of following types:
The selected object must be the result of the following: sources (includes readers), filters.
* vtkNonOverlappingAMR
The dataset must contain a field array (cell)


with 1 component(s).


The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.
|-
|'''SelectMaterialArrays''' (SelectMaterialArrays)
|
This property specifies the cell arrays from which the
analysis will determine fragments
|


|
An array of scalars is required.
|-
|'''SelectMassArrays''' (SelectMassArrays)
|
This property specifies the cell arrays from which the
analysis will determine fragment mass
|


|}
|
An array of scalars is required.
|-
|'''SelectVolumeWeightedArrays''' (SelectVolumeWeightedArrays)
|
This property specifies the cell arrays from which the
analysis will determine volume weighted average values
|


|
An array of scalars is required.
|-
|'''SelectMassWeightedArrays''' (SelectMassWeightedArrays)
|
This property specifies the cell arrays from which the
analysis will determine mass weighted average values
|


==Append Geometry==
|
An array of scalars is required.


|}


Takes an input of multiple poly data parts and output has only one part.
==AMR Fragments Filter==


The Append Geometry filter operates on multiple polygonal data sets. It merges their geometry into a single data set. Only the point and cell attributes that all of the input data sets have in common will appear in the output.<br>
Meta Fragment filterCombines the running of
AMRContour, AMRFragmentIntegration, AMRDualContour and ExtractCTHParts


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 305: Line 369:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
This property specifies the volume input of the
filter.
|
|
Set the input to the Append Geometry filter.


|
|
Accepts input of following types:
* vtkNonOverlappingAMR
The dataset must contain a field array (cell)
with 1 component(s).
|-
|'''SelectMaterialArrays''' (SelectMaterialArrays)
|
This property specifies the cell arrays from which the
analysis will determine fragments
|
|
The selected object must be the result of the following: sources (includes readers), filters.


|
An array of scalars is required.
|-
|'''SelectMassArrays''' (SelectMassArrays)
|
This property specifies the cell arrays from which the
analysis will determine fragment mass
|


The selected dataset must be one of the following types (or a subclass of one of them): vtkPolyData.
|
An array of scalars is required.
|-
|'''SelectVolumeWeightedArrays''' (SelectVolumeWeightedArrays)
|
This property specifies the cell arrays from which the
analysis will determine volume weighted average values
|


|
An array of scalars is required.
|-
|'''SelectMassWeightedArrays''' (SelectMassWeightedArrays)
|
This property specifies the cell arrays from which the
analysis will determine mass weighted average values
|


|}
|
An array of scalars is required.
|-
|'''Volume Fraction Value''' (VolumeFractionSurfaceValue)
|
This property specifies the values at which to compute
the isosurface.
|
0.1
|


|-
|'''Extract Surface''' (Extract Surface)
|
Whether or not to extract a surface from this data
|
0
|
Accepts boolean values (0 or 1).
|-
|'''Use Watertight Surface''' (Use Watertight Surface)
|
Whether the extracted surface should be watertight or not
|
0
|
Accepts boolean values (0 or 1).
|-
|'''Integrate Fragments''' (Integrate Fragments)
|
Whether or not to integrate fragments in this data
|
1
|
Accepts boolean values (0 or 1).


==Block Scalars==
|}


==Add Field Arrays==


The Level Scalars filter uses colors to show levels of a multiblock dataset.
Reads arrays from a file and adds them to the input data object.
Takes in an input data object and a filename. Opens the file
and adds any arrays it sees there to the input data.


The Level Scalars filter uses colors to show levels of a multiblock dataset.<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 334: Line 469:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
The input.
|
|
This property specifies the input to the Level Scalars filter.


|
|
|-
|'''FileName''' (FileName)
|
|
The selected object must be the result of the following: sources (includes readers), filters.


This property specifies the file to read to get arrays


The selected dataset must be one of the following types (or a subclass of one of them): vtkMultiBlockDataSet.
|


|
The value(s) must be a filename (or filenames).


|}
|}


==Angular Periodic Filter==


==Calculator==
This filter generate a periodic multiblock dataset.This filter generate a periodic
 
multiblock dataset


Compute new attribute arrays as function of existing arrays.
{| class="PropertiesTable" border="1" cellpadding="5"
 
|-
The Calculator filter computes a new data array or new point coordinates as a function of existing scalar or vector arrays. If point-centered arrays are used in the computation of a new data array, the resulting array will also be point-centered. Similarly, computations using cell-centered arrays will produce a new cell-centered array. If the function is computing point coordinates, the result of the function must be a three-component vector. The Calculator interface operates similarly to a scientific calculator. In creating the function to evaluate, the standard order of operations applies.<br>
Each of the calculator functions is described below. Unless otherwise noted, enclose the operand in parentheses using the ( and ) buttons.<br>
Clear: Erase the current function (displayed in the read-only text box above the calculator buttons).<br>
/: Divide one scalar by another. The operands for this function are not required to be enclosed in parentheses.<br>
*: Multiply two scalars, or multiply a vector by a scalar (scalar multiple). The operands for this function are not required to be enclosed in parentheses.<br>
-: Negate a scalar or vector (unary minus), or subtract one scalar or vector from another. The operands for this function are not required to be enclosed in parentheses.<br>
+: Add two scalars or two vectors. The operands for this function are not required to be enclosed in parentheses.<br>
sin: Compute the sine of a scalar.<br>
cos: Compute the cosine of a scalar.<br>
tan: Compute the tangent of a scalar.<br>
asin: Compute the arcsine of a scalar.<br>
acos: Compute the arccosine of a scalar.<br>
atan: Compute the arctangent of a scalar.<br>
sinh: Compute the hyperbolic sine of a scalar.<br>
cosh: Compute the hyperbolic cosine of a scalar.<br>
tanh: Compute the hyperbolic tangent of a scalar.<br>
min: Compute minimum of two scalars.<br>
max: Compute maximum of two scalars.<br>
x^y: Raise one scalar to the power of another scalar. The operands for this function are not required to be enclosed in parentheses.<br>
sqrt: Compute the square root of a scalar.<br>
e^x: Raise e to the power of a scalar.<br>
log: Compute the logarithm of a scalar (deprecated. same as log10).<br>
log10: Compute the logarithm of a scalar to the base 10.<br>
ln: Compute the logarithm of a scalar to the base 'e'.<br>
ceil: Compute the ceiling of a scalar.<br>
floor: Compute the floor of a scalar.<br>
abs: Compute the absolute value of a scalar.<br>
v1.v2: Compute the dot product of two vectors. The operands for this function are not required to be enclosed in parentheses.<br>
cross: Compute cross product of two vectors.<br>
mag: Compute the magnitude of a vector.<br>
norm: Normalize a vector.<br>
The operands are described below.<br>
The digits 0 - 9 and the decimal point are used to enter constant scalar values.<br>
iHat, jHat, and kHat are vector constants representing unit vectors in the X, Y, and Z directions, respectively.<br>
The scalars menu lists the names of the scalar arrays and the components of the vector arrays of either the point-centered or cell-centered data. The vectors menu lists the names of the point-centered or cell-centered vector arrays. The function will be computed for each point (or cell) using the scalar or vector value of the array at that point (or cell).<br>
The filter operates on any type of data set, but the input data set must have at least one scalar or vector array. The arrays can be either point-centered or cell-centered. The Calculator filter's output is of the same data set type as the input.<br>
 
{| class="PropertiesTable" border="1" cellpadding="5"
|-
| '''Property'''
| '''Property'''
| '''Description'''
| '''Description'''
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Attribute Mode'''<br>''(AttributeMode)''
|'''Input''' (Input)
|
|
This property determines whether the computation is to be performed on point-centered or cell-centered data.
This property specifies the input to the Periodic filter.


| 0
|
|
The value must be one of the following: point_data (1), cell_data (2), field_data (5).


|
Accepts input of following types:
* vtkDataSet
|-
|-
| '''Coordinate Results'''<br>''(CoordinateResults)''
|'''BlockIndices''' (BlockIndices)
|
This property lists the ids of the blocks to make periodic
from the input multiblock dataset.
|
|
The value of this property determines whether the results of this computation should be used as point coordinates or as a new array.


| 0
|
|
Only the values 0 and 1 are accepted.


|-
|'''IterationMode''' (IterationMode)
|
This property specifies the mode of iteration, either a user-provided number
of periods, or the maximum number of periods to rotate to 360°.
|
1
|
The value(s) is an enumeration of the following:
* Manual (0)
* Maximum (1)
|-
|'''NumberOfPeriods''' (NumberOfPeriods)
|
This property specifies the number of iteration
|
3
|


|-
|-
| '''Function'''<br>''(Function)''
|'''RotationMode''' (RotationMode)
|
|
This property contains the equation for computing the new array.
This property specifies the mode of rotation, either from a user provided
 
angle or from an array in the data.
|
|
0
|
|
The value(s) is an enumeration of the following:
* Direct Angle (0)
* Array Value (1)
|-
|-
| '''Input'''<br>''(Input)''
|'''RotationAngle''' (RotationAngle)
|
|
This property specifies the input dataset to the Calculator filter. The scalar and vector variables may be chosen from this dataset's arrays.
Rotation angle in degree.


|
|
10
|
|
The selected object must be the result of the following: sources (includes readers), filters.
The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.


|-
|-
| '''Replace Invalid Results'''<br>''(ReplaceInvalidValues)''
|'''RotationArrayName''' (RotationArrayName)
|
|
This property determines whether invalid values in the computation will be replaced with a specific value. (See the ReplacementValue property.)
Field array name that contains the rotation angle in radian.


| 1
|
|
Only the values 0 and 1 are accepted.
periodic angle
 
|


|-
|-
| '''Replacement Value'''<br>''(ReplacementValue)''
|'''Axis''' (Axis)
|
|
If invalid values in the computation are to be replaced with another value, this property contains that value.
This property specifies the axis of rotation
 
|
| 0
0
|
|
The value(s) is an enumeration of the following:
* Axis X (0)
* Axis Y (1)
* Axis Z (2)
|-
|-
| '''Result Array Name'''<br>''(ResultArrayName)''
|'''Center''' (Center)
|
|
This property contains the name for the output array containing the result of this computation.
This property specifies the 3D coordinates for the
 
center of the rotation.
| Result
|
0.0 0.0 0.0
|
|
|}




==Cell Centers==
|}


==Annotate Attribute Data==


Create a point (no geometry) at the center of each input cell.
Adds a text annotation to a Rander View
This filter can be used to add a text annotation to a Render View (or
similar) using a tuple from any attribute array (point/cell/field/row
etc.) from a specific rank (when running in parallel). Use **ArrayName**
property to select the array association and array name. Use
**ElementId* property to set the element number to extract the value to
label with. When running on multiple ranks, use **ProcessId** property
to select the rank of interest. The **Prefix** property can be used to
specify a string that will be used as the prefix to the generated
annotation text.


The Cell Centers filter places a point at the center of each cell in the input data set. The center computed is the parametric center of the cell, not necessarily the geometric or bounding box center. The cell attributes of the input will be associated with these newly created points of the output. You have the option of creating a vertex cell per point in the outpuut. This is useful because vertex cells are rendered, but points are not. The points themselves could be used for placing glyphs (using the Glyph filter). The Cell Centers filter takes any type of data set as input and produces a polygonal data set as output.<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 478: Line 613:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
|
This property specifies the input to the Cell Centers filter.
 
Set the input of the filter. To avoid the complications/confusion when identifying
elements in a composite dataset, this filter doesn't support composite datasets
currently.


|
|
|
|
The selected object must be the result of the following: sources (includes readers), filters.
Accepts input of following types:
 
* vtkDataSet
 
* vtkTable
The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.
The dataset must contain a field array (any)


with 1 component(s).


|-
|-
| '''Vertex Cells'''<br>''(VertexCells)''
|'''ArrayAssociation''' (ArrayAssociation)
|
Select the attribute to use to popular array names from.
|
2
|
The value(s) is an enumeration of the following:
* Point Data (0)
* Cell Data (1)
* Field Data (2)
* Row Data (6)
|-
|'''ArrayName''' (ArrayName)
|
Choose arrays that is going to be displayed
|
|
If set to 1, a vertex cell will be generated per point in the output. Otherwise only points will be generated.


| 0
|
|
Only the values 0 and 1 are accepted.


|-
|'''ElementId''' (ElementId)
|


|}
Set the element index to annotate with.


|
0
|


==Cell Data to Point Data==
|-
|'''ProcessId''' (ProcessId)
|


Set the process rank to extract element from.


Create point attributes by averaging cell attributes.
|
0
|
 
|-
|'''Prefix''' (Prefix)
|
Text that is used as a prefix to the field value
|
Value is:
|
 
 
|}
 
==Annotate Global Data==
 
Filter for annotating with global data (designed for ExodusII reader)
Annotate Global Data provides a simpler API for creating text
annotations using vtkPythonAnnotationFilter. Instead of users
specifying the annotation expression, this filter determines the
expression based on the array selected by limiting the scope of the
functionality. This filter only allows the user to annotate using
"global-data" aka field data and specify the string prefix to use. If
the field array chosen has as many elements as number of timesteps,
the array is assumed to be "temporal" and indexed using the current
timestep.


The Cell Data to Point Data filter averages the values of the cell attributes of the cells surrounding a point to compute point attributes. The Cell Data to Point Data filter operates on any type of data set, and the output data set is of the same type as the input.<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 517: Line 703:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
Set the input of the filter.
|
|
This property specifies the input to the Cell Data to Point Data filter.


|
|
|
Accepts input of following types:
The selected object must be the result of the following: sources (includes readers), filters.
* vtkDataSet
The dataset must contain a field array (none)


with 1 component(s).


The dataset must contain a cell array.
|-
 
|'''SelectArrays''' (SelectArrays)
 
|
The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.
Choose arrays that is going to be
displayed
|


|


|-
|-
| '''Pass Cell Data'''<br>''(PassCellData)''
|'''Prefix''' (Prefix)
|
|
If this property is set to 1, then the input cell data is passed through to the output; otherwise, only the generated point data will be available in the output.
Text that is used as a prefix to the field
 
value
| 0
|
Value is:
|
|
Only the values 0 and 1 are accepted.


|-
|-
| '''Piece Invariant'''<br>''(PieceInvariant)''
|'''Suffix''' (Suffix)
|
Text that is used as a suffix to the field
value
|
|
If the value of this property is set to 1, this filter will request ghost levels so that the values at boundary points match across processes. NOTE: Enabling this option might cause multiple executions of the data source because more information is needed to remove internal surfaces.


| 0
|
|
Only the values 0 and 1 are accepted.




|}
|}


==Annotate Time Filter==


==Clean==
Shows input data time as text annnotation in the view.The Annotate Time
 
filter can be used to show the data time in a text
 
annotation.
Merge coincident points if they do not meet a feature edge criteria.
 
The Clean filter takes polygonal data as input and generates polygonal data as output. This filter can merge duplicate points, remove unused points, and transform degenerate cells into their appropriate forms (e.g., a triangle is converted into a line if two of its points are merged).<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 569: Line 759:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Absolute Tolerance'''<br>''(AbsoluteTolerance)''
|'''Input''' (Input)
|
This property specifies the input dataset for which to
display the time.
|
|
If merging nearby points (see PointMerging property) and using absolute tolerance (see ToleranceIsAbsolute property), this property specifies the tolerance for performing merging in the spatial units of the input data set.


| 1
|
|
The value must be greater than or equal to 0.


|-
|-
| '''Convert Lines To Points'''<br>''(ConvertLinesToPoints)''
|'''Format''' (Format)
|
|
If this property is set to 1, degenerate lines (a "line" whose endpoints are at the same spatial location) will be converted to points.
The value of this property is a format string used to
 
display the input time. The format string is specified using printf
| 1
style.
|
Time: %f
|
|
Only the values 0 and 1 are accepted.


|-
|-
| '''Convert Polys To Lines'''<br>''(ConvertPolysToLines)''
|'''Shift''' (Shift)
|
The amount of time the input is shifted (after
scaling).
|
|
If this property is set to 1, degenerate polygons (a "polygon" with only two distinct point coordinates) will be converted to lines.
0.0
 
| 1
|
|
Only the values 0 and 1 are accepted.


|-
|-
| '''Convert Strips To Polys'''<br>''(ConvertStripsToPolys)''
|'''Scale''' (Scale)
|
|
If this property is set to 1, degenerate triangle strips (a triangle "strip" containing only one triangle) will be converted to triangles.
The factor by which the input time is
 
scaled.
| 1
|
|
Only the values 0 and 1 are accepted.
1.0
 
 
|-
| '''Input'''<br>''(Input)''
|
|
Set the input to the Clean filter.


|
|
The selected object must be the result of the following: sources (includes readers), filters.


|}


The selected dataset must be one of the following types (or a subclass of one of them): vtkPolyData.
==Append Attributes==


Copies geometry from first input. Puts all of the arrays into the output.
The Append Attributes filter takes multiple input data
sets with the same geometry and merges their point and
cell attributes to produce a single output containing all
the point and cell attributes of the inputs. Any inputs
without the same number of points and cells as the first
input are ignored. The input data sets must already be
collected together, either as a result of a reader that
loads multiple parts (e.g., EnSight reader) or because the
Group Parts filter has been run to form a collection of
data sets.


{| class="PropertiesTable" border="1" cellpadding="5"
|-
|-
| '''Piece Invariant'''<br>''(PieceInvariant)''
| '''Property'''
|
| '''Description'''
If this property is set to 1, the whole data set will be processed at once so that cleaning the data set always produces the same results. If it is set to 0, the data set can be processed one piece at a time, so it is not necessary for the entire data set to fit into memory; however the results are not guaranteed to be the same as they would be if the Piece invariant option was on. Setting this option to 0 may produce seams in the output dataset when ParaView is run in parallel.
| '''Default Value(s)'''
 
| '''Restrictions'''
| 1
|
Only the values 0 and 1 are accepted.
 


|-
|-
| '''Point Merging'''<br>''(PointMerging)''
|'''Input''' (Input)
|
This property specifies the input to the Append
Attributes filter.
|
|
If this property is set to 1, then points will be merged if they are within the specified Tolerance or AbsoluteTolerance (see the Tolerance and AbsoluteTolerance propertys), depending on the value of the ToleranceIsAbsolute property. (See the ToleranceIsAbsolute property.) If this property is set to 0, points will not be merged.


| 1
|
|
Only the values 0 and 1 are accepted.
Accepts input of following types:
* vtkDataSet


|}


|-
==Append Datasets==
| '''Tolerance'''<br>''(Tolerance)''
|
If merging nearby points (see PointMerging property) and not using absolute tolerance (see ToleranceIsAbsolute property), this property specifies the tolerance for performing merging as a fraction of the length of the diagonal of the bounding box of the input data set.


| 0
Takes an input of multiple datasets and output has only one unstructured grid.The Append
|
Datasets filter operates on multiple data sets of any type
The value must be greater than or equal to 0 and less than or equal to 1.
(polygonal, structured, etc.). It merges their geometry
into a single data set. Only the point and cell attributes
that all of the input data sets have in common will appear
in the output. The input data sets must already be
collected together, either as a result of a reader that
loads multiple parts (e.g., EnSight reader) or because the
Group Parts filter has been run to form a collection of
data sets.


{| class="PropertiesTable" border="1" cellpadding="5"
|-
| '''Property'''
| '''Description'''
| '''Default Value(s)'''
| '''Restrictions'''


|-
|-
| '''Tolerance Is Absolute'''<br>''(ToleranceIsAbsolute)''
|'''Input''' (Input)
|
This property specifies the datasets to be merged into a
single dataset by the Append Datasets filter.
|
|
This property determines whether to use absolute or relative (a percentage of the bounding box) tolerance when performing point merging.


| 0
|
|
Only the values 0 and 1 are accepted.
Accepts input of following types:
 
* vtkDataSet


|}
|}


==Append Geometry==


==Clean Cells to Grid==
Takes an input of multiple poly data parts and output has only one part.The Append
 
Geometry filter operates on multiple polygonal data sets.
 
It merges their geometry into a single data set. Only the
This filter merges cells and converts the data set to unstructured grid.
point and cell attributes that all of the input data sets
 
have in common will appear in the output.
Merges degenerate cells. Assumes the input grid does not contain duplicate<br>
points. You may want to run vtkCleanUnstructuredGrid first to assert it. If<br>
duplicated cells are found they are removed in the output. The filter also<br>
handles the case, where a cell may contain degenerate nodes (i.e. one and<br>
the same node is referenced by a cell more than once).<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 682: Line 881:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
Set the input to the Append Geometry
filter.
|
|
This property specifies the input to the Clean Cells to Grid filter.


|
|
|
Accepts input of following types:
The selected object must be the result of the following: sources (includes readers), filters.
* vtkPolyData
 
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkUnstructuredGrid.
 


|}
|}


==Block Scalars==


==Clean to Grid==
The Level Scalars filter uses colors to show levels of a multiblock dataset.The Level
 
Scalars filter uses colors to show levels of a multiblock
 
dataset.
This filter merges points and converts the data set to unstructured grid.
 
The Clean to Grid filter merges points that are exactly coincident. It also converts the data set to an unstructured grid. You may wish to do this if you want to apply a filter to your data set that is available for unstructured grids but not for the initial type of your data set (e.g., applying warp vector to volumetric data). The Clean to Grid filter operates on any type of data set.<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 711: Line 907:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
This property specifies the input to the Level Scalars
filter.
|
|
This property specifies the input to the Clean to Grid filter.


|
|
|
Accepts input of following types:
The selected object must be the result of the following: sources (includes readers), filters.
* vtkMultiBlockDataSet
 
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.
 


|}
|}


==CTH Surface==


==Clip==
Not finished yet.
 
 
Clip with an implicit plane. Clipping does not reduce the dimensionality of the data set. The output data type of this filter is always an unstructured grid.
 
The Clip filter cuts away a portion of the input data set using an implicit plane. This filter operates on all types of data sets, and it returns unstructured grid data on output.<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 740: Line 931:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Clip Type'''<br>''(ClipFunction)''
|'''Input''' (Input)
|
This property specifies the input of the
filter.
|
|
This property specifies the parameters of the clip function (an implicit plane) used to clip the dataset.


|
|
|
Accepts input of following types:
The value must be set to one of the following: Plane, Box, Sphere, Scalar.
* vtkCompositeDataSet


|}


|-
==CacheKeeper==
| '''Input'''<br>''(Input)''
|
This property specifies the dataset on which the Clip filter will operate.


|
vtkPVCacheKeeper manages data cache for flip book
|
animations. When caching is disabled, this simply acts as a pass through
The selected object must be the result of the following: sources (includes readers), filters.
filter. When caching is enabled, is the current time step has been
 
previously cached then this filter shuts the update request, otherwise
 
propagates the update and then cache the result for later use. The
The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.
current time step is set using SetCacheTime().


{| class="PropertiesTable" border="1" cellpadding="5"
|-
| '''Property'''
| '''Description'''
| '''Default Value(s)'''
| '''Restrictions'''


|-
|-
| '''Inside Out'''<br>''(InsideOut)''
|'''Input''' (Input)
|
Set the input to the Update Suppressor
filter.
|
|
If this property is set to 0, the clip filter will return that portion of the dataset that lies within the clip function. If set to 1, the portions of the dataset that lie outside the clip function will be returned instead.


| 0
|
|
Only the values 0 and 1 are accepted.


|-
|-
| '''Scalars'''<br>''(SelectInputScalars)''
|'''CacheTime''' (CacheTime)
|
|
If clipping with scalars, this property specifies the name of the scalar array on which to perform the clip operation.


|
|
0.0
|
|
An array of scalars is required.
Valud array names will be chosen from point and cell data.


|-
|-
| '''Use Value As Offset'''<br>''(UseValueAsOffset)''
|'''CachingEnabled''' (CachingEnabled)
|
|
If UseValueAsOffset is true, Value is used as an offset parameter to the implicit function. Otherwise, Value is used only when clipping using a scalar array.
Toggle whether the caching is enabled.
 
| 0
|
|
Only the values 0 and 1 are accepted.
1
 
 
|-
| '''Value'''<br>''(Value)''
|
|
If clipping with scalars, this property sets the scalar value about which to clip the dataset based on the scalar array chosen. (See SelectInputScalars.) If clipping with a clip function, this property specifies an offset from the clip function to use in the clipping operation. Neither functionality is currently available in ParaView's user interface.
Accepts boolean values (0 or 1).
 
| 0
|
The value must lie within the range of the selected data array.
 


|}
|}


==Calculator==


==Clip Closed Surface==
Compute new attribute arrays as function of existing arrays.
The Calculator filter computes a new data array or new point
coordinates as a function of existing scalar or vector arrays. If
point-centered arrays are used in the computation of a new data array,
the resulting array will also be point-centered. Similarly,
computations using cell-centered arrays will produce a new
cell-centered array. If the function is computing point coordinates,
the result of the function must be a three-component vector.


The Calculator interface operates similarly to a scientific
calculator. In creating the function to evaluate, the standard order
of operations applies. Each of the calculator functions is described
below. Unless otherwise noted, enclose the operand in parentheses
using the ( and ) buttons.


Clip a polygonal dataset with a plane to produce closed surfaces
- Clear: Erase the current function (displayed in the read-only text
box above the calculator buttons).
- /: Divide one scalar by another. The operands for this function are
not required to be enclosed in parentheses.
- *: Multiply two scalars, or multiply a vector by a scalar (scalar multiple).
The operands for this function are not required to be enclosed in parentheses.
- -: Negate a scalar or vector (unary minus), or subtract one scalar or vector
from another. The operands for this function are not required to be enclosed
in parentheses.
- +: Add two scalars or two vectors. The operands for this function are not
required to be enclosed in parentheses.
- sin: Compute the sine of a scalar. cos: Compute the cosine of a scalar.
- tan: Compute the tangent of a scalar.
- asin: Compute the arcsine of a scalar.
- acos: Compute the arccosine of a scalar.
- atan: Compute the arctangent of a scalar.
- sinh: Compute the hyperbolic sine of a scalar.
- cosh: Compute the hyperbolic cosine of a scalar.
- tanh: Compute the hyperbolic tangent of a scalar.
- min: Compute minimum of two scalars.
- max: Compute maximum of two scalars.
- x^y: Raise one scalar to the power of another scalar. The operands for
this function are not required to be enclosed in parentheses.
- sqrt: Compute the square root of a scalar.
- e^x: Raise e to the power of a scalar.
- log: Compute the logarithm of a scalar (deprecated. same as log10).
- log10: Compute the logarithm of a scalar to the base 10.
- ln: Compute the logarithm of a scalar to the base 'e'.
- ceil: Compute the ceiling of a scalar. floor: Compute the floor of a scalar.
- abs: Compute the absolute value of a scalar.
- v1.v2: Compute the dot product of two vectors. The operands for this
function are not required to be enclosed in parentheses.
- cross: Compute cross product of two vectors.
- mag: Compute the magnitude of a vector.
- norm: Normalize a vector.


This clip filter cuts away a portion of the input polygonal dataset using a plane to generate a new polygonal dataset.<br>
The operands are described below. The digits 0 - 9 and the decimal
point are used to enter constant scalar values. **iHat**, **jHat**,
and **kHat** are vector constants representing unit vectors in the X,
Y, and Z directions, respectively. The scalars menu lists the names of
the scalar arrays and the components of the vector arrays of either
the point-centered or cell-centered data. The vectors menu lists the
names of the point-centered or cell-centered vector arrays. The
function will be computed for each point (or cell) using the scalar or
vector value of the array at that point (or cell). The filter operates
on any type of data set, but the input data set must have at least one
scalar or vector array. The arrays can be either point-centered or
cell-centered. The Calculator filter's output is of the same data set
type as the input.


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 822: Line 1,062:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Base Color'''<br>''(BaseColor)''
|'''Input''' (Input)
|
This property specifies the input dataset to the
Calculator filter. The scalar and vector variables may be chosen from
this dataset's arrays.
|
|
Specify the color for the faces from the input.


| 0.1 0.1 1
|
|
The value must be greater than or equal to (0, 0, 0) and less than or equal to (1, 1, 1).
Accepts input of following types:
 
* vtkDataSet
The dataset must contain a field array ()


|-
|-
| '''Clip Color'''<br>''(ClipColor)''
|'''AttributeMode''' (AttributeMode)
|
|
Specifiy the color for the capping faces (generated on the clipping interface).
This property determines whether the computation is to
 
be performed on point-centered or cell-centered data.
| 1 0.11 0.1
|
1
|
|
The value must be greater than or equal to (0, 0, 0) and less than or equal to (1, 1, 1).
The value(s) is an enumeration of the following:
 
* Point Data (1)
 
* Cell Data (2)
|-
|-
| '''Clipping Plane'''<br>''(ClippingPlane)''
|'''CoordinateResults''' (CoordinateResults)
|
|
This property specifies the parameters of the clipping plane used to clip the polygonal data.
The value of this property determines whether the
 
results of this computation should be used as point coordinates or as a
new array.
|
|
0
|
|
The value must be set to one of the following: Plane.
Accepts boolean values (0 or 1).
 
 
|-
|-
| '''Generate Cell Origins'''<br>''(GenerateColorScalars)''
|'''ResultNormals''' (ResultNormals)
|
|
Generate (cell) data for coloring purposes such that the newly generated cells (including capping faces and clipping outlines) can be distinguished from the input cells.
Set whether to output results as point/cell
 
normals. Outputing as normals is only valid with vector
| 0
results. Point or cell normals are selected using
AttributeMode.
|
0
|
|
Only the values 0 and 1 are accepted.
Accepts boolean values (0 or 1).
 
 
|-
|-
| '''Generate Faces'''<br>''(GenerateFaces)''
|'''ResultTCoords''' (ResultTCoords)
|
Set whether to output results as point/cell
texture coordinates. Point or cell texture coordinates are
selected using AttributeMode. 2-component texture coordinates
cannot be generated at this time.
|
|
Generate polygonal faces in the output.
0
 
| 1
|
|
Only the values 0 and 1 are accepted.
Accepts boolean values (0 or 1).
 
 
|-
|-
| '''Generate Outline'''<br>''(GenerateOutline)''
|'''ResultArrayName''' (ResultArrayName)
|
This property contains the name for the output array
containing the result of this computation.
|
Result
|
|
Generate clipping outlines in the output wherever an input face is cut by the clipping plane.


| 0
|-
|'''Function''' (Function)
|
|
Only the values 0 and 1 are accepted.


This property contains the equation for computing the new
array.


|-
| '''Input'''<br>''(Input)''
|
|
This property specifies the dataset on which the Clip filter will operate.


|
|
|
The selected object must be the result of the following: sources (includes readers), filters.
The selected dataset must be one of the following types (or a subclass of one of them): vtkPolyData.


|-
|-
| '''Inside Out'''<br>''(InsideOut)''
|'''Replace Invalid Results''' (ReplaceInvalidValues)
|
|
If this flag is turned off, the clipper will return the portion of the data that lies within the clipping plane. Otherwise, the clipper will return the portion of the data that lies outside the clipping plane.
This property determines whether invalid values in the
 
computation will be replaced with a specific value. (See the
| 0
ReplacementValue property.)
|
1
|
|
Only the values 0 and 1 are accepted.
Accepts boolean values (0 or 1).
 
 
|-
|-
| '''Clipping Tolerance'''<br>''(Tolerance)''
|'''ReplacementValue''' (ReplacementValue)
|
|
Specify the tolerance for creating new points. A small value might incur degenerate triangles.
If invalid values in the computation are to be replaced
 
with another value, this property contains that value.
| 1e-06
|
0.0
|
|
|}




==Clip Generic Dataset==
|}


==Cell Centers==


Clip with an implicit plane, sphere or with scalars. Clipping does not reduce the dimensionality of the data set. This output data type of this filter is always an unstructured grid.
Create a point (no geometry) at the center of each input cell.The Cell Centers
 
filter places a point at the center of each cell in the
The Generic Clip filter cuts away a portion of the input data set using a plane, a sphere, a box, or a scalar value. The menu in the Clip Function portion of the interface allows the user to select which implicit function to use or whether to clip using a scalar value. Making this selection loads the appropriate user interface. For the implicit functions, the appropriate 3D widget (plane, sphere, or box) is also displayed. The use of these 3D widgets, including their user interface components, is discussed in section 7.4.<br>
input data set. The center computed is the parametric
If an implicit function is selected, the clip filter returns that portion of the input data set that lies inside the function. If Scalars is selected, then the user must specify a scalar array to clip according to. The clip filter will return the portions of the data set whose value in the selected Scalars array is larger than the Clip value. Regardless of the selection from the Clip Function menu, if the Inside Out option is checked, the opposite portions of the data set will be returned.<br>
center of the cell, not necessarily the geometric or
This filter operates on all types of data sets, and it returns unstructured grid data on output.<br>
bounding box center. The cell attributes of the input will
be associated with these newly created points of the
output. You have the option of creating a vertex cell per
point in the outpuut. This is useful because vertex cells
are rendered, but points are not. The points themselves
could be used for placing glyphs (using the Glyph filter).
The Cell Centers filter takes any type of data set as
input and produces a polygonal data set as
output.


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 930: Line 1,183:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Clip Type'''<br>''(ClipFunction)''
|'''Input''' (Input)
|
This property specifies the input to the Cell Centers
filter.
|
|
Set the parameters of the clip function.


|
|
|
Accepts input of following types:
The value must be set to one of the following: Plane, Box, Sphere, Scalar.
* vtkDataSet
 
 
|-
|-
| '''Input'''<br>''(Input)''
|'''VertexCells''' (VertexCells)
|
|
Set the input to the Generic Clip filter.
If set to 1, a vertex cell will be generated per point
 
in the output. Otherwise only points will be generated.
|
|
0
|
|
The selected object must be the result of the following: sources (includes readers), filters.
Accepts boolean values (0 or 1).


|}


The selected dataset must be one of the following types (or a subclass of one of them): vtkGenericDataSet.
==Cell Data to Point Data==


Create point attributes by averaging cell attributes.The Cell
Data to Point Data filter averages the values of the cell
attributes of the cells surrounding a point to compute
point attributes. The Cell Data to Point Data filter
operates on any type of data set, and the output data set
is of the same type as the input.


{| class="PropertiesTable" border="1" cellpadding="5"
|-
|-
| '''Inside Out'''<br>''(InsideOut)''
| '''Property'''
| '''Description'''
| '''Default Value(s)'''
| '''Restrictions'''
 
|-
|'''Input''' (Input)
|
This property specifies the input to the Cell Data to
Point Data filter.
|
|
Choose which portion of the dataset should be clipped away.


| 0
|
|
Only the values 0 and 1 are accepted.
Accepts input of following types:
 
* vtkDataSet
The dataset must contain a field array (cell)


|-
|-
| '''Scalars'''<br>''(SelectInputScalars)''
|'''PassCellData''' (PassCellData)
|
|
If clipping with scalars, this property specifies the name of the scalar array on which to perform the clip operation.
If this property is set to 1, then the input cell data
 
is passed through to the output; otherwise, only the generated point
data will be available in the output.
|
|
0
|
|
An array of scalars is required.
Accepts boolean values (0 or 1).
 
 
Valud array names will be chosen from point and cell data.
 
 
|-
|-
| '''Value'''<br>''(Value)''
|'''PieceInvariant''' (PieceInvariant)
|
|
If clipping with a scalar array, choose the clipping value.
If the value of this property is set to 1, this filter
 
will request ghost levels so that the values at boundary points match
| 0
across processes. NOTE: Enabling this option might cause multiple
executions of the data source because more information is needed to
remove internal surfaces.
|
0
|
|
The value must lie within the range of the selected data array.
Accepts boolean values (0 or 1).
 


|}
|}


==Clean==


==Compute Derivatives==
Merge coincident points if they do not meet a feature edge criteria.The Clean filter
 
takes polygonal data as input and generates polygonal data
 
as output. This filter can merge duplicate points, remove
This filter computes derivatives of scalars and vectors.
unused points, and transform degenerate cells into their
 
appropriate forms (e.g., a triangle is converted into a
CellDerivatives is a filter that computes derivatives of scalars and vectors at the center of cells. You can choose to generate different output including the scalar gradient (a vector), computed tensor vorticity (a vector), gradient of input vectors (a tensor), and strain matrix of the input vectors (a tensor); or you may choose to pass data through to the output.<br>
line if two of its points are merged).


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 1,002: Line 1,274:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
Set the input to the Clean filter.
|
|
This property specifies the input to the filter.


|
|
Accepts input of following types:
* vtkPolyData
|-
|'''PieceInvariant''' (PieceInvariant)
|
If this property is set to 1, the whole data set will be
processed at once so that cleaning the data set always produces the
same results. If it is set to 0, the data set can be processed one
piece at a time, so it is not necessary for the entire data set to fit
into memory; however the results are not guaranteed to be the same as
they would be if the Piece invariant option was on. Setting this option
to 0 may produce seams in the output dataset when ParaView is run in
parallel.
|
1
|
Accepts boolean values (0 or 1).
|-
|'''Tolerance''' (Tolerance)
|
If merging nearby points (see PointMerging property) and
not using absolute tolerance (see ToleranceIsAbsolute property), this
property specifies the tolerance for performing merging as a fraction
of the length of the diagonal of the bounding box of the input data
set.
|
0.0
|
|
The selected object must be the result of the following: sources (includes readers), filters.
The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.


|-
|'''AbsoluteTolerance''' (AbsoluteTolerance)
|
If merging nearby points (see PointMerging property) and
using absolute tolerance (see ToleranceIsAbsolute property), this
property specifies the tolerance for performing merging in the spatial
units of the input data set.
|
1.0
|


|-
|-
| '''Output Tensor Type'''<br>''(OutputTensorType)''
|'''ToleranceIsAbsolute''' (ToleranceIsAbsolute)
|
This property determines whether to use absolute or
relative (a percentage of the bounding box) tolerance when performing
point merging.
|
0
|
Accepts boolean values (0 or 1).
|-
|'''ConvertLinesToPoints''' (ConvertLinesToPoints)
|
|
This property controls how the filter works to generate tensor cell data. You can choose to compute the gradient of the input vectors, or compute the strain tensor of the vector gradient tensor. By default, the filter will take the gradient of the vector data to construct a tensor.
If this property is set to 1, degenerate lines (a "line"
 
whose endpoints are at the same spatial location) will be converted to
| 1
points.
|
1
|
|
The value must be one of the following: Nothing (0), Vector Gradient (1), Strain (2).
Accepts boolean values (0 or 1).
 
 
|-
|-
| '''Output Vector Type'''<br>''(OutputVectorType)''
|'''ConvertPolysToLines''' (ConvertPolysToLines)
|
|
This property Controls how the filter works to generate vector cell data. You can choose to compute the gradient of the input scalars, or extract the vorticity of the computed vector gradient tensor. By default, the filter will take the gradient of the input scalar data.
If this property is set to 1, degenerate polygons (a
 
"polygon" with only two distinct point coordinates) will be converted
| 1
to lines.
|
1
|
|
The value must be one of the following: Nothing (0), Scalar Gradient (1), Vorticity (2).
Accepts boolean values (0 or 1).
 
 
|-
|-
| '''Scalars'''<br>''(SelectInputScalars)''
|'''ConvertStripsToPolys''' (ConvertStripsToPolys)
|
|
This property indicates the name of the scalar array to differentiate.
If this property is set to 1, degenerate triangle strips
 
(a triangle "strip" containing only one triangle) will be converted to
triangles.
|
|
1
|
|
An array of scalars is required.
Accepts boolean values (0 or 1).
 
 
|-
|-
| '''Vectors'''<br>''(SelectInputVectors)''
|'''PointMerging''' (PointMerging)
|
|
This property indicates the name of the vector array to differentiate.
If this property is set to 1, then points will be merged
 
if they are within the specified Tolerance or AbsoluteTolerance (see
| 1
the Tolerance and AbsoluteTolerance propertys), depending on the value
of the ToleranceIsAbsolute property. (See the ToleranceIsAbsolute
property.) If this property is set to 0, points will not be
merged.
|
1
|
|
An array of vectors is required.
Accepts boolean values (0 or 1).
 


|}
|}


==Clean Cells to Grid==


==Connectivity==
This filter merges cells and converts the data set to unstructured grid.Merges degenerate cells. Assumes
 
the input grid does not contain duplicate points. You may
 
want to run vtkCleanUnstructuredGrid first to assert it.
Mark connected components with integer point attribute array.
If duplicated cells are found they are removed in the
 
output. The filter also handles the case, where a cell may
The Connectivity filter assigns a region id to connected components of the input data set. (The region id is assigned as a point scalar value.) This filter takes any data set type as input and produces unstructured grid output.<br>
contain degenerate nodes (i.e. one and the same node is
referenced by a cell more than once).


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 1,071: Line 1,394:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Color Regions'''<br>''(ColorRegions)''
|'''Input''' (Input)
|
This property specifies the input to the Clean Cells to
Grid filter.
|
|
Controls the coloring of the connected regions.


| 1
|
|
Only the values 0 and 1 are accepted.
Accepts input of following types:
* vtkUnstructuredGrid


|}


|-
==Clean to Grid==
| '''Extraction Mode'''<br>''(ExtractionMode)''
|
Controls the extraction of connected surfaces.
 
| 5
|
The value must be one of the following: Extract Point Seeded Regions (1), Extract Cell Seeded Regions (2), Extract Specified Regions (3), Extract Largest Region (4), Extract All Regions (5), Extract Closes Point Region (6).


This filter merges points and converts the data set to unstructured grid.The Clean to Grid filter merges
points that are exactly coincident. It also converts the
data set to an unstructured grid. You may wish to do this
if you want to apply a filter to your data set that is
available for unstructured grids but not for the initial
type of your data set (e.g., applying warp vector to
volumetric data). The Clean to Grid filter operates on any
type of data set.


{| class="PropertiesTable" border="1" cellpadding="5"
|-
|-
| '''Input'''<br>''(Input)''
| '''Property'''
|
| '''Description'''
This property specifies the input to the Connectivity filter.
| '''Default Value(s)'''
| '''Restrictions'''


|-
|'''Input''' (Input)
|
|
This property specifies the input to the Clean to Grid
filter.
|
|
The selected object must be the result of the following: sources (includes readers), filters.
The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.


|
Accepts input of following types:
* vtkDataSet


|}
|}


==ClientServerMoveData==


==Contingency Statistics==
Compute a statistical model of a dataset and/or assess the dataset with a statistical model.


This filter either computes a statistical model of a dataset or takes such a model as its second input.  Then, the model (however it is obtained) may optionally be used to assess the input dataset.<br>
This filter computes contingency tables between pairs of attributes.  This result is a tabular bivariate probability distribution which serves as a Bayesian-style prior model.  Data is assessed by computing <br>
*  the probability of observing both variables simultaneously;<br>
*  the probability of each variable conditioned on the other (the two values need not be identical); and<br>
*  the pointwise mutual information (PMI).
<br>
Finally, the summary statistics include the information entropy of the observations.<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 1,126: Line 1,449:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Attribute Mode'''<br>''(AttributeMode)''
|'''Input''' (Input)
|
Set the input to the Client Server Move Data
filter.
|
|
Specify which type of field data the arrays will be drawn from.


| 0
|
|
Valud array names will be chosen from point and cell data.


|-
|-
| '''Input'''<br>''(Input)''
|'''OutputDataType''' (OutputDataType)
|
|
The input to the filter.  Arrays from this dataset will be used for computing statistics and/or assessed by a statistical model.


|
|
0
|
|
The selected object must be the result of the following: sources (includes readers), filters.
The dataset must contain a point or cell array.
The selected dataset must be one of the following types (or a subclass of one of them): vtkImageData, vtkStructuredGrid, vtkPolyData, vtkUnstructuredGrid, vtkTable, vtkGraph.


|-
|-
| '''Model Input'''<br>''(ModelInput)''
|'''WholeExtent''' (WholeExtent)
|
|
A previously-calculated model with which to assess a separate dataset. This input is optional.


|
|
0 -1 0 -1 0 -1
|
|
The selected object must be the result of the following: sources (includes readers), filters.




The selected dataset must be one of the following types (or a subclass of one of them): vtkTable, vtkMultiBlockDataSet.
|}
 
==Clip==


Clip with an implicit plane. Clipping does not reduce the dimensionality of the data set. The output data type of this filter is always an unstructured grid.The Clip filter
cuts away a portion of the input data set using an
implicit plane. This filter operates on all types of data
sets, and it returns unstructured grid data on
output.


{| class="PropertiesTable" border="1" cellpadding="5"
|-
|-
| '''Variables of Interest'''<br>''(SelectArrays)''
| '''Property'''
|
| '''Description'''
Choose arrays whose entries will be used to form observations for statistical analysis.
| '''Default Value(s)'''
| '''Restrictions'''


|-
|'''Input''' (Input)
|
|
This property specifies the dataset on which the Clip
filter will operate.
|
|
An array of scalars is required.


|-
| '''Task'''<br>''(Task)''
|
|
Specify the task to be performed: modeling and/or assessment.
Accepts input of following types:
#  "Detailed model of input data," creates a set of output tables containing a calculated statistical model of the '''entire''' input dataset;
* vtkDataSet
#  "Model a subset of the data," creates an output table (or tables) summarizing a '''randomly-chosen subset''' of the input dataset;
The dataset must contain a field array ()
#  "Assess the data with a model," adds attributes to the first input dataset using a model provided on the second input port; and
#  "Model and assess the same data," is really just operations 2 and 3 above applied to the same input dataset.  The model is first trained using a fraction of the input data and then the entire dataset is assessed using that model.


When the task includes creating a model (i.e., tasks 2, and 4), you may adjust the fraction of the input dataset used for training.  You should avoid using a large fraction of the input data for training as you will then not be able to detect overfitting.  The ''Training fraction'' setting will be ignored for tasks 1 and 3.
with 1 component(s).


| 3
|-
|'''Clip Type''' (ClipFunction)
|
|
The value must be one of the following: Detailed model of input data (0), Model a subset of the data (1), Assess the data with a model (2), Model and assess the same data (3).
This property specifies the parameters of the clip
 
function (an implicit plane) used to clip the dataset.
 
|-
| '''Training Fraction'''<br>''(TrainingFraction)''
|
|
Specify the fraction of values from the input dataset to be used for model fitting. The exact set of values is chosen at random from the dataset.


| 0.1
|
|
The value must be greater than or equal to 0 and less than or equal to 1.
The value can be one of the following:
* Plane (implicit_functions)


* Box (implicit_functions)


|}
* Sphere (implicit_functions)


* Cylinder (implicit_functions)


==Contour==
* Scalar (implicit_functions)
 
 
Generate isolines or isosurfaces using point scalars.
 
The Contour filter computes isolines or isosurfaces using a selected point-centered scalar array. The Contour filter operates on any type of data set, but the input is required to have at least one point-centered scalar (single-component) array. The output of this filter is polygonal.<br>


{| class="PropertiesTable" border="1" cellpadding="5"
|-
| '''Property'''
| '''Description'''
| '''Default Value(s)'''
| '''Restrictions'''
|-
|-
| '''Compute Gradients'''<br>''(ComputeGradients)''
|'''InputBounds''' (InputBounds)
|
|
If this property is set to 1, a scalar array containing a gradient value at each point in the isosurface or isoline will be created by this filter; otherwise an array of gradients will not be computed. This operation is fairly expensive both in terms of computation time and memory required, so if the output dataset produced by the contour filter will be processed by filters that modify the dataset's topology or geometry, it may be wise to set the value of this property to 0. Not that if ComputeNormals is set to 1, then gradients will have to be calculated, but they will only be stored in the output dataset if ComputeGradients is also set to 1.


| 0
|
|
Only the values 0 and 1 are accepted.


|


|-
|-
| '''Compute Normals'''<br>''(ComputeNormals)''
|'''Scalars''' (SelectInputScalars)
|
If clipping with scalars, this property specifies the
name of the scalar array on which to perform the clip
operation.
|
|
If this property is set to 1, a scalar array containing a normal value at each point in the isosurface or isoline will be created by the contour filter; otherwise an array of normals will not be computed. This operation is fairly expensive both in terms of computation time and memory required, so if the output dataset produced by the contour filter will be processed by filters that modify the dataset's topology or geometry, it may be wise to set the value of this property to 0.
Select whether to compute normals.


| 1
|
|
Only the values 0 and 1 are accepted.
An array of scalars is required.The value must be field array name.
 
 
|-
|-
| '''Compute Scalars'''<br>''(ComputeScalars)''
|'''Value''' (Value)
|
|
If this property is set to 1, an array of scalars (containing the contour value) will be added to the output dataset. If set to 0, the output will not contain this array.
If clipping with scalars, this property sets the scalar
 
value about which to clip the dataset based on the scalar array chosen.
| 0
(See SelectInputScalars.) If clipping with a clip function, this
|
property specifies an offset from the clip function to use in the
Only the values 0 and 1 are accepted.
clipping operation. Neither functionality is currently available in
 
ParaView's user interface.
 
|-
| '''Isosurfaces'''<br>''(ContourValues)''
|
This property specifies the values at which to compute isosurfaces/isolines and also the number of such values.
 
|
|
0.0
|
|
The value must lie within the range of the selected data array.
The value must lie within the range of the selected data array.
|-
|-
| '''Input'''<br>''(Input)''
|'''InsideOut''' (InsideOut)
|
|
This property specifies the input dataset to be used by the contour filter.
If this property is set to 0, the clip filter will
 
return that portion of the dataset that lies within the clip function.
If set to 1, the portions of the dataset that lie outside the clip
function will be returned instead.
|
|
0
|
|
The selected object must be the result of the following: sources (includes readers), filters.
Accepts boolean values (0 or 1).
 
 
The dataset must contain a point array with 1 components.
 
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.
 
 
|-
|-
| '''Point Merge Method'''<br>''(Locator)''
|'''UseValueAsOffset''' (UseValueAsOffset)
|
|
This property specifies an incremental point locator for merging duplicate / coincident points.
If UseValueAsOffset is true, Value is used as an offset
 
parameter to the implicit function. Otherwise, Value is used only when
clipping using a scalar array.
|
|
0
|
|
The selected object must be the result of the following: incremental_point_locators.
Accepts boolean values (0 or 1).
 
 
The value must be set to one of the following: MergePoints, IncrementalOctreeMergePoints, NonMergingPointLocator.
 
 
|-
|-
| '''Contour By'''<br>''(SelectInputScalars)''
|'''Crinkle clip''' (PreserveInputCells)
|
|
This property specifies the name of the scalar array from which the contour filter will compute isolines and/or isosurfaces.
This parameter controls whether to extract entire cells
 
in the given region or clip those cells so all of the output one stay
only inside that region.
|
|
0
|
|
An array of scalars is required.
Accepts boolean values (0 or 1).
 
 
Valud array names will be chosen from point and cell data.
 


|}
|}


==Clip Closed Surface==


==Contour Generic Dataset==
Clip a polygonal dataset with a plane to produce closed surfaces
 
This clip filter cuts away a portion of the input polygonal dataset using
 
a plane to generate a new polygonal dataset.
Generate isolines or isosurfaces using point scalars.
 
The Generic Contour filter computes isolines or isosurfaces using a selected point-centered scalar array. The available scalar arrays are listed in the Scalars menu. The scalar range of the selected array will be displayed.<br>
The interface for adding contour values is very similar to the one for selecting cut offsets (in the Cut filter). To add a single contour value, select the value from the New Value slider in the Add value portion of the interface and click the Add button, or press Enter. To instead add several evenly spaced contours, use the controls in the Generate range of values section. Select the number of contour values to generate using the Number of Values slider. The Range slider controls the interval in which to generate the contour values. Once the number of values and range have been selected, click the Generate button. The new values will be added to the Contour Values list. To delete a value from the Contour Values list, select the value and click the Delete button. (If no value is selected, the last value in the list will be removed.) Clicking the Delete All button removes all the values in the list. If no values are in the Contour Values list when Accept is pressed, the current value of the New Value slider will be used.<br>
In addition to selecting contour values, you can also select additional computations to perform. If any of Compute Normals, Compute Gradients, or Compute Scalars is selected, the appropriate computation will be performed, and a corresponding point-centered array will be added to the output.<br>
The Generic Contour filter operates on a generic data set, but the input is required to have at least one point-centered scalar (single-component) array. The output of this filter is polygonal.<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 1,319: Line 1,603:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Compute Gradients'''<br>''(ComputeGradients)''
|'''Input''' (Input)
|
This property specifies the dataset on which the Clip
filter will operate.
|
|
Select whether to compute gradients.


| 0
|
|
Only the values 0 and 1 are accepted.
Accepts input of following types:
* vtkPolyData
The dataset must contain a field array (point)


with 1 component(s).


|-
|-
| '''Compute Normals'''<br>''(ComputeNormals)''
|'''Clipping Plane''' (ClippingPlane)
|
This property specifies the parameters of the clipping
plane used to clip the polygonal data.
|
|
Select whether to compute normals.


| 1
|
|
Only the values 0 and 1 are accepted.
The value can be one of the following:
 
* Plane (implicit_functions)


|-
|-
| '''Compute Scalars'''<br>''(ComputeScalars)''
|'''GenerateFaces''' (GenerateFaces)
|
Generate polygonal faces in the output.
|
|
Select whether to compute scalars.
1
 
| 0
|
|
Only the values 0 and 1 are accepted.
Accepts boolean values (0 or 1).
 
 
|-
|-
| '''Isosurfaces'''<br>''(ContourValues)''
|'''GenerateOutline''' (GenerateOutline)
|
|
This property specifies the values at which to compute isosurfaces/isolines and also the number of such values.
Generate clipping outlines in the output wherever an
 
input face is cut by the clipping plane.
|
|
0
|
|
The value must lie within the range of the selected data array.
Accepts boolean values (0 or 1).
 
 
|-
|-
| '''Input'''<br>''(Input)''
|'''Generate Cell Origins''' (ScalarMode)
|
|
Set the input to the Generic Contour filter.
Generate (cell) data for coloring purposes such that the
 
newly generated cells (including capping faces and clipping outlines)
can be distinguished from the input cells.
|
0
|
The value(s) is an enumeration of the following:
* None (0)
* Color (1)
* Label (2)
|-
|'''InsideOut''' (InsideOut)
|
If this flag is turned off, the clipper will return the
portion of the data that lies within the clipping plane. Otherwise, the
clipper will return the portion of the data that lies outside the
clipping plane.
|
0
|
Accepts boolean values (0 or 1).
|-
|'''Clipping Tolerance''' (Tolerance)
|
Specify the tolerance for creating new points. A small
value might incur degenerate triangles.
|
|
0.000001
|
|
The selected object must be the result of the following: sources (includes readers), filters.
The selected dataset must be one of the following types (or a subclass of one of them): vtkGenericDataSet.


|-
|-
| '''Point Merge Method'''<br>''(Locator)''
|'''Base Color''' (BaseColor)
|
|
This property specifies an incremental point locator for merging duplicate / coincident points.
Specify the color for the faces from the
 
input.
|
|
0.10 0.10 1.00
|
|
The selected object must be the result of the following: incremental_point_locators.
The value must be set to one of the following: MergePoints, IncrementalOctreeMergePoints, NonMergingPointLocator.


|-
|-
| '''Contour By'''<br>''(SelectInputScalars)''
|'''Clip Color''' (ClipColor)
|
|
This property specifies the name of the scalar array from which the contour filter will compute isolines and/or isosurfaces.
Specifiy the color for the capping faces (generated on
 
the clipping interface).
|
|
1.00 0.11 0.10
|
|
An array of scalars is required.
Valud array names will be chosen from point and cell data.




|}
|}


==Clip Generic Dataset==


==Curvature==
Clip with an implicit plane, sphere or with scalars. Clipping does not reduce the dimensionality of the data set. This output data type of this filter is always an unstructured grid.
 
The Generic Clip filter cuts away a portion of the input
 
data set using a plane, a sphere, a box, or a scalar
This filter will compute the Gaussian or mean curvature of the mesh at each point.
value. The menu in the Clip Function portion of the
 
interface allows the user to select which implicit
The Curvature filter computes the curvature at each point in a polygonal data set. This filter supports both Gaussian and mean curvatures.<br><br><br>
function to use or whether to clip using a scalar value.
; the type can be selected from the Curvature type menu button.<br>
Making this selection loads the appropriate user
interface. For the implicit functions, the appropriate 3D
widget (plane, sphere, or box) is also displayed. The use
of these 3D widgets, including their user interface
components, is discussed in section 7.4. If an implicit
function is selected, the clip filter returns that portion
of the input data set that lies inside the function. If
Scalars is selected, then the user must specify a scalar
array to clip according to. The clip filter will return
the portions of the data set whose value in the selected
Scalars array is larger than the Clip value. Regardless of
the selection from the Clip Function menu, if the Inside
Out option is checked, the opposite portions of the data
set will be returned. This filter operates on all types of
data sets, and it returns unstructured grid data on
output.


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 1,415: Line 1,731:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Curvature Type'''<br>''(CurvatureType)''
|'''Input''' (Input)
|
Set the input to the Generic Clip
filter.
|
|
This propery specifies which type of curvature to compute.


| 0
|
|
The value must be one of the following: Gaussian (0), Mean (1).
Accepts input of following types:
 
* vtkGenericDataSet
The dataset must contain a field array (point)


|-
|-
| '''Input'''<br>''(Input)''
|'''Clip Type''' (ClipFunction)
|
Set the parameters of the clip function.
|
|
This property specifies the input to the Curvature filter.


|
|
|
The value can be one of the following:
The selected object must be the result of the following: sources (includes readers), filters.
* Plane (implicit_functions)


* Box (implicit_functions)


The selected dataset must be one of the following types (or a subclass of one of them): vtkPolyData.
* Sphere (implicit_functions)


* Scalar (implicit_functions)


|-
|-
| '''Invert Mean Curvature'''<br>''(InvertMeanCurvature)''
|'''InputBounds''' (InputBounds)
|
|
If this property is set to 1, the mean curvature calculation will be inverted. This is useful for meshes with inward-pointing normals.


| 0
|
|
Only the values 0 and 1 are accepted.


|


|}
|-
|'''Scalars''' (SelectInputScalars)
|
If clipping with scalars, this property specifies the
name of the scalar array on which to perform the clip
operation.
|


|
An array of scalars is required.The value must be field array name.
|-
|'''InsideOut''' (InsideOut)
|
Choose which portion of the dataset should be clipped
away.
|
0
|
Accepts boolean values (0 or 1).
|-
|'''Value''' (Value)
|
If clipping with a scalar array, choose the clipping
value.
|
0.0
|
The value must lie within the range of the selected data array.


==D3==
|}


==Color By Array==


Repartition a data set into load-balanced spatially convex regions.  Create ghost cells if requested.
This filter generate a color based image data based on a selected data scalar
 
The D3 filter is available when ParaView is run in parallel. It operates on any type of data set to evenly divide it across the processors into spatially contiguous regions. The output of this filter is of type unstructured grid.<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 1,464: Line 1,809:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Boundary Mode'''<br>''(BoundaryMode)''
|'''Input''' (Input)
|
|
This property determines how cells that lie on processor boundaries are handled. The "Assign cells uniquely" option assigns each boundary cell to exactly one process, which is useful for isosurfacing. Selecting "Duplicate cells" causes the cells on the boundaries to be copied to each process that shares that boundary. The "Divide cells" option breaks cells across process boundary lines so that pieces of the cell lie in different processes. This option is useful for volume rendering.


| 0
|
|
The value must be one of the following: Assign cells uniquely (0), Duplicate cells (1), Divide cells (2).


|
Accepts input of following types:
* vtkImageData
The dataset must contain a field array (point)
with 1 component(s).


|-
|-
| '''Input'''<br>''(Input)''
|'''LookupTable''' (LookupTable)
|
|
This property specifies the input to the D3 filter.


|
|
|
|
The selected object must be the result of the following: sources (includes readers), filters.


|-
|'''Color By''' (SelectInputScalars)
|
This property specifies the name of the scalar array
from which we will color by.
|


The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.
|
An array of scalars is required.The value must be field array name.
|-
|'''RGBA NaN Color''' (NaNColor)
|


|
0 0 0 255
|


|-
|-
| '''Minimal Memory'''<br>''(UseMinimalMemory)''
|'''OutputFormat''' (OutputFormat)
|
|
If this property is set to 1, the D3 filter requires communication routines to use minimal memory than without this restriction.


| 0
|
|
Only the values 0 and 1 are accepted.
3
 
|
The value(s) is an enumeration of the following:
* Luminance (1)
* Luminance Alpha (2)
* RGB (3)
* RGBA (4)


|}
|}


==Compute Derivatives==


==Decimate==
This filter computes derivatives of scalars and vectors.
 
CellDerivatives is a filter that computes derivatives of
 
scalars and vectors at the center of cells. You can choose
Simplify a polygonal model using an adaptive edge collapse algorithm.  This filter works with triangles only.
to generate different output including the scalar gradient
 
(a vector), computed tensor vorticity (a vector), gradient
The Decimate filter reduces the number of triangles in a polygonal data set. Because this filter only operates on triangles, first run the Triangulate filter on a dataset that contains polygons other than triangles.<br>
of input vectors (a tensor), and strain matrix of the
input vectors (a tensor); or you may choose to pass data
through to the output.


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 1,513: Line 1,880:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Boundary Vertex Deletion'''<br>''(BoundaryVertexDeletion)''
|'''Input''' (Input)
|
This property specifies the input to the
filter.
|
|
If this property is set to 1, then vertices on the boundary of the dataset can be removed. Setting the value of this property to 0 preserves the boundary of the dataset, but it may cause the filter not to reach its reduction target.


| 1
|
|
Only the values 0 and 1 are accepted.
Accepts input of following types:
* vtkDataSet
The dataset must contain a field array (point)
 
with 1 component(s).
 
The dataset must contain a field array (point)


with 3 component(s).


|-
|-
| '''Feature Angle'''<br>''(FeatureAngle)''
|'''Scalars''' (SelectInputScalars)
|
This property indicates the name of the scalar array to
differentiate.
|
|
The value of thie property is used in determining where the data set may be split. If the angle between two adjacent triangles is greater than or equal to the FeatureAngle value, then their boundary is considered a feature edge where the dataset can be split.


| 15
|
|
The value must be greater than or equal to 0 and less than or equal to 180.
An array of scalars is required.
 
 
|-
|-
| '''Input'''<br>''(Input)''
|'''Vectors''' (SelectInputVectors)
|
|
This property specifies the input to the Decimate filter.
This property indicates the name of the vector array to
 
differentiate.
|
|
1
|
|
The selected object must be the result of the following: sources (includes readers), filters.
An array of vectors is required.
 
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkPolyData.
 
 
|-
|-
| '''Preserve Topology'''<br>''(PreserveTopology)''
|'''OutputVectorType''' (OutputVectorType)
|
|
If this property is set to 1, decimation will not split the dataset or produce holes, but it may keep the filter from reaching the reduction target. If it is set to 0, better reduction can occur (reaching the reduction target), but holes in the model may be produced.
This property Controls how the filter works to generate
 
vector cell data. You can choose to compute the gradient of the input
| 0
scalars, or extract the vorticity of the computed vector gradient
tensor. By default, the filter will take the gradient of the input
scalar data.
|
1
|
|
Only the values 0 and 1 are accepted.
The value(s) is an enumeration of the following:
 
* Nothing (0)
 
* Scalar Gradient (1)
* Vorticity (2)
|-
|-
| '''Target Reduction'''<br>''(TargetReduction)''
|'''OutputTensorType''' (OutputTensorType)
|
|
This property specifies the desired reduction in the total number of polygons in the output dataset. For example, if the TargetReduction value is 0.9, the Decimate filter will attempt to produce an output dataset that is 10% the size of the input.)
This property controls how the filter works to generate
 
tensor cell data. You can choose to compute the gradient of the input
| 0.9
vectors, or compute the strain tensor of the vector gradient tensor. By
default, the filter will take the gradient of the vector data to
construct a tensor.
|
1
|
|
The value must be greater than or equal to 0 and less than or equal to 1.
The value(s) is an enumeration of the following:
 
* Nothing (0)
* Vector Gradient (1)
* Strain (2)


|}
|}


==Compute Quartiles==


==Delaunay 2D==
Compute the quartiles table from a dataset or table.
 
 
Create 2D Delaunay triangulation of input points. It expects a vtkPointSet as input and produces vtkPolyData as output. The points are expected to be in a mostly planar distribution.
 
Delaunay2D is a filter that constructs a 2D Delaunay triangulation from a list of input points. These points may be represented by any dataset of type vtkPointSet and subclasses. The output of the filter is a polygonal dataset containing a triangle mesh.<br><br><br>
The 2D Delaunay triangulation is defined as the triangulation that satisfies the Delaunay criterion for n-dimensional simplexes (in this case n=2 and the simplexes are triangles). This criterion states that a circumsphere of each simplex in a triangulation contains only the n+1 defining points of the simplex. In two dimensions, this translates into an optimal triangulation. That is, the maximum interior angle of any triangle is less than or equal to that of any possible triangulation.<br><br><br>
Delaunay triangulations are used to build topological structures from unorganized (or unstructured) points. The input to this filter is a list of points specified in 3D, even though the triangulation is 2D. Thus the triangulation is constructed in the x-y plane, and the z coordinate is ignored (although carried through to the output). You can use the option ProjectionPlaneMode in order to compute the best-fitting plane to the set of points, project the points and that plane and then perform the triangulation using their projected positions and then use it as the plane in which the triangulation is performed.<br><br><br>
The Delaunay triangulation can be numerically sensitive in some cases. To prevent problems, try to avoid injecting points that will result in triangles with bad aspect ratios (1000:1 or greater). In practice this means inserting points that are "widely dispersed", and enables smooth transition of triangle sizes throughout the mesh. (You may even want to add extra points to create a better point distribution.) If numerical problems are present, you will see a warning message to this effect at the end of the triangulation process.<br><br><br>
Warning:<br>
Points arranged on a regular lattice (termed degenerate cases) can be triangulated in more than one way (at least according to the Delaunay criterion). The choice of triangulation (as implemented by this algorithm) depends on the order of the input points. The first three points will form a triangle; other degenerate points will not break this triangle.<br><br><br>
Points that are coincident (or nearly so) may be discarded by the algorithm. This is because the Delaunay triangulation requires unique input points. The output of the Delaunay triangulation is supposedly a convex hull. In certain cases this implementation may not generate the convex hull.<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 1,588: Line 1,960:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Alpha'''<br>''(Alpha)''
|'''Input''' (Input)
|
This property specifies the input to the
filter.
|
|
The value of this property controls the output of this filter. For a non-zero alpha value, only edges or triangles contained within a sphere centered at mesh vertices will be output. Otherwise, only triangles will be output.


| 0
|
|
The value must be greater than or equal to 0.
Accepts input of following types:
* vtkDataObject


|}


|-
==Connectivity==
| '''Bounding Triangulation'''<br>''(BoundingTriangulation)''
|
If this property is set to 1, bounding triangulation points (and associated triangles) are included in the output. These are introduced as an initial triangulation to begin the triangulation process. This feature is nice for debugging output.


| 0
Mark connected components with integer point attribute array.The Connectivity
|
filter assigns a region id to connected components of the
Only the values 0 and 1 are accepted.
input data set. (The region id is assigned as a point
scalar value.) This filter takes any data set type as
input and produces unstructured grid
output.


{| class="PropertiesTable" border="1" cellpadding="5"
|-
| '''Property'''
| '''Description'''
| '''Default Value(s)'''
| '''Restrictions'''


|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
This property specifies the input to the Connectivity
filter.
|
|
This property specifies the input dataset to the Delaunay 2D filter.


|
|
Accepts input of following types:
* vtkDataSet
|-
|'''ExtractionMode''' (ExtractionMode)
|
|
The selected object must be the result of the following: sources (includes readers), filters.
Controls the extraction of connected
 
surfaces.
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkPointSet.
 
 
|-
| '''Offset'''<br>''(Offset)''
|
|
This property is a multiplier to control the size of the initial, bounding Delaunay triangulation.
5
 
| 1
|
|
The value must be greater than or equal to 0.75.
The value(s) is an enumeration of the following:
 
* Extract Point Seeded Regions (1)
 
* Extract Cell Seeded Regions (2)
* Extract Specified Regions (3)
* Extract Largest Region (4)
* Extract All Regions (5)
* Extract Closes Point Region (6)
|-
|-
| '''Projection Plane Mode'''<br>''(ProjectionPlaneMode)''
|'''ColorRegions''' (ColorRegions)
|
|
This property determines type of projection plane to use in performing the triangulation.
Controls the coloring of the connected
 
regions.
| 0
|
|
The value must be one of the following: XY Plane (0), Best-Fitting Plane (2).
1
 
 
|-
| '''Tolerance'''<br>''(Tolerance)''
|
This property specifies a tolerance to control discarding of closely spaced points. This tolerance is specified as a fraction of the diagonal length of the bounding box of the points.
 
| 1e-05
|
|
The value must be greater than or equal to 0 and less than or equal to 1.
Accepts boolean values (0 or 1).
 


|}
|}


==Contingency Statistics==


==Delaunay 3D==
Compute a statistical model of a dataset and/or assess the dataset with a statistical model.
 
This filter either computes a statistical model of a dataset or takes
 
such a model as its second input. Then, the model (however it is
Create a 3D Delaunay triangulation of input                                points.  It expects a vtkPointSet as input and                                produces vtkUnstructuredGrid as output.
obtained) may optionally be used to assess the input dataset. This filter
 
computes contingency tables between pairs of attributes. This result is a
Delaunay3D is a filter that constructs a 3D Delaunay triangulation<br>
tabular bivariate probability distribution which serves as a
from a list of input points. These points may be represented by any<br>
Bayesian-style prior model. Data is assessed by computing &lt;ul&gt;
dataset of type vtkPointSet and subclasses. The output of the filter<br>
&lt;li&gt; the probability of observing both variables simultaneously;
is an unstructured grid dataset. Usually the output is a tetrahedral<br>
&lt;li&gt; the probability of each variable conditioned on the other (the
mesh, but if a non-zero alpha distance value is specified (called<br>
two values need not be identical); and &lt;li&gt; the pointwise mutual
the "alpha" value), then only tetrahedra, triangles, edges, and<br>
information (PMI). &lt;/ul&gt; Finally, the summary statistics include
vertices lying within the alpha radius are output. In other words,<br>
the information entropy of the observations.
non-zero alpha values may result in arbitrary combinations of<br>
tetrahedra, triangles, lines, and vertices. (The notion of alpha<br>
value is derived from Edelsbrunner's work on "alpha shapes".)<br><br><br>
The 3D Delaunay triangulation is defined as the triangulation that<br>
satisfies the Delaunay criterion for n-dimensional simplexes (in<br>
this case n=3 and the simplexes are tetrahedra). This criterion<br>
states that a circumsphere of each simplex in a triangulation<br>
contains only the n+1 defining points of the simplex. (See text for<br>
more information.) While in two dimensions this translates into an<br>
"optimal" triangulation, this is not true in 3D, since a measurement<br>
for optimality in 3D is not agreed on.<br><br><br>
Delaunay triangulations are used to build topological structures<br>
from unorganized (or unstructured) points. The input to this filter<br>
is a list of points specified in 3D. (If you wish to create 2D<br>
triangulations see Delaunay2D.) The output is an unstructured<br>
grid.<br><br><br>
The Delaunay triangulation can be numerically sensitive. To prevent<br>
problems, try to avoid injecting points that will result in<br>
triangles with bad aspect ratios (1000:1 or greater). In practice<br>
this means inserting points that are "widely dispersed", and enables<br>
smooth transition of triangle sizes throughout the mesh. (You may<br>
even want to add extra points to create a better point<br>
distribution.) If numerical problems are present, you will see a<br>
warning message to this effect at the end of the triangulation<br>
process.<br><br><br>
Warning:<br>
Points arranged on a regular lattice (termed degenerate cases) can<br>
be triangulated in more than one way (at least according to the<br>
Delaunay criterion). The choice of triangulation (as implemented by<br>
this algorithm) depends on the order of the input points. The first<br>
four points will form a tetrahedron; other degenerate points<br>
(relative to this initial tetrahedron) will not break it.<br><br><br>
Points that are coincident (or nearly so) may be discarded by the<br>
algorithm. This is because the Delaunay triangulation requires<br>
unique input points. You can control the definition of coincidence<br>
with the "Tolerance" instance variable.<br><br><br>
The output of the Delaunay triangulation is supposedly a convex<br>
hull. In certain cases this implementation may not generate the<br>
convex hull. This behavior can be controlled by the Offset instance<br>
variable. Offset is a multiplier used to control the size of the<br>
initial triangulation. The larger the offset value, the more likely<br>
you will generate a convex hull; and the more likely you are to see<br>
numerical problems.<br><br><br>
The implementation of this algorithm varies from the 2D Delaunay<br>
algorithm (i.e., Delaunay2D) in an important way. When points are<br>
injected into the triangulation, the search for the enclosing<br>
tetrahedron is quite different. In the 3D case, the closest<br>
previously inserted point point is found, and then the connected<br>
tetrahedra are searched to find the containing one. (In 2D, a "walk"<br>
towards the enclosing triangle is performed.) If the triangulation<br>
is Delaunay, then an enclosing tetrahedron will be found. However,<br>
in degenerate cases an enclosing tetrahedron may not be found and<br>
the point will be rejected.<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 1,726: Line 2,048:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Alpha'''<br>''(Alpha)''
|'''Input''' (Input)
|
The input to the filter. Arrays from this dataset will
be used for computing statistics and/or assessed by a statistical
model.
|
|
This property specifies the alpha (or distance) value to control
the output of this filter.  For a non-zero alpha value, only
edges, faces, or tetra contained within the circumsphere (of
radius alpha) will be output.  Otherwise, only tetrahedra will be
output.


| 0
|
|
The value must be greater than or equal to 0.
Accepts input of following types:
 
* vtkImageData
* vtkStructuredGrid
* vtkPolyData
* vtkUnstructuredGrid
* vtkTable
* vtkGraph
The dataset must contain a field array ()


|-
|-
| '''Bounding Triangulation'''<br>''(BoundingTriangulation)''
|'''ModelInput''' (ModelInput)
|
A previously-calculated model with which to assess a
separate dataset. This input is optional.
|
|
This boolean controls whether bounding triangulation points (and
associated triangles) are included in the output. (These are
introduced as an initial triangulation to begin the triangulation
process. This feature is nice for debugging output.)


| 0
|
|
Only the values 0 and 1 are accepted.
Accepts input of following types:
 
* vtkTable
 
* vtkMultiBlockDataSet
|-
|-
| '''Input'''<br>''(Input)''
|'''AttributeMode''' (AttributeMode)
|
|
This property specifies the input dataset to the Delaunay 3D filter.
Specify which type of field data the arrays will be
 
drawn from.
|
|
0
|
|
The selected object must be the result of the following: sources (includes readers), filters.
The value must be field array name.
 
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkPointSet.
 
 
|-
|-
| '''Offset'''<br>''(Offset)''
|'''Variables of Interest''' (SelectArrays)
|
Choose arrays whose entries will be used to form
observations for statistical analysis.
|
|
This property specifies a multiplier to control the size of the
initial, bounding Delaunay triangulation.


| 2.5
|
|
The value must be greater than or equal to 2.5.


|-
|-
| '''Tolerance'''<br>''(Tolerance)''
|'''Task''' (Task)
|
Specify the task to be performed: modeling and/or
assessment. &lt;ol&gt; &lt;li&gt; "Detailed model of input data,"
creates a set of output tables containing a calculated statistical
model of the &lt;b&gt;entire&lt;/b&gt; input dataset;&lt;/li&gt;
&lt;li&gt; "Model a subset of the data," creates an output table (or
tables) summarizing a &lt;b&gt;randomly-chosen subset&lt;/b&gt; of the
input dataset;&lt;/li&gt; &lt;li&gt; "Assess the data with a model,"
adds attributes to the first input dataset using a model provided on
the second input port; and&lt;/li&gt; &lt;li&gt; "Model and assess the
same data," is really just operations 2 and 3 above applied to the same
input dataset. The model is first trained using a fraction of the input
data and then the entire dataset is assessed using that
model.&lt;/li&gt; &lt;/ol&gt; When the task includes creating a model
(i.e., tasks 2, and 4), you may adjust the fraction of the input
dataset used for training. You should avoid using a large fraction of
the input data for training as you will then not be able to detect
overfitting. The &lt;i&gt;Training fraction&lt;/i&gt; setting will be
ignored for tasks 1 and 3.
|
|
This property specifies a tolerance to control discarding of
3
closely spaced points. This tolerance is specified as a fraction
|
of the diagonal length of the bounding box of the points.
The value(s) is an enumeration of the following:
 
* Detailed model of input data (0)
| 0.001
* Model a subset of the data (1)
* Assess the data with a model (2)
* Model and assess the same data (3)
|-
|'''TrainingFraction''' (TrainingFraction)
|
Specify the fraction of values from the input dataset to
be used for model fitting. The exact set of values is chosen at random
from the dataset.
|
0.1
|
|
The value must be greater than or equal to 0 and less than or equal to 1.




|}
|}


==Contour==


==Descriptive Statistics==
Generate isolines or isosurfaces using point scalars.The Contour
 
filter computes isolines or isosurfaces using a selected
 
point-centered scalar array. The Contour filter operates
Compute a statistical model of a dataset and/or assess the dataset with a statistical model.
on any type of data set, but the input is required to have
 
at least one point-centered scalar (single-component)
This filter either computes a statistical model of a dataset or takes such a model as its second input. Then, the model (however it is obtained) may optionally be used to assess the input dataset.
array. The output of this filter is
<br>
polygonal.
This filter computes the min, max, mean, raw moments M2 through M4, standard deviation, skewness, and kurtosis for each array you select.
 
<br>
The model is simply a univariate Gaussian distribution with the mean and standard deviation provided. Data is assessed using this model by detrending the data (i.e., subtracting the mean) and then dividing by the standard deviation. Thus the assessment is an array whose entries are the number of standard deviations from the mean that each input point lies.<br>
 


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 1,811: Line 2,154:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Attribute Mode'''<br>''(AttributeMode)''
|'''Input''' (Input)
|
This property specifies the input dataset to be used by
the contour filter.
|
|
Specify which type of field data the arrays will be drawn from.


| 0
|
|
Valud array names will be chosen from point and cell data.
Accepts input of following types:
* vtkDataSet
The dataset must contain a field array (point)


with 1 component(s).


|-
|-
| '''Input'''<br>''(Input)''
|'''Contour By''' (SelectInputScalars)
|
This property specifies the name of the scalar array
from which the contour filter will compute isolines and/or
isosurfaces.
|
|
The input to the filter.  Arrays from this dataset will be used for computing statistics and/or assessed by a statistical model.


|
|
An array of scalars is required.The value must be field array name.
|-
|'''ComputeNormals''' (ComputeNormals)
|
If this property is set to 1, a scalar array containing
a normal value at each point in the isosurface or isoline will be
created by the contour filter; otherwise an array of normals will not
be computed. This operation is fairly expensive both in terms of
computation time and memory required, so if the output dataset produced
by the contour filter will be processed by filters that modify the
dataset's topology or geometry, it may be wise to set the value of this
property to 0. Select whether to compute normals.
|
|
The selected object must be the result of the following: sources (includes readers), filters.
1
 
|
 
Accepts boolean values (0 or 1).
The dataset must contain a point or cell array.
 
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkImageData, vtkStructuredGrid, vtkPolyData, vtkUnstructuredGrid, vtkTable, vtkGraph.
 
 
|-
|-
| '''Model Input'''<br>''(ModelInput)''
|'''ComputeGradients''' (ComputeGradients)
|
|
A previously-calculated model with which to assess a separate dataset. This input is optional.
If this property is set to 1, a scalar array containing
 
a gradient value at each point in the isosurface or isoline will be
created by this filter; otherwise an array of gradients will not be
computed. This operation is fairly expensive both in terms of
computation time and memory required, so if the output dataset produced
by the contour filter will be processed by filters that modify the
dataset's topology or geometry, it may be wise to set the value of this
property to 0. Not that if ComputeNormals is set to 1, then gradients
will have to be calculated, but they will only be stored in the output
dataset if ComputeGradients is also set to 1.
|
|
0
|
|
The selected object must be the result of the following: sources (includes readers), filters.
Accepts boolean values (0 or 1).
 
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkTable, vtkMultiBlockDataSet.
 
 
|-
|-
| '''Variables of Interest'''<br>''(SelectArrays)''
|'''ComputeScalars''' (ComputeScalars)
|
|
Choose arrays whose entries will be used to form observations for statistical analysis.
If this property is set to 1, an array of scalars
 
(containing the contour value) will be added to the output dataset. If
set to 0, the output will not contain this array.
|
|
0
|
Accepts boolean values (0 or 1).
|-
|'''OutputPointsPrecision''' (OutputPointsPrecision)
|
|
An array of scalars is required.


Select the output precision of the coordinates. **Single** sets the
output to single-precision floating-point (i.e., float), **Double**
sets it to double-precision floating-point (i.e., double), and
**Default** sets it to the same precision as the precision of the
points in the input. Defaults to ***Single***.


|
0
|
The value(s) is an enumeration of the following:
* Single (0)
* Double (1)
* Same as input (2)
|-
|-
| '''Deviations should be'''<br>''(SignedDeviations)''
|'''GenerateTriangles''' (GenerateTriangles)
|
|
Should the assessed values be signed deviations or unsigned?
This parameter controls whether to produce triangles in the output.
Warning: Many filters do not properly handle non-trianglular polygons.


| 0
|
|
The value must be one of the following: Unsigned (0), Signed (1).
1
 
|
 
Accepts boolean values (0 or 1).
|-
|-
| '''Task'''<br>''(Task)''
|'''Isosurfaces''' (ContourValues)
|
This property specifies the values at which to compute
isosurfaces/isolines and also the number of such
values.
|
|
Specify the task to be performed: modeling and/or assessment.
#  "Detailed model of input data," creates a set of output tables containing a calculated statistical model of the '''entire''' input dataset;
#  "Model a subset of the data," creates an output table (or tables) summarizing a '''randomly-chosen subset''' of the input dataset;
#  "Assess the data with a model," adds attributes to the first input dataset using a model provided on the second input port; and
#  "Model and assess the same data," is really just operations 2 and 3 above applied to the same input dataset.  The model is first trained using a fraction of the input data and then the entire dataset is assessed using that model.


When the task includes creating a model (i.e., tasks 2, and 4), you may adjust the fraction of the input dataset used for training.  You should avoid using a large fraction of the input data for training as you will then not be able to detect overfitting.  The ''Training fraction'' setting will be ignored for tasks 1 and 3.
| 3
|
|
The value must be one of the following: Detailed model of input data (0), Model a subset of the data (1), Assess the data with a model (2), Model and assess the same data (3).
The value must lie within the range of the selected data array.
 
 
|-
|-
| '''Training Fraction'''<br>''(TrainingFraction)''
|'''Point Merge Method''' (Locator)
|
This property specifies an incremental point locator for
merging duplicate / coincident points.
|
|
Specify the fraction of values from the input dataset to be used for model fitting. The exact set of values is chosen at random from the dataset.


| 0.1
|
|
The value must be greater than or equal to 0 and less than or equal to 1.
The value can be one of the following:
* MergePoints (incremental_point_locators)


* IncrementalOctreeMergePoints (incremental_point_locators)


|}
* NonMergingPointLocator (incremental_point_locators)




==Elevation==
|}


==Contour Generic Dataset==


Create point attribute array by projecting points onto an elevation vector.
Generate isolines or isosurfaces using point scalars.The Generic
 
Contour filter computes isolines or isosurfaces using a
The Elevation filter generates point scalar values for an input dataset along a specified direction vector.<br><br><br>
selected point-centered scalar array. The available scalar
The Input menu allows the user to select the data set to which this filter will be applied. Use the Scalar range entry boxes to specify the minimum and maximum scalar value to be generated. The Low Point and High Point define a line onto which each point of the data set is projected. The minimum scalar value is associated with the Low Point, and the maximum scalar value is associated with the High Point. The scalar value for each point in the data set is determined by the location along the line to which that point projects.<br>
arrays are listed in the Scalars menu. The scalar range of
the selected array will be displayed. The interface for
adding contour values is very similar to the one for
selecting cut offsets (in the Cut filter). To add a single
contour value, select the value from the New Value slider
in the Add value portion of the interface and click the
Add button, or press Enter. To instead add several evenly
spaced contours, use the controls in the Generate range of
values section. Select the number of contour values to
generate using the Number of Values slider. The Range
slider controls the interval in which to generate the
contour values. Once the number of values and range have
been selected, click the Generate button. The new values
will be added to the Contour Values list. To delete a
value from the Contour Values list, select the value and
click the Delete button. (If no value is selected, the
last value in the list will be removed.) Clicking the
Delete All button removes all the values in the list. If
no values are in the Contour Values list when Accept is
pressed, the current value of the New Value slider will be
used. In addition to selecting contour values, you can
also select additional computations to perform. If any of
Compute Normals, Compute Gradients, or Compute Scalars is
selected, the appropriate computation will be performed,
and a corresponding point-centered array will be added to
the output. The Generic Contour filter operates on a
generic data set, but the input is required to have at
least one point-centered scalar (single-component) array.
The output of this filter is polygonal.


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 1,913: Line 2,317:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''High Point'''<br>''(HighPoint)''
|'''Input''' (Input)
|
Set the input to the Generic Contour
filter.
|
|
This property defines the other end of the direction vector (large scalar values).


| 0 0 1
|
|
The coordinate must lie within the bounding box of the dataset. It will default to the maximum in each dimension.
Accepts input of following types:
* vtkGenericDataSet
The dataset must contain a field array (point)


with 1 component(s).


|-
|-
| '''Input'''<br>''(Input)''
|'''Contour By''' (SelectInputScalars)
|
This property specifies the name of the scalar array
from which the contour filter will compute isolines and/or
isosurfaces.
|
|
This property specifies the input dataset to the Elevation filter.


|
|
An array of scalars is required.The value must be field array name.
|-
|'''ComputeNormals''' (ComputeNormals)
|
Select whether to compute normals.
|
1
|
Accepts boolean values (0 or 1).
|-
|'''ComputeGradients''' (ComputeGradients)
|
Select whether to compute gradients.
|
0
|
Accepts boolean values (0 or 1).
|-
|'''ComputeScalars''' (ComputeScalars)
|
Select whether to compute scalars.
|
0
|
|
The selected object must be the result of the following: sources (includes readers), filters.
Accepts boolean values (0 or 1).
 
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.
 
 
|-
|-
| '''Low Point'''<br>''(LowPoint)''
|'''Isosurfaces''' (ContourValues)
|
This property specifies the values at which to compute
isosurfaces/isolines and also the number of such
values.
|
|
This property defines one end of the direction vector (small scalar values).


| 0 0 0
|
|
The coordinate must lie within the bounding box of the dataset. It will default to the minimum in each dimension.
The value must lie within the range of the selected data array.
 
 
|-
|-
| '''Scalar Range'''<br>''(ScalarRange)''
|'''Point Merge Method''' (Locator)
|
This property specifies an incremental point locator for
merging duplicate / coincident points.
|
|
This property determines the range into which scalars will be mapped.


| 0 1
|
|
|}
The value can be one of the following:
* MergePoints (incremental_point_locators)
 
* IncrementalOctreeMergePoints (incremental_point_locators)


* NonMergingPointLocator (incremental_point_locators)


==Extract AMR Blocks==


|}


This filter extracts a list of datasets from hierarchical datasets.
==Convert AMR dataset to Multi-block==


This filter extracts a list of datasets from hierarchical datasets.<br>
Convert AMR to Multiblock


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 1,969: Line 2,404:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
|
This property specifies the input to the Extract Datasets filter.
This property specifies the input for this
 
filter.
|
|
|
The selected object must be the result of the following: sources (includes readers), filters.


The selected dataset must be one of the following types (or a subclass of one of them): vtkHierarchicalBoxDataSet.
|-
| '''Selected Data Sets'''<br>''(SelectedDataSets)''
|
|
This property provides a list of datasets to extract.
Accepts input of following types:
* vtkOverlappingAMR


|
|
|}
|}


==ConvertSelection==


==Extract Block==
Converts a selection from one type to
 
another.
 
This filter extracts a range of blocks from a multiblock dataset.
 
This filter extracts a range of groups from a multiblock dataset<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 2,005: Line 2,429:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Block Indices'''<br>''(BlockIndices)''
|'''DataInput''' (DataInput)
|
Set the vtkDataObject input used to convert the
selection.
|
|
This property lists the ids of the blocks to extract
from the input multiblock dataset.


|
|
Accepts input of following types:
* vtkDataObject
|-
|'''Input''' (Input)
|
Set the selection to convert.
|
|
|
Accepts input of following types:
* vtkSelection
|-
|-
| '''Input'''<br>''(Input)''
|'''OutputType''' (OutputType)
|
|
This property specifies the input to the Extract Group filter.
Set the ContentType for the output.
 
|
|
5
|
|
The selected object must be the result of the following: sources (includes readers), filters.
The value(s) is an enumeration of the following:
 
* SELECTIONS (0)
 
* GLOBALIDs (1)
The selected dataset must be one of the following types (or a subclass of one of them): vtkMultiBlockDataSet.
* PEDIGREEIDS (2)
 
* VALUES (3)
 
* INDICES (4)
* FRUSTUM (5)
* LOCATION (6)
* THRESHOLDS (7)
|-
|-
| '''Maintain Structure'''<br>''(MaintainStructure)''
|'''ArrayNames''' (ArrayNames)
|
|
This is used only when PruneOutput is ON. By default, when pruning the
output i.e. remove empty blocks, if node has only 1 non-null child
block, then that node is removed. To preserve these parent nodes, set
this flag to true.


| 0
|
|
Only the values 0 and 1 are accepted.


|


|-
|-
| '''Prune Output'''<br>''(PruneOutput)''
|'''MatchAnyValues''' (MatchAnyValues)
|
|
When set, the output mutliblock dataset will be pruned to remove empty
nodes. On by default.


| 1
|
|
Only the values 0 and 1 are accepted.
0
 
|
Accepts boolean values (0 or 1).


|}
|}


==Crop==


==Extract CTH Parts==
Efficiently extract an area/volume of interest from a 2-d image or 3-d volume.The Crop filter
 
extracts an area/volume of interest from a 2D image or a
 
3D volume by allowing the user to specify the minimum and
Create a surface from a CTH volume fraction.
maximum extents of each dimension of the data. Both the
 
input and output of this filter are uniform rectilinear
Extract CTH Parts is a specialized filter for visualizing the data from a CTH simulation. It first converts the selected cell-centered arrays to point-centered ones. It then contours each array at a value of 0.5. The user has the option of clipping the resulting surface(s) with a plane. This filter only operates on unstructured data. It produces polygonal output.<br>
data.


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 2,066: Line 2,499:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Double Volume Arrays'''<br>''(AddDoubleVolumeArrayName)''
|'''Input''' (Input)
|
This property specifies the input to the Crop
filter.
|
|
This property specifies the name(s) of the volume fraction array(s) for generating parts.


|
|
|
Accepts input of following types:
An array of scalars is required.
* vtkImageData
 
 
|-
|-
| '''Float Volume Arrays'''<br>''(AddFloatVolumeArrayName)''
|'''OutputWholeExtent''' (OutputWholeExtent)
|
|
This property specifies the name(s) of the volume fraction array(s) for generating parts.
This property gives the minimum and maximum point index
 
(extent) in each dimension for the output dataset.
|
|
0 0 0 0 0 0
|
|
An array of scalars is required.
The value(s) must lie within the structured-extents of the input dataset.


|}


|-
==Curvature==
| '''Unsigned Character Volume Arrays'''<br>''(AddUnsignedCharVolumeArrayName)''
|
This property specifies the name(s) of the volume fraction array(s) for generating parts.


|
This filter will compute the Gaussian or mean curvature of the mesh at each point.The
|
Curvature filter computes the curvature at each point in a
An array of scalars is required.
polygonal data set. This filter supports both Gaussian and
mean curvatures. ; the type can be selected from the
Curvature type menu button.


{| class="PropertiesTable" border="1" cellpadding="5"
|-
| '''Property'''
| '''Description'''
| '''Default Value(s)'''
| '''Restrictions'''


|-
|-
| '''Clip Type'''<br>''(ClipPlane)''
|'''Input''' (Input)
|
This property specifies the input to the Curvature
filter.
|
|
This property specifies whether to clip the dataset, and if so, it also specifies the parameters of the plane with which to clip.


|
|
|
Accepts input of following types:
The value must be set to one of the following: None, Plane, Box, Sphere.
* vtkPolyData
 
 
|-
|-
| '''Input'''<br>''(Input)''
|'''InvertMeanCurvature''' (InvertMeanCurvature)
|
|
This property specifies the input to the Extract CTH Parts filter.
If this property is set to 1, the mean curvature
 
calculation will be inverted. This is useful for meshes with
inward-pointing normals.
|
|
0
|
|
The selected object must be the result of the following: sources (includes readers), filters.
Accepts boolean values (0 or 1).
 
 
The dataset must contain a cell array with 1 components.
 
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.
 
 
|-
|-
| '''Volume Fraction Value'''<br>''(VolumeFractionSurfaceValue)''
|'''CurvatureType''' (CurvatureType)
|
This propery specifies which type of curvature to
compute.
|
|
The value of this property is the volume fraction value for the surface.
0
 
| 0.1
|
|
The value must be greater than or equal to 0 and less than or equal to 1.
The value(s) is an enumeration of the following:
 
* Gaussian (0)
* Mean (1)


|}
|}


==D3==


==Extract Cells By Region==
Repartition a data set into load-balanced spatially convex regions. Create ghost cells if requested.The D3 filter is
 
available when ParaView is run in parallel. It operates on
 
any type of data set to evenly divide it across the
This filter extracts cells that are inside/outside a region or at a region boundary.
processors into spatially contiguous regions. The output
 
of this filter is of type unstructured
This filter extracts from its input dataset all cells that are either completely inside or outside of a specified region (implicit function). On output, the filter generates an unstructured grid.<br>
grid.
To use this filter you must specify a region  (implicit function). You must also specify whethter to extract cells lying inside or outside of the region. An option exists to extract cells that are neither inside or outside (i.e., boundary).<br>


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 2,149: Line 2,586:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
| '''Extract intersected'''<br>''(Extract intersected)''
|
This parameter controls whether to extract cells that are on the boundary of the region.
| 0
|
Only the values 0 and 1 are accepted.


|-
|-
| '''Extract only intersected'''<br>''(Extract only intersected)''
|'''Input''' (Input)
|
|
This parameter controls whether to extract only cells that are on the boundary of the region. If this parameter is set, the Extraction Side parameter is ignored. If Extract Intersected is off, this parameter has no effect.
This property specifies the input to the D3
 
filter.
| 0
|
|
Only the values 0 and 1 are accepted.


|-
| '''Extraction Side'''<br>''(ExtractInside)''
|
This parameter controls whether to extract cells that are inside or outside the region.
| 1
|
|
The value must be one of the following: outside (0), inside (1).
Accepts input of following types:
 
* vtkDataSet
 
|-
|-
| '''Intersect With'''<br>''(ImplicitFunction)''
|'''BoundaryMode''' (BoundaryMode)
|
|
This property sets the region used to extract cells.
This property determines how cells that lie on processor
 
boundaries are handled. The "Assign cells uniquely" option assigns each
boundary cell to exactly one process, which is useful for isosurfacing.
Selecting "Duplicate cells" causes the cells on the boundaries to be
copied to each process that shares that boundary. The "Divide cells"
option breaks cells across process boundary lines so that pieces of the
cell lie in different processes. This option is useful for volume
rendering.
|
|
0
|
|
The value must be set to one of the following: Plane, Box, Sphere.
The value(s) is an enumeration of the following:
 
* Assign cells uniquely (0)
 
* Duplicate cells (1)
* Divide cells (2)
|-
|-
| '''Input'''<br>''(Input)''
|'''Minimal Memory''' (UseMinimalMemory)
|
|
This property specifies the input to the Slice filter.
If this property is set to 1, the D3 filter requires
 
communication routines to use minimal memory than without this
restriction.
|
|
0
|
|
The selected object must be the result of the following: sources (includes readers), filters.
Accepts boolean values (0 or 1).
 
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.
 


|}
|}


==Decimate==


==Extract Edges==
Simplify a polygonal model using an adaptive edge collapse algorithm. This filter works with triangles only.
 
The Decimate filter reduces the number of triangles in a
 
polygonal data set. Because this filter only operates on
Extract edges of 2D and 3D cells as lines.
triangles, first run the Triangulate filter on a dataset
 
that contains polygons other than
The Extract Edges filter produces a wireframe version of the input dataset by extracting all the edges of the dataset's cells as lines. This filter operates on any type of data set and produces polygonal output.<br>
triangles.


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 2,218: Line 2,643:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
This property specifies the input to the Decimate
filter.
|
|
This property specifies the input to the Extract Edges filter.


|
|
Accepts input of following types:
* vtkPolyData
|-
|'''TargetReduction''' (TargetReduction)
|
This property specifies the desired reduction in the
total number of polygons in the output dataset. For example, if the
TargetReduction value is 0.9, the Decimate filter will attempt to
produce an output dataset that is 10% the size of the
input.)
|
0.9
|
|
The selected object must be the result of the following: sources (includes readers), filters.


|-
|'''PreserveTopology''' (PreserveTopology)
|
If this property is set to 1, decimation will not split
the dataset or produce holes, but it may keep the filter from reaching
the reduction target. If it is set to 0, better reduction can occur
(reaching the reduction target), but holes in the model may be
produced.
|
0
|
Accepts boolean values (0 or 1).
|-
|'''FeatureAngle''' (FeatureAngle)
|
The value of this property is used in determining where
the data set may be split. If the angle between two adjacent triangles
is greater than or equal to the FeatureAngle value, then their boundary
is considered a feature edge where the dataset can be
split.
|
15.0
|


The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.
|-
 
|'''BoundaryVertexDeletion''' (BoundaryVertexDeletion)
|
If this property is set to 1, then vertices on the
boundary of the dataset can be removed. Setting the value of this
property to 0 preserves the boundary of the dataset, but it may cause
the filter not to reach its reduction target.
|
1
|
Accepts boolean values (0 or 1).


|}
|}


==Delaunay 2D==


==Extract Generic Dataset Surface==
Create 2D Delaunay triangulation of input points. It expects a vtkPointSet as input and produces vtkPolyData as output. The points are expected to be in a mostly planar distribution.
 
Delaunay2D is a filter that constructs a 2D Delaunay
 
triangulation from a list of input points. These points
Extract geometry from a higher-order dataset
may be represented by any dataset of type vtkPointSet and
 
subclasses. The output of the filter is a polygonal
Extract geometry from a higher-order dataset.<br>
dataset containing a triangle mesh. The 2D Delaunay
triangulation is defined as the triangulation that
satisfies the Delaunay criterion for n-dimensional
simplexes (in this case n=2 and the simplexes are
triangles). This criterion states that a circumsphere of
each simplex in a triangulation contains only the n+1
defining points of the simplex. In two dimensions, this
translates into an optimal triangulation. That is, the
maximum interior angle of any triangle is less than or
equal to that of any possible triangulation. Delaunay
triangulations are used to build topological structures
from unorganized (or unstructured) points. The input to
this filter is a list of points specified in 3D, even
though the triangulation is 2D. Thus the triangulation is
constructed in the x-y plane, and the z coordinate is
ignored (although carried through to the output). You can
use the option ProjectionPlaneMode in order to compute the
best-fitting plane to the set of points, project the
points and that plane and then perform the triangulation
using their projected positions and then use it as the
plane in which the triangulation is performed. The
Delaunay triangulation can be numerically sensitive in
some cases. To prevent problems, try to avoid injecting
points that will result in triangles with bad aspect
ratios (1000:1 or greater). In practice this means
inserting points that are "widely dispersed", and enables
smooth transition of triangle sizes throughout the mesh.
(You may even want to add extra points to create a better
point distribution.) If numerical problems are present,
you will see a warning message to this effect at the end
of the triangulation process. Warning: Points arranged on
a regular lattice (termed degenerate cases) can be
triangulated in more than one way (at least according to
the Delaunay criterion). The choice of triangulation (as
implemented by this algorithm) depends on the order of the
input points. The first three points will form a triangle;
other degenerate points will not break this triangle.
Points that are coincident (or nearly so) may be discarded
by the algorithm. This is because the Delaunay
triangulation requires unique input points. The output of
the Delaunay triangulation is supposedly a convex hull. In
certain cases this implementation may not generate the
convex hull.


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 2,247: Line 2,761:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
This property specifies the input dataset to the
Delaunay 2D filter.
|
|
Set the input to the Generic Geometry Filter.


|
|
Accepts input of following types:
* vtkPointSet
|-
|'''ProjectionPlaneMode''' (ProjectionPlaneMode)
|
This property determines type of projection plane to use
in performing the triangulation.
|
0
|
The value(s) is an enumeration of the following:
* XY Plane (0)
* Best-Fitting Plane (2)
|-
|'''Alpha''' (Alpha)
|
The value of this property controls the output of this
filter. For a non-zero alpha value, only edges or triangles contained
within a sphere centered at mesh vertices will be output. Otherwise,
only triangles will be output.
|
0.0
|
|
The selected object must be the result of the following: sources (includes readers), filters.


|-
|'''Tolerance''' (Tolerance)
|
This property specifies a tolerance to control
discarding of closely spaced points. This tolerance is specified as a
fraction of the diagonal length of the bounding box of the
points.
|
0.00001
|


The selected dataset must be one of the following types (or a subclass of one of them): vtkGenericDataSet.
|-
 
|'''Offset''' (Offset)
|
This property is a multiplier to control the size of the
initial, bounding Delaunay triangulation.
|
1.0
|


|-
|-
| '''Pass Through Cell Ids'''<br>''(PassThroughCellIds)''
|'''BoundingTriangulation''' (BoundingTriangulation)
|
|
Select whether to forward original ids.
If this property is set to 1, bounding triangulation
 
points (and associated triangles) are included in the output. These are
| 1
introduced as an initial triangulation to begin the triangulation
process. This feature is nice for debugging output.
|
0
|
|
Only the values 0 and 1 are accepted.
Accepts boolean values (0 or 1).
 


|}
|}


==Delaunay 3D==


==Extract Level==
Create a 3D Delaunay triangulation of input points. It expects a vtkPointSet as input and produces vtkUnstructuredGrid as output.Delaunay3D is a filter that constructs
 
a 3D Delaunay triangulation from a list of input points. These points may be
 
represented by any dataset of type vtkPointSet and subclasses. The output of
This filter extracts a range of groups from a hierarchical dataset.
the filter is an unstructured grid dataset. Usually the output is a tetrahedral
 
mesh, but if a non-zero alpha distance value is specified (called the "alpha"
This filter extracts a range of levels from a hierarchical dataset<br>
value), then only tetrahedra, triangles, edges, and vertices lying within the
alpha radius are output. In other words, non-zero alpha values may result in
arbitrary combinations of tetrahedra, triangles, lines, and vertices. (The
notion of alpha value is derived from Edelsbrunner's work on "alpha shapes".)
The 3D Delaunay triangulation is defined as the triangulation that satisfies
the Delaunay criterion for n-dimensional simplexes (in this case n=3 and the
simplexes are tetrahedra). This criterion states that a circumsphere of each
simplex in a triangulation contains only the n+1 defining points of the
simplex. (See text for more information.) While in two dimensions this
translates into an "optimal" triangulation, this is not true in 3D, since a
measurement for optimality in 3D is not agreed on. Delaunay triangulations are
used to build topological structures from unorganized (or unstructured) points.
The input to this filter is a list of points specified in 3D. (If you wish to
create 2D triangulations see Delaunay2D.) The output is an unstructured grid.
The Delaunay triangulation can be numerically sensitive. To prevent problems,
try to avoid injecting points that will result in triangles with bad aspect
ratios (1000:1 or greater). In practice this means inserting points that are
"widely dispersed", and enables smooth transition of triangle sizes throughout
the mesh. (You may even want to add extra points to create a better point
distribution.) If numerical problems are present, you will see a warning
message to this effect at the end of the triangulation process. Warning: Points
arranged on a regular lattice (termed degenerate cases) can be triangulated in
more than one way (at least according to the Delaunay criterion). The choice of
triangulation (as implemented by this algorithm) depends on the order of the
input points. The first four points will form a tetrahedron; other degenerate
points (relative to this initial tetrahedron) will not break it. Points that
are coincident (or nearly so) may be discarded by the algorithm. This is
because the Delaunay triangulation requires unique input points. You can
control the definition of coincidence with the "Tolerance" instance variable.
The output of the Delaunay triangulation is supposedly a convex hull. In
certain cases this implementation may not generate the convex hull. This
behavior can be controlled by the Offset instance variable. Offset is a
multiplier used to control the size of the initial triangulation. The larger
the offset value, the more likely you will generate a convex hull; and the more
likely you are to see numerical problems. The implementation of this algorithm
varies from the 2D Delaunay algorithm (i.e., Delaunay2D) in an important way.
When points are injected into the triangulation, the search for the enclosing
tetrahedron is quite different. In the 3D case, the closest previously inserted
point point is found, and then the connected tetrahedra are searched to find
the containing one. (In 2D, a "walk" towards the enclosing triangle is
performed.) If the triangulation is Delaunay, then an enclosing tetrahedron
will be found. However, in degenerate cases an enclosing tetrahedron may not be
found and the point will be rejected.


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 2,286: Line 2,885:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
This property specifies the input dataset to the
Delaunay 3D filter.
|
|
This property specifies the input to the Extract Group filter.


|
|
Accepts input of following types:
* vtkPointSet
|-
|'''Alpha''' (Alpha)
|
This property specifies the alpha (or distance) value to
control the output of this filter. For a non-zero alpha value, only
edges, faces, or tetra contained within the circumsphere (of radius
alpha) will be output. Otherwise, only tetrahedra will be
output.
|
0.0
|
|
The selected object must be the result of the following: sources (includes readers), filters.
The selected dataset must be one of the following types (or a subclass of one of them): vtkHierarchicalBoxDataSet.


|-
|-
| '''Levels'''<br>''(Levels)''
|'''Tolerance''' (Tolerance)
|
|
This property lists the levels to extract
This property specifies a tolerance to control
from the input hierarchical dataset.
discarding of closely spaced points. This tolerance is specified as a
 
fraction of the diagonal length of the bounding box of the
points.
|
|
0.001
|
|
|}


==Extract Selection==
Extract different type of selections.
This filter extracts a set of cells/points given a selection.<br>
The selection can be obtained from a rubber-band selection<br>
(either cell, visible or in a frustum) or threshold selection<br>
and passed to the filter or specified by providing an ID list.<br>
{| class="PropertiesTable" border="1" cellpadding="5"
|-
| '''Property'''
| '''Description'''
| '''Default Value(s)'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Offset''' (Offset)
|
|
This property specifies the input from which the selection is extracted.
This property specifies a multiplier to control the size
 
of the initial, bounding Delaunay triangulation.
|
|
2.5
|
|
The selected object must be the result of the following: sources (includes readers), filters.
The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet, vtkTable.


|-
|-
| '''Preserve Topology'''<br>''(PreserveTopology)''
|'''BoundingTriangulation''' (BoundingTriangulation)
|
This boolean controls whether bounding triangulation
points (and associated triangles) are included in the output. (These
are introduced as an initial triangulation to begin the triangulation
process. This feature is nice for debugging output.)
|
0
|
Accepts boolean values (0 or 1).
|-
|'''AlphaTets''' (AlphaTets)
|
This boolean controls whether tetrahedrons which satisfy
the alpha criterion output when alpha is non-zero.
|
1
|
Accepts boolean values (0 or 1).
|-
|'''AlphaTris''' (AlphaTris)
|
This boolean controls whether triangles which satisfy
the alpha criterion output when alpha is non-zero.
|
|
If this property is set to 1 the output preserves the topology of its
1
input and adds an insidedness array to mark which cells are inside or
out. If 0 then the output is an unstructured grid which contains only
the subset of cells that are inside.
 
| 0
|
|
Only the values 0 and 1 are accepted.
Accepts boolean values (0 or 1).
 
 
|-
|-
| '''Selection'''<br>''(Selection)''
|'''AlphaLines''' (AlphaLines)
|
|
The input that provides the selection object.
This boolean controls whether lines which satisfy the
 
alpha criterion output when alpha is non-zero.
|
|
0
|
|
The selected object must be the result of the following: sources (includes readers), filters.
Accepts boolean values (0 or 1).
 
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkSelection.
 
 
|-
|-
| '''Show Bounds'''<br>''(ShowBounds)''
|'''AlphaVerts''' (AlphaVerts)
|
|
For frustum selection, if this property is set to 1 the output is the
This boolean controls whether vertices which satisfy the
outline of the frustum instead of the contents of the input that lie
alpha criterion are output when alpha is non-zero.
within the frustum.
|
 
0
| 0
|
|
Only the values 0 and 1 are accepted.
Accepts boolean values (0 or 1).
 


|}
|}


==Descriptive Statistics==


==Extract Subset==
Compute a statistical model of a dataset and/or assess the dataset with a statistical model.
 
This filter either computes a statistical model of a dataset or takes
 
such a model as its second input. Then, the model (however it is
Extract a subgrid from a structured grid with the option of setting subsample strides.
obtained) may optionally be used to assess the input dataset.&lt;p&gt;
 
This filter computes the min, max, mean, raw moments M2 through M4,
The Extract Grid filter returns a subgrid of a structured input data set (uniform rectilinear, curvilinear, or nonuniform rectilinear). The output data set type of this filter is the same as the input type.<br>
standard deviation, skewness, and kurtosis for each array you
select.&lt;p&gt; The model is simply a univariate Gaussian distribution
with the mean and standard deviation provided. Data is assessed using
this model by detrending the data (i.e., subtracting the mean) and then
dividing by the standard deviation. Thus the assessment is an array whose
entries are the number of standard deviations from the mean that each
input point lies.


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 2,393: Line 2,999:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Include Boundary'''<br>''(IncludeBoundary)''
|'''Input''' (Input)
|
The input to the filter. Arrays from this dataset will
be used for computing statistics and/or assessed by a statistical
model.
|
|
If the value of this property is 1, then if the sample rate in any dimension is greater than 1, the boundary indices of the input dataset will be passed to the output even if the boundary extent is not an even multiple of the sample rate in a given dimension.


| 0
|
|
Only the values 0 and 1 are accepted.
Accepts input of following types:
* vtkImageData
* vtkStructuredGrid
* vtkPolyData
* vtkUnstructuredGrid
* vtkTable
* vtkGraph
The dataset must contain a field array ()


|-
|'''ModelInput''' (ModelInput)
|
A previously-calculated model with which to assess a
separate dataset. This input is optional.
|


|
Accepts input of following types:
* vtkTable
* vtkMultiBlockDataSet
|-
|-
| '''Input'''<br>''(Input)''
|'''AttributeMode''' (AttributeMode)
|
|
This property specifies the input to the Extract Grid filter.
Specify which type of field data the arrays will be
 
drawn from.
|
|
0
|
|
The selected object must be the result of the following: sources (includes readers), filters.
The value must be field array name.
 
 
The selected dataset must be one of the following types (or a subclass of one of them): vtkImageData, vtkRectilinearGrid, vtkStructuredPoints, vtkStructuredGrid.
 
 
|-
|-
| '''Sample Rate I'''<br>''(SampleRateI)''
|'''Variables of Interest''' (SelectArrays)
|
Choose arrays whose entries will be used to form
observations for statistical analysis.
|
|
This property indicates the sampling rate in the I dimension. A value grater than 1 results in subsampling; every nth index will be included in the output.


| 1
|
|
The value must be greater than or equal to 1.


|-
|-
| '''Sample Rate J'''<br>''(SampleRateJ)''
|'''Task''' (Task)
|
|
This property indicates the sampling rate in the J dimension. A value grater than 1 results in subsampling; every nth index will be included in the output.
Specify the task to be performed: modeling and/or
 
assessment. &lt;ol&gt; &lt;li&gt; "Detailed model of input data,"
| 1
creates a set of output tables containing a calculated statistical
model of the &lt;b&gt;entire&lt;/b&gt; input dataset;&lt;/li&gt;
&lt;li&gt; "Model a subset of the data," creates an output table (or
tables) summarizing a &lt;b&gt;randomly-chosen subset&lt;/b&gt; of the
input dataset;&lt;/li&gt; &lt;li&gt; "Assess the data with a model,"
adds attributes to the first input dataset using a model provided on
the second input port; and&lt;/li&gt; &lt;li&gt; "Model and assess the
same data," is really just operations 2 and 3 above applied to the same
input dataset. The model is first trained using a fraction of the input
data and then the entire dataset is assessed using that
model.&lt;/li&gt; &lt;/ol&gt; When the task includes creating a model
(i.e., tasks 2, and 4), you may adjust the fraction of the input
dataset used for training. You should avoid using a large fraction of
the input data for training as you will then not be able to detect
overfitting. The &lt;i&gt;Training fraction&lt;/i&gt; setting will be
ignored for tasks 1 and 3.
|
3
|
|
The value must be greater than or equal to 1.
The value(s) is an enumeration of the following:
 
* Detailed model of input data (0)
 
* Model a subset of the data (1)
* Assess the data with a model (2)
* Model and assess the same data (3)
|-
|-
| '''Sample Rate K'''<br>''(SampleRateK)''
|'''TrainingFraction''' (TrainingFraction)
|
Specify the fraction of values from the input dataset to
be used for model fitting. The exact set of values is chosen at random
from the dataset.
|
|
This property indicates the sampling rate in the K dimension. A value grater than 1 results in subsampling; every nth index will be included in the output.
0.1
 
| 1
|
|
The value must be greater than or equal to 1.


|-
|-
| '''V OI'''<br>''(VOI)''
|'''Deviations should be''' (SignedDeviations)
|
|
This property specifies the minimum and maximum point indices along each of the I, J, and K axes; these values indicate the volume of interest (VOI). The output will have the (I,J,K) extent specified here.
Should the assessed values be signed deviations or
 
unsigned?
| 0 0 0 0 0 0
|
|
The values must lie within the extent of the input dataset.
0
 
|
The value(s) is an enumeration of the following:
* Unsigned (0)
* Signed (1)


|}
|}


==Elevation==


==Extract Surface==
Create point attribute array by projecting points onto an elevation vector.
 
The Elevation filter generates point scalar values for an
 
input dataset along a specified direction vector. The
Extract a 2D boundary surface using neighbor relations to eliminate internal faces.
Input menu allows the user to select the data set to which
 
this filter will be applied. Use the Scalar range entry
The Extract Surface filter extracts the polygons forming the outer surface of the input dataset. This filter operates on any type of data and produces polygonal data as output.<br>
boxes to specify the minimum and maximum scalar value to
be generated. The Low Point and High Point define a line
onto which each point of the data set is projected. The
minimum scalar value is associated with the Low Point, and
the maximum scalar value is associated with the High
Point. The scalar value for each point in the data set is
determined by the location along the line to which that
point projects.


{| class="PropertiesTable" border="1" cellpadding="5"
{| class="PropertiesTable" border="1" cellpadding="5"
Line 2,472: Line 3,122:
| '''Default Value(s)'''
| '''Default Value(s)'''
| '''Restrictions'''
| '''Restrictions'''
|-
|-
| '''Input'''<br>''(Input)''
|'''Input''' (Input)
|
This property specifies the input dataset to the
Elevation filter.
|
|
This property specifies the input to the Extract Surface filter.


|
|
Accepts input of following types:
* vtkDataSet
|-
|'''ScalarRange''' (ScalarRange)
|
This property determines the range into which scalars
will be mapped.
|
0 1
|
|
The selected object must be the result of the following: sources (includes readers), filters.
The selected dataset must be one of the following types (or a subclass of one of them): vtkDataSet.


|-
|-
| '''Nonlinear Subdivision Level'''<br>''(NonlinearSubdivisionLevel)''
|'''Low Point''' (LowPoint)
|
This property defines one end of the direction vector
(small scalar values).
|
0 0 0
|
|
If the input is an unstructured grid with nonlinear faces, this
parameter determines how many times the face is subdivided into
linear faces.  If 0, the output is the equivalent of its linear
couterpart (and the midpoints determining the nonlinear
interpolation are discarded).  If 1, the nonlinear face is
triangulated based on the midpoints.  If greater than 1, the
triangulated pieces are recursively subdivided to reach the
desired subdivision.  Setting the value to greater than 1 may
cause some point data to not be passed even if no quadratic faces
exist.  This option has no effect if the input is not an
unstructured grid.


| 1
The value must lie within the bounding box of the dataset.
|
The value must be greater than or equal to 0 and less than or equal to 4.


It will default to the min in each dimension.


|-
|-
| '''Piece Invariant'''<br>''(PieceInvariant)''
|'''High Point''' (HighPoint)
|
|
If the value of this property is set to 1, internal surfaces along process boundaries will be removed. NOTE: Enabling this option might cause multiple executions of the data source because more information is needed to remove internal surfaces.
This property defines the other end of the direction
 
vector (large scalar values).
| 1
|
0 0 1
|
|
Only the values 0 and 1 are accepted.


The value must lie within the bounding box of the dataset.


|}
It will default to the max in each dimension.




==FFT Of Selection Over Time==
|}


==Environment Annotation==


Extracts selection over time and plots the FFT
Allows annotation of user name, date/time, OS, and possibly filename.
Apply to any source. Gui allows manual selection of desired annotation options.
</