SetFrictionIsolator Method

cPropLink SetFrictionIsolator Method

CSi API ETABS 2015

Initializes a friction isolator-type link property. If this function is called for an existing link property, all items for the property are reset to their default value.

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

Syntax

C++

Copy to Clipboard Print

int SetFrictionIsolator(
	string Name,
	ref bool[] DOF,
	ref bool[] Fixed,
	ref bool[] Nonlinear,
	ref double[] Ke,
	ref double[] Ce,
	ref double[] K,
	ref double[] Slow,
	ref double[] Fast,
	ref double[] Rate,
	ref double[] Radius,
	double Damping,
	double DJ2,
	double DJ3,
	string Notes = "",
	string GUID = ""
)

int SetFrictionIsolator(
	string Name,
	ref bool[] DOF,
	ref bool[] Fixed,
	ref bool[] Nonlinear,
	ref double[] Ke,
	ref double[] Ce,
	ref double[] K,
	ref double[] Slow,
	ref double[] Fast,
	ref double[] Rate,
	ref double[] Radius,
	double Damping,
	double DJ2,
	double DJ3,
	string Notes = "",
	string GUID = ""
)

Function SetFrictionIsolator ( _
	Name As String, _
	ByRef DOF As Boolean(), _
	ByRef Fixed As Boolean(), _
	ByRef Nonlinear As Boolean(), _
	ByRef Ke As Double(), _
	ByRef Ce As Double(), _
	ByRef K As Double(), _
	ByRef Slow As Double(), _
	ByRef Fast As Double(), _
	ByRef Rate As Double(), _
	ByRef Radius As Double(), _
	Damping As Double, _
	DJ2 As Double, _
	DJ3 As Double, _
	Optional Notes As String = "", _
	Optional GUID As String = "" _
) As Integer

Function SetFrictionIsolator ( _
	Name As String, _
	ByRef DOF As Boolean(), _
	ByRef Fixed As Boolean(), _
	ByRef Nonlinear As Boolean(), _
	ByRef Ke As Double(), _
	ByRef Ce As Double(), _
	ByRef K As Double(), _
	ByRef Slow As Double(), _
	ByRef Fast As Double(), _
	ByRef Rate As Double(), _
	ByRef Radius As Double(), _
	Damping As Double, _
	DJ2 As Double, _
	DJ3 As Double, _
	Optional Notes As String = "", _
	Optional GUID As String = "" _
) As Integer

int SetFrictionIsolator(
	String^ Name, 
	array<bool>^% DOF, 
	array<bool>^% Fixed, 
	array<bool>^% Nonlinear, 
	array<double>^% Ke, 
	array<double>^% Ce, 
	array<double>^% K, 
	array<double>^% Slow, 
	array<double>^% Fast, 
	array<double>^% Rate, 
	array<double>^% Radius, 
	double Damping, 
	double DJ2, 
	double DJ3, 
	String^ Notes = L"", 
	String^ GUID = L""
)

int SetFrictionIsolator(
	String^ Name, 
	array<bool>^% DOF, 
	array<bool>^% Fixed, 
	array<bool>^% Nonlinear, 
	array<double>^% Ke, 
	array<double>^% Ce, 
	array<double>^% K, 
	array<double>^% Slow, 
	array<double>^% Fast, 
	array<double>^% Rate, 
	array<double>^% Radius, 
	double Damping, 
	double DJ2, 
	double DJ3, 
	String^ Notes = L"", 
	String^ GUID = L""
)

Parameters

Name: Type: System String
The name of an existing or new link property. If this is an existing property, that property is modified; otherwise, a new property is added

DOF: Type: System Boolean

Fixed

Type:

System Boolean
This is a boolean array, dimensioned to 5, indicating if the specified degree of freedom is fixed (restrained).

Value	Fixity
Fixed(0)	U1 fixity if DOF(0) = True
Fixed(1)	U2 fixity if DOF(1) = True
Fixed(2)	U3 fixity if DOF(2) = True
Fixed(3)	R1 fixity if DOF(3) = True
Fixed(4)	R2 fixity if DOF(4) = True
Fixed(5)	R3 fixity if DOF(5) = True

Nonlinear

Type:

System Boolean
This is a boolean array, dimensioned to 5, indicating if nonlinear properties exist for a specified degree of freedom.

Value	Nonlinear
Nonlinear(0)	U1 has nonlinear properties
Nonlinear(1)	U2 has nonlinear properties
Nonlinear(2)	U3 has nonlinear properties
Nonlinear(3)	R1, not used
Nonlinear(4)	R2, not used
Nonlinear(5)	R3, not used

Note that this item is applicable only for degrees of freedom U1, U2 and U3. For those degrees of freedom, the term Nonlinear(n) applies only when DOF(n) = True and Fixed(n) = False.

Ke: Type: System Double

Ce: Type: System Double

K: Type: System Double

Slow

Type:

System Double
This is an array of the friction coefficient at zero velocity terms for the link property. This coefficient applies for nonlinear analyses.

Value	Slow
Slow(0)	U1, not used
Slow(1)	U2
Slow(2)	U3
Slow(3)	R1, not used
Slow(4)	R2, not used
Slow(5)	R3, not used

Note that this item is applicable only for degrees of freedom U2 and U3. For those degrees of freedom, the term Slow(n) applies only when DOF(n) = True, Fixed(n) = False, and Nonlinear(n) = True.

Fast

Type:

System Double
This is an array of the friction coefficient at fast velocity terms for the link property. This coefficient applies for nonlinear analyses.

