ALTADataSet Class: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(60 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Template:APIClass|ALTADataSet Class| }}  
{{Template:API}}{{Template:APIBreadcrumb}}<div style="border:1px solid #D0CDE8; background:#EEEDF7; border-radius:10px; width:auto; margin:0 0 1em 1em; padding:1em; float:right;"><span style="font-family:arial;font-size:5;color:#585858">Other Versions: [[ALTADataSet Class 10|Version 10]]</span></div>
{{Template:ALTADataSet Class.Cmt}}
{{Template:PlotsNote.Cmt}}


A usage example for this class is available [[ALTADataSet_Class_Example|here]].


== Constructors ==
<onlyinclude>Represents a data set for accelerated life testing data analysis. </onlyinclude>
*[[ALTADataSet_Constructors|ALTADataSet]]          {{APIComment|{{Template:ALTADataSet_Constructors1.Cmt}}}}
*[[ALTADataSet_Constructors|ALTADataSet( String )]]  {{APIComment|{{Template:ALTADataSet_Constructors2.Cmt}}}}


== Methods  ==
==Constructor==
Use these methods to enter data points into a data sheet and analyze them. The settings for the analysis are specified with this class's properties.
{| {{APITable}}
|-
| style="width: 200px;"|ALTADataSet||Creates an instance of the ALTADataSet class.  
|-
|[[ALTADataSet_Constructors|ALTADataSet()]]||{{:ALTADataSet_Constructors}}
|}


'''Add Stresses and Stress Profiles'''
*[[ALTADataSet.AddStressDefinition|AddStressDefinition( String, [ALTASolverLSR], [Double] )]] {{APIComment|{{Template:ALTADataSet.AddStressDefinition.Cmt}}}}
*[[ALTADataSet.AddStressProfile|AddStressProfile( ALTAStressProfile )]] {{APIComment|{{Template:ALTADataSet.AddStressProfile.Cmt}}}}


'''Add/Remove Data'''
==Method==
*[[ALTADataSet.AddFailure|AddFailure( Double, Integer, Object() )]]      {{APIComment|{{Template:ALTADataSet.AddFailure1.Cmt}}}}
{| {{APITable}}
*[[ALTADataSet.AddFailure|AddFailure( Double, Integer, Object )]]        {{APIComment|{{Template:ALTADataSet.AddFailure2.Cmt}}}}
|-
*[[ALTADataSet.AddFailure|AddFailure( Double, Integer, Object, Object )]] {{APIComment|{{Template:ALTADataSet.AddFailure3.Cmt}}}}
| style="width: 200px;"|[[ALTADataSet.AddFailure|AddFailure]]||{{:ALTADataSet.AddFailure}}
*[[ALTADataSet.AddSuspension|AddSuspension( Double, Integer, Object() )]]       {{APIComment|{{Template:ALTADataSet.AddSuspension1.Cmt}}}}
|-
*[[ALTADataSet.AddSuspension|AddSuspension( Double, Integer, Object )]]         {{APIComment|{{Template:ALTADataSet.AddSuspension2.Cmt}}}}
|[[ALTADataSet.AddFailureInterval|AddFailureInterval]]||{{:ALTADataSet.AddFailureInterval}}
*[[ALTADataSet.AddSuspension|AddSuspension( Double, Integer, Object, Object )]] {{APIComment|{{Template:ALTADataSet.AddSuspension3.Cmt}}}}
|-
*[[ALTADataSet.AddFailureInterval|AddFailureInterval( Double, Double, Integer, Object() )]]       {{APIComment|{{Template:ALTADataSet.AddFailureInterval1.Cmt}}}}
|[[ALTADataSet.AddFreeForm|AddFreeForm]]||{{:ALTADataSet.AddFreeForm}}
*[[ALTADataSet.AddFailureInterval|AddFailureInterval( Double, Double, Integer, Object )]]         {{APIComment|{{Template:ALTADataSet.AddFailureInterval2.Cmt}}}}
|-
*[[ALTADataSet.AddFailureInterval|AddFailureInterval( Double, Double, Integer, Object, Object )]] {{APIComment|{{Template:ALTADataSet.AddFailureInterval3.Cmt}}}}
|[[ALTADataSet.AddStressDefinition|AddStressDefinition]]||{{:ALTADataSet.AddStressDefinition}}
*[[ALTADataSet.AddSuspensionInterval|AddSuspensionInterval( Double, Double, Integer, Object() )]]       {{APIComment|{{Template:ALTADataSet.AddSuspensionInterval1.Cmt}}}}
|-
*[[ALTADataSet.AddSuspensionInterval|AddSuspensionInterval( Double, Double, Integer, Object )]]         {{APIComment|{{Template:ALTADataSet.AddSuspensionInterval2.Cmt}}}}
|[[ALTADataSet.AddStressProfile|AddStressProfile]]||{{:ALTADataSet.AddStressProfile}}
*[[ALTADataSet.AddSuspensionInterval|AddSuspensionInterval( Double, Double, Integer, Object, Object )]]  {{APIComment|{{Template:ALTADataSet.AddSuspensionInterval3.Cmt}}}}
|-
*[[ALTADataSet.ClearDataSet|ClearDataSet]]                       {{APIComment|{{Template:ALTADataSet.ClearDataSet.Cmt}}}}
|[[ALTADataSet.AddSuspension|AddSuspension]]||{{:ALTADataSet.AddSuspension}}
|-
|[[ALTADataSet.AddSuspensionInterval|AddSuspensionInterval]]||{{:ALTADataSet.AddSuspensionInterval}}
|-
|[[ALTADataSet.Calculate|Calculate]]||{{:ALTADataSet.Calculate}}
|-
|[[ALTADataSet.ClearDataSet|ClearDataSet]]||{{:ALTADataSet.ClearDataSet}}
|}


