CDPL.Math.FZeroGrid Class Reference

Immutable grid where all elements have the value zero of type float. More...

Inheritance diagram for CDPL.Math.FZeroGrid:

Public Member Functions
None	__init__ ()
	Constructs an empty zero grid (zero size on every axis).
None	__init__ (FZeroGrid g)
	Contructs a copy of the FZeroGrid instance g. More...
None	__init__ (int m, int n, int o)
	Constructs a zero grid of size m×n×o. More...
None	resize (int m, int n, int o)
	Resizes the grid axes to (m, n, o). More...
int	getObjectID ()
	Returns the numeric identifier (ID) of the wrapped C++ class instance. More...
int	getSize1 ()
	Returns the first-axis size. More...
int	getSize2 ()
	Returns the second-axis size. More...
int	getSize3 ()
	Returns the third-axis size. More...
bool	isEmpty ()
	Tells whether the grid is empty (any axis has zero size). More...
float	getElement (int i, int j, int k)
	Returns the zero element. More...
float	getElement (int i)
	Returns the zero element. More...
object	toArray ()
	Converts the FZeroGrid instance into a corresponding numpy.ndarray object. More...
int	getSize ()
	Returns the total element count \( \mathrm{size}_1 \cdot \mathrm{size}_2 \cdot \mathrm{size}_3 \). More...
FZeroGrid	assign (FZeroGrid g)
	Copy-assigns the axis sizes from g. More...
None	swap (FZeroGrid g)
	Swaps the axis sizes with g. More...
float	__call__ (int i, int j, int k)
	Returns the zero element. More...
float	__call__ (int i)
	Returns the zero element. More...
float	__getitem__ (tuple ijk)
	Returns the zero element. More...
float	__getitem__ (int i)
	Returns the zero element. More...
int	__len__ ()
	Returns the total element count \( \mathrm{size}_1 \cdot \mathrm{size}_2 \cdot \mathrm{size}_3 \). More...
bool	__eq__ (FZeroGrid g)
	Returns the result of the comparison operation self == g. More...
bool	__eq__ (ConstFGridExpression e)
	Returns the result of the comparison operation self == e. More...
bool	__ne__ (FZeroGrid g)
	Returns the result of the comparison operation self != g. More...
bool	__ne__ (ConstFGridExpression e)
	Returns the result of the comparison operation self != e. More...
str	__str__ ()
	Returns a string representation of the FZeroGrid instance. More...
FZeroGrid	__pos__ ()
	Returns self. More...
ConstFGridExpression	__neg__ ()
	Returns the result of the operation self * -1. More...
ConstFGridExpression	__add__ (ConstFGridExpression e)
	Returns the result of the addition operation self + e. More...
ConstFGridExpression	__sub__ (ConstFGridExpression e)
	Returns the result of the subtraction operation self - e. More...
ConstFGridExpression	__mul__ (float t)
	Returns the result of the multiplication operation self * t. More...
ConstFGridExpression	__div__ (float t)
	Returns the result of the division operation self // t. More...
ConstFGridExpression	__truediv__ (float t)
	Returns the result of the true division operation self / t. More...
ConstFGridExpression	__rmul__ (float t)
	Returns the result of the multiplication operation t * self. More...

Properties
	objectID = property(getObjectID)
	size1 = property(getSize1)
	size2 = property(getSize2)
	size3 = property(getSize3)

Detailed Description

Immutable grid where all elements have the value zero of type float.

Constructor & Destructor Documentation

__init__() [1/2]

None CDPL.Math.FZeroGrid.__init__

(

FZeroGrid

g

)

Contructs a copy of the FZeroGrid instance g.

Parameters

g	The FZeroGrid instance to copy.

__init__() [2/2]

None CDPL.Math.FZeroGrid.__init__	(	int	m,
		int	n,
		int	o
	)

Constructs a zero grid of size m×n×o.

Parameters

m	The first-axis size.
n	The second-axis size.
o	The third-axis size.

Member Function Documentation

resize()

None CDPL.Math.FZeroGrid.resize	(	int	m,
		int	n,
		int	o
	)

Resizes the grid axes to (m, n, o).

Parameters

m	The new first-axis size.
n	The new second-axis size.
o	The new third-axis size.

getObjectID()

int CDPL.Math.FZeroGrid.getObjectID

(

)

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

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

getSize1()

int CDPL.Math.FZeroGrid.getSize1

(

)

Returns the first-axis size.

Returns

The size along the first axis.

getSize2()

int CDPL.Math.FZeroGrid.getSize2

(

)

Returns the second-axis size.

Returns

The size along the second axis.

getSize3()

int CDPL.Math.FZeroGrid.getSize3

(

)

Returns the third-axis size.

Returns

The size along the third axis.

isEmpty()

bool CDPL.Math.FZeroGrid.isEmpty

(

)

Tells whether the grid is empty (any axis has zero size).

Returns

True if any axis is zero, and False otherwise.

getElement() [1/2]

float CDPL.Math.FZeroGrid.getElement	(	int	i,
		int	j,
		int	k
	)

Returns the zero element.

Parameters

i	The zero-based first-axis index.
j	The zero-based second-axis index.
k	The zero-based third-axis index.

Returns

The zero element.

Exceptions

Base.IndexError

if any of the indices is out of range.

getElement() [2/2]

float CDPL.Math.FZeroGrid.getElement

