Analytical¶

class
Analytical
(*args)¶ Base class to evaluate the probability of failure of a system.
 Available constructors:
Analytical(nearestPointAlgorithm, event, physicalStartingPoint)
 Parameters
 nearestPointAlgorithm
OptimizationAlgorithm
Optimization algorithm used to research the design point.
 event
RandomVector
Failure event.
 physicalStartingPointsequence of float
Starting point of the optimization algorithm, declared in the physical space.
 nearestPointAlgorithm
See also
Notes
Used in reliability analysis, Analytical is a base class for the approximation methods
FORM
andSORM
enabling to evaluate the failure probability of a system. A failure event is defined as follows : where denotes a random input vector representing the sources of uncertainties, is a determinist vector representing the fixed variables. is the limit state function of the model separating the failure domain from the safe domain. Considering the joint probability density function of the random variables , the probability of failure of the event is :The analytical methods use an isoprobabilistic transformation to move from the physical space to the standard normal space (Uspace) where distributions are spherical (invariant by rotation by definition), with zero mean, unit variance and unit correlation matrix. The usual isoprobabilistic transformations are the Generalized Nataf transformation and the Rosenblatt one.
In that new Uspace, the event has the new expression defined from the transformed limit state function of the model and its boundary : . Then, the event probability rewrites :
where is the density function of the distribution in the standard space.
The analytical methods rely on the assumption that most of the contribution to comes from points located in the vicinity of a particular point , the design point, defined in the Uspace as the point located on the limit state surface verifying the event of maximum likelihood. Given the probabilistic characteristics of the Uspace, has a geometrical interpretation: it is the point located on the event boundary and at minimal distance from the origin of the Uspace. Thus, considering its coordinates in the Uspace, the design point is the result of the constrained optimization problem :
Then the limit state surface is approximated in the standard space by a linear surface (
FORM
) or by a quadratic surface (SORM
) at the design point in order to evaluate the failure probability. For more information on this evaluation, see the documentation associated with these two methods.The result of the optimization problem is recoverable thanks to the method
getAnalyticalResult()
.The unicity and the strongness of the design point can be checked thanks to the
Strong Maximum Test
.Examples
>>> import openturns as ot >>> myFunction = ot.SymbolicFunction(['E', 'F', 'L', 'I'], ['F*L^3/(3*E*I)']) >>> myDistribution = ot.Normal([50.0, 1.0, 10.0, 5.0], [1.0]*4, ot.IdentityMatrix(4)) >>> vect = ot.RandomVector(myDistribution) >>> output = ot.CompositeRandomVector(myFunction, vect) >>> myEvent = ot.ThresholdEvent(output, ot.Less(), 3.0) >>> # We create an OptimizationAlgorithm algorithm >>> myOptim = ot.AbdoRackwitz() >>> myAlgo = ot.Analytical(myOptim, myEvent, [50.0, 1.0, 10.0, 5.0])
Methods
getAnalyticalResult
(self)Accessor to the result.
getClassName
(self)Accessor to the object’s name.
getEvent
(self)Accessor to the event of which the probability is calculated.
getId
(self)Accessor to the object’s id.
getName
(self)Accessor to the object’s name.
getNearestPointAlgorithm
(self)Accessor to the optimization algorithm used to find the design point.
getPhysicalStartingPoint
(self)Accessor to the starting point of the optimization algorithm.
getShadowedId
(self)Accessor to the object’s shadowed id.
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.
run
(self)Perform the research of the design point.
setEvent
(self, event)Accessor to the event of which the probability is calculated.
setName
(self, name)Accessor to the object’s name.
setNearestPointAlgorithm
(self, solver)Accessor to the optimization algorithm used to find the design point.
setPhysicalStartingPoint
(self, …)Accessor to the starting point of the optimization algorithm.
setShadowedId
(self, id)Accessor to the object’s shadowed id.
setVisibility
(self, visible)Accessor to the object’s visibility state.

__init__
(self, *args)¶ Initialize self. See help(type(self)) for accurate signature.

getAnalyticalResult
(self)¶ Accessor to the result.
 Returns
 result
AnalyticalResult
Result structure which contains the results of the optimisation problem.
 result

getClassName
(self)¶ Accessor to the object’s name.
 Returns
 class_namestr
The object class name (object.__class__.__name__).

getEvent
(self)¶ Accessor to the event of which the probability is calculated.
 Returns
 event
RandomVector
Event of which the probability is calculated.
 event

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.

getNearestPointAlgorithm
(self)¶ Accessor to the optimization algorithm used to find the design point.
 Returns
 algorithm
OptimizationAlgorithm
Optimization algorithm used to research the design point.
 algorithm

getPhysicalStartingPoint
(self)¶ Accessor to the starting point of the optimization algorithm.
 Returns
 point
Point
Starting point of the optimization algorithm, declared in the physical space.
 point

getShadowedId
(self)¶ Accessor to the object’s shadowed id.
 Returns
 idint
Internal unique identifier.

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.

run
(self)¶ Perform the research of the design point.
Notes
Performs the research of the design point and creates a
AnalyticalResult
, the structure result which is accessible with the methodgetAnalyticalResult()
.

setEvent
(self, event)¶ Accessor to the event of which the probability is calculated.
 Parameters
 event
RandomVector
Event of which the probability is calculated.
 event

setName
(self, name)¶ Accessor to the object’s name.
 Parameters
 namestr
The name of the object.

setNearestPointAlgorithm
(self, solver)¶ Accessor to the optimization algorithm used to find the design point.
 Parameters
 algorithm
OptimizationAlgorithm
Optimization algorithm used to research the design point.
 algorithm

setPhysicalStartingPoint
(self, physicalStartingPoint)¶ Accessor to the starting point of the optimization algorithm.
 Parameters
 pointsequence of float
Starting point of the optimization algorithm, declared in the physical space.

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.