Talk:Create Plots/Notes
DRAFT
In the Weibull++ data set and 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 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 Imports SynthesisAPI Public Class Form1 Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click 'Create a Weibull++ data set. Dim WDS 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) 'Analyze the data set using the 2-parameter Weibull distribution and '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 'Analyze the data set. WDS.Calculate() 'Declare a new WAPlots object. Dim WPlot As New WAPlots 'Add the analyzed data set to the plot. WPlot.AddDataset(WDS) 'Create a probability plot and display it in the PictureBox. PictureBox1.Image = WPlot.CreatePlot(WAPlotType.Probability) PictureBox1.SizeMode = PictureBoxSizeMode.AutoSize End Sub 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 this tutorial). From this data set, we'll create a plot.
'Create a Weibull++ data set. Dim WDS 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) 'Analyze the data set using the 2-parameter Weibull distribution and '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 'Analyze the data set. WDS.Calculate()
Next, create a new WAPlots object to represent the plot and then use the AddDataset method to assign the data set to the plot.
'Declare a new WAPlots object. Dim WPlot As New WAPlots 'Add the analyzed data set to the plot. WPlot.AddDataset(WDS)
Use the CreatePlot method to create the plot. The type of plot it creates is specified by the WAPlotType enumeration. In this example, we've chosen a probability plot.
To display the plot, assign it to the Image
property of the PictureBox. The SizeMode
property is optional; it resizes the PictureBox to fit the image.
'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 ALTADataSet.PlotUseStress(index)
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.