cPropFrameSetRebarColumn Method

int SetRebarColumn(
	string Name,
	string MatPropLong,
	string MatPropConfine,
	int Pattern,
	int ConfineType,
	double Cover,
	int NumberCBars,
	int NumberR3Bars,
	int NumberR2Bars,
	string RebarSize,
	string TieSize,
	double TieSpacingLongit,
	int Number2DirTieBars,
	int Number3DirTieBars,
	bool ToBeDesigned
)

Function SetRebarColumn ( 
	Name As String,
	MatPropLong As String,
	MatPropConfine As String,
	Pattern As Integer,
	ConfineType As Integer,
	Cover As Double,
	NumberCBars As Integer,
	NumberR3Bars As Integer,
	NumberR2Bars As Integer,
	RebarSize As String,
	TieSize As String,
	TieSpacingLongit As Double,
	Number2DirTieBars As Integer,
	Number3DirTieBars As Integer,
	ToBeDesigned As Boolean
) As Integer

int SetRebarColumn(
	String^ Name, 
	String^ MatPropLong, 
	String^ MatPropConfine, 
	int Pattern, 
	int ConfineType, 
	double Cover, 
	int NumberCBars, 
	int NumberR3Bars, 
	int NumberR2Bars, 
	String^ RebarSize, 
	String^ TieSize, 
	double TieSpacingLongit, 
	int Number2DirTieBars, 
	int Number3DirTieBars, 
	bool ToBeDesigned
)

abstract SetRebarColumn : 
        Name : string * 
        MatPropLong : string * 
        MatPropConfine : string * 
        Pattern : int * 
        ConfineType : int * 
        Cover : float * 
        NumberCBars : int * 
        NumberR3Bars : int * 
        NumberR2Bars : int * 
        RebarSize : string * 
        TieSize : string * 
        TieSpacingLongit : float * 
        Number2DirTieBars : int * 
        Number3DirTieBars : int * 
        ToBeDesigned : bool -> int 

Parameters

Name

Type: SystemString
The name of an existing frame section property.

MatPropLong

Type: SystemString
The name of the rebar material property for the longitudinal rebar.

MatPropConfine

Type: SystemString
The name of the rebar material property for the confinement rebar.

Pattern

Type: SystemInt32
This is either 1 or 2, indicating the rebar configuration.

Value	Pattern
1	Rectangular
2	Circular

For circular frame section properties this item must be 2; otherwise an error is returned.

ConfineType

Type: SystemInt32
This is either 1 or 2, indicating the confinement bar type.

Value	Type
1	Ties
2	Spiral

This item applies only when Pattern = 2. If Pattern = 1, the confinement bar type is assumed to be ties.

Cover

Type: SystemDouble
The clear cover for the confinement steel (ties). In the special case of circular reinforcement in a rectangular column, this is the minimum clear cover. [L]

NumberCBars

Type: SystemInt32
This item applies to a circular rebar configuration, Pattern = 2. It is the total number of longitudinal reinforcing bars in the column.

NumberR3Bars

Type: SystemInt32
This item applies to a rectangular rebar configuration, Pattern = 1. It is the number of longitudinal bars (including the corner bar) on each face of the column that is parallel to the local 3-axis of the column.

NumberR2Bars

Type: SystemInt32
This item applies to a rectangular rebar configuration, Pattern = 1. It is the number of longitudinal bars (including the corner bar) on each face of the column that is parallel to the local 2-axis of the column.

RebarSize

Type: SystemString
The rebar name for the longitudinal rebar in the column.

TieSize

Type: SystemString
The rebar name for the confinement rebar in the column.

TieSpacingLongit

Type: SystemDouble
The longitudinal spacing of the confinement bars (ties). [L]

Number2DirTieBars

Type: SystemInt32
This item applies to a rectangular reinforcing configuration, Pattern = 1. It is the number of confinement bars (tie legs) running in the local 2-axis direction of the column.

Number3DirTieBars

Type: SystemInt32
This item applies to a rectangular reinforcing configuration, Pattern = 1. It is the number of confinement bars (tie legs) running in the local 3-axis direction of the column.

ToBeDesigned

Type: SystemBoolean
If this item is True, the column longitudinal rebar is to be designed; otherwise it is to be checked.

Return Value

• Rectangular
• Circle

The material assigned to the specified frame section property must be concrete or this function returns an error.

Examples

Public 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, eMatType.Rebar, , , , , eMatTypeRebar.ASTM_A706)

   'set column rebar data
       ret = SapModel.PropFrame.SetRebarColumn("R1", RebarName, RebarName, 2, 2, 2, 10, 0, 0, "#10", "#5", 4, 0, 0, False)

   'close ETABS
       EtabsObject.ApplicationExit(False)

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

Reference