Value	Fast
Fast(0)	U1, not used
Fast(1)	U2
Fast(2)	U3
Fast(3)	R1, not used
Fast(4)	R2, not used
Fast(5)	R3, not used

Note that this item is applicable only for degrees of freedom U2 and U3. For those degrees of freedom, the term Fast(n) applies only when DOF(n) = True, Fixed(n) = False, and Nonlinear(n) = True.

Rate

Type:

System Double
This is an array of the inverse of the characteristic sliding velocity terms for the link property. This item applies for nonlinear analyses.

Value	Rate
Rate(0)	U1, not used
Rate(1)	U2 [s/L]
Rate(2)	U3 [s/L]
Rate(3)	R1, not used
Rate(4)	R2, not used
Rate(5)	R3, not used

Note that this item is applicable only for degrees of freedom U2 and U3. For those degrees of freedom, the term Fast(n) applies only when DOF(n) = True, Fixed(n) = False, and Nonlinear(n) = True.

Radius

Type:

System Double
This is an array of the radius of the sliding contact surface terms for the link property. Inputting 0 means there is an infinite radius, that is, the slider is flat. This item applies for nonlinear analyses.

Value	Radius
Radius(0)	U1, not used
Radius(1)	U2 [L]
Radius(2)	U3 [L]
Radius(3)	R1, not used
Radius(4)	R2, not used
Radius(5)	R3, not used

Note that this item is applicable only for degrees of freedom U2 and U3. For those degrees of freedom, the term Fast(n) applies only when DOF(n) = True, Fixed(n) = False, and Nonlinear(n) = True.

Damping: Type: System Double

DJ2: Type: System Double

DJ3: Type: System Double

Notes (Optional): Type: System String

GUID (Optional): Type: System String
The GUID (global unique identifier), if any, assigned to the property. If this item is input as Default, the program assigns a GUID to the property.

Return Value

Returns zero if the property is successfully initialized; 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 MyDOF() As Boolean 
       Dim MyFixed() As Boolean 
       Dim MyNonLinear() as Boolean 
       Dim MyKe() As Double 
       Dim MyCe() As Double 
       Dim MyK() As Double 
       Dim MySlow() As Double 
       Dim MyFast() As Double 
       Dim MyRate() As Double 
       Dim MyRadius() 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)

   'add link property 
       ReDim MyDOF(5)
       ReDim MyFixed(5)
       ReDim MyNonLinear(5)
       ReDim MyKe(5)
       ReDim MyCe(5)
       ReDim MyK(5)
       ReDim MySlow(5)
       ReDim MyFast(5)
       ReDim MyRate(5)
       ReDim MyRadius(5)

       MyDOF(0) = True
       MyKe(0) = 12
       MyCe(0) = 0.01

       MyDOF(1) = True
       MyNonLinear(1) = True
       MyKe(1) = 12
       MyCe(1) = 0.01
       MyK(1) = 20
       MySlow(1)= 0.6
       MyFast(1)= 0.5
       MyRate(1)= 10
       MyRadius(1)= 80

       MyDOF(2) = True
       MyNonLinear(2) = True
       MyKe(2) = 14
       MyCe(2) = 0.008
       MyK(2) = 22
       MySlow(2)= 0.66
       MyFast(2)= 0.55
       MyRate(2)= 12
       MyRadius(2)= 75

       MyDOF(3) = True
       MyKe(3) = 15
       MyCe(3) = 0

       MyDOF(4) = True
       MyFixed(4) = True

       ret = SapModel.PropLink.SetFrictionIsolator("FI1", MyDOF, MyFixed, MyNonLinear, MyKe, MyCe, MyK, MySlow, MyFast, MyRate, MyRadius, 0.1, 2, 3)

   '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 MyDOF() As Boolean 
       Dim MyFixed() As Boolean 
       Dim MyNonLinear() as Boolean 
       Dim MyKe() As Double 
       Dim MyCe() As Double 
       Dim MyK() As Double 
       Dim MySlow() As Double 
       Dim MyFast() As Double 
       Dim MyRate() As Double 
       Dim MyRadius() 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)

   'add link property 
       ReDim MyDOF(5)
       ReDim MyFixed(5)
       ReDim MyNonLinear(5)
       ReDim MyKe(5)
       ReDim MyCe(5)
       ReDim MyK(5)
       ReDim MySlow(5)
       ReDim MyFast(5)
       ReDim MyRate(5)
       ReDim MyRadius(5)

       MyDOF(0) = True
       MyKe(0) = 12
       MyCe(0) = 0.01

       MyDOF(1) = True
       MyNonLinear(1) = True
       MyKe(1) = 12
       MyCe(1) = 0.01
       MyK(1) = 20
       MySlow(1)= 0.6
       MyFast(1)= 0.5
       MyRate(1)= 10
       MyRadius(1)= 80

       MyDOF(2) = True
       MyNonLinear(2) = True
       MyKe(2) = 14
       MyCe(2) = 0.008
       MyK(2) = 22
       MySlow(2)= 0.66
       MyFast(2)= 0.55
       MyRate(2)= 12
       MyRadius(2)= 75

       MyDOF(3) = True
       MyKe(3) = 15
       MyCe(3) = 0

       MyDOF(4) = True
       MyFixed(4) = True

       ret = SapModel.PropLink.SetFrictionIsolator("FI1", MyDOF, MyFixed, MyNonLinear, MyKe, MyCe, MyK, MySlow, MyFast, MyRate, MyRadius, 0.1, 2, 3)

   'close ETABS
       EtabsObject.ApplicationExit(False)

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