Even-odd preconditioned linear operator including derivatives for arrays. More...

#include <eoprec_constdet_linop.h>

Inheritance diagram for Chroma::EvenOddPrecConstDetLinearOperatorArray< T, P, Q >:

Public Member Functions
virtual	~EvenOddPrecConstDetLinearOperatorArray ()
	Virtual destructor to help with cleanup;. More...

const Subset &	subset () const
	Only defined on the odd lattice. More...

virtual int	size (void) const =0
	Expected length of array index. More...

virtual const FermBC< T, P, Q > &	getFermBC () const =0
	Return the fermion BC object for this linear operator. More...

virtual void	deriv (P &ds_u, const multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign) const
	Apply the operator onto a source std::vector. More...

virtual void	derivEvenEvenLinOp (P &ds_u, const multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign) const
	Apply the even-even block onto a source std::vector. More...

virtual void	derivEvenOddLinOp (P &ds_u, const multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign) const
	Apply the the even-odd block onto a source std::vector. More...

virtual void	derivOddEvenLinOp (P &ds_u, const multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign) const
	Apply the the odd-even block onto a source std::vector. More...

virtual void	derivOddOddLinOp (P &ds_u, const multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign) const
	Apply the the odd-odd block onto a source std::vector. More...

Public Member Functions inherited from Chroma::EvenOddPrecLinearOperatorArray< T, P, Q >
virtual	~EvenOddPrecLinearOperatorArray ()
	Virtual destructor to help with cleanup;. More...

const Subset &	subset () const
	Only defined on the odd lattice. More...

virtual void	evenEvenLinOp (multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign) const =0
	Apply the even-even block onto a source std::vector. More...

virtual void	evenEvenInvLinOp (multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign) const =0
	Apply the inverse of the even-even block onto a source std::vector. More...

virtual void	evenOddLinOp (multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign) const =0
	Apply the the even-odd block onto a source std::vector. More...

virtual void	oddEvenLinOp (multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign) const =0
	Apply the the odd-even block onto a source std::vector. More...

virtual void	oddOddLinOp (multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign) const =0
	Apply the the odd-odd block onto a source std::vector. More...

virtual void	operator() (multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign) const
	Apply the operator onto a source std::vector. More...

virtual void	unprecLinOp (multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign) const
	Apply the UNPRECONDITIONED operator onto a source std::vector. More...

virtual void	derivUnprecLinOp (P &ds_u, const multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign) const

virtual unsigned long	evenEvenNFlops () const
	Apply the derivative of the UNPRECONDITIONED operator onto a source std::vector. More...

virtual unsigned long	evenOddNFlops () const
	Return flops performed by the evenOddLinOp. More...

virtual unsigned long	oddEvenNFlops () const
	Return flops performed by the oddEvenLinOp. More...

virtual unsigned long	oddOddNFlops () const
	Return flops performed by the oddOddLinOp. More...

virtual unsigned long	evenEvenInvNFlops () const
	Return flops performed by the evenEvenInvLinOp. More...

virtual unsigned long	nFlops () const
	Return flops performed by the operator() More...

Public Member Functions inherited from Chroma::DiffLinearOperatorArray< T, P, Q >
virtual	~DiffLinearOperatorArray ()
	Virtual destructor to help with cleanup;. More...

virtual void	deriv (P &ds_u, const multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign, const Real &epsilon) const
	Apply the derivative of the operator onto a source std::vector to some precision. More...

Public Member Functions inherited from Chroma::LinearOperatorArray< T >
virtual	~LinearOperatorArray ()
	Virtual destructor to help with cleanup;. More...

virtual void	operator() (multi1d< T > &chi, const multi1d< T > &psi, enum PlusMinus isign, Real epsilon) const
	Apply the operator onto a source std::vector to some precision. More...

Detailed Description

template<typename T, typename P, typename Q>
class Chroma::EvenOddPrecConstDetLinearOperatorArray< T, P, Q >

Even-odd preconditioned linear operator including derivatives for arrays.

Support for even-odd preconditioned linear operators with derivatives

Given a matrix M written in block form:

 [      A             D        ]
 [       E,E           E,O     ]
 [                             ]
 [      D             A        ]
 [       O,E           O,O     ]

The preconditioning consists of using the triangular matrices

 [      1              0        ]
 [       E,E            E,O     ]

L = [ ] [ D A^(-1) 1 ] [ O,E E,E O,O ]

and

 [      A              D       ]
 [       E,E            E,O    ]

U = [ ] [ 0 1 ] [ O,E O,O ]

The preconditioned matrix is formed from

M' = L^-1 * M * U^-1

where

      [      1              0        ]
      [       E,E            E,O     ]

L^(-1) = [ ] [ - D A^(-1) 1 ] [ O,E E,E O,O ]

and

      [      A^(-1)       - A^(-1) D       ]
      [       E,E            E,E    E,O    ]

U^(-1) = [ ] [ 0 1 ] [ O,E O,O ]

