ARTS  2.3.1285(git:92a29ea9-dirty)
ComplexVectorView Class Reference

The ComplexVectorView class. More...

#include <complex.h>

Inheritance diagram for ComplexVectorView:
ConstComplexVectorView ComplexVector

Public Types

typedef ComplexIterator1D iterator
 
- Public Types inherited from ConstComplexVectorView
typedef ConstComplexIterator1D const_iterator
 

Public Member Functions

constexpr ComplexVectorView (const ComplexVectorView &)=default
 
 ComplexVectorView (const ComplexVector &)
 Bail out immediately if somebody tries to create a ComplexVectorView from a const Complex*Vector. More...
 
 ComplexVectorView (ComplexVector &v)
 Create ComplexVectorView from a ComplexVector. More...
 
Complexoperator[] (Index n)
 Plain Index operator. More...
 
Complexget (Index n)
 Get element implementation without assertions. More...
 
Numericget_real (Index n)
 Get element implementation without assertions. More...
 
Numericget_imag (Index n)
 Get element implementation without assertions. More...
 
VectorView real ()
 Get a view of the real part of the vector. More...
 
VectorView imag ()
 Get a view of the imaginary part of the vector. More...
 
ComplexVectorView operator[] (const Range &r)
 Index operator for subrange. More...
 
ComplexIterator1D begin ()
 Return iterator to first element. More...
 
ComplexIterator1D end ()
 Return iterator behind last element. More...
 
ComplexVectorViewoperator= (const ConstComplexVectorView &v)
 Assignment operator. More...
 
ComplexVectorViewoperator= (const ComplexVectorView &v)
 Assignment from ComplexVectorView to ComplexVectorView. More...
 
ComplexVectorViewoperator= (const ComplexVector &v)
 Assignment from ComplexVector. More...
 
ComplexVectorViewoperator= (const Array< Complex > &v)
 Assignment operator from Array<Complex>. More...
 
ComplexVectorViewoperator= (Complex x)
 Assigning a scalar to a ComplexVectorView will set all elements to this value. More...
 
ComplexVectorViewoperator= (const ConstVectorView &v)
 
ComplexVectorViewoperator= (const VectorView &v)
 
ComplexVectorViewoperator= (const Vector &v)
 
ComplexVectorViewoperator= (const Array< Numeric > &v)
 
ComplexVectorViewoperator= (Numeric x)
 
ComplexVectorView operator*= (Complex x)
 Multiplication by scalar. More...
 
ComplexVectorView operator/= (Complex x)
 Division by scalar. More...
 
ComplexVectorView operator+= (Complex x)
 Addition of scalar. More...
 
ComplexVectorView operator-= (Complex x)
 Subtraction of scalar. More...
 
ComplexVectorView operator*= (Numeric x)
 Multiplication by scalar. More...
 
ComplexVectorView operator/= (Numeric x)
 Division by scalar. More...
 
ComplexVectorView operator+= (Numeric x)
 Addition of scalar. More...
 
ComplexVectorView operator-= (Numeric x)
 Subtraction of scalar. More...
 
ComplexVectorView operator*= (const ConstComplexVectorView &x)
 Element-vise multiplication by another vector. More...
 
ComplexVectorView operator/= (const ConstComplexVectorView &x)
 Element-vise division by another vector. More...
 
ComplexVectorView operator+= (const ConstComplexVectorView &x)
 Element-vise addition of another vector. More...
 
ComplexVectorView operator-= (const ConstComplexVectorView &x)
 Element-vise subtraction of another vector. More...
 
ComplexVectorView operator*= (const ConstVectorView &x)
 Element-vise multiplication by another vector. More...
 
ComplexVectorView operator/= (const ConstVectorView &x)
 Element-vise division by another vector. More...
 
ComplexVectorView operator+= (const ConstVectorView &x)
 Element-vise addition of another vector. More...
 
ComplexVectorView operator-= (const ConstVectorView &x)
 Element-vise subtraction of another vector. More...
 
 operator ComplexMatrixView ()
 Conversion to 1 column matrix. More...
 
