MeshEntityIterator.h

// Copyright (C) 2006-2008 Anders Logg
//
// This file is part of DOLFIN.
//
// DOLFIN 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 3 of the License, or
// (at your option) any later version.
//
// DOLFIN 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 DOLFIN. If not, see <http://www.gnu.org/licenses/>.
//
// Modified by Andre Massing 2009
//
// First added:  2006-05-09
// Last changed: 2014-07-02

#ifndef __MESH_ENTITY_ITERATOR_H
#define __MESH_ENTITY_ITERATOR_H

#include "Mesh.h"
#include "MeshEntity.h"

namespace dolfin
{


  class MeshEntityIterator
  {
  public:

    MeshEntityIterator() : _pos(0), pos_end(0), index(0) {}

    MeshEntityIterator(const Mesh& mesh, std::size_t dim)
      : _entity(), _pos(0), pos_end(0), index(0)
    {
      // Check if mesh is empty
      if (mesh.num_vertices() == 0)
        return;

      // Initialize mesh entity
      _entity.init(mesh, dim, 0);

      mesh.init(dim);
      // End at ghost cells for normal iterator
      pos_end = mesh.topology().ghost_offset(dim);
    }

    MeshEntityIterator(const Mesh& mesh, std::size_t dim, std::string opt)
      : _entity(), _pos(0), pos_end(0), index(0)
    {
      // Check if mesh is empty
      if (mesh.num_vertices() == 0)
        return;

      // Initialize mesh entity
      _entity.init(mesh, dim, 0);
      mesh.init(dim);

      pos_end = mesh.topology().size(dim);
      if (opt == "regular")
        pos_end = mesh.topology().ghost_offset(dim);
      else if (opt == "ghost")
        _pos = mesh.topology().ghost_offset(dim);
      else if (opt != "all")
        dolfin_error("MeshEntityIterator.h",
                     "initialize MeshEntityIterator",
                     "unknown opt=\"%s\", choose from "
                     "opt=[\"regular\", \"ghost\", \"all\"]", opt.c_str());
    }

    MeshEntityIterator(const MeshEntity& entity, std::size_t dim)
      : _entity(entity.mesh(), dim, 0), _pos(0), index(0)
    {
      // Get connectivity
      const MeshConnectivity& c = entity.mesh().topology()(entity.dim(), dim);

      // Compute connectivity if empty
      if (c.empty())
        entity.mesh().init(entity.dim(), dim);

      // Get size and index map
      if (c.empty())
      {
        pos_end = 0;
        index = 0;
      }
      else
      {
        pos_end = c.size(entity.index());
        index = c(entity.index());
      }
    }

    MeshEntityIterator(const MeshEntityIterator& it)
      : _entity(it._entity), _pos(it._pos), pos_end(it.pos_end),
      index(it.index) {}

    virtual ~MeshEntityIterator() {}

    MeshEntityIterator& operator++()
    {
      ++_pos;
      return *this;
    }

    MeshEntityIterator& operator--()
    {
      --_pos;
      return *this;
    }

    std::size_t pos() const
    { return _pos; }

    bool operator==(const MeshEntityIterator& it) const
    {
      // Use const_cast to use operator* inside comparison, which
      // automatically updates the entity index corresponding to pos
      // *before* comparison (since update of entity delays until
      // request for entity)
      return ((const_cast<MeshEntityIterator *>(this))->operator*()
            == (const_cast<MeshEntityIterator *>(&it))->operator*()
            && _pos == it._pos && index == it.index);
    }

    bool operator!=(const MeshEntityIterator & it) const
    { return !operator==(it); }

    MeshEntity& operator*()
    { return *operator->(); }

    MeshEntity* operator->()
    { _entity._local_index = (index ? index[_pos] : _pos); return &_entity; }

    bool end() const
    { return _pos >= pos_end; }

    MeshEntityIterator end_iterator()
    {
      MeshEntityIterator
      sg(*this);
      sg.set_end();
      return sg;
    }

    // Note: Not a subclass of Variable for efficiency!
    // Commented out to avoid warning about shadowing str() for MeshEntity
    // Return informal string representation (pretty-print)
    // std::string str(bool verbose) const;

  private:

    // Set pos to end position. To create a kind of mesh.end() iterator.
    void set_end()
    { _pos = pos_end; }

    // Mesh entity
    MeshEntity _entity;

    // Current position
    std::size_t _pos;

    // End position
    std::size_t pos_end;

    // Mapping from pos to index (if any)
    const unsigned int* index;

  };

}

#endif