Nektar++
Public Member Functions | Static Public Member Functions | Static Public Attributes | Protected Member Functions | List of all members
Nektar::FieldUtils::OutputTecplotBinary Class Reference

Tecplot output class, specifically for binary field output. More...

#include <OutputTecplot.h>

Inheritance diagram for Nektar::FieldUtils::OutputTecplotBinary:
[legend]

Public Member Functions

 OutputTecplotBinary (FieldSharedPtr f)
 
virtual ~OutputTecplotBinary ()
 
- Public Member Functions inherited from Nektar::FieldUtils::OutputTecplot
 OutputTecplot (FieldSharedPtr f)
 
virtual ~OutputTecplot ()
 
virtual void Process (po::variables_map &vm)
 Write fld to output file. More...
 
virtual std::string GetModuleName ()
 
- Public Member Functions inherited from Nektar::FieldUtils::OutputFileBase
 OutputFileBase (FieldSharedPtr f)
 
virtual ~OutputFileBase ()
 
virtual std::string GetModuleDescription ()
 
virtual ModulePriority GetModulePriority ()
 
- Public Member Functions inherited from Nektar::FieldUtils::OutputModule
 OutputModule (FieldSharedPtr p_f)
 
FIELD_UTILS_EXPORT void OpenStream ()
 Open a file for output. More...
 
- Public Member Functions inherited from Nektar::FieldUtils::Module
FIELD_UTILS_EXPORT Module (FieldSharedPtr p_f)
 
virtual ~Module ()=default
 
const ConfigOptionGetConfigOption (const std::string &key) const
 
FIELD_UTILS_EXPORT void RegisterConfig (std::string key, std::string value="")
 Register a configuration option with a module. More...
 
FIELD_UTILS_EXPORT void PrintConfig ()
 Print out all configuration options for a module. More...
 
FIELD_UTILS_EXPORT void SetDefaults ()
 Sets default configuration options for those which have not been set. More...
 
FIELD_UTILS_EXPORT void AddFile (std::string fileType, std::string fileName)
 
FIELD_UTILS_EXPORT void EvaluateTriFieldAtEquiSpacedPts (LocalRegions::ExpansionSharedPtr &exp, const Array< OneD, const NekDouble > &infield, Array< OneD, NekDouble > &outfield)
 

Static Public Member Functions

static std::shared_ptr< Modulecreate (FieldSharedPtr f)
 Creates an instance of this class. More...
 
- Static Public Member Functions inherited from Nektar::FieldUtils::OutputTecplot
static std::shared_ptr< Modulecreate (FieldSharedPtr f)
 Creates an instance of this class. More...
 

Static Public Attributes

static ModuleKey m_className
 
- Static Public Attributes inherited from Nektar::FieldUtils::OutputTecplot
static ModuleKey m_className
 

Protected Member Functions

void WriteDoubleOrFloat (std::ofstream &outfile, Array< OneD, NekDouble > &data)
 Write either double-precision or single-precision output of field data. More...
 
virtual void WriteTecplotHeader (std::ofstream &outfile, std::vector< std::string > &var)
 Write Tecplot files header in binary format. More...
 
virtual void WriteTecplotZone (std::ofstream &outfile)
 
virtual void WriteTecplotConnectivity (std::ofstream &outfile)
 Write Tecplot connectivity information (ASCII) More...
 
- Protected Member Functions inherited from Nektar::FieldUtils::OutputTecplot
virtual void OutputFromPts (po::variables_map &vm)
 Write from pts to output file. More...
 
virtual void OutputFromExp (po::variables_map &vm)
 Write from m_exp to output file. More...
 
virtual void OutputFromData (po::variables_map &vm)
 Write from data to output file. More...
 
virtual fs::path GetPath (std::string &filename, po::variables_map &vm)
 
virtual fs::path GetFullOutName (std::string &filename, po::variables_map &vm)
 
void WriteTecplotFile (po::variables_map &vm)
 
int GetNumTecplotBlocks ()
 Calculate number of Tecplot blocks. More...
 
