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

General 4-component quaternion with component values of type unsigned long. More...

+ Inheritance diagram for CDPL.Math.ULQuaternion:

Public Member Functions

None __init__ ()
 Constructs an uninitialized quaternion.
 
None __init__ (ULQuaternion q)
 Constructs a copy of the quaternion q. More...
 
None __init__ (int c1, int c2=0, int c3=0, int c4=0)
 Constructs the quaternion with the supplied component values. More...
 
None __init__ (ConstFQuaternionExpression e)
 Constructs the quaternion from the quaternion expression e. More...
 
None __init__ (ConstDQuaternionExpression e)
 Constructs the quaternion from the quaternion expression e. More...
 
None __init__ (ConstLQuaternionExpression e)
 Constructs the quaternion from the quaternion expression e. More...
 
None __init__ (ConstULQuaternionExpression e)
 Constructs the quaternion from the quaternion expression e. More...
 
None __init__ (object a)
 Constructs the quaternion from the numpy.ndarray object a. More...
 
int getObjectID ()
 Returns the numeric identifier (ID) of the wrapped C++ class instance. More...
 
ULQuaternion assign (ConstFQuaternionExpression e)
 Assigns the quaternion expression e to this quaternion (via a temporary to handle aliasing). More...
 
ULQuaternion assign (ConstDQuaternionExpression e)
 Assigns the quaternion expression e to this quaternion (via a temporary to handle aliasing). More...
 
ULQuaternion assign (ConstLQuaternionExpression e)
 Assigns the quaternion expression e to this quaternion (via a temporary to handle aliasing). More...
 
ULQuaternion assign (ConstULQuaternionExpression e)
 Assigns the quaternion expression e to this quaternion (via a temporary to handle aliasing). More...
 
ULQuaternion assign (ULQuaternion q)
 Copy-assigns the components of q to this quaternion. More...
 
None assign (object a)
 Assigns the contents of the numpy.ndarray object a to this quaternion. More...
 
int getC1 ()
 Returns the real component C1. More...
 
int getC2 ()
 Returns the imaginary component C2. More...
 
int getC3 ()
 Returns the imaginary component C3. More...
 
int getC4 ()
 Returns the imaginary component C4. More...
 
object toArray ()
 Converts the ULQuaternion instance into a corresponding numpy.ndarray object. More...
 
None swap (ULQuaternion q)
 Swaps the four components of this quaternion with those of q. More...
 
None setC1 (int v)
 Sets the value of the real component C1 to v. More...
 
None setC2 (int v)
 Sets the value of the imaginary component C2 to v. More...
 
None setC3 (int v)
 Sets the value of the imaginary component C3 to v. More...
 
None setC4 (int v)
 Sets the value of the imaginary component C4 to v. More...
 
None set (int c1=0, int c2=0, int c3=0, int c4=0)
 Sets the four quaternion components to the supplied values. More...
 
bool __eq__ (ULQuaternion q)
 Returns the result of the comparison operation self == q. More...
 
bool __eq__ (ConstULQuaternionExpression q)
 Returns the result of the comparison operation self == q. More...
 
bool __ne__ (ULQuaternion q)
 Returns the result of the comparison operation self != q. More...
 
bool __ne__ (ConstULQuaternionExpression q)
 Returns the result of the comparison operation self != q. More...
 
str __str__ ()
 Returns a string representation of the ULQuaternion instance. More...
 
ULQuaternion __pos__ ()
 Returns self. More...
 
ConstULQuaternionExpression __neg__ ()
 Returns the result of the operation self * -1. More...
 
ConstULQuaternionExpression __add__ (int t)
 Returns the result of the addition operation self + t. More...
 
ConstULQuaternionExpression __add__ (ConstULQuaternionExpression e)
 Returns the result of the addition operation self + e. More...
 
ConstULQuaternionExpression __radd__ (int t)
 Returns the result of the addition operation t + self. More...
 
ConstULQuaternionExpression __sub__ (int t)
 Returns the result of the subtraction operation self - t. More...
 
ConstULQuaternionExpression __sub__ (ConstULQuaternionExpression e)
 Returns the result of the subtraction operation self - e. More...
 
ConstULQuaternionExpression __rsub__ (int t)
 Returns the result of the subtraction operation t - self. More...
 
ConstULQuaternionExpression __mul__ (int t)
 Returns the result of the multiplication operation self * t. More...
 
ConstULQuaternionExpression __mul__ (ConstULQuaternionExpression e)
 Returns the result of the multiplication operation self * e. More...
 
ConstULQuaternionExpression __rmul__ (int t)
 Returns the result of the multiplication operation t * self. More...
 
ConstULQuaternionExpression __div__ (int t)
 Returns the result of the division operation self // t. More...
 
ConstULQuaternionExpression __div__ (ConstULQuaternionExpression e)
 Returns the result of the division operation self // e. More...
 
ConstULQuaternionExpression __truediv__ (int t)
 Returns the result of the true division operation self / t. More...
 
ConstULQuaternionExpression __rdiv__ (int t)
 Returns the result of the division operation t // self. More...
 
ULQuaternion __iadd__ (int t)
 Adds the scalar t to the real component. More...
 
ULQuaternion __iadd__ (ULQuaternion q)
 Adds the quaternion q to this quaternion (via a temporary to handle aliasing). More...
 
ULQuaternion __iadd__ (ConstULQuaternionExpression e)
 Adds the quaternion expression e to this quaternion (via a temporary to handle aliasing). More...
 
ULQuaternion __isub__ (int t)
 Subtracts the scalar t from the real component. More...
 
ULQuaternion __isub__ (ULQuaternion q)
 Subtracts the quaternion q from this quaternion (via a temporary to handle aliasing). More...
 
ULQuaternion __isub__ (ConstULQuaternionExpression e)
 Subtracts the quaternion expression e from this quaternion (via a temporary to handle aliasing). More...
 
ULQuaternion __imul__ (int t)
 Multiplies every component by the scalar t. More...
 
ULQuaternion __imul__ (ULQuaternion q)
 Right-multiplies this quaternion by the quaternion q (Hamilton product, via a temporary). More...
 
ULQuaternion __imul__ (ConstULQuaternionExpression e)
 Right-multiplies this quaternion by the quaternion expression e (Hamilton product, via a temporary). More...
 
ULQuaternion __idiv__ (int t)
 Divides every component by the scalar t. More...
 
ULQuaternion __idiv__ (ULQuaternion q)
 Right-divides this quaternion by the quaternion q (Hamilton-product inverse, via a temporary). More...
 
ULQuaternion __idiv__ (ConstULQuaternionExpression e)
 Right-divides this quaternion by the quaternion expression e (Hamilton-product inverse, via a temporary). More...
 
ULQuaternion __itruediv__ (int t)
 Divides every component by the scalar t. More...
 
ULQuaternion __itruediv__ (ULQuaternion q)
 Right-divides this quaternion by the quaternion q (Hamilton-product inverse, via a temporary). More...
 
ULQuaternion __itruediv__ (ConstULQuaternionExpression e)
 Right-divides this quaternion by the quaternion expression e (Hamilton-product inverse, via a temporary). More...
 

Properties

 objectID = property(getObjectID)
 

Detailed Description

General 4-component quaternion with component values of type unsigned long.

Constructor & Destructor Documentation

◆ __init__() [1/7]

None CDPL.Math.ULQuaternion.__init__ ( ULQuaternion  q)

Constructs a copy of the quaternion q.

Parameters
qThe quaternion to copy.

◆ __init__() [2/7]

None CDPL.Math.ULQuaternion.__init__ ( int  c1,
int   c2 = 0,
int   c3 = 0,
int   c4 = 0 
)

Constructs the quaternion with the supplied component values.

Parameters
c1The real component.
c2The first imaginary component.
c3The second imaginary component.
c4The third imaginary component.

◆ __init__() [3/7]

None CDPL.Math.ULQuaternion.__init__ ( ConstFQuaternionExpression  e)

Constructs the quaternion from the quaternion expression e.

Parameters
eThe quaternion expression to materialize.

◆ __init__() [4/7]

None CDPL.Math.ULQuaternion.__init__ ( ConstDQuaternionExpression  e)

Constructs the quaternion from the quaternion expression e.

