Unbounded dense matrix holding floating-point values of type double. More...

Inheritance diagram for CDPL.Math.DMatrix:

Public Member Functions
None	__init__ ()
	Constructs an empty matrix (zero rows and zero columns).

None	__init__ (DMatrix m)
	Constructs a copy of the matrix m. More...

None	__init__ (int m, int n)
	Constructs an m×n matrix with default-initialized elements. More...

None	__init__ (int m, int n, float v)
	Constructs an m×n matrix with every element initialized to v. More...

None	__init__ (ConstFMatrixExpression e)
	Constructs the matrix from the matrix expression e (materializing the expression result). More...

None	__init__ (ConstDMatrixExpression e)
	Constructs the matrix from the matrix expression e (materializing the expression result). More...

None	__init__ (ConstLMatrixExpression e)
	Constructs the matrix from the matrix expression e (materializing the expression result). More...

None	__init__ (ConstULMatrixExpression e)
	Constructs the matrix from the matrix expression e (materializing the expression result). More...

None	__init__ (object a)
	Constructs the matrix from the 2D `numpy.ndarray` object a. More...

None	resize (int m, int n, bool preserve=True, float v=0.0)
	Resizes the matrix to m×n elements. More...

None	clear (float v=0.0)
	Sets every element of the matrix to the value v. More...

int	getObjectID ()
	Returns the numeric identifier (ID) of the wrapped C++ class instance. More...

DMatrix	assign (ConstFMatrixExpression e)
	Assigns the matrix expression e to this matrix (via a temporary to handle aliasing). More...

DMatrix	assign (ConstDMatrixExpression e)
	Assigns the matrix expression e to this matrix (via a temporary to handle aliasing). More...

DMatrix	assign (ConstLMatrixExpression e)
	Assigns the matrix expression e to this matrix (via a temporary to handle aliasing). More...

DMatrix	assign (ConstULMatrixExpression e)
	Assigns the matrix expression e to this matrix (via a temporary to handle aliasing). More...

DMatrix	assign (DMatrix m)
	Copy-assigns the contents of m to this matrix. More...

DMatrix	assign (object a)
	Assigns the contents of the 2D `numpy.ndarray` object a to this matrix. More...

int	getSize1 ()
	Returns the number of rows. More...

int	getSize2 ()
	Returns the number of columns. More...

bool	isEmpty ()
	Tells whether the matrix is empty. More...

float	getElement (int i, int j)
	Returns the element at (i, j). More...

object	toArray ()
	Converts the `DMatrix` instance into a corresponding `numpy.ndarray` object. More...

None	swap (DMatrix m)
	Swaps the contents of this matrix with those of m. More...

None	setElement (int i, int j, float v)
	Sets the value of the element (i, j) to v. More...

float	__call__ (int i, int j)
	Returns the element at (i, j). More...

float	__getitem__ (tuple ij)
	Returns the element at (i, j). More...

int	__len__ ()
	Returns the number of rows. More...

bool	__eq__ (DMatrix m)
	Returns the result of the comparison operation `self == m`. More...

bool	__eq__ (ConstDMatrixExpression e)
	Returns the result of the comparison operation `self == e`. More...

bool	__ne__ (DMatrix m)
	Returns the result of the comparison operation `self != m`. More...

bool	__ne__ (ConstDMatrixExpression e)
	Returns the result of the comparison operation `self != e`. More...

str	__str__ ()
	Returns a string representation of the `DMatrix` instance. More...

DMatrix	__pos__ ()
	Returns self. More...

ConstDMatrixExpression	__neg__ ()
	Returns the result of the operation `self * -1`. More...

ConstDMatrixExpression	__add__ (ConstDMatrixExpression e)
	Returns the result of the addition operation `self + e`. More...

ConstDMatrixExpression	__sub__ (ConstDMatrixExpression e)
	Returns the result of the subtraction operation `self - e`. More...

ConstDMatrixExpression	__mul__ (float t)
	Returns the result of the multiplication operation `self * t`. More...

ConstDMatrixExpression	__mul__ (ConstDMatrixExpression e)
	Returns the result of the multiplication operation `self * e`. More...

