ALTADataSet.AddStressDefinition: Difference between revisions

Latest revision as of 20:41, 24 June 2016

Adds a stress type to the data set.

Syntax

.AddStressDefinition(Name, StressRelation, UseStress)

Parameters

Name

Required. String. The name of the stress.

StressRelation

Optional. The stress transformation that will be applied to the stress. Applies to the general log-linear (GLL) or cumulative damage (CD) models only. Can be any ALTASolverLSR constant. Default value = 0 (exponential life-stress relationship).

UseStress

Optional. Double. The use stress level. Default value = 1.

Example

The following example demonstrates how to add stress definitions to an ALTADataSet object.

VBA

 'Declare a new ALTADataSet object.  
  Dim ADS As New ALTADataSet
 
 'Define 2 stress types with use stress levels = 10 and 25. 
  Call ADS.AddStressDefinition("Stress1",,10)
  Call ADS.AddStressDefinition("Stress2",,25)
 
 'Add failure times for Stress1 = 190 and Stress2 = 235. 
  Call ADS.AddFailure_3(100, 1, 190, 235)
  Call ADS.AddFailure_3(120, 1, 190, 235)
  Call ADS.AddFailure_3(130, 1, 190, 235)

VB.NET
 
 'Declare a new ALTADataSet object.  
  Dim ADS As New ALTADataSet
 
 'Define 2 stress types with use stress levels = 10 and 25. 
  ADS.AddStressDefinition("Stress1",,10)
  ADS.AddStressDefinition("Stress2",,25)

 'Add failure times for Stress1 = 190 and Stress2 = 235. 
  ADS.AddFailure(100, 1, 190, 235)
  ADS.AddFailure(120, 1, 190, 235)
  ADS.AddFailure(130, 1, 190, 235)

@@ Line 1: / Line 1: @@
-{{Template:APIClass|ALTADataSet Class|ALTADataSet}}
+{{Template:API}}{{Template:APIBreadcrumb|.[[ALTADataSet_Class|ALTADataSet]]}}
-{{Template:ALTADataSet.AddStressDefinition.Cmt}} The number of stress values used in subsequent calls to AddFailure, AddSuspension, etc. must be equal to the number of stress definitions in the data set (e.g., before you can add a failure time obtained with two stresses, you must add two stress definitions).
-== Syntax ==
+<onlyinclude>Adds a stress type to the data set.</onlyinclude>
-<ul><li>{{APIName|[[ALTADataSet.AddStressDefinition|AddStressDefinition]](}}
-{{APIPrefix|ByVal}}
-{{APIName|Name}}
-{{APIPrefix|As String, Optional ByVal}}
-{{APIName|StressRelation}}
-{{APIPrefix|As [[ALTASolverLSR]]}}
-=
-{{APIName|[[ALTASolverLSR]].Exponential,}}
-{{APIPrefix|Optional ByVal}}
-{{APIName|UseStress}}
-{{APIPrefix|As Double}}
-=
-{{APIName|1)}}
-</li>
-<li>
-{{APIName|[[ALTADataSet.AddStressDefinition|AddStressDefinition]](}}
-{{APIPrefix|ByVal}}
-{{APIName|Name}}
-{{APIPrefix|As String, Optional ByVal}}
-{{APIName|StressRelation}}
-{{APIPrefix|As [[ALTASolverLSR]]}}
-=
-{{APIName|[[ALTASolverLSR]].Exponential,}}
-{{APIPrefix|Optional ByVal}}
-{{APIName|UseStress}}
-{{APIPrefix|As Double}}
-=
-{{APIName|1)}}
-</li>
-</ul>
-Parameters
+==Syntax==
-:''Name'': The name of the new stress definition.
+ '''.AddStressDefinition'''(''Name'', ''StressRelation'', ''UseStress'')
-:''StressRelation'': The relation to set the new stress definition.
+===Parameters===
+''Name''
+:Required. String. The name of the stress.
-:''UseStress'': The use stress level.
+''StressRelation''
+:Optional. The stress transformation that will be applied to the stress. Applies to the general log-linear (GLL) or cumulative damage (CD) models only. Can be any [[ALTASolverLSR_Enumeration|ALTASolverLSR]] constant. Default value &#61; 0 (exponential life-stress relationship).
-== Usage Example ==
+''UseStress''
+:Optional. Double. The use stress level. Default value &#61; 1.
-{{APIComment|Declare the ALTADataSet. See [[New ALTADataSet]] for additional details.}}
- Dim ALTADS as New ALTADataSet
-{{APIComment|Add a new stress definition.}}
+== Example ==
- ADS.AddStressDefinition("NewStress1")
+The following example demonstrates how to add stress definitions to an ALTADataSet object.
-{{APIComment|Add an [[ALTAStressProfile Class|ALTAStressProfile]] with stress segments. See [[ALTAStressProfile Class|ALTAStressProfile]] for additional details.}}
+ '''VBA'''
- Dim NewStressProfile1 As New ALTAStressProfile("NewStressProfile1")
-  NewStressProfile1.RepeatCycle = True
+ {{APIComment|'Declare a new ALTADataSet object.}}
- NewStressProfile1.AddSegment(1, 250)
+   {{APIPrefix|Dim}} ADS {{APIPrefix|As New}} ALTADataSet
- NewStressProfile1.AddSegment(2, 300)
- NewStressProfile1.AddSegment(3, 400)
+ {{APIComment|'Define 2 stress types with use stress levels &#61; 10 and 25.}}
+   {{APIPrefix|Call}} ADS.AddStressDefinition({{APIString|"Stress1"}},,10)
+   {{APIPrefix|Call}} ADS.AddStressDefinition({{APIString|"Stress2"}},,25)
+  {{APIComment|'Add failure times for Stress1 &#61; 190 and Stress2 &#61; 235.}}
+   {{APIPrefix|Call}} ADS.AddFailure_3(100, 1, 190, 235)
+   {{APIPrefix|Call}} ADS.AddFailure_3(120, 1, 190, 235)
+   {{APIPrefix|Call}} ADS.AddFailure_3(130, 1, 190, 235)
-{{APIComment|Add the stress profile}}
+ '''VB.NET'''
-        ALTADS.AddStressProfile(NewStressProfile1)
+ {{APIComment|'Declare a new ALTADataSet object.}}
+   {{APIPrefix|Dim}} ADS {{APIPrefix|As New}} ALTADataSet
+ {{APIComment|'Define 2 stress types with use stress levels &#61; 10 and 25.}}
+   ADS.AddStressDefinition({{APIString|"Stress1"}},,10)
+   ADS.AddStressDefinition({{APIString|"Stress2"}},,25)
+ {{APIComment|'Add failure times for Stress1 &#61; 190 and Stress2 &#61; 235.}}
+   ADS.AddFailure(100, 1, 190, 235)
+   ADS.AddFailure(120, 1, 190, 235)
+   ADS.AddFailure(130, 1, 190, 235)

ALTADataSet.AddStressDefinition: Difference between revisions

Latest revision as of 20:41, 24 June 2016

Syntax

Parameters

Example

Navigation menu

Search