Parameters
eThe quaternion expression to materialize.

◆ __init__() [5/7]

None CDPL.Math.ULQuaternion.__init__ ( ConstLQuaternionExpression  e)

Constructs the quaternion from the quaternion expression e.

Parameters
eThe quaternion expression to materialize.

◆ __init__() [6/7]

None CDPL.Math.ULQuaternion.__init__ ( ConstULQuaternionExpression  e)

Constructs the quaternion from the quaternion expression e.

Parameters
eThe quaternion expression to materialize.

◆ __init__() [7/7]

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

Constructs the quaternion from the numpy.ndarray object a.

Parameters
aThe numpy.ndarray object.
See also
[NUMPY]

Member Function Documentation

◆ getObjectID()

int CDPL.Math.ULQuaternion.getObjectID ( )

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

Different Python ULQuaternion 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 ULQuaternion 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]

ULQuaternion CDPL.Math.ULQuaternion.assign ( ConstFQuaternionExpression  e)

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

Parameters
eThe source quaternion expression.
Returns
self.

◆ assign() [2/6]

ULQuaternion CDPL.Math.ULQuaternion.assign ( ConstDQuaternionExpression  e)

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

Parameters
eThe source quaternion expression.
Returns
self.

◆ assign() [3/6]

ULQuaternion CDPL.Math.ULQuaternion.assign ( ConstLQuaternionExpression  e)

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

Parameters
eThe source quaternion expression.
Returns
self.

◆ assign() [4/6]

ULQuaternion CDPL.Math.ULQuaternion.assign ( ConstULQuaternionExpression  e)

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

Parameters
eThe source quaternion expression.
Returns
self.

◆ assign() [5/6]

ULQuaternion CDPL.Math.ULQuaternion.assign ( ULQuaternion  q)

Copy-assigns the components of q to this quaternion.

Parameters
qThe source quaternion.
Returns
self.

◆ assign() [6/6]

None CDPL.Math.ULQuaternion.assign ( object  a)

Assigns the contents of the numpy.ndarray object a to this quaternion.

Parameters
aThe numpy.ndarray object.
See also
[NUMPY]

◆ getC1()

int CDPL.Math.ULQuaternion.getC1 ( )

Returns the real component C1.

Returns
The value of C1.

◆ getC2()

int CDPL.Math.ULQuaternion.getC2 ( )

Returns the imaginary component C2.

Returns
The value of C2.

◆ getC3()

int CDPL.Math.ULQuaternion.getC3 ( )

Returns the imaginary component C3.

Returns
The value of C3.

◆ getC4()

int CDPL.Math.ULQuaternion.getC4 ( )

Returns the imaginary component C4.

Returns
The value of C4.

◆ toArray()

object CDPL.Math.ULQuaternion.toArray ( )

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

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

◆ swap()

None CDPL.Math.ULQuaternion.swap ( ULQuaternion  q)

Swaps the four components of this quaternion with those of q.

Parameters
qThe quaternion to swap with.

◆ setC1()

None CDPL.Math.ULQuaternion.setC1 ( int  v)

Sets the value of the real component C1 to v.

Parameters
vThe new value of the real component C1.

◆ setC2()

None CDPL.Math.ULQuaternion.setC2 ( int  v)

Sets the value of the imaginary component C2 to v.

Parameters
vThe new value of the imaginary component C2.

◆ setC3()

None CDPL.Math.ULQuaternion.setC3 ( int  v)

Sets the value of the imaginary component C3 to v.

Parameters
vThe new value of the imaginary component C3.

◆ setC4()

None CDPL.Math.ULQuaternion.setC4 ( int  v)

Sets the value of the imaginary component C4 to v.

Parameters
vThe new value of the imaginary component C4.

◆ set()

None CDPL.Math.ULQuaternion.set ( int   c1 = 0,
int   c2 = 0,
int   c3 = 0,
int   c4 = 0 
)

Sets the four quaternion components to the supplied values.

Parameters
c1The new real component.
c2The new first imaginary component.
c3The new second imaginary component.
c4The new third imaginary component.

◆ __eq__() [1/2]

bool CDPL.Math.ULQuaternion.__eq__ ( ULQuaternion  q)

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