'''Analyze Data'''
*[[ALTADataSet.Calculate|Calculate]] {{APIComment|{{Template:ALTADataSet.Calculate.Cmt}}}}


== Properties ==
==Properties==
Use these properties to specify analysis settings and view analysis results, as well as view or edit properties of the data set.
{| {{APITable}}
|-
| style="width: 200px;"|AnalysisResults||Gets the '''[[ALTAAnalysisResults_Class|ALTAAnalysisResults]]''' object that represents the likelihood function value estimated from the accelerated life testing data analysis.
|-
|Calculated||Indicates whether the data set has been analyzed. '''Boolean'''. Read only.
|-
|DatasetName||Gets or sets the name of the data set. '''String'''. If no name has been specified, the default name is "Set 1."
|-
|FailureCount|| Gets the total number of failures in the data set. '''Integer'''.
|-
|FittedModel||References the '''[[cModel Class|cModel]]''' object that represents the fitted model of the accelerated life testing data analysis. From the cModel object, you can obtain results such as the reliability, mean time, failure rate, etc.
|-
|NumStresses||Gets the total number of stresses in the data set. '''Integer'''.
|-
|[[ALTADataSet.PlotUseStress|PlotUseStress]]||{{:ALTADataSet.PlotUseStress}}
|-
|StressRelation(''Index'')||Gets or sets a value from the '''[[ALTASolverLSR_Enumeration|ALTASolverLSR]]''' enumeration, which specifies the stress transformation of a particular stress. Default value = 0 (exponential life-stress relationship). The ''Index'' parameter is an integer that specifies the stress index, where 0 = first stress, 1 = second stress, etc. This property applies to the general log-linear (GLL) or cumulative damage (CD) model only.
|-
|SuspensionCount||Gets the total number of suspensions in the data set. '''Integer'''.
|-
|UseCalculationProgress||Indicates whether to display the progress bar while analyzing the data set. '''Boolean'''. Default value = True.
|-
|UseEvents||Indicates whether to enable user-defined event procedures for the <code>ALTADataSet</code> object. '''Boolean'''. Default value = False.
|}


'''Analysis Settings'''
*AnalysisSettings (as ''[[ALTAAnalysisOptions Class|ALTAAnalysisOptions]]'') {{APIComment|{{Template:ALTADataSet.AnalysisSettings.Cmt}}}}
*GeneralSettings (as ''[[ALTAGeneralOptions Class|ALTAGeneralOptions]]'') {{APIComment|{{Template:ALTADataSet.GeneralSettings.Cmt}}}}
*[[ALTADataSet.PlotUseStress|PlotUseStress( Integer )]] (as ''double'') {{APIComment|{{Template:ALTADataSet.PlotUseStress.Cmt}}}}
*[[ALTADataSet.StressRelation|StressRelation( Integer )]] (as ''[[ALTASolverLSR Enumeration|ALTASolverLSR]]'') {{APIComment|{{Template:ALTADataSet.StressRelation.Cmt}}}}


