StrongMaximumTest¶

class
StrongMaximumTest
(*args)¶ Strong Maximum Test.
Refer to Strong Maximum Test.
 Available constructors:
StrongMaximumTest(event, designPoint, importanceLevel, accuracyLevel, confidenceLevel)
StrongMaximumTest(event, designPoint, importanceLevel, accuracyLevel, pointNumber)
 Parameters
 event
StandardEvent
Failure event defining in the standard space (Uspace).
 designPointsequence of float
Design point in the standard space resulting from the optimization algorithm.
 importanceLevelfloat,
Importance level.
 accuracyLevelfloat,
Accuracy level. It is recommanded to take .
 confidenceLevelpositive float,
Confidence level.
 pointNumberint,
Number of points used to perform the Strong Maximum Test, evaluated by the limit state function.
 event
See also
Notes
The Strong Maximum Test helps to evaluate the quality of the design point resulting from the optimization algorithm launched for example by the
Analytical
class or its derived classesFORM
andSORM
. It checks whether the design point computed is :the true design point, which means a global maximum point,
a strong design point, which means that there is no other local maximum located on the event boundary and which likelihood is slightly inferior to the design point one.
The Strong Maximum Test will sample the sphere centered on the origin of the standard space and of radius : with , and the HasoferLind reliability index.
The number of the simulations sampling the sphere of radius is determined to ensure that the test detects with a probability greater than any point of outside the design point vicinity which contribution to is not negligeable (i.e. which density value in the Uspace is greater than times the density value at the design point).
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) >>> # FORM analyse to get the design point >>> myAlgo = ot.FORM(ot.AbdoRackwitz(), myEvent, [50.0, 1.0, 10.0, 5.0]) >>> myAlgo.run() >>> FORMresult = myAlgo.getResult() >>> designPoint = FORMresult.getStandardSpaceDesignPoint() >>> # Strong Max Test >>> myStandardEvent = ot.StandardEvent(myEvent) >>> myTest = ot.StrongMaximumTest(myStandardEvent, designPoint, 0.15, 3, 0.99) >>> myTest.run()
Methods
getAccuracyLevel
(self)Accessor to the accuracy level.
getClassName
(self)Accessor to the object’s name.
getConfidenceLevel
(self)Accessor to the confidence level.
getDeltaEpsilon
(self)Accessor to the parameter .
getDesignPointVicinity
(self)Accessor to the design point vinicity.
getEvent
(self)Accessor to the event in the standard space.
Accessor to the points verifying the event and far of the design point.
Accessor to values of the limit state function.
Accessor to the points not verifying the event and far of the design point.
Accessor to values of the limit state function.
getId
(self)Accessor to the object’s id.
getImportanceLevel
(self)Accessor to the importance level.
getName
(self)Accessor to the object’s name.
Accessor to the points verifying the event and near of the design point.
Accessor to values of the limit state function.
Accessor to the points not verifying the event and near of the design point.
Accessor to values of the limit state function.
getPointNumber
(self)Accessor to the number of points.
getShadowedId
(self)Accessor to the object’s shadowed id.
Accessor to the design point in the standard space.
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 Strong Maximum Test.
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.

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

getAccuracyLevel
(self)¶ Accessor to the accuracy level.
 Returns
 accuracypositive float
Accuracy level .

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

getConfidenceLevel
(self)¶ Accessor to the confidence level.
 Returns
 levelpositive float
Confidence level .

getDeltaEpsilon
(self)¶ Accessor to the parameter .
 Returns
 delta_epsilonfloat
.

getDesignPointVicinity
(self)¶ Accessor to the design point vinicity.
 Returns
 vicinityfloat,
Design point vinicity .

getEvent
(self)¶ Accessor to the event in the standard space.
 Returns
 event
StandardEvent
Failure event in the standard space on which is based the Strong Maximum Test.
 event

getFarDesignPointVerifyingEventPoints
(self)¶ Accessor to the points verifying the event and far of the design point.
 Returns
 points
Sample
The points of the discretized sphere which are out of the vicinity of the standard design point and which verify the event.
 points

getFarDesignPointVerifyingEventValues
(self)¶ Accessor to values of the limit state function.
 Returns
 values
Sample
The values of the limit state function on the points of the discretized sphere which are out of the vicinity of the standard design point and which verify the event.
 values

getFarDesignPointViolatingEventPoints
(self)¶ Accessor to the points not verifying the event and far of the design point.
 Returns
 points
Sample
The points of the discretized sphere which are out of the vicinity of the standard design point and which don’t verify the event.
 points

getFarDesignPointViolatingEventValues
(self)¶ Accessor to values of the limit state function.
 Returns
 values
Sample
The values of the limit state function on the points of the discretized sphere which are out of the vicinity of the standard design point and which don’t verify the event.
 values

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

getImportanceLevel
(self)¶ Accessor to the importance level.
 Returns
 levelfloat
Importance level .

getName
(self)¶ Accessor to the object’s name.
 Returns
 namestr
The name of the object.

getNearDesignPointVerifyingEventPoints
(self)¶ Accessor to the points verifying the event and near of the design point.
 Returns
 points
Sample
The points of the discretized sphere which are inside the vicinity of the standard design point and which verify the event.
 points

getNearDesignPointVerifyingEventValues
(self)¶ Accessor to values of the limit state function.
 Returns
 values
Sample
The values of the limit state function on the points of the discretized sphere which are inside the vicinity of the standard design point and which verify the event.
 values

getNearDesignPointViolatingEventPoints
(self)¶ Accessor to the points not verifying the event and near of the design point.
 Returns
 point
Sample
The points of the discretized sphere which are out of the vicinity of the standard design point and which don’t verify the event.
 point

getNearDesignPointViolatingEventValues
(self)¶ Accessor to values of the limit state function.
 Returns
 values
Sample
The values of the limit state function on the points of the discretized sphere which are inside the vicinity of the standard design point and which don’t verify the event.
 values

getPointNumber
(self)¶ Accessor to the number of points.
 Returns
 numberint,
Number of points used to perform the Strong Maximum Test, evaluated by the limit state function.

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

getStandardSpaceDesignPoint
(self)¶ Accessor to the design point in the standard space.
 Returns
 point
Point
Design point in the standard space.
 point

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 Strong Maximum Test.

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.