const Complexget_c_array () const
 Conversion to plain C-array. More...
 
Complexget_c_array ()
 Conversion to plain C-array. More...
 
virtual ~ComplexVectorView ()=default
 Destructor. More...
 
 ComplexVectorView (Complex &a)
 A special constructor, which allows to make a VectorView from a scalar. More...
 
- Public Member Functions inherited from ConstComplexVectorView
constexpr ConstComplexVectorView (const ConstComplexVectorView &)=default
 
constexpr ConstComplexVectorView (ConstComplexVectorView &&)=default
 
ConstComplexVectorViewoperator= (const ConstComplexVectorView &)=default
 
ConstComplexVectorViewoperator= (ConstComplexVectorView &&)=default
 
bool empty () const
 
Index nelem () const
 
Complex sum () const
 Returns true if variable size is zero. More...
 
const Complexoperator[] (Index n) const
 Plain const index operator. More...
 
const Complexget (Index n) const
 Get element implementation without assertions. More...
 
const Numericget_real (Index n) const
 Get element implementation without assertions. More...
 
const Numericget_imag (Index n) const
 Get element implementation without assertions. More...
 
ConstVectorView real () const
 Get a view of the real part of the vector. More...
 
ConstVectorView imag () const
 Get a view of the imaginary part of the vector. More...
 
ConstComplexVectorView operator[] (const Range &r) const
 Const index operator for subrange. More...
 
ConstComplexIterator1D begin () const
 Return const iterator to first element. More...
 
ConstComplexIterator1D end () const
 Return const iterator behind last element. More...
 
 operator ConstComplexMatrixView () const
 Conversion to const 1 column matrix. More...
 
virtual ~ConstComplexVectorView ()=default
 Destructor. More...
 
 ConstComplexVectorView (const Complex &a)
 A special constructor, which allows to make a ConstComplexVectorView from a scalar. More...
 

Protected Member Functions

 ComplexVectorView ()=default
 
 ComplexVectorView (Complex *data, const Range &range)
 Explicit constructor. More...
 
 ComplexVectorView (Complex *data, const Range &p, const Range &n)
 Recursive constructor. More...
 
- Protected Member Functions inherited from ConstComplexVectorView
 ConstComplexVectorView ()=default
 
 ConstComplexVectorView (Complex *data, const Range &range)
 Explicit constructor. More...
 
 ConstComplexVectorView (Complex *data, const Range &p, const Range &n)
 Recursive constructor. More...
 

Friends

class ConstComplexIterator2D
 
class ComplexIterator2D
 
class ComplexMatrixView
 

Additional Inherited Members

- Protected Attributes inherited from ConstComplexVectorView
Range mrange {0, 0}
 The range of mdata that is actually used. More...
 
Complexmdata {nullptr}
 Pointer to the plain C array that holds the data. More...
 

Detailed Description

The ComplexVectorView class.

This contains the main implementation of a complex vector. The class ComplexVector is just a special case of subvector which also allocates storage.

Unfortunately, names of element functions of derived classes hide the names of the original class, even if the arguments are different. This means that we have to redefine those element functions that can have different arguments, for example the constant index operators and iterators.

Definition at line 367 of file complex.h.

Member Typedef Documentation

◆ iterator

Definition at line 384 of file complex.h.

Constructor & Destructor Documentation

◆ ComplexVectorView() [1/7]

constexpr ComplexVectorView::ComplexVectorView ( const ComplexVectorView )
default

◆ ComplexVectorView() [2/7]

ComplexVectorView::ComplexVectorView ( const ComplexVector )

Bail out immediately if somebody tries to create a ComplexVectorView from a const Complex*Vector.

Definition at line 154 of file complex.cc.

◆ ComplexVectorView() [3/7]

ComplexVectorView::ComplexVectorView ( ComplexVector v)

◆ ~ComplexVectorView()

virtual ComplexVectorView::~ComplexVectorView ( )
virtualdefault