void CalculateConnectivity ()
 Calculate connectivity information for each expansion dimension. More...
 
- Protected Member Functions inherited from Nektar::FieldUtils::Module
 Module ()
 

Additional Inherited Members

- Public Attributes inherited from Nektar::FieldUtils::Module
FieldSharedPtr m_f
 Field object. More...
 
- Protected Attributes inherited from Nektar::FieldUtils::OutputTecplot
bool m_binary
 True if writing binary field output. More...
 
bool m_oneOutputFile
 True if writing a single output file. More...
 
bool m_writeHeader
 True if writing header. More...
 
TecplotZoneType m_zoneType
 Tecplot zone type of output. More...
 
std::vector< int > m_numPoints
 Number of points per block in Tecplot file. More...
 
int m_numBlocks
 Number of blocks in Tecplot file. More...
 
int m_coordim
 Coordinate dimension of output. More...
 
int m_totConn
 Total number of connectivity entries. More...
 
std::vector< Array< OneD, int > > m_conn
 Connectivty for each block: one per element. More...
 
Array< OneD, int > m_rankFieldSizes
 Each rank's field sizes. More...
 
Array< OneD, int > m_rankConnSizes
 Each rank's connectivity sizes. More...
 
Array< OneD, Array< OneD, NekDouble > > m_fields
 Field data to output. More...
 
- Protected Attributes inherited from Nektar::FieldUtils::OutputFileBase
bool m_requireEquiSpaced
 
- Protected Attributes inherited from Nektar::FieldUtils::OutputModule
std::ofstream m_fldFile
 Output stream. More...
 
- Protected Attributes inherited from Nektar::FieldUtils::Module
std::map< std::string, ConfigOptionm_config
 List of configuration values. More...
 
std::set< std::string > m_allowedFiles
 List of allowed file formats. More...
 

Detailed Description

Tecplot output class, specifically for binary field output.

Definition at line 135 of file OutputTecplot.h.

Constructor & Destructor Documentation

◆ OutputTecplotBinary()

Nektar::FieldUtils::OutputTecplotBinary::OutputTecplotBinary ( FieldSharedPtr  f)
inline

Definition at line 145 of file OutputTecplot.h.

145  : OutputTecplot(f)
146  {
147  m_binary = true;
148  }
bool m_binary
True if writing binary field output.
Definition: OutputTecplot.h:97

References Nektar::FieldUtils::OutputTecplot::m_binary.

◆ ~OutputTecplotBinary()

virtual Nektar::FieldUtils::OutputTecplotBinary::~OutputTecplotBinary ( )
inlinevirtual

Definition at line 150 of file OutputTecplot.h.

151  {
152  }

Member Function Documentation

◆ create()

static std::shared_ptr<Module> Nektar::FieldUtils::OutputTecplotBinary::create ( FieldSharedPtr  f)
inlinestatic

Creates an instance of this class.

Definition at line 139 of file OutputTecplot.h.

140  {
142  }
static std::shared_ptr< DataType > AllocateSharedPtr(const Args &...args)
Allocate a shared pointer from the memory pool.

References Nektar::MemoryManager< DataType >::AllocateSharedPtr().

◆ WriteDoubleOrFloat()

void Nektar::FieldUtils::OutputTecplotBinary::WriteDoubleOrFloat ( std::ofstream &  outfile,
Array< OneD, NekDouble > &  data 
)
protected

Write either double-precision or single-precision output of field data.

Parameters
outfileOutput file name.
expansionExpansion that is considered

Definition at line 662 of file OutputTecplot.cpp.

664 {
665  // Data format: either double or single depending on user options
666  bool useDoubles = m_config["double"].as<bool>();
667 
668  if (useDoubles)
669  {
670  // For doubles, we can just write data.
671  WriteStream(outfile, data);
672  }
673  else
674  {
675  // For single precision, needs typecast first.
676  int nPts = data.size();
677  std::vector<float> tmp(data.size());
678  std::copy(&data[0], &data[0] + nPts, &tmp[0]);
679  WriteStream(outfile, tmp);
680  }
681 }
std::map< std::string, ConfigOption > m_config
List of configuration values.
Definition: Module.h:228
def copy(self)
Definition: pycml.py:2663
void WriteStream(std::ostream &outfile, T data)
Helper function to write binary data to stream.

References CellMLToNektar.pycml::copy(), Nektar::FieldUtils::Module::m_config, and Nektar::FieldUtils::WriteStream().

Referenced by WriteTecplotZone().

◆ WriteTecplotConnectivity()

void Nektar::FieldUtils::OutputTecplotBinary::WriteTecplotConnectivity ( std::ofstream &  outfile)
protectedvirtual

Write Tecplot connectivity information (ASCII)

Parameters
outfileOutput file

Reimplemented from Nektar::FieldUtils::OutputTecplot.

Definition at line 890 of file OutputTecplot.cpp.

891 {
892  if (m_oneOutputFile && m_f->m_comm->GetRank() > 0)
893  {
894  // Need to amalgamate connectivity information
895  Array<OneD, int> conn(m_totConn);
896  for (int i = 0, cnt = 0; i < m_conn.size(); ++i)
897  {
898  Vmath::Vcopy(m_conn[i].size(), &m_conn[i][0], 1, &conn[cnt], 1);
899  cnt += m_conn[i].size();
900  }
901  m_f->m_comm->Send(0, conn);
902  }
903  else
904  {
905  for (int i = 0; i < m_conn.size(); ++i)
906  {
907  WriteStream(outfile, m_conn[i]);
908  }
909 
910  if (m_oneOutputFile && m_f->m_comm->GetRank() == 0)
911  {
912  int offset = m_rankFieldSizes[0];
913 
914  for (int n = 1; n < m_f->m_comm->GetSize(); ++n)
915  {
916  Array<OneD, int> conn(m_rankConnSizes[n]);
917  m_f->m_comm->Recv(n, conn);
918 
919  for (int j = 0; j < conn.size(); ++j)
920  {
921  conn[j] += offset;
922  }
923 
924  WriteStream(outfile, conn);
925  offset += m_rankFieldSizes[n];
926  }
927  }
928  }
929 }
FieldSharedPtr m_f
Field object.
Definition: Module.h:225
int m_totConn
Total number of connectivity entries.
std::vector< Array< OneD, int > > m_conn
Connectivty for each block: one per element.
Array< OneD, int > m_rankConnSizes
Each rank's connectivity sizes.
bool m_oneOutputFile
True if writing a single output file.
Definition: OutputTecplot.h:99
Array< OneD, int > m_rankFieldSizes
Each rank's field sizes.
void Vcopy(int n, const T *x, const int incx, T *y, const int incy)
Definition: Vmath.cpp:1255

References Nektar::FieldUtils::OutputTecplot::m_conn, Nektar::FieldUtils::Module::m_f, Nektar::FieldUtils::OutputTecplot::m_oneOutputFile, Nektar::FieldUtils::OutputTecplot::m_rankConnSizes, Nektar::FieldUtils::OutputTecplot::m_rankFieldSizes, Nektar::FieldUtils::OutputTecplot::m_totConn, Vmath::Vcopy(), and Nektar::FieldUtils::WriteStream().

◆ WriteTecplotHeader()

void Nektar::FieldUtils::OutputTecplotBinary::WriteTecplotHeader ( std::ofstream &  outfile,
std::vector< std::string > &  var 
)
protectedvirtual

Write Tecplot files header in binary format.

Parameters
outfileOutput file name
varVariables names

Reimplemented from Nektar::FieldUtils::OutputTecplot.

Definition at line 465 of file OutputTecplot.cpp.

467 {
468  if (m_oneOutputFile && m_f->m_comm->GetRank() > 0)
469  {
470  return;
471  }
472 
473  // Version number
474  outfile << "#!TDV112";
475 
476  // Int value of 1 for endian check
477  WriteStream(outfile, 1);
478 
479  // We'll probably write a full solution field
480  WriteStream(outfile, 0);
481 
482  // Title
483  std::string title = "";
484  WriteStream(outfile, title);
485 
486  // Number of variables
487  WriteStream(outfile, (int)var.size());
488 
489  for (int i = 0; i < var.size(); ++i)
490  {
491  WriteStream(outfile, var[i]);
492  }
493 }

