Home
Publications
Presentations
Support
Download
Examples
Developers
Class Docs
Namespaces
Classes
Files
Mailing Lists
Gallery
Wiki

node.h

Go to the documentation of this file.

// The libMesh Finite Element Library.
// Copyright (C) 2002-2012 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_NODE_H
#define LIBMESH_NODE_H

// Local includes
#include "libmesh/point.h"
#include "libmesh/dof_object.h"
#include "libmesh/reference_counted_object.h"
#include "libmesh/auto_ptr.h"

// C++ includes
#include <iostream>
#include <vector>

namespace libMesh
{


// forward declarations
class Node;
class MeshBase;
class MeshRefinement;


class Node : public Point,
             public DofObject,
             public ReferenceCountedObject<Node>
{

public:

  explicit
  Node  (const Real x=0,
         const Real y=0,
         const Real z=0,
         const dof_id_type id = invalid_id);

  Node (const Node& n);

  explicit Node (const Point& p,
                 const dof_id_type id = invalid_id);

  ~Node ();

  Node& operator= (const Point& p);

  static AutoPtr<Node> build (const Node& n);

  static AutoPtr<Node> build (const Point& p,
                              const dof_id_type id);

  static AutoPtr<Node> build (const Real x,
                              const Real y,
                              const Real z,
                              const dof_id_type id);

  bool active () const;


  bool operator ==(const Node& rhs) const;

  void print_info (std::ostream& os=libMesh::out) const;

  std::string get_info () const;

#ifdef LIBMESH_HAVE_MPI

  struct PackedNode
  {
    static const unsigned int header_size = 2;

    dof_id_type id;
    processor_id_type pid;
    Real x;
// FIXME: We should drop z (and y) if libMesh is built 2D (or 1D) only
    Real y;
    Real z;

    PackedNode () :
      id(0),
      pid(DofObject::invalid_processor_id),
      x(0.),
      y(0.),
      z(0.)
    {}

    explicit
    PackedNode (const Node &node) :
      id(node.id()),
      pid(node.processor_id()),
      x(node(0)),
#if LIBMESH_DIM > 1
      y(node(1)),
#else
      y(0.),
#endif
#if LIBMESH_DIM > 2
      z(node(2))
#else
      z(0.)
#endif
    {}

    AutoPtr<Node> build_node () const
    {
      AutoPtr<Node> node(new Node(x,y,z,id));
      node->processor_id() = pid;
      return node;
    }

    Point build_point () const
    {
      return Point(x,y,z);
    }

    static MPI_Datatype create_mpi_datatype ();

    static void pack (std::vector<int> &conn, const Node* node);

    static void unpack (std::vector<int>::const_iterator start, Node& node);
  };

unsigned int packed_size() const
{
  // use "(a+b-1)/b" trick to get a/b to round up
  static const unsigned int ints_per_Real = 
    (sizeof(Real) + sizeof(int) - 1) / sizeof(int);

  return PackedNode::header_size + LIBMESH_DIM*ints_per_Real +
         this->packed_indexing_size();
}

#endif // #ifdef LIBMESH_HAVE_MPI

private:

  friend class MeshRefinement;
  friend class Elem;
};



// ------------------------------------------------------------
// global Node functions

inline
std::ostream& operator << (std::ostream& os, const Node& n)
{
  n.print_info(os);
  return os;
}



//------------------------------------------------------
// Inline functions
inline
Node::Node (const Real x,
            const Real y,
            const Real z,
            const dof_id_type dofid) :
  Point(x,y,z)
{
  this->set_id() = dofid;
}



inline
Node::Node (const Node& n) :
  Point(n),
  DofObject(n),
  ReferenceCountedObject<Node>()
{
}



inline
Node::Node (const Point& p,
            const dof_id_type dofid) :
  Point(p)
{
  // optionally assign the id.  We have
  // to do it like this otherwise
  // Node n = Point p would erase
  // the id!
  if (dofid != invalid_id)
    this->set_id() = dofid;
}



inline
Node::~Node ()
{
}



inline
Node & Node::operator= (const Point& p)
{
  (*this)(0) = p(0);
#if LIBMESH_DIM > 1
  (*this)(1) = p(1);
#endif
#if LIBMESH_DIM > 2
  (*this)(2) = p(2);
#endif

  return *this;
}



inline
AutoPtr<Node> Node::build(const Node& n)
{
  AutoPtr<Node> ap(new Node(n));
  return ap;
}



inline
AutoPtr<Node> Node::build(const Point& p,
                          const dof_id_type id)
{

  AutoPtr<Node> ap(new Node(p,id));
  return ap;
}



inline
AutoPtr<Node> Node::build(const Real x,
                          const Real y,
                          const Real z,
                          const dof_id_type id)
{
  AutoPtr<Node> ap(new Node(x,y,z,id));
  return ap;
}



inline
bool Node::active () const
{
  return (this->id() != Node::invalid_id);
}


} // namespace libMesh


#endif // LIBMESH_NODE_H

---

Site Created By: libMesh Developers
Last modified: February 05 2013 19:54:48 UTC

Hosted By: