refineable_line_mesh.h

Go to the documentation of this file.

// LIC// ====================================================================
// LIC// This file forms part of oomph-lib, the object-oriented,
// LIC// multi-physics finite-element library, available
// LIC// at http://www.oomph-lib.org.
// LIC//
// LIC// Copyright (C) 2006-2025 Matthias Heil and Andrew Hazel
// LIC//
// LIC// This library is free software; you can redistribute it and/or
// LIC// modify it under the terms of the GNU Lesser General Public
// LIC// License as published by the Free Software Foundation; either
// LIC// version 2.1 of the License, or (at your option) any later version.
// LIC//
// LIC// This library is distributed in the hope that it will be useful,
// LIC// but WITHOUT ANY WARRANTY; without even the implied warranty of
// LIC// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// LIC// Lesser General Public License for more details.
// LIC//
// LIC// You should have received a copy of the GNU Lesser General Public
// LIC// License along with this library; if not, write to the Free Software
// LIC// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
// LIC// 02110-1301  USA.
// LIC//
// LIC// The authors may be contacted at oomph-lib@maths.man.ac.uk.
// LIC//
// LIC//====================================================================
#ifndef OOMPH_REFINEABLE_LINE_MESH_HEADER
#define OOMPH_REFINEABLE_LINE_MESH_HEADER
 
#include "line_mesh.h"
#include "refineable_mesh.h"
#include "refineable_line_element.h"
 
namespace oomph
{
  //===========================================================================
  /// Intermediate mesh class that implements the mesh adaptation functions
  /// specified in the RefineableMesh class for meshes that contain the
  /// refineable variant of QElement s [The class ELEMENT provided as the
  /// template parameter must be of type RefineableQElement<1>].
  ///
  /// Mesh adaptation/refinement is implemented by BinaryTree procedures
  /// and any concrete implementation of this class needs to provide a
  /// BinaryTreeForest representation of the initial (coarse) mesh.
  //===========================================================================
  template<class ELEMENT>
  class RefineableLineMesh : public virtual TreeBasedRefineableMesh<ELEMENT>,
                             public virtual LineMeshBase
  {
  public:
    /// Constructor: Set up static binary tree data
    RefineableLineMesh()
    {
      // BinaryTree static data needs to be setup before binary tree-based
      // mesh refinement works
      BinaryTree::setup_static_data();
    }
 
    /// Broken copy constructor
    RefineableLineMesh(const RefineableLineMesh& dummy) = delete;
 
    /// Broken assignment operator
    void operator=(const RefineableLineMesh&) = delete;
 
    /// Destructor:
    virtual ~RefineableLineMesh() {}
 
    /// Set up the tree forest associated with the Mesh.
    /// Forwards call to setup_binary_tree_forest().
    virtual void setup_tree_forest()
    {
      setup_binary_tree_forest();
    }
 
    /// Set up BinaryTreeForest. Wipes any existing tree structure and
    /// regards the currently active elements as the root trees in the forest.
    void setup_binary_tree_forest()
    {
      // This wipes all elements/binary trees in the tree representation
      // but leaves the leaf elements alone
      if (this->Forest_pt != 0) delete this->Forest_pt;
 
      // Each finite element in the coarse base mesh gets associated with
      // (the root of) a BinaryTree. Store BinaryTreeRoots in vector:
      Vector<TreeRoot*> trees_pt;
 
      // Determine number of elements in mesh
      const unsigned n_element = this->nelement();
 
      // Loop over all elements, build corresponding BinaryTree and store
      // BinaryTreeRoots in vector:
      for (unsigned e = 0; e < n_element; e++)
      {
        // Get pointer to full element type
        ELEMENT* el_pt = dynamic_cast<ELEMENT*>(this->element_pt(e));
 
        // Build associated binary tree(root) -- pass pointer to corresponding
        // finite element and add the pointer to vector of binary tree (roots):
        trees_pt.push_back(new BinaryTreeRoot(el_pt));
      }
 
      // Plant BinaryTreeRoots in BinaryTreeForest
      this->Forest_pt = new BinaryTreeForest(trees_pt);
    }
  };
 
} // namespace oomph
 
#endif