References Nektar::FieldUtils::Module::m_f, Nektar::FieldUtils::OutputTecplot::m_oneOutputFile, CG_Iterations::title, and Nektar::FieldUtils::WriteStream().

◆ WriteTecplotZone()

void Nektar::FieldUtils::OutputTecplotBinary::WriteTecplotZone ( std::ofstream &  outfile)
protectedvirtual

Write Tecplot zone output in binary

Parameters
outfileOutput file name.
expansionExpansion that is considered

Reimplemented from Nektar::FieldUtils::OutputTecplot.

Definition at line 689 of file OutputTecplot.cpp.

690 {
691  Array<OneD, NekDouble> fieldMin(m_fields.size());
692  Array<OneD, NekDouble> fieldMax(m_fields.size());
693 
694  // Data format: either double or single depending on user options
695  bool useDoubles = m_config["double"].as<bool>();
696 
697  if ((m_oneOutputFile && m_f->m_comm->GetRank() == 0) || !m_oneOutputFile)
698  {
699  // Don't bother naming zone
700  WriteStream(outfile, 299.0f); // Zone marker
701 
702  // Write same name as preplot
703  int rank = m_f->m_comm->GetRank();
704  string zonename = "ZONE " + boost::lexical_cast<string>(rank);
705  WriteStream(outfile, zonename);
706 
707  WriteStream(outfile, -1); // No parent zone
708  WriteStream(outfile, -1); // No strand ID
709  WriteStream(outfile, 0.0); // Solution time
710  WriteStream(outfile, -1); // Unused, set to -1
711 
712  // Zone type: 1 = lineseg, 3 = quad, 5 = brick
713  WriteStream(outfile, (int)m_zoneType);
714 
715  WriteStream(outfile, 0); // Data at nodes
716  WriteStream(outfile, 0); // No 1-1 face neighbours
717  WriteStream(outfile, 0); // No user-defined connections
718 
719  if (m_zoneType == eOrdered)
720  {
721  for (int i = 0; i < m_numPoints.size(); ++i)
722  {
723  WriteStream(outfile, m_numPoints[i]);
724  }
725 
726  for (int i = m_numPoints.size(); i < 3; ++i)
727  {
728  WriteStream(outfile, 0);
729  }
730  }
731  else
732  {
733  // Number of points in zone
734  int nPoints = m_oneOutputFile ? Vmath::Vsum(m_f->m_comm->GetSize(),
735  m_rankFieldSizes, 1)
736  : m_fields[0].size();
737 
738  WriteStream(outfile, nPoints); // Total number of points
739  WriteStream(outfile, m_numBlocks); // Number of blocks
740  WriteStream(outfile, 0); // Unused
741  WriteStream(outfile, 0); // Unused
742  WriteStream(outfile, 0); // Unused
743  }
744 
745  WriteStream(outfile, 0); // No auxiliary data names
746 
747  // Finalise header
748  WriteStream(outfile, 357.0f);
749 
750  // Now start to write data section so that we can dump geometry
751  // information
752 
753  // Data marker
754  WriteStream(outfile, 299.0f);
755 
756  for (int j = 0; j < m_fields.size(); ++j)
757  {
758  WriteStream(outfile, useDoubles ? 2 : 1);
759  }
760 
761  // No passive variables or variable sharing, no zone connectivity
762  // sharing (we only dump one zone)
763  WriteStream(outfile, 0);
764  WriteStream(outfile, 0);
765  WriteStream(outfile, -1);
766  }
767 
768  for (int i = 0; i < m_fields.size(); ++i)
769  {
770  fieldMin[i] = Vmath::Vmin(m_fields[i].size(), m_fields[i], 1);
771  fieldMax[i] = Vmath::Vmax(m_fields[i].size(), m_fields[i], 1);
772  }
773 
774  m_f->m_comm->AllReduce(fieldMin, LibUtilities::ReduceMin);
775  m_f->m_comm->AllReduce(fieldMax, LibUtilities::ReduceMax);
776 
777  // Write out min/max of field data
778  if ((m_oneOutputFile && m_f->m_comm->GetRank() == 0) || !m_oneOutputFile)
779  {
780  for (int i = 0; i < m_fields.size(); ++i)
781  {
782  WriteStream(outfile, fieldMin[i]);
783  WriteStream(outfile, fieldMax[i]);
784  }
785  }
786 
787  if (m_oneOutputFile && m_f->m_comm->GetRank() == 0)
788  {
789  for (int i = 0; i < m_fields.size(); ++i)
790  {
791  WriteDoubleOrFloat(outfile, m_fields[i]);
792 
793  for (int n = 1; n < m_f->m_comm->GetSize(); ++n)
794  {
795  Array<OneD, NekDouble> tmp(m_rankFieldSizes[n]);
796  m_f->m_comm->Recv(n, tmp);
797  WriteDoubleOrFloat(outfile, tmp);
798  }
799  }
800  }
801  else if (m_oneOutputFile && m_f->m_comm->GetRank() > 0)
802  {
803  for (int i = 0; i < m_fields.size(); ++i)
804  {
805  m_f->m_comm->Send(0, m_fields[i]);
806  }
807  }
808  else
809  {
810  for (int i = 0; i < m_fields.size(); ++i)
811  {
812  WriteDoubleOrFloat(outfile, m_fields[i]);
813  }
814  }
815 }
void WriteDoubleOrFloat(std::ofstream &outfile, Array< OneD, NekDouble > &data)
Write either double-precision or single-precision output of field data.
TecplotZoneType m_zoneType
Tecplot zone type of output.
std::vector< int > m_numPoints
Number of points per block in Tecplot file.
int m_numBlocks
Number of blocks in Tecplot file.
Array< OneD, Array< OneD, NekDouble > > m_fields
Field data to output.
T Vmin(int n, const T *x, const int incx)
Return the minimum element in x - called vmin to avoid conflict with min.
Definition: Vmath.cpp:1050
T Vsum(int n, const T *x, const int incx)
Subtract return sum(x)
Definition: Vmath.cpp:895
T Vmax(int n, const T *x, const int incx)
Return the maximum element in x – called vmax to avoid conflict with max.
Definition: Vmath.cpp:945

