Chemical Data Processing Library Python API - Version 1.4.0
Public Member Functions | Properties | List of all members
CDPL.Math.LUnitVector Class Reference

Memory-efficient immutable unit vector with element values of type long. More...

+ Inheritance diagram for CDPL.Math.LUnitVector:

Public Member Functions

None __init__ ()
 Constructs an empty unit vector (size zero, index zero).
 
None __init__ (LUnitVector v)
 Constructs a copy of the unit vector v. More...
 
None __init__ (int n, int i)
 Constructs a unit vector of size n with the 1 element at index i. More...
 
None resize (int n)
 Resizes the logical element count to n. More...
 
int getIndex ()
 
int getObjectID ()
 Returns the numeric identifier (ID) of the wrapped C++ class instance. More...
 
bool isEmpty ()
 Tells whether the vector has zero logical size. More...
 
int getSize ()
 Returns the logical element count. More...
 
int getElement (int i)
 Returns the element at index i. More...
 
object toArray ()
 Converts the LUnitVector instance into a corresponding numpy.ndarray object. More...
 
LUnitVector assign (LUnitVector v)
 Copy-assigns the size and unit index from v. More...
 
None swap (LUnitVector v)
 Swaps the size and unit index with v. More...
 
bool __eq__ (LUnitVector v)
 Returns the result of the comparison operation self == v. More...
 
bool __eq__ (ConstLVectorExpression e)
 Returns the result of the comparison operation self == e. More...
 
bool __ne__ (LUnitVector v)
 Returns the result of the comparison operation self != v. More...
 
bool __ne__ (ConstLVectorExpression e)
 Returns the result of the comparison operation self != e. More...
 
int __call__ (int i)
 Returns the element at index i. More...
 
int __getitem__ (int i)
 Returns the element at index i. More...
 
int __len__ ()
 Returns the logical element count. More...
 
str __str__ ()
 Returns a string representation of the LUnitVector instance. More...
 
LUnitVector __pos__ ()
 Returns self. More...
 
ConstLVectorExpression __neg__ ()
 Returns the result of the operation self * -1. More...
 
ConstLVectorExpression __add__ (ConstLVectorExpression e)
 Returns the result of the addition operation self + e. More...
 
ConstLVectorExpression __sub__ (ConstLVectorExpression e)
 Returns the result of the subtraction operation self - e. More...
 
ConstLVectorExpression __mul__ (int t)
 Returns the result of the multiplication operation self * t. More...
 
ConstLVectorExpression __mul__ (ConstLMatrixExpression e)
 Returns the result of the multiplication operation self * e. More...
 
ConstLVectorExpression __div__ (int t)
 Returns the result of the division operation self // t. More...
 
ConstLVectorExpression __truediv__ (int t)
 Returns the result of the true division operation self / t. More...
 
ConstLVectorExpression __rmul__ (int t)
 Returns the result of the multiplication operation t * self. More...
 

Properties

 index = property(getIndex)
 
 objectID = property(getObjectID)
 
 size = property(getSize)
 

Detailed Description

Memory-efficient immutable unit vector with element values of type long.

Constructor & Destructor Documentation

◆ __init__() [1/2]

None CDPL.Math.LUnitVector.__init__ ( LUnitVector  v)

Constructs a copy of the unit vector v.

Parameters
vThe unit vector to copy.

◆ __init__() [2/2]

None CDPL.Math.LUnitVector.__init__ ( int  n,
int  i 
)

Constructs a unit vector of size n with the 1 element at index i.

Parameters
nThe element count.
iThe zero-based index of the non-zero element.

Member Function Documentation

◆ resize()

None CDPL.Math.LUnitVector.resize ( int  n)

Resizes the logical element count to n.

Parameters
nThe new element count.

◆ getObjectID()

int CDPL.Math.LUnitVector.getObjectID ( )

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

Different Python LUnitVector 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 LUnitVector 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.

◆ isEmpty()

bool CDPL.Math.LUnitVector.isEmpty ( )

Tells whether the vector has zero logical size.

Returns
True if the logical size is zero, and False otherwise.

◆ getSize()

int CDPL.Math.LUnitVector.getSize ( )

Returns the logical element count.

Returns
The element count.

◆ getElement()

int CDPL.Math.LUnitVector.getElement ( int  i)

Returns the element at index i.

Parameters
iThe zero-based element index.
Returns
A reference to either 1 (if i equals the unit index) or 0.
Exceptions
Base.IndexErrorif i is out of range.

◆ toArray()

object CDPL.Math.LUnitVector.toArray ( )

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

