Description

class Description(*args)

Collection of strings.

Available constructors:

Description(size=0, value=’ ‘)

Description(sequence)

Parameters

sizeint,

Size of the collection.

valuestr

Value set to the size elements.

sequencesequence of str

Components of the vector.

Examples

>>> import openturns as ot

Use the first constructor:

>>> ot.Description()
[]
>>> ot.Description(2)
[,]
>>> ot.Description(2, 'C')
[C,C]

Use the second constructor:

>>> vector = ot.Description(['P1', 'P2', 'P3'])
>>> vector
[P1,P2,P3]

Use some functionalities:

>>> vector[1] = 'P4'
>>> vector
[P1,P4,P3]
>>> vector.add('P5')
>>> vector
[P1,P4,P3,P5]

Methods

BuildDefault(\*args)	Build a default description.
add(self, \*args)	Append a component (in-place).
at(self, \*args)	Access to an element of the collection.
clear(self)	Reset the collection to zero dimension.
find(self, val)	Find the index of a given value.
getClassName(self)	Accessor to the object’s name.
getId(self)	Accessor to the object’s id.
getName(self)	Accessor to the object’s name.
getShadowedId(self)	Accessor to the object’s shadowed id.
getSize(self)	Get the collection’s dimension (or size).
getVisibility(self)	Accessor to the object’s visibility state.
hasName(self)	Test if the object is named.
hasVisibleName(self)	Test if the object has a distinguishable name.
isBlank(self)	Check if the description is blank.
isEmpty(self)	Tell if the collection is empty.
resize(self, newSize)	Change the size of the collection.
setName(self, name)	Accessor to the object’s name.
setShadowedId(self, id)	Accessor to the object’s shadowed id.
setVisibility(self, visible)	Accessor to the object’s visibility state.

sort

__init__(self, \*args)

Initialize self. See help(type(self)) for accurate signature.

static BuildDefault(\*args)

Build a default description.

Parameters

sizeint,

Size of the collection.

valuestr

Prefixed label of the final labels. By default, it is equal to Component.

Returns

descriptionDescription

Description of dimension size built as: value0, …, valueN with N=size-1.

Examples

>>> import openturns as ot
>>> ot.Description.BuildDefault(3)
[Component0,Component1,Component2]
>>> ot.Description.BuildDefault(3, 'C')
[C0,C1,C2]

add(self, \*args)

Append a component (in-place).

Parameters

valuetype depends on the type of the collection.

The component to append.

Examples

>>> import openturns as ot
>>> x = ot.Point(2)
>>> x.add(1.)
>>> print(x)
[0,0,1]

at(self, \*args)

Access to an element of the collection.

Parameters

indexpositive int

Position of the element to access.

Returns

elementtype depends on the type of the collection

Element of the collection at the position index.

clear(self)

Reset the collection to zero dimension.

Examples

>>> import openturns as ot
>>> x = ot.Point(2)
>>> x.clear()
>>> x
class=Point name=Unnamed dimension=0 values=[]

find(self, val)

Find the index of a given value.

Parameters

valcollection value type

The value to find

Returns

indexint

The index of the first occurence of the value, or the size of the container if not found. When several values match, only the first index is returned.

getClassName(self)

Accessor to the object’s name.

Returns

class_namestr

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

getId(self)

Accessor to the object’s id.

Returns

idint

Internal unique identifier.

getName(self)

Accessor to the object’s name.

Returns

namestr

The name of the object.

getShadowedId(self)

Accessor to the object’s shadowed id.

Returns

idint

Internal unique identifier.

getSize(self)

Get the collection’s dimension (or size).

Returns

nint

The number of components in the collection.

getVisibility(self)

Accessor to the object’s visibility state.

Returns

visiblebool

Visibility flag.

hasName(self)

Test if the object is named.

Returns

hasNamebool

True if the name is not empty.

hasVisibleName(self)

Test if the object has a distinguishable name.

Returns

hasVisibleNamebool

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

isBlank(self)

Check if the description is blank.

Returns

isBlankbool

True if all the components are empty.

Examples

>>> import openturns as ot
>>> vector = ot.Description(3)
>>> vector.isBlank()
True
>>> vector = ot.Description(['P1', 'P2', ' '])
>>> vector.isBlank()
False

isEmpty(self)

Tell if the collection is empty.

Returns

isEmptybool

True if there is no element in the collection.

Examples

>>> import openturns as ot
>>> x = ot.Point(2)
>>> x.isEmpty()
False
>>> x.clear()
>>> x.isEmpty()
True

resize(self, newSize)

Change the size of the collection.

Parameters

newSizepositive int

New size of the collection.

Notes

If the new size is smaller than the older one, the last elements are thrown away, else the new elements are set to the default value of the element type.

Examples

>>> import openturns as ot
>>> x = ot.Point(2, 4)
>>> print(x)
[4,4]
>>> x.resize(1)
>>> print(x)
[4]
>>> x.resize(4)
>>> print(x)
[4,0,0,0]

setName(self, name)

Accessor to the object’s name.

Parameters

namestr

The name of the object.

setShadowedId(self, id)

Accessor to the object’s shadowed id.

Parameters

idint

Internal unique identifier.

setVisibility(self, visible)

Accessor to the object’s visibility state.

Parameters

visiblebool

Visibility flag.