(

int

i

)

Returns the zero element.

Parameters

i	The zero-based linear index.

Returns

The zero element.

Exceptions

Base.IndexError

if i is out of range.

toArray()

object CDPL.Math.FZeroGrid.toArray

(

)

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

Returns

The generated numpy.ndarray object.

See also

[NUMPY]

getSize()

int CDPL.Math.FZeroGrid.getSize

(

)

Returns the total element count \( \mathrm{size}_1 \cdot \mathrm{size}_2 \cdot \mathrm{size}_3 \).

Returns

The total number of elements.

assign()

FZeroGrid CDPL.Math.FZeroGrid.assign

(

FZeroGrid

g

)

Copy-assigns the axis sizes from g.

Parameters

g	The source zero grid.

Returns

self.

swap()

None CDPL.Math.FZeroGrid.swap

(

FZeroGrid

g

)

Swaps the axis sizes with g.

Parameters

g	The zero grid to swap with.

__call__() [1/2]

float CDPL.Math.FZeroGrid.__call__	(	int	i,
		int	j,
		int	k
	)

Returns the zero element.

Parameters

i	The zero-based first-axis index.
j	The zero-based second-axis index.
k	The zero-based third-axis index.

Returns

The zero element.

Exceptions

Base.IndexError

if any of the indices is out of range.

__call__() [2/2]

float CDPL.Math.FZeroGrid.__call__

(

int

i

)

Returns the zero element.

Parameters

i	The zero-based linear index.

Returns

The zero element.

Exceptions

Base.IndexError

if i is out of range.

__getitem__() [1/2]

float CDPL.Math.FZeroGrid.__getitem__

(

tuple

ijk

)

Returns the zero element.

Parameters

i	The zero-based first-axis index.
j	The zero-based second-axis index.
k	The zero-based third-axis index.

Returns

The zero element.

Exceptions

Base.IndexError

if any of the indices is out of range.

__getitem__() [2/2]

float CDPL.Math.FZeroGrid.__getitem__

(

int

i

)

Returns the zero element.

Parameters

i	The zero-based linear index.

Returns

The zero element.

Exceptions

Base.IndexError

if i is out of range.

__len__()

int CDPL.Math.FZeroGrid.__len__

(

)

Returns the total element count \( \mathrm{size}_1 \cdot \mathrm{size}_2 \cdot \mathrm{size}_3 \).

Returns

The total number of elements.

__eq__() [1/2]

bool CDPL.Math.FZeroGrid.__eq__

(

FZeroGrid

g

)

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

Parameters

g	The FZeroGrid instance to be compared with.

Returns

The result of the comparison operation.

__eq__() [2/2]

bool CDPL.Math.FZeroGrid.__eq__

(

ConstFGridExpression

e

)

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

Parameters

e	The ConstFGridExpression instance to be compared with.

Returns

The result of the comparison operation.

__ne__() [1/2]

bool CDPL.Math.FZeroGrid.__ne__

(

FZeroGrid

g

)

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

Parameters

g	The FZeroGrid instance to be compared with.

Returns

The result of the comparison operation.

__ne__() [2/2]

bool CDPL.Math.FZeroGrid.__ne__

(

ConstFGridExpression

e

)

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

Parameters

e	The ConstFGridExpression instance to be compared with.

Returns

The result of the comparison operation.

__str__()

str CDPL.Math.FZeroGrid.__str__

(

)

Returns a string representation of the FZeroGrid instance.

Returns

The generated string representation.

__pos__()

FZeroGrid CDPL.Math.FZeroGrid.__pos__

(

)

Returns self.

Returns

self.

__neg__()

ConstFGridExpression CDPL.Math.FZeroGrid.__neg__

(

)

Returns the result of the operation self * -1.

Returns

A ConstFGridExpression instance holding the result of the element negation.

__add__()

ConstFGridExpression CDPL.Math.FZeroGrid.__add__

(

ConstFGridExpression

e

)

Returns the result of the addition operation self + e.

Parameters

e	Specifies the second addend.

Returns

A ConstFGridExpression instance holding the result of the addition.

__sub__()

ConstFGridExpression CDPL.Math.FZeroGrid.__sub__

(

ConstFGridExpression

e

)

Returns the result of the subtraction operation self - e.

Parameters

e	Specifies the subtrahend.

Returns

A FZeroGrid instance holding the result of the subtraction.

__mul__()

ConstFGridExpression CDPL.Math.FZeroGrid.__mul__

(

float

t

)

Returns the result of the multiplication operation self * t.

Parameters

t	Specifies the multiplier.

Returns

A ConstFGridExpression instance holding the result of the multiplication.

__div__()

ConstFGridExpression CDPL.Math.FZeroGrid.__div__

(

float

t

)

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

Parameters

t	Specifies the divisor.

Returns

A ConstFGridExpression instance holding the result of the division.

__truediv__()

ConstFGridExpression CDPL.Math.FZeroGrid.__truediv__

(

float

t

)

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

Parameters

t	Specifies the divisor.

Returns

A ConstFGridExpression instance holding the result of the division.

__rmul__()

ConstFGridExpression CDPL.Math.FZeroGrid.__rmul__

(

float

t

)

Returns the result of the multiplication operation t * self.

Parameters

t	Specifies the multiplicand.

Returns

A ConstFGridExpression instance holding the result of the multiplication.