iterator3d_range.hpp

Go to the documentation of this file.

/*
 * Copyright(c):
 * Signal Image and Communications (SIC) Department 
 * http://www.sic.sp2mi.univ-poitiers.fr/ 
 *  - University of Poitiers, France http://www.univ-poitiers.fr 
 *  - XLIM  Institute UMR CNRS 7252  http://www.xlim.fr/ 
 * 
 * and 
 * 
 * D2 Fluid, Thermic and Combustion 
 *  - University of Poitiers, France http://www.univ-poitiers.fr 
 *  - PPRIME Institute -  UPR CNRS 3346  http://www.pprime.fr
 *  - ISAE-ENSMA http://www.ensma.fr
 *
 * Contributor(s):
 * The SLIP team,
 * Benoit Tremblais <tremblais_AT_sic.univ-poitiers.fr>,
 * Laurent David <laurent.david_AT_lea.univ-poitiers.fr>, 
 * Ludovic Chatellier <ludovic.chatellier_AT_univ-poitiers.fr>, 
 * Lionel Thomas <lionel.thomas_AT_univ-poitiers.fr>, 
 * Denis Arrivault <arrivault_AT_sic.univ-poitiers.fr>, 
 * Julien Dombre <julien.dombre_AT_univ-poitiers.fr>.
 *
 * Description:
 * The Simple Library of Image Processing (SLIP) is a new image processing 
 * library. It is written in the C++ language following as much as possible 
 * the ISO/ANSI C++ standard. It is consequently compatible with any system  
 * satisfying the ANSI C++ complience. It works on different Unix , Linux ,  
 * Mircrosoft Windows and Mac OS X plateforms. SLIP is a research library that  
 * was created by the Signal, Image and Communications (SIC) departement of  
 * the XLIM, UMR 7252 CNRS Institute in collaboration with the Fluids, Thermic  
 * and Combustion departement of the P', UPR 3346 CNRS Institute of the  
 * University of Poitiers.
 * 
 * The SLIP Library source code has been registered to the APP (French Agency 
 * for the Protection of Programs) by the University of Poitiers and CNRS, 
 * under  registration number IDDN.FR.001.300034.000.S.P.2010.000.21000.

 * http://www.sic.sp2mi.univ-poitiers.fr/slip/
 *
 * This software is governed by the CeCILL-C license under French law and
 * abiding by the rules of distribution of free software.  You can  use, 
 * modify and/ or redistribute the software under the terms of the CeCILL-C 
 * license as circulated by CEA, CNRS and INRIA at the following URL 
 * http://www.cecill.info.
 * As a counterpart to the access to the source code and  rights to copy,
 * modify and redistribute granted by the license, users are provided only
 * with a limited warranty  and the software's author,  the holder of the
 * economic rights,  and the successive licensors  have only  limited
 * liability.
 * 
 * In this respect, the user's attention is drawn to the risks associated
 * with loading,  using,  modifying and/or developing or reproducing the
 * software by the user in light of its specific status of free software,
 * that may mean  that it is complicated to manipulate,  and  that  also
 * therefore means  that it is reserved for developers  and  experienced
 * professionals having in-depth computer knowledge. Users are therefore
 * encouraged to load and test the software's suitability as regards their
 * requirements in conditions enabling the security of their systems and/or
 * data to be ensured and,  more generally, to use and operate it in the 
 * same conditions as regards security. 
 *
 * The fact that you are presently reading this means that you have had
 * knowledge of the CeCILL-C license and that you accept its terms.
 */

#ifndef SLIP_ITERATOR3D_RANGE_HPP
#define SLIP_ITERATOR3D_RANGE_HPP

#include <iterator>
#include <cassert>

#include "Point3d.hpp"
#include "DPoint3d.hpp"
#include "DPoint2d.hpp"
#include "Range.hpp"
#include "iterator_types.hpp"

namespace slip
{
  template <class Container3D>
  class iterator3d_range  
  {
  public:
    //typedef std::random_access_iterator_tag iterator_category;
    typedef std::random_access_iterator3d_tag iterator_category;
    typedef typename Container3D::value_type value_type;
    typedef DPoint3d<int> difference_type;
    typedef DPoint2d<int> diff2d;
    typedef typename Container3D::pointer pointer;
    typedef typename Container3D::reference reference;
    
