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.

Note that this tutorial is for demonstration purposes only; it doesn't take efficiency into account and doesn't include any exception handling.

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 SynthesisAPI Form1 Button1_Click(sender Object, e  EventArgs)  Button1.Click WDS 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) WDS.AnalysisSettings.Distribution = WeibullSolverDistribution.Weibull WDS.AnalysisSettings.Parameters = WeibullSolverNumParameters.MS_2Parameter WDS.AnalysisSettings.Analysis = WeibullSolverMethod.RRX WDS.Calculate WPlot WAPlots WPlot.AddDataset(WDS) PictureBox1.Image = WPlot.CreatePlot(WAPlotType.Probability) PictureBox1.SizeMode = PictureBoxSizeMode.AutoSize

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.

WDS 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) WDS.AnalysisSettings.Distribution = WeibullSolverDistribution.Weibull WDS.AnalysisSettings.Parameters = WeibullSolverNumParameters.MS_2Parameter WDS.AnalysisSettings.Analysis = WeibullSolverMethod.RRX 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.

WPlot WAPlots 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  property of the PictureBox. The  property is optional; it resizes the PictureBox to fit the image. PictureBox1.Image = WPlot.CreatePlot(WAPlotType.Probability) PictureBox1.SizeMode = PictureBoxSizeMode.AutoSize

Note
For ALTA Data Sets

In ALTA data sets, you have the option to create a use level probability plot based on a specified use stress level. Use the PlotUseStress(index) property to specify the use stress value to be plotted. The Index parameter is an integer that specifies the stress index, where 0 = first stress, 1 = second stress, etc.

For example, for an ALTA single-stress analysis:

ADS ALTADataSet APlot WAPlots APlot.AddDataset(ADS) ADS.PlotUseStress(0) = 200 PictureBox1.Image = APlot.CreatePlot(WAPlotType.UseLevelProbability) PictureBox1.SizeMode = PictureBoxSizeMode.AutoSize

For Models

You can also plot the results of any cModel object by using the WAPlots.AddModel method. For example:

model cModel plot WAPlots plot.AddModel(model)