Assigns beam rebar data to frame sections.
Namespace: ETABS2015Assembly: ETABS2015 (in ETABS2015.dll) Version: 15.0.0.0 (15.0.0.0)
int SetRebarBeam(
string Name,
string MatPropLong,
string MatPropConfine,
double CoverTop,
double CoverBot,
double TopLeftArea,
double TopRightArea,
double BotLeftArea,
double BotRightArea
)
Function SetRebarBeam ( _
Name As String, _
MatPropLong As String, _
MatPropConfine As String, _
CoverTop As Double, _
CoverBot As Double, _
TopLeftArea As Double, _
TopRightArea As Double, _
BotLeftArea As Double, _
BotRightArea As Double _
) As Integer
int SetRebarBeam(
String^ Name,
String^ MatPropLong,
String^ MatPropConfine,
double CoverTop,
double CoverBot,
double TopLeftArea,
double TopRightArea,
double BotLeftArea,
double BotRightArea
)
Parameters
- Name
- Type:
System String
The name of an existing frame section property.
- MatPropLong
- Type: System String
The name of the rebar material property for the longitudinal rebar.
- MatPropConfine
- Type: System String
The name of the rebar material property for the confinement rebar.
- CoverTop
- Type: System Double
The distance from the top of the beam to the centroid of the top
longitudinal reinforcement. [L]
- CoverBot
- Type: System Double
The distance from the bottom of the beam to the centroid of the
bottom longitudinal reinforcement. [L]
- TopLeftArea
- Type: System Double
The total area of longitudinal reinforcement at the
top left end of the beam. [L2]
- TopRightArea
- Type: System Double
The total area of longitudinal reinforcement at the
top right end of the beam. [L2]
- BotLeftArea
- Type: System Double
The total area of longitudinal reinforcement at the
bottom left end of the beam. [L2]
- BotRightArea
- Type: System Double
The total area of longitudinal reinforcement at the
bottom right end of the beam. [L2]
Return Value
Returns zero if the rebar data is successfully assigned;
otherwise it returns a nonzero value.
This function applies only to the following section types. Calling this function for any other type of frame section property returns an error.
The material assigned to the specified frame section property must be concrete or this function returns an error.
Public Sub Example()
Dim SapModel As cSapModel
Dim EtabsObject As cOAPI
Dim ret As Integer = -1
Dim RebarName As String
EtabsObject = CreateObject("CSI.ETABS.API.ETABSObject")
ret = EtabsObject.ApplicationStart()
SapModel = EtabsObject.SapModel
ret = SapModel.InitializeNewModel()
ret = SapModel.File.NewSteelDeck(4,12,12,4,4,24,24)
ret = SapModel.PropFrame.SetRectangle("R1", "4000Psi", 20, 12)
ret = SapModel.PropMaterial.AddQuick(RebarName, ETABS2013.eMatType.Rebar, , , , , ETABS2013.eMatTypeRebar.ASTM_A706)
ret = SapModel.PropFrame.SetRebarBeam("R1", RebarName, RebarName, 3.5, 3, 4.1, 4.2, 4.3, 4.4)
EtabsObject.ApplicationExit(False)
SapModel = Nothing
EtabsObject = Nothing
End SubPublic Sub Example()
Dim SapModel As cSapModel
Dim EtabsObject As cOAPI
Dim ret As Integer = -1
Dim RebarName As String
'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)
'set new frame section property
ret = SapModel.PropFrame.SetRectangle("R1", "4000Psi", 20, 12)
'add ASTM A706 rebar material
ret = SapModel.PropMaterial.AddQuick(RebarName, ETABS2013.eMatType.Rebar, , , , , ETABS2013.eMatTypeRebar.ASTM_A706)
'set beam rebar data
ret = SapModel.PropFrame.SetRebarBeam("R1", RebarName, RebarName, 3.5, 3, 4.1, 4.2, 4.3, 4.4)
'close ETABS
EtabsObject.ApplicationExit(False)
'clean up variables
SapModel = Nothing
EtabsObject = Nothing
End Sub