    typedef iterator3d_range self;
    
    typedef typename Container3D::size_type size_type;
    
    iterator3d_range():
      cont3d_(0),pos_(0),x1_(0),x2_(0),x3_(0),range_x1_(0,0),range_x2_(0,0),range_x3_(0,0)
    {}
    
    iterator3d_range(Container3D* c,
                                     const slip::Range<int>& r1,
                                     const slip::Range<int>& r2,
                                     const slip::Range<int>& r3):
      cont3d_(c),pos_((*c)[r1.start()][r2.start()] + r3.start())
      ,x1_(r1.start()),x2_(r2.start()),x3_(r3.start())
      ,range_x1_(r1),range_x2_(r2),range_x3_(r3)
    {}
    
    iterator3d_range(const self& o):
      cont3d_(o.cont3d_),pos_(o.pos_),x1_(o.x1_),x2_(o.x2_),x3_(o.x3_),
      range_x1_(o.range_x1_),range_x2_(o.range_x2_),range_x3_(o.range_x3_)
    {}
    
    self& operator=(const self& o)
    {
      if(this != &o)
                {
                  this->cont3d_ = o.cont3d_;
                  this->pos_ = o.pos_;
                  this->x1_ = o.x1_;
                  this->x2_ = o.x2_;
                  this->x3_ = o.x3_;
                  this->range_x1_ = o.range_x1_;
                  this->range_x2_ = o.range_x2_;
                  this->range_x3_ = o.range_x3_;
                }
      return *this;
    }
    inline
    reference operator*()
    {
      return *pos_;
    }
    
