Академический Документы
Профессиональный Документы
Культура Документы
V8i (SELECTseries 6)
Legal Notices
Trademark Notice
Bentley and the B Bentley logo are registered or non-registered trademarks of Bentley Systems,
Incorporated.
RAM SBeam, RAM Structural System, RAM Manager, RAM Modeler, RAM Steel, RAM Frame, RAM
Foundation and RAM Concrete are registered or non-registered trademarks of Bentley Systems,
Incorporated.
All other marks are the property of their respective owners.
Copyright Notice
Copyright (c) 2013 Bentley Systems, Incorporated. All Rights Reserved.
Including software, file formats, and audiovisual displays; may only be used pursuant to applicable
software license agreement; contains confidential and proprietary information of Bentley Systems,
Incorporated and/or third parties which is protected by copyright and trade secret law and may not be
provided or otherwise made available without proper authorization.
Acknowledgements
Objective Grid C++ Library Copyright Rogue Wave Software, Inc.
Virtual Print Engine (VPE) Copyright IDEAL Software
Contains CM2 MeshTools by Computing Objects
Math Kernel Library (MKL) Intel Corporation
The Boost Graph Library (BGL) Siek, J.G., Lee, L., and Lumsdaine, A.
Ultimate Toolbox Dundas Software Ltd.
TurboDXF Ideal Engineering
Portions Copyright Microsoft Corporation
Includes Adobe PDF Library technology. Portions Copyright Adobe Systems, Inc.
Clipper library Angus Johnson
zlib software Jean-loup Gailly and Mark Adler.
Legal Notices
Restricted Rights Legends
computer software pursuant to 48 C.F.R. 52.227-19(a), as applicable. Use, modification, reproduction,
release, performance, display or disclosure of this software and accompanying documentation by the
U.S. Government are subject to restrictions as set forth in this Agreement and pursuant to 48 C.F.R.
12.212, 52.227-19, 227.7202, and 1852.227-86, as applicable. Contractor/Manufacturer is Bentley
Systems, Incorporated, 685 Stockton Drive, Exton, PA 19341-0678.
Unpublished - rights reserved under the Copyright Laws of the United States and International treaties.
Disclaimer
The software and related documentation, including this documentation, are protected by both United
States copyright law and international treaty provisions. Any unauthorized copying or reproduction is
strictly prohibited and subject to civil and criminal penalties. Please refer to the License Agreement
(EULA) for authorization to make a backup copy of the software. You may not sell this software or
documentation or give copies of them to anyone else.
Except as expressly warranted in the License Agreement (EULA), Bentley Systems, Incorporated
disclaims all warranties, expressed or implied, including but not limited to implied warranties or
merchantability and fitness for a particular purpose, with respect to the software, the accompanying
written materials, and any accompanying hardware. All results should be verified to the user's
satisfaction. The contents of these written materials may include technical inaccuracies or typographical
errors and may be revised without prior notice.
Disclaimer
Table of Contents
Chapter 1: Introduction ........................................................................................................9
Chapter 2: The Load Combination Generator ..................................................................... 11
2.1
2.2
2.3
3.2
3.3
Introduction
The Load Combination Generator is a tool that is used by RAM Frame, RAM Concrete and RAM
Foundation for creating load combinations. It provides a means for generating combinations based on
specific codes and also allows the user to manually enter custom load combinations.
Load Combinations are generated from Load Combination template files. While most users will never
need to concern themselves with these files, templates can be modified to generate customized
combinations to meet the specific needs of an engineer's work environment. New templates can also be
created. See Chapter 3, Load Combination Templates for more information on template files.
Introduction
10
The Load Combination Generator is used to either generate load combinations based on a selected
code's requirements or to enter load combinations manually. This chapter explains how both are done.
Dead Load
Lp
Ln
Rfp
Rfn
Sp
Sn
Wind Load
Earthquake Load
Dyn
O (Oh, not Zero)
ND
NL
NR
Notional Roof
11
Positive and Negative refer to downward acting Live Loads (Positive) and upward acting (uplift) Live
Loads (Negative). The program automatically detects and treats these as separate Live Load cases, when
they occur.
12
13
14
If combinations with syntax errors exist (indicated by a red light) when the user clicks Ok, a warning
will be given asking if the user wants to fix the errors. Because the combo generator does not save load
combinations that contain errors, these combinations will be deleted if not fixed.
Once a template ID is selected, the Code for Combinations drop-down control lists the available
templates for that material (Figure 4). From this control, a code is selected and the dialog controls
become available and the Generate button becomes active.
At this point, combinations can be generated just as if one was using the Load Combination Generation
command. There are two important differences:
1. Existing combinations are not replaced when new combinations are generated as they are in the
Generator. New combinations are appended to the end of the existing combination list.
2. Because these are Custom Combinations, they can be modified and/or deleted from the combination
list.
To edit a load combination, select it in the Load Combinations list and make the desired changes. It
should not exceed 254 characters, including blanks and can have at most twenty five load cases.
15
16
The Load Combination Generator reads an external file to obtain a template and generate the
combinations based on that template. Templates are provided with the program for generating the load
combinations for each building code. The engineer can also create templates.
The use of the load combination templates can be as simple or as complex as the user chooses. Their
purpose is to provide flexibility and, if used correctly, can be a very powerful tool. If used incorrectly or
without careful thought and planning, they can cause more problems than they solve.
Different ways to use the template files
1. The very simplest way to use the templates is to ignore them. The use of template files should be
transparent to the user. This will be the case for most users.
2. A slightly more advanced approach is to access the templates via the Custom Load Combinations
command and modify any combinations that are generated. The Custom Load Combination
command provides access to all templates (regardless of material) and generates combinations
based on the template selected. These generated combinations can then be edited or deleted. By
accessing the templates in this way, one can use their power without having to edit them directly.
3. The most advanced option is to create and edit your own template files. These templates will then be
listed in the Load Combination dialog, along with the templates provided with the program, the same
as if they had come with the program. They will also be available in the Custom Load Combination
dialog. This is an advanced feature and is not recommended for users who are not experienced
with text editors, scripting or debugging .
17
The last section in the template is the actual combination template (COMBINATIONS:), which lists all
combinations that could be generated using this template.
An example of the template file format is given in the following:
ID: TemplateIDText
NAME: TemplateNameText
CONTROL1: T/F
V10, Variable10Text , MinValue , MaxValue , DefaultValue
V11, Variable11Text , MinValue , MaxValue , DefaultValue
.
.
.
V 1n , VariablennText , MinValue , MaxValue , DefaultValue
CONTROL2: T/F , LoadCaseSymbol , LoadCaseSymbol(opt) , Text
OPTION 1: V20 = Value1 , Option1Text
OPTION 2: V20 = Value2 , Option2Text
.
.
.
OPTION n : V20 = Valuen , OptionnText
DEFAULT: OptionNumber
CONTROL3: T/F
TITLE: TitleText30
V30, CheckedValue30 , UncheckedValue30
18
19
3.1.1 ID:
Purpose: The Template ID associates the template with a material (e.g., Steel) and a design code. It is
used for two purposes. When the Load Combination Generator is invoked, it reads all of the
template files (files with the extension .cmb) located in the Tables directory. When a file
with a Template ID that matches the current material and design code is found, the
template is read from that file and made available to the Load Combination Generator.
The second use for the Template ID's is related to Custom Combinations. While an engineer
can still type in Custom Combinations, it is now possible to generate custom combinations
based on the templates. In the Custom Combinations dialog, all of the templates are
available to the user (not just those associated with the current material and design code).
The Template ID's are displayed in a combo box. The user selects a template type and from
there has access to all of the templates associated with that Template ID.
Format:
ID: TemplateIDText
The Template ID line begins with ID: followed by the Template ID, TemplateIDText . It
must be the first line of the template file and there can be only one Template ID line per file.
It must be followed by a blank line.
For use in the Load Combination Generator, TemplateIDText must be one of the Template IDs listed
in Table 3:
Template ID
Material
Design Code
STEEL_ASD
Steel
ASD Standard
20
Steel
LRFD Standard
STEEL_BRITISH
Steel
British Standard
STEEL_CAN
Steel
Canadian Standard
STEEL_EURO
Steel
Eurocode Standard
STEEL_AS_NZS
Steel
AS 4100-98 Standard
STEEL_SP_ASD
Steel
STEEL_SP_LRFD
Steel
CONCRETE_ACI
Concrete
ACI 318
CONCRETE_BRITISH
Concrete
BS 8110
CONCRETE_CP_65
Concrete
CP65
CONCRETE_EC2
Concrete
Eurocode 2
CONCRETE_CHINESE
Concrete
CONCRETE__AS3600
Concrete
AS/NZS 1170.0
SOIL_ACI
Soil
SOIL_BRITISH
Soil
British
SOIL_CP65
Soil
CP65
NOTIONAL_BRITISH
Steel
BS 5950
If a Template ID other than one listed above is used in a template file, that template will NOT be
available to the generator. It will, however, be available through the Custom Load Combination dialog.
Note that NOTIONAL_BRITISH is used exclusively for the BS 5950 Lambda Critical feature; it is not
anticipated that that ID will be used in any user-created templates.
3.1.2 NAME:
Purpose: The Template Name uniquely identifies a template within its Template ID group. For
example, there are several combination codes within the STEEL_ASD Template group (e.g.,
UBC, SBC, BOCA, etc.). It is necessary to be able to differentiate one template from another.
This is done through the Template Name.
When the Load Combinations Generator is initiated, it reads all of the template files and
reads into memory all templates that are associated with a specific Template ID. As it reads
21
each file, it compiles a list of the templates that are available. This list is displayed in the
"Code for Combinations" list. The template that will be used to generate combinations is
selected here by the user.
If a Template Name is duplicated within a Template group, a warning is given.
Format:
NAME: TemplateNameText
The Template Name line begins with NAME: followed by the Template Name,
TemplateNameText. TemplateNameText is any convenient name assigned by the user
creating the template to identify the combinations contained in the template. For example,
Template Names used in the templates provided with the program include AISC ASD, IBC
2000 LRFD, ACI 318-95/99 and BS 8110 1997. The name may include blanks and may
have up to 99 characters. This name must be unique within the Template ID type group. It
must be followed by a blank line.
3.1.3 CONTROL1:
Purpose: Control 1 is a spread sheet-like grid that accepts input for variables that modify load cases
in the load combination. There can be up to 10 variables associated with Control 1. These
variables will be used as load factors or used to modify load factors as specified in the Load
Combinations.
Use this control if the value entered for the variable can be a range of numbers.
Format: CONTROL1: T/F
V10, Variable10Text , MinValue , MaxValue , DefaultValue
V11, Variable11Text, MinValue, MaxValue, DefaultValue
.
.
.
V1n, Variable1nText, MinValue, MaxValue, DefaultValue
The Control 1 line begins with CONTROL1: followed by either T or F. An F (False) indicates
that the control is not used, and no additional information is necessary. In this case the
Control 1 grids will not appear in the Load Combination dialog box.
A T (True) indicates that the control is to be used. The subsequent lines define the user
interface display.
22
Use Control 2 if there are several discrete values that can be assigned to one variable. The engineer
using the template will not be able to enter a value but rather will choose an option that will determine
a value.
In some cases, it is desirable to associate more than one value with a given option. This would be the
case when selection of a given option impacts the factors in different load combination in different ways.
To accomplish this, up to 5 additional variables can be defined for each combo box selection. When
using multiple variables with Control 2, it is imperative that each option have the same number of
variables (i.e., V20, V21, etc.) associated with it.
23
The Control 2 line begins with CONTROL2: followed by either T or F . An F (False) indicates that the
control is not used, and no additional information is necessary. In this case the Control 2 list will not
appear in the Load Combination dialog box.
A T (True) indicates that the control is to be used. The rest of the line contains the additional
information
LoadCaseSymbol1 , LoadCaseSymbol2(optional) , and Text .
LoadCaseSymbol1 and LoadCaseSymbol2 are Load Case symbols as given in Table 1 and Table 2 in
Chapter 2.1. These are called dependent load cases. That is, load cases of both types must have been
Analyzed in order for this control to be visible. If the visibility of the control is based on just one load
case, either enter the same load case symbol twice or leave the second load case symbol blank.
Text is the text that will appear above the option list. Notice the location of the commas separating
items. If the second load case symbol is not used, the commas must still be present to preserve the
empty space.
Subsequent lines for control 2 contain the information for each combo box option. Each option is
defined on a separate line and must be formatted as follows:
24
3.1.5 CONTROL3:
Purpose: Control 3 is a set of options with check boxes. Depending on whether the option is selected
or de-selected, values will be assigned to variables used as factors or to modify factors in
the Load Combinations. There can be up to 10 variables associated with Control 3.
25
Use Control 3 in "Either/Or" situations. In the example above, the user has the option to
either suppress the 1.1 Factor or to apply it.
Format:
CONTROL3: T/F
TITLE: TitleText30
V30, CheckedValue30 , UncheckedValue30
DEFAULT: ON/OFF
TITLE: TitleText31
V31, CheckedValue31 , UncheckedValue31
DEFAULT: ON/OFF
.
.
.
TITLE: TitleText3n
V 3n , CheckedValue3n , UncheckedValue3n
DEFAULT: ON/OFF
The Control 3 line begins with CONTROL3: followed by either T or F . An F (False) indicates that the
control is not used, and no additional information is necessary. In this case, the Control 3 list will not
appear in the Load Combination dialog box. A T (True) indicates that the control is to be used, and
additional lines of information are required for each item in the list.
Each item consists of three lines. The first line begins with TITLE: followed by the text string that will be
displayed for that option. The next line begins with the variable V30 followed by two values,
CheckedValue30 and UncheckedValue30 . CheckedValue30 is the value that will be assigned to
V30 if the option is selected and UncheckedValue30 is the value that will be assigned to V30 if the
option is not selected. The third line begins with DEFAULT: followed by either ON or OFF . ON indicates
that the initial default for the check box associated with that option is for it to be selected, OFF indicates
that it is not to be selected. It is advised to set the default to the setting most commonly selected.
These three lines are repeated for each option desired, using a different variable for each. The variables
V30 through V39 can be used.
An example of Control 3 is:
CONTROL3: T
TITLE: Suppress 1.1 Factor on Seismic Combos.
V30, 1.1, 1.0
DEFAULT: ON
26
3.1.6 CONTROL4:
Purpose: Control 4 consists of two selection buttons; one to indicate the use of program calculated
values and one to indicate the use of values entered by a user.
Control 4 is a special control that is used in the RAM Structural System to apply the
Redundancy Factor, Rho, to the seismic load in combinations. As currently implemented,
the Use Calculated option will always assign the calculated value of Rho to the variable. This
control can also be used, however, for other purposes if the Use Calculated option is not
used. It is useful when the value of the load factor is dependent upon the direction of the
load case.
Format:
The Control 4 line begins with CONTROL4: followed by either T or F . An F (False) indicates that the
control is not used, and no additional information is necessary. In this case, the Control 4 options will
not appear in the Load Combination dialog box.
A T (True) indicates that the control is to be used, and the Control 4 line must contain the additional
information LoadCaseSymbol , a blank, and Text . The items must be separated by commas as shown
and the blank must be included (it is not currently used but is to provide for a future expansion of the
capability of the control).
LoadCaseSymbol is a Load Case symbol as given in "Error! Reference source not found.." Load cases
of this type must have been Analyzed in order for this control to be available. If LoadCaseSymbol is left
blank, the control will always be available (unless the control flag was set to F). Text is the text that will
appear above the option.
When CONTROL4 is set to True, the subsequent line in the file must be as follows: it begins with V40 ,
followed by parameters associated with that variable. Text1 is a text string that will be associated with
the first of two edit boxes. The text string may include blanks and may have up to 4 characters. Text2 is
a text string that will be associated with the second edit box. MinV1 is the minimum allowable value for
that variable as specified in the first edit box; if the user specifies a value less than that, a Warning will
be given by the program. MaxV1 is the maximum allowable value for that variable as specified in the
first edit box; if the user specifies a value greater than that, a Warning will be given by the program.
DefV1 is the default value that will initially appear in the edit box, but which the user can change. For
convenience it should be given the value that is most likely to be specified. MinV2 , MaxV2 and DefV2 are
the minimum, maximum and default values, respectively, associated with the second edit box. Each of
these items must be separated by a comma.
27
Control
Purpose
CALC
ReserveDirVar
2 or 5
3.1.8 COMBINATIONS:
Purpose: The COMBINATIONS section of each template is used to explicitly define the load
combinations. The load factors associated with each load case in each load combination are
specified.
Format:
COMBINATIONS:
Flag Combination1
Flag Combination2
28
Flag Combination3
Flag Combination4
.
.
.
Flag Combination n
END:
The Combinations section begins with the keyword COMBINATIONS: .
Each subsequent line consists of a flag and a mathematical expression describing a single combination,
as described below. Each combination must be listed.
The Combinations section ends with END: .
Flag is either T: or blank. It indicates whether the combination is to be included when the Tensiononly option is invoked in the analysis performed by RAM Frame.
Combination1 , Combination2 , etc, are mathematical expressions consisting of Factors, Load Case
Symbols, Operators and Variables that define a single combination.
Factors can be any number, positive or negative. Generally there should be one combination with a
positive factor on the Wind and Seismic load cases and another with a negative factor, to account for the
reversal of those load cases. If the factor is 1.0, it can be omitted.
Variables can also be used, either instead of or in conjunction with Factors. The variables and their
definition were described previously in the CONTROLS section. Variables should only be used if the
corresponding Control has been activated and defined. Acceptable variable names are V10 through V19
(from Control 1), V20 through V25 (from Control 2), V30 through V39 (from Control 3), V40 (from
Control 4) and V50 through V55 (from Control 5). No other variable names will be recognized. The
program will automatically assign to the variable the value entered by the engineer in the dialog box.
The Load Case Symbols are given in Table 1 in Chapter 2.1. They are used to specify the general Load
Case type. In RAM Frame, there may be multiple Wind, Earthquake, Dynamic or Other load cases; each
of them are of the general Load Case type W, E, Dyn, and O, respectively. Any Load Combinations
containing those load cases need only be generically defined once; the program will automatically
generate actual load combinations for each load case of that type.
Operators can be + , - , * (multiply), and / (divide). Parentheses can also be used. Operators must be
used between Factors, Variables and Load Case Symbols.
An example of a Combinations section is given in the following:
COMBINATIONS:
T: 1.0 * D
T: 1.0 * D + 0.75 * Lp + 0.75 * Rfp
T: 1.0 * D + 0.75 * Ln + 0.75 * Rfn
T: 1.0 * D + 0.75 * Lp + 0.75 * Sp
T: 1.0 * D + 0.75 * Ln + 0.75 * Sn
.
29
30
You should not create a template file if one has already been provide with the
program that creates the combinations you need. You should not create a template
file for a model with specific peculiar conditions that require special combinations
that will not be used again for future models. That is, the combinations are used only
for that one project and not reused. For this situation you should use the Custom
Load Combinations command and create the combinations manually within the
program rather than create a template to generate your project-specific
combinations.
31
32
3.3 Errors
While there are many advantages to using external template files for creating load combinations, it does
open up the possibility for errors to occur. Here are some common problems to watch out for.
Syntax error in the template. These can occur in the dialog Control section of the template or the
Combinations section of the template. There is a fairly exhaustive syntax checker in the generator. If it
encounters a line it cannot read, an error message is given that shows the errant line. This template will
not be available until the syntax error is corrected.
Changing the name of a template that is being used by a model . In this situation, when the model
loads, the template name that is saved with the model will not match what is now in the template file. An
error message will be given stating that the existing load combinations will be deleted. Solution: return
to the Load Combination generator, select a new template and regenerate the combinations.
Incorrect data entered. Otherwise known as typos. If the user creating the template types in 100 as a
dead load factor rather than 1.0, there is no way for the generator to know that this is incorrect. Custom
templates should be tested and verified very carefully before they are used.
33
34
Index
C
Code for Combinations 12
Combinations 28
Combinations Template Section
17
Comments 32
Control 1 22
Control 2 23
Control 3 25
Control 4 26
Control 5 23
Control Section 17
Copying Templates 31
Custom Load Combinations 13
D
Dropped Combinations 30
Dropped Term 30
E
Editing Templates 31
Entering Combinations 14
Error Messages 33
L
Load case symbols 11
T
Table of Symbols 11
Template Creation 31
Template Format 17
Template ID 15, 17, 20
Template Name 17, 21
Templates 15, 17
Testing 33
U
Using Templates 17
N
Notional Loads 30
V
Validate 15
R
Reserve Words 28
35
36