Returns
The generated numpy.ndarray object.
See also
[NUMPY]

◆ assign()

LUnitVector CDPL.Math.LUnitVector.assign ( LUnitVector  v)

Copy-assigns the size and unit index from v.

Parameters
vThe source unit vector.
Returns
self.

◆ swap()

None CDPL.Math.LUnitVector.swap ( LUnitVector  v)

Swaps the size and unit index with v.

Parameters
vThe unit vector to swap with.

◆ __eq__() [1/2]

bool CDPL.Math.LUnitVector.__eq__ ( LUnitVector  v)

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

Parameters
vThe LUnitVector instance to be compared with.
Returns
The result of the comparison operation.

◆ __eq__() [2/2]

bool CDPL.Math.LUnitVector.__eq__ ( ConstLVectorExpression  e)

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

Parameters
eThe ConstLVectorExpression instance to be compared with.
Returns
The result of the comparison operation.

◆ __ne__() [1/2]

bool CDPL.Math.LUnitVector.__ne__ ( LUnitVector  v)

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

Parameters
vThe LUnitVector instance to be compared with.
Returns
The result of the comparison operation.

◆ __ne__() [2/2]

bool CDPL.Math.LUnitVector.__ne__ ( ConstLVectorExpression  e)

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

Parameters
eThe ConstLVectorExpression instance to be compared with.
Returns
The result of the comparison operation.

◆ __call__()

int CDPL.Math.LUnitVector.__call__ ( int  i)

Returns the element at index i.

Parameters
iThe zero-based element index.
Returns
A reference to either 1 (if i equals the unit index) or 0.
Exceptions
Base.IndexErrorif i is out of range.

◆ __getitem__()

int CDPL.Math.LUnitVector.__getitem__ ( int  i)

Returns the element at index i.

Parameters
iThe zero-based element index.
Returns
A reference to either 1 (if i equals the unit index) or 0.
Exceptions
Base.IndexErrorif i is out of range.

◆ __len__()

int CDPL.Math.LUnitVector.__len__ ( )

Returns the logical element count.

Returns
The element count.

◆ __str__()

str CDPL.Math.LUnitVector.__str__ ( )

Returns a string representation of the LUnitVector instance.

Returns
The generated string representation.

◆ __pos__()

LUnitVector CDPL.Math.LUnitVector.__pos__ ( )

Returns self.

Returns
self.

◆ __neg__()

ConstLVectorExpression CDPL.Math.LUnitVector.__neg__ ( )

Returns the result of the operation self * -1.

Returns
A ConstLVectorExpression instance holding the result of the element negation.

◆ __add__()

ConstLVectorExpression CDPL.Math.LUnitVector.__add__ ( ConstLVectorExpression  e)

Returns the result of the addition operation self + e.

Parameters
eSpecifies the second addend.
Returns
A ConstLVectorExpression instance holding the result of the addition.

◆ __sub__()

ConstLVectorExpression CDPL.Math.LUnitVector.__sub__ ( ConstLVectorExpression  e)

Returns the result of the subtraction operation self - e.

Parameters
eSpecifies the subtrahend.
Returns
A LUnitVector instance holding the result of the subtraction.

◆ __mul__() [1/2]

ConstLVectorExpression CDPL.Math.LUnitVector.__mul__ ( int  t)

Returns the result of the multiplication operation self * t.

Parameters
tSpecifies the multiplier.
Returns
A ConstLVectorExpression instance holding the result of the multiplication.

◆ __mul__() [2/2]

ConstLVectorExpression CDPL.Math.LUnitVector.__mul__ ( ConstLMatrixExpression  e)

Returns the result of the multiplication operation self * e.

Parameters
eSpecifies the multiplier.
Returns
A ConstLVectorExpression instance holding the result of the multiplication.

◆ __div__()

ConstLVectorExpression CDPL.Math.LUnitVector.__div__ ( int  t)

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

Parameters
tSpecifies the divisor.
Returns
A ConstLVectorExpression instance holding the result of the division.

◆ __truediv__()

ConstLVectorExpression CDPL.Math.LUnitVector.__truediv__ ( int  t)

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

Parameters
tSpecifies the divisor.
Returns
A ConstLVectorExpression instance holding the result of the division.

◆ __rmul__()

ConstLVectorExpression CDPL.Math.LUnitVector.__rmul__ ( int  t)

Returns the result of the multiplication operation t * self.

Parameters
tSpecifies the multiplicand.
Returns
A ConstLVectorExpression instance holding the result of the multiplication.