OrthogonalDirection

class OrthogonalDirection(*args)

Sampling following the orthogonal direction strategy.

Available constructor:

OrthogonalDirection()

OrthogonalDirection(dimension, k)

Parameters:
dimensioninteger

The dimension of the standard space. By default, dimension = 0 but automatically updated by the calling class.

kint

The number of elements in the linear combinations. By default, k = 1 but automatically updated by the calling class.

See also

RandomDirection

Notes

This strategy is parameterized by k \in \{1, \ldots, n\}, where n is the dimension of the input random vector \vect{X}. We generate one direct orthonormalized basis (\vect{e}_1, \ldots, \vect{e}_n) uniformly distributed in the set of direct orthonormal bases. We consider all the normalized linear combinations of k vectors chosen within the n vectors of the basis, where the coefficients of the linear combinations are in \{+1, -1\}. This generates \binom{k}{n} 2^k new vectors \vect{v}_i. We sample according to all the directions defined by the vectors \vect{v}_i.

If k = 1, we consider all the axes of the standard space.

Methods

generate()

Generate the sample.

getClassName()

Accessor to the object's name.

getDimension()

Accessor to the dimension.

getId()

Accessor to the object's id.

getName()

Accessor to the object's name.

getShadowedId()

Accessor to the object's shadowed id.

getUniformUnitVectorRealization(*args)

Accessor to a realization according to the uniform distribution.

getVisibility()

Accessor to the object's visibility state.

hasName()

Test if the object is named.

hasVisibleName()

Test if the object has a distinguishable name.

setDimension(dimension)

Accessor to the dimension.

setName(name)

Accessor to the object's name.

setShadowedId(id)

Accessor to the object's shadowed id.

setVisibility(visible)

Accessor to the object's visibility state.

getUniformOrientationRealization

__init__(*args)
generate()

Generate the sample.

Returns:
sampleSample

The sample generated according to the orthogonal direction strategy.

getClassName()

Accessor to the object’s name.

Returns:
class_namestr

The object class name (object.__class__.__name__).

getDimension()

Accessor to the dimension.

Returns:
dimensionint

Dimension of the standard space.

getId()

Accessor to the object’s id.

Returns:
idint

Internal unique identifier.

getName()

Accessor to the object’s name.

Returns:
namestr

The name of the object.

getShadowedId()

Accessor to the object’s shadowed id.

Returns:
idint

Internal unique identifier.

getUniformUnitVectorRealization(*args)

Accessor to a realization according to the uniform distribution.

Parameters:
dimensionint

The dimension of the sphere unity (which is the dimension of the standard space).

Returns:
samplePoint

The realization of a vector on the sphere unity, according to the uniform distribution.

getVisibility()

Accessor to the object’s visibility state.

Returns:
visiblebool

Visibility flag.

hasName()

Test if the object is named.

Returns:
hasNamebool

True if the name is not empty.

hasVisibleName()

Test if the object has a distinguishable name.

Returns:
hasVisibleNamebool

True if the name is not empty and not the default one.

setDimension(dimension)

Accessor to the dimension.

Parameters:
dimensionint

Dimension of the standard space.

setName(name)

Accessor to the object’s name.

Parameters:
namestr

The name of the object.

setShadowedId(id)

Accessor to the object’s shadowed id.

Parameters:
idint

Internal unique identifier.

setVisibility(visible)

Accessor to the object’s visibility state.

Parameters:
visiblebool

Visibility flag.

Examples using the class

Use the Directional Sampling Algorithm

Use the Directional Sampling Algorithm