VTK  9.5.20250905
vtkHyperTreeGridSource.h
Go to the documentation of this file.
1// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
2// SPDX-License-Identifier: BSD-3-Clause
63#ifndef vtkHyperTreeGridSource_h
64#define vtkHyperTreeGridSource_h
65
66#include "vtkFiltersSourcesModule.h" // For export macro
68#include "vtkWrappingHints.h" // For VTK_MARSHALAUTO
69
70#include <map> // STL Header
71#include <string> // STL Header
72#include <vector> // STL Header
73
74VTK_ABI_NAMESPACE_BEGIN
75class vtkBitArray;
76class vtkDataArray;
78class vtkIdTypeArray;
81class vtkQuadric;
82
83class VTKFILTERSSOURCES_EXPORT VTK_MARSHALAUTO vtkHyperTreeGridSource
85{
86public:
88 void PrintSelf(ostream& os, vtkIndent indent) override;
89
91
96 unsigned int GetMaxDepth();
97
104 void SetMaxDepth(unsigned int levels);
105
107
110 vtkSetVector3Macro(Origin, double);
111 vtkGetVector3Macro(Origin, double);
113
115
118 vtkSetVector3Macro(GridScale, double);
119 vtkGetVector3Macro(GridScale, double);
120 void SetGridScale(double scale) { this->SetGridScale(scale, scale, scale); }
122
124
127 void SetDimensions(const unsigned int* dims);
128 void SetDimensions(unsigned int, unsigned int, unsigned int);
129 vtkGetVector3Macro(Dimensions, unsigned int);
131
133
137 vtkSetMacro(TransposedRootIndexing, bool);
138 vtkGetMacro(TransposedRootIndexing, bool);
142
144
147 vtkGetMacro(Orientation, unsigned int);
149
151
154 vtkSetClampMacro(BranchFactor, unsigned int, 2, 3);
155 vtkGetMacro(BranchFactor, unsigned int);
157
159
164 vtkSetMacro(UseDescriptor, bool);
165 vtkGetMacro(UseDescriptor, bool);
166 vtkBooleanMacro(UseDescriptor, bool);
168
170
175 vtkSetMacro(UseMask, bool);
176 vtkGetMacro(UseMask, bool);
177 vtkBooleanMacro(UseMask, bool);
179
181
186 vtkSetMacro(GenerateInterfaceFields, bool);
187 vtkGetMacro(GenerateInterfaceFields, bool);
188 vtkBooleanMacro(GenerateInterfaceFields, bool);
190
192
195 vtkSetStringMacro(Descriptor);
196 vtkGetStringMacro(Descriptor);
198
200
203 vtkSetStringMacro(Mask);
204 vtkGetStringMacro(Mask);
206
208
212 vtkGetObjectMacro(DescriptorBits, vtkBitArray);
214
219
221
224 virtual void SetMaskBits(vtkBitArray*);
225 vtkGetObjectMacro(MaskBits, vtkBitArray);
227
229
232 virtual void SetQuadric(vtkQuadric*);
233 vtkGetObjectMacro(Quadric, vtkQuadric);
235
237
240 void SetQuadricCoefficients(double[10]);
241 void GetQuadricCoefficients(double[10]);
244
249
251
257
258protected:
261
263
265
267
272
277
282
287 int treeIdx, int idx[3], int offset = 0);
288
295 vtkHyperTreeGridNonOrientedCursor* cursor, unsigned int level, int treeIdx, int childIdx,
296 int idx[3], int parentPos, int offset = 0);
297
302 vtkHyperTreeGridNonOrientedCursor* cursor, unsigned int level, int treeIdx, int childIdx,
303 int idx[3], int parentPos);
304
309 unsigned int level, int treeIdx, const int idx[3], double origin[3], double size[3]);
310
314 double EvaluateQuadric(double[3]);
315
316 double Origin[3];
317 double GridScale[3];
318 unsigned int Dimension;
319
320 unsigned int Dimensions[3];
322 unsigned int MaxDepth;
323
324 unsigned int Orientation;
325 unsigned int BranchFactor;
326 unsigned int BlockSize;
330
334
336 char* Mask;
337 std::vector<std::string> LevelDescriptors;
338 std::vector<std::string> LevelMasks;
339
342 std::vector<vtkIdType> LevelBitsIndex;
343 std::vector<vtkIdType> LevelBitsIndexCnt;
344
346 std::map<vtkIdType, vtkIdType> LevelZeroMaterialMap;
347
348 std::vector<int> LevelCounters;
349
351
353
354private:
356 void operator=(const vtkHyperTreeGridSource&) = delete;
357
358 // Multi-piece utilities
359 int Piece = 0;
360 int NumPieces = 1;
361 int CurrentTreeProcess = 0; // Track the process where next root trees should go
362
368 bool IsLevelDescriptorConsistent(bool isRootLevel, unsigned int nRefined, unsigned int nLeaves,
369 unsigned int nTotal, unsigned int nNextLevel, const std::ostringstream& descriptor);
370};
371
372VTK_ABI_NAMESPACE_END
373#endif
dynamic, self-adjusting array of bits
Definition vtkBitArray.h:29
abstract superclass for arrays of numeric data
general representation of visualization data
Superclass for algorithms that produce a hyper tree grid as output.
Objects for traversal a HyperTreeGrid.
Create a synthetic grid of hypertrees.
void SetDimensions(const unsigned int *dims)
Set/Get the number of root cells + 1 in each dimension of the grid.
void SetIndexingModeToIJK()
Specify whether indexing mode of grid root cells must be transposed to x-axis first,...
virtual void SetQuadric(vtkQuadric *)
Set/Get the quadric function.
virtual void SetMaskBits(vtkBitArray *)
Set/Get the bitarray used as a material mask.
std::vector< vtkIdType > LevelBitsIndex
int RequestData(vtkInformation *, vtkInformationVector **, vtkInformationVector *) override
This is called by the superclass.
int InitializeFromStringDescriptor()
Initialize grid from descriptor string when it is to be used.
static vtkHyperTreeGridSource * New()
void SetGridScale(double scale)
Set/Get the scale to be applied to root cells in each dimension of the grid.
void InitTreeFromDescriptor(vtkHyperTreeGrid *output, vtkHyperTreeGridNonOrientedCursor *cursor, int treeIdx, int idx[3], int offset=0)
Initialize tree grid from descriptor and call subdivide if needed.
vtkMTimeType GetMTime() override
Override GetMTime because we delegate to a vtkQuadric.
virtual void SetLevelZeroMaterialIndex(vtkIdTypeArray *)
Set the index array used to as a material mask.
double EvaluateQuadric(double[3])
Evaluate quadric at given point coordinates.
int FillOutputPortInformation(int, vtkInformation *) override
Define default input and output port types.
int RequestInformation(vtkInformation *, vtkInformationVector **, vtkInformationVector *) override
std::vector< vtkIdType > LevelBitsIndexCnt
unsigned int GetMaxDepth()
Return the maximum number of levels of the hypertree.
void SetDimensions(unsigned int, unsigned int, unsigned int)
Set/Get the number of root cells + 1 in each dimension of the grid.
void SetIndexingModeToKJI()
Specify whether indexing mode of grid root cells must be transposed to x-axis first,...
vtkBitArray * ConvertDescriptorStringToBitArray(const std::string &)
Helpers to convert string descriptors & mask to bit arrays.
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
vtkIdTypeArray * LevelZeroMaterialIndex
void SubdivideFromStringDescriptor(vtkHyperTreeGrid *output, vtkHyperTreeGridNonOrientedCursor *cursor, unsigned int level, int treeIdx, int childIdx, int idx[3], int parentPos, int offset=0)
Subdivide grid from descriptor string when it is to be used offset represents the offset reading in t...
std::vector< std::string > LevelMasks
void SubdivideFromBitsDescriptor(vtkHyperTreeGrid *output, vtkHyperTreeGridNonOrientedCursor *cursor, unsigned int level, int treeIdx, int childIdx, int idx[3], int parentPos)
Subdivide grid from descriptor string when it is to be used.
vtkBitArray * ConvertMaskStringToBitArray(const std::string &)
Helpers to convert string descriptors & mask to bit arrays.
int InitializeFromBitsDescriptor()
Initialize grid from bit array descriptors when it is to be used.
~vtkHyperTreeGridSource() override
void SubdivideFromQuadric(vtkHyperTreeGrid *output, vtkHyperTreeGridNonOrientedCursor *cursor, unsigned int level, int treeIdx, const int idx[3], double origin[3], double size[3])
Subdivide grid from quadric when descriptor is not used.
void SetMaxDepth(unsigned int levels)
Set the maximum number of levels of the hypertrees.
double * GetQuadricCoefficients()
Helpers to set/get the 10 coefficients of the quadric function.
std::map< vtkIdType, vtkIdType > LevelZeroMaterialMap
void GetQuadricCoefficients(double[10])
Helpers to set/get the 10 coefficients of the quadric function.
std::vector< std::string > LevelDescriptors
int ProcessTrees(vtkHyperTreeGrid *, vtkDataObject *) override
Main routine to process individual trees in the grid.
void SetQuadricCoefficients(double[10])
Helpers to set/get the 10 coefficients of the quadric function.
virtual void SetDescriptorBits(vtkBitArray *)
Set/Get the bitarray used to describe the grid.
A dataset containing a grid of vtkHyperTree instances arranged as a rectilinear grid.
dynamic, self-adjusting array of vtkIdType
abstract interface for implicit functions
a simple class to control print indentation
Definition vtkIndent.h:108
Store zero or more vtkInformation instances.
Store vtkAlgorithm input/output information.
evaluate implicit quadric function
Definition vtkQuadric.h:112
vtkTypeUInt32 vtkMTimeType
Definition vtkType.h:287
#define VTK_MARSHALAUTO