HistoryStrategy

class HistoryStrategy(*args)

History storage strategy.

Available constructors:

HistoryStrategy()

HistoryStrategy(historyStrategyImp)

Parameters:

historyStrategyImp : HistoryStrategyImplementation

An implementation of a history strategy which is provided by Compact, Full, Last or Null class.

See also

Compact, Full, Last, Null

Notes

In order to prevent a memory problem, the User has the possibility to choose the storage strategy used to save the numerical samples. Four strategies are proposed :

  • the Null strategy where nothing is stored. This class does not require to specify arguments.

  • the Full strategy where every point is stored. Be careful! The memory will be exhausted for huge samples. This class does not require to specify arguments.

  • the Last strategy where only the N last points are stored, where N is specified by the User. This class requires to specify the number of points to store.

  • the Compact strategy where a regularly spaced sub-sample is stored. The minimum size N of the stored numerical sample is specified by the User. OpenTURNS proceeds as follows :

    1. it stores the first 2N simulations : the size of the stored sample is 2N,
    2. it selects only 1 out of 2 of the stored simulations : then the size of the stored sample decreases to N (this is the compact step),
    3. it stores the next N simulations when selecting 1 out of 2 of the next simulations : the size of the stored sample is 2N,
    4. it selects only 1 out of 2 of the stored simulations : then the size of the stored sample decreases to N,
    5. it stores the next N simulations when selecting 1 out of 4 of the next simulations : the size of the stored sample is 2N,
    6. then it keeps on until reaching the stopping criteria.

    The stored numerical sample will have a size within N and 2N. This class requires to specify the number of points to store.

Methods

clear() Clear the stored points.
getClassName() Accessor to the object’s name.
getId() Accessor to the object’s id.
getImplementation(*args) Accessor to the underlying implementation.
getName() Accessor to the object’s name.
getSample() Accessor to the stored sample.
setName(name) Accessor to the object’s name.
store(*args) Store points or samples.
__init__(*args)

x.__init__(…) initializes x; see help(type(x)) for signature

clear()

Clear the stored points.

Notes

It erases the previously stored points

getClassName()

Accessor to the object’s name.

Returns:

class_name : str

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

getId()

Accessor to the object’s id.

Returns:

id : int

Internal unique identifier.

getImplementation(*args)

Accessor to the underlying implementation.

Returns:

impl : Implementation

The implementation class.

getName()

Accessor to the object’s name.

Returns:

name : str

The name of the object.

getSample()

Accessor to the stored sample.

Returns:

sample : Sample

Numerical sample which is the collection of points stored by the history strategy.

setName(name)

Accessor to the object’s name.

Parameters:

name : str

The name of the object.

store(*args)

Store points or samples.

Parameters:

data : sequence of float or 2-d sequence of float

Point or sample to store.

Notes

It adds a unique point or all the point of the sample in the natural order to the history.