cPropMaterialGetOSteel_1 Method

Retrieves the other material property data for steel materials.

Namespace:  ETABS2016
Assembly:  ETABS2016 (in ETABS2016.dll) Version: 16.0.0.0 (16.0.0.0)
Syntax
Copy
int GetOSteel_1(
	string Name,
	ref double Fy,
	ref double Fu,
	ref double EFy,
	ref double EFu,
	ref int SSType,
	ref int SSHysType,
	ref double StrainAtHardening,
	ref double StrainAtMaxStress,
	ref double StrainAtRupture,
	ref double FinalSlope,
	double Temp = 0
)

Parameters

Name
Type: SystemString
The name of an existing steel material property.
Fy
Type: SystemDouble
Fu
Type: SystemDouble
The minimum tensile stress. [F/L2]
EFy
Type: SystemDouble
EFu
Type: SystemDouble
SSType
Type: SystemInt32
This is 0 or 1, indicating the stress-strain curve type.
ValueSSType
0User defined
1Parametric - Simple
SSHysType
Type: SystemInt32
This is 0 through 7, indicating the stress-strain curve type.
ValueSSHysType
0Elastic
1Kinematic
2Takeda
3Pivot
4Concrete
5BRB Hardening
6Degrading
7Isotropic
StrainAtHardening
Type: SystemDouble
This item applies only when parametric stress-strain curves are used. It is the strain at the onset of strain hardening.
StrainAtMaxStress
Type: SystemDouble
This item applies only when parametric stress-strain curves are used. It is the strain at the maximum stress. This item must be larger than the StrainAtHardening item.
StrainAtRupture
Type: SystemDouble
This item applies only when parametric stress-strain curves are used. It is the strain at rupture. This item must be larger than the StrainAtMaxStress item.
FinalSlope
Type: SystemDouble
This item applies only to parametric stress-strain curves. It is a multiplier on the material modulus of elasticity, E. This value multiplied times E gives the final slope of the curve.
Temp (Optional)
Type: SystemDouble
The temperature at which the specified data is to be retrieved. The temperature must have been defined previously for the material.

This item applies only if the specified material has properties that are temperature dependent. That is, it applies only if properties are specified for the material at more than one temperature.

Return Value

Type: Int32
Returns zero if the data is successfully retrieved; otherwise it returns a nonzero value.
Remarks
Examples
VB
Copy
Public Sub Example()
       Dim SapModel As cSapModel
       Dim EtabsObject As cOAPI
       Dim ret As Integer = -1
       Dim Fy As Double
       Dim Fu As Double
       Dim eFy As Double
       Dim eFu As Double
       Dim SSType As Integer
       Dim SSHysType As Integer
       Dim StrainAtHardening As Double
       Dim StrainAtMaxStress As Double
       Dim StrainAtRupture As Double
       Dim FinalSlope As Double

   'create ETABS object
       EtabsObject = CreateObject("CSI.ETABS.API.ETABSObject")

   'start ETABS application
       ret = EtabsObject.ApplicationStart()

   'create SapModel object
       SapModel = EtabsObject.SapModel

   'initialize model
       ret = SapModel.InitializeNewModel()

   'create steel deck template model
       ret = SapModel.File.NewSteelDeck(4,12,12,4,4,24,24)

   'initialize new material property
       ret = SapModel.PropMaterial.SetMaterial("Steel", eMatType.Steel)

   'assign other properties
       ret = SapModel.PropMaterial.SetOSteel_1("Steel", 55, 68, 60, 70, 1, 2, 0.02, 0.1, 0.2, -0.1)

   'get other properties
       ret = SapModel.PropMaterial.GetOSteel_1("Steel", Fy, Fu, eFy, eFu, SSType, SSHysType, StrainAtHardening, StrainAtMaxStress, StrainAtRupture, FinalSlope)

   'close ETABS
       EtabsObject.ApplicationExit(False)

   'clean up variables
       SapModel = Nothing
       EtabsObject = Nothing
   End Sub
See Also