PODSummary¶

class
PODSummary
(*args)¶ Run the analysis and compute POD with several methods.
Available constructor:
PODSummary(inputSample, outputSample, detection, noiseThres, saturationThres, boxCox)
Parameters: inputSample : 2d sequence of float
Vector of the input values. The first column must correspond with the defect sizes.
outputSample : 2d sequence of float
Vector of the signals, of dimension 1.
detection : float
Detection value of the signal.
noiseThres : float
Value for low censored data. Default is None.
saturationThres : float
Value for high censored data. Default is None
boxCox : bool or float
Enable or not the Box Cox transformation. If boxCox is a float, the Box Cox transformation is enabled with the given value. Default is False.
Warning
The first column of the input sample must corresponds with the defects sample.
Notes
This class aims at running the linear analysis and computing the POD with different models:
 Linear regression model with Gaussian residuals hypothesis,
 Linear regression model with no hypothesis on the residuals (binomial),
 Linear regression model with with kernel smoothing on the residuals,
 Quantile regression,
 Polynomial chaos,
 kriging if the dimension of the input sample is greater than 1.
Each method can be deactivated using the method setMethodActive and using the key corresponding to the method.
All results can be displayed and saved thanks to the methods printResults, saveResults and saveGraphs. For each method, the probability level and confidence level can be specified in order to compute the defect size to the wanted probability level.
The verbosity is enabled by default but it can be disabled using the method setVerbose.
Methods
drawGraphs
([directory, extension, …])draw and save all possible graphs getKrigingPOD
()Accessor to the kriging POD object. getLinearBinomialPOD
()Accessor to the linear model POD object with no hypothesis on the residuals. getLinearGaussPOD
()Accessor to the linear model POD object with Gaussian hypothesis. getLinearKernelSmoothingPOD
()Accessor to the linear model POD object with kernel smoothing on the residuals. getMethodActive
()Accessor to the dictionnary of active methods. getPolynomialChaosPOD
()Accessor to the polynomial chaos POD object. getQuantileRegressionPOD
()Accessor to the quantile regression POD object. getResults
([probabilityLevel, confidenceLevel])Print all results in the terminal. getSamplingSize
()Accessor to the Monte Carlo sampling size. getSimulationSize
()Accessor to the simulation size. getVerbose
()Accessor to the verbosity. run
()Run all active methods. saveResults
(name[, probabilityLevel, …])Save all analysis test results in a file. setMethodActive
(method, activation)Accessor to the dictionnary of active methods. setSamplingSize
(size)Accessor to the Monte Carlo sampling size. setSimulationSize
(size)Accessor to the simulation size. setVerbose
(verbose)Accessor to the verbosity. 
drawGraphs
(directory=None, extension='png', probabilityLevel=None, confidenceLevel=None)¶ draw and save all possible graphs
Parameters: directory : string
Directory where to save the graphs. Default is the working directory.
extension : string
File extension of the graphs. Default is ‘png’.
probabilityLevel : float
The probability level for which the defect size is computed. default is None.
confidenceLevel : float
The confidence level associated to the given probability level the defect size is computed. Default is None.

getKrigingPOD
()¶ Accessor to the kriging POD object.
Returns: algorithm : KrigingPOD
The KrigingPOD object that is used to compute the POD.

getLinearBinomialPOD
()¶ Accessor to the linear model POD object with no hypothesis on the residuals.
Returns: algorithm : UnivariateLinearModelPOD
The UnivariateLinearModelPOD object that is used to compute the POD.

getLinearGaussPOD
()¶ Accessor to the linear model POD object with Gaussian hypothesis.
Returns: algorithm : UnivariateLinearModelPOD
The UnivariateLinearModelPOD object that is used to compute the POD.

getLinearKernelSmoothingPOD
()¶ Accessor to the linear model POD object with kernel smoothing on the residuals.
Returns: algorithm : UnivariateLinearModelPOD
The UnivariateLinearModelPOD object that is used to compute the POD.

getMethodActive
()¶ Accessor to the dictionnary of active methods.
Returns: activeDict : dict
The dictionnary containing the bool telling if the methods is activated or not.

getPolynomialChaosPOD
()¶ Accessor to the polynomial chaos POD object.
Returns: algorithm : PolynomialChaosPOD
The PolynomialChaosPOD object that is used to compute the POD.

getQuantileRegressionPOD
()¶ Accessor to the quantile regression POD object.
Returns: algorithm : QuantileRegressionPOD
The QuantileRegressionPOD object that is used to compute the POD.

getResults
(probabilityLevel=0.9, confidenceLevel=0.95)¶ Print all results in the terminal.
Parameters: probabilityLevel : float
The probability level for which the defect size is computed. default is 0.9.
confidenceLevel : float
The confidence level associated to the given probability level the defect size is computed. Default is 0.95.
Notes
The probability level and confidence level can be specified in order to display the defect size for different probability level.

getSamplingSize
()¶ Accessor to the Monte Carlo sampling size.
Returns: size : int
The size of the Monte Carlo simulation used to compute the POD for each defect size for polynomial chaos and kriging.

getSimulationSize
()¶ Accessor to the simulation size.
Returns: size : int
The size of the simulation used to compute the confidence interval.

getVerbose
()¶ Accessor to the verbosity.
Returns: verbose : bool
Enable or disable the verbosity. Default is True.

run
()¶ Run all active methods.

saveResults
(name, probabilityLevel=0.9, confidenceLevel=0.95)¶ Save all analysis test results in a file.
Parameters: name : string
Name of the file or full path name.
probabilityLevel : float
The probability level for which the defect size is computed. default is 0.9.
confidenceLevel : float
The confidence level associated to the given probability level the defect size is computed. Default is 0.95.
Notes
The probability level and confidence level can be specified in order to display the defect size for different probability level.
The file can be saved as a csv file. Separations are made with tabulations.
If name is the file name, then it is saved in the current working directory.

setMethodActive
(method, activation)¶ Accessor to the dictionnary of active methods.
Parameters: method : string
The key of the method to activate or deactivate.
activation : bool
Set to True to activate and False to deactivate.

setSamplingSize
(size)¶ Accessor to the Monte Carlo sampling size.
Parameters: size : int
The size of the Monte Carlo simulation used to compute the POD for each defect size for polynomial chaos and kriging.

setSimulationSize
(size)¶ Accessor to the simulation size.
Parameters: size : int
The size of the simulation used to compute the confidence interval.

setVerbose
(verbose)¶ Accessor to the verbosity.
Parameters: verbose : bool
Enable or disable the verbosity.