VTK  9.0.2
vtkAlgorithm.h
Go to the documentation of this file.
1 /*=========================================================================
2 
3  Program: Visualization Toolkit
4  Module: vtkAlgorithm.h
5 
6  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
7  All rights reserved.
8  See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
9 
10  This software is distributed WITHOUT ANY WARRANTY; without even
11  the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
12  PURPOSE. See the above copyright notice for more information.
13 
14 =========================================================================*/
41 #ifndef vtkAlgorithm_h
42 #define vtkAlgorithm_h
43 
44 #include "vtkCommonExecutionModelModule.h" // For export macro
45 #include "vtkObject.h"
46 
47 class vtkAbstractArray;
48 class vtkAlgorithmInternals;
49 class vtkAlgorithmOutput;
50 class vtkCollection;
51 class vtkDataArray;
52 class vtkDataObject;
53 class vtkExecutive;
54 class vtkInformation;
61 
62 class VTKCOMMONEXECUTIONMODEL_EXPORT vtkAlgorithm : public vtkObject
63 {
64 public:
65  static vtkAlgorithm* New();
66  vtkTypeMacro(vtkAlgorithm, vtkObject);
67  void PrintSelf(ostream& os, vtkIndent indent) override;
68 
90  {
93  DEFAULT_PRECISION
94  };
95 
101 
107 
113  virtual void SetExecutive(vtkExecutive* executive);
114 
139  vtkInformation* request, vtkInformationVector** inInfo, vtkInformationVector* outInfo);
140 
146  vtkInformation* request, vtkCollection* inInfo, vtkInformationVector* outInfo);
147 
153  virtual int ComputePipelineMTime(vtkInformation* request, vtkInformationVector** inInfoVec,
154  vtkInformationVector* outInfoVec, int requestFromOutputPort, vtkMTimeType* mtime);
155 
163  virtual int ModifyRequest(vtkInformation* request, int when);
164 
172 
180 
182 
185  vtkGetObjectMacro(Information, vtkInformation);
188 
193 
198 
200 
203  void Register(vtkObjectBase* o) override;
204  void UnRegister(vtkObjectBase* o) override;
206 
208 
212  vtkSetMacro(AbortExecute, vtkTypeBool);
213  vtkGetMacro(AbortExecute, vtkTypeBool);
214  vtkBooleanMacro(AbortExecute, vtkTypeBool);
216 
218 
221  vtkGetMacro(Progress, double);
223 
228  VTK_LEGACY(void SetProgress(double));
229 
235  void UpdateProgress(double amount);
236 
238 
250  void SetProgressShiftScale(double shift, double scale);
251  vtkGetMacro(ProgressShift, double);
252  vtkGetMacro(ProgressScale, double);
254 
256 
263  void SetProgressText(const char* ptext);
264  vtkGetStringMacro(ProgressText);
266 
268 
272  vtkGetMacro(ErrorCode, unsigned long);
274 
275  // left public for performance since it is used in inner loops
277 
307 
317 
331 
333 
342  int idx, int port, int connection, int fieldAssociation, const char* name);
344  int idx, int port, int connection, int fieldAssociation, int fieldAttributeType);
345  virtual void SetInputArrayToProcess(int idx, vtkInformation* info);
347 
371  virtual void SetInputArrayToProcess(int idx, int port, int connection,
372  const char* fieldAssociation, const char* attributeTypeorName);
373 
378 
379  // from here down are convenience methods that really are executive methods
380 
385 
391 
396  vtkDataObject* GetInputDataObject(int port, int connection);
397 
399 
412  virtual void SetInputConnection(int port, vtkAlgorithmOutput* input);
415 
417 
426  virtual void AddInputConnection(int port, vtkAlgorithmOutput* input);
429 
439  virtual void RemoveInputConnection(int port, vtkAlgorithmOutput* input);
440 
444  virtual void RemoveInputConnection(int port, int idx);
445 
449  virtual void RemoveAllInputConnections(int port);
450 
460  virtual void SetInputDataObject(vtkDataObject* data) { this->SetInputDataObject(0, data); }
461 
468  virtual void AddInputDataObject(vtkDataObject* data) { this->AddInputDataObject(0, data); }
469 
478 
483 
488 
493 
498  vtkAlgorithm* GetInputAlgorithm(int port, int index, int& algPort);
499 
504 
509 
515 
520 
530 
535 
544 
546 
549  virtual void Update(int port);
550  virtual void Update();
552 
575  virtual vtkTypeBool Update(int port, vtkInformationVector* requests);
576 
582  virtual vtkTypeBool Update(vtkInformation* requests);
583 
590  virtual int UpdatePiece(
591  int piece, int numPieces, int ghostLevels, const int extents[6] = nullptr);
592 
598  virtual int UpdateExtent(const int extents[6]);
599 
606  virtual int UpdateTimeStep(double time, int piece = -1, int numPieces = 1, int ghostLevels = 0,
607  const int extents[6] = nullptr);
608 
612  virtual void UpdateInformation();
613 
617  virtual void UpdateDataObject();
618 
622  virtual void PropagateUpdateExtent();
623 
627  virtual void UpdateWholeExtent();
628 
633  void ConvertTotalInputToPortConnection(int ind, int& port, int& conn);
634 
635  //======================================================================
636  // The following block of code is to support old style VTK applications. If
637  // you are using these calls there are better ways to do it in the new
638  // pipeline
639  //======================================================================
640 
642 
645  virtual void SetReleaseDataFlag(int);
646  virtual int GetReleaseDataFlag();
650 
651  //========================================================================
652 
654 
661  int UpdateExtentIsEmpty(vtkInformation* pinfo, int extentType);
663 
669 
671 
676  int* GetUpdateExtent() VTK_SIZEHINT(6) { return this->GetUpdateExtent(0); }
678  void GetUpdateExtent(int& x0, int& x1, int& y0, int& y1, int& z0, int& z1)
679  {
680  this->GetUpdateExtent(0, x0, x1, y0, y1, z0, z1);
681  }
682  void GetUpdateExtent(int port, int& x0, int& x1, int& y0, int& y1, int& z0, int& z1);
683  void GetUpdateExtent(int extent[6]) { this->GetUpdateExtent(0, extent); }
684  void GetUpdateExtent(int port, int extent[6]);
686 
688 
693  int GetUpdatePiece() { return this->GetUpdatePiece(0); }
697  int GetUpdateGhostLevel() { return this->GetUpdateGhostLevel(0); }
700 
702 
712  vtkGetObjectMacro(ProgressObserver, vtkProgressObserver);
714 
715 protected:
717  ~vtkAlgorithm() override;
718 
719  // Keys used to indicate that input/output port information has been
720  // filled.
722 
723  // Arbitrary extra information associated with this algorithm
725 
732 
739 
743  virtual void SetNumberOfInputPorts(int n);
744 
748  virtual void SetNumberOfOutputPorts(int n);
749 
750  // Helper methods to check input/output port index ranges.
751  int InputPortIndexInRange(int index, const char* action);
752  int OutputPortIndexInRange(int index, const char* action);
753 
758  int GetInputArrayAssociation(int idx, vtkInformationVector** inputVector);
759 
761 
769  int GetInputArrayAssociation(int idx, int connection, vtkInformationVector** inputVector);
772 
774 
780  int idx, vtkInformationVector** inputVector, int& association);
782 
784 
792  vtkDataArray* GetInputArrayToProcess(int idx, int connection, vtkInformationVector** inputVector);
794  int idx, int connection, vtkInformationVector** inputVector, int& association);
796  vtkDataArray* GetInputArrayToProcess(int idx, vtkDataObject* input, int& association);
798 
800 
806  int idx, vtkInformationVector** inputVector, int& association);
808 
810 
819  int idx, int connection, vtkInformationVector** inputVector);
821  int idx, int connection, vtkInformationVector** inputVector, int& association);
823  vtkAbstractArray* GetInputAbstractArrayToProcess(int idx, vtkDataObject* input, int& association);
825 
834 
842 
844 
848  vtkSetMacro(ErrorCode, unsigned long);
849  unsigned long ErrorCode;
851 
852  // Progress/Update handling
853  double Progress;
855 
856  // Garbage collection support.
858 
859  // executive methods below
860 
867  virtual void SetNthInputConnection(int port, int index, vtkAlgorithmOutput* input);
868 
875  virtual void SetNumberOfInputConnections(int port, int n);
876 
878 
886  {
887  this->SetInputDataObject(port, input);
888  }
890  {
891  this->AddInputDataObject(port, input);
892  }
893 
895 
896 private:
897  vtkExecutive* Executive;
898  vtkInformationVector* InputPortInformation;
899  vtkInformationVector* OutputPortInformation;
900  vtkAlgorithmInternals* AlgorithmInternal;
901  static void ConnectionAdd(
902  vtkAlgorithm* producer, int producerPort, vtkAlgorithm* consumer, int consumerPort);
903  static void ConnectionRemove(
904  vtkAlgorithm* producer, int producerPort, vtkAlgorithm* consumer, int consumerPort);
905  static void ConnectionRemoveAllInput(vtkAlgorithm* consumer, int port);
906  static void ConnectionRemoveAllOutput(vtkAlgorithm* producer, int port);
907 
908 private:
909  vtkAlgorithm(const vtkAlgorithm&) = delete;
910  void operator=(const vtkAlgorithm&) = delete;
911 
912  double ProgressShift;
913  double ProgressScale;
914 };
915 
916 #endif
Abstract superclass for all arrays.
Proxy object to connect input/output ports.
Superclass for all sources, filters, and sinks in VTK.
Definition: vtkAlgorithm.h:63
virtual void UpdateDataObject()
Create output object(s).
int GetUpdatePiece(int port)
void UpdateProgress(double amount)
Update the progress of the process object.
static vtkAlgorithm * New()
vtkDataObject * GetInputDataObject(int port, int connection)
Get the data object that will contain the algorithm input for the given port and given connection.
int GetInputArrayAssociation(int idx, vtkInformationVector **inputVector)
Get the assocition of the actual data array for the input array specified by idx, this is only reason...
virtual void RemoveInputConnection(int port, vtkAlgorithmOutput *input)
Remove a connection from the given input port index.
virtual void SetNumberOfOutputPorts(int n)
Set the number of output ports provided by the algorithm.
virtual void SetNthInputConnection(int port, int index, vtkAlgorithmOutput *input)
Replace the Nth connection on the given input port.
int GetUpdateGhostLevel()
Definition: vtkAlgorithm.h:697
static vtkInformationIntegerKey * PORT_REQUIREMENTS_FILLED()
void GetUpdateExtent(int port, int &x0, int &x1, int &y0, int &y1, int &z0, int &z1)
int GetInputArrayAssociation(int idx, vtkDataObject *input)
virtual void AddInputDataObject(vtkDataObject *data)
Definition: vtkAlgorithm.h:468
virtual void SetInputDataObject(vtkDataObject *data)
Definition: vtkAlgorithm.h:460
int UpdateExtentIsEmpty(vtkInformation *pinfo, int extentType)
int UpdateExtentIsEmpty(vtkInformation *pinfo, vtkDataObject *output)
This detects when the UpdateExtent will generate no data This condition is satisfied when the UpdateE...
void GetUpdateExtent(int extent[6])
Definition: vtkAlgorithm.h:683
int GetUpdatePiece()
These functions return the update extent for output ports that use piece extents.
Definition: vtkAlgorithm.h:693
vtkInformation * Information
Definition: vtkAlgorithm.h:724
vtkAbstractArray * GetInputAbstractArrayToProcess(int idx, vtkDataObject *input, int &association)
vtkExecutive * GetInputExecutive()
Equivalent to GetInputExecutive(0, 0)
Definition: vtkAlgorithm.h:519
virtual vtkTypeBool Update(vtkInformation *requests)
Convenience method to update an algorithm after passing requests to its first output port.
virtual int FillOutputPortInformation(int port, vtkInformation *info)
Fill the output port information objects for this algorithm.
virtual void RemoveAllInputConnections(int port)
Removes all input connections.
virtual int ComputePipelineMTime(vtkInformation *request, vtkInformationVector **inInfoVec, vtkInformationVector *outInfoVec, int requestFromOutputPort, vtkMTimeType *mtime)
A special version of ProcessRequest meant specifically for the pipeline modified time request.
vtkAbstractArray * GetInputAbstractArrayToProcess(int idx, vtkInformationVector **inputVector)
Get the actual data array for the input array specified by idx, this is only reasonable during the RE...
virtual void AddInputConnection(vtkAlgorithmOutput *input)
virtual vtkTypeBool Update(int port, vtkInformationVector *requests)
This method enables the passing of data requests to the algorithm to be used during execution (in add...
vtkAlgorithmOutput * GetInputConnection(int port, int index)
Get the algorithm output port connected to an input port.
int * GetUpdateExtent(int port)
vtkInformation * GetOutputPortInformation(int port)
Get the information object associated with an output port.
virtual int UpdatePiece(int piece, int numPieces, int ghostLevels, const int extents[6]=nullptr)
Convenience method to update an algorithm after passing requests to its first output port.
virtual void SetInputArrayToProcess(int idx, int port, int connection, const char *fieldAssociation, const char *attributeTypeorName)
String based versions of SetInputArrayToProcess().
virtual vtkTypeBool ProcessRequest(vtkInformation *request, vtkInformationVector **inInfo, vtkInformationVector *outInfo)
Upstream/Downstream requests form the generalized interface through which executives invoke a algorit...
int GetNumberOfOutputPorts()
Get the number of output ports provided by the algorithm.
virtual int ModifyRequest(vtkInformation *request, int when)
This method gives the algorithm a chance to modify the contents of a request before or after (specifi...
void ReleaseDataFlagOff()
void SetInputDataInternal(int port, vtkDataObject *input)
These methods are used by subclasses to implement methods to set data objects directly as input.
Definition: vtkAlgorithm.h:885
void UnRegister(vtkObjectBase *o) override
Decrease the reference count (release by another object).
int GetNumberOfInputPorts()
Get the number of input ports used by the algorithm.
int GetInputArrayAssociation(int idx, int connection, vtkInformationVector **inputVector)
Filters that have multiple connections on one port can use this signature.
vtkDataObject * GetOutputDataObject(int port)
Get the data object that will contain the algorithm output for the given port.
vtkAlgorithm * GetInputAlgorithm(int port, int index)
Returns the algorithm connected to a port-index pair.
vtkInformation * GetInputInformation()
Equivalent to GetInputInformation(0, 0)
Definition: vtkAlgorithm.h:534
void ReleaseDataFlagOn()
void SetProgressShiftScale(double shift, double scale)
Specify the shift and scale values to use to apply to the progress amount when UpdateProgress is call...
vtkDataArray * GetInputArrayToProcess(int idx, int connection, vtkInformationVector **inputVector)
Filters that have multiple connections on one port can use this signature.
vtkAlgorithm * GetInputAlgorithm()
Equivalent to GetInputAlgorithm(0, 0).
Definition: vtkAlgorithm.h:508
void SetProgress(double)
SetProgress is deprecated.
unsigned long ErrorCode
Definition: vtkAlgorithm.h:848
void GetUpdateExtent(int port, int extent[6])
int GetUpdateGhostLevel(int port)
virtual void SetInputArrayToProcess(int idx, int port, int connection, int fieldAssociation, const char *name)
Set the input data arrays that this algorithm will process.
virtual void AddInputDataObject(int port, vtkDataObject *data)
Add the data-object as an input to this given port.
vtkExecutive * GetInputExecutive(int port, int index)
Returns the executive associated with a particular input connection.
int OutputPortIndexInRange(int index, const char *action)
static void SetDefaultExecutivePrototype(vtkExecutive *proto)
If the DefaultExecutivePrototype is set, a copy of it is created in CreateDefaultExecutive() using Ne...
vtkAbstractArray * GetInputAbstractArrayToProcess(int idx, int connection, vtkInformationVector **inputVector)
Filters that have multiple connections on one port can use this signature.
vtkAbstractArray * GetInputAbstractArrayToProcess(int idx, vtkDataObject *input)
vtkDataArray * GetInputArrayToProcess(int idx, vtkInformationVector **inputVector)
Get the actual data array for the input array specified by idx, this is only reasonable during the RE...
vtkDataArray * GetInputArrayToProcess(int idx, vtkDataObject *input)
vtkDataArray * GetInputArrayToProcess(int idx, vtkInformationVector **inputVector, int &association)
void ReportReferences(vtkGarbageCollector *) override
vtkExecutive * GetExecutive()
Get this algorithm's executive.
char * ProgressText
Definition: vtkAlgorithm.h:854
vtkAlgorithm * GetInputAlgorithm(int port, int index, int &algPort)
Returns the algorithm and the output port index of that algorithm connected to a port-index pair.
vtkAbstractArray * GetInputAbstractArrayToProcess(int idx, vtkInformationVector **inputVector, int &association)
void SetProgressObserver(vtkProgressObserver *)
If an ProgressObserver is set, the algorithm will report progress through it rather than directly.
vtkDataArray * GetInputArrayToProcess(int idx, vtkDataObject *input, int &association)
virtual void SetInputArrayToProcess(int idx, vtkInformation *info)
virtual int FillInputPortInformation(int port, vtkInformation *info)
Fill the input port information objects for this algorithm.
virtual void UpdateWholeExtent()
Bring this algorithm's outputs up-to-date.
vtkDataArray * GetInputArrayToProcess(int idx, int connection, vtkInformationVector **inputVector, int &association)
virtual void SetNumberOfInputConnections(int port, int n)
Set the number of input connections on the given input port.
virtual void SetInputConnection(int port, vtkAlgorithmOutput *input)
Set the connection for the given input port index.
int GetTotalNumberOfInputConnections()
Get the total number of inputs for this algorithm.
virtual void SetInputConnection(vtkAlgorithmOutput *input)
void ConvertTotalInputToPortConnection(int ind, int &port, int &conn)
Convenience routine to convert from a linear ordering of input connections to a port/connection pair.
virtual void SetExecutive(vtkExecutive *executive)
Set this algorithm's executive.
int GetNumberOfInputConnections(int port)
Get the number of inputs currently connected to a port.
void SetProgressText(const char *ptext)
Set the current text message associated with the progress state.
vtkInformation * GetInputArrayFieldInformation(int idx, vtkInformationVector **inputVector)
This method takes in an index (as specified in SetInputArrayToProcess) and a pipeline information vec...
virtual void PropagateUpdateExtent()
Propagate meta-data upstream.
virtual void Update(int port)
Bring this algorithm's outputs up-to-date.
vtkTypeBool AbortExecute
Definition: vtkAlgorithm.h:272
virtual int UpdateExtent(const int extents[6])
Convenience method to update an algorithm after passing requests to its first output port.
void Register(vtkObjectBase *o) override
Participate in garbage collection.
vtkAlgorithmOutput * GetOutputPort()
Definition: vtkAlgorithm.h:477
int GetUpdateNumberOfPieces()
Definition: vtkAlgorithm.h:695
vtkTypeBool ProcessRequest(vtkInformation *request, vtkCollection *inInfo, vtkInformationVector *outInfo)
Version of ProcessRequest() that is wrapped.
vtkInformation * GetInputPortInformation(int port)
Get the information object associated with an input port.
DesiredOutputPrecision
Values used for setting the desired output precision for various algorithms.
Definition: vtkAlgorithm.h:90
virtual void SetReleaseDataFlag(int)
Turn release data flag on or off for all output ports.
virtual void SetInputDataObject(int port, vtkDataObject *data)
Sets the data-object as an input on the given port index.
void GetUpdateExtent(int &x0, int &x1, int &y0, int &y1, int &z0, int &z1)
Definition: vtkAlgorithm.h:678
vtkInformation * GetInputArrayInformation(int idx)
Get the info object for the specified input array to this algorithm.
vtkAbstractArray * GetInputAbstractArrayToProcess(int idx, int connection, vtkInformationVector **inputVector, int &association)
virtual void SetNumberOfInputPorts(int n)
Set the number of input ports used by the algorithm.
virtual void RemoveInputConnection(int port, int idx)
Remove a connection given by index idx.
virtual void SetInputArrayToProcess(int idx, int port, int connection, int fieldAssociation, int fieldAttributeType)
int HasExecutive()
Check whether this algorithm has an assigned executive.
vtkAlgorithmOutput * GetOutputPort(int index)
Get a proxy object corresponding to the given output port of this algorithm.
int * GetUpdateExtent()
These functions return the update extent for output ports that use 3D extents.
Definition: vtkAlgorithm.h:676
vtkInformation * GetOutputInformation(int port)
Return the information object that is associated with a particular output port.
vtkProgressObserver * ProgressObserver
Definition: vtkAlgorithm.h:894
virtual int GetReleaseDataFlag()
virtual void UpdateInformation()
Bring the algorithm's information up-to-date.
void AddInputDataInternal(int port, vtkDataObject *input)
Definition: vtkAlgorithm.h:889
~vtkAlgorithm() override
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
virtual vtkExecutive * CreateDefaultExecutive()
Create a default executive.
int GetUpdateNumberOfPieces(int port)
int InputPortIndexInRange(int index, const char *action)
double Progress
Definition: vtkAlgorithm.h:853
vtkInformation * GetInputInformation(int port, int index)
Return the information object that is associated with a particular input connection.
virtual int UpdateTimeStep(double time, int piece=-1, int numPieces=1, int ghostLevels=0, const int extents[6]=nullptr)
Convenience method to update an algorithm after passing requests to its first output port.
virtual void SetInformation(vtkInformation *)
virtual void Update()
static vtkExecutive * DefaultExecutivePrototype
Definition: vtkAlgorithm.h:877
virtual void AddInputConnection(int port, vtkAlgorithmOutput *input)
Add a connection to the given input port index.
void RemoveAllInputs()
Remove all the input data.
create and manipulate ordered lists of objects
Definition: vtkCollection.h:53
abstract superclass for arrays of numeric data
Definition: vtkDataArray.h:50
general representation of visualization data
Definition: vtkDataObject.h:60
Superclass for all pipeline executives in VTK.
Definition: vtkExecutive.h:47
Detect and break reference loops.
a simple class to control print indentation
Definition: vtkIndent.h:34
Key for integer values in vtkInformation.
Key for string values in vtkInformation.
Store zero or more vtkInformation instances.
Store vtkAlgorithm input/output information.
abstract base class for most VTK objects
Definition: vtkObjectBase.h:64
abstract base class for most VTK objects
Definition: vtkObject.h:63
Basic class to optionally replace vtkAlgorithm progress functionality.
static vtkInformationIntegerKey * INPUT_PORT()
static vtkInformationIntegerKey * INPUT_IS_OPTIONAL()
Keys used to specify input port requirements.
static vtkInformationIntegerKey * INPUT_CONNECTION()
static vtkInformationInformationVectorKey * INPUT_ARRAYS_TO_PROCESS()
static vtkInformationStringVectorKey * INPUT_REQUIRED_DATA_TYPE()
static vtkInformationInformationVectorKey * INPUT_REQUIRED_FIELDS()
static vtkInformationIntegerKey * CAN_HANDLE_PIECE_REQUEST()
Key that tells the pipeline that a particular algorithm can or cannot handle piece request.
static vtkInformationIntegerKey * CAN_PRODUCE_SUB_EXTENT()
This key tells the executive that a particular output port is capable of producing an arbitrary subex...
static vtkInformationIntegerKey * INPUT_IS_REPEATABLE()
@ info
Definition: vtkX3D.h:382
@ port
Definition: vtkX3D.h:453
@ scale
Definition: vtkX3D.h:235
@ time
Definition: vtkX3D.h:503
@ extent
Definition: vtkX3D.h:351
@ name
Definition: vtkX3D.h:225
@ index
Definition: vtkX3D.h:252
@ data
Definition: vtkX3D.h:321
int vtkTypeBool
Definition: vtkABI.h:69
vtkTypeUInt32 vtkMTimeType
Definition: vtkType.h:293
#define VTK_SIZEHINT(...)