Test the design point with the Strong Maximum Test

In this example we are going to validate a FORM estimation using the Strong Maximum Test.

The Strong Maximum Test helps to evaluate the quality of the design point resulting from the optimization algorithm. 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.

This verification is very important in order to give sense to the FORM and SORM approximations.

We briefly recall here the main principles of the test. The objective is to detect all the points in the ball of radius which are potentially the real design point (case of ) or which contribution to is not negligeable as regards the approximations Form and Sorm (case of ). The contribution of a point is considered as negligeable when its likelihood in the -space is more than -times lesser than the design point one. The radius is the distance to the -space center upon which points are considered as negligeable in the evaluation of .

import openturns as ot

ot.Log.Show(ot.Log.NONE)

Create the model Y = x1 + 2*x2

model = ot.SymbolicFunction(["x1", "x2"], ["x1+2*x2"])

# Create the input distribution and random vector X
inputDist = ot.Normal(2)
inputDist.setDescription(["X1", "X2"])

inputVector = ot.RandomVector(inputDist)

# Create the output random vector Y=model(X)
output = ot.CompositeRandomVector(model, inputVector)
output.setName("MyOutputY")

Create the physical event Y > 4

threshold = 4
myEvent = ot.ThresholdEvent(output, ot.Greater(), threshold)

# Create the associated standard event in the standard space
myStandardEvent = ot.StandardEvent(myEvent)

First : FORM analyses to get the design point

myCobyla = ot.Cobyla()
myStartingPoint = inputDist.getMean()
myAlgoFORM = ot.FORM(myCobyla, myEvent, myStartingPoint)
myAlgoFORM.run()
FORMResult = myAlgoFORM.getResult()
standardSpaceDesignPoint = FORMResult.getStandardSpaceDesignPoint()

Fix the importance level epsilon of the test Care : 0<epsilon<1

importanceLevel = 0.15

# Fix the accuracy level tau of the test
# Care : tau >0
# It is recommended that tau <4
accuracyLevel = 3.0

# Fix the confidence level (1-q) of the test
confidenceLevel = 0.99

# Create the Strong Maximum Test
# CARE : the event must be declared in the standard space
# 1. From the confidenceLevel parameter
mySMT_CL = ot.StrongMaximumTest(
    myStandardEvent,
    standardSpaceDesignPoint,
    importanceLevel,
    accuracyLevel,
    confidenceLevel,
)

# 2. Or from the  maximum number of points sampling the sphere
pointsNumber = 1000
mySMT_PN = ot.StrongMaximumTest(
    myStandardEvent,
    standardSpaceDesignPoint,
    importanceLevel,
    accuracyLevel,
    pointsNumber,
)

# Perform the test
mySMT_CL.run()
mySMT_PN.run()

# Get (or evaluate) the confidence level
# associated to the number of points used to sample the sphere
print("Confidence level = ", mySMT_CL.getConfidenceLevel())

# Get (or evaluate) the number of points used to sample the sphere
# associated the confidence level used
print("Points Number = ", mySMT_CL.getPointNumber())

Confidence level =  0.99
Points Number =  13

# Get all the points verifying the event  and outside the design point vicinity
# Get also the values of limit state function at these points
potentialDesignPoints = mySMT_CL.getFarDesignPointVerifyingEventPoints()
values = mySMT_CL.getFarDesignPointVerifyingEventValues()
print("Potential design points = ", potentialDesignPoints)
print("Model values = ", values)

# Get all the points verifying the event and inside the design point vicinity
# Get also the values of limit state function at these points
vicinityDesignPoint = mySMT_CL.getNearDesignPointVerifyingEventPoints()
values = mySMT_CL.getNearDesignPointVerifyingEventValues()
print(
    "Points verifying the Event in the vicinity of the design points = ",
    vicinityDesignPoint,
)
print("Model values = ", values)

# Get all the points not verifying the event and outside the design point vicinity
# Get also the values of limit state function at these points
farSecurityPoints = mySMT_CL.getFarDesignPointViolatingEventPoints()
values = mySMT_CL.getFarDesignPointViolatingEventValues()
print(
    "Points NOT verifying the Event outside the vicinity of the design points = ",
    farSecurityPoints,
)
print("Model values = ", values)

# Get  all the points not verifying the event and inside the design point vicinity
# Get also the values of limit state function at these points
vicinitySecurityPoints = mySMT_CL.getNearDesignPointViolatingEventPoints()
values = mySMT_CL.getNearDesignPointViolatingEventValues()
print(
    "Points NOT verifying the Event outside the vicinity of the design points = ",
    vicinitySecurityPoints,
)
print("Model values = ", values)

Potential design points =
Model values =
Points verifying the Event in the vicinity of the design points =  0 : [  4.35393    -0.142915   ]
1 : [  4.30651     0.656617   ]
2 : [ -1.82076     3.95752    ]
3 : [  4.35627    -0.00715204 ]
4 : [ -1.96262     3.88912    ]
5 : [ -1.90605     3.91716    ]
6 : [  4.35491    -0.109327   ]
Model values =      [ y0      ]
0 : [ 4.0681  ]
1 : [ 5.61974 ]
2 : [ 6.09429 ]
3 : [ 4.34197 ]
4 : [ 5.81563 ]
5 : [ 5.92827 ]
6 : [ 4.13625 ]
Points NOT verifying the Event outside the vicinity of the design points =  0 : [  4.14285   -1.34684   ]
1 : [ -2.58691   -3.50501   ]
2 : [ -3.55551    2.51704   ]
3 : [ -4.1313    -1.38186   ]
4 : [  0.0233527 -4.35622   ]
5 : [ -2.89287    3.25707   ]
Model values =      [ y0       ]
0 : [  1.44916 ]
1 : [ -9.59692 ]
2 : [  1.47858 ]
3 : [ -6.89502 ]
4 : [ -8.68908 ]
5 : [  3.62126 ]
Points NOT verifying the Event outside the vicinity of the design points =
Model values =