|
|
| (5 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| =DRAFT= | | =DRAFT= |
| {{Template:API}}{{Template:BacktoPrevPage}}
| |
|
| |
| In the [[Perform_Life_Data_Analysis_on_External_Data_Source|Weibull++ data set]] and [[Perform_Accelerated_Life_Testing_Data_Analysis_on_External_Data_Source|ALTA data set]] tutorials, you learned how to use the Synthesis API to analyze a data set and obtain calculated results. In this tutorial, you'll use the Synthesis API to generate a plot of the results.
| |
|
| |
| ==Prerequisites==
| |
| This tutorial uses a Windows Form application that displays a plot at a click of a button. Before you begin, please create a Windows Form Application project, and add a '''Button''' and '''PictureBox''' control to the form.
| |
|
| |
| Need help with creating Windows Forms? See this [https://msdn.microsoft.com/en-us/library/b201w61t%28v=vs.100%29.aspx Microsoft tutorial].
| |
|
| |
| ==Tutorial: Weibull++/ALTA Plots ==
| |
| The following example demonstrates how to use the Synthesis API to create a Weibull++ probability plot and display it in a Windows application. To run this example, paste the code to the Button Click event handler in your project, as shown in the example below. A discussion of the example follows.
| |
|
| |
| '''VB.NET'''
| |
|
| |
| {{APIPrefix|Imports}} SynthesisAPI
| |
|
| |
| {{APIPrefix|Public Class}} Form1
| |
| {{APIPrefix|Private Sub}} Button1_Click(sender {{APIPrefix|As}} Object, e {{APIPrefix|As}} EventArgs) {{APIPrefix|Handles}} Button1.Click
| |
|
| |
| {{APIComment|'Create a Weibull++ data set.}}
| |
| {{APIPrefix|Dim}} WDS {{APIPrefix|As New}} WeibullDataSet
| |
| WDS.AddFailure(16, 1)
| |
| WDS.AddFailure(34, 1)
| |
| WDS.AddFailure(53, 1)
| |
| WDS.AddFailure(75, 1)
| |
| WDS.AddFailure(93, 1)
| |
| WDS.AddSuspension(120, 5)
| |
|
| |
| {{APIComment|'Analyze the data set using the 2-parameter Weibull distribution and}}
| |
| {{APIComment|'the RRX analysis method. 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|'Declare a new WAPlots object.}}
| |
| {{APIPrefix|Dim}} WPlot {{APIPrefix|As New}} WAPlots
| |
|
| |
| {{APIComment|'Add the analyzed data set to the plot.}}
| |
| WPlot.AddDataset(WDS)
| |
|
| |
| {{APIComment|'Create a probability plot and display it in the PictureBox.}}
| |
| PictureBox1.Image = WPlot.CreatePlot(WAPlotType.Probability)
| |
| PictureBox1.SizeMode = PictureBoxSizeMode.AutoSize
| |
|
| |
| {{APIPrefix|End Sub}}
| |
| {{APIPrefix|End Class}}
| |
|
| |
| ===Discussion===
| |
|
| |
| You'll first need an analyzed Weibull++ or ALTA data set before you can create a plot. The first three sections of code in this example demonstrate how to create and analyze a simple Weibull++ data set (for a full discussion, see [[Perform_Life_Data_Analysis_on_External_Data_Source|this tutorial]]). From this data set, we'll create a plot.
| |
|
| |
| {{APIComment|'Create a Weibull++ data set.}}
| |
| {{APIPrefix|Dim}} WDS {{APIPrefix|As New}} WeibullDataSet
| |
| WDS.AddFailure(16, 1)
| |
| WDS.AddFailure(34, 1)
| |
| WDS.AddFailure(53, 1)
| |
| WDS.AddFailure(75, 1)
| |
| WDS.AddFailure(93, 1)
| |
| WDS.AddSuspension(120, 5)
| |
|
| |
| {{APIComment|'Analyze the data set using the 2-parameter Weibull distribution and}}
| |
| {{APIComment|'the RRX analysis method. 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()
| |
|
| |
| Next, create a new [[WAPlots Class|WAPlots]] object to represent the plot and then use the [[WAPlots.AddDataset|AddDataset]] method to assign the data set to the plot.
| |
|
| |
| {{APIComment|'Declare a new WAPlots object.}}
| |
| {{APIPrefix|Dim}} WPlot {{APIPrefix|As New}} WAPlots
| |
|
| |
| {{APIComment|'Add the analyzed data set to the plot.}}
| |
| WPlot.AddDataset(WDS)
| |
|
| |
| Use the [[WAPlots.CreatePlot|CreatePlot]] method to create the plot. The type of plot it creates is specified by the [[WAPlotType Enumeration|WAPlotType]] enumeration. In this example, we've chosen a probability plot.
| |
|
| |
| To display the plot, assign it to the <code>Image</code> property of the PictureBox. The <code>SizeMode</code> property is optional; it resizes the PictureBox to fit the image.
| |
|
| |
| {{APIComment|'Create a probability plot and display it in the PictureBox.}}
| |
| PictureBox1.Image = WPlot.CreatePlot(WAPlotType.Probability)
| |
| PictureBox1.SizeMode = PictureBoxSizeMode.AutoSize
| |
|
| |
| ==Note==
| |
| In ALTA data sets, you can choose to include the use stress level in the plot. Use the <code>ALTADataSet.PlotUseStress(''index'')</code> property to get or set the use stress value of a particular stress. The ''Index'' parameter is an integer that specifies the stress index, where 0 = first stress, 1 = second stress, etc.
| |
|
| |
| ===References===
| |
| *[[WAPlots Class]]
| |
| **[[WAPlots.AddDataset|WAPlots.AddDataset Method]]
| |
| **[[WAPlots.CreatePlot|WAPlots.CreatePlot Method]]
| |
| *[[WAPlotType Enumeration]]
| |