Files
openfoam/src/OpenFOAM/matrices/SquareMatrix/SquareMatrixI.H
kuti 745624c024 ENH: partial overhaul of Matrix type (#1220)
- additional operators:
  + compound assignment
  + inner product: operator&
  + outer product: operator^

- additional functions:
   - MatrixBlock methods: subColumn, subRow, subMatrix
   - L2 norms for matrix or column
   - trace, diag, round, transpose

- MatrixBlock methods: col(), block() are deprecated since their
  access patterns with (size, offset) are unnatural/unwieldy.

- verifications by test/Matrix/Test-Matrix
2019-05-23 11:32:45 +01:00

276 lines
6.2 KiB
C++

/*---------------------------------------------------------------------------*\
========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration |
\\ / A nd | Copyright (C) 2019 OpenCFD Ltd.
\\/ M anipulation |
-------------------------------------------------------------------------------
| Copyright (C) 2011-2016 OpenFOAM Foundation
-------------------------------------------------------------------------------
License
This file is part of OpenFOAM.
OpenFOAM 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 3 of the License, or
(at your option) any later version.
OpenFOAM 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 OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
\*---------------------------------------------------------------------------*/
#define CHECK_MATRIX_IS_SQUARE(a, b) \
if (a != b) \
{ \
FatalErrorInFunction \
<< "Attempt to create a non-square matrix (" \
<< a << ", " << b << ')' << nl << abort(FatalError); \
}
// * * * * * * * * * * * * * * * * Constructors * * * * * * * * * * * * * * //
template<class Type>
inline Foam::SquareMatrix<Type>::SquareMatrix()
:
Matrix<SquareMatrix<Type>, Type>()
{}
template<class Type>
inline Foam::SquareMatrix<Type>::SquareMatrix(const label n)
:
Matrix<SquareMatrix<Type>, Type>(n, n)
{}
template<class Type>
inline Foam::SquareMatrix<Type>::SquareMatrix
(
const label n,
const zero
)
:
Matrix<SquareMatrix<Type>, Type>(n, n, Zero)
{}
template<class Type>
inline Foam::SquareMatrix<Type>::SquareMatrix
(
const label n,
const Type& val
)
:
Matrix<SquareMatrix<Type>, Type>(n, n, val)
{}
template<class Type>
template<class AnyType>
inline Foam::SquareMatrix<Type>::SquareMatrix
(
const label n,
const Identity<AnyType>
)
:
Matrix<SquareMatrix<Type>, Type>(n, n, Zero)
{
for (label i=0; i < n; ++i)
{
this->operator()(i, i) = pTraits<Type>::one;
}
}
template<class Type>
inline Foam::SquareMatrix<Type>::SquareMatrix
(
const labelPair& dims
)
:
Matrix<SquareMatrix<Type>, Type>(dims)
{
CHECK_MATRIX_IS_SQUARE(dims.first(), dims.second());
}
template<class Type>
inline Foam::SquareMatrix<Type>::SquareMatrix
(
const labelPair& dims,
const zero
)
:
Matrix<SquareMatrix<Type>, Type>(dims, Zero)
{
CHECK_MATRIX_IS_SQUARE(dims.first(), dims.second());
}
template<class Type>
inline Foam::SquareMatrix<Type>::SquareMatrix
(
const labelPair& dims,
const Type& val
)
:
Matrix<SquareMatrix<Type>, Type>(dims, val)
{
CHECK_MATRIX_IS_SQUARE(dims.first(), dims.second());
}
template<class Type>
inline Foam::SquareMatrix<Type>::SquareMatrix
(
const label m,
const label n,
const zero
)
:
Matrix<SquareMatrix<Type>, Type>(m, n, Zero)
{
CHECK_MATRIX_IS_SQUARE(m, n);
}
template<class Type>
template<class MatrixType>
inline Foam::SquareMatrix<Type>::SquareMatrix
(
const ConstMatrixBlock<MatrixType>& mat
)
:
Matrix<SquareMatrix<Type>, Type>(mat)
{
// Check is square?
}
template<class Type>
template<class MatrixType>
inline Foam::SquareMatrix<Type>::SquareMatrix
(
const MatrixBlock<MatrixType>& mat
)
:
Matrix<SquareMatrix<Type>, Type>(mat)
{
// Check is square?
}
template<class Type>
inline Foam::SquareMatrix<Type>::SquareMatrix
(
const RectangularMatrix<Type>& mat
)
:
Matrix<SquareMatrix<Type>, Type>(mat)
{
CHECK_MATRIX_IS_SQUARE(mat.m(), mat.n());
}
template<class Type>
inline Foam::SquareMatrix<Type>::SquareMatrix(Istream& is)
:
Matrix<SquareMatrix<Type>, Type>(is)
{
CHECK_MATRIX_IS_SQUARE(this->m(), this->n());
}
template<class Type>
inline Foam::autoPtr<Foam::SquareMatrix<Type>>
Foam::SquareMatrix<Type>::clone() const
{
return autoPtr<SquareMatrix<Type>>::New(*this);
}
// * * * * * * * * * * * * * * * Member Functions * * * * * * * * * * * * * //
template<class Type>
inline void Foam::SquareMatrix<Type>::resize(const label m)
{
Matrix<SquareMatrix<Type>, Type>::resize(m, m);
}
template<class Type>
inline void Foam::SquareMatrix<Type>::setSize(const label m)
{
Matrix<SquareMatrix<Type>, Type>::resize(m, m);
}
template<class Type>
inline void Foam::SquareMatrix<Type>::shallowResize(const label m)
{
Matrix<SquareMatrix<Type>, Type>::shallowResize(m, m);
}
// * * * * * * * * * * * * * * * Member Operators * * * * * * * * * * * * * //
template<class Type>
inline void Foam::SquareMatrix<Type>::operator=(const zero)
{
Matrix<SquareMatrix<Type>, Type>::operator=(Zero);
}
template<class Type>
inline void Foam::SquareMatrix<Type>::operator=(const Type& val)
{
Matrix<SquareMatrix<Type>, Type>::operator=(val);
}
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
namespace Foam
{
// * * * * * * * * * * * * * * * Friend Functions * * * * * * * * * * * * * //
template<class Type>
inline Foam::SquareMatrix<Type> symmOuter
(
const Field<Type>& f1,
const Field<Type>& f2
)
{
SquareMatrix<Type> f1f2T(f1.size());
for (label i = 0; i < f1f2T.m(); ++i)
{
for (label j = 0; j < f1f2T.n(); ++j)
{
f1f2T(i, j) = f1[i]*f2[j];
}
}
return f1f2T;
}
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
} // End namespace Foam
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
#undef CHECK_MATRIX_IS_SQUARE
// ************************************************************************* //