ConstDVectorExpression	__mul__ (ConstDVectorExpression e)
	Returns the result of the multiplication operation `self * e`. More...

ConstDMatrixExpression	__div__ (float t)
	Returns the result of the division operation `self // t`. More...

ConstDMatrixExpression	__truediv__ (float t)
	Returns the result of the true division operation `self / t`. More...

ConstDMatrixExpression	__rmul__ (float t)
	Returns the result of the multiplication operation `t * self`. More...

None	__setitem__ (tuple ij, float v)
	Sets the value of the element (i, j) to v. More...

DMatrix	__iadd__ (DMatrix m)
	Adds the contents of the matrix m element-wise to this matrix (no alias check needed). More...

DMatrix	__iadd__ (ConstDMatrixExpression e)
	Adds the matrix expression e element-wise to this matrix (via a temporary to handle aliasing). More...

DMatrix	__isub__ (DMatrix m)
	Subtracts the contents of the matrix m element-wise from this matrix (no alias check needed). More...

DMatrix	__isub__ (ConstDMatrixExpression e)
	Subtracts the matrix expression e element-wise from this matrix (via a temporary to handle aliasing). More...

DMatrix	__imul__ (float t)
	Multiplies every element by the scalar t. More...

DMatrix	__idiv__ (float t)
	Divides every element by the scalar t. More...

DMatrix	__itruediv__ (float t)
	Divides every element by the scalar t. More...

Properties
	objectID = property(getObjectID)

	size1 = property(getSize1)

	size2 = property(getSize2)

Detailed Description

Unbounded dense matrix holding floating-point values of type double.

Constructor & Destructor Documentation

◆ init() [1/8]

None CDPL.Math.DMatrix.__init__ ( DMatrix m )

Constructs a copy of the matrix m.

Parameters

m	The matrix to copy.

◆ init() [2/8]

None CDPL.Math.DMatrix.__init__	(	int	m,
		int	n
	)

Constructs an m×n matrix with default-initialized elements.

Parameters

m	The number of rows.
n	The number of columns.

◆ init() [3/8]

None CDPL.Math.DMatrix.__init__	(	int	m,
		int	n,
		float	v
	)

Constructs an m×n matrix with every element initialized to v.

Parameters

m	The number of rows.
n	The number of columns.
v	The value used for element initialization.

◆ init() [4/8]

None CDPL.Math.DMatrix.__init__ ( ConstFMatrixExpression e )

Constructs the matrix from the matrix expression e (materializing the expression result).

Parameters

e	The matrix expression to materialize.

◆ init() [5/8]

None CDPL.Math.DMatrix.__init__ ( ConstDMatrixExpression e )

Constructs the matrix from the matrix expression e (materializing the expression result).

Parameters

e	The matrix expression to materialize.

◆ init() [6/8]

None CDPL.Math.DMatrix.__init__ ( ConstLMatrixExpression e )

Constructs the matrix from the matrix expression e (materializing the expression result).

Parameters

e	The matrix expression to materialize.

◆ init() [7/8]

None CDPL.Math.DMatrix.__init__ ( ConstULMatrixExpression e )

Constructs the matrix from the matrix expression e (materializing the expression result).

Parameters

e	The matrix expression to materialize.

◆ init() [8/8]

None CDPL.Math.DMatrix.__init__ ( object a )

Constructs the matrix from the 2D numpy.ndarray object a.

Parameters

a	The `numpy.ndarray` object.

See also: [NUMPY]

Member Function Documentation

◆ resize()

None CDPL.Math.DMatrix.resize	(	int	m,
		int	n,
		bool	preserve = `True`,
		float	v = `0.0`
	)

Resizes the matrix to m×n elements.

Parameters

m	The new row count.
n	The new column count.
preserve	If `True`, existing element values at indices that remain valid are kept. If `False`, all elements are set to v.
v	The fill value for newly added elements (or for all elements when preserve is `False`).

◆ clear()

None CDPL.Math.DMatrix.clear ( float v = 0.0 )