Destructor.

◆ ComplexVectorView() [4/7]

ComplexVectorView::ComplexVectorView ( Complex a)

A special constructor, which allows to make a VectorView from a scalar.

Definition at line 446 of file complex.cc.

◆ ComplexVectorView() [5/7]

ComplexVectorView::ComplexVectorView ( )
protecteddefault

◆ ComplexVectorView() [6/7]

ComplexVectorView::ComplexVectorView ( Complex data,
const Range range 
)
protected

Explicit constructor.

This one is used by Vector to initialize its own VectorView part.

Definition at line 452 of file complex.cc.

◆ ComplexVectorView() [7/7]

ComplexVectorView::ComplexVectorView ( Complex data,
const Range p,
const Range n 
)
protected

Recursive constructor.

This is used to construct sub ranges from sub ranges. That means that the new range has to be interpreted relative to the original range. The new range may contain -1 for the extent which acts as a joker. However, the used Range constructor converts this to an explicit range, consistent with the original Range.

Parameters
*dataThe actual data.
pPrevious range.
nNew Range.

Definition at line 467 of file complex.cc.

Member Function Documentation

◆ begin()

ComplexIterator1D ComplexVectorView::begin ( )

Return iterator to first element.

Definition at line 178 of file complex.cc.

References ConstComplexVectorView::mdata, ConstComplexVectorView::mrange, Range::mstart, and Range::mstride.

Referenced by ComplexVector::ComplexVector(), copy(), and operator=().

◆ end()

ComplexIterator1D ComplexVectorView::end ( )

Return iterator behind last element.

Definition at line 183 of file complex.cc.

References ConstComplexVectorView::mdata, Range::mextent, ConstComplexVectorView::mrange, Range::mstart, and Range::mstride.

Referenced by ComplexVector::ComplexVector(), copy(), and operator=().

◆ get()

Complex& ComplexVectorView::get ( Index  n)
inline

Get element implementation without assertions.

Definition at line 394 of file complex.h.

References n.

◆ get_c_array() [1/2]

const Complex * ComplexVectorView::get_c_array ( ) const

Conversion to plain C-array.

This function returns a pointer to the raw data. It fails if the VectorView is not pointing to the beginning of a Vector or the stride is not 1 because the caller expects to get a C array with continuous data.

Definition at line 421 of file complex.cc.

References ConstComplexVectorView::mdata, ConstComplexVectorView::mrange, Range::mstart, and Range::mstride.

Referenced by diagonalize(), and inv().

◆ get_c_array() [2/2]

Complex * ComplexVectorView::get_c_array ( )

Conversion to plain C-array.

This function returns a pointer to the raw data. It fails if the VectorView is not pointing to the beginning of a Vector or the stride is not 1 because the caller expects to get a C array with continuous data.

Definition at line 435 of file complex.cc.

References ConstComplexVectorView::mdata, ConstComplexVectorView::mrange, Range::mstart, and Range::mstride.

◆ get_imag()

Numeric& ComplexVectorView::get_imag ( Index  n)
inline

Get element implementation without assertions.

Definition at line 404 of file complex.h.

References n.

◆ get_real()

Numeric& ComplexVectorView::get_real ( Index  n)
inline

Get element implementation without assertions.

Definition at line 399 of file complex.h.

References n.

◆ imag()

VectorView ComplexVectorView::imag ( )
inline

Get a view of the imaginary part of the vector.

Definition at line 412 of file complex.h.

References Zeeman::end(), operator+=(), and r.

◆ operator ComplexMatrixView()

ComplexVectorView::operator ComplexMatrixView ( )

Conversion to 1 column matrix.

Definition at line 406 of file complex.cc.

References ConstComplexVectorView::mdata, and ConstComplexVectorView::mrange.

◆ operator*=() [1/4]

ComplexVectorView ComplexVectorView::operator*= ( Complex  x)

Multiplication by scalar.

Definition at line 242 of file complex.cc.

