ARTS 2.5.10 (git: 2f1c442c)
Public Member Functions | Private Attributes | Friends | List of all members
Range Class Reference

The range class. More...

#include <matpackI.h>

Public Member Functions

constexpr Range (Index start, Index extent, Index stride=1) ARTS_NOEXCEPT
 Explicit constructor.
 
constexpr Range (Index start, Joker, Index stride=1) ARTS_NOEXCEPT
 Constructor with joker extent.
 
constexpr Range (Joker, Index stride=1) noexcept
 Constructor with just a joker.
 
constexpr Range (Index max_size, const Range &r) ARTS_NOEXCEPT
 Constructor which converts a range with joker to an explicit range.
 
constexpr Range (const Range &p, const Range &n) ARTS_NOEXCEPT
 Constructor of a new range relative to an old range.
 
constexpr Index get_start () const noexcept
 Returns the start index of the range.
 
constexpr Index get_extent () const noexcept
 Returns the extent of the range.
 
constexpr Index get_stride () const noexcept
 Returns the stride of the range.
 
constexpr Range operator() (const Range r) const ARTS_NOEXCEPT
 Range of range.
 
constexpr Index operator() (const Index i) const ARTS_NOEXCEPT
 
constexpr void swap (Range &other) noexcept
 

Private Attributes

Index mstart
 The start index.
 
Index mextent
 The number of elements.
 
Index mstride
 The stride.
 

Friends

class ConstVectorView
 
class VectorView
 
class Vector
 invlib wrapper type for ARTS vectors.
 
class ConstMatrixView
 
class MatrixView
 
class Matrix
 invlib wrapper type for ARTS matrices.
 
class Iterator2D
 
class Iterator3D
 
class Iterator4D
 
class Iterator5D
 
class Iterator6D
 
class Iterator7D
 
class ConstIterator2D
 
class ConstIterator3D
 
class ConstIterator4D
 
class ConstIterator5D
 
class ConstIterator6D
 
class ConstIterator7D
 
class ConstTensor3View
 
class Tensor3View
 
class Tensor3
 
class ConstTensor4View
 
class Tensor4View
 
class Tensor4
 
class ConstTensor5View
 
class Tensor5View
 
class Tensor5
 
class ConstTensor6View
 
class Tensor6View
 
class Tensor6
 
class ConstTensor7View
 
class Tensor7View
 
class Tensor7
 
struct Sparse
 
class ConstComplexVectorView
 
class ComplexVectorView
 
class ComplexVector
 
class ConstComplexMatrixView
 
class ComplexMatrixView
 
class ComplexMatrix
 
class ComplexIterator2D
 
class ConstComplexIterator2D
 
void mult_general (VectorView, const ConstMatrixView &, const ConstVectorView &) ARTS_NOEXCEPT
 Matrix Vector multiplication.
 
std::ostream & operator<< (std::ostream &os, const Range &r)
 
constexpr void swap (Range &a, Range &b) noexcept
 

Detailed Description

The range class.

This is used to specifiy a range of a vector. In general, a range is given by a start index, an extent, and a stride. The entire vector would be: start = 0, range = # elements, stride = 1

Stride specifies the stepsize of the vector. A stride of 2 means only every second element. This is particularly important in connection with matrices.

There are a number of special constructors for this class, of particular interest should be those using jokers, which provide a Matlab-like functionality.

Definition at line 160 of file matpackI.h.

Constructor & Destructor Documentation

◆ Range() [1/5]

constexpr Range::Range ( Index  start,
Index  extent,
Index  stride = 1 
)
inlineconstexpr

Explicit constructor.

Parameters
[in]startStart must be >= 0.
[in]extentExtent also. Although internally negative extent means "to the end", this can not be created this way, only with the joker. Zero extent is allowed, though, which corresponds to an empty range.
[in]strideStride can be anything. It can be omitted, in which case the default value is 1.

Definition at line 174 of file matpackI.h.

References ARTS_ASSERT, mextent, and mstart.

◆ Range() [2/5]

constexpr Range::Range ( Index  start,
Joker  ,
Index  stride = 1 
)
inlineconstexpr

Constructor with joker extent.

Depending on the sign of stride, this means "to the end", or "to the beginning".

Definition at line 191 of file matpackI.h.

References ARTS_ASSERT, and mstart.

◆ Range() [3/5]

constexpr Range::Range ( Joker  ,
Index  stride = 1 
)
inlineconstexprnoexcept

Constructor with just a joker.

This means, take everything. You can still optionally give a stride, though. This constructor is just shorter notation for Range(0,joker)

Definition at line 202 of file matpackI.h.

◆ Range() [4/5]

constexpr Range::Range ( Index  max_size,
const Range &  r 
)
inlineconstexpr

Constructor which converts a range with joker to an explicit range.

Parameters
[in]max_sizeThe maximum allowed size of the vector.
[in]rThe new range, with joker.

Definition at line 214 of file matpackI.h.

References ARTS_ASSERT, mextent, mstart, and mstride.

◆ Range() [5/5]

constexpr Range::Range ( const Range &  p,
const Range &  n 
)
inlineconstexpr

Constructor of a new range relative to an old range.

The new range may contain -1 for the stride, which acts as a joker.

Parameters
[in]pPrevious range.
[in]nNew range.

Definition at line 247 of file matpackI.h.

References ARTS_ASSERT, mextent, mstart, and mstride.

Member Function Documentation

◆ get_extent()

constexpr Index Range::get_extent ( ) const
inlineconstexprnoexcept

Returns the extent of the range.

Definition at line 343 of file matpackI.h.

References mextent.

Referenced by covmat_seAddBlock(), CovarianceMatrix::is_consistent(), Block::ncols(), Block::nrows(), Tensor3::reduce_rank(), Tensor4::reduce_rank(), Tensor5::reduce_rank(), Tensor6::reduce_rank(), and Tensor7::reduce_rank().

◆ get_start()

constexpr Index Range::get_start ( ) const
inlineconstexprnoexcept

Returns the start index of the range.

Definition at line 341 of file matpackI.h.

References mstart.

Referenced by calcBaselineFit(), CovarianceMatrix::is_consistent(), jacobianCalcPointingZaInterp(), jacobianCalcPointingZaRecalc(), jacobianCalcPolyfit(), jacobianCalcSinefit(), yCalc(), and yCalc_mblock_loop_body().

◆ get_stride()

constexpr Index Range::get_stride ( ) const
inlineconstexprnoexcept

Returns the stride of the range.

Definition at line 345 of file matpackI.h.

References mstride.

◆ operator()() [1/2]

constexpr Index Range::operator() ( const Index  i) const
inlineconstexpr

Definition at line 360 of file matpackI.h.

References mstart, and mstride.

◆ operator()() [2/2]

constexpr Range Range::operator() ( const Range  r) const
inlineconstexpr

Range of range.

Definition at line 348 of file matpackI.h.

References joker, mextent, mstart, and mstride.

◆ swap()

constexpr void Range::swap ( Range &  other)
inlineconstexprnoexcept

Definition at line 366 of file matpackI.h.

References mextent, mstart, mstride, and swap.

Friends And Related Function Documentation

◆ ComplexIterator2D

friend class ComplexIterator2D
friend

Definition at line 331 of file matpackI.h.

◆ ComplexMatrix

friend class ComplexMatrix
friend

Definition at line 330 of file matpackI.h.

◆ ComplexMatrixView

friend class ComplexMatrixView
friend

Definition at line 329 of file matpackI.h.

◆ ComplexVector

friend class ComplexVector
friend

Definition at line 327 of file matpackI.h.

◆ ComplexVectorView

friend class ComplexVectorView
friend

Definition at line 326 of file matpackI.h.

◆ ConstComplexIterator2D

friend class ConstComplexIterator2D
friend

Definition at line 332 of file matpackI.h.

◆ ConstComplexMatrixView

friend class ConstComplexMatrixView
friend

Definition at line 328 of file matpackI.h.

◆ ConstComplexVectorView

friend class ConstComplexVectorView
friend

Definition at line 325 of file matpackI.h.

◆ ConstIterator2D

friend class ConstIterator2D
friend

Definition at line 303 of file matpackI.h.

◆ ConstIterator3D

friend class ConstIterator3D
friend

Definition at line 304 of file matpackI.h.

◆ ConstIterator4D

friend class ConstIterator4D
friend

Definition at line 305 of file matpackI.h.

◆ ConstIterator5D

friend class ConstIterator5D
friend

Definition at line 306 of file matpackI.h.

