VTK
vtkGenericEnSightReader.h
Go to the documentation of this file.
1 /*=========================================================================
2 
3  Program: Visualization Toolkit
4  Module: vtkGenericEnSightReader.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 =========================================================================*/
23 #ifndef vtkGenericEnSightReader_h
24 #define vtkGenericEnSightReader_h
25 
26 #include "vtkIOEnSightModule.h" // For export macro
28 
29 class vtkCallbackCommand;
33 
34 class TranslationTableType;
35 
36 // Cell/Point Ids store mode:
37 // Sparse Mode is supposed to be for a large number of distributed processes (Unstructured)
38 // Non Sparse Mode is supposed to be for a small number of distributed processes (Unstructured)
39 // Implicit Mode is for Structured Data
41 {
46 };
47 
48 class VTKIOENSIGHT_EXPORT vtkGenericEnSightReader : public vtkMultiBlockDataSetAlgorithm
49 {
50 public:
51  static vtkGenericEnSightReader *New();
53  void PrintSelf(ostream& os, vtkIndent indent) override;
54 
56 
59  void SetCaseFileName(const char* fileName);
60  vtkGetStringMacro(CaseFileName);
62 
64 
67  vtkSetStringMacro(FilePath);
68  vtkGetStringMacro(FilePath);
70 
72 
75  vtkGetMacro(EnSightVersion, int);
77 
79 
82  vtkGetMacro(NumberOfVariables, int);
83  vtkGetMacro(NumberOfComplexVariables, int);
85 
87 
90  int GetNumberOfVariables(int type); // returns -1 if unknown type specified
91  vtkGetMacro(NumberOfScalarsPerNode, int);
92  vtkGetMacro(NumberOfVectorsPerNode, int);
93  vtkGetMacro(NumberOfTensorsSymmPerNode, int);
94  vtkGetMacro(NumberOfScalarsPerElement, int);
95  vtkGetMacro(NumberOfVectorsPerElement, int);
96  vtkGetMacro(NumberOfTensorsSymmPerElement, int);
97  vtkGetMacro(NumberOfScalarsPerMeasuredNode, int);
98  vtkGetMacro(NumberOfVectorsPerMeasuredNode, int);
99  vtkGetMacro(NumberOfComplexScalarsPerNode, int);
100  vtkGetMacro(NumberOfComplexVectorsPerNode, int);
101  vtkGetMacro(NumberOfComplexScalarsPerElement, int);
102  vtkGetMacro(NumberOfComplexVectorsPerElement, int);
104 
108  const char* GetDescription(int n);
109 
113  const char* GetComplexDescription(int n);
114 
125  const char* GetDescription(int n, int type);
126 
128 
131  int GetVariableType(int n);
132  int GetComplexVariableType(int n);
134 
136 
139  virtual void SetTimeValue(float value);
140  vtkGetMacro(TimeValue, float);
142 
144 
147  vtkGetMacro(MinimumTimeValue, float);
148  vtkGetMacro(MaximumTimeValue, float);
150 
152 
155  vtkGetObjectMacro(TimeSets, vtkDataArrayCollection);
157 
164  int DetermineEnSightVersion(int quiet=0);
165 
167 
170  vtkBooleanMacro(ReadAllVariables, vtkTypeBool);
171  vtkSetMacro(ReadAllVariables, vtkTypeBool);
172  vtkGetMacro(ReadAllVariables, vtkTypeBool);
174 
176 
180  vtkGetObjectMacro(PointDataArraySelection, vtkDataArraySelection);
181  vtkGetObjectMacro(CellDataArraySelection, vtkDataArraySelection);
183 
185 
188  int GetNumberOfPointArrays();
189  int GetNumberOfCellArrays();
191 
193 
197  const char* GetPointArrayName(int index);
198  const char* GetCellArrayName(int index);
200 
202 
206  int GetPointArrayStatus(const char* name);
207  int GetCellArrayStatus(const char* name);
208  void SetPointArrayStatus(const char* name, int status);
209  void SetCellArrayStatus(const char* name, int status);
211 
213  {
214  ENSIGHT_6 = 0,
215  ENSIGHT_6_BINARY = 1,
216  ENSIGHT_GOLD = 2,
217  ENSIGHT_GOLD_BINARY = 3,
218  ENSIGHT_MASTER_SERVER = 4
219  };
220 
222 
228  void SetByteOrderToBigEndian();
229  void SetByteOrderToLittleEndian();
230  vtkSetMacro(ByteOrder, int);
231  vtkGetMacro(ByteOrder, int);
232  const char *GetByteOrderAsString();
234 
235  enum
236  {
237  FILE_BIG_ENDIAN=0,
238  FILE_LITTLE_ENDIAN=1,
239  FILE_UNKNOWN_ENDIAN=2
240  };
241 
243 
247  vtkGetStringMacro(GeometryFileName);
249 
251 
263  vtkSetMacro(ParticleCoordinatesByIndex, vtkTypeBool);
264  vtkGetMacro(ParticleCoordinatesByIndex, vtkTypeBool);
265  vtkBooleanMacro(ParticleCoordinatesByIndex, vtkTypeBool);
267 
272  static bool IsEnSightFile(const char *casefilename);
273 
277  virtual int CanReadFile(const char *casefilename);
278 
279 //THIB
280 vtkGenericEnSightReader* GetReader() { return this->Reader; }
281 
282 
283 protected:
285  ~vtkGenericEnSightReader() override;
286 
290  vtkInformationVector*) override;
293  vtkInformationVector*) override;
294 
300  virtual void ClearForNewCaseFileName();
301 
306  int ReadLine(char result[256]);
307 
312  int ReadBinaryLine(char result[80]);
313 
314  // Internal function that skips blank lines and reads the 1st
315  // non-blank line it finds (up to 256 characters).
316  // Returns 0 is there was an error.
317  int ReadNextDataLine(char result[256]);
318 
320 
323  vtkSetStringMacro(GeometryFileName);
325 
327 
330  void AddVariableDescription(const char* description);
331  void AddComplexVariableDescription(const char* description);
333 
335 
338  void AddVariableType(int variableType);
339  void AddComplexVariableType(int variableType);
341 
343 
347  int ReplaceWildcards(char* fileName, int timeSet, int fileSet);
348  void ReplaceWildcardsHelper(char* fileName, int num);
350 
351  // Callback registered with the SelectionObserver.
352  static void SelectionModifiedCallback(vtkObject* caller, unsigned long eid,
353  void* clientdata, void* calldata);
354  void SelectionModified();
355 
356  // Utility to create argument for vtkDataArraySelection::SetArrays.
357  char** CreateStringArray(int numStrings);
358  void DestroyStringArray(int numStrings, char** strings);
359 
360  // Fill the vtkDataArraySelection objects with the current set of
361  // EnSight variables.
362  void SetDataArraySelectionSetsFromVariables();
363 
364  // Fill the vtkDataArraySelection objects with the current set of
365  // arrays in the internal EnSight reader.
366  void SetDataArraySelectionSetsFromReader();
367 
368  // Fill the internal EnSight reader's vtkDataArraySelection objects
369  // from those in this object.
370  void SetReaderDataArraySelectionSetsFromSelf();
371 
372  istream* IS;
373  FILE *IFile;
375 
378  char* FilePath;
379 
380  // array of types (one entry per instance of variable type in case file)
383 
384  // pointers to lists of descriptions
387 
390 
391  // number of file names / descriptions per type
404 
405  float TimeValue;
408 
409  // Flag for whether TimeValue has been set.
411 
413  virtual void SetTimeSets(vtkDataArrayCollection*);
414 
416 
419 
420  // The EnSight file version being read. Valid after
421  // UpdateInformation. Value is -1 for unknown version.
423 
424  // The array selections. These map over the variables and complex
425  // variables to hide the details of EnSight behind VTK terminology.
428 
429  // The observer to modify this object when the array selections are
430  // modified.
432 
433  // Whether the SelectionModified callback should invoke Modified.
434  // This is used when we are copying to/from the internal reader.
436 
437  // Insert a partId and return the 'realId' that should be used.
438  int InsertNewPartId(int partId);
439 
440  // Wrapper around an stl map
441  TranslationTableType *TranslationTable;
442 
443 private:
445  void operator=(const vtkGenericEnSightReader&) = delete;
446 };
447 
448 #endif
vtkDataArrayCollection * TimeSets
vtkCallbackCommand * SelectionObserver
abstract base class for most VTK objects
Definition: vtkObject.h:53
Store vtkAlgorithm input/output information.
EnsightReaderCellIdMode
Superclass for algorithms that produce only vtkMultiBlockDataSet as output.
virtual int RequestData(vtkInformation *, vtkInformationVector **, vtkInformationVector *)
This is called by the superclass.
int FillOutputPortInformation(int port, vtkInformation *info) override
Fill the output port information objects for this algorithm.
static vtkMultiBlockDataSetAlgorithm * New()
int vtkTypeBool
Definition: vtkABI.h:69
vtkDataArraySelection * PointDataArraySelection
supports function callbacks
a simple class to control print indentation
Definition: vtkIndent.h:33
Store on/off settings for data arrays for a vtkSource.
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
TranslationTableType * TranslationTable
vtkGenericEnSightReader * Reader
maintain an ordered list of IdList objects
maintain an ordered list of dataarray objects
Store zero or more vtkInformation instances.
vtkDataArraySelection * CellDataArraySelection
class to read any type of EnSight files
vtkGenericEnSightReader * GetReader()
virtual int RequestInformation(vtkInformation *, vtkInformationVector **, vtkInformationVector *)
This is called by the superclass.