'''Analysis Results'''
==Fields==
*FittedModel (as ''[[cModel Class|cModel]]'') {{APIComment|{{Template:ALTADataSet.FittedModel.Cmt}}}}
{| {{APITable}}
*AnalysisResults (as ''[[ALTAAnalysisResults Class|ALTAAnalysisResults]]'') {{APIComment|{{Template:ALTADataSet.AnalysisResults.Cmt}}}}
|-
| style="width: 200px;"|AnalysisSettings||References the '''[[ALTAAnalysisOptions_Class|ALTAAnalysisOptions]]''' object, which represents the analysis settings of the accelerated life testing data analysis. Read-Only.
|-
|GeneralSettings||References the '''[[ALTAGeneralOptions_Class|ALTAGeneralOptions]]''' object, which represents the calculation settings for the cumulative damage life-stress model. Read-Only.
|}


'''Data Set Properties'''
*DatasetName (as ''string'') {{APIComment|{{Template:ALTADataSet.DatasetName.Cmt}}}}
*FailureCount (as ''integer'') {{APIComment|{{Template:WeibullDataSet.FailureCount.Cmt}}}} <!--Shared with WeibullDataSet-->
*SuspensionCount (as ''integer'') {{APIComment|{{Template:WeibullDataSet.SuspensionCount.Cmt}}}} <!--Shared with WeibullDataSet-->
*NumStresses (as ''integer'') {{APIComment|{{Template:ALTADataSet.NumStresses.Cmt}}}}


== Events ==
==Events==
The [[ALTAEvents Class|ALTAEvents]] class contains {{Template:ALTAEvents_Class.Cmt}} <!--Comment shared with ALTADataSet_Class-->
{| {{APITable}}
*[[ALTAEvents.Message|Message( ALTADataSet, String, String,  Boolean )]] {{APIComment|{{Template:WeibullEvents.Message.Cmt}}}}  
|-
*[[ALTAEvents.Question|Question( ALTADataSet, String, MsgBoxStyle, MsgBoxResult )]] {{APIComment|{{Template:WeibullEvents.Question.Cmt}}}}
| style="width: 200px;"|[[ALTADataSet.HideCalculationProgress|HideCalculationProgress]]||{{:ALTADataSet.HideCalculationProgress}}
*[[ALTAEvents.UpdateCalculationProgress|UpdateCalculationProgress( ALTADataSet, String, String, Double, Boolean, Long, Boolean ) ]]{{APIComment|{{Template:WeibullEvents.UpdateCalculationProgress.Cmt}}}}
|-
*[[ALTAEvents.ShowCalculationProgress|ShowCalculationProgress( ALTADataSet )]]{{APIComment|{{Template:WeibullEvents.ShowCalculationProgress.Cmt}}}}  
|[[ALTADataSet.Message|Message]]||{{:ALTADataSet.Message}}
*[[ALTAEvents.HideCalculationProgress|HideCalculationProgress( ALTADataSet )]]{{APIComment|{{Template:WeibullEvents.HideCalculationProgress.Cmt}}}}
|-
 
|[[ALTADataSet.ShowCalculationProgress|ShowCalculationProgress]]||{{:ALTADataSet.ShowCalculationProgress}}
== Usage Example ==
|-
{{APIComment|Declare the ALTADataSet.}}
|[[ALTADataSet.UpdateCalculationProgress|UpdateCalculationProgress]]||{{:ALTADataSet.UpdateCalculationProgress}}
        Dim ALTADS as New ALTADataSet
|}
 
{{APIComment|Declare an [[ALTAStressProfile Class|ALTAStressProfile]] so stress levels can vary with time.}}
        Dim sp = New ALTAStressProfile("Profile1")
        sp.RepeatCycle = True
        sp.AddSegment(1, 250)
        sp.AddSegment(2, 300)
        sp.AddSegment(3, 400)
 