◆ ConstIterator6D

friend class ConstIterator6D
friend

Definition at line 307 of file matpackI.h.

◆ ConstIterator7D

friend class ConstIterator7D
friend

Definition at line 308 of file matpackI.h.

◆ ConstMatrixView

friend class ConstMatrixView
friend

Definition at line 294 of file matpackI.h.

◆ ConstTensor3View

friend class ConstTensor3View
friend

Definition at line 309 of file matpackI.h.

◆ ConstTensor4View

friend class ConstTensor4View
friend

Definition at line 312 of file matpackI.h.

◆ ConstTensor5View

friend class ConstTensor5View
friend

Definition at line 315 of file matpackI.h.

◆ ConstTensor6View

friend class ConstTensor6View
friend

Definition at line 318 of file matpackI.h.

◆ ConstTensor7View

friend class ConstTensor7View
friend

Definition at line 321 of file matpackI.h.

◆ ConstVectorView

friend class ConstVectorView
friend

Definition at line 291 of file matpackI.h.

◆ Iterator2D

friend class Iterator2D
friend

Definition at line 297 of file matpackI.h.

◆ Iterator3D

friend class Iterator3D
friend

Definition at line 298 of file matpackI.h.

◆ Iterator4D

friend class Iterator4D
friend

Definition at line 299 of file matpackI.h.

◆ Iterator5D

friend class Iterator5D
friend

Definition at line 300 of file matpackI.h.

◆ Iterator6D

friend class Iterator6D
friend

Definition at line 301 of file matpackI.h.

◆ Iterator7D

friend class Iterator7D
friend

Definition at line 302 of file matpackI.h.

◆ Matrix

friend class Matrix
friend

invlib wrapper type for ARTS matrices.

Definition at line 296 of file matpackI.h.

◆ MatrixView

friend class MatrixView
friend

Definition at line 295 of file matpackI.h.

◆ mult_general

void mult_general ( VectorView  y,
const ConstMatrixView &  M,
const ConstVectorView &  x 
)
friend

Matrix Vector multiplication.

y = M*x. Note that the order is different from MTL, output comes first! Dimensions of y, M, and x must match. No memory reallocation takes place, only the data is copied. Using this function on overlapping Matrix and VectorViews belonging to the same Matrix will lead to unpredictable results.

The implementation here is different from the other multiplication routines. It does not use iterators but a more drastic approach to gain maximum performance.

Definition at line 1138 of file matpackI.cc.

◆ operator<<

std::ostream & operator<< ( std::ostream &  os,
const Range &  r 
)
friend

Definition at line 39 of file matpackI.cc.

◆ Sparse

friend struct Sparse
friend

Definition at line 324 of file matpackI.h.

◆ swap

constexpr void swap ( Range &  a,
Range &  b 
)
friend

Definition at line 373 of file matpackI.h.

Referenced by swap().

◆ Tensor3

friend class Tensor3
friend

Definition at line 311 of file matpackI.h.

◆ Tensor3View

friend class Tensor3View
friend

Definition at line 310 of file matpackI.h.

◆ Tensor4

friend class Tensor4
friend

Definition at line 314 of file matpackI.h.

◆ Tensor4View

friend class Tensor4View
friend

Definition at line 313 of file matpackI.h.

◆ Tensor5

friend class Tensor5
friend

Definition at line 317 of file matpackI.h.

◆ Tensor5View

friend class Tensor5View
friend

Definition at line 316 of file matpackI.h.

◆ Tensor6

friend class Tensor6
friend

Definition at line 320 of file matpackI.h.

◆ Tensor6View

friend class Tensor6View
friend

Definition at line 319 of file matpackI.h.

◆ Tensor7

friend class Tensor7
friend

Definition at line 323 of file matpackI.h.

◆ Tensor7View

friend class Tensor7View
friend

Definition at line 322 of file matpackI.h.

◆ Vector

friend class Vector
friend

invlib wrapper type for ARTS vectors.

Definition at line 293 of file matpackI.h.

◆ VectorView

friend class VectorView
friend

Definition at line 292 of file matpackI.h.

Member Data Documentation

◆ mextent

Index Range::mextent
private

The number of elements.

-1 means extent to the end of the vector.

Definition at line 380 of file matpackI.h.

