WeibullAnalysisOptions Class: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Template:APIClass|WeibullDataSet Class|Weibull++}}
{{Template:API}}{{Template:APIBreadcrumb}}
{{Template:WeibullDataSet.AnalysisSettings.Cmt}}


== Properties==
'''Life Distribution'''
*Distribution    (type: ''[[WeibullSolverDistribution]]'')  {{APIComment|{{Template:WeibullAnalysisOptions.Distribution.cmt}}}}
*Parameters      (type: ''[[WeibullSolverNumParameters]]'') {{APIComment|{{Template:WeibullAnalysisOptions.Parameters.Cmt}}}}
*Subpopulations  (type: ''integer'')                        {{APIComment|{{Template:WeibullAnalysisOptions.Subpopulations.Cmt}}}}


'''Control Panel Analysis Page Settings'''
<onlyinclude>Represents the analysis settings of the associated [[WeibullDataSet Class|WeibullDataSet]] object.</onlyinclude>
*Analysis                  (type: ''[[WeibullSolverMethod]]'')    {{APIComment|{{Template:WeibullAnalysisOptions.Analysis.Cmt}}}} 
*RankingMethod            (type: ''[[WeibullSolverRankMethod]]''){{APIComment|{{Template:WeibullAnalysisOptions.RankingMethod.Cmt}}}}
*UseRSRegression          (type: ''boolean'')                    {{APIComment|{{Template:WeibullAnalysisOptions.UseRSRegression.Cmt}}}}
*ConfBounds                (type: ''boolean'')                    {{APIComment|{{Template:WeibullAnalysisOptions.ConfBounds.Cmt}}}}
*SortBeforeCalculations    (type: ''boolean'')                    {{APIComment|{{Template:WeibullAnalysisOptions.SortBeforeCalculations.Cmt}}}}
*UngroupGroupedData        (type: ''boolean'')                    {{APIComment|{{Template:WeibullAnalysisOptions.UngroupGroupedData.Cmt}}}}
*Weibull_UnbiasParameters  (type: ''boolean'')                    {{APIComment|{{Template:WeibullAnalysisOptions.Weibull_UnbiasParameters.Cmt}}}}