Parameters
qThe ULQuaternion instance to be compared with.
Returns
The result of the comparison operation.

◆ __eq__() [2/2]

bool CDPL.Math.ULQuaternion.__eq__ ( ConstULQuaternionExpression  q)

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

Parameters
qThe ConstULQuaternionExpression instance to be compared with.
Returns
The result of the comparison operation.

◆ __ne__() [1/2]

bool CDPL.Math.ULQuaternion.__ne__ ( ULQuaternion  q)

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

Parameters
qThe ULQuaternion instance to be compared with.
Returns
The result of the comparison operation.

◆ __ne__() [2/2]

bool CDPL.Math.ULQuaternion.__ne__ ( ConstULQuaternionExpression  q)

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

Parameters
qThe ConstULQuaternionExpression instance to be compared with.
Returns
The result of the comparison operation.

◆ __str__()

str CDPL.Math.ULQuaternion.__str__ ( )

Returns a string representation of the ULQuaternion instance.

Returns
The generated string representation.

◆ __pos__()

ULQuaternion CDPL.Math.ULQuaternion.__pos__ ( )

Returns self.

Returns
self.

◆ __neg__()

ConstULQuaternionExpression CDPL.Math.ULQuaternion.__neg__ ( )

Returns the result of the operation self * -1.

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

◆ __add__() [1/2]

ConstULQuaternionExpression CDPL.Math.ULQuaternion.__add__ ( int  t)

Returns the result of the addition operation self + t.

Parameters
tSpecifies the second addend.
Returns
A ConstULQuaternionExpression instance holding the result of the addition.

◆ __add__() [2/2]

ConstULQuaternionExpression CDPL.Math.ULQuaternion.__add__ ( ConstULQuaternionExpression  e)

Returns the result of the addition operation self + e.

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

◆ __radd__()

ConstULQuaternionExpression CDPL.Math.ULQuaternion.__radd__ ( int  t)

Returns the result of the addition operation t + self.

Parameters
tSpecifies the first addend.
Returns
A ConstULQuaternionExpression instance holding the result of the addition.

◆ __sub__() [1/2]

ConstULQuaternionExpression CDPL.Math.ULQuaternion.__sub__ ( int  t)

Returns the result of the subtraction operation self - t.

Parameters
tSpecifies the subtrahend.
Returns
A ULQuaternion instance holding the result of the subtraction.

◆ __sub__() [2/2]

ConstULQuaternionExpression CDPL.Math.ULQuaternion.__sub__ ( ConstULQuaternionExpression  e)

Returns the result of the subtraction operation self - e.

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

◆ __rsub__()

ConstULQuaternionExpression CDPL.Math.ULQuaternion.__rsub__ ( int  t)

Returns the result of the subtraction operation t - self.

Parameters
tSpecifies the minuend.
Returns
A ULQuaternion instance holding the result of the subtraction.

◆ __mul__() [1/2]

ConstULQuaternionExpression CDPL.Math.ULQuaternion.__mul__ ( int  t)

Returns the result of the multiplication operation self * t.

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

◆ __mul__() [2/2]

ConstULQuaternionExpression CDPL.Math.ULQuaternion.__mul__ ( ConstULQuaternionExpression  e)

Returns the result of the multiplication operation self * e.

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

◆ __rmul__()

ConstULQuaternionExpression CDPL.Math.ULQuaternion.__rmul__ ( int  t)

Returns the result of the multiplication operation t * self.

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

◆ __div__() [1/2]

ConstULQuaternionExpression CDPL.Math.ULQuaternion.__div__ ( int  t)

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

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

◆ __div__() [2/2]

ConstULQuaternionExpression CDPL.Math.ULQuaternion.__div__ ( ConstULQuaternionExpression  e)

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

Parameters
eSpecifies the divisor.
Returns
A ConstULQuaternionExpression instance holding the result of the division.

◆ __truediv__()

ConstULQuaternionExpression CDPL.Math.ULQuaternion.__truediv__ ( int  t)

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

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

◆ __rdiv__()

ConstULQuaternionExpression CDPL.Math.ULQuaternion.__rdiv__ ( int  t)

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