{{APIComment|Add failure values to the data set. Each failure is obtained during time-varying stress levels.}}
        ALTADS.AddFailure(1, 1, sp)
        ALTADS.AddFailure(2, 1, sp)
        ALTADS.AddFailure(3, 1, sp)
 
{{APIComment|Add suspension values to the data set.}}
        ALTADS.AddSuspension(1, 1, sp)
        ALTADS.AddSuspension(2, 1, sp)
        ALTADS.AddSuspension(3, 1, sp)
 
{{APIComment|Get the number of failures and suspensions for later use.}}
        Dim NumberOfFailures as Integer
        NumberOfFailures = ALTADataSet.FailureCount
        Dim NumberOfSuspension as Integer
        NumberOfSuspension = ALTADS.SuspensionCount
       
{{APIComment|Calculate the ALTADataSet. See [[ALTADataSet.Calculate|Calculate]] for additional details.}}
        ALTADS.Calculate
 
{{APIComment|Use ClearDataSet to clear data and fitted model. See [[ALTADataSet.ClearDataSet|ClearDataSet]] for additional details.}}}}
        ALTADS.ClearDataSet

Latest revision as of 17:11, 12 March 2019

APIWiki.png


Member of: SynthesisAPI

Other Versions: Version 10


Represents a data set for accelerated life testing data analysis.

Constructor

Name Description
ALTADataSet Creates an instance of the ALTADataSet class.
ALTADataSet() A parameterized constructor for the ALTADataSet class (.NET only)


Method

Name Description
AddFailure Adds a failure time to the data set.
AddFailureInterval Adds interval censored failures to the data set.
AddFreeForm Adds a failure time at the specified percent to the data set.
AddStressDefinition Adds a stress type to the data set.
AddStressProfile Adds a cProfile object, which represents a time-dependent stress profile, to the data set. Applies to the cumulative damage (CD) model only.
AddSuspension Adds suspensions to the data set.
AddSuspensionInterval Adds interval censored suspensions to the data set.
Calculate Fits a life distribution and life-stress relationship to the current data set, and creates a cModel object that represents the fitted model.
ClearDataSet Clears all data in the data set and removes the fitted model, if any.


Properties

Name Description
AnalysisResults Gets the ALTAAnalysisResults object that represents the likelihood function value estimated from the accelerated life testing data analysis.
Calculated Indicates whether the data set has been analyzed. Boolean. Read only.
DatasetName Gets or sets the name of the data set. String. If no name has been specified, the default name is "Set 1."
FailureCount Gets the total number of failures in the data set. Integer.
FittedModel References the cModel object that represents the fitted model of the accelerated life testing data analysis. From the cModel object, you can obtain results such as the reliability, mean time, failure rate, etc.
NumStresses Gets the total number of stresses in the data set. Integer.
PlotUseStress Sets the use stress value to be plotted (does not affect results of calculations). Double. The Index parameter is an integer that specifies the stress index, where 0 = first stress, 1 = second stress, etc.
StressRelation(Index) Gets or sets a value from the ALTASolverLSR enumeration, which specifies the stress transformation of a particular stress. Default value = 0 (exponential life-stress relationship). The Index parameter is an integer that specifies the stress index, where 0 = first stress, 1 = second stress, etc. This property applies to the general log-linear (GLL) or cumulative damage (CD) model only.
SuspensionCount Gets the total number of suspensions in the data set. Integer.
UseCalculationProgress Indicates whether to display the progress bar while analyzing the data set. Boolean. Default value = True.
UseEvents Indicates whether to enable user-defined event procedures for the ALTADataSet object. Boolean. Default value = False.


Fields

Name Description
AnalysisSettings References the ALTAAnalysisOptions object, which represents the analysis settings of the accelerated life testing data analysis. Read-Only.
GeneralSettings References the ALTAGeneralOptions object, which represents the calculation settings for the cumulative damage life-stress model. Read-Only.


Events

Name Description
HideCalculationProgress Occurs when the calculation process is running. Hides the progress bar.
Message Occurs when an error is produced. Displays an error message.
ShowCalculationProgress Occurs when the calculation process is running. Displays a progress bar.
UpdateCalculationProgress Occurs when the calculation process is running. Displays messages regarding the progress of the calculations.