Pipeline IDs

From ParaQ Wiki
Jump to navigationJump to search

Overview

Currently, there is no native support for unique identifiers in vtk/ParaView. There are many issues that relate to this.

Proposal

IDs are unique data types - they may not be the same as a typical DatArray.

  • Data objects such as vtkDataArray must be able to use IDs as accessors into their arrays.
  • IDs must be copied from input to output. It is unclear at this point if this requirement should be enforced by superclasses, or if it is a policy, and therefore responsibility lies with the filter programmer.
  • IDs must be able to be 'hidden', so that they won't clutter up the 'normal' array name space. Whenever possible, users should be able to ignore this data.
  • IDs must be able to be 'shown', if the user wants to color the data using these.

Pedigree ID

A pedigree ID is defined as the ID which relates input objects to output objects. It is used to follow the 'pedigree' of an object. This ID is applied by a filter, in a way defined by its operation. Two examples illustrate its use.

Constraints

  • A Pedigree ID is copied from parent to child. Any filter that creates cells that have a parent/child relationship should copy the Pedigree ID appropriately.
  • A Pedigree ID may not be arbitrarily overwritten by any filter in the pipeline.
  • Certain operations, such as interpolation, should never be performed on a Pedigree ID.

Unique IDs

A Unique ID is an identifier for points or cells which uniquely defines each in a parallel data set. Any time two points or cells have the same Unique ID, they are considered to be the same. At present, the D3 filter is the only filter that uses this capability, and we are looking into whether or not the general capability is needed, or if this should be implemented only inside the D3 filter.

Constraints

  • The set of Unique IDs needn't be contiguous.
  • There is no relationship between a filter's input Unique ID set and its output Unique ID set.
  • If a filter divides or creates cells, then the cell Unique ID array must be rebuilt.
  • If a filter interpolates or creates points, then the point Unique ID array must be rebuilt.
  • The Unique ID data need not exist, and does not have to be passed along by filters. Not passing this data should be the default behavior.

Other IDs

If the Pedigree ID and the Source ID are not sufficient, a filter may create its own named ID. It may not overwrite other ID types.

Retrieved from "http://www.paraview.org/ParaView/index.php?title=Pipeline_IDs&oldid=772"