Referenced by ComplexMatrixView::diagonal(), ConstComplexMatrixView::diagonal(), ConstMatrixView::diagonal(), ConstVectorView::empty(), ComplexVectorView::end(), ComplexMatrixView::end(), Tensor3View::end(), Tensor4View::end(), Tensor5View::end(), Tensor6View::end(), Tensor7View::end(), VectorView::end(), MatrixView::end(), ConstComplexVectorView::end(), ConstComplexMatrixView::end(), ConstTensor3View::end(), ConstTensor4View::end(), ConstTensor5View::end(), ConstTensor6View::end(), ConstTensor7View::end(), ConstVectorView::end(), ConstMatrixView::end(), Tensor3View::get_c_array(), Tensor4View::get_c_array(), Tensor5View::get_c_array(), Tensor6View::get_c_array(), Tensor7View::get_c_array(), get_extent(), ComplexVectorView::imag(), ComplexMatrixView::imag(), ConstComplexVectorView::imag(), ConstComplexMatrixView::imag(), ConstTensor4View::nbooks(), ConstTensor5View::nbooks(), ConstTensor6View::nbooks(), ConstTensor7View::nbooks(), ConstTensor3View::ncols(), ConstTensor4View::ncols(), ConstTensor5View::ncols(), ConstTensor6View::ncols(), ConstTensor7View::ncols(), ConstComplexVectorView::nelem(), ConstVectorView::nelem(), ConstTensor7View::nlibraries(), ConstTensor3View::npages(), ConstTensor4View::npages(), ConstTensor5View::npages(), ConstTensor6View::npages(), ConstTensor7View::npages(), ConstTensor3View::nrows(), ConstTensor4View::nrows(), ConstTensor5View::nrows(), ConstTensor6View::nrows(), ConstTensor7View::nrows(), ConstTensor5View::nshelves(), ConstTensor6View::nshelves(), ConstTensor7View::nshelves(), ConstTensor6View::nvitrines(), ConstTensor7View::nvitrines(), Tensor4View::operator()(), ConstTensor4View::operator()(), Tensor3View::operator()(), ConstTensor3View::operator()(), ComplexMatrixView::operator()(), ConstComplexMatrixView::operator()(), Tensor5View::operator()(), ConstTensor5View::operator()(), operator()(), ComplexMatrixView::operator=(), ComplexVectorView::operator=(), MatrixView::operator=(), Tensor3View::operator=(), Tensor4View::operator=(), Tensor5View::operator=(), Tensor6View::operator=(), Tensor7View::operator=(), VectorView::operator=(), ComplexVectorView::operator[](), VectorView::operator[](), ConstComplexVectorView::operator[](), ConstVectorView::operator[](), Range(), ComplexVectorView::real(), ComplexMatrixView::real(), ConstComplexVectorView::real(), ConstComplexMatrixView::real(), Tensor4::resize(), Tensor7::resize(), Vector::resize(), Tensor3::resize(), ComplexMatrix::resize(), Matrix::resize(), Tensor5::resize(), Tensor6::resize(), ConstComplexVectorView::size(), ConstVectorView::size(), and swap().

◆ mstart

Index Range::mstart
private

The start index.

Definition at line 377 of file matpackI.h.

