Talk:Create Plots/Notes

From ReliaWiki
Revision as of 00:02, 20 May 2016 by Kate Racaza (talk | contribs)
Jump to navigation Jump to search

DRAFT

APIWiki.png


<< Back to Tutorials Main Page

xxx

Prerequisites

In this tutorial, you'll use a Windows Form application to create a button that, when clicked, analyzes a Weibull++ data set and displays the resulting plot. Before you begin, be sure to create a Windows Form Application project, and add a Button and a PictureBox control to the form. You can rename the button to "Create Plot," if desired.

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 as shown 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

The Synthesis API can create plots only from analyzed data sets. In this example, the first three sections of code demonstrate how to create and analyze a simple Weibull++ data set (for a full discussion, see this tutorial).

  '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()

The WAPlots object represents a plot based on the fitted model of a Weibull++ or ALTA data set. Use the AddDataset method to assign the data set (in this case, a WeibullDataSet object) 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 a 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.

References