FORMImportanceSamplingAnalysis

class persalys.FORMImportanceSamplingAnalysis(*args)

Run a FORM analysis followed by an importance sampling for reliability analysis.

Parameters

namestr

Name

limitStateLimitState

Limit state

Examples

>>> import openturns as ot
>>> import persalys

Create the model:

>>> R = persalys.Input('R', 0., ot.LogNormalMuSigma(300., 30., 0.).getDistribution(), 'Yield strength')
>>> F = persalys.Input('F', 0., ot.Normal(75000., 5000.), 'Traction load')
>>> G = persalys.Output('G', 'deviation')
>>> myPhysicalModel = persalys.SymbolicPhysicalModel('myPhysicalModel', [R, F], [G], ['R-F/(pi_*100.0)'])

Create the limit state:

>>> limitState = persalys.LimitState('ls1', myPhysicalModel, 'G', ot.Less(), 0.)

Process the reliability analysis:

>>> analysis = persalys.FORMImportanceSamplingAnalysis('myAnalysis', limitState)
>>> analysis.setMaximumCalls(1000)
>>> analysis.run()

Get the result:

>>> result = analysis.getResult()
>>> pf = result.getSimulationResult().getProbabilityEstimate()

Methods

getBlockSize()	Block size accessor.
getClassName()	Accessor to the object's name.
getErrorMessage()	Error message accessor.
getFORMResult()	FORM result accessor.
getInterestVariables()	Get the variables to analyse.
getLimitState()	Limit-state accessor.
getMaximumCalls()	Maximum calls accessor.
getMaximumCoefficientOfVariation()	Maximum coefficient of variation accessor.
getMaximumElapsedTime()	Maximum elapsed time accessor.
getName()	Accessor to the object's name.
getOptimizationAlgorithm()	Accessor to the optimization algorithm used to find the design point.
getPhysicalModel()	Physical model accessor.
getPhysicalStartingPoint()	Physical starting point accessor.
getPythonScript()	Physical model accessor.
getResult()	Result accessor.
getSeed()	Seed accessor.
getStandardSpaceDesignPoint()	Accessor to standard space design point.
getWarningMessage()	Warning message accessor.
hasName()	Test if the object is named.
hasValidResult()	Whether the analysis has been run.
isReliabilityAnalysis()	Whether the analysis involves reliability.
isRunning()	Whether the analysis is running.
run()	Launch the analysis.
setBlockSize(size)	Block size accessor.
setInterestVariables(outputsNames)	Set the variables to analyse.
setMaximumCalls(maxi)	Maximum calls accessor.
setMaximumCoefficientOfVariation(coef)	Maximum coefficient of variation accessor.
setMaximumElapsedTime(seconds)	Maximum elapsed time accessor.
setName(name)	Accessor to the object's name.
setOptimizationAlgorithm(solver)	Accessor to the optimization algorithm used to find the design point.
setPhysicalStartingPoint(point)	Physical starting point accessor.
setSeed(seed)	Seed accessor.
setStandardSpaceDesignPoint(point)	Accessor to standard space design point.

canBeLaunched
getElapsedTime
getParentObserver

__init__(*args)

getBlockSize()

Block size accessor.

Returns

sizeint

Number of terms in the probability simulation estimator grouped together. It is set by default to 1.

getClassName()

Accessor to the object’s name.

Returns

class_namestr

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

getErrorMessage()

Error message accessor.

Returns

messagestr

Error message if the analysis failed

getFORMResult()

FORM result accessor.

Returns

resultopenturns.FORMResult

Result of the FORM analysis

getInterestVariables()

Get the variables to analyse.

Returns

variablesNamessequence of str

Names of the variables to analyse

getLimitState()

Limit-state accessor.

Returns

limitStateLimitState

The Limit-state.

getMaximumCalls()

Maximum calls accessor.

Returns

maxCallspositive int

The maximum calls of the function.

getMaximumCoefficientOfVariation()

Maximum coefficient of variation accessor.

Returns

maxCoefdouble

The maximum coefficient of variation. It is set by default to 0.01.

getMaximumElapsedTime()

Maximum elapsed time accessor.

Returns

maxTimepositive int

The maximum elapsed time in seconds. It is set by default to 60 seconds.

getName()

Accessor to the object’s name.

Returns

namestr

The name of the object.

getOptimizationAlgorithm()

Accessor to the optimization algorithm used to find the design point.

Returns

algorithmopenturns.OptimizationAlgorithm

Optimization algorithm used to research the design point. Cobyla is the default used algorithm.

getPhysicalModel()

Physical model accessor.

Returns

modelPhysicalModel

Physical model

getPhysicalStartingPoint()

Physical starting point accessor.

Returns

pointopenturns.Point

Physical starting point. By default it set to the mean of the composed distribution of the physical model

getPythonScript()

Physical model accessor.

Returns

scriptstr

Python script to replay the analysis

getResult()

Result accessor.

Returns

resultSimulationReliabilityResult

Result

getSeed()

Seed accessor.

Returns

seedint

Seed

getStandardSpaceDesignPoint()

Accessor to standard space design point.

Returns

pointopenturns.Point

Standard space design point. It is the mean of the Normal distribution used to sample.

getWarningMessage()

Warning message accessor.

Returns

messagestr

Warning message which can appear during the analysis computation

hasName()

Test if the object is named.

Returns

hasNamebool

True if the name is not empty.

hasValidResult()

Whether the analysis has been run.

Returns

hasValidResultbool

Whether the analysis has already been run

isReliabilityAnalysis()

Whether the analysis involves reliability.

Returns

isReliabilityAnalysisbool

Whether the analysis involves a reliability analysis

isRunning()

Whether the analysis is running.

Returns

isRunningbool

Whether the analysis is running

run()

Launch the analysis.

setBlockSize(size)

Block size accessor.

Parameters

sizeint

Number of terms in the probability simulation estimator grouped together. It is set by default to 1.

setInterestVariables(outputsNames)

Set the variables to analyse.

Parameters

variablesNamessequence of str

Names of the variables to analyse

setMaximumCalls(maxi)

Maximum calls accessor.

Parameters

maxCallspositive int

The maximum calls of the function.

setMaximumCoefficientOfVariation(coef)

Maximum coefficient of variation accessor.

Parameters

maxCoefdouble

The maximum coefficient of variation. It is set by default to 0.01.

setMaximumElapsedTime(seconds)

Maximum elapsed time accessor.

Parameters

maxTimepositive int

The maximum elapsed time in seconds. It is set by default to 60 seconds.

setName(name)

Accessor to the object’s name.

Parameters

namestr

The name of the object.

setOptimizationAlgorithm(solver)

Accessor to the optimization algorithm used to find the design point.

Parameters

algorithmopenturns.OptimizationAlgorithm

Optimization algorithm used to research the design point. Cobyla is the default used algorithm.

setPhysicalStartingPoint(point)

Physical starting point accessor.

Parameters

pointsequence of float

Physical starting point. By default it set to the mean of the composed distribution of the physical model

setSeed(seed)

Seed accessor.

Parameters

seedint

Seed

setStandardSpaceDesignPoint(point)

Accessor to standard space design point.

Parameters

pointsequence of float

Standard space design point. It is the mean of the Normal distribution used to sample