Links
Comment on page

SAP2000 Specifics

Items Specific to the GSA plug-in

SAP Versions

Typical plugin works for SAP2000 v21 or newer. If you need to use v20 or earlier, check for a matching final field in package manager (ie X.XX.XX.19 for SAP2000 v19)

Setting Executable Path

We have enabled the means to nominate the SAP2000 executable path. This may come in handy if you are not running SAP on a local computer such as if SAP2000 is installed on server.
To do this:
1.0 Update to the latest version of the SAP2000 plug-in.
2.0 Navigate to the folder equivalent to: C:\Users\[USER]\AppData\Roaming\GeometryGym and the file ggRhinoSAP.config
3.0 If you edit the file in notepad or similar, and set the option C:\Program Files\Computers and Structures\SAP2000 22 to the path where the SAP executable file is for your install.
4.0 Restart Rhino.

Base

  • unit selection

Attributes

Standard Materials

The SAP plug-in allows you to select a range of predefined materials from within SAP using a set of standard material components. These include standard materials for the following:
  • Concrete
  • Steel
  • Rebar
  • Tendon
  • Cold Formed
  • Aluminum
Choosing a standard material in SAP
By right-clicking on the input parameter you can view a list of available options for definition.
These components rely on the SAP2000 API link.

Properties

Standard Frame Properties

SAP2000 has an inbuilt library of standard Frame properties that can be chosen when creating generating a Frame element in SAP. Instead of using the Geometry Gym In-built catalogue you can provide an appropriate file in-which will be searched for the provided section. On bake of the structure the file-path will be provided to SAP. SAP will search the provided file for a section profile which matches the name provided and then apply it to the structure.

SAP Section Designer

The SAP section designer can be used to generate built up sections to be used in SAP. To create a section design section in Grasshopper. The ggSAPCreateFramePropSectionDesigner component works similar to a standard section property component although it can take any multiple of shapes to build-up a composite section. Section shapes need to be defined using the ggSAPFrameSectionDesignerShape component. This component allows you to specify a particular profile from the profile catalogue or a user defined profile.
You can specify each individual Shape with a prescribed translation in the X and Y directions as well as a rotation (all relative to the x/y axis plane 0,0). An optional Shape material can be provided for Shapes, which allows composite material shapes to be defined. If no material is provided a the base material provided to the Section Designer Property component will be used.
A design type can also be selected for the Section Design section (Steel_Design, Concrete_Column, etc), by default the No_Design is selected.
You will not currently get a preview of these sections in Rhino/Grasshopper.

Non Prismatic Frame Section Property

SAP allows for the definition of non prismatic sections, or section which are varying along the length of the member. With the **ggSAPCreateNonPrismSectionProp**component you can set a non-prismatic section (such as a tapered beam) or a more complex varying section along the length of a frame element. The image below shows a script for a simple tapered beam.
SAP2000 non-prismatic section frame element

Frame Auto Selection Set

ggSAPAutoSelectionSet

Elements

Frame Elements

Auto Mesh

ggSAPFrameAutoMesh
SAP allows for automatic auto meshing of frame elements to brake members at intersecting nodes or elements or a predefined number of points along a beam. The image below shows how to set up frame element auto meshing.
Set Points or Lines to true to force auto meshing at intersections for particular frame elements.
SAP2000 Auto meshing for frame elements

Cable Elements

The ggSAPCreateCable and ggSAPCreateCableProp components allow the definition of circular cable elements with specific properties associated with cable elements. The image below shows the typical workflow. You can assign different attributes to the cable by using the ggSAPCableAtts component.
If you are defining cable elements in SAP then you should not require to use a profile as input.
Defining a cable property in SAP
You can create a GAP Type Link in SAP by using the ggSAPCreateLinkPropGAP component. Each translation and rotational direction input is overloaded to take either a Boolean input or a Link direction parameter input (ggSAPLinkPropParamsGAP). In the direction parameters you can choose to set the direction as non-linear and choose associated values.
By default each direction input is set to false resulting in no link in that direction, if set to true a rigid link is set.
Setting a GAP Link in SAP

Loads

Analysis

Results

Design

You can automate the design of structures by applying code design requirements and setting the SAP2000 design feature to run using the ggSAPDesign. The component can be found under the ggSAPSolver tab.
The design component works similar to the ggSAPSolver component with an extra step, which is to run the design module in SAP and extract any additional associated design queries. When the component is enabled, it will bake the model and run the analysis for the provided load cases. It will then trigger the prescribed SAP Design module to run.
Currently only steel design is enabled within SAP2000
You can specify queries in which you want to extract from the analysis such as node displacements or beam forces as you would with the Solver component - These should go into the Analysis result queries input. Once analysis is complete it will run the steel design module for the provided groups of elements.

