Talk:Perform Life Data Analysis on External Data Source/Notes: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
(Replaced content with '=DRAFT=')
 
(12 intermediate revisions by the same user not shown)
Line 1: Line 1:
=DRAFT=
=DRAFT=
{{Template:API}}{{Template:BacktoPrevPage}}
With the Synthesis API, you can leverage the Weibull++ analysis engine to perform life data analysis on an external data source. In this tutorial, you will learn how to use the API to create and analyze a data set, and obtain analysis results from the model.
==Tutorial: Life Data Analysis==
The following example demonstrates how to define and analyze a Weibull++ data set, and use the result to estimate the probability of failure. A discussion of the example follows.
This example uses the following data set:
{|{{table}}
|Number in State||State||Time to F or S
|-
|1||F||16
|-
|1||F||34
|-
|1||F||53
|-
|1||F||75
|-
|1||F||93
|-
|5||S||120
|}
'''VB.NET'''
{{APIPrefix|Imports}} SynthesisAPI
{{APIPrefix|Module}} Module1
    {{APIPrefix|Sub}} Main()
  {{APIComment|'Declare a new WeibullDataSet object.}}
    {{APIPrefix|Dim}} WDS {{APIPrefix|As New}} WeibullDataSet
 
  {{APIComment|'Add failure times to the data set.}}
    WDS.AddFailure(16, 1)
    WDS.AddFailure(34, 1)
    WDS.AddFailure(53, 1) 
    WDS.AddFailure(75, 1)
    WDS.AddFailure(93, 1)
 
  {{APIComment|'Add five suspensions to the data set.}}
    WDS.AddSuspension(120, 5) 
  {{APIComment|'Use the 2-parameter Weibull distribution and the rank regression on X (RRX) analysis method.}}
  {{APIComment|'Keep all other analysis settings at default.}}
    WDS.AnalysisSettings.Distribution = WeibullSolverDistribution.Weibull
    WDS.AnalysisSettings.Parameters = WeibullSolverNumParameters.MS_2Parameter
    WDS.AnalysisSettings.Analysis = WeibullSolverMethod.RRX
 
  {{APIComment|'Analyze the data set.}}
    WDS.Calculate()
  {{APIComment|'Calculate the probability of failure at 226 hrs and display the result.}}
    {{APIPrefix|Dim}} r {{APIPrefix|As}} Double
    r = WDS.FittedModel.unreliability(226)
    MsgBox({{APIString|"Prob. Fail: "}} & r)
    {{APIPrefix|End Sub}}
{{APIPrefix|End Module}}
==Discussion==
The [[WeibullDataSet Class|WeibullDataSet]] class represents a Weibull++ standard folio data sheet. The class contains all the methods and properties that allow you to define a data set and fit a statistical distribution to the data.
  {{APIComment|'Declare a new WeibullDataSet object.}}
    {{APIPrefix|Dim}} WDS {{APIPrefix|As New}} WeibullDataSet
The data set can contain failures, suspensions, interval data or free-form data. The following example shows how to use the [[WeibullDataSet.AddFailure|AddFailure]] method to define failures and the [[WeibullDataSet.AddSuspension|AddSuspension]] method to define suspensions.
{{APIComment|'Add failure times to the data set.}}
  WDS.AddFailure(16, 1)
  WDS.AddFailure(34, 1)
  WDS.AddFailure(53, 1) 
  WDS.AddFailure(75, 1)
  WDS.AddFailure(93, 1)
 
{{APIComment|'Add five suspensions to the data set.}}
  WDS.AddSuspension(120, 5)
The AnalysisSetting property returns a [[WeibullAnalysisOptions Class|WeibullAnalysisOptions]] object, which represents the analysis settings of the data set. In the following example, we use the <code>Distribution</code>, <code>Parameters</code> and <code>Analysis</code> properties of the object to specify the life distribution and analysis method.
{{APIComment|'Use the 2-parameter Weibull distribution and the rank regression on X (RRX) analysis method.}}
{{APIComment|'Keep all other analysis settings at default.}}
  WDS.AnalysisSettings.Distribution = WeibullSolverDistribution.Weibull
  WDS.AnalysisSettings.Parameters = WeibullSolverNumParameters.MS_2Parameter
  WDS.AnalysisSettings.Analysis = WeibullSolverMethod.RRX
Use the [[WeibullDataSet.Calculate|Calculate]] method to analyze the data set. The method returns a message box that shows the estimated parameters of the life distribution, based on the settings specified in the <code>AnalysisSettings</code> property.
{{APIComment|'Analyze the data set.}}
  WDS.Calculate()
The <code>FittedModel</code> property gets a [[CModel Class|cModel]] object that represents the fitted model of the life data analysis. From the model, you can calculate useful metrics such as reliability, failure rate, mean time, etc. In this example, we use the [[CModel.Unreliability|cModel.Unreliability]] method to calculate for the probability of failure.
  {{APIComment|'Calculate the probability of failure at 226 hrs and display the result.}}
    {{APIPrefix|Dim}} r {{APIPrefix|As}} Double
    r = WDS.FittedModel.unreliability(226)
    MsgBox({{APIString|"Prob. Fail: "}} & r)
==References==
*[[WeibullDataSet Class]]
*[[WeibullDataSet.AddFailure|WeibullDataSet.AddFailure Method]]
*[[WeibullDataSet.AddSuspension| WeibullDataSet.AddSuspension Method]]
*[[WeibullDataSet.Calculate|WeibullDataSet.Calculate Method]]
*[[WeibullAnalysisOptions Class]]
*[[CModel Class|cModel Class]]

Latest revision as of 00:45, 7 September 2016

DRAFT