References Nektar::FieldUtils::eOrdered, Nektar::FieldUtils::Module::m_config, Nektar::FieldUtils::Module::m_f, Nektar::FieldUtils::OutputTecplot::m_fields, Nektar::FieldUtils::OutputTecplot::m_numBlocks, Nektar::FieldUtils::OutputTecplot::m_numPoints, Nektar::FieldUtils::OutputTecplot::m_oneOutputFile, Nektar::FieldUtils::OutputTecplot::m_rankFieldSizes, Nektar::FieldUtils::OutputTecplot::m_zoneType, Nektar::LibUtilities::ReduceMax, Nektar::LibUtilities::ReduceMin, Vmath::Vmax(), Vmath::Vmin(), Vmath::Vsum(), WriteDoubleOrFloat(), and Nektar::FieldUtils::WriteStream().

Member Data Documentation

◆ m_className

ModuleKey Nektar::FieldUtils::OutputTecplotBinary::m_className
static
Initial value:
=
"Writes a Tecplot file in binary plt format.")
static std::shared_ptr< Module > create(FieldSharedPtr f)
Creates an instance of this class.
tKey RegisterCreatorFunction(tKey idKey, CreatorFunction classCreator, std::string pDesc="")
Register a class with the factory.
Definition: NekFactory.hpp:198
std::pair< ModuleType, std::string > ModuleKey
Definition: Module.h:285
ModuleFactory & GetModuleFactory()
Definition: Module.cpp:49

Definition at line 144 of file OutputTecplot.h.