Sets every element of the matrix to the value v.

Parameters

v	The fill value.

◆ getObjectID()

int CDPL.Math.DMatrix.getObjectID ( )

Returns the numeric identifier (ID) of the wrapped C++ class instance.

Different Python DMatrix instances may reference the same underlying C++ class instance. The commonly used Python expression a is not b thus cannot tell reliably whether the two DMatrix instances a and b reference different C++ objects. The numeric identifier returned by this method allows to correctly implement such an identity test via the simple expression a.getObjectID() != b.getObjectID().

Returns: The numeric ID of the internally referenced C++ class instance.

◆ assign() [1/6]

DMatrix CDPL.Math.DMatrix.assign ( ConstFMatrixExpression e )

Assigns the matrix expression e to this matrix (via a temporary to handle aliasing).

Parameters

e	The source matrix expression.

Returns: self.

◆ assign() [2/6]

DMatrix CDPL.Math.DMatrix.assign ( ConstDMatrixExpression e )

Assigns the matrix expression e to this matrix (via a temporary to handle aliasing).

Parameters

e	The source matrix expression.

Returns: self.

◆ assign() [3/6]

DMatrix CDPL.Math.DMatrix.assign ( ConstLMatrixExpression e )

Assigns the matrix expression e to this matrix (via a temporary to handle aliasing).

Parameters

e	The source matrix expression.

Returns: self.

◆ assign() [4/6]

DMatrix CDPL.Math.DMatrix.assign ( ConstULMatrixExpression e )

Assigns the matrix expression e to this matrix (via a temporary to handle aliasing).

Parameters

e	The source matrix expression.

Returns: self.

◆ assign() [5/6]

DMatrix CDPL.Math.DMatrix.assign ( DMatrix m )

Copy-assigns the contents of m to this matrix.

Parameters

m	The source matrix.

Returns: self.

◆ assign() [6/6]

DMatrix CDPL.Math.DMatrix.assign ( object a )

Assigns the contents of the 2D numpy.ndarray object a to this matrix.

Parameters

a	The `numpy.ndarray` object.

See also: [NUMPY]

◆ getSize1()

int CDPL.Math.DMatrix.getSize1 ( )

Returns the number of rows.

Returns: The number of rows.

◆ getSize2()

int CDPL.Math.DMatrix.getSize2 ( )

Returns the number of columns.

Returns: The number of columns.

◆ isEmpty()

bool CDPL.Math.DMatrix.isEmpty ( )

Tells whether the matrix is empty.

Returns: True if the underlying storage holds no elements, and False otherwise.

◆ getElement()

float CDPL.Math.DMatrix.getElement	(	int	i,
		int	j
	)

Returns the element at (i, j).

Parameters

i	The zero-based row index.
j	The zero-based column index.

Returns: The value of the element.

Exceptions

Base.IndexError if either index is out of range.

◆ toArray()

object CDPL.Math.DMatrix.toArray ( )

Converts the DMatrix instance into a corresponding numpy.ndarray object.

Returns: The generated numpy.ndarray object.

See also: [NUMPY]

◆ swap()

None CDPL.Math.DMatrix.swap ( DMatrix m )

Swaps the contents of this matrix with those of m.

Parameters

m	The matrix to swap with.

◆ setElement()

None CDPL.Math.DMatrix.setElement	(	int	i,
		int	j,
		float	v
	)

Sets the value of the element (i, j) to v.

Parameters

i	The zero-based row index.
j	The zero-based column index.
v	The new value of the element.

Exceptions

Base.IndexError if any of the indices is out of range.

◆ call()

float CDPL.Math.DMatrix.__call__	(	int	i,
		int	j
	)

Returns the element at (i, j).

Parameters

i	The zero-based row index.
j	The zero-based column index.

Returns: The value of the element.

Exceptions

Base.IndexError if either index is out of range.

◆ getitem()

float CDPL.Math.DMatrix.__getitem__ ( tuple ij )

Returns the element at (i, j).

Parameters

i	The zero-based row index.
j	The zero-based column index.

Returns: The value of the element.

Exceptions