Design Codes

We currently allow for a number of different design codes for setting code specific design parameters. Set a design code by selecting one of the SAP steel design components from the ggSAPSolver tab (for example ggSAPSteelDesignEurocode) . This will set the basic values for the code to be applied to the design.
You also have the ability to set any number of design overwrites specific to an element in the model. To set a specific design overwrite for specific element/s, select a design overwrite component (for example ggSteelDesignEurocodeOverwrite) from the ggSAPsolver tab.
SAP Design Overwrites
By hovering over the component you can see which overwrites are available for that particular code and by right-clicking on the Overwrite parameter you can select the desired overwrite. You can add more than one overwrite by providing a list of integer values corresponding to the overwrite enum.

Design Overwrites Values

When providing design overwrites you need to ensure that the overwrite values are as per the requirements of SAP, else it will not be set correctly. Below are the anticipated overwrite values for each provided code taken from the SAP API documentation. Please check to ensure these are the most relevant.
OWs
CSA
AS4100
Eurocode
Click the Tab you are designing with for specific overwrite values.
Set Overwrite {Steel CAN CSA S16-01}
The value of the considered overwrite item.
1 = Framing type (0 = As specified in preferences, 1 = Type LD MRF, 2 = Type MD MRF, 3 = Type D MRF, 4 = Type LD CBF(V), 5 = Type LD CBF(TC), 6 = Type LD CBF(TO), 7 = Type LD CBF(OT), 8 = Type MD CBF(V), 9 = Type MD CBF(TC), 10 = Type MD CBF(TO), 11 = Type MD CBF(OT), 12 = EBF, 13 = Cantilever Column, 14 = Conventional MF, 15 = Conventional BF)
2 = Consider deflection (0 = No, Any other value = Yes)
3 = Deflection check type (0 = Program default, 1 = Ratio, 2 = Absolute, 3 = Both)
4 = DL deflection limit, L/Value (Value >= 0; 0 means no check for this item)
5 = SDL + LL deflection limit, L/Value (Value >= 0; 0 means no check for this item)
6 = LL deflection limit, L/Value (Value >= 0; 0 means no check for this item)
7 = Total load deflection limit, L/Value (Value >= 0; 0 means no check for this item)
8 = Total camber limit, L/Value (Value >= 0; 0 means no check for this item)
9 = DL deflection limit, absolute (Value >= 0; 0 means no check for this item. [L])
10 = SDL + LL deflection limit, absolute (Value >= 0; 0 means no check for this item. [L])
11 = LL deflection limit, absolute (Value >= 0; 0 means no check for this item. [L])
12 = Total load deflection limit, absolute (Value >= 0; 0 means no check for this item. [L])
13 = Total camber limit, absolute (Value >= 0; 0 means no check for this item. [L])
14 = Specified camber (Value >= 0. [L])
15 = Net area to total area ratio (Value >= 0; 0 means use program default value)
16 = Live load reduction factor (Value >= 0; 0 means use program determined value)
17 = Unbraced length ratio, Major (Value >= 0; 0 means use program determined value)
18 = Unbraced length ratio, Minor (Value >= 0; 0 means use program determined value)
19 = Unbraced length ratio, Lateral Torsional Buckling (Value >= 0; 0 means use program determined value)
20 = Effective length factor, K Major (Value >= 0; 0 means use program determined value)
21 = Effective length factor, K Minor (Value >= 0; 0 means use program determined value)
22 = Effective length factor, K LTB (Value >= 0; 0 means use program determined value)
23 = Moment coefficient, Omega1 Major (Value >= 0; 0 means use program determined value)
24 = Moment coefficient, Omega1 Minor (Value >= 0; 0 means use program determined value)
25 = Moment coefficient, Omega2 (Value >= 0; 0 means use program determined value)
26 = Nonsway moment factor, U1 Major (Value >= 0; 0 means use program determined value)
27 = Nonsway moment factor, U1 Minor (Value >= 0; 0 means use program determined value)
28 = Sway moment factor, U2 Major (Value >= 0; 0 means use program determined value)
29 = Sway moment factor, U2 Minor (Value >= 0; 0 means use program determined value)
30 = Parameter for compressive resistance, n (Value >= 0; 0 means use program determined value)
31 = Yield stress, Fy (Value >= 0; 0 means use program determined value. [F/L2])
32 = Expected to specified Fy ratio, Ry (Value >= 0; 0 means use program determined value. [F/L2])
33 = Compressive resistance, Cr (Value >= 0; 0 means use program determined value. [F])
34 = Tensile resistance, Tr (Value >= 0; 0 means use program determined value. [F])
35 = Major bending resistance, Mr3 (Value >= 0; 0 means use program determined value. [FL])
36 = Minor bending resistance, Mr2 (Value >= 0; 0 means use program determined value. [FL])
37 = Major shear resistance, Vr2 (Value >= 0; 0 means use program determined value. [F])
38 = Minor shear resistance, Vr3 (Value >= 0; 0 means use program determined value. [F])
39 = Demand/capacity ratio limit (Value >= 0; 0 means use program determined value)
Set Overwrite {Steel AS 4100-1998}
The value of the considered overwrite item.
1 = Framing type (0 = As specified in preferences, 1 = Moment frame, 2 = Braced frame)
2 = Steel type (1 = Hot rolled, 2 = Hot finished, 3 = Cold form, 4 = Stress relieved, 5 = Lightly welded, 6 = Heavily welded)
3 = Consider deflection (0 = No, Any other value = Yes)
4 = Deflection check type(0 = Program default, 1 = Ratio, 2 = Absolute, 3 = Both)
5 = DL deflection limit, L/Value (Value >= 0; 0 means no check for this item)
6 = SDL + LL deflection limit, L/Value (Value >= 0; 0 means no check for this item)
7 = LL deflection limit, L/Value (Value >= 0; 0 means no check for this item)
8 = Total load deflection limit, L/Value (Value >= 0; 0 means no check for this item)
9 = Total camber limit, L/Value (Value >= 0; 0 means no check for this item)
10 = DL deflection limit, absolute (Value >= 0; 0 means no check for this item. [L])
11 = SDL + LL deflection limit, absolute (Value >= 0; 0 means no check for this item. [L])
12 = LL deflection limit, absolute (Value >= 0; 0 means no check for this item. [L])
13 = Total load deflection limit, absolute (Value >= 0; 0 means no check for this item. [L])
14 = Total camber limit, absolute (Value >= 0; 0 means no check for this item. [L])
15 = Specified camber (Value >= 0. [L])
16 = Net area to total area ratio (Value >= 0; 0 means use program default value)
17 = Live load reduction factor (Value >= 0; 0 means use program determined value)
18 = Unbraced length ratio, Major (Value >= 0; 0 means use program determined value)
19 = Unbraced length ratio, Minor (Value >= 0; 0 means use program determined value)
20 = Unbraced length ratio, Lateral Torsional Buckling (Value >= 0; 0 means use program determined value)
21 = Effective length factor, Ke Major Braced (Value >= 0; 0 means use program determined value)
22 = Effective length factor, Ke Minor Braced (Value >= 0; 0 means use program determined value)
23 = Effective length factor, Ke Major Sway (Value >= 0; 0 means use program determined value)
24 = Effective length factor, Ke Minor Sway (Value >= 0; 0 means use program determined value)
25 = Twist restraint factor for LTB (kt) (Value >= 0; 0 means use program determined value)
26 = Lateral rotation restraint factor (kr) (Value >= 0; 0 means use program determined value)
27 = Load height factor for LTB (kl) (Value >= 0; 0 means use program determined value)
28 = Moment coefficient, Cm Major (Value >= 0; 0 means use program determined value)
29 = Moment coefficient, Cm Minor (Value >= 0; 0 means use program determined value)
30 = Moment modification factor, Alpha_m (Value >= 0; 0 means use program determined value)
31 = Slender reduction factor, Alpha_s (Value >= 0; 0 means use program determined value)
32 = Nonsway moment factor, Db Major (Value >= 0; 0 means use program determined value)
33 = Nonsway moment factor, Db Minor (Value >= 0; 0 means use program determined value)
34 = Sway moment factor, Bs Major (Value >= 0; 0 means use program determined value)
35 = Sway moment factor, Bs Minor (Value >= 0; 0 means use program determined value)
36 = Form factor, Kf (Value >= 0; 0 means use program determined value)
37 = Axial capacity correction factor, Kt (Value >= 0; 0 means use program determined value)
38 = Yield stress, Fy (Value >= 0; 0 means use program determined value. [F/L2])
39 = Compressive capacity, Nc (Value >= 0; 0 means use program determined value. [F])
40 = Tensile capacity, Nt (Value >= 0; 0 means use program determined value. [F])
41 = Major bending capacity, Ms33 (Value >= 0; 0 means use program determined value. [FL])
42 = Minor bending capacity, Ms22 (Value >= 0; 0 means use program determined value. [FL])
43 = Minor bending capacity, Mb33 (Value >= 0; 0 means use program determined value. [FL])
44 = Major shear capacity, Vu2 (Value >= 0; 0 means use program determined value. [F])
45 = Minor shear capacity, Vu3 (Value >= 0; 0 means use program determined value. [F])
46 = Demand/capacity ratio limit (Value >= 0; 0 means use program determined value)
Set Overwrite {Steel Eurocode 3 2005}
The value of the considered overwrite item.
1 = Framing type (0 = Program Default, 1 = Moment Frame, 2 = Braced Frame)
2 = Consider deflection (0 = Program Determined, 1 = No, 2 = Yes)
3 = Deflection check type (0 = Program default, 1 = Ratio, 2 = Absolute, 3 = Both)
4 = DL deflection limit, L/Value (Value >= 0; 0 means no check for this item.)
5 = SDL + LL deflection limit, L/Value (Value >= 0; 0 means no check for this item.)
6 = LL deflection limit, L/Value ( Value >= 0; 0 means no check for this item.)
7 = Total load deflection limit, L/Value (Value >= 0; 0 means no check for this item.)
8 = Total camber limit, L/Value (Value >= 0; 0 means no check for this item.)
9 = DL deflection limit, absolute (Value >= 0; 0 means no check for this item. [L])
10 = SDL + LL deflection limit, absolute (Value >= 0; 0 means no check for this item. [L])
11 = LL deflection limit, absolute (Value >= 0; 0 means no check for this item. [L])
12 = Total load deflection limit, absolute (Value >= 0; 0 means no check for this item. [L])
13 = Total camber limit, absolute (Value >= 0; 0 means no check for this item. [L])
14 = Specified camber (Value >= 0. [L])
15 = Net area to total area ratio (Value >= 0; 0 means use program default value)
16 = Live load reduction factor (Value >= 0; 0 means use program determined value)
17 = Unbraced length ratio, Major (Value >= 0; 0 means use program determined value)
18 = Unbraced length ratio, Minor (Value >= 0; 0 means use program determined value)
19 = Effective length factor sway, K2 Major (Value >= 0; 0 means use program determined value)
20 = Effective length factor sway, K2 Minor (Value >= 0; 0 means use program determined value)
21 = Moment coefficient, kyy Major (Value >= 0; 0 means use program determined value)
22 = Moment coefficient, kzz Minor (Value >= 0; 0 means use program determined value)
23 = Bending coefficient, C1 (Value >= 0; 0 means use program determined value)
24 = Moment coefficient, kzy (Value >= 0; 0 means use program determined value)
25 = Moment coefficient, kyz (Value >= 0; 0 means use program determined value)
26 = Yield stress, Fy (Value >= 0; 0 means use program determined value. [F/L2])
27 = Compressive capacity, Nc.Rd (Value >= 0; 0 means use program determined value. [F])
28 = Tensile capacity, Nt.Rd (Value >= 0; 0 means use program determined value. [F])
29 = Major bending capacity, Mc3.Rd (Value >= 0; 0 means use program determined value. [FL])
30 = Minor bending capacity, Mc2.Rd (Value >= 0; 0 means use program determined value. [FL])
31 = Buckling resistance moment, Mb.Rd (Value >= 0; 0 means use program determined value. [FL])
32 = Major shear capacity, V2.Rd (Value >= 0; 0 means use program determined value. [F])
33 = Minor shear capacity, V3.Rd (Value >= 0; 0 means use program determined value. [F])
34 = Demand/capacity ratio limit (Value >= 0; 0 means use program determined value)
35 = Section class (0 = Program default, 1 = Class 1, 2 = Class 2, 3 = Class 3, 4 = Class 4)
36 = Column buckling curve, y-y (0 = Program default, 1 = a0, 2 = a, 3 = b, 4 = c, 5 = d)
37 = Column buckling curve, z-z (0 = Program default, 1 = a0, 2 = a, 3 = b, 4 = c, 5 = d)
38 = Buckling curve for LTB (0 = Program default, 1 = a0, 2 = a, 3 = b, 4 = c, 5 = d)
39 = System overstrength factor, Omega (Value >= 0; 0 means use program determined value)
40 = Is rolled section (0 = Program Determined, 1 = No, 2 = Yes)
41 = Unbraced length ratio, LTB (Value >= 0; 0 means use program determined value)
42 = Effective length factor braced, K1 Major (Value >= 0; 0 means use program determined value)
43 = Effective length factor braced, K1 Minor (Value >= 0; 0 means use program determined value)
44 = Effective length factor, K LTB (Value >= 0; 0 means use program determined value)
45 = Material overstrength factor, GammaOV (Value >= 0; 0 means use program determined value)
46 = Warping constant, Iw (Value >= 0; 0 means use program determined value. [L6])
47 = Elastic torsional buckling force, Ncr T (Value >= 0; 0 means use program determined value. [F])
48 = Elastic torsional-flexural buckling force, Ncr TF (Value >= 0; 0 means use program determined value. [F])
Not here? See general design page