◆ operator*=() [2/4]

ComplexVectorView ComplexVectorView::operator*= ( Numeric  x)

Multiplication by scalar.

Definition at line 249 of file complex.cc.

◆ operator*=() [3/4]

ComplexVectorView ComplexVectorView::operator*= ( const ConstComplexVectorView x)

Element-vise multiplication by another vector.

Definition at line 298 of file complex.cc.

References ConstComplexVectorView::begin(), i, and ConstComplexVectorView::nelem().

◆ operator*=() [4/4]

ComplexVectorView ComplexVectorView::operator*= ( const ConstVectorView x)

Element-vise multiplication by another vector.

Definition at line 312 of file complex.cc.

References ConstComplexVectorView::begin(), ConstVectorView::begin(), i, ConstComplexVectorView::nelem(), and ConstVectorView::nelem().

◆ operator+=() [1/4]

ComplexVectorView ComplexVectorView::operator+= ( Complex  x)

Addition of scalar.

Definition at line 270 of file complex.cc.

◆ operator+=() [2/4]

ComplexVectorView ComplexVectorView::operator+= ( Numeric  x)

Addition of scalar.

Definition at line 277 of file complex.cc.

◆ operator+=() [3/4]

ComplexVectorView ComplexVectorView::operator+= ( const ConstComplexVectorView x)

Element-vise addition of another vector.

Definition at line 352 of file complex.cc.

References ConstComplexVectorView::begin(), i, and ConstComplexVectorView::nelem().

◆ operator+=() [4/4]

ComplexVectorView ComplexVectorView::operator+= ( const ConstVectorView x)

Element-vise addition of another vector.

Definition at line 366 of file complex.cc.

References ConstComplexVectorView::begin(), ConstVectorView::begin(), i, ConstComplexVectorView::nelem(), and ConstVectorView::nelem().

◆ operator-=() [1/4]

ComplexVectorView ComplexVectorView::operator-= ( Complex  x)

Subtraction of scalar.

Definition at line 284 of file complex.cc.

◆ operator-=() [2/4]

ComplexVectorView ComplexVectorView::operator-= ( Numeric  x)

Subtraction of scalar.

Definition at line 291 of file complex.cc.

◆ operator-=() [3/4]

ComplexVectorView ComplexVectorView::operator-= ( const ConstComplexVectorView x)

Element-vise subtraction of another vector.

Definition at line 379 of file complex.cc.

References ConstComplexVectorView::begin(), i, and ConstComplexVectorView::nelem().

◆ operator-=() [4/4]

ComplexVectorView ComplexVectorView::operator-= ( const ConstVectorView x)

Element-vise subtraction of another vector.

Definition at line 393 of file complex.cc.

References ConstComplexVectorView::begin(), ConstVectorView::begin(), i, ConstComplexVectorView::nelem(), and ConstVectorView::nelem().

◆ operator/=() [1/4]

ComplexVectorView ComplexVectorView::operator/= ( Complex  x)

Division by scalar.

Definition at line 256 of file complex.cc.

◆ operator/=() [2/4]

ComplexVectorView ComplexVectorView::operator/= ( Numeric  x)

Division by scalar.

Definition at line 263 of file complex.cc.

◆ operator/=() [3/4]

ComplexVectorView ComplexVectorView::operator/= ( const ConstComplexVectorView x)

Element-vise division by another vector.

Definition at line 325 of file complex.cc.

References ConstComplexVectorView::begin(), i, and ConstComplexVectorView::nelem().

◆ operator/=() [4/4]

ComplexVectorView ComplexVectorView::operator/= ( const ConstVectorView x)

Element-vise division by another vector.

Definition at line 339 of file complex.cc.

References ConstComplexVectorView::begin(), ConstVectorView::begin(), i, ConstComplexVectorView::nelem(), and ConstVectorView::nelem().

◆ operator=() [1/10]

ComplexVectorView & ComplexVectorView::operator= ( const ConstComplexVectorView v)

Assignment operator.

