ucd_io.h

Go to the documentation of this file.

// The libMesh Finite Element Library.
// Copyright (C) 2002-2024 Benjamin S. Kirk, John W. Peterson, Roy H. Stogner

// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.

// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.

// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA



#ifndef LIBMESH_UCD_IO_H
#define LIBMESH_UCD_IO_H

// Local includes
#include "libmesh/libmesh_common.h"
#include "libmesh/mesh_input.h"
#include "libmesh/mesh_output.h"

// C++ includes
#include <map>

namespace libMesh
{

// Forward declarations
class MeshBase;
enum ElemType : int;

class UCDIO : public MeshInput<MeshBase>,
              public MeshOutput<MeshBase>
{
public:

  explicit
  UCDIO (MeshBase & mesh) :
    MeshInput<MeshBase> (mesh),
    MeshOutput<MeshBase>(mesh)
  {}

  explicit
  UCDIO (const MeshBase & mesh) :
    MeshOutput<MeshBase> (mesh)
  {}

  virtual void read (const std::string &) override;

  virtual void write (const std::string &) override;

  using MeshOutput<MeshBase>::write_nodal_data;

  virtual void write_nodal_data(const std::string & fname,
                                const std::vector<Number> & soln,
                                const std::vector<std::string> & names) override;


private:

  void read_implementation (std::istream & in_stream);

  void write_implementation (std::ostream & out_stream);

  void write_header(std::ostream & out,
                    const MeshBase & mesh,
                    dof_id_type n_elems,
                    unsigned int n_vars);

  void write_nodes(std::ostream & out,
                   const MeshBase & mesh);

  void write_interior_elems(std::ostream & out,
                            const MeshBase & mesh);

  void write_soln(std::ostream & out,
                  const MeshBase & mesh,
                  const std::vector<std::string> & names,
                  const std::vector<Number> & soln);

  // Static map from libmesh ElementType -> UCD description string for
  // use during writing.
  static std::map<ElemType, std::string> _writing_element_map;

  // Static map from libmesh UCD description string -> ElementType for
  // use during reading.
  static std::map<std::string, ElemType> _reading_element_map;

  // Static function used to build the _writing_element_map.
  static std::map<ElemType, std::string> build_writing_element_map();

  // Static function used to build the _reading_element_map.
  static std::map<std::string, ElemType> build_reading_element_map();
};

} // namespace libMesh


#endif // LIBMESH_UCD_IO_H