Parameters
tSpecifies the dividend.
Returns
A ConstULQuaternionExpression instance holding the result of the division.

◆ __iadd__() [1/3]

ULQuaternion CDPL.Math.ULQuaternion.__iadd__ ( int  t)

Adds the scalar t to the real component.

Parameters
tThe scalar addend.
Returns
self.

◆ __iadd__() [2/3]

ULQuaternion CDPL.Math.ULQuaternion.__iadd__ ( ULQuaternion  q)

Adds the quaternion q to this quaternion (via a temporary to handle aliasing).

Parameters
qThe source quaternion.
Returns
self.

◆ __iadd__() [3/3]

ULQuaternion CDPL.Math.ULQuaternion.__iadd__ ( ConstULQuaternionExpression  e)

Adds the quaternion expression e to this quaternion (via a temporary to handle aliasing).

Parameters
eThe source quaternion expression.
Returns
self.

◆ __isub__() [1/3]

ULQuaternion CDPL.Math.ULQuaternion.__isub__ ( int  t)

Subtracts the scalar t from the real component.

Parameters
tThe scalar subtrahend.
Returns
self.

◆ __isub__() [2/3]

ULQuaternion CDPL.Math.ULQuaternion.__isub__ ( ULQuaternion  q)

Subtracts the quaternion q from this quaternion (via a temporary to handle aliasing).

Parameters
qThe source quaternion.
Returns
self.

◆ __isub__() [3/3]

ULQuaternion CDPL.Math.ULQuaternion.__isub__ ( ConstULQuaternionExpression  e)

Subtracts the quaternion expression e from this quaternion (via a temporary to handle aliasing).

Parameters
eThe source quaternion expression.
Returns
self.

◆ __imul__() [1/3]

ULQuaternion CDPL.Math.ULQuaternion.__imul__ ( int  t)

Multiplies every component by the scalar t.

Parameters
tThe scalar multiplier.
Returns
self.

◆ __imul__() [2/3]

ULQuaternion CDPL.Math.ULQuaternion.__imul__ ( ULQuaternion  q)

Right-multiplies this quaternion by the quaternion q (Hamilton product, via a temporary).

Parameters
qThe right-hand quaternion.
Returns
self.

◆ __imul__() [3/3]

ULQuaternion CDPL.Math.ULQuaternion.__imul__ ( ConstULQuaternionExpression  e)

Right-multiplies this quaternion by the quaternion expression e (Hamilton product, via a temporary).

Parameters
eThe right-hand quaternion expression.
Returns
self.

◆ __idiv__() [1/3]

ULQuaternion CDPL.Math.ULQuaternion.__idiv__ ( int  t)

Divides every component by the scalar t.

Parameters
tThe scalar divisor.
Returns
self.

◆ __idiv__() [2/3]

ULQuaternion CDPL.Math.ULQuaternion.__idiv__ ( ULQuaternion  q)

Right-divides this quaternion by the quaternion q (Hamilton-product inverse, via a temporary).

Parameters
qThe right-hand quaternion.
Returns
self.

◆ __idiv__() [3/3]

ULQuaternion CDPL.Math.ULQuaternion.__idiv__ ( ConstULQuaternionExpression  e)

Right-divides this quaternion by the quaternion expression e (Hamilton-product inverse, via a temporary).

Parameters
eThe right-hand quaternion expression.
Returns
self.

◆ __itruediv__() [1/3]

ULQuaternion CDPL.Math.ULQuaternion.__itruediv__ ( int  t)

Divides every component by the scalar t.

Parameters
tThe scalar divisor.
Returns
self.

◆ __itruediv__() [2/3]

ULQuaternion CDPL.Math.ULQuaternion.__itruediv__ ( ULQuaternion  q)

Right-divides this quaternion by the quaternion q (Hamilton-product inverse, via a temporary).

Parameters
qThe right-hand quaternion.
Returns
self.

◆ __itruediv__() [3/3]

ULQuaternion CDPL.Math.ULQuaternion.__itruediv__ ( ConstULQuaternionExpression  e)

Right-divides this quaternion by the quaternion expression e (Hamilton-product inverse, via a temporary).

Parameters
eThe right-hand quaternion expression.
Returns
self.