Lazy Operations

Overview

AIE architectures offer multiplication instructions that can perform additional operations on on the input arguments. Instead of adding one variant for each possible combination, AIE API offers types that can wrap an existing vector, accumulator of element reference and be passed into the multiplication function. Then the API will merge the operations into a single instruction or apply the operation on the vector before the multiplication, depending on the hardware support,

The following example performs an element-wise multiplication of the absolute of vector a and the conjugate of vector b.

      aie::accumfoo(
      aie::vectora,
      aie::vectorb)
     

      {
     

      aie::accumret;
     


      ret =
      aie::mul(
      aie::op_abs(a),
      aie::op_conj(b));
     


      returnret;
     

      }
     

Functions
template
constexprunary_op< T,Operation::Abs>	aie::op_abs(const T &e)
	More...
template<AccumAcc>
constexprunary_op< Acc,Operation::Acc_Add>	aie::op_add(const Acc &acc)
	More...
template
constexprunary_op< T,Operation::Conj>	aie::op_conj(const T &e)
	More...
template<VectorVec>
constexprbinary_op< Vec, Vec,Operation::Max>	aie::op_max(const Vec &a, const Vec &b)
	More...
template<VectorVec>
constexprbinary_op< Vec, Vec,Operation::Min>	aie::op_min(const Vec &a, const Vec &b)
	More...
template
constexprunary_op< T,Operation::None>	aie::op_none(const T &e)
	More...
template<AccumAcc>
constexprunary_op< Acc,Operation::Acc_Sub>	aie::op_sub(const Acc &acc)
	More...

Function Documentation

op_abs()

template

constexprunary_opOperation::Abs> aie::op_abs ( const T & e )

constexpr

Returns an absolute operation modifier for the given vector or element. On some architecture versions, this operation can be collapsed with a subsequent multiplication.

Parameters

e	Vectoror element to which the operation is performed. The type must meetVectororElem.

op_add()

template< AccumAcc>

constexprunary_opOperation::Acc_Add> aie::op_add ( const Acc & acc )

constexpr

Returns an addition operation modifier for the given accumulator.

Parameters

acc	Accumulator to which the operation is performed.

op_conj()

template

constexprunary_opOperation::Conj> aie::op_conj ( const T & e )

constexpr

Returns a conjugate operation modifier for the given complex vector or element. On some architecture versions, this operation can be collapsed with a subsequent multiplication.

Parameters

e	Vectoror element to which the operation is performed. The type must meetComplexVectororComplexElem.

op_max()

template< VectorVec>

constexprbinary_opOperation::Max> aie::op_max ( const Vec & a, const Vec & b )

constexpr

Returns a maximum operation modifier for the given pair of vectors or elements. On some architecture versions, this operation can be collapsed with a subsequent multiplication.

Parameters

a	First vector or element passed to the operation. The type must meetVectororElem.
b	Second vector or element passed to the operation. The type must be the same as for a.

op_min()

template< VectorVec>

constexprbinary_opOperation::Min> aie::op_min ( const Vec & a, const Vec & b )

constexpr

Returns a minimum operation modifier for the given pair of vectors or elements. On some architecture versions, this operation can be collapsed with a subsequent multiplication.

Parameters

a	First vector or element passed to the operation. The type must meetVectororElem.
b	Second vector or element passed to the operation. The type must be the same as for a.

op_none()

template

constexprunary_opOperation::None> aie::op_none ( const T & e )

constexpr

Returns an empty operation modifier for the given vector or element.

Parameters

e	Vectoror element to which the operation is performed. The type must meetVectororElem.

op_sub()

template< AccumAcc>

constexprunary_opOperation::Acc_Sub> aie::op_sub ( const Acc & acc )

constexpr

Returns a subtraction operation modifier for the given accumulator.

Parameters

acc	Accumulator to which the operation is performed.