ProbabilitySimulationResult¶
- class ProbabilitySimulationResult(*args)¶
Probability simulation result.
Notes
Structure created by the method run() of a
EventSimulation
, and obtained thanks to the method getResult().Examples
>>> import openturns as ot >>> ot.RandomGenerator.SetSeed(0) >>> limitState = ot.SymbolicFunction(['E', 'F', 'L', 'I'], ['-F*L^3/(3.*E*I)']) >>> # Enable the history mechanism in order to use the getImportanceFactors method >>> limitState = ot.MemoizeFunction(limitState) >>> distribution = ot.Normal([50.0, 1.0, 10.0, 5.0], [1.0]*4, ot.IdentityMatrix(4)) >>> output = ot.CompositeRandomVector(limitState, ot.RandomVector(distribution)) >>> event = ot.ThresholdEvent(output, ot.Less(), -3.0) >>> experiment = ot.MonteCarloExperiment() >>> algo = ot.ProbabilitySimulationAlgorithm(event, experiment) >>> algo.run() >>> result = algo.getResult() >>> importanceFactors = result.getImportanceFactors()
Methods
Draw the importance factors.
Accessor to the block size.
Accessor to the object's name.
Accessor to the coefficient of variation.
getConfidenceLength
(*args)Accessor to the confidence length.
getEvent
()Accessor to the event.
Accessor to the importance factors.
Accessor to the mean point conditioned to the event realization.
getName
()Accessor to the object's name.
Accessor to the outer sampling.
Accessor to the asymptotic probability distribution.
Accessor to the probability estimate.
Accessor to the standard deviation.
Accessor to the elapsed time.
Accessor to the variance estimate.
hasName
()Test if the object is named.
setBlockSize
(blockSize)Accessor to the block size.
setEvent
(event)Accessor to the event.
setName
(name)Accessor to the object's name.
setOuterSampling
(outerSampling)Accessor to the outer sampling.
setProbabilityEstimate
(probabilityEstimate)Accessor to the probability estimate.
setTimeDuration
(time)Accessor to the elapsed time.
setVarianceEstimate
(varianceEstimate)Accessor to the variance estimate.
- __init__(*args)¶
- drawImportanceFactors()¶
Draw the importance factors.
Warning
It is necessary to enable the history of the model to perform this analysis (see
MemoizeFunction
).- Returns:
- graph
Graph
Importance factor graph.
- graph
See also
- getBlockSize()¶
Accessor to the block size.
- Returns:
- blockSizeint
Number of terms in the probability simulation estimator grouped together.
- getClassName()¶
Accessor to the object’s name.
- Returns:
- class_namestr
The object class name (object.__class__.__name__).
- getCoefficientOfVariation()¶
Accessor to the coefficient of variation.
- Returns:
- coefficientfloat
Coefficient of variation of the simulated sample which is equal to with the variance estimate and the probability estimate.
- getConfidenceLength(*args)¶
Accessor to the confidence length.
- Parameters:
- levelfloat,
Confidence level. By default, it is .
- Returns:
- confidenceLengthfloat
Length of the confidence interval at the confidence level level.
- getEvent()¶
Accessor to the event.
- Returns:
- event
RandomVector
Event we want to evaluate the probability.
- event
- getImportanceFactors()¶
Accessor to the importance factors.
- Returns:
- importanceFactors
PointWithDescription
Sequence containing the importance factors with a description for each component.
- importanceFactors
See also
Notes
The importance factors are evaluated from the coordinates of the mean point of event domain , mapped into the standard space as follows:
where with the iso-probabilistic transformation and the mean point .
Warning
This notion is only available if the history mechanism of the model is activated (see
MemoizeFunction
).
- getMeanPointInEventDomain()¶
Accessor to the mean point conditioned to the event realization.
- Returns:
- meanPoint
Point
Mean point in the physical space of all the simulations generated by the
EventSimulation
algorithm that failed into the event domain.
- meanPoint
Notes
Warning
This notion is only available if the history mechanism of the model is activated (see
MemoizeFunction
).
- getName()¶
Accessor to the object’s name.
- Returns:
- namestr
The name of the object.
- getOuterSampling()¶
Accessor to the outer sampling.
- Returns:
- outerSamplingint
Number of groups of terms in the probability simulation estimator.
- getProbabilityDistribution()¶
Accessor to the asymptotic probability distribution.
- Returns:
- probaDistribution
Normal
Asymptotic normal distribution of the event probability estimate.
- probaDistribution
- getProbabilityEstimate()¶
Accessor to the probability estimate.
- Returns:
- probaEstimatefloat
Estimate of the event probability.
- getStandardDeviation()¶
Accessor to the standard deviation.
- Returns:
- sigmafloat
Standard deviation of the estimator at the end of the simulation.
- getTimeDuration()¶
Accessor to the elapsed time.
- Returns:
- timefloat
Simulation duration in seconds
- getVarianceEstimate()¶
Accessor to the variance estimate.
- Returns:
- varianceEstimatefloat
Variance estimate.
- hasName()¶
Test if the object is named.
- Returns:
- hasNamebool
True if the name is not empty.
- setBlockSize(blockSize)¶
Accessor to the block size.
- Parameters:
- blockSizeint,
Number of terms in the probability simulation estimator grouped together.
- setEvent(event)¶
Accessor to the event.
- Parameters:
- event
RandomVector
Event we want to evaluate the probability.
- event
- setName(name)¶
Accessor to the object’s name.
- Parameters:
- namestr
The name of the object.
- setOuterSampling(outerSampling)¶
Accessor to the outer sampling.
- Parameters:
- outerSamplingint,
Number of groups of terms in the probability simulation estimator.
- setProbabilityEstimate(probabilityEstimate)¶
Accessor to the probability estimate.
- Parameters:
- probaEstimatefloat,
Estimate of the event probability.
- setTimeDuration(time)¶
Accessor to the elapsed time.
- Parameters:
- timefloat
Simulation duration in seconds
- setVarianceEstimate(varianceEstimate)¶
Accessor to the variance estimate.
- Parameters:
- varianceEstimatefloat,
Variance estimate.
Examples using the class¶
Create a process from random vectors and processes
Estimate a probability with Monte Carlo
Use a randomized QMC algorithm
Use the Adaptive Directional Stratification Algorithm
Use the Directional Sampling Algorithm
Specify a simulation algorithm
Use the Importance Sampling algorithm
Estimate a probability with Monte-Carlo on axial stressed beam: a quick start guide to reliability
Estimate a buckling probability
Exploitation of simulation algorithm results
Axial stressed beam : comparing different methods to estimate a probability
Using the FORM - SORM algorithms on a nonlinear function