Referenced by ComplexVectorView::begin(), ComplexMatrixView::begin(), Tensor3View::begin(), Tensor4View::begin(), Tensor5View::begin(), Tensor6View::begin(), Tensor7View::begin(), VectorView::begin(), MatrixView::begin(), ConstComplexVectorView::begin(), ConstComplexMatrixView::begin(), ConstTensor3View::begin(), ConstTensor4View::begin(), ConstTensor5View::begin(), ConstTensor6View::begin(), ConstTensor7View::begin(), ConstVectorView::begin(), ConstMatrixView::begin(), ComplexMatrixView::diagonal(), ConstComplexMatrixView::diagonal(), ConstMatrixView::diagonal(), ComplexVectorView::end(), ComplexMatrixView::end(), Tensor3View::end(), Tensor4View::end(), Tensor5View::end(), Tensor6View::end(), Tensor7View::end(), VectorView::end(), MatrixView::end(), ConstComplexVectorView::end(), ConstComplexMatrixView::end(), ConstTensor3View::end(), ConstTensor4View::end(), ConstTensor5View::end(), ConstTensor6View::end(), ConstTensor7View::end(), ConstVectorView::end(), ConstMatrixView::end(), ConstTensor4View::get(), ComplexVectorView::get(), ConstComplexVectorView::get(), ConstVectorView::get(), ConstTensor3View::get(), ConstTensor5View::get(), Tensor3View::get_c_array(), Tensor4View::get_c_array(), Tensor5View::get_c_array(), Tensor6View::get_c_array(), Tensor7View::get_c_array(), get_start(), ComplexVectorView::imag(), ComplexMatrixView::imag(), ConstComplexVectorView::imag(), ConstComplexMatrixView::imag(), ComplexIterator2D::operator!=(), ConstComplexIterator2D::operator!=(), ConstIterator3D::operator!=(), ConstIterator4D::operator!=(), ConstIterator5D::operator!=(), ConstIterator6D::operator!=(), ConstIterator7D::operator!=(), Iterator3D::operator!=(), Iterator4D::operator!=(), Iterator5D::operator!=(), Iterator6D::operator!=(), Iterator7D::operator!=(), Tensor4View::operator()(), ConstTensor4View::operator()(), Tensor3View::operator()(), ConstTensor3View::operator()(), ComplexMatrixView::operator()(), ConstComplexMatrixView::operator()(), Tensor5View::operator()(), ConstTensor5View::operator()(), operator()(), Range(), ComplexVectorView::real(), ComplexMatrixView::real(), ConstComplexVectorView::real(), ConstComplexMatrixView::real(), Tensor4::resize(), Tensor7::resize(), Vector::resize(), Tensor3::resize(), ComplexMatrix::resize(), Matrix::resize(), Tensor5::resize(), Tensor6::resize(), ConstComplexVectorView::selem(), ConstVectorView::selem(), and swap().

◆ mstride

Index Range::mstride
private

The stride.

Can be positive or negative.

Definition at line 382 of file matpackI.h.

Referenced by ComplexVectorView::begin(), ComplexMatrixView::begin(), Tensor3View::begin(), Tensor4View::begin(), Tensor5View::begin(), Tensor6View::begin(), Tensor7View::begin(), VectorView::begin(), MatrixView::begin(), ConstComplexVectorView::begin(), ConstComplexMatrixView::begin(), ConstTensor3View::begin(), ConstTensor4View::begin(), ConstTensor5View::begin(), ConstTensor6View::begin(), ConstTensor7View::begin(), ConstVectorView::begin(), ConstMatrixView::begin(), ConstComplexVectorView::delem(), ConstVectorView::delem(), ComplexMatrixView::diagonal(), ConstComplexMatrixView::diagonal(), ConstMatrixView::diagonal(), ComplexVectorView::end(), ComplexMatrixView::end(), Tensor3View::end(), Tensor4View::end(), Tensor5View::end(), Tensor6View::end(), Tensor7View::end(), VectorView::end(), MatrixView::end(), ConstComplexVectorView::end(), ConstComplexMatrixView::end(), ConstTensor3View::end(), ConstTensor4View::end(), ConstTensor5View::end(), ConstTensor6View::end(), ConstTensor7View::end(), ConstVectorView::end(), ConstMatrixView::end(), ConstTensor4View::get(), ComplexVectorView::get(), ConstComplexVectorView::get(), ConstVectorView::get(), ConstTensor3View::get(), ConstTensor5View::get(), Tensor3View::get_c_array(), Tensor4View::get_c_array(), Tensor5View::get_c_array(), Tensor6View::get_c_array(), Tensor7View::get_c_array(), get_stride(), ComplexVectorView::imag(), ComplexMatrixView::imag(), ConstComplexVectorView::imag(), ConstComplexMatrixView::imag(), Tensor4View::operator()(), ConstTensor4View::operator()(), Tensor3View::operator()(), ConstTensor3View::operator()(), ComplexMatrixView::operator()(), ConstComplexMatrixView::operator()(), Tensor5View::operator()(), ConstTensor5View::operator()(), operator()(), Range(), ComplexVectorView::real(), ComplexMatrixView::real(), ConstComplexVectorView::real(), ConstComplexMatrixView::real(), Tensor4::resize(), Tensor7::resize(), Vector::resize(), Tensor3::resize(), ComplexMatrix::resize(), Matrix::resize(), Tensor5::resize(), Tensor6::resize(), and swap().

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