ProjectionStrategy

class ProjectionStrategy(*args)

Base class for the evaluation strategies of the approximation coefficients.

Available constructors:

ProjectionStrategy(projectionStrategy)

Parameters
projectionStrategyProjectionStrategy

A projection strategy which is a LeastSquaresStrategy or an IntegrationStrategy.

See also

FunctionalChaosAlgorithm, LeastSquaresStrategy, IntegrationStrategy

Notes

Consider \vect{Y} = g(\vect{X}) with g: \Rset^d \rightarrow \Rset^p, \vect{X} \sim \cL_{\vect{X}} and \vect{Y} with finite variance: g\in L_{\cL_{\vect{X}}}^2(\Rset^d, \Rset^p).

The functional chaos expansion approximates \vect{Y} using an isoprobabilistic transformation T and an orthonormal multivariate basis (\Psi_k)_{k \in \Nset} of L^2_{\mu}(\Rset^d,\Rset). See FunctionalChaosAlgorithm to get more details.

The meta model of g, based on the functional chaos decomposition of f = g \circ T^{-1} writes:

\tilde{g} = \sum_{k \in K} \vect{\alpha}_k \Psi_k \circ T

where K is a non empty finite set of indices, whose cardinality is denoted by P.

We detail the case where p=1.

The vector \vect{\alpha} = (\alpha_k)_{k \in K} is equivalently defined by:

(1)\vect{\alpha} = \argmin_{\vect{\alpha} \in \Rset^K} \Expect{ \left( g \circ T^{-1}(\vect{Z}) - \sum_{k \in K} \alpha_k \Psi_k (\vect{Z})\right)^2 }

and:

(2)\alpha_k = <g \circ T^{-1}(\vect{Z}), \Psi_k (\vect{Z})>_{\mu} = \Expect{ g \circ T^{-1}(\vect{Z}) \Psi_k (\vect{Z}) }

where \vect{Z} = T(\vect{X}) and the mean \Expect{.} is evaluated with respect to the measure \mu.

It corresponds to two points of view:

  • relation (1) means that the coefficients (\alpha_k)_{k \in K} minimize the quadratic error between the model and the polynomial approximation. Use LeastSquaresStrategy.

  • relation (2) means that \alpha_k is the scalar product of the model with the k-th element of the orthonormal basis (\Psi_k)_{k \in \Nset}. Use IntegrationStrategy.

In both cases, the mean \Expect{.} is approximated by a linear quadrature formula:

(3)\Expect{ f(\vect{Z})} \simeq \sum_{i \in I} \omega_i f(\Xi_i)

where f is a function in L^1(\mu).

In the approximation (3), the set I, the points (\Xi_i)_{i \in I} and the weights (\omega_i)_{i \in I} are evaluated from different methods implemented in the WeightedExperiment.

The convergence criterion used to evaluate the coefficients is based on the residual value defined in the FunctionalChaosAlgorithm.

Methods

getClassName(self)

Accessor to the object’s name.

getCoefficients(self)

Accessor to the coefficients.

getExperiment(self)

Accessor to the experiments.

getId(self)

Accessor to the object’s id.

getImplementation(self)

Accessor to the underlying implementation.

getInputSample(self)

Accessor to the input sample.

getMeasure(self)

Accessor to the measure.

getName(self)

Accessor to the object’s name.

getOutputSample(self)

Accessor to the output sample.

getRelativeError(self)

Accessor to the relative error.

getResidual(self)

Accessor to the residual.

getWeights(self)

Accessor to the weights.

setExperiment(self, weightedExperiment)

Accessor to the design of experiment.

setInputSample(self, inputSample)

Accessor to the input sample.

setMeasure(self, measure)

Accessor to the measure.

setName(self, name)

Accessor to the object’s name.

setOutputSample(self, outputSample)

Accessor to the output sample.

setWeights(self, weights)

Accessor to the weights.

computeCoefficients
__init__(self, \*args)

Initialize self. See help(type(self)) for accurate signature.

getClassName(self)

Accessor to the object’s name.

Returns
class_namestr

The object class name (object.__class__.__name__).

getCoefficients(self)

Accessor to the coefficients.

Returns
coefPoint

Coefficients (\alpha_k)_{k \in K}.

getExperiment(self)

Accessor to the experiments.

Returns
expWeightedExperiment

Weighted experiment used to evaluate the coefficients.

getId(self)

Accessor to the object’s id.

Returns
idint

Internal unique identifier.

getImplementation(self)

Accessor to the underlying implementation.

Returns
implImplementation

The implementation class.

getInputSample(self)

Accessor to the input sample.

Returns
XSample

Input Sample.

getMeasure(self)

Accessor to the measure.

Returns
muDistribution

Measure \mu defining the scalar product.

getName(self)

Accessor to the object’s name.

Returns
namestr

The name of the object.

getOutputSample(self)

Accessor to the output sample.

Returns
YSample

Output Sample.

getRelativeError(self)

Accessor to the relative error.

Returns
efloat

Relative error.

getResidual(self)

Accessor to the residual.

Returns
erfloat

Residual error.

getWeights(self)

Accessor to the weights.

Returns
wPoint

Weights of the design of experiments.

setExperiment(self, weightedExperiment)

Accessor to the design of experiment.

Parameters
expWeightedExperiment

Weighted design of experiment.

setInputSample(self, inputSample)

Accessor to the input sample.

Parameters
XSample

Input Sample.

setMeasure(self, measure)

Accessor to the measure.

Parameters
mDistribution

Measure \mu defining the scalar product.

setName(self, name)

Accessor to the object’s name.

Parameters
namestr

The name of the object.

setOutputSample(self, outputSample)

Accessor to the output sample.

Parameters
YSample

Output Sample.

setWeights(self, weights)

Accessor to the weights.

Parameters
wPoint

Weights of the design of experiments.