Resulting in a new M

 [      1                    0                      ]
 [       E,E                  E,O                   ]
 [                                                  ]
 [      0                A     -  D    A^(-1)  D    ]
 [       O,E              O,O      O,E   E,E    E,O ]

This class is used to implement the resulting linear operator

 ~
 M  =  A(o,o) - D(o,e) . A^-1(e,e) . D(e,o)

By construction, the linear operator is ONLY defined on the odd subset

Definition at line 362 of file eoprec_constdet_linop.h.

Constructor & Destructor Documentation

◆ ~EvenOddPrecConstDetLinearOperatorArray()

template<typename T , typename P , typename Q >

virtual Chroma::EvenOddPrecConstDetLinearOperatorArray< T, P, Q >::~EvenOddPrecConstDetLinearOperatorArray ( )

inlinevirtual

Virtual destructor to help with cleanup;.

Definition at line 366 of file eoprec_constdet_linop.h.

Member Function Documentation

◆ deriv()

template<typename T , typename P , typename Q >

virtual void Chroma::EvenOddPrecConstDetLinearOperatorArray< T, P, Q >::deriv	(	P &	ds_u,
		const multi1d< T > &	chi,
		const multi1d< T > &	psi,
		enum PlusMinus	isign
	)		const

inlinevirtual

Apply the operator onto a source std::vector.

User should make sure deriv routines do a resize

Implements Chroma::EvenOddPrecLinearOperatorArray< T, P, Q >.

Definition at line 379 of file eoprec_constdet_linop.h.

References chi, Chroma::isign, Chroma::MINUS, mu, Nd, Chroma::PLUS, psi, tmp2, and tmp3.

◆ derivEvenEvenLinOp()

template<typename T , typename P , typename Q >

virtual void Chroma::EvenOddPrecConstDetLinearOperatorArray< T, P, Q >::derivEvenEvenLinOp	(	P &	ds_u,
		const multi1d< T > &	chi,
		const multi1d< T > &	psi,
		enum PlusMinus	isign
	)		const

inlinevirtual

Apply the even-even block onto a source std::vector.

Implements Chroma::EvenOddPrecLinearOperatorArray< T, P, Q >.

Reimplemented in Chroma::EvenOddPrecOvlapContFrac5DPVLinOpArray, Chroma::EvenOddPrecOvlapContFrac5DLinOpBaseArray, Chroma::EvenOddPrecOvExtLinOpArray, Chroma::EvenOddPrecGenNEFDWLinOpArray, Chroma::EvenOddPrecHtContFrac5DLinOpArray, and Chroma::EvenOddPrecDWLinOpArray.

Definition at line 427 of file eoprec_constdet_linop.h.

◆ derivEvenOddLinOp()

template<typename T , typename P , typename Q >

virtual void Chroma::EvenOddPrecConstDetLinearOperatorArray< T, P, Q >::derivEvenOddLinOp	(	P &	ds_u,
		const multi1d< T > &	chi,
		const multi1d< T > &	psi,
		enum PlusMinus	isign
	)		const

inlinevirtual

Apply the the even-odd block onto a source std::vector.

Implements Chroma::EvenOddPrecLinearOperatorArray< T, P, Q >.

Reimplemented in Chroma::EvenOddPrecOvlapContFrac5DPVLinOpArray, Chroma::EvenOddPrecOvlapContFrac5DLinOpBaseArray, Chroma::EvenOddPrecOvExtLinOpArray, Chroma::EvenOddPrecGenNEFDWLinOpArray, Chroma::EvenOddPrecHtContFrac5DLinOpArray, and Chroma::EvenOddPrecDWLinOpArray.

Definition at line 435 of file eoprec_constdet_linop.h.

◆ derivOddEvenLinOp()

template<typename T , typename P , typename Q >

virtual void Chroma::EvenOddPrecConstDetLinearOperatorArray< T, P, Q >::derivOddEvenLinOp	(	P &	ds_u,
		const multi1d< T > &	chi,
		const multi1d< T > &	psi,
		enum PlusMinus	isign
	)		const

inlinevirtual

Apply the the odd-even block onto a source std::vector.

Implements Chroma::EvenOddPrecLinearOperatorArray< T, P, Q >.

Reimplemented in Chroma::EvenOddPrecOvlapContFrac5DPVLinOpArray, Chroma::EvenOddPrecOvlapContFrac5DLinOpBaseArray, Chroma::EvenOddPrecOvExtLinOpArray, Chroma::EvenOddPrecGenNEFDWLinOpArray, Chroma::EvenOddPrecHtContFrac5DLinOpArray, and Chroma::EvenOddPrecDWLinOpArray.

Definition at line 443 of file eoprec_constdet_linop.h.

◆ derivOddOddLinOp()

template<typename T , typename P , typename Q >

virtual void Chroma::EvenOddPrecConstDetLinearOperatorArray< T, P, Q >::derivOddOddLinOp	(	P &	ds_u,
		const multi1d< T > &	chi,
		const multi1d< T > &	psi,
		enum PlusMinus	isign
	)		const