Base.IndexError if either index is out of range.

◆ len()

int CDPL.Math.DMatrix.__len__ ( )

Returns the number of rows.

Returns: The number of rows.

◆ eq() [1/2]

bool CDPL.Math.DMatrix.__eq__ ( DMatrix m )

Returns the result of the comparison operation self == m.

Parameters

m	The `DMatrix` instance to be compared with.

Returns: The result of the comparison operation.

◆ eq() [2/2]

bool CDPL.Math.DMatrix.__eq__ ( ConstDMatrixExpression e )

Returns the result of the comparison operation self == e.

Parameters

e	The `ConstDMatrixExpression` instance to be compared with.

Returns: The result of the comparison operation.

◆ ne() [1/2]

bool CDPL.Math.DMatrix.__ne__ ( DMatrix m )

Returns the result of the comparison operation self != m.

Parameters

m	The `DMatrix` instance to be compared with.

Returns: The result of the comparison operation.

◆ ne() [2/2]

bool CDPL.Math.DMatrix.__ne__ ( ConstDMatrixExpression e )

Returns the result of the comparison operation self != e.

Parameters

e	The `ConstDMatrixExpression` instance to be compared with.

Returns: The result of the comparison operation.

◆ str()

str CDPL.Math.DMatrix.__str__ ( )

Returns a string representation of the DMatrix instance.

Returns: The generated string representation.

◆ pos()

DMatrix CDPL.Math.DMatrix.__pos__ ( )

Returns self.

Returns: self.

◆ neg()

ConstDMatrixExpression CDPL.Math.DMatrix.__neg__ ( )

Returns the result of the operation self * -1.

Returns: A ConstDMatrixExpression instance holding the result of the element negation.

◆ add()

ConstDMatrixExpression CDPL.Math.DMatrix.__add__ ( ConstDMatrixExpression e )

Returns the result of the addition operation self + e.

Parameters

e	Specifies the second addend.

Returns: A ConstDMatrixExpression instance holding the result of the addition.

◆ sub()

ConstDMatrixExpression CDPL.Math.DMatrix.__sub__ ( ConstDMatrixExpression e )

Returns the result of the subtraction operation self - e.

Parameters

e	Specifies the subtrahend.

Returns: A DMatrix instance holding the result of the subtraction.

◆ mul() [1/3]

ConstDMatrixExpression CDPL.Math.DMatrix.__mul__ ( float t )

Returns the result of the multiplication operation self * t.

Parameters

t	Specifies the multiplier.

Returns: A ConstDMatrixExpression instance holding the result of the multiplication.

◆ mul() [2/3]

ConstDMatrixExpression CDPL.Math.DMatrix.__mul__ ( ConstDMatrixExpression e )

Returns the result of the multiplication operation self * e.

Parameters

e	Specifies the multiplier.

Returns: A ConstDMatrixExpression instance holding the result of the multiplication.

◆ mul() [3/3]

ConstDVectorExpression CDPL.Math.DMatrix.__mul__ ( ConstDVectorExpression e )

Returns the result of the multiplication operation self * e.

Parameters

e	Specifies the multiplier.

Returns: A ConstDVectorExpression instance holding the result of the multiplication.

◆ div()

ConstDMatrixExpression CDPL.Math.DMatrix.__div__ ( float t )

Returns the result of the division operation self // t.

Parameters

t	Specifies the divisor.

Returns: A ConstDMatrixExpression instance holding the result of the division.

◆ truediv()

ConstDMatrixExpression CDPL.Math.DMatrix.__truediv__ ( float t )

Returns the result of the true division operation self / t.

Parameters

t	Specifies the divisor.

Returns: A ConstDMatrixExpression instance holding the result of the division.

◆ rmul()

ConstDMatrixExpression CDPL.Math.DMatrix.__rmul__ ( float t )

Returns the result of the multiplication operation t * self.

Parameters

t	Specifies the multiplicand.

Returns: A ConstDMatrixExpression instance holding the result of the multiplication.

◆ setitem()

None CDPL.Math.DMatrix.__setitem__	(	tuple	ij,
		float	v
	)

