NAISResult

class NAISResult(*args)

NAIS result.

Methods

drawImportanceFactors()

Draw the importance factors.

getAuxiliaryDistribution()

Accessor of the auxiliary distribution at the final NAIS step.

getAuxiliaryInputSample()

Accessor of the auxiliary distribution input sample at the final NAIS step.

getAuxiliaryOutputSample()

Accessor of the auxiliary distribution output sample at the final NAIS step.

getBlockSize()

Accessor to the block size.

getClassName()

Accessor to the object's name.

getCoefficientOfVariation()

Accessor to the coefficient of variation.

getConfidenceLength(*args)

Accessor to the confidence length.

getEvent()

Accessor to the event.

getId()

Accessor to the object's id.

getImportanceFactors()

Accessor to the importance factors.

getMeanPointInEventDomain()

Accessor to the mean point conditioned to the event realization.

getName()

Accessor to the object's name.

getOuterSampling()

Accessor to the outer sampling.

getProbabilityDistribution()

Accessor to the asymptotic probability distribution.

getProbabilityEstimate()

Accessor to the probability estimate.

getShadowedId()

Accessor to the object's shadowed id.

getStandardDeviation()

Accessor to the standard deviation.

getVarianceEstimate()

Accessor to the variance estimate.

getVisibility()

Accessor to the object's visibility state.

getWeights()

Auxiliary distribution input sample associated weights accessor of the final NAIS step.

hasName()

Test if the object is named.

hasVisibleName()

Test if the object has a distinguishable name.

setAuxiliaryDistribution(auxiliaryDistribution)

Accessor of the auxiliary distribution at the final NAIS step.

setAuxiliaryInputSample(auxiliaryInputSample)

Accessor of the auxiliary distribution input sample at the final NAIS step.

setAuxiliaryOutputSample(auxiliaryInputSample)

Accessor of the auxiliary distribution output sample at the final NAIS step.

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.

setShadowedId(id)

Accessor to the object's shadowed id.

setVarianceEstimate(varianceEstimate)

Accessor to the variance estimate.

setVisibility(visible)

Accessor to the object's visibility state.

setWeights(weights)

Auxiliary distribution input sample associated weights accessor of the final NAIS step.

__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:
graphGraph

Importance factor graph.

getAuxiliaryDistribution()

Accessor of the auxiliary distribution at the final NAIS step.

Returns:
auxiliaryDistributionDistribution

Auxiliary distribution at the final NAIS step.

getAuxiliaryInputSample()

Accessor of the auxiliary distribution input sample at the final NAIS step.

Returns:
auxiliaryInputSampleSample

Auxiliary distribution input sample at the final NAIS step.

getAuxiliaryOutputSample()

Accessor of the auxiliary distribution output sample at the final NAIS step.

Returns:
auxiliaryOutputSampleSample

Auxiliary distribution output sample at the final NAIS step.

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 \sqrt{Var_e} / P_e with Var_e the variance estimate and P_e the probability estimate.

getConfidenceLength(*args)

Accessor to the confidence length.

Parameters:
levelfloat, level \in ]0, 1[

Confidence level. By default, it is 0.95.

Returns:
confidenceLengthfloat

Length of the confidence interval at the confidence level level.

getEvent()

Accessor to the event.

Returns:
eventRandomVector

Event we want to evaluate the probability.

getId()

Accessor to the object’s id.

Returns:
idint

Internal unique identifier.

getImportanceFactors()

Accessor to the importance factors.

Returns:
importanceFactorsPointWithDescription

Sequence containing the importance factors with a description for each component.

Notes

The importance factors \alpha_i are evaluated from the coordinates of the mean point of event domain \vect{X}^*_{event}, mapped into the standard space as follows:

\alpha_i = \displaystyle \frac{\left(U_{i}^*\right)^2}{||\vect{U}^*||^2}

where \vect{U}^* = T(\vect{X}^*_{event}) with T the iso-probabilistic transformation and the mean point \vect{X}^*_{event} = \displaystyle \frac{1}{n} \sum_{i=1}^{n} \vect{X}_i 1_{event}(\vect{X}_i).

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:
meanPointPoint

Mean point in the physical space of all the simulations generated by the EventSimulation algorithm that failed into the event domain.

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:
probaDistributionNormal

Asymptotic normal distribution of the event probability estimate.

getProbabilityEstimate()

Accessor to the probability estimate.

Returns:
probaEstimatefloat

Estimate of the event probability.

getShadowedId()

Accessor to the object’s shadowed id.

Returns:
idint

Internal unique identifier.

getStandardDeviation()

Accessor to the standard deviation.

Returns:
sigmafloat

Standard deviation of the estimator at the end of the simulation.

getVarianceEstimate()

Accessor to the variance estimate.

Returns:
varianceEstimatefloat

Variance estimate.

getVisibility()

Accessor to the object’s visibility state.

Returns:
visiblebool

Visibility flag.

getWeights()

Auxiliary distribution input sample associated weights accessor of the final NAIS step.

Returns:
weightsPoint

Auxiliary distribution input sample associated weights.

hasName()

Test if the object is named.

Returns:
hasNamebool

True if the name is not empty.

hasVisibleName()

Test if the object has a distinguishable name.

Returns:
hasVisibleNamebool

True if the name is not empty and not the default one.

setAuxiliaryDistribution(auxiliaryDistribution)

Accessor of the auxiliary distribution at the final NAIS step.

Parameters:
auxiliaryDistributionDistribution

Auxiliary distribution at the final NAIS step.

setAuxiliaryInputSample(auxiliaryInputSample)

Accessor of the auxiliary distribution input sample at the final NAIS step.

Parameters:
auxiliaryInputSampleSample

Auxiliary distribution input sample at the final NAIS step.

setAuxiliaryOutputSample(auxiliaryInputSample)

Accessor of the auxiliary distribution output sample at the final NAIS step.

Parameters:
auxiliaryOutputSampleSample

Auxiliary distribution output sample at the final NAIS step.

setBlockSize(blockSize)

Accessor to the block size.

Parameters:
blockSizeint, blockSize \geq 0

Number of terms in the probability simulation estimator grouped together.

setEvent(event)

Accessor to the event.

Parameters:
eventRandomVector

Event we want to evaluate the probability.

setName(name)

Accessor to the object’s name.

Parameters:
namestr

The name of the object.

setOuterSampling(outerSampling)

Accessor to the outer sampling.

Parameters:
outerSamplingint, outerSampling \geq 0

Number of groups of terms in the probability simulation estimator.

setProbabilityEstimate(probabilityEstimate)

Accessor to the probability estimate.

Parameters:
probaEstimatefloat, 0 \leq P_e \leq 1

Estimate of the event probability.

setShadowedId(id)

Accessor to the object’s shadowed id.

Parameters:
idint

Internal unique identifier.

setVarianceEstimate(varianceEstimate)

Accessor to the variance estimate.

Parameters:
varianceEstimatefloat, Var_e \geq 0

Variance estimate.

setVisibility(visible)

Accessor to the object’s visibility state.

Parameters:
visiblebool

Visibility flag.

setWeights(weights)

Auxiliary distribution input sample associated weights accessor of the final NAIS step.

Parameters:
weightsPoint

Auxiliary distribution input sample associated weights.

Examples using the class

Non parametric Adaptive Importance Sampling (NAIS)

Non parametric Adaptive Importance Sampling (NAIS)