'''Bayesian-Weibull Model Settings'''
== Properties  ==
*Bayesian_PriorDistribution (type: ''[[WeibullBayesianPriorDistribution]]'') {{APIComment|{{Template:WeibullAnalysisOptions.Bayesian_PriorDistribution.Cmt}}}}
{| {{APITable}}
*Bayesian_Mean              (type: ''double'')                              {{APIComment|{{Template:WeibullAnalysisOptions.Bayesian_Mean.Cmt}}}}
|-
*Bayesian_Std              (type: ''double'')                               {{APIComment|{{Template:WeibullAnalysisOptions.Bayesian_Std.Cmt}}}}
| style="width: 180px;"|Analysis||Gets or sets a value from the '''[[WeibullSolverMethod_Enumeration|WeibullSolverMethod]]''' enumeration, which specifies the method (e.g., RRX, MLE, etc.) for estimating the parameters of the distribution. '''Double'''. Default value = 0 (RRX).
*Bayesian_Lambda            (type: ''double'')                               {{APIComment|{{Template:WeibullAnalysisOptions.Bayesian_Lambda.Cmt}}}}
|-
*Bayesian_MinBeta          (type: ''double'')                              {{APIComment|{{Template:WeibullAnalysisOptions.Bayesian_MinBeta.Cmt}}}}
|Bayesian_Lambda||Gets or sets the value of the lambda parameter of the prior distribution. Applies to Bayesian-Weibull analyses where the prior distribution of beta is assumed to follow an exponential distribution. '''Double'''. Default value = 2.
*Bayesian_MaxBeta          (type: ''double'')                              {{APIComment|{{Template:WeibullAnalysisOptions.Bayesian_MaxBeta.Cmt}}}}
|-
*Bayesian_Results          (type: ''[[WeibullBayesianResultsOption]]'')    {{APIComment|{{Template:WeibullAnalysisOptions.Bayesian_ResultsAs.Cmt}}}}
|Bayesian_MaxBeta||Gets or sets the maximum value of the beta parameter of the prior distribution. Applies to Bayesian-Weibull analyses where the prior distribution of beta is assumed to follow a uniform distribution. '''Double'''. Default value = 2.
|-
|Bayesian_Mean||Gets or sets the value of the mean parameter of the prior distribution. Applies to Bayesian-Weibull analyses where the prior distribution of beta is assumed to follow a normal distribution. '''Double'''. Default value = 2.
|-
|Bayesian_MinBeta||Gets or sets the minimum value of the beta parameter of the prior distribution. Applies to Bayesian-Weibull analyses where the prior distribution of beta is assumed to follow a uniform distribution. '''Double'''. Default value = 1.
|-
|Bayesian_PriorDistribution||Gets or set a value from the '''[[WeibullBayesianPriorDistribution_Enumeration|WeibullBayesianPriorDistribution]]''' enumeration, which specifies the prior distribution for the Bayesian-Weibull analysis. Default value = 0 (normal distribution).
|-
|Bayesian_ResultsAs||Gets or sets a value from the '''[[WeibullBayesianResultsOption_Enumeration|WeibullBayesianResultsOption]]''' enumeration, which specifies whether to obtain the point estimates of beta from the median value or the mean value of the posterior distribution. Default value = 0 (median).
|-
|Bayesian_Std||Gets or sets the value of the standard deviation parameter of the prior distribution. Applies to Bayesian-Weibull analyses where the prior distribution of beta is assumed to follow a normal distribution. '''Double'''. Default value = 1.
|-
|ConfBounds||Gets or sets a value from the '''[[WeibullSolverCBMethod_Enumeration|WeibullSolverCBMethod]]''' enumeration, which specifies the method for calculating the confidence bounds. Default value = 0 (Fisher Matrix method).
|-
|Distribution||Gets or sets a value from the '''[[WeibullSolverDistribution_Enumeration|WeibullSolverDistribution]]''' enumeration, which specifies the life distribution to fit to the data set. Default value = 0 (Weibull distribution).
|-
|Parameters||Gets or sets a value from the '''[[WeibullSolverNumParameters_Enumeration|WeibullSolverNumParameters]]''' enumeration, which specifies the form of a distribution. Default value = 1 (2-parameter form)
|-
|RankingMethod||Gets or sets a value from the '''[[WeibullSolverRankMethod_Enumeration|WeibullSolverRankMethod]]''' enumeration, which specifies the rank method for calculating the unreliability estimates of the times-to-failure data. Default value = 0 (median ranks).
|-
|SortBeforeCalculations||Indicates whether the failures/suspension times in the data set are sorted in ascending order before calculation. '''Boolean'''. Default value = True.
|-
|Subpopulations||Gets or sets the number of subpopulations in the data set. Applies to mixed Weibull analysis only. '''Integer'''. Default value = 2.
|-
|UngroupedGroupedData||Indicates whether to ungroup a grouped data set when using rank regression. '''Boolean'''. Default value = False.
|-
|UseRSRegression||Indicates whether to use ReliaSoft's ranking method (RRM) to calculate the unreliability estimates for times-to-failure data. '''Boolean'''. Default value = False, but is forced to True when analyzing interval censored data.
|-
|UseSpecialSort||Indicates whether failures will always be put before suspensions when two identical times are encountered. '''Boolean'''. Default value = True.
|-
|Weibull_UnbiasParameters||Indicates whether the biased beta estimate (due to MLE sampling error) will be corrected for the 2-parameter Weibull distribution. '''Boolean'''. Default value = False.
|}


'''Application Setup Option'''
*UseSpecialSort (type: ''boolean'') {{APIComment|{{Template:WeibullAnalysisOptions.UseSpecialSort.Cmt}}}}


== Usage Example ==
== Example ==
The following example demonstrates how to initialize some of the analysis settings for a particular WeibullDataSet object.


{{APIComment|Declare a WeibullDataSet object.}}
'''VBA'''
        Dim WDS as New [[WeibullDataSet Class|WeibullDataSet]]
{{APIComment|'Declare a new WeibullDataSet object.}}
  {{APIPrefix|Dim}} WDS {{APIPrefix|As New}} WeibullDataSet
 
{{APIComment|'Specify the analysis settings.}}
  WDS.AnalysisSettings.Analysis = WeibullSolverMethod_RRX
  WDS.AnalysisSettings.ConfBounds = WeibullSolverCBMethod_FisherMatrix
  WDS.AnalysisSettings.Distribution = WeibullSolverDistribution_Weibull
  WDS.AnalysisSettings.Parameters = WeibullSolverNumParameters_MS_2Parameter
  WDS.AnalysisSettings.RankingMethod = WeibullSolverRankMethod_Median
  WDS.AnalysisSettings.SortBeforeCalculations = True
  WDS.AnalysisSettings.UngroupGroupedData = False
  WDS.AnalysisSettings.UseRSRegression = False
  WDS.AnalysisSettings.UseSpecialSort = True
  WDS.AnalysisSettings.Weibull_UnbiasParameters = False
{{APIComment|'Add failure times to the data set.}}
  {{APIPrefix|Call}} WDS.AddFailure(100, 1)
  {{APIPrefix|Call}} WDS.AddFailure(120, 1)
  {{APIPrefix|Call}} WDS.AddFailure(130, 1) 
{{APIComment|'Analyze the data set.}}
  WDS.Calculate()


{{APIComment|Set Weibull as the distribution for analysis.}}
'''VB.NET'''
        WDS.[[WeibullDataSet.AnalysisSettings|AnalysisSettings]].[[WeibullAnalysisOptions.Distribution|Distribution]] = [[WeibullSolverDistribution]].Weibull
 
{{APIComment|'Declare a new WeibullDataSet object.}}
{{APIComment|Specify that the 2-parameter version of the distribution will be used.}}
  {{APIPrefix|Dim}} WDS {{APIPrefix|As New}} WeibullDataSet
        WDS.[[WeibullDataSet.AnalysisSettings|AnalysisSettings]].[[WeibullAnalysisOptions.Parameters|Parameters]] = [[WeibullSolverNumParameters]].MS_2Parameter
 
 
{{APIComment|'Specify the analysis settings.}}
{{APIComment|Set MLE as the method that will be used to estimate the parameters.}}
  WDS.AnalysisSettings.Analysis = WeibullSolverMethod.RRX
        WDS.[[WeibullDataSet.AnalysisSettings|AnalysisSettings]].[[WeibullAnalysisOptions.Analysis|Analysis]] = [[WeibullSolverMethod]].MLE
  WDS.AnalysisSettings.ConfBounds = WeibullSolverCBMethod.FisherMatrix
  WDS.AnalysisSettings.Distribution = WeibullSolverDistribution.Weibull
  WDS.AnalysisSettings.Parameters = WeibullSolverNumParameters.MS_2Parameter
  WDS.AnalysisSettings.RankingMethod = WeibullSolverRankMethod.Median
  WDS.AnalysisSettings.SortBeforeCalculations = True
  WDS.AnalysisSettings.UngroupGroupedData = False
  WDS.AnalysisSettings.UseRSRegression = False
  WDS.AnalysisSettings.UseSpecialSort = True
  WDS.AnalysisSettings.Weibull_UnbiasParameters = False
{{APIComment|'Add failure times to the data set.}}
  WDS.AddFailure(100, 1)
  WDS.AddFailure(120, 1)
  WDS.AddFailure(130, 1) 
{{APIComment|'Analyze the data set.}}
  WDS.Calculate()

Latest revision as of 20:27, 24 June 2016

APIWiki.png


Member of: SynthesisAPI


Represents the analysis settings of the associated WeibullDataSet object.

Properties

Name Description
Analysis Gets or sets a value from the WeibullSolverMethod enumeration, which specifies the method (e.g., RRX, MLE, etc.) for estimating the parameters of the distribution. Double. Default value = 0 (RRX).
Bayesian_Lambda Gets or sets the value of the lambda parameter of the prior distribution. Applies to Bayesian-Weibull analyses where the prior distribution of beta is assumed to follow an exponential distribution. Double. Default value = 2.
Bayesian_MaxBeta Gets or sets the maximum value of the beta parameter of the prior distribution. Applies to Bayesian-Weibull analyses where the prior distribution of beta is assumed to follow a uniform distribution. Double. Default value = 2.
Bayesian_Mean Gets or sets the value of the mean parameter of the prior distribution. Applies to Bayesian-Weibull analyses where the prior distribution of beta is assumed to follow a normal distribution. Double. Default value = 2.
Bayesian_MinBeta Gets or sets the minimum value of the beta parameter of the prior distribution. Applies to Bayesian-Weibull analyses where the prior distribution of beta is assumed to follow a uniform distribution. Double. Default value = 1.
Bayesian_PriorDistribution Gets or set a value from the WeibullBayesianPriorDistribution enumeration, which specifies the prior distribution for the Bayesian-Weibull analysis. Default value = 0 (normal distribution).
Bayesian_ResultsAs Gets or sets a value from the WeibullBayesianResultsOption enumeration, which specifies whether to obtain the point estimates of beta from the median value or the mean value of the posterior distribution. Default value = 0 (median).
Bayesian_Std Gets or sets the value of the standard deviation parameter of the prior distribution. Applies to Bayesian-Weibull analyses where the prior distribution of beta is assumed to follow a normal distribution. Double. Default value = 1.
ConfBounds Gets or sets a value from the WeibullSolverCBMethod enumeration, which specifies the method for calculating the confidence bounds. Default value = 0 (Fisher Matrix method).
Distribution Gets or sets a value from the WeibullSolverDistribution enumeration, which specifies the life distribution to fit to the data set. Default value = 0 (Weibull distribution).
Parameters Gets or sets a value from the WeibullSolverNumParameters enumeration, which specifies the form of a distribution. Default value = 1 (2-parameter form)
RankingMethod Gets or sets a value from the WeibullSolverRankMethod enumeration, which specifies the rank method for calculating the unreliability estimates of the times-to-failure data. Default value = 0 (median ranks).
SortBeforeCalculations Indicates whether the failures/suspension times in the data set are sorted in ascending order before calculation. Boolean. Default value = True.
Subpopulations Gets or sets the number of subpopulations in the data set. Applies to mixed Weibull analysis only. Integer. Default value = 2.
UngroupedGroupedData Indicates whether to ungroup a grouped data set when using rank regression. Boolean. Default value = False.
UseRSRegression Indicates whether to use ReliaSoft's ranking method (RRM) to calculate the unreliability estimates for times-to-failure data. Boolean. Default value = False, but is forced to True when analyzing interval censored data.
UseSpecialSort Indicates whether failures will always be put before suspensions when two identical times are encountered. Boolean. Default value = True.
Weibull_UnbiasParameters Indicates whether the biased beta estimate (due to MLE sampling error) will be corrected for the 2-parameter Weibull distribution. Boolean. Default value = False.


Example

The following example demonstrates how to initialize some of the analysis settings for a particular WeibullDataSet object.

VBA

 'Declare a new WeibullDataSet object. 
  Dim WDS As New WeibullDataSet
 
 'Specify the analysis settings. 
  WDS.AnalysisSettings.Analysis = WeibullSolverMethod_RRX
  WDS.AnalysisSettings.ConfBounds = WeibullSolverCBMethod_FisherMatrix
  WDS.AnalysisSettings.Distribution = WeibullSolverDistribution_Weibull
  WDS.AnalysisSettings.Parameters = WeibullSolverNumParameters_MS_2Parameter
  WDS.AnalysisSettings.RankingMethod = WeibullSolverRankMethod_Median
  WDS.AnalysisSettings.SortBeforeCalculations = True
  WDS.AnalysisSettings.UngroupGroupedData = False
  WDS.AnalysisSettings.UseRSRegression = False
  WDS.AnalysisSettings.UseSpecialSort = True
  WDS.AnalysisSettings.Weibull_UnbiasParameters = False

 'Add failure times to the data set. 
  Call WDS.AddFailure(100, 1)
  Call WDS.AddFailure(120, 1)
  Call WDS.AddFailure(130, 1)  

 'Analyze the data set. 
  WDS.Calculate()
VB.NET

 'Declare a new WeibullDataSet object. 
  Dim WDS As New WeibullDataSet
 
 'Specify the analysis settings. 
  WDS.AnalysisSettings.Analysis = WeibullSolverMethod.RRX
  WDS.AnalysisSettings.ConfBounds = WeibullSolverCBMethod.FisherMatrix
  WDS.AnalysisSettings.Distribution = WeibullSolverDistribution.Weibull
  WDS.AnalysisSettings.Parameters = WeibullSolverNumParameters.MS_2Parameter
  WDS.AnalysisSettings.RankingMethod = WeibullSolverRankMethod.Median
  WDS.AnalysisSettings.SortBeforeCalculations = True
  WDS.AnalysisSettings.UngroupGroupedData = False
  WDS.AnalysisSettings.UseRSRegression = False
  WDS.AnalysisSettings.UseSpecialSort = True
  WDS.AnalysisSettings.Weibull_UnbiasParameters = False

 'Add failure times to the data set. 
  WDS.AddFailure(100, 1)
  WDS.AddFailure(120, 1)
  WDS.AddFailure(130, 1)  

 'Analyze the data set. 
  WDS.Calculate()