This copies the data from another VectorView t o this Complex*VectorView. Dimensions must agree! Resizing would destroy the selection that we might have done in this VectorView by setting its range.

Definition at line 193 of file complex.cc.

References ConstComplexVectorView::begin(), copy(), ConstComplexVectorView::end(), Range::mextent, and ConstComplexVectorView::mrange.

Referenced by ComplexVector::operator=().

◆ operator=() [2/10]

ComplexVectorView & ComplexVectorView::operator= ( const ComplexVectorView v)

Assignment from ComplexVectorView to ComplexVectorView.

This is a tricky one. The problem is that since ComplexVectorView is derived from ConstComplexVectorView, a default = operator is generated by the compiler, which does not do what we want. So we need this one to override the default.

Definition at line 210 of file complex.cc.

References ConstComplexVectorView::begin(), begin(), copy(), end(), Range::mextent, and ConstComplexVectorView::mrange.

◆ operator=() [3/10]

ComplexVectorView & ComplexVectorView::operator= ( const ComplexVector v)

Assignment from ComplexVector.

This is important to avoid a bug when assigning a Vector to a Complex*VectorView.

Definition at line 223 of file complex.cc.

References ConstComplexVectorView::begin(), begin(), copy(), end(), Range::mextent, and ConstComplexVectorView::mrange.

◆ operator=() [4/10]

ComplexVectorView & ComplexVectorView::operator= ( const Array< Complex > &  v)

Assignment operator from Array<Complex>.

This copies the data from an Array<Complex> to this VectorView. Dimensions must agree! Resizing would destroy the selection that we might have done in this VectorView by setting its range.

Array<Complex> can be useful to collect things in, because there is a .push_back method for it. Then, after collecting we usually have to transfer the content to a Vector. With this assignment operator that's easy.

Definition at line 1534 of file complex.cc.

References i, and Array< base >::nelem().

◆ operator=() [5/10]

ComplexVectorView & ComplexVectorView::operator= ( Complex  x)

Assigning a scalar to a ComplexVectorView will set all elements to this value.

Definition at line 236 of file complex.cc.

References ConstComplexVectorView::begin(), copy(), and ConstComplexVectorView::end().

◆ operator=() [6/10]

ComplexVectorView& ComplexVectorView::operator= ( const ConstVectorView v)

◆ operator=() [7/10]

ComplexVectorView& ComplexVectorView::operator= ( const VectorView v)

◆ operator=() [8/10]

ComplexVectorView& ComplexVectorView::operator= ( const Vector v)

◆ operator=() [9/10]

ComplexVectorView& ComplexVectorView::operator= ( const Array< Numeric > &  v)

◆ operator=() [10/10]

ComplexVectorView& ComplexVectorView::operator= ( Numeric  x)

◆ operator[]() [1/2]

Complex& ComplexVectorView::operator[] ( Index  n)
inline

Plain Index operator.

Definition at line 387 of file complex.h.

References n.

◆ operator[]() [2/2]

ComplexVectorView ComplexVectorView::operator[] ( const Range r)

Index operator for subrange.

We have to also account for the case, that *this is already a subrange of a Vector. This allows correct recursive behavior.

Definition at line 173 of file complex.cc.

References ConstComplexVectorView::ComplexVectorView, ConstComplexVectorView::mdata, and ConstComplexVectorView::mrange.

◆ real()

VectorView ComplexVectorView::real ( )
inline

Get a view of the real part of the vector.

Definition at line 409 of file complex.h.

Friends And Related Function Documentation

◆ ComplexIterator2D

friend class ComplexIterator2D
friend

Definition at line 462 of file complex.h.

◆ ComplexMatrixView

friend class ComplexMatrixView
friend

Definition at line 463 of file complex.h.

◆ ConstComplexIterator2D

friend class ConstComplexIterator2D
friend

Definition at line 461 of file complex.h.

Referenced by ConstComplexMatrixView::begin(), and ConstComplexMatrixView::end().


The documentation for this class was generated from the following files: