aboutsummaryrefslogtreecommitdiffhomepage
path: root/Eigen/src/Core/FixedBlock.h
blob: 2f5d3fa841d98725d66e39ccc132c6ccbbbf4b8d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
// This file is part of Eigen, a lightweight C++ template library
// for linear algebra. Eigen itself is part of the KDE project.
//
// Copyright (C) 2006-2008 Benoit Jacob <jacob@math.jussieu.fr>
//
// Eigen is free software; you can redistribute it and/or modify it under the
// terms of the GNU General Public License as published by the Free Software
// Foundation; either version 2 or (at your option) any later version.
//
// Eigen 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 General Public License for more
// details.
//
// You should have received a copy of the GNU General Public License along
// with Eigen; if not, write to the Free Software Foundation, Inc., 51
// Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
//
// As a special exception, if other files instantiate templates or use macros
// or functions from this file, or you compile this file and link it
// with other works to produce a work based on this file, this file does not
// by itself cause the resulting work to be covered by the GNU General Public
// License. This exception does not invalidate any other reasons why a work
// based on this file might be covered by the GNU General Public License.

#ifndef EIGEN_FIXEDBLOCK_H
#define EIGEN_FIXEDBLOCK_H

/** \class FixedBlock
  *
  * \brief Expression of a fixed-size block
  *
  * \param MatrixType the type of the object in which we are taking a block
  * \param BlockRows the number of rows of the block we are taking
  * \param BlockCols the number of columns of the block we are taking
  *
  * This class represents an expression of a fixed-size block. It is the return
  * type of MatrixBase::fixedBlock() and most of the time this is the only way it
  * is used.
  *
  * However, if you want to directly maniputate fixed-size block expressions,
  * for instance if you want to write a function returning such an expression, you
  * will need to use this class.
  *
  * Here is an example illustrating this:
  * \include class_FixedBlock.cpp
  * Output: \verbinclude class_FixedBlock.out
  *
  * \sa MatrixBase::fixedBlock(int,int), class Block
  */
template<typename MatrixType, int BlockRows, int BlockCols> class FixedBlock
  : public MatrixBase<typename MatrixType::Scalar,
                      FixedBlock<MatrixType, BlockRows, BlockCols> >
{
  public:
    typedef typename MatrixType::Scalar Scalar;
    typedef typename MatrixType::Ref MatRef;
    friend class MatrixBase<Scalar, FixedBlock>;
    typedef MatrixBase<Scalar, FixedBlock> Base;

    FixedBlock(const MatRef& matrix, int startRow, int startCol)
      : m_matrix(matrix), m_startRow(startRow), m_startCol(startCol)
    {
      assert(startRow >= 0 && BlockRows >= 1 && startRow + BlockRows <= matrix.rows()
          && startCol >= 0 && BlockCols >= 1 && startCol + BlockCols <= matrix.cols());
    }
    
    EIGEN_INHERIT_ASSIGNMENT_OPERATORS(FixedBlock)
    
  private:
    enum{
      RowsAtCompileTime = BlockRows,
      ColsAtCompileTime = BlockCols,
      MaxRowsAtCompileTime = BlockRows,
      MaxColsAtCompileTime = BlockCols
    };

    const FixedBlock& _ref() const { return *this; }
    static int _rows() { return BlockRows; }
    static int _cols() { return BlockCols; }
    
    Scalar& _coeffRef(int row, int col)
    {
      return m_matrix.coeffRef(row + m_startRow.value(), col + m_startCol.value());
    }
    
    Scalar _coeff(int row, int col) const
    {
      return m_matrix.coeff(row + m_startRow.value(), col + m_startCol.value());
    }
    
  protected:
    MatRef m_matrix;
    IntAtRunTimeIfDynamic<MatrixType::Traits::RowsAtCompileTime == 1 ? 0 : Dynamic>
      m_startRow;
    IntAtRunTimeIfDynamic<MatrixType::Traits::ColsAtCompileTime == 1 ? 0 : Dynamic>
      m_startCol;
};

/** \returns a fixed-size expression of a block in *this.
  *
  * The template parameters \a BlockRows and \a BlockCols are the number of
  * rows and columns in the block.
  *
  * \param startRow the first row in the block
  * \param startCol the first column in the block
  *
  * Example: \include MatrixBase_fixedBlock_int_int.cpp
  * Output: \verbinclude MatrixBase_fixedBlock_int_int.out
  *
  * \sa class FixedBlock, block(int,int,int,int)
  */
template<typename Scalar, typename Derived>
template<int BlockRows, int BlockCols>
FixedBlock<Derived, BlockRows, BlockCols> MatrixBase<Scalar, Derived>
  ::fixedBlock(int startRow, int startCol)
{
  return FixedBlock<Derived, BlockRows, BlockCols>(ref(), startRow, startCol);
}

/** This is the const version of fixedBlock(int, int). */
template<typename Scalar, typename Derived>
template<int BlockRows, int BlockCols>
const FixedBlock<Derived, BlockRows, BlockCols> MatrixBase<Scalar, Derived>
  ::fixedBlock(int startRow, int startCol) const
{
  return FixedBlock<Derived, BlockRows, BlockCols>(ref(), startRow, startCol);
}

#endif // EIGEN_FIXEDBLOCK_H