AreaStressShellLayered

AreaStressShellLayered

Syntax

SapObject.Sap2000.Results.AreaStressShellLayered

VB6 Procedure

Function AreaStressShellLayered(ByVal name As String, ByVal ItemTypeElm As eItemTypeElm, ByRef NumberResults As Long, ByRef Obj() As String, ByRef Elm() As String, ByRef Layer() As String, ByRef IntPtNum() As Long, ByRef IntPtLoc() As Double, ByRef PointElm() As String, ByRef LoadCase() As String, ByRef StepType() As String, ByRef StepNum() As Double, ByRef S11() As Double, ByRef S22() As Double, ByRef S12() As Double, ByRef SMax() As Double, ByRef SMin() As Double, ByRef SAngle() As Double, ByRef SVM() As Double, ByRef S13Avg() As Double, ByRef S23Avg() As Double, ByRef SMaxAvg() As Double, ByRef SAngleAvg() As Double) As Long

Parameters

Name

The name of an existing area object, area element or group of objects, depending on the value of the ItemTypeElm item.

ItemTypeElm

This is one of the following items in the eItemTypeElm enumeration:

ObjectElm = 0

Element = 1

GroupElm = 2

SelectionElm = 3

If this item is ObjectElm, the result request is for the area elements corresponding to the area object specified by the Name item.

If this item is Element, the result request is for the area element specified by the Name item.

If this item is GroupElm, the result request is for the area elements corresponding to all area objects included in the group specified by the Name item.

If this item is SelectionElm, the result request is for area elements corresponding to all selected area objects and the Name item is ignored.

NumberResults

The total number of results returned by the program.

Obj

This is an array that includes the area object name associated with each result, if any.

Elm

This is an array that includes the area element name associated with each result.

Layer

This is an array that includes the layer name associated with each result.

IntPtNum

This is an array that includes the integration point number within the specified layer of the area element.

IntPtLoc

This is an array that includes the integration point relative location within the specified layer of the area element. The location is between -1 (bottom of layer) and +1 (top of layer), inclusive. The midheight of the layer is at a value of 0.

PointElm

This is an array that includes the name of the point element where the results are reported.

LoadCase

This is an array that includes the name of the analysis case or load combination associated with each result.

StepType

This is an array that includes the step type, if any, for each result. See 
Analysis Results Step Type
.

StepNum

This is an array that includes the step number, if any, for each result.See 
Analysis Results Step Number
.

S11, S22, S12

The area element internal S11, S22 and S12 stresses, at the specified point element location, for the specified layer and layer integration point, reported in the area element local coordinate system. [F/L
2
]

SMax, SMin

The area element maximum and minimum principal stresses, at the specified point element location, for the specified layer and layer integration point. [F/L
2
]

SAngle

The angle measured counter clockwise (when the local 3 axis is pointing toward you) from the area local 1 axis to the direction of the maximum principal stress. [deg]

SVM

The area element internal Von Mises stress at the specified point element location, for the specified layer and layer integration point. [F/L
2
]

S13Avg, S23Avg

The area element average S13 or S23 out-of-plane shear stress at the specified point element location, for the specified layer and layer integration point. [F/L
2
]

SMaxAvg

The area element maximum average out-of-plane shear stress for the specified layer and layer integration point. It is equal to the square root of the sum of the squares of S13Avg and S23Avg. [F/L
2
]

SAngleAvg

The angle measured counter clockwise (when the local 3 axis is pointing toward you) from the area local 1 axis to the direction of SMaxAvg. [deg]

Remarks

This function reports the area stresses for the specified area elements that are assigned layered shell section properties.

The function returns zero if the stresses are successfully recovered, otherwise it returns a nonzero value.

See 
Analysis Results Remarks
 for more information.

VBA Example

Similar to AreaStressShell

 'get area stresses for area object "1"

 ret = SapModel.Results.AreaStressShellLayered("1", Object, NumberResults, Obj, Elm, Layer, IntPtNum, IntPtLoc, PointElm, LoadCase, StepType, StepNum, S11, S22, S12, SMax, SMin, SAngle, SVM, S13Avg, S23Avg, SMaxAvg, SAngleAvg)

Release Notes

Initial release in version 11.00.

Changed nomenclature from Load Cases, Analysis Cases and Response Combinations to Load Patterns, Load Cases and Load Combinations, respectively, in version 12.00.

See Also

AreaForceShell

AreaStressShell

AreaJointForceShell