ALTADataSet.AddFailure: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
(Undo revision 65393 by David J. Groebel (Talk))
 
(52 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Template:APIClass|ALTADataSet Class|ALTADataSet}}
{{Template:API}}{{Template:APIBreadcrumb|.[[ALTADataSet_Class|ALTADataSet]]}}<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.AddFailure 10|Version 10]]</span></div>


Inserts a failure point to the ALTADataSet.


== Method Syntax ==
<onlyinclude>Adds a failure time to the data set.</onlyinclude>
{{APIName|AddFailure(}}
{{APIPrefix|ByVal}}
{{APIName|Value}}
{{APIPrefix|As Double}}
{{APIName|,}}
{{APIPrefix|ByVal}}
{{APIName|NumberInGroup}}
{{APIPrefix|As Integer}}
{{APIName|,}}
{{APIPrefix|ByRef}}
{{APIName|Stress()}}
{{APIPrefix|As Object}}
{{APIName|)}}


{{APIName|AddFailure(}}
==Syntax==
{{APIPrefix|ByVal}}
'''VBA'''
{{APIName|Value}}
{{APIPrefix|As Double}}
'''.AddFailure'''(''Value'', ''NumberinGroup'', {{APIPrefix|ByRef}} ''Stress()'')
{{APIName|,}}
{{APIPrefix|ByVal}}
'''.AddFailure_2'''(''Value'', ''NumberinGroup'', ''Stress1'')
{{APIName|NumberInGroup}}
{{APIPrefix|As Integer}}
'''.AddFailure_3'''(''Value'', ''NumberinGroup'', ''Stress1'', ''Stress2'')
{{APIName|,}}
{{APIPrefix|ByRef}}
{{APIName|Stress1}}
{{APIPrefix|As Object}}
{{APIName|)}}


{{APIName|AddFailure(}}
'''VB.NET'''
{{APIPrefix|ByVal}}
{{APIName|Value}}
'''.AddFailure'''(''Value'', ''NumberinGroup'', {{APIPrefix|ByRef}} ''Stress()'')
{{APIPrefix|As Double}}
{{APIName|,}}
'''.AddFailure'''(''Value'', ''NumberinGroup'', ''Stress1'')
{{APIPrefix|ByVal}}
{{APIName|NumberInGroup}}
'''.AddFailure'''(''Value'', ''NumberinGroup'', ''Stress1'', ''Stress2'')
{{APIPrefix|As Integer}}
{{APIName|,}}
{{APIPrefix|ByRef}}
{{APIName|Stress1, Stress2}}
{{APIPrefix|As Object}}
{{APIName|)}}
<br> {{APIComment|Adds a failure data point to the collection of data points in the data set.}}


== Parameters ==
===Parameters===
'''Value'''
''Value''
The failure point in time.
:Required. Double. The exact time of failure.  


'''NumberInGroup'''
''NumberinGroup''
The number of units that failed at the '''Value''' time.
:Required. Integer. The number of failed units at the time of failure.  


'''Stress()'''
''Stress()''
An array of numeric values or references to [[ALTAStressProfile Class|ALTAStressProfiles]] already entered into the ALTADataSet
:Required. Object. Can be an array of numeric stress values or [[CProfile_Class|cProfile]] objects.


'''Stress1'''
''Stress1''
An numeric value or a reference to an [[ALTAStressProfile Class|ALTAStressProfile]]
:Required. Object. The stress value for the first stress definition. Can be a numeric stress value or [[CProfile_Class|cProfile]] object.


'''Stress2'''
''Stress2''
An numeric value or a reference to an [[ALTAStressProfile Class|ALTAStressProfile]]
:Required. Object. The stress value for the second stress definition. Can be a numeric stress value or [[CProfile_Class|cProfile]] object.


{{APIComment|Adds a failure data point to the collection of data points in the data set.}}


== Usage Example ==
== Example ==
The following example demonstrates how to add failure times to an ALTADataSet object.


{{APIComment|Declare the ALTADataSet. See [[New ALTADataSet]] for additional details.}}
'''VBA'''
        Dim ALTADS as New ALTADataSet
{{APIComment|'Declare a new ALTADataSet object.}}
  {{APIPrefix|Dim}} ADS {{APIPrefix|As New}} ALTADataSet
 
{{APIComment|'Define a stress type with use stress level &#61; 10.}}
  {{APIPrefix|Call}} ADS.AddStressDefinition({{APIString|"Stress1"}},,10)
 
{{APIComment|'Add failure times for Stress1 &#61; 190.}}
  {{APIPrefix|Call}} ADS.AddFailure_2(100, 1, 190)
  {{APIPrefix|Call}} ADS.AddFailure_2(120, 1, 190)
  {{APIPrefix|Call}} ADS.AddFailure_2(130, 1, 190)


{{APIComment|Declare an [[ALTAStressProfile Class|ALTAStressProfile]]. See [[ALTAStressProfile Class|ALTAStressProfile]] for additional details.}}
'''VB.NET'''
        Dim sp = New ALTAStressProfile("Profile1")
 
        sp.RepeatCycle = True
{{APIComment|'Declare a new ALTADataSet object.}}
        sp.AddSegment(1, 250)
  {{APIPrefix|Dim}} ADS {{APIPrefix|As New}} ALTADataSet
        sp.AddSegment(2, 300)
 
        sp.AddSegment(3, 400)
{{APIComment|'Define a stress type with use stress level &#61; 10.}}
  ADS.AddStressDefinition({{APIString|"Stress1"}},,10)
 
{{APIComment|'Add failure times for Stress1 &#61; 190.}}
  ADS.AddFailure(100, 1, 190)
  ADS.AddFailure(120, 1, 190)
  ADS.AddFailure(130, 1, 190)


{{APIComment|Add values to the raw data.}}
        ALTADS.AddFailure(1, 1, sp)
        ALTADS.AddFailure(2, 1, sp)
        ALTADS.AddFailure(3, 1, sp)


{{APIComment|Get the number of failures. In this example, NumberOfFailures will be 3.}}
== See Also ==
        Dim NumberOfFailures as Integer
*[[ALTADataSet.AddStressProfile|ALTADataSet.AddStressProfile Method]]
        NumberOfFailures = ALTADS.FailureCount

Latest revision as of 19:39, 10 August 2018

APIWiki.png


Member of: SynthesisAPI.ALTADataSet

Other Versions: Version 10


Adds a failure time to the data set.

Syntax

VBA

.AddFailure(Value, NumberinGroup, ByRef Stress())

.AddFailure_2(Value, NumberinGroup, Stress1)

.AddFailure_3(Value, NumberinGroup, Stress1, Stress2)
VB.NET

.AddFailure(Value, NumberinGroup, ByRef Stress())

.AddFailure(Value, NumberinGroup, Stress1)

.AddFailure(Value, NumberinGroup, Stress1, Stress2)

Parameters

Value

Required. Double. The exact time of failure.

NumberinGroup

Required. Integer. The number of failed units at the time of failure.

Stress()

Required. Object. Can be an array of numeric stress values or cProfile objects.

Stress1

Required. Object. The stress value for the first stress definition. Can be a numeric stress value or cProfile object.

Stress2

Required. Object. The stress value for the second stress definition. Can be a numeric stress value or cProfile object.


Example

The following example demonstrates how to add failure times to an ALTADataSet object.

VBA

 'Declare a new ALTADataSet object.  
  Dim ADS As New ALTADataSet
 
 'Define a stress type with use stress level = 10. 
  Call ADS.AddStressDefinition("Stress1",,10)
 
 'Add failure times for Stress1 = 190. 
  Call ADS.AddFailure_2(100, 1, 190)
  Call ADS.AddFailure_2(120, 1, 190)
  Call ADS.AddFailure_2(130, 1, 190)
VB.NET
 
 'Declare a new ALTADataSet object.  
  Dim ADS As New ALTADataSet
 
 'Define a stress type with use stress level = 10. 
  ADS.AddStressDefinition("Stress1",,10)
 
 'Add failure times for Stress1 = 190. 
  ADS.AddFailure(100, 1, 190)
  ADS.AddFailure(120, 1, 190)
  ADS.AddFailure(130, 1, 190)


See Also