    inline
    pointer operator->()
    { 
      return &(operator*()); 
    }
    
    
    inline
    self& operator++()
    {
      if((x3_ < int(range_x3_.start() + (range_x3_.iterations() * range_x3_.stride()))) && (x2_ <= int(range_x2_.start() + (range_x2_.iterations() * range_x2_.stride()))) && (x1_ <= int(range_x1_.start() + (range_x1_.iterations() * range_x1_.stride()))))
                {
                  this->x3_+= range_x3_.stride();
                  this->pos_+= range_x3_.stride();
                }
      else if(x2_ < int(range_x2_.start() + (range_x2_.iterations() * range_x2_.stride())) && (x1_ <= int(range_x1_.start() + (range_x1_.iterations() * range_x1_.stride()))))
                {
                  this->x2_+= range_x2_.stride();
                  this->x3_ = range_x3_.start();
                  this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else if(x1_ < int(range_x1_.start() + (range_x1_.iterations() * range_x1_.stride())))
                {
                  this->x1_+= range_x1_.stride();
                  this->x2_ = range_x2_.start();
                  this->x3_ = range_x3_.start();
                  this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else
                {
                  this->x1_ = range_x1_.start() + range_x1_.stride() * (range_x1_.iterations() + 1);
                  this->x2_ = range_x2_.start() + range_x2_.stride() * (range_x2_.iterations() + 1);
                  this->x3_ = range_x3_.start() + range_x3_.stride() * (range_x3_.iterations() + 1);
                  this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      return *this;
    }
    
    inline
    self operator++(int)
    {
      self tmp = *this;
      ++(*this);
      return tmp;
    }
    
    inline
    self& operator--()
    {
      if((x3_ > int(range_x3_.start())) && (x2_ >= int(range_x2_.start())) && (x1_ >= int(range_x1_.start())))
                {
                  this->x3_-= range_x3_.stride();
                  this->pos_-= range_x3_.stride();
                }
      else if((x2_ > int(range_x2_.start())) && (x1_ >= int(range_x1_.start())))
                {
                  this->x2_-= range_x2_.stride();
                  this->x3_ = range_x3_.start() + range_x3_.stride() * range_x3_.iterations();
                  this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else if(x1_ > int(range_x2_.start()))
                {
                  this->x1_-= range_x1_.stride();
                  this->x2_ = range_x2_.start() + range_x2_.stride() * range_x2_.iterations();
                  this->x3_ = range_x3_.start() + range_x3_.stride() * range_x3_.iterations();
                  this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else 
                {
                  this->x1_ = int(range_x1_.start()-range_x1_.stride());
                  this->x2_ = int(range_x2_.start()-range_x2_.stride());
                  this->x3_ = int(range_x3_.start()-range_x3_.stride());
                  this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      return *this;
    }
    
    inline
    self operator--(int)
    {
      self tmp = *this;
      --(*this);
      return tmp;
  }
    
    inline
    friend bool operator==(const self& i1,
                                                   const self& i2)
    {
      
      return ( (i1.cont3d_ == i2.cont3d_) && (i1.pos_ == i2.pos_) 
                       && (i1.x1_ == i2.x1_) && (i1.x2_ == i2.x2_)  && (i1.x3_ == i2.x3_));
    }
    
    inline
    friend bool operator!=(const self& i1,
                                                   const self& i2)
    {
      return ( (i1.cont3d_ != i2.cont3d_) || (i1.pos_ != i2.pos_)
                       || (i1.x1_ != i2.x1_) || (i1.x2_ != i2.x2_)|| (i1.x3_ != i2.x3_) );
    }
    inline
    friend bool operator<(const self& i1,
                                                  const self& i2)
    {
      
      return ( i1.pos_ < i2.pos_);
    }

    inline
    friend bool operator>(const self& i1,
                                                  const self& i2)
    {
      
      return (i2 < i1);
    }
    
    inline
    friend bool operator<=(const self& i1,
                                                   const self& i2)
    {
      
      return  !(i2 < i1);
    }
    
    inline
    friend bool operator>=(const self& i1,
                                                   const self& i2)
    {
      
      return  !(i1 < i2);
    }
    inline
    self& operator+=(const difference_type& d)
    {
      this->x1_ += this->range_x1_.stride() * d.dx1();
      this->x2_ += this->range_x2_.stride() * d.dx2();
      this->x3_ += this->range_x3_.stride() * d.dx3();
      this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
      return *this;
    }
    
    inline
    self& operator-=(const difference_type& d)
    {
      this->x1_ -= this->range_x1_.stride() * d.dx1();
      this->x2_ -= this->range_x2_.stride() * d.dx2();
      this->x3_ -= this->range_x3_.stride() * d.dx3();
      this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
      return *this;
    }
    
    inline
    self operator+(const difference_type& d)
    {
      self tmp = *this;
      tmp += d;
      return tmp;
    }
    
    inline
    self operator-(const difference_type& d)
    {
      self tmp = *this;
      tmp -= d;
      return tmp;
    }
    
    inline
    friend difference_type operator-(const self& i1,
                                                                     const self& i2)
    {
      assert(i1.range_x1_.stride() == i2.range_x1_.stride());
      assert(i1.range_x2_.stride() == i2.range_x2_.stride());
      assert(i1.range_x3_.stride() == i2.range_x3_.stride());
      return difference_type(int((i1.x1_ - i2.x1_)/i1.range_x1_.stride()),
                                                     int((i1.x2_ - i2.x2_))/i1.range_x2_.stride(),
                                                     int((i1.x3_ - i2.x3_))/i1.range_x3_.stride());
    }
    
    
    inline
    reference operator[](difference_type d)
    {
      return (*cont3d_)[this->x1_+ this->range_x1_.stride() * d.dx1()]
                [this->x2_+ this->range_x2_.stride() * d.dx2()]
                [this->x3_+ this->range_x3_.stride() * d.dx3()];
    }
    
    inline
    pointer operator[](diff2d d)
    {
      return (*cont3d_)[this->x1_+ this->range_x1_.stride() * d.dx1()]
                [this->x2_ + this->range_x2_.stride() * d.dx2()];
    }
    
    inline
    pointer* operator[](int n)
    {
      return (*cont3d_)[this->x1_+ this->range_x1_.stride() * n];
    }
    
      
    inline
    typename Container3D::row_range_iterator row_begin(size_type slice, size_type row)
    {
      return cont3d_->row_begin(range_x1_.start() + slice * range_x1_.stride(), range_x2_.start() 
                                                                + row * range_x2_.stride(), range_x3_);
    }
    
    inline
    typename Container3D::row_range_iterator row_end(size_type slice, size_type row)
    {
      return this->row_begin(slice,row) + (range_x3_.iterations() + 1);
    }
    
    inline
    typename Container3D::col_range_iterator col_begin(size_type slice, size_type col)
    {
      return cont3d_->col_begin(range_x1_.start() + slice * range_x1_.stride()
                                                                , range_x3_.start() 
                                                                + col * range_x3_.stride(), range_x2_);
    }
    
    inline
    typename Container3D::col_range_iterator col_end(size_type slice, size_type col)
    {
      return this->col_begin(slice,col) + (range_x2_.iterations() + 1);
    }
    
    
    inline
    int x1() const
    {
      return this->x1_;
    }
    inline
    int k() const
    {
      return this->x1_;
    }
    inline
    int x2() const
    {
      return this->x2_;
    }
    inline
    int i() const
    {
      return this->x2_;
    }
    
    inline
    int x3() const
    {
      return this->x3_;
    }
    inline
    int j() const
    {
      return this->x3_;
    }
    
  private: 
    Container3D* cont3d_; // pointer to the 3d container
    pointer pos_;         // linear position within the container
    int x1_;              // first subscript position 
    int x2_;              // second subscript position
    int x3_;              // third subscript position
    slip::Range<int> range_x1_; // range to iterate on the first axis
    slip::Range<int> range_x2_; //range to iterate on the second axis
    slip::Range<int> range_x3_; //range to iterate on the third axis
  };
  
  
  template <class Container3D>
  class const_iterator3d_range  
  {
  public:
    //typedef std::random_access_iterator_tag iterator_category;
    typedef std::random_access_iterator3d_tag iterator_category;
    typedef typename Container3D::value_type value_type;
    typedef DPoint3d<int> difference_type;
    typedef DPoint2d<int> diff2d;
    typedef typename Container3D::const_pointer pointer;
    typedef typename Container3D::const_reference reference;
    
    typedef const_iterator3d_range self;
    
    typedef typename Container3D::size_type size_type;
    
    const_iterator3d_range():
      cont3d_(0),pos_(0),x1_(0),x2_(0),x3_(0),range_x1_(0,0),range_x2_(0,0),range_x3_(0,0)
    {}

    const_iterator3d_range(Container3D* c,
                                                   const slip::Range<int>& r1,
                                                   const slip::Range<int>& r2,
                                                   const slip::Range<int>& r3):
      cont3d_(c),pos_((*c)[r1.start()][r2.start()] + r3.start())
      ,x1_(r1.start()),x2_(r2.start()),x3_(r3.start())
      ,range_x1_(r1),range_x2_(r2),range_x3_(r3)
    {}
    
    const_iterator3d_range(const self& o):
      cont3d_(o.cont3d_),pos_(o.pos_),x1_(o.x1_),x2_(o.x2_),x3_(o.x3_)
      ,range_x1_(o.range_x1_),range_x2_(o.range_x2_),range_x3_(o.range_x3_)
    {}
    
    self& operator=(const self& o)
    {
      if(this != &o)
                {
                  this->cont3d_ = o.cont3d_;
                  this->pos_ = o.pos_;
                  this->x1_ = o.x1_;
                  this->x2_ = o.x2_;
                  this->x3_ = o.x3_;
                  this->range_x1_ = o.range_x1_;
                  this->range_x2_ = o.range_x2_;
                  this->range_x3_ = o.range_x3_;
                }
      return *this;
    }
    inline
    reference operator*() const
    {
      return *pos_;
    }
    
    inline
    pointer operator->() const
    { 
      return &(operator*()); 
    }
    
    
    
    
    inline
    self& operator++()
    {
      if((x3_ < int(range_x3_.start() + (range_x3_.iterations() * range_x3_.stride()))) && (x2_ <= int(range_x2_.start() + (range_x2_.iterations() * range_x2_.stride()))) && (x1_ <= int(range_x1_.start() + (range_x1_.iterations() * range_x1_.stride()))))
                {
                  this->x3_+= range_x3_.stride();
                  this->pos_+= range_x3_.stride();
                }
      else if(x2_ < int(range_x2_.start() + (range_x2_.iterations() * range_x2_.stride())) && (x1_ <= int(range_x1_.start() + (range_x1_.iterations() * range_x1_.stride()))))
                {
                  this->x2_+= range_x2_.stride();
                  this->x3_ = range_x3_.start();
                  this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else if(x1_ < int(range_x1_.start() + (range_x1_.iterations() * range_x1_.stride())))
                {
                  this->x1_+= range_x1_.stride();
                  this->x2_ = range_x2_.start();
                  this->x3_ = range_x3_.start();
                  this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else
                {
                  this->x1_ = range_x1_.start() + range_x1_.stride() * (range_x1_.iterations() + 1);
                  this->x2_ = range_x2_.start() + range_x2_.stride() * (range_x2_.iterations() + 1);
                  this->x3_ = range_x3_.start() + range_x3_.stride() * (range_x3_.iterations() + 1);
                  this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      return *this;
    }
    
    inline
    self operator++(int)
    {
      self tmp = *this;
      ++(*this);
      return tmp;
    }
    
    inline
    self& operator--()
    {
      if((x3_ > int(range_x3_.start())) && (x2_ >= int(range_x2_.start())) && (x1_ >= int(range_x1_.start())))
                {
                  this->x3_-= range_x3_.stride();
                  this->pos_-= range_x3_.stride();
                }
      else if((x2_ > int(range_x2_.start())) && (x1_ >= int(range_x1_.start())))
                {
                  this->x2_-= range_x2_.stride();
                  this->x3_ = range_x3_.start() + range_x3_.stride() * range_x3_.iterations();
                  this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else if(x1_ > int(range_x2_.start()))
                {
                  this->x1_-= range_x1_.stride();
                  this->x2_ = range_x2_.start() + range_x2_.stride() * range_x2_.iterations();
                  this->x3_ = range_x3_.start() + range_x3_.stride() * range_x3_.iterations();
                  this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else 
                {
                  this->x1_ = int(range_x1_.start()-range_x1_.stride());
                  this->x2_ = int(range_x2_.start()-range_x2_.stride());
                  this->x3_ = int(range_x3_.start()-range_x3_.stride());
                  this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      return *this;
    }
    
    inline
    self operator--(int)
    {
      self tmp = *this;
      --(*this);
      return tmp;
    }
    
    inline
    friend bool operator==(const self& i1,
                                                   const self& i2)
    {
      
      return ( (i1.cont3d_ == i2.cont3d_) && (i1.pos_ == i2.pos_) 
                       && (i1.x1_ == i2.x1_) && (i1.x2_ == i2.x2_)  && (i1.x3_ == i2.x3_));
    }
    
    inline
    friend bool operator!=(const self& i1,
                                                   const self& i2)
    {
      return ( (i1.cont3d_ != i2.cont3d_) || (i1.pos_ != i2.pos_)
                       || (i1.x1_ != i2.x1_) || (i1.x2_ != i2.x2_) || (i1.x3_ != i2.x3_));
    }
    inline
    friend bool operator<(const self& i1,
                                                  const self& i2)
    {
      
      return ( i1.pos_ < i2.pos_);
    }

    inline
    friend bool operator>(const self& i1,
                                                  const self& i2)
    {
      
      return (i2 < i1);
    }
  
    inline
    friend bool operator<=(const self& i1,
                                                   const self& i2)
    {
      
      return  !(i2 < i1);
    }
    
    inline
    friend bool operator>=(const self& i1,
                                                   const self& i2)
    {
      
      return  !(i1 < i2);
    }
    inline
    self& operator+=(const difference_type& d)
    {
      this->x1_ += this->range_x1_.stride() * d.dx1();
      this->x2_ += this->range_x2_.stride() * d.dx2();
      this->x3_ += this->range_x3_.stride() * d.dx3();
      this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
      return *this;
    }
    
    inline
    self& operator-=(const difference_type& d)
    {
      this->x1_ -= this->range_x1_.stride() * d.dx1();
      this->x2_ -= this->range_x2_.stride() * d.dx2();
      this->x3_ -= this->range_x3_.stride() * d.dx3();
      this->pos_ = cont3d_->begin() + (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + (this->x2_* int(cont3d_->cols())) + this->x3_;
      return *this;
    }
    
    inline
    self operator+(const difference_type& d)
    {
      self tmp = *this;
      tmp += d;
      return tmp;
    }
    
    inline
    self operator-(const difference_type& d)
    {
      self tmp = *this;
      tmp -= d;
      return tmp;
    }
    
    inline
    friend difference_type operator-(const self& i1,
                                                                     const self& i2)
    {
      assert(i1.range_x1_.stride() == i2.range_x1_.stride());
      assert(i1.range_x2_.stride() == i2.range_x2_.stride());
      assert(i1.range_x3_.stride() == i2.range_x3_.stride());
      return difference_type(int((i1.x1_ - i2.x1_)/i1.range_x1_.stride()),
                                                     int((i1.x2_ - i2.x2_))/i1.range_x2_.stride(),
                                                     int((i1.x3_ - i2.x3_))/i1.range_x3_.stride());
    }
    
    
    inline
    reference operator[](difference_type d) const
    {
      return (*cont3d_)[this->x1_+ this->range_x1_.stride() * d.dx1()]
                [this->x2_+ this->range_x2_.stride() * d.dx2()]
                [this->x3_+ this->range_x3_.stride() * d.dx3()];
    }
    
    inline
    pointer operator[](diff2d d) const
    {
      return (*cont3d_)[this->x1_+ this->range_x1_.stride() * d.dx1()]
                [this->x2_ + this->range_x2_.stride() * d.dx2()];
    }
    
    inline
    pointer* operator[](int n) const
    {
      return (*cont3d_)[this->x1_+ this->range_x1_.stride() * n];
    }
    
    
    inline
    typename Container3D::const_row_range_iterator row_begin(size_type slice
                                                                                                                     , size_type row) const
    {
      return cont3d_->row_begin(range_x1_.start() + slice * range_x1_.stride()
                                                                , range_x2_.start() + row * range_x2_.stride(), range_x3_);
    }
    
    inline
    typename Container3D::const_row_range_iterator row_end(size_type slice
                                                                                                                   , size_type row) const
    {
      return this->row_begin(slice,row) + (range_x3_.iterations() + 1);
    }
    
    inline
    typename Container3D::const_col_range_iterator col_begin(size_type slice
                                                                                                                     , size_type col) const
    {
      return cont3d_->col_begin(range_x1_.start() + slice * range_x1_.stride()
                                                                , range_x3_.start() + col * range_x3_.stride(), range_x2_);
    }
    
    inline
    typename Container3D::const_col_range_iterator col_end(size_type slice
                                                                                                                   , size_type col) const
    {
      return this->col_begin(slice,col) + (range_x2_.iterations() + 1);
    }
    
    inline
    int x1()
    {
      return this->x1_;
    }
    inline
    int k()
    {
      return this->x2_;
    }
    inline
    int x2()
    {
      return this->x2_;
    }
    inline
    int i()
    {
      return this->x2_;
    }
    inline
    int x3()
    {
      return this->x3_;
    }
    inline
    int j()
    {
      return this->x3_;
    }
    
  private: 
    Container3D* cont3d_; // pointer to the 3d container
    pointer pos_;         // linear position within the container
    int x1_;              // first subscript position 
    int x2_;              // second subscript position
    int x3_;              // third subscript position
    slip::Range<int> range_x1_; // range to iterate on the first axis
    slip::Range<int> range_x2_; //range to iterate on the second axis
    slip::Range<int> range_x3_; //range to iterate on the third axis
  };
  
  
  
  
}//slip::

#endif //SLIP_ITERATOR3D_RANGE_HPP