GetORebar Method

cPropMaterial GetORebar Method

CSi API ETABS 2015

(NEWER FUNCTION AVAILABLE) Retrieves the other material property data for rebar materials.

Namespace: ETABS2015
Assembly: ETABS2015 (in ETABS2015.dll) Version: 15.0.0.0 (15.0.0.0)

Syntax

int GetORebar(
	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 StrainUltimate,
	ref bool UseCaltransSSDefaults,
	double Temp = 0
)

int GetORebar(
	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 StrainUltimate,
	ref bool UseCaltransSSDefaults,
	double Temp = 0
)

Function GetORebar ( _
	Name As String, _
	ByRef Fy As Double, _
	ByRef Fu As Double, _
	ByRef EFy As Double, _
	ByRef EFu As Double, _
	ByRef SSType As Integer, _
	ByRef SSHysType As Integer, _
	ByRef StrainAtHardening As Double, _
	ByRef StrainUltimate As Double, _
	ByRef UseCaltransSSDefaults As Boolean, _
	Optional Temp As Double = 0 _
) As Integer

Function GetORebar ( _
	Name As String, _
	ByRef Fy As Double, _
	ByRef Fu As Double, _
	ByRef EFy As Double, _
	ByRef EFu As Double, _
	ByRef SSType As Integer, _
	ByRef SSHysType As Integer, _
	ByRef StrainAtHardening As Double, _
	ByRef StrainUltimate As Double, _
	ByRef UseCaltransSSDefaults As Boolean, _
	Optional Temp As Double = 0 _
) As Integer

int GetORebar(
	String^ Name, 
	double% Fy, 
	double% Fu, 
	double% EFy, 
	double% EFu, 
	int% SSType, 
	int% SSHysType, 
	double% StrainAtHardening, 
	double% StrainUltimate, 
	bool% UseCaltransSSDefaults, 
	double Temp = 0
)

int GetORebar(
	String^ Name, 
	double% Fy, 
	double% Fu, 
	double% EFy, 
	double% EFu, 
	int% SSType, 
	int% SSHysType, 
	double% StrainAtHardening, 
	double% StrainUltimate, 
	bool% UseCaltransSSDefaults, 
	double Temp = 0
)

Parameters

Name: Type: System String
The name of an existing rebar material property.

Fy: Type: System Double

Fu: Type: System Double
The minimum tensile stress. [F/L2]

EFy: Type: System Double

EFu: Type: System Double

SSType

Type:

System Int32
This is 0, 1 or 2, indicating the stress-strain curve type.

Value	SSType
0	User defined
1	Parametric - Simple
2	Parametric - Park

SSHysType

Type:

System Int32
This is 0 through 7, indicating the stress-strain curve type.

Value	SSHysType
0	Elastic
1	Kinematic
2	Takeda
3	Pivot
4	Concrete
5	BRB Hardening
6	Degrading
7	Isotropic

StrainAtHardening: Type: System Double
This item applies only when parametric stress-strain curves are used and when UseCaltransSSDefaults is False. It is the strain at the onset of strain hardening.

StrainUltimate: Type: System Double
This item applies only when parametric stress-strain curves are used and when UseCaltransSSDefaults is False. It is the ultimate strain capacity. This item must be larger than the StrainAtHardening item.

UseCaltransSSDefaults: Type: System Boolean
If this item is True, the program uses Caltrans default controlling strain values, which are bar size dependent.

Temp (Optional): Type: System Double
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

Returns zero if the data is successfully retrieved; otherwise it returns a nonzero value.

Remarks

Examples

C++

Copy to Clipboard Print

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 StrainUltimate As Double 
       Dim UseCaltransSSDefaults As Boolean 

   '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("Rebar", ETABS2013.eMatType.Rebar)

   'assign other properties
       ret = SapModel.PropMaterial.SetORebar("Rebar", 62, 93, 70, 102, 2, 2, 0.02, 0.1, False)

   'get other properties
       ret = SapModel.PropMaterial.GetORebar("Rebar", Fy, Fu, eFy, eFu, SSType, SSHysType, StrainAtHardening, StrainUltimate, UseCaltransSSDefaults)

   'close ETABS
       EtabsObject.ApplicationExit(False)

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

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 StrainUltimate As Double 
       Dim UseCaltransSSDefaults As Boolean 

   '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("Rebar", ETABS2013.eMatType.Rebar)

   'assign other properties
       ret = SapModel.PropMaterial.SetORebar("Rebar", 62, 93, 70, 102, 2, 2, 0.02, 0.1, False)

   'get other properties
       ret = SapModel.PropMaterial.GetORebar("Rebar", Fy, Fu, eFy, eFu, SSType, SSHysType, StrainAtHardening, StrainUltimate, UseCaltransSSDefaults)

   'close ETABS
       EtabsObject.ApplicationExit(False)

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