Sets the value of the element (i, j) to v.

Parameters

i	The zero-based row index.
j	The zero-based column index.
v	The new value of the element.

Exceptions

Base.IndexError if any of the indices is out of range.

◆ iadd() [1/2]

DMatrix CDPL.Math.DMatrix.__iadd__ ( DMatrix m )

Adds the contents of the matrix m element-wise to this matrix (no alias check needed).

Parameters

m	The source matrix.

Returns: self.

◆ iadd() [2/2]

DMatrix CDPL.Math.DMatrix.__iadd__ ( ConstDMatrixExpression e )

Adds the matrix expression e element-wise to this matrix (via a temporary to handle aliasing).

Parameters

e	The source matrix expression.

Returns: self.

◆ isub() [1/2]

DMatrix CDPL.Math.DMatrix.__isub__ ( DMatrix m )

Subtracts the contents of the matrix m element-wise from this matrix (no alias check needed).

Parameters

m	The source matrix.

Returns: self.

◆ isub() [2/2]

DMatrix CDPL.Math.DMatrix.__isub__ ( ConstDMatrixExpression e )

Subtracts the matrix expression e element-wise from this matrix (via a temporary to handle aliasing).

Parameters

e	The source matrix expression.

Returns: self.

◆ imul()

DMatrix CDPL.Math.DMatrix.__imul__ ( float t )

Multiplies every element by the scalar t.

Parameters

t	The scalar multiplier.

Returns: self.

◆ idiv()

DMatrix CDPL.Math.DMatrix.__idiv__ ( float t )

Divides every element by the scalar t.

Parameters

t	The scalar divisor.

Returns: self.

◆ itruediv()

DMatrix CDPL.Math.DMatrix.__itruediv__ ( float t )

Divides every element by the scalar t.

Parameters

t	The scalar divisor.

Returns: self.

Public Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ __init__() [1/8]

◆ __init__() [2/8]

◆ __init__() [3/8]

◆ __init__() [4/8]

◆ __init__() [5/8]

◆ __init__() [6/8]

◆ __init__() [7/8]

◆ __init__() [8/8]

Member Function Documentation

◆ resize()

◆ clear()

◆ getObjectID()

◆ assign() [1/6]

◆ assign() [2/6]

◆ assign() [3/6]

◆ assign() [4/6]

◆ assign() [5/6]

◆ assign() [6/6]

◆ getSize1()

◆ getSize2()

◆ isEmpty()

◆ getElement()

◆ toArray()

◆ swap()

◆ setElement()

◆ __call__()

◆ __getitem__()

◆ __len__()

◆ __eq__() [1/2]

◆ __eq__() [2/2]

◆ __ne__() [1/2]

◆ __ne__() [2/2]

◆ __str__()

◆ __pos__()

◆ __neg__()

◆ __add__()

◆ __sub__()

◆ __mul__() [1/3]

◆ __mul__() [2/3]

◆ __mul__() [3/3]

◆ __div__()

◆ __truediv__()

◆ __rmul__()

◆ __setitem__()

◆ __iadd__() [1/2]

◆ __iadd__() [2/2]

◆ __isub__() [1/2]

◆ __isub__() [2/2]

◆ __imul__()

◆ __idiv__()

◆ __itruediv__()

◆ init() [1/8]

◆ init() [2/8]

◆ init() [3/8]

◆ init() [4/8]

◆ init() [5/8]

◆ init() [6/8]

◆ init() [7/8]

◆ init() [8/8]

◆ call()

◆ getitem()

◆ len()

◆ eq() [1/2]

◆ eq() [2/2]

◆ ne() [1/2]

◆ ne() [2/2]

◆ str()

◆ pos()

◆ neg()

◆ add()

◆ sub()

◆ mul() [1/3]

◆ mul() [2/3]

◆ mul() [3/3]

◆ div()

◆ truediv()

◆ rmul()

◆ setitem()

◆ iadd() [1/2]

◆ iadd() [2/2]

◆ isub() [1/2]

◆ isub() [2/2]

◆ imul()

◆ idiv()

◆ itruediv()