ALTADataSet.AddSuspension: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
(Created page with '{{Template:APIClass|ALTADataSet Class|ALTADataSet}} Inserts a suspension point to the ALTADataSet. == Method Syntax == {{APIName|AddSuspension(}} {{APIPrefix|ByVal}} {{APIName|…')
 
No edit summary
 
(19 intermediate revisions by 3 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.AddSuspension 10|Version 10]]</span></div>


Inserts a suspension point to the ALTADataSet.


== Method Syntax ==
<onlyinclude>Adds suspensions to the data set.</onlyinclude>
{{APIName|AddSuspension(}}
{{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|AddSuspension(}}
==Syntax==
{{APIPrefix|ByVal}}
'''VBA'''
{{APIName|Value}}
{{APIPrefix|As Double}}
'''.AddSuspension'''(''Value'', ''NumberinGroup'', {{APIPrefix|ByRef}} ''Stress()'')
{{APIName|,}}
{{APIPrefix|ByVal}}
'''.AddSuspension_2'''(''Value'', ''NumberinGroup'', ''Stress1'')
{{APIName|NumberInGroup}}
{{APIPrefix|As Integer}}
'''.AddSuspension_3'''(''Value'', ''NumberinGroup'', ''Stress1'', ''Stress2'')
{{APIName|,}}
{{APIPrefix|ByRef}}
{{APIName|Stress1}}
{{APIPrefix|As Object}}
{{APIName|)}}


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


== Parameters ==
===Parameters===
'''Value'''
''Value''
The suspension point in time.
:Required. Double. The suspension time.  


'''NumberInGroup'''
''NumberinGroup''
The number of units that were suspended at the '''Value''' time.
:Required. Integer. The number of suspended units at the time of suspension.  


'''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 suspension data point to the collection of data points in the data set.}}


== Usage Example ==
== Example ==
The following example demonstrates how to add suspensions 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 suspensions for Stress1 &#61; 190.}}
  {{APIPrefix|Call}} ADS.AddSuspension_2(100, 1, 190)
  {{APIPrefix|Call}} ADS.AddSuspension_2(120, 1, 190)
  {{APIPrefix|Call}} ADS.AddSuspension_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 suspensions for Stress1 &#61; 190.}}
  ADS.AddSuspension(100, 1, 190)
  ADS.AddSuspension(120, 1, 190)
  ADS.AddSuspension(130, 1, 190)


{{APIComment|Add values to the raw data.}}
== See Also ==
        ALTADS.AddSuspension(1, 1, sp)
*[[ALTADataSet.AddStressProfile|ALTADataSet.AddStressProfile Method]]
        ALTADS.AddSuspension(2, 1, sp)
        ALTADS.AddSuspension(3, 1, sp)
 
{{APIComment|Get the number of suspensions. In this example, NumberOfSuspension will be 3.}}
        Dim NumberOfSuspension as Integer
        NumberOfSuspension = ALTADS.SuspensionCount

Latest revision as of 23:42, 22 March 2017

APIWiki.png


Member of: SynthesisAPI.ALTADataSet

Other Versions: Version 10


Adds suspensions to the data set.

Syntax

VBA

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

.AddSuspension_2(Value, NumberinGroup, Stress1)

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

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

.AddSuspension(Value, NumberinGroup, Stress1)

.AddSuspension(Value, NumberinGroup, Stress1, Stress2)

Parameters

Value

Required. Double. The suspension time.

NumberinGroup

Required. Integer. The number of suspended units at the time of suspension.

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 suspensions 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 suspensions for Stress1 = 190. 
  Call ADS.AddSuspension_2(100, 1, 190)
  Call ADS.AddSuspension_2(120, 1, 190)
  Call ADS.AddSuspension_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 suspensions for Stress1 = 190. 
  ADS.AddSuspension(100, 1, 190)
  ADS.AddSuspension(120, 1, 190)
  ADS.AddSuspension(130, 1, 190)

See Also