GSA 10.2 – GWA Keywords


Introduction

The format of the text data file is a record by record file with fields separated by tabs or commas. There are three variants of the text file: The default option (.gwa) reads/writes files in an international format. Data is written in SI units. The decimal point is a dot and the fields are separated by a tab. This is recommended where files have to be transferred between offices in different countries. The tab separated option (.txt) reads/writes files in a locale specific format where the decimal point can be a dot or comma depending on the locale. The files can either be in SI or model units. The csv file option (.csv) reads/writes files in a locale specific format where the decimal point can be a dot or comma, and the list separator a comma or semi-colon depending on the locale. The files can either be in SI or model units. With the default (.gwa) file extension the file is read/written in an international format. The alternative options read/write files using the local settings for decimal points and list separators (see 'Windows Settings') for ease of importing the files into spreadsheets.

Each record consists of a keyword and a number of fields). There may only be one record per line, but a record may be continued on more than one line. To spread a record over several lines a continuation marker (a \) should be placed in the next field position on that line. Comments can be included in the file on any line after a comment marker (an !) character. The \ should precede any comments and anything after the continuation marker will be treated as a comment. Both comments and continuation characters should be separated from the fields by a tab. Blank lines (no space or tab characters) are acceptable. A blank field is interpreted as a null string for string fields and a zero for numeric fields.

The keyword is of the form keyword.version:sid. If no version is specified the latest version is assumed. The sid (string id) is optional but can be used for tagging records for transferring data between programs. Case fields are integer values for analysis cases or strings in the format Tx.y for task x results for timestep y.

Units

When saving to a text file format you can select to use either model units or SI units.
When exporting user modules .gwa format is used, with SI units.
When importing/reading text files, SI units are assumed (until a UNIT_ record is encountered - after which that unit preference is used for subsequent values)
When copying/pasting GWA data to/from the clipboard, the current model units are used.

Changes between GSA 10.1 and GSA 10.2

KeywordChange
LOAD_GRAVITYLoaded entity type field added
LOAD_BEAM_POINT
LOAD_BEAM_UDL
LOAD_BEAM_LINE
LOAD_BEAM_PATCH
LOAD_BEAM_TRILIN
LOAD_BEAM_PRE
LOAD_BEAM_TEN
LOAD_BEAM_STRN
LOAD_BEAM_LENG
LOAD_2D_FACE
LOAD_2D_PRE
LOAD_2D_TENDON
LOAD_2D_STRN
LOAD_1D_THERMAL
LOAD_2D_THERMAL
LOAD_3D_THERMAL
OP_VIEWInteger field to indicate whether it is a custom output or a default output view added

GSA 10.2 records

Each record is of the form:
KEY_WORD, value, value, value, value
Version numbers may be associated with GWA keywords. Versions are specified by appending the version number to the keyword, separated by a '.', for example: NODE.2 When reading GWA records for versioned keywords, where no version is supplied the current version is assumed. GSA does not write the version to GWA records. A new version number is assigned only when new data is inserted into an existing keyword record. New data appended to an existing keyword record does not warrant a new version number. Where a table is referred to, this represents the following input n, x1, y1, ... xn, yn where n is the number of points, xi is the value of the abscissa and yi is the value of the ordinate. The format of the specific records is as follows:

Index


ACC

ACC | node | case | x | y | z

Description

Nodal acceleration

Parameters

node node number
case analysis case
x,y,z accelerations [m/s²]

Index


ADD

ADD | index | key | <data>

Description

Append data

Parameters

index index number
key key word
<data> data for key

Index


ALIGN

ALIGN | num | name | surface | num ( | chain | curv )

Description

Alignment definition

Parameters

num record number
name name
surface the grid surface on which the alignment exists
num number of alignment points
((
chain chainage [m]
curv curvature (1/radius) at position [/m]
positive value curvature to right
negative value curvature to left
))

Index


ANAL

ANAL | case | name | task | desc

ANAL | case | name | task | desc | stage

Description

Analysis case definition

Parameters

case case number
name case name
task task number
desc load description (e.g. "1.4L1+1.2L2")
stage deprecated: task number (input only and static analysis only)

Note

These are set to PRE_ANLAYSIS until some results are found

Index


ANAL_STAGE

ANAL_STAGE.3 | stage | name | colour | list | phi | time | lock

ANAL_STAGE.2 | stage | name | colour | list | phi | lock

ANAL_STAGE.1 | stage | name | list

Description

analysis stage definition

Parameters

stage stage number
name stage name
colour colour (ref. colour syntax)
list list of elements in stage
phi creep factor
time time at which stage applies
lock list of elements with releases locked in stage

Index


ANAL_STAGE_MAT

ANAL_STAGE_MAT | stage | elem_mat | stage_mat | phi

Description

Analysis stage material definition

Parameters

stage stage number
elem_mat element material number
stage_mat new material number
phi creep coefficient

Index


ANAL_STAGE_PROP

ANAL_STAGE_PROP | stage | type | elem_prop | stage_prop

Description

Analysis stage property definition

Parameters

stage stage number
type element property type
BEAM
SPRING
MASS
2D 2D element property
LINK
CABLE
3D 3D element property
DAMPER
elem_prop element property number
stage_prop new property number

Index


AREA

AREA.2 | ref | name | colour | type | span | property | group | lines | coefficient

AREA.1 | ref | name | type | span | property | group | lines | coefficient

Description

area definition

Parameters

ref number
name name
colour colour (ref. colour syntax)
type area type
UNDEF not defined
VOID void
ONE_WAY one-way spanning
TWO_WAY two-way spanning
MULTI_WAY multi-way spanning
span span direction [degrees] (only used if one-way spanning)
property 2D element property reference
group group number
lines list of line references
coefficient meshgen refinement coefficient

Index


ASSEMBLY

ASSEMBLY.3 | num | name | type | entity | topo_1 | topo_2 | orient_node | int_topo | size_y | size_z | curve_type | curve_order | point_defn | points

ASSEMBLY.2 | num | name | entity | TOPO | topo_1 | topo_2 | orient_node | int_topo | curve_type | curve_order | point_defn | points

ASSEMBLY.2 | num | name | elem | AXIS | axis | auto | end_1 | end_2 | offset | centre_y | centre_z | point_defn | points

ASSEMBLY.1 | num | name | axis | entity | point_defn | points | auto | end_1 | end_2 | centre_y | centre_z

Description

Assembly definition

Parameters

num record number
name name
type entity type
MEMBER
ELEMENT
entity list of entities in assembly
topo_1 node at end 1 of assembly
topo_2 node at end 2 of assembly
orient_node node defining xy plane of assembly
int_topo list of internal nodes defining curve
empty list if assembly is not curved
size_y dimension in y direction (0 for undefined)
size_z dimension in z direction (0 for undefined)
curve_type option for fit of curve to topology
LAGRANGE Lagrange interpolation
CIRCULAR Circular arc
curve_order (reserved for future use)
axis assembly axis
auto automatic determination of extents
AUTO automatic
MANUAL manual
end_1 x coordinate of end 1 of assembly
end_2 x coordinate of end 2 of assembly
offset transverse offset definition
SPECIFY specify values directly
CENTROID_1 EA centroid at end 1
CENTROID_2 EA centroid at end 1
CENTROID_M EA centroid at mid position
centre_y y offset of centre from default position of x axis
centre_z z offset of centre from default position of x axis
point_defn definition of intermediate points
POINT number of points along assembly
SPACING spacing of points along assembly
STOREY assembly defined by storeys
EXPLICIT explicitly defined values
points definition of points
number of points POINT
spacing SPACING
storey list STOREY
explicit range EXPLICIT

Index


AXIAL_FORCE_DISP

AXIAL_FORCE_DISP | case | node | dir | num_pos | { axial | disp }

Description

Load factor displacement results

Parameters

case analysis case
node node
dir direction
num_pos number of positions
axial axial force factor
disp axial force value

Index


AXIS

AXIS.1 | num | name | type | Ox | Oy | Oz | Xx | Xy | Xz | XYx | XYy | Xyz

Description

Axis definition

Parameters

num axis number
name name
type axis type
CART cartesian
CYL cylindrical
SPH spherical
Ox,Oy,Oz origin [m]
Xx,Xy,Xz x axis vector
XYxXYy,XYz xy plane vector

Index


BASE_REACT

BASE_REACT | case | item | shear

Description

Base shear in response spectrum analysis

Parameters

case analysis case
item response item
shear response item base shear [N]
three values for CQC3 combination

Index


BASE_SHEAR

BASE_SHEAR | case | item | shear

Description

Base shear in response spectrum analysis

Parameters

case analysis case
item response item
shear response item base shear [N]
three values for CQC3 combination

Index


BASE_SHEAR_EQN

BASE_SHEAR_EQN | case | eqn

Description

Equation which governs base shear in response spectrum analysis

Parameters

case analysis case
eqn governing equation

Index


BASIC_BRIDGE_LOAD

BASIC_BRIDGE_LOAD | num | name | group | path | type | start | end | vehicle | intensity | effect

Description

Basic bridge load definition

Parameters

num record number
name name
group group number
path path number
type load type
UDL | KEL | VEHICLE
start start load position [m]
end end load position [m]
vehicle vehicle
standard vehicles:
HB6
HB11
HB16
HB21
HB26
HB45-6
HB45-11
HB45-16
HB45-21
HB45-26
UIC71/RU
SW_0
SW_2
H20_44+
HS20_44_14+
HS20_44_22+
HS20_44_30+
H20_44-
HS20_44_14-
HS20_44_22-
HS20_44_30-
EU_TS300
EU_TS200
EU_TS100
AASHTO_TANDEM
AASHTO_2_TRUCK+
AASHTO_2_TRUCK-
M1600_3.75
M1600_5
S1600_3.75
S1600_5
SV-TT-NORM-TOHIGHCHAIN
SV-TT-NORM-TOLOWCHAIN
SV-TT-SLOW-TOHIGHCHAIN
SV-TT-SLOW-TOLOWCHAIN
SV-TRAIN-1.2TOHIGHCHAIN
SV-TRAIN-1.2TOLOWCHAIN
SV-TRAIN-5TOHIGHCHAIN
SV-TRAIN-5TOLOWCHAIN
SV-TRAIN-9TOHIGHCHAIN
SV-TRAIN-9TOLOWCHAIN
SV150-1.2NORM
SV150-1.2SLOW
SV150-5NORM
SV150-5SLOW
SV150-9NORM
SV150-9SLOW
SV100-1.2NORM
SV100-1.2SLOW
SV100-5NORM
SV100-5SLOW
SV100-9NORM
SV100-9SLOW
SV80-1.2NORM
SV80-1.2SLOW
SV80-5NORM
SV80-5SLOW
SV80-9NORM
SV80-9SLOW
SV80EC_1_2
SV80EC_5
SV80EC_9
SV100EC_1_2
SV100EC_5
SV100EC_9
SV196EC_1_2_HIGH
SV196EC_1_2_LOW
SV196EC_5_HIGH
SV196EC_5_LOW
SV196EC_9_HIGH
SV196EC_9_LOW
SOV250_1P5_HIGH
SOV250_5_HIGH
SOV250_9_HIGH
SOV250_14_HIGH
SOV250_20_HIGH
SOV250_30_HIGH
SOV250_40_HIGH
SOV350_1P5_HIGH
SOV350_5_HIGH
SOV350_9_HIGH
SOV350_14_HIGH
SOV350_20_HIGH
SOV350_30_HIGH
SOV350_40_HIGH
SOV450_1P5_HIGH
SOV450_5_HIGH
SOV450_9_HIGH
SOV450_14_HIGH
SOV450_20_HIGH
SOV450_30_HIGH
SOV450_40_HIGH
SOV600_1P5_HIGH
SOV600_5_HIGH
SOV600_9_HIGH
SOV600_14_HIGH
SOV600_20_HIGH
SOV600_30_HIGH
SOV600_40_HIGH
intensity intensity [N][N/m][N]
effect influence effect value

Index


BLANK

BLANK | key | low | high

Description

Blank records

Parameters

key key word
low,high record limits

Index


BLOCK

BLOCK.1 | num | name | colour | member_list | off_x | off_y | off_z | axis

Description

Blocks

Parameters

num block number
name name
colour colour (ref. colour syntax)
member_listmember list
off_x offset list in x
off_y offset list in y
off_z offset list in z
axis Axis system for offsets

Index


BRIDGE_LOAD

BRIDGE_LOAD | no | type | path | start | end | interval | intensity | vehicle | list

*** DEPRECATED ***

Index


BRIDGE_OPTI_SUM_EC1

BRIDGE_OPTI_SUM_EC1 | num | name | path | lane1 | lane2 | lane3 | lane4 | total | factor | critical

Description

Bridge optimization summary definition of EC1

Parameters

num reference number
name name
path LM3 path
lane1 path number of lane 1
lane2 path number of lane 2
lane3 path number of lane 3
lane4 path number of lane 4
total total effect
factor factored effect
critical critical value

Index


BRIDGE_OPTI_SUM_UKHK

BRIDGE_OPTI_SUM_UKHK | num | name | path | lane1 | fac1 | lane2 | fac2 | lane3 | fac3 | lane4 | fac | total | factor | critical

Description

Bridge optimization summary definition

Parameters

num reference number
name name
path HB path
lane path number of lane i
fac lane factor i
total total effect
factor factored effect
critical critical value

Index


BRIDGE_OPTI_SUM_US

BRIDGE_OPTI_SUM_US | num | name | path | lane1 | lane2 | lane3 | lane4 | total | factor | critical

Description

Bridge optimization summary definition of EC1

Parameters

num reference number
name name
path LM3 path
lane1 path number of lane 1
lane2 path number of lane 2
lane3 path number of lane 3
lane4 path number of lane 4
total total effect
factor factored effect
critical critical value

Index


CARRIAGEWAY_PATH

CARRIAGEWAY_PATH | num | name | type | group | alignment | left | right | factor | analyse

Description

Carriageway path

Parameters

num record number
name name
type path type
LANE
FOOTWAY
TRACK
VEHICLE
group group number
alignment alignment number
left left / centre offset [m]
right right offset / gauge [m]
factor left factor
analyse analysis flag
ANALYSE_YES
ANALYSE_NO

Index


CASES_IN_RESP

CASES_IN_RESP | case | num

Description

Cases in response spectrum analysis

Parameters

case analysis case
num number of cases

Index


CASE_DESC

CASE_DESC | name | desc

Description

Case description

Parameters

name name
desc case description

Index


CENTRE_MASS

CENTRE_MASS | case | x | y | z

Description

Structure centre of mass

Parameters

case analysis case
x,y,z coordinates of centre of mass [m]

Index


COMBINATION

COMBINATION | case | name | desc | bridge | note

Description

Combination case title definition

Parameters

case combination case
name name
desc combination case description
bridge optional flag for bridge analysis
STANDARD (blank) not a bridge analysis case
BRIDGE a bridge analysis
note case note

Index


CONDITION

CONDITION | task | condition

Description

Condition number

Parameters

task task number
condition condition number of stiffness matrix

Index


CONS_EQN

CONS_EQN.2 | name | constrained_node | dir | equation | stage

CONS_EQN.1 | constrained_node | dir | equation | stage

Description

Constraint equation definition

Parameters

name constraint equation name
constrained_node constrained node
dir load direction
X | Y | Z | XX | YY | ZZ
equation constraint equation
stage list of stages in which constraint is active

Index


CONS_FORCE

CONS_FORCE | node | case | x | y | z

Description

Nodal constraint force

Parameters

node node number
case analysis case
x,y,z constraint forces [N]

Index


CONS_MOMENT

CONS_MOMENT | node | case | x | y | z

Description

Nodal constraint moment

Parameters

node node number
case analysis case
x,y,z constraint moment [N.m]

Index


CURRENCY

CURRENCY | type

Description

Currency

Parameters

type currency type
AED United Arab Emirates, dirham
AUD Australia, dollars
BND Brunei, dollar
BWP Botswana, pula
CAD Canada, dollars
CHF Switzerland, franc
CNY China, yuan renminbi
CYP Cyprus, pound
DKK Denmark, krone
EUR Europe, euro
GBP UK, pounds
HKD Hong Kong, dollars
IDR Indonesia, rupiah
INR India, rupee
JPY Japan, yen
KRW Korea, won
KZT Kazakhstan, tenge
MUR Mauritius, rupee
MXN Mexico, peso
MYR Malaysia, ringgit
NGN Nigeria, naira
NOK Norway, krone
NZD New Zealand, dollars
PGK Papua New Guinea, kina
PHP Philippines, peso
PLN Poland, zloty
QAR Qatar, rial
RON Romania, lei
RSD Serbia, dinar
RUR Russia, ruble
SEK Sweden, krona
SGD Singapore, dollars
THB Thailand, baht
TRL Turkey, lira
UAH Ukraine, hryvnia
USD US, dollars
VND Vietnam, dong
ZAR South Africa, rand
ZWD Zimbabwe, dollar

Note

uses ISO 4217 currency codes

Index


CUSTOM_OP_VIEW

CUSTOM_OP_VIEW.7

*** DEPRECATED ***

Index


DAMPER_FORCE

DAMPER_FORCE | node | case | x | y | z

Description

Nodal damper force

Parameters

node node number
case analysis case
x,y,z damper forces [N]

Index


DAMPER_MOMENT

DAMPER_MOMENT | node | case | x | y | z

Description

Nodal damper moment

Parameters

node node number
case analysis case
x,y,z damper moment [N.m]

Index


DAMP_IN_RESP

DAMP_IN_RESP | case | item | damp

Description

Damping in response spectrum analysis

Parameters

case analysis case
item response item
damp response item damping

Index


DELETE

DELETE | key | low | high

Description

Delete records

Parameters

key key word
low,high record limits

Index


DESIGN

DESIGN | case | title | factor_list | type | ratio

*** DEPRECATED ***

Index


DESIGN_STEEL_REST_PROP

DESIGN_STEEL_REST_PROP | num | name | num_rest ( | rest_type | rest_ref | rest_height | rest_desc )

Description

Steel design restraint property

*** DEPRECATED ***

Parameters

num record number
name name
num_rest number of restraint on member
((
rest_type restraint type
DES_NODE restraint at node
DES_SPAN restraint along the span
rest_ref position index along member
rest_height load height [m]
+ve destabilizing load
-ve stabilizing
rest_desc restraint description (e.g. F12L MINV)
))

Index


DESIGN_TASK

DESIGN_TASK | task | name | STEEL | case | member_list | primary | secondary | util | tol | pool |

DESIGN_TASK | task | name | CONC_2D | case | member_list | num_bar ( | bars ) | spacing |

Description

Design tasks

Parameters

task task number
name task name
type task type
STEEL Steel beams and columns
CONC_2D Concrete 2D members
member_list list of members
case combination case
primary primary objective
secondary secondary objective
util utilisation limit
tol utilisation tolerance
pool pool reference
YES Assign same section for all member with same pool
NO No preference
num_bar number of bar sizes
((
bars bar sizes
))
spacing maximum spacing

Index


DISP

DISP | node | case | x | y | z

Description

Nodal displacement

Parameters

node node number
case analysis case
x,y,z displacements [m]

Index


DISP_ELEM

DISP_ELEM | elem | case | pos | x | y | z

Description

element displacement

Parameters

elem element number
case analysis case
pos position on element
0 | 1 | ...
x,y,z displacements [m]

Index


DISP_NODE

DISP_NODE.2 | name | list | case | axis | dir | value

DISP_NODE.1 | list | case | axis | dir | value

Description

Applied displacement definition

Parameters

name name of the load
list list of nodes
case load case number
axis axis number in which load acts
dir load direction
X | Y | Z | XX | YY | ZZ
value displacement [m]

Index


DLF_CURVE

DLF_CURVE | num | name | num_point | desc

Description

DLF (dynamic load factor) curve definition

Parameters

num record number
name name
desc description of the dynamic load factor in text format e.g. (1,4,3,2,1) (2,4,3,2,1) (3,4,3,2,1)...

Index


EFF_MASS

EFF_MASS | case | option | x | y | z

Description

Effective mass

Parameters

case analysis case
option type option
TRAN translational
ROT rotational
x,y,z values [kg][kg.m²]

Index


EL

EL.4 | num | name | colour | type | prop | group | topo() | orient_node | orient_angle | is_rls { | rls { | k } } off_x1 | off_x2 | off_y | off_z | dummy | parent

EL.3 | num | name | colour | type | prop | group | topo() | orient_node | orient_angle | is_rls { | rls { | k } } off_x1 | off_x2 | off_y | off_z | dummy

EL.2 | num | name | colour | type | prop | group | topo() | orient_node | orient_angle | is_rls { | rls { | k } } is_offset { | ox | oy | oz } | dummy

EL.1 - for use with COM GwaCommand GET command to return element in EL_BAR, etc. format

Description

Element release definition

Parameters

num element number
name name
colour colour (ref. colour syntax)
type element type
BAR
BEAM
TIE
STRUT
SPRING
GRD_SPRING
LINK
DAMPER
GRD_DAMPER
CABLE
SPACER
MASS
GROUND
TRI3
TRI6
QUAD4
QUAD8
BRICK8
LOAD_PANEL
prop property number
for tapered elements the property is of the form section[start:end] where
section property number
start fraction along section taper at start of element [0:1]
end fraction along section taper at end of element [0:1]
group group number
topo() topology - number of items depends on type
orient_node orientation node
orient_angleorientation angle
is_rls releases are included, or not
NO_RLS | RLS | STIFF
{{
rls release code for elements
6 characters - translation + rotation
F fix (no release)
R pin (release)
K stiff (release + stiffness)
{{
k stiffness - one value for each K above
}}
}}
off_x1 offset x - end 1 (beam/bar/rod/strut/tie elements only)
off_x2 offset x - end 2 (beam/bar/rod/strut/tie elements only)
off_y offset y (beam elements only)
off_z offset z (beam and 2D elements only)
is_offset offsets are included, or not
OFFSET | LOCAL_OFFSET | NO_OFFSET
{{
ox offset x
oy offset y
oz offset z
}}
action action applied to beam elements
NORMAL
COMPRESSION compression-only
TENSION tension-only
dummy dummy flag
parent the member from which the element was generated. If the element was generated from a member replicated by a block, the replica index follows after a decimal point (eg 1.2)

Index


ENV_PARAM

ENV_PARAM.4 | material | country | variant | grade | notes | eEnergy_A | eCO2_A | eCO2_B | eCO2_C | eCO2_D | recycle

ENV_PARAM.3 | material | country | variant | grade | user_param | user_unit | eEnergy_A | eCO2_A | eCO2_B | eCO2_C | eCO2_D | recycle | user_value

ENV_PARAM.2 | material | country | variant | grade | user_param | user_unit | eEnergy_A | eCO2_A | eCO2_B | eCO2_C | eCO2_D | recycle | user_value

ENV_PARAM.1 | material | country | variant | grade | user_param | user_unit | eEnergy | eCO2 | recycle | user_value

Description

Environmental parameters

Parameters

material material
STEEL steel
CONCRETE concrete
ALUMINIUM aluminium
GLASS glass
REBAR rebar
country 2 letter country code
variant material variant
grade material grade
user_param user defined parameter
user_unit units for user defined parameter
eEnergy embodied energy
eEnergy_A embodied energy - product stage
CO2e_A embodied CO2e - product stage
CO2e_B embodied CO2e (not used)
CO2e_C embodied CO2e - end of life stage
CO2e_D embodied CO2e - beyond building life
eCO2 embodied CO2
recycle recycled content
user_value user defined parameter

Index


ENV_RES_ELEM

ENV_RES_ELEM | elem | case | permutation

Description

Analysis envelope results

Parameters

elem element number
case analysis case
permutation permutation defining envelope

Index


ENV_RES_NODE

ENV_RES_NODE | node | case | permutation

Description

Analysis envelope results

Parameters

node node number
case analysis case
permutation permutation defining envelope

Index


ERROR_NORM

ERROR_NORM | case | value

Description

Error norm

Parameters

case analysis case
value error

Index


ETA_IN_RESP

ETA_IN_RESP | case | item | eta

Description

Damping in response spectrum analysis

Parameters

case analysis case
item response item
eta response item eta

Index


EXIST

EXIST | key | record

Description

Check that record exists

Parameters

key keyword
record record number

Index


EXPLICIT_HOURGLASS_ENERGY

EXPLICIT_HOURGLASS_ENERGY | case | energy

Description

Explicit time history hourglass energy

Parameters

case analysis case
energy hourglass energy

Index


EXPLICIT_KINETIC_ENERGY

EXPLICIT_KINETIC_ENERGY | case | energy

Description

Explicit time history kinetic energy

Parameters

case analysis case
energy kinetic energy

Index


EXPLICIT_STRAIN_ENERGY

EXPLICIT_STRAIN_ENERGY | case | energy

Description

Explicit time history strain energy

Parameters

case analysis case
energy strain energy

Index


EXPLICIT_TIME

EXPLICIT_TIME | case | time

Description

Explicit time history time step time

Parameters

case analysis case
time timestep time

Index


FOOTFALL

FOOTFALL | node | case | res_resp_factor | res_peak_vel | res_RMS_vel | res_peak_acc | res_RMS_acc | res_crit_node | res_crit_freq | tran_resp_factor | tran_peak_vel | tran_RMS_vel | tran_peak_acc | tran_RMS_acc | tran_crit_node | tran_crit_freq

Description

nodal results of footfall vibration analysis

Parameters

node node number
case analysis case
res_resp_factor resonant analysis maximum response factor
res_peak_vel resonant analysis peak velocity
res_RMS_vel resonant analysis Root-Mean-Square velocity
res_peak_acc resonant analysis peak acceleration
res_RMS_acc resonant analysis Root-Mean-Square acceleration
res_crit_node resonant analysis critical node number
res_crit_freq resonant analysis critical walking frequency
tran_resp_factortransient analysis maximum response factor
tran_peak_vel transient analysis peak velocity
tran_RMS_vel transient analysis Root-Mean-Square velocity
tran_peak_acc transient analysis peak acceleration
tran_RMS_acc transient analysis Root-Mean-Square acceleration
tran_crit_node transient analysis critical node number
tran_crit_freq transient analysis critical walking frequency

Index


FORCE

FORCE | elem | case | pos | x | y | z

Description

1D element force

Parameters

elem element number
case analysis case
pos position
0 | 1
x,y,z forces [N]

Index


FORCE_1D

FORCE_1D | elem | case | pos | x | y | z

Description

1D element force

Parameters

elem element number
case analysis case
pos position on element
0 ≤ pos <= 1
x,y,z forces [N]

Index


FORCE_2D

FORCE_2D | elem | case | pos | xx | yy | xy

Description

2D element force

Parameters

elem element number
case analysis case
pos position on element
-1 | 0 | 1 ... (-1 centre)
xx,yy,xy force tensor [N/m]

Index


FORCE_DENSITY_1D

FORCE_DENSITY_1D | num | name | density

Description

1D element force-density property definition

Parameters

num record number
name name
density force density [N/m]

Index


FORCE_DENSITY_2D

FORCE_DENSITY_2D | num | name | density

Description

2D element force-density property definition

Parameters

num record number
name name
density force density [N/m²]

Index


FREQ

FREQ | case | freq

Description

Frequency

Parameters

case analysis case
freq frequency [/s]

Index


FREQ_DAMPING

FREQ_DAMPING | num | name | table

Description

Freqency-damping definition

Parameters

num record number
name name
table table of frequency v damping values

Index


FREQ_IN_RESP

FREQ_IN_RESP | case | item | freq

Description

Frequency in response spectrum analysis

Parameters

case analysis case
item response item
freq response item frequency [/s]

Index


FREQ_WT_CURVE

FREQ_WT_CURVE | num | name | desc

Description

frequency weighting curve definition

Parameters

num record number
name name
desc description of the frequency weighting curve in text format e.g. (1,0.4) (2,0.4) (5,1.0) (16,1.0) (20,0.8)...

Index


FRONT

FRONT | x | y | z

*** DEPRECATED ***

Index


GEN_REST

GEN_REST.2 | name | x | y | z | xx | yy | zz | list | stage

GEN_REST.1 | x | y | z | xx | yy | zz | list | stage

Description

Generalised restraints

Parameters

name restraint name
x,y,... restraint condition
0 free
1 constrained
list list of nodes
stage list of stages in which constraint is active

Index


GET

GET | key | i | j | k | option

GET | key | i | option

GET | key | i | j | pos

GET | key | option

Description

Get data

Parameters

key keyword
i,j,k item identifier
option result option
pos position on element

Note

i,j,k depend on the data required.

Index


GET_ALL

GET_ALL | key

Description

Get data

Parameters

key keyword

Index


GRID_LAYOUT

GRID_LAYOUT | num | name | explicit | extent_locked | spacing_x | spacing_y | min_extent_x | min_extent_y | max_extent_x | max_extent_y | margin_x | margin_y

Description

Grid layout definition

Parameters

num record number
name name
explicit <not used>
extent_locked locked grid extents
LOCK
NO_LOCK (or blank)
spacing_x spacing in x direction [m]
spacing_y spacing in y direction [m]
min_extent_x minimum grid extent in x [m]
min_extent_y minimum grid extent in y [m]
max_extent_x maximum grid extent in x [m]
max_extent_y maximum grid extent in y [m]
margin_x margin in x [m]
margin_y margin in y [m]

Index


GRID_LINE

GRID_LINE | num | name | arc | coor_x | coor_y | length | theta1 | theta2

Description

Grid line definition

Parameters

num record number
name name
arc line is circular arc
ARC
LINE (or blank)
coor_x X coordinate of start of line or centre of arc [m]
coor_y Y coordinate of start of line or centre of arc [m]
length length of line or radius of arc [m]
theta1 angle of line from X or or to start of arc [°]
theta2 angle to end of arc (ignored if line) [°]

Index


GRID_PLANE

GRID_PLANE.3 | num | name | type | axis | elev | below | above GRID_PLANE.2 | num | name | type | axis | elev | tol | below | above GRID_PLANE.1 | num | name | axis | option | elev | elements | span | angle | layout | tol | type | grid | below | above

Description

Grid plane definition

Parameters

num record number
name name
type type
GENERAL general grid plane
STOREY storey
axis grid plane axis
elev grid elevation [m]
tol grid plane tolerance
below storey tolerance below grid plane if STOREY
above storey tolerance above grid plane if STOREY
option definition option
ELEV plane defined by elevation in axis z direction
elements list of elements in grid plane
span span option
ONE one-way
TWO two-way
MULTI multi-way
angle span angle for one-way spanning [m]
layout <not used>
grid grid expansion
LEGACY/0 legacy algorithm
PLANE_ASPECT/1 plane approx. with adjustemnt for aspect ratio
PLANE_SMOOTH plane approx. with adjustment for aspect ratio & smoothing along edges
PLANE_CORNER plane approx. with adjustment for aspect ratio,
smoothing along edges and corner effects (default)

Note

For a storey grid plane the axis must be global

Index


GRID_SURFACE

GRID_SURFACE.1 | num | name | plane | type | elements | tol | span | angle | grid

Description

Grid surface definition

Parameters

num record number
name name
plane grid plane
type type of elements for load (1 or 2)
elements list of elements in grid surface
tol tolerance for elements in grid surface
span span option
ONE one-way
TWO two-way
angle span angle for one-way spanning [m]
grid grid expansion
LEGACY/0 legacy algorithm
PLANE_ASPECT/1 plane approx. with adjustemnt for aspect ratio
PLANE_SMOOTH plane approx. with adjustment for aspect ratio & smoothing along edges
PLANE_CORNER plane approx. with adjustment for aspect ratio,
smoothing along edges and corner effects (default)

Index


GRID_TOL

GRID_TOL | plane | edge | angle | refinement

*** DEPRECATED ***

Index


GR_VIEW

GR_VIEW (not published)

Index


GSS_PARAM

GSS_PARAM | task | solver | preconditioner | zero | stiff | flat | ratio | SOR factor | residual | auto_cons | subspace | num_Jacobi | tol_Jacobi | num_Conj | tol_Conj | num_nonlin | tol_nonlin | norm | factor | rest | gauss | integration | Sturm | plate | in-plane | condition | eigen | vectors | shift | tied | auto_rest | global_k | random

Description

GSS solver parameters

Parameters

task task number
solver solver method (unused)
preconditionerconjugate gradient pre-conditioner (unused)
zero minimum stiffness value allowed
stiff minimum stiffness value in auto (stiffness) constraints
flat minimum flatness value in auto (geometric) constraints
ratio minimum ratio of low:high stiffness in auto constraints
SOR successive overrelaxation factor [0:2] (unused)
residual flag for residual check
RESIDUAL | NO_CHECK
auto_cons automatic constraint option
AUTO_STIFF stiffness based check
AUTO_GEOM geometry based check
AUTO_KZZ artificial zz stiffness
subspace subspace convergence tolerance
num_Jacobi Jacobi # iterations
tol_Jacobi Jacobi tolerance
num_conj conjugate gradient # iterations (unused)
tol_conj conjugate gradient tolerance (unused)
num_nonlin non-linear # iterations
tol_nonlin non-linear tolerance
norm dynamic modal normalization
DISP normalize to unit displacement
MASS normalize to unit modal mass
factor normalization factor
rest analysis reatraint
0 none
35 horizontal (x=1, y=2, zz=32)
4 vertical (z=4)
Gauss stress at Gauss point or nodes
GAUSS | NODE
integration integration order
INT_LOW | INT_NORM | INT_HIGH
Sturm Sturm sequence check flag
STURM include Sturm check
NO_STURM no Sturm check
plate Plate formulation
MINDLIN Reissner/Mindlin plate theory
MITC MITC theory
in-plane in-plane treatment
BILINEAR no local zz stiffness
ALLMAN_COOK include Allman-Cook zz stiffness terms
condition flag for condition check
CONDITION | NO_CHECK
eigen eigen solver method
SUBSPACE subspace iteration eigensolver including shifting & locking
SPECTRA Lanczos Method using Spectra
EIGEN_SUBSPACE_JACOBI traditional subspace iteration eigensolver (deprecated)
EIGEN_SUBSPACE_SHIFT improved subspace iteration eigensolver including shifting & locking (deprecated)
vectors number of subspace vectors (0 = auto)
shift shift strategy
NONE
CONSERVATIVE
AGGRESSIVE
tied extra degrees of freedom for tied interface nodes on 2D elements
TIED add degrees of freedom for tied interface nodes
NO_TIED no extra degrees of freedom for tied interface nodes
global_k global stiffness factor (deprecated)
0 no factor applied
random randomize the ritz vectors

Note

Gauss and integration should not be adjusted by users

Index


HIGHEST

HIGHEST | key

Description

Get highest record number

Parameters

key keyword

Index


INERTIA

INERTIA | case | Ixx | Iyy | Izz | Ixy | Iyz | Izx

Description

Structure inertia

Parameters

case analysis case
Ixx,Iyy,... inertia tensor [kg.m²]

Index


INERTIA_ACT

INERTIA_ACT | case | xx | yy | zz

Description

Structure active mass

Parameters

case analysis case
xx,yy,zz active inertia in the global directions [kgm²]

Index


INERTIA_NODE

INERTIA_NODE | node | case | Ixx | Iyy | Izz | Ixy | Iyz | Izx

Description

Nodal mass

Parameters

node node number
case analysis case
Iij ij inertia term [kgm²]

Index


INF_BEAM

INF_BEAM | name | action | elem | pos | factor | type | axis | dir

Description

Beam influence definition

Parameters

name name
action action number
elem element
pos position on element
factor multiplier
type influence type
FORCE | DISP
axis influence axis
dir influence direction
X | Y | Z | XX | YY | ZZ

Index


INF_BEAM_RES

INF_BEAM_RES | case | num_infl | num_zone ( | num_zone_pos ( | zone_pos_value ) )

Description

Beam influence results

Parameters

case analysis case
num_infl number of influence lines
num_zone number of zones
((
num_zone_posnumber of positions
((
zone_pos_valuevalues
))
))

Index


INF_NODE

INF_NODE | name | action | node | factor | type | axis | dir

Description

Node influence definition

Parameters

name name
action action number
node node
factor multiplier
type influence type
FORCE | DISP
axis influence axis
dir influence direction
X | Y | Z | XX | YY | ZZ

Index


INF_NODE_RES

INF_NODE_RES | case | num_infl | num_zone ( | num_zone_pos ( | zone_pos_value ) )

Description

Node influence results

Parameters

case analysis case
num_infl number of influence lines
num_zone number of zones
((
num_zone_posnumber of positions
((
zone_pos_valuevalues
))
))

Index


INF_POS

INF_POS | case | num_path ( | path_start | path_end )

Description

Influence positions

Parameters

case analysis case
num_path number of paths
((
path_start start posititon [m]
path_end end posititon [m]
))

Index


JOINT

JOINT.2 | name | constrained_node | x | y | z | xx | yy | zz | primary_node | stage

JOINT.1 | constrained_node | x | y | z | xx | yy | zz | primary_node | stage

Description

Joint definition

Parameters

name joint name
constrained_node constrained node
x,y,... linked condition
0 free
1 constrained
primary_node primary node
stage list of stages in which constraint is active

Index


LINE

LINE.3 | ref | name | colour | type | topology_1 | topology_2 | topology_3 | radius | axis | x | y | z | xx | yy | zz | Kx | Ky | Kz | Kxx | Kyy | Kzz | CM2_MESHTOOLS{step_definition | elem_len_start | elem_len_end | num_elem} | tied_int

LINE.3 | ref | name | colour | type | topology_1 | topology_2 | topology_3 | radius | axis | x | y | z | xx | yy | zz | Kx | Ky | Kz | Kxx | Kyy | Kzz | QUAD_BUILD{step_definition | step_size | num_seg | step_ratio} | tied_int

LINE.2 | ref | name | colour | type | topology_1 | topology_2 | topology_3 | radius | axis | x | y | z | xx | yy | zz | Kx | Ky | Kz | Kxx | Kyy | Kzz | step_definition | step_size | num_seg | step_ratio | tied_int

LINE.1 | ref | name | type | topology_1 | topology_2 | topology_3 | radius | axis | x | y | z | xx | yy | zz | Kx | Ky | Kz | Kxx | Kyy | Kzz | step_definition | step_size | num_seg | step_ratio

Description

line definition

Parameters

ref number
name name
colour colour (ref. colour syntax)
type line type
LINE | ARC_RADIUS | ARC_THIRD_PT
topology_1 topology (line references)
topology_2 topology (line references)
topology_3 topology (line references)
radius arc radius
axis constraint axis
GLOBAL
# axis number
x,y,... restraint condition to be applied to nodes generated along this line
0 free
1 restrained
Kx,Ky,... nodal stiffnesses to be applied to nodes generated along this line [N/m][Nm]
QUAD_BUILD quad-build mesh generator attributes
CM2_MESHTOOLSCM2 MeshTools mesh generator attributes
step_definitionmeshgen: step definition
USE_REGION_STEP_SIZE uses element size specified in region
STEP_SIZE element size specified
NUM_SEGMENTS number of elements
step_size meshgen: desirable distance between nodes on this line (if step size specified)
num_seg meshgen: desirable number of segments on this line (if number of segments specified)
step_ratio meshgen: ratio between last and first step values on this line (if number of segments specified)
elem_len_startMeshTools: length of the element at the start of the line (if step size specified)
elem_len_endMeshTools: length of the element at the end of the line (if step size specified)
num_elem MeshTools: desirable number of elements along the line (if number of segments specified)
tied_int meshgen: tie meshes of all regions along this line

Index


LIST

LIST | num | name | type | list

Description

List definition

Parameters

num record number
name name
type list type
NODE node list
ELEMENT element list
MEMBER member list
CASE case list
LINE line list
AREA area list
REGION region list
POLYLINE polyline list
UNDEF list of undefined type
list list definition

Index


LOAD_1D_THERMAL

LOAD_1D_THERMAL.3 | name | entity type | entity list | case | type | value

LOAD_1D_THERMAL.3 | name | entity type | entity list | case | type | pos_1 | value_1 | pos_2 | value_2

LOAD_1D_THERMAL.2 | name | element list | case | type | value

LOAD_1D_THERMAL.2 | name | element list | case | type | pos_1 | value_1 | pos_2 | value_2

LOAD_1D_THERMAL.1 | element list | case | type | value

LOAD_1D_THERMAL.1 | element list | case | type | pos_1 | value_1 | pos_2 | value_2

Description

Beam thermal load definition

Parameters

name name of the load
entitytype entity type
ELEMENT
entitylist list of loaded entities
elementlist list of elements
case load case number
type load type
CONS constant temperature
DY gradient in y direction of element
DZ gradient in z direction of element
value load value
pos_1 position 1 in load direction [m]
value_1 temperature at position 1 [°C]
pos_2 position 2 in load direction [m]
value_2 temperature at position 2 [°C]

Index


LOAD_2D_EDGE

LOAD_2D_EDGE.2 | name | list | case | axis | edge | dir | value(2)

LOAD_2D_EDGE.1| list | case | axis | edge | dir | value(2)

Description

2D element edge load definition

Parameters

name name of the load
list list of elements
case load case number
axis axis in which load acts
edge edge number
dir load direction
X | Y | Z
value() load values [N/m²]

Index


LOAD_2D_FACE

LOAD_2D_FACE.3 | name | entity type | entity list | case | axis | type | proj | dir | value(n) | r | s | equation | equation axis | equation pressure unit | equation length unit | equation angle unit | is uniform

LOAD_2D_FACE.2 | name | element list | case | axis | type | proj | dir | value(n) | r | s

LOAD_2D_FACE.1| element list | case | axis | type | proj | dir | value(n)

Description

2D element face load definition

Parameters

name name of the load
entitytype entity type
ELEMENT
style="padding-right:6em;">MEMBER
entitylist list of loaded entities elementlist list of elements case load case number axis axis in which load acts type load type
CONS constant (one value)
GEN variable (one value for each corner node)
POINT point (one value)
style="padding-right:6em;">EQUATION equation (zero values) proj flag for projected loads
YES | NO
dir load direction
X | Y | Z
value() load values [N/m²] r,s load position (for POINT type only) equation load as a function of x,y,z position (for EQUATION type only) equationaxis axis system for the equation (for EQUATION type only) equationpressure unit units of pressure in the equation (for EQUATION type only) equationlength unit units of length in the equation (for EQUATION type only) equationangle unit units of angle in the equation (for EQUATION type only) isuniform is the equation uniform or variable across each element (for EQUATION type only)
UNIFORM | VARIABLE

Index


LOAD_2D_PRE

LOAD_2D_PRE.3 | name | entity type | entity list | case | dir | value

LOAD_2D_PRE.2 | name | element list | case | dir | value

LOAD_2D_PRE.1 | element list | case | dir | value

Description

2D element prestress load definition

Parameters

name name of the load
entitytype entity type
ELEMENT
style="padding-right:6em;">MEMBER
entitylist list of loaded entities elementlist list of elements case load case number dir load direction
BOTH in both x and y directions
X
Y
value load values [N/m]

Index


LOAD_2D_STRN

LOAD_2D_STRN.3 | name | entity type | entity list | case | dir | value

LOAD_2D_STRN.2 | name | element list | case | dir | value

LOAD_2D_STRN.1 | element list | case | dir | value

Description

2D element initial strain load definition

Parameters

name name of the load
entitytype entity type
ELEMENT
style="padding-right:6em;">MEMBER
entitylist list of loaded entities elementlist list of elements case load case number dir load direction
BOTH in both x and y directions
X
Y
value load values [N/m²]

Index


LOAD_2D_TENDON

LOAD_2D_TENDON.3 | name | entity type | entity list | case | dir | value | offset

LOAD_2D_TENDON.2 | name | element list | case | dir | value | offset

LOAD_2D_TENDON.1 | element list | case | dir | value | offset

Description

2D element prestress load definition

Parameters

name name of the load
entitytype entity type
ELEMENT
style="padding-right:6em;">MEMBER
entitylist list of loaded entities elementlist list of elements case load case number dir load direction
BOTH in both x and y directions
X
Y
value load values [N/m] offset prestress offset [m]

Index


LOAD_2D_THERMAL

LOAD_2D_THERMAL.3 | name | entity type | entity list | case | type | values(n)

LOAD_2D_THERMAL.2 | name | element list | case | type | values(n)

LOAD_2D_THERMAL.1 | element list | case | type | values(n)

Description

2D element thermal load definition

Parameters

name name of the load
entitytype entity type
ELEMENT
style="padding-right:6em;">MEMBER
entitylist list of loaded entities elementlist list of elements case load case number type load type
CONS constant temperature (1 value)
DZ gradient in z direction of element (2 values)
GEN general temperature distribution (6/8 values)
values() load values [°C]

Index


LOAD_3D_FACE

LOAD_3D_FACE.2 | name | list | case | axis | type | proj | face | dir | value(n)

LOAD_3D_FACE.1 | name | list | case | axis | type | proj | face | value(n)

Description

3D element face load definition

Parameters

name name of the load
list list of elements
case load case number
axis axis in which load acts
type load type
CONS constant (one value for element)
GEN variable (one value for each corner node)
proj flag for projected loads
YES | NO
face face index
0 Bottom
1 Top
2 Front
3 Right
4 Back
5 Left
dir load direction
X | Y | Z
value() load values [N/m³]

Index


LOAD_3D_THERMAL

LOAD_3D_THERMAL.2 | name | entity type | entity list | case | type | values(n)

LOAD_3D_THERMAL.1 | name | element list | case | type | values(n)

Description

3D element thermal load definition

Parameters

name name of the load
entitytype entity type
ELEMENT
style="padding-right:6em;">MEMBER
entitylist list of loaded entities elementlist list of elements case load case number type load type
CONS constant temperature (1 value)
GEN general temperature distribution (8 values)
values() load values [°C]

Index


LOAD_BEAM

LOAD_BEAM

Description

Keyword for use in GwaCommand command strings for getting information on beam loading records, i.e. LOAD_BEAM_POINT, LOAD_BEAM_UDL, LOAD_BEAM_LINE, LOAD_BEAM_PATCH and LOAD_BEAM_TRILIN records

Index


LOAD_BEAM_DIST

LOAD_BEAM_DIST.2 | name | list | case | dir | pos | value

LOAD_BEAM_DIST.1 | list | case | dir | pos | value

Description

1D entity distortion load definition

Parameters

name name of the load
list list of elements
case load case number
dir load direction
X | Y | Z | XX | YY | ZZ
pos load position
+ve value length [m]
-ve - proportion of element length
value load value [m][-]

Index


LOAD_BEAM_LENG

LOAD_BEAM_LENG.3 | name | entity type | entity list | case | value

LOAD_BEAM_LENG.2 | name | element list | case | value

LOAD_BEAM_LENG.1 | element list | case | value

Description

Beam initial length (lack of fit) load definition

Parameters

name name of the load
entitytype entity type
MEMBER
ELEMENT
entitylist list of loaded entities
elementlist list of elements
case load case number
value change in length [m]

Index


LOAD_BEAM_LINE

LOAD_BEAM_LINE.3 | name | entity type | entity list | case | axis | proj | dir | value_1 | value_2

LOAD_BEAM_LINE.2 | name | element list | case | axis | proj | dir | value_1 | value_2

LOAD_BEAM_LINE.1 | element list | case | axis | proj | dir | value_1 | value_2

Description

1D entity linear load definition

Parameters

name name of the load
entitytype entity type
MEMBER
ELEMENT
entitylist list of loaded entities
elementlist list of elements
case load case number
axis axis number in which load acts
GLOBAL
LOCAL
NATURAL deformed local
n axis numbers
proj projection flag
YES | NO
dir load direction
X | Y | Z | XX | YY | ZZ
value_1 load value at start [N/m][N]
value_2 load value at end [N/m][N]

Index


LOAD_BEAM_PATCH

LOAD_BEAM_PATCH.3 | name | entity type | entity list | case | axis | proj | dir | pos_1 | value_1 | pos_2 | value_2

LOAD_BEAM_PATCH.2 | name | element list | case | axis | proj | dir | pos_1 | value_1 | pos_2 | value_2

LOAD_BEAM_PATCH.1 | element list | case | axis | proj | dir | pos_1 | value_1 | pos_2 | value_2

Description

1D entity patch load definition

Parameters

name name of the load
entitytype entity type
MEMBER
ELEMENT
entitylist list of loaded entities
elementlist list of elements
case load case number
axis axis number in which load acts
GLOBAL
LOCAL
NATURAL deformed local
n axis number
proj projection flag
YES | NO
dir load direction
X | Y | Z | XX | YY | ZZ
pos_1 start load position
+ve value length [m]
-ve - proportion of element length
value_1 load value at start [N/m][N]
pos_2 end load position
+ve value length [m]
-ve - proportion of element length
value_2 load value at end [N/m][N]

Index


LOAD_BEAM_POINT

LOAD_BEAM_POINT.3 | name | entity type | entity list | case | axis | proj | dir | pos | value

LOAD_BEAM_POINT.2 | name | element list | case | axis | proj | dir | pos | value

LOAD_BEAM_POINT.1 | element list | case | axis | proj | dir | pos | value

Description

1D entity point load definition

Parameters

name name of the load
entitytype entity type
MEMBER
ELEMENT
entitylist list of loaded entities
elementlist list of elements
case load case number
axis axis number in which load acts
GLOBAL
LOCAL
NATURAL deformed local
n axis number
proj projection flag
YES | NO
dir load direction
X | Y | Z | XX | YY | ZZ
pos load position
+ve value length
-ve - proportion of element length
value load value [N][N.m]

Index


LOAD_BEAM_POLY

LOAD_BEAM_POLY | list | case | axis | proj | dir | table

*** DEPRECATED ***

Index


LOAD_BEAM_PRE

LOAD_BEAM_PRE.3 | name | entity type | entity list | case | value

LOAD_BEAM_PRE.2 | name | element list | case | value

LOAD_BEAM_PRE.1 | element list | case | value

Description

1D entity prestress load definition

Parameters

name name of the load
entitytype entity type
MEMBER
ELEMENT
entitylist list of loaded entities
elementlist list of elements
case load case number
value load value [N]

Index


LOAD_BEAM_STRN

LOAD_BEAM_STRN.3 | name | entity type | entity list | case | value

LOAD_BEAM_STRN.2 | name | element list | case | value

LOAD_BEAM_STRN.1 | element list | case | value

Description

Beam initial strain load definition

Parameters

name name of the load
entitytype entity type
MEMBER
ELEMENT
entitylist list of loaded entities
elementlist list of elements
case load case number
value strain value [-]

Index


LOAD_BEAM_TEN

LOAD_BEAM_TEN.3 | name | entity type | entity list | case | value | y | z

LOAD_BEAM_TEN.2 | name | element list | case | value | y | z

LOAD_BEAM_TEN.1 | element list | case | value | y | z

Description

Beam tendon prestress load definition

Parameters

name name of the load
entitytype entity type
MEMBER
ELEMENT
entitylist list of loaded entities
elementlist list of elements
case load case number
value load value [N]
y,z load position in section [m]

Index


LOAD_BEAM_TRILIN

LOAD_BEAM_TRILIN.3 | name | entity type | entity list | case | axis | proj | dir | pos_1 | value_1 | pos_2 | value_2

LOAD_BEAM_TRILIN.2 | name | element list | case | axis | proj | dir | pos_1 | value_1 | pos_2 | value_2

LOAD_BEAM_TRILIN.1 | element list | case | axis | proj | dir | pos_1 | value_1 | pos_2 | value_2

Description

1D entity tri-linear load definition

Parameters

name name of the load
entitytype entity type
MEMBER
ELEMENT
entitylist list of loaded entities
elementlist list of elements
case load case number
axis axis number in which load acts
GLOBAL
LOCAL
NATURAL deformed local
n axis number
proj projection flag
YES | NO
dir load direction
X | Y | Z | XX | YY | ZZ
pos_1 start load position
+ve value length [m]
-ve - proportion of element length
value_1 load value at start [N/m][N]
pos_2 end load position
+ve value length [m]
-ve - proportion of element length
value_2 load value at end [N/m][N]

Index


LOAD_BEAM_UDL

LOAD_BEAM_UDL.3 | name | entity type | entity list | case | axis | proj | dir | value

LOAD_BEAM_UDL.2 | name | element list | case | axis | proj | dir | value

LOAD_BEAM_UDL.1 | element list | case | axis | proj | dir | value

Description

1D entity uniform load definition

Parameters

name name of the load
entitytype entity type
MEMBER
ELEMENT
entitylist list of loaded entities
elementlist list of elements
case load case number
axis axis number in which load acts
proj projection flag
YES | NO
dir load direction
X | Y | Z | XX | YY | ZZ
value load value [N/m][N]

Index


LOAD_CURVE

LOAD_CURVE | num | name | abs | ord | table

Description

Load curve definition

Parameters

num record number
name name
abs dimension on abscissa
TIME
NULL
ord dimension on ordinate (ref. dimension syntax)
table table of load curve points

Index


LOAD_FAC

LOAD_FAC | case | factor

Description

Buckling load factor

Parameters

case analysis case
factor load factor

Index


LOAD_FACTOR_DISP

LOAD_FACTOR_DISP | case | node | dir | num_pos ( | pos_factor | pos_disp )

Description

Load factor results

Parameters

case analysis case
node node
dir direction
num_pos number of positions
((
pos_factor displacement factor
pos_disp displacement value
))

Index


LOAD_GRAV

LOAD_GRAV | case | x | y | z

*** DEPRECATED ***

Index


LOAD_GRAVITY

LOAD_GRAVITY.4 | name | entity type | entity list | nodelist | case | x | y | z

LOAD_GRAVITY.3 | name | element list | nodelist | case | x | y | z

LOAD_GRAVITY.2 | name | element list | case | x | y | z

LOAD_GRAVITY.1 | elemlist | case | x | y | z

Description

Gravity load definition

Parameters

name name of the load
entitytype entity type
MEMBER
ELEMENT
entitylist list of loaded entities
elementlist list of elements
nodelist list of nodes
case load case number
x x gravitational acceleration
y y gravitational acceleration
z z gravitational acceleration

Note

A z value of -1 corresponds to a normal gravity load.

Index


LOAD_GRID_AREA

LOAD_GRID_AREA.2 | name | grid_surface | area | poly | case | axis | proj | dir | value

LOAD_GRID_AREA.1 | grid_plane | area | poly | case | axis | proj | dir | value

Description

Grid area load definition

Parameters

name name of the load
grid_surfacegrid surface
area load area option
PLANE whole plane loaded
POLYREF reference to polygon bounding the load
POLYGON polygon bounding the load
poly polygon which defines the load
ignored for PLANE
reference for POLYREF
polygon definition for POLYGON
case load case number
axis axis in which load acts
proj flag for projected load
dir load direction
X | Y | Z
value load value [N/m²]

Index


LOAD_GRID_LINE

LOAD_GRID_LINE.2 | name | grid_surface | line | poly | case | axis | proj | dir | value_1 | value_2

LOAD_GRID_LINE.1 | grid_plane | line | poly | case | axis | proj | dir | value_1 | value_2

Description

Grid line load definition

Parameters

name name of the load
grid_surfacegrid surface
line load line option
POLYREF reference to polygon defining the load
POLYGON polygon defining the load
poly polygon which defines the load
reference for POLYREF
polygon definition for POLYGON
case load case number
axis axis in which load acts
proj flag for projected load
YES | NO
dir load direction
X | Y | Z
value_1 load value at start [N/m]
value_2 load value at end [N/m]

Index


LOAD_GRID_POINT

LOAD_GRID_POINT.2 | name | grid_surface | x | y | case | axis | dir | value

LOAD_GRID_POINT.1 | grid_plane | x | y | case | axis | dir | value

Description

Grid point load definition

Parameters

name name of the load
grid_surfacegrid surface
x,y grid coordinates
case load case number
axis axis in which load acts
dir load direction
X | Y | Z
value load value [N]

Index


LOAD_NODE

LOAD_NODE.2 | name | list | case | axis | dir | value

LOAD_NODE.1 | list | case | axis | dir | value

Description

Node load definition

Parameters

name name of the load
list list of nodes
case load case number
axis axis number in which load acts
dir load direction
X | Y | Z | XX | YY | ZZ
value load [N]

Index


LOAD_TITLE

LOAD_TITLE.2 | case | title | type | source | category | dir | include | bridge

LOAD_TITLE.1 | case | title | type.1 | bridge

Description

Load case title definition

Parameters

case case number
title load case title
type load type
LC_UNDEF undefined
LC_PERM_SELF Permanent | Self weight
LC_PERM_SOIL Permanent | Soil
LC_PERM_EQUIV Permanent | Equivalent
LC_PRESTRESS Prestress
LC_VAR_IMP Variable | Imposed
LC_VAR_ROOF Variable | Imposed (roof)
LC_VAR_WIND Variable | Wind
LC_VAR_SNOW Variable | Snow
LC_VAR_RAIN Variable | Rain
LC_VAR_TEMP Variable | Thermal
LC_VAR_EQUIV Variable | Equivalent
LC_ACCIDENTAL Accidental
LC_EQE_ACC Seismic | Accidental torsion
type.1 load type (also valid as a LOAD_TITLE.2 type)
DEAD
IMPOSED
WIND
SNOW
NOTIONAL
SEISMIC
UNDEF
source source for grouping of load cases
category category of variable loads (Eurocode only) (A to H)
dir load direction
X | Y
include include option
INC_UNDEF undefined
INC_SUP unfavourable
INC_INF favourable
INC_BOTH unfavourable & favourable
bridge optional flag for bridge analysis
STANDARD (or blank) not a bridge analysis case
BRIDGE a bridge analysis case

Index


LOCATION

LOCATION | north | elevation | country | latitude | longitude

Description

Location information

Parameters

north angle of north from global X
elevation elevation of model
country country
latitude location
longitude location

Index


LOCKED

LOCKED | key | record

Description

Check locked status

Parameters

key key word
record record number

Index


LOCKED

LOCKED | key | record

Parameters

key key word
record record number

Index


MASS

MASS | case | value

Description

Structure mass

Parameters

case analysis case
value structure mass [kg]

Index


MASS_ACT

MASS_ACT | case | x | y | z

Description

Structure active mass

Parameters

case analysis case
x,y,z active mass in the global directions [kg]

Index


MASS_IN_RESP

MASS_IN_RESP | case | item | mass

Description

Mass in response spectrum analysis

Parameters

case analysis case
item response item
mass response item effective mass [kg]
three values for CQC3 combination

Index


MASS_NODE

MASS_NODE | node | case | mass

Description

Nodal mass

Parameters

node node number
case analysis case
mass nodal mass [kg]

Index


MAT

MAT.11 | num | name | E | f | nu | G | rho | alpha | <prop> | num_uc (| abs | ord | pts[] |) num_sc (| abs | ord | pts[] |) num_ut (| abs | ord | pts[] |) num_st (| abs | ord | pts[] |) eps | <uls> | <sls> | cost | type | env | env_param

MAT.10 | num | name | E | f | nu | G | rho | alpha | <prop> | num_uc (| abs | ord | pts[] |) num_sc (| abs | ord | pts[] |) num_ut (| abs | ord | pts[] |) num_st (| abs | ord | pts[] |) eps | <uls> | <sls> | cost | type

MAT.8 | num | name | mod | E | nu | G | rho | alpha | <prop> | num_uc (| abs | ord | pts[] |) num_sc (| abs | ord | pts[] |) num_ut (| abs | ord | pts[] |) num_st (| abs | ord | pts[] |) eps | <uls> | <sls> cost

MAT.6 | num | name | mod | E | nu | rho | alpha | num_uc (| abs | ord | pts[] |) num_sc (| abs | ord | pts[] |) num_ut (| abs | ord | pts[] |) num_st (| abs | ord | pts[] |) eps | <uls> | <sls> cost

MAT.4 | num | name | E | nu | rho | alpha | num_uc (| abs | ord | pts[] |) num_sc (| abs | ord | pts[] |) num_ut (| abs | ord | pts[] |) num_st (| abs | ord | pts[] |) eps | <uls> | <sls>

Note

This should not be used directly but as part of grade record

Parameters

num material number (if not embedded)
name name
mod modified from standard
TRUE
FALSE
E elastic modulus
f strength
nu Poisson's ratio
G shear modulus
rho density
alpha thermal expansivity
<prop> analysis properties (see MAT_ANAL)
num_uc number of points for explicit ULS compression curve
num_sc number of points for explicit SLS compression curve
num_ut number of points for explicit ULS tension curve
num_st number of points for explicit SLS tension curve
abs unit type for abscissa - only written if num_?? > 0
ord unit type for ordinate - ditto
pts[] points defining curve - ditto
eps limit strain
<uls> uls curve (see MAT_CURVE_PARAM)
<sls> sls curve (see MAT_CURVE_PARAM)
cost cost
type material type normally can be inferred from specific grade record
STEEL
CONCRETE
FRP
ALUMINIUM
TIMBER
GLASS
FABRIC
REBAR
GENERIC
env environmental parameters present
TRUE
FALSE
<env_param> environmental parameters (see ENV_PARAM)

Index


MATRIX

MATRIX | rec | num ( | node_i | dir_i | node_j | dir_j | k_ij | m_ij )

Description

External stiffness/mass matrix

Parameters

rec record number
num number of terms
((
node_i node representing row
dir_i component representing row
node_j node representing column
dir_j component representing column
k_ij stiffness
m_ij mass
))

Note

Always written in SI units

Index


MAT_ALUMINIUM

MAT_ALUMINIUM.9 | num | name | E | F | nu | G | rho | alpha | num_uc (| abs | ord | pts[] |) num_sc (| abs | ord | pts[] |) num_ut (| abs | ord | pts[] |) num_st (| abs | ord | pts[] |) eps | <uls> | <sls> cost

Description

Material

Parameters

num material number (if not embedded)
name name
mod modified from standard
F strength
E elastic modulus
nu Poisson's ratio
G shear modulus
rho density
alpha thermal expansivity
analysis properties (see MAT_ANAL)
num_uc number of points for explicit ULS compression curve
num_sc number of points for explicit SLS compression curve
num_ut number of points for explicit ULS tension curve
num_st number of points for explicit SLS tension curve
abs unit type for abscissa
ord unit type for ordinate
pts[] points defining curve
eps limit strain
<uls> uls curve (see MAT_CURVE_PARAM)
<sls> sls curve (see MAT_CURVE_PARAM)
cost cost

Index


MAT_ANAL

MAT_ANAL | num | MAT_DRUCKER_PRAGER | name | colour | 10 | G | nu | rho | cohesion | phi | psi | Eh | scribe | alpha | damp

Description

Drucker-Prager material definition

Parameters

num record number
name name
colour colour (ref. colour syntax)
G shear modulus [N/m²]
nu Poisson's ratio
rho density [kg/m³]
cohesion cohesion [N/m²]
phi friction angle [°]
psi dilation [°]
Eh hardening modulus [N/m²]
scribe Yield inscribed/circumscribed (1 inscribed, -1 circumscribed)
alpha coefficient of thermal expansion [/°C]
damp material damping fraction

Index


MAT_ANAL

MAT_ANAL | num | MAT_ELAS_ISO | name | colour | 6 | E | nu | rho | alpha | G | damp |

Description

Isotropic-elastic material

Parameters

num record number
name name
colour colour (ref. colour syntax)
E Young's modulus [N/m²]
nu Poisson's ratio
rho density [kg/m³]
alpha coefficient of thermal expansion [/°C]
G shear modulus [N/m²]
0 use formula E / (2ν + 2)
damp material damping fraction

Index


MAT_ANAL

MAT_ANAL | num | MAT_ELAS_ORTHO | name | colour | 14 | Ex | Ey | Ez | nuxy | nuyz | nuzx | rho | alphax | alphay | alphaz | Gxy | Gyz | Gzx | damp

Description

Isotropic-elastic material definition

Parameters

num record number
name name
colour colour (ref. colour syntax)
Ex Young's modulus, axial [N/m²]
Ey Young's modulus, y
Ez Young's modulus, z
nuxy Poisson's ratio, x to y
nuyz Poisson's ratio, y to z
nuzx Poisson's ratio, z to x
rho density [kg/m³]
alphax coefficient of thermal expansion, axial [/°C]
alphay coefficient of thermal expansion, y
alphaz coefficient of thermal expansion, z
Gxy shear modulus, x to y [N/m²] (must be provided)
Gyz shear modulus, y to z
Gzx shear modulus, z to x
damp material damping fraction

Index


MAT_ANAL

MAT_ANAL | num | MAT_ELAS_PLAS_ISO | name | colour | 9 | E | nu | rho | alpha | yield | ultimate | Eh | beta | damp

Description

Isotropic-elastic material (with yield) definition

Parameters

num record number
name name
colour colour (ref. colour syntax)
E Young's modulus [N/m²]
nu Poisson's ratio
rho density [kg/m³]
alpha coefficient of thermal expansion [/°C]
yield yield stress [N/m²]
ultimate ultimate stress [N/m²]
Eh hardening modulus [N/m²]
beta hardening parameter
damp material damping fraction

Index


MAT_ANAL

MAT_ANAL | num | MAT_FABRIC | name | colour | 4 | Ex | Ey | nu | G | 1 | comp

Description

Elastic-fabric material definition

Parameters

num record number
name name
colour colour (ref. colour syntax)
Ex Young's modulus in x [N/m]
Ex Young's modulus in y [N/m]
nu Poisson's ratio in xy
G shear modulus in xy [N/m] (must be provided)
comp compression flag
material does not take compression
COMP material takes compression

Index


MAT_ANAL

MAT_ANAL | num | MAT_MOHR_COULOMB | name | colour | 13 | G | nu | rho | c | phi | psi | Eh | alpha | damp | k0 | ref_level | G_gradient | c_gradient

Description

Mohr-Coulomb material definition

Parameters

num record number
name name
colour colour (ref. colour syntax)
G shear modulus [N/m²]
nu Poisson's ratio
rho density [kg/m³]
cohesion cohesion [N/m²]
phi friction angle [°]
psi dilation [°]
Eh hardening modulus [N/m²]
alpha coefficient of thermal expansion [/°C]
damp material damping fraction
k0 earth pressure constant
ref_level reference level for G and cohesion
G_gradient gradient of G with depth
c_gradient gradient of cohension with depth

Index


MAT_ANAL

MAT_ANAL | num | OSEES_BARSLIP | name | colour | 10 | $fc | $fy | $Es | $fu | $Eh | $ld | $db | $depth | $height | $ancLratio | 4 | $nb | $bsFlag | $type | $damage | 0

MAT_ANAL | num | OSEES_CONCRETE01 | name | colour | 4 | $fpc | $epsc0 | $fpcu | $epsU | 0 | 0

MAT_ANAL | num | OSEES_CONCRETE02 | name | colour | 7 | $fpc | $epsc0 | $fpcu | $epsU | $lambda | $ft | $Ets | 0 | 0

MAT_ANAL | num | OSEES_CONCRETE03 | name | colour | 10 | $fpc | $epsc0 | $fpcu | $epsU | $lambda | $ft | $epst0 | $ft0 | $beta | $epstu | 0 | 0

MAT_ANAL | num | OSEES_CONCRETE04 | name | colour | 7 | $fc | $ec | $ecu | $Ec | $fct | $et | $beta | 0 | 0

MAT_ANAL | num | OSEES_ELASTICPP | name | colour | 4 | $e | $epsyP | $epsyN | $eps0 | 0 | 0

MAT_ANAL | num | OSEES_HARDENING | name | colour | 5 | $e | $sigmaY | $H_iso | $H_kin | $eta | 0 | 0

MAT_ANAL | num | OSEES_HYSTERETIC | name | colour | 17 | $s1p | $e1p | $s2p | $e2p | $s3p | $e3p | $s1n | $e1n | $s2n | $e2n | $s3n | $e3n | $pinchX | $pinchY | $damage1 | $damage2 | $beta | 0 | 0

MAT_ANAL | num | OSEES_LIMITSTATE_AXIAL | name | colour | 21 | $s1p | $e1p | $s2p | $e2p | $s3p | $e3p | $s1n | $e1n | $s2n | $e2n | $s3n | $e3n | $pinchX | $pinchY | $damage1 | $damage2 | $beta | $Fsw | $Kdeg | $Fres | $delta | 7 | $eleTag | $defType | $forType | $ndI | $ndJ | $dof | $perpDirn | 0

MAT_ANAL | num | OSEES_LIMITSTATE_SHEAR | name | colour | 26 | $s1p | $e1p | $s2p | $e2p | $s3p | $e3p | $s1n | $e1n | $s2n | $e2n | $s3n | $e3n | $pinchX | $pinchY | $damage1 | $damage2 | $beta | $rho | $fc | $b | $h | $d | $Fsw | $Kdeg | $Fres | $delta | 7 | $eleTag | $defType | $forType | $ndI | $ndJ | $dof | $perpDirn | 0

MAT_ANAL | num | OSEES_REINFORCINGSTEEL_CMFATIGUE | name | colour | 9 | $fy | $fu | $Es | $Esh | $esh | $eult | $Cf | $alpha | $Cd | 0 | 0

MAT_ANAL | num | OSEES_REINFORCINGSTEEL_DMBUCK | name | colour | 8 | $fy | $fu | $Es | $Esh | $esh | $eult | $lsr | $alpha | 0 | 0

MAT_ANAL | num | OSEES_REINFORCINGSTEEL_GABUCK | name | colour | 10 | $fy | $fu | $Es | $Esh | $esh | $eult | $lsr | $beta | $r | $gamma | 0 | 0

MAT_ANAL | num | OSEES_REINFORCINGSTEEL_ISOHARD | name | colour | 8 | $fy | $fu | $Es | $Esh | $esh | $eult | $a1 | $limit | 0 | 0

MAT_ANAL | num | OSEES_REINFORCINGSTEEL_MPCURVEPARAMS | name | colour | 9 | $fy | $fu | $Es | $Esh | $esh | $eult | $R1 | $R2 | $R3 | 0 | 0

MAT_ANAL | num | OSEES_STEEL01 | name | colour | 7 | $Fy | $E0 | $b | $a1 | $a2 | $a3 | $a4 | 0 | 0

MAT_ANAL | num | OSEES_STEEL02 | name | colour | 11 | $Fy | $e | $b | $R0 | $cR1 | $cR2 | $a1 | $a2 | $a3 | $a4 | $sigInit | 0 | 0

MAT_ANAL | num | OSEES_VISCOUS | name | colour | 2 | $c | $alpha | 0 | 0

Description

OpenSees material definitions

Parameters

num record number
name name
colour colour (ref. colour syntax)

Note

See the OpenSees manual to explain the parameters

Index


MAT_CONCRETE

MAT_CONCRETE | num | <mat> | type | cement | fc | fcd | fcdc | fcdt | fcfib | EmEs | n | Emod | eps_peak | eps_max | eps_u | eps_ax | eps_tran | eps_axs | light | agg | 0.0 | xd_min | xd_max | beta | shrink | confine | fcc | eps_plas_c |eps_u_c

Description

Concrete material

Parameters

num concrete material number
<mat> basic material definition (see MAT)
type strength type
CUBE
CYLINDER
cement cement class
N normal
S slow
R rapid hardening
fc concrete strength
fcd design strength
fcdc cracked strength
fcdt tensile strength
fcfib peak strength for FIB/Popovics curves
EmEs ratio of initial elastic modulus to secant modulus
n parabolic coefficient (normally 2)
Emod modifier on elastic stiffness typically in range (0.8:1.2)
eps_peak concrete strain at peak SLS stress
eps_max maximum conrete SLS strain
eps_u concrete ULS failure strain
eps_ax concrete max compressive ULS strain
eps_tran slab transition strain
eps_axs slab axial strain limit
light lightweight flag
TRUE
FALSE
agg maximum aggregate size
xd_min minimum x/d in flexure
xd_max maximum x/d in flexure
beta depth of rectangular stress block
shrink shrinkage strain
confine confining stress
fcc concrete strength [confined]
eps_plas_cplastic strain (ULS) [confined]
eps_u_c concrete failure strain [confined]

Index


MAT_CURVE

MAT_CURVE | num | name | abs | ord | table

Description

Load curve definition

Parameters

num record number
name name
abs dimension on abscissa (ref. dimension syntax)
ord dimension on ordinate (ref. dimension syntax)
table table of load curve points

Index


MAT_CURVE_PARAM

MAT_CURVE_PARAM.3 | num | name | model | strain[6] | gamma_f | gamma_e

MAT_CURVE_PARAM.2 | num | name | model | gamma_f | gamma_e

Description

Material models

Parameters

num material model number (if not embedded)
name name
model material model
UNDEF undefined
MAT_VOID void material - no strength
EXPLICIT explicit material curve
EXPLICIT_ENV explicit material curve envelope
LINEAR, linear material
ELAS_PLAS elastic-perfectly plastic material
ELAS_HARD elastic-hardening material
NO_COMPRESSION no compression
PRESTRESS prestress tendons
PROG_YIELD progressive yield
BS5400_BAR BS 5400 bar curve
PARK Park model
ASTM_STRAND ASTM A416 prestress strand
ELAS_PLAS_TEN elastic-plastic tendon
RECT_PARABOLA parabola rectangle
RECTANGLE rectangular compression block
BILINEAR bilinear stress block
POPOVICS Popovics
FIB_SCHEMATIC FIB schematic (BS8110 part2 curve)
RECT_AISC AISC 360 filled compression tube
BS8110_PT2 part2 curve
NO_TENSION no tension
INTERPOLATED interplated between cracked and uncracked
TR59 Technical Report 59 (was ICE technical note 372)
PD6687 PD 6687 variant of Eurocode model
EC2_CONFINED EC2 confined
MANDER Mander
MANDER_CONFINED Mander confined
MOD_RECTANGLE modified rectangle
RIGID_PLAS, rigid-plastic
strain[6]key strain values
Elastic compression
Elastic tension
Plastic compression
Plastic tension
Failure compression
Failure tension
gamma_f material factor on strength
gamma_e material factor on elastic modulus

Note

Material model for concrete require two descriptors - for compression and for tension These are combined with a + e.g. RECT_PARABOLA+NO_TENSION Not all material models are supported in all design codes

Index


MAT_FABRIC

MAT_FABRIC | num | <mat>

Description

Fabric material grade

Parameters

num material number
<mat> basic material definition (see MAT)

Index


MAT_FRP

MAT_FRP | num | <mat> | f | debond | Ce

Description

FRP material

Parameters

num FRP material number
<mat> basic material definition (see MAT)
f strength
debond debond strain limit
Ce environmental reduction factor (ACI 440.1R-17) Table 7.1

Index


MAT_GLASS

MAT_GLASS.9 | num | name | E | F | nu | G | rho | alpha | num_uc (| abs | ord | pts[] |) num_sc (| abs | ord | pts[] |) num_ut (| abs | ord | pts[] |) num_st (| abs | ord | pts[] |) eps | <uls> | <sls> cost

Description

Material

Parameters

num material number (if not embedded)
name name
F strength
E elastic modulus
nu Poisson's ratio
G shear modulus
rho density
alpha thermal expansivity
analysis properties (see MAT_ANAL)
num_uc number of points for explicit ULS compression curve
num_sc number of points for explicit SLS compression curve
num_ut number of points for explicit ULS tension curve
num_st number of points for explicit SLS tension curve
abs unit type for abscissa
ord unit type for ordinate
pts[] points defining curve
eps limit strain
<uls> uls curve (see MAT_CURVE_PARAM)
<sls> sls curve (see MAT_CURVE_PARAM)
cost cost

Index


MAT_ISO

MAT_ISO | num | name | desc | E | nu | G | rho | alpha | yield | ultimate | Eh | beta | damp | env | rebar | country | variant | grade | eEnergy | eCO2 | recycle | user

MAT_ISO | num | name | MT_CONCRETE | E | nu | G | rho | alpha | yield | ultimate | Eh | beta | damp | env | rebar | country | variant | grade | eEnergy | eCO2 | recycle | user | country_r | variant_r | grade_r | eEnergy_r | eCO2_r | recycle_r | user_r

Description

Isotropic-elastic material (with yield) definition

Parameters

num record number
name name
desc material description
MT_STEEL
MT_CONCRETE
MT_ALUMINIUM
MT_GLASS
MT_WOOD
E Young's modulus [N/m²]
nu Poisson's ratio
G shear modulus [N/m²]
rho density [kg/m³]
alpha coefficient of thermal expansion [/°C]
yield yield stress [N/m²]
ultimate ultimate stress [N/m²]
Eh hardening modulus [N/m²]
beta hardening parameter
damp material damping fraction
env include environmental parameters
ENV include environmental parameters
NO_ENV no environmental parameters
rebar fraction of rebar by volume
0 no rebar
country country for environmental parameters
variant variant for environmental parameters
grade grade for environmental parameters
eEnergy embodied energy for environmental parameters
eCO2 embodied CO2 for environmental parameters
recycle recycled content for environmental parameters
user user parameter for environmental parameters
country_r country for rebar environmental parameters
variant_r variant for rebar environmental parameters
grade_r grade for rebar environmental parameters
eEnergy_r embodied energy for rebar environmental parameters
eCO2_r embodied CO2 for rebar environmental parameters
recycle_r recycled content for rebar environmental parameters
user_r user parameter for rebar environmental parameters
see ENV_PARAM for details

Index


MAT_REBAR

MAT_REBAR | num | <mat> | type | fy | fu | Eh | k | fyd | fydc | flim | eps_y | eps_p | eps_pc | eps_u | 0.0 | beta_c | beta_t | eta1 | eta2 | k1 | xi | Ce | ductile | relax | label

Description

Rebar material

Parameters

num rebar material number
<mat> basic material definition (see MAT)
type bar type
STEEL
TENDON
FRP
fy yield strength
fu ultimate tensile strength
Eh hardening modulus
k hardening parameter (EC2)
fyd design yield strength
fydc design yield strength in compression
flim limit strength
eps_y yield strain
eps_p plastic strain
eps_pc plastic strain (compression)
eps_u ultimate strain
beta_c bond coefficient for anchorage (BS8110)
beta_tbeta_t
eta_c bond coefficient for anchorage (EC2)
eta_teta_t
k1 bond coefficient for cracking (EC2)
xi prestress bond factor (EC2)
Ce environmental reduction factor (ACI 440.1R-17) Table 7.1
ductile ductility class
relax 1000 hour relaxation
label Bar grade label (for detailing)

Index


MAT_STEEL

MAT_STEEL.3 | num | <mat> | fy | fu | eps_p | Eh

Description

Steel material

Parameters

num steel material number
<mat> basic material definition (see MAT)
fy yield strength
fu ultimate strength
eps_p perfectly plastic strain limit
Eh hardening modulus

Index


MAT_TIMBER

MAT_TIMBER.9 | num | name | E | F | nu | G | rho | alpha | num_uc (| abs | ord | pts[] |) num_sc (| abs | ord | pts[] |) num_ut (| abs | ord | pts[] |) num_st (| abs | ord | pts[] |) eps | <uls> | <sls> cost

Description

Material

Parameters

num material number (if not embedded)
name name
F strength
E elastic modulus
nu Poisson's ratio
G shear modulus
rho density
alpha thermal expansivity
analysis properties (see MAT_ANAL)
num_uc number of points for explicit ULS compression curve
num_sc number of points for explicit SLS compression curve
num_ut number of points for explicit ULS tension curve
num_st number of points for explicit SLS tension curve
abs unit type for abscissa
ord unit type for ordinate
pts[] points defining curve
eps limit strain
<uls> uls curve (see MAT_CURVE_PARAM)
<sls> sls curve (see MAT_CURVE_PARAM)
cost cost

Index


MEMB

MEMB.8 | num | name | colour | type (1D) | exposure | prop | group | topology | node | angle | mesh_size | is_intersector | analysis_type | fire | limiting_temperature | time[4] | dummy | rls_1 { | k_1 } rls_2 { | k_2 } | restraint_end_1 | restraint_end_2 | AUTOMATIC | load_height | load_ref | is_off { | auto_off_x1 | auto_off_x2 | off_x1 | off_x2 | off_y | off_z } | has_ltb_factor { ltb_factor } | has_moment_amplification_factor_strong_axis { moment_amplification_factor_strong_axis } | has_moment_amplification_factor_weak_axis { moment_amplification_factor_weak_axis}

MEMB.8 | num | name | colour | type (1D) | exposure | prop | group | topology | node | angle | mesh_size | is_intersector | analysis_type | fire | limiting_temperature | time[4] | dummy | rls_1 { | k_1 } rls_2 { | k_2 } | restraint_end_1 | restraint_end_2 | EFF_LEN | lyy | lzz | llt | load_height | load_ref | is_off { | auto_off_x1 | auto_off_x2 | off_x1 | off_x2 | off_y | off_z } | has_ltb_factor { ltb_factor } | has_moment_amplification_factor_strong_axis { moment_amplification_factor_strong_axis } | has_moment_amplification_factor_weak_axis { moment_amplification_factor_weak_axis}

MEMB.8 | num | name | colour | type (1D) | exposure | prop | group | topology | node | angle | mesh_size | is_intersector | analysis_type | fire | limiting_temperature | time[4] | dummy | rls_1 { | k_1 } rls_2 { | k_2 } | restraint_end_1 | restraint_end_2 | EXPLICIT | num_pt | { pt | rest | } | num_span | { span | rest | } load_height | load_ref | is_off { | auto_off_x1 | auto_off_x2 | off_x1 | off_x2 | off_y | off_z } | has_ltb_factor { ltb_factor } | has_moment_amplification_factor_strong_axis { moment_amplification_factor_strong_axis } | has_moment_amplification_factor_weak_axis { moment_amplification_factor_weak_axis}

MEMB.8 | num | name | colour | type (2D) | exposure | prop | group | topology | node | angle | mesh_size | is_intersector | analysis_type | fire | limiting_temperature | time[4] | dummy | off_z | off_auto_internal | reinforcement2d | mesh_mode

MEMB.8 | num | name | colour | type (3D) | prop | group | topology | node | angle | mesh_size | is_intersector | analysis_type | fire | time[4] | dummy |

MEMB.7 | num | name | colour | type (1D) | prop | group | topology | node | angle | mesh_size | mesh_option | analysis_type | fire | time[4] | dummy | end_1 | end_2 | AUTOMATIC | height | load_ref | exposure

MEMB.7 | num | name | colour | type (1D) | prop | group | topology | node | angle | mesh_size | mesh_option | analysis_type | fire | time[4] | dummy | end_1 | end_2 | EXPLICIT | nump ( | point | rest ) | nums ( | span | rest ) height | load_ref | off_auto_x1 | off_auto_x2 | off_auto_internal | off_x1 | off_x2 | off_y | off_z | exposure

MEMB.7 | num | name | colour | type (1D) | prop | group | topology | node | angle | mesh_size | mesh_option | analysis_type | fire | time[4] | dummy | end_1 | end_2 | AUTOMATIC | height | load_ref | off_auto_x1 | off_auto_x2 | off_auto_internal | off_x1 | off_x2 | off_y | off_z | exposure

MEMB.7 | num | name | colour | type (2D) | prop | group | topology | node | angle | mesh_size | mesh_option | analysis_type | fire | time[4] | dummy | off_auto_internal | off_z | exposure |

MEMB.5 | num | name | colour | geom | mat | type | section | group | topo | arc | node | angle | fire | time[3] | dummy | end_1 | end_2 | AUTOMATIC | pool | height | load_ref | off_auto_x1 | off_auto_x2 | off_x1 | off_x2 | off_y | off_z

MEMB.5 | num | name | colour | geom | mat | type | section | group | topo | arc | node | angle | fire | time[3] | dummy | end_1 | end_2 | EXPLICIT | nump | { point | rest | } | nums | { span | rest | } height | load_ref | pool | off_auto_x1 | off_auto_x2 | off_x1 | off_x2 | off_y | off_z

MEMB.5 | num | name | colour | geom | mat | type | section | group | topo | arc | node | angle | fire | time[3] | dummy | end_1 | end_2 | EFF_LEN | lyy | lzz | llt | height | load_ref | pool | off_auto_x1 | off_auto_x2 | off_x1 | off_x2 | off_y | off_z

MEMB.4 | num | name | colour | geom | mat | type | section | group | topo | arc | node | angle | dummy | end_1 | end_2 | AUTOMATIC | pool | height | load_ref | off_auto_x1 | off_auto_x2 | off_x1 | off_x2 | off_y | off_z

MEMB.4 | num | name | colour | geom | mat | type | section | group | topo | arc | node | angle | dummy | end_1 | end_2 | EXPLICIT | nump | { point | rest | } | nums | { span | rest | } height | load_ref | pool | off_auto_x1 | off_auto_x2 | off_x1 | off_x2 | off_y | off_z

MEMB.4 | num | name | colour | geom | mat | type | section | group | topo | arc | node | angle | dummy | end_1 | end_2 | EFF_LEN | lyy | lzz | llt | height | load_ref | pool | off_auto_x1 | off_auto_x2 | off_x1 | off_x2 | off_y | off_z

MEMB.3 | num | name | colour | MT_STEEL | type | section | design | restraint | group | topo(n) | radius | node | angle | is_rls { | rls} is_offset { | Ox | Oy | Oz } | rest_list

MEMB.3 | num | name | colour | MT_CONCRETE | type | section | design | num_layout | { layout } | group | topo(n) | radius | node | angle | is_rls { | rls { | k } } | is_offset { | Ox | Oy | Oz }

MEMB.3 | num | name | colour | MT_UNDEF | type | section | group | topo(n) | radius | node | angle | is_rls { | rls} is_offset { | Ox | Oy | Oz }

MEMB.2 | num | name | colour | MT_STEEL | type | section | design | restraint | group | topo(2) | node | angle | is_rls { | rls} is_offset { | Ox | Oy | Oz }

MEMB.2 | num | name | colour | MT_CONCRETE | type | section | design | num_layout | { layout } | group | topo(2) | node | angle | is_rls { | rls} is_offset { | Ox | Oy | Oz }

MEMB.2 | num | name | colour | MT_UNDEF | type | section | group | topo(2) | node | angle | is_rls { | rls} is_offset { | Ox | Oy | Oz }

MEMB.1 | num | MT_STEEL | type | section | design | restraint | group | topo(2) | node | angle | rls(2) | { Ox | Oy | Oz }

MEMB.1 | num | MT_CONCRETE | type | section | design | num_layout | { layout } | group | topo(2) | node | angle | rls(2) | { Ox | Oy | Oz }

MEMB.1 | num | MT_UNDEF | type | section | group | topo(2) | node | angle | rls(2) | { Ox | Oy | Oz }

Description

Member definition

Parameters

topo topology
number of nodes, list of nodes
num member number
name name
colour colour (ref. colour syntax)
type member type
mat material type
BEAM
COLUMN
GENERIC_1D
SLAB
WALL
GENERIC_2D
VOID_CUTTER_1D
VOID_CUTTER_2D
STEEL
CONCRETE
FRP
ALUMINIUM
TIMBER
GLASS
geom member geometry
LINEAR linear (2 nodes)
ARC arc (3 nodes)
RAD arc (3 nodes) with radius
# explicit internal nodes (2 + # nodes)
prop property number
section section property number
group group number
topology topology string
Syntax :
• ordered list of nodes
• node number preceded by 'a' for arc through node
For 2D members there are options
• V followed by list of nodes in (...) for a void area
• P followed by list of nodes in (...) for points to be included
• L followed by list of nodes in (...) for lines to be included
style="padding-right:6em;">• A followed by list of nodes in (...) for a solid area
arc arc radius
node orientation node
angle orientation angle
mesh_size target mesh size
is_intersectormeshing option
YES Member will intersect with others to ensure resulting elements 'node out'
NO Member will mesh independently from others (no intersections)
mesh_option meshing option
MESH Mesh with other members
SELF Mesh independently
NONE Exclude from analysis mesh
mesh_mode 2D member meshing mode
TRI Create tri-only mesh
MIXED Create mixed quad/tri mesh
QUAD Create quad-only mesh
analysis_typeanalysis type
EL_TYPE For 1D members, refer to 1D Element Type options
LINEAR Linear 2D elements
QUADRATIC Quadratic 2D elements
RIGID Rigid xy diaphragm (2D members only)
LOAD_PANEL Load panel 2D elements
fire fire resistance in minutes
limiting_temperature limiting temperature
time[4] time member created from project start
1 at which member is created
2 time at start of drying
3 time loaded
4 time destroyed
dummy dummy flag
ACTIVE in use
DUMMY dummy (inactive)
is_rls releases are included, or not
NO_RLS | RLS | STIFF
rls,rls_1, rls_2 release code for members
6 characters - translation(x,y,z) & rotation (x,y,z)
F fixed
R released
K stiff
k,k_1, k_2 stiffness - one value for each K above
restraint_end_1restraint (for effective length calculation) at end 1
restraint_end_2restraint at end 2
lyy yy effective length
>0 length
<0 percentage or -fraction [0:1]
lzz zz effective length
>0 length
<0 percentage or -fraction [0:1]
llt lateral-torsional effective length
>0 length
<0 percentage or -fraction [0:1]
pool section pool in form number.type
optional types
BEAM concrete beam
COLUMN concrete column
PERIM concrete
load_height load height
load_ref load height reference point
SHR_CENTRE Shear centre
TOP_FLANGE Top flange
BOT_FLANGE Bottom flange
num_pt number of points
pt point id
0 all internal
n nth internal point
rest restraint condition
YES - explicit points
NO points are auto generated
num_span number of spans
span span id
0 all
n nth internal span
rest restraint condition
YES explicit spans
NO spans are auto generated
is_off is member offset
OFF member has offsets
NO_OFF no offets on member
auto_off_x1 automatic offset - end 1
AUTO automatic based on column size + off_x1
MAN only manually defined value considered
auto_off_x2 automatic offset - end 2
AUTO automatic based on column size + off_x2
MAN only manually defined value considered
off_x1 offset x - end 1 (beam/bar/rod/strut/tie members only)
off_x2 offset x - end 2 (beam/bar/rod/strut/tie members only)
off_y offset y (beam members only)
off_z offset z (beam and 2D members only)
off_auto_internalautomatic offset - internal
YES create rigid offset at physical intersection with joining members
NO mesh based on centreline intersection only
exposure exposed surfaces
ALL All
THREE Three sides
TOP_BOT Top + Bottom
SIDES Sides
ONE One side
NONE None;
is_offset is offset exist in member
NO_OFFSET no offset
OFFSET offset exist
LOCAL_OFFSET offset exist and is local
Ox,Oy,Oz offset [m]
has_ltb_factoris the equivalent uniform moment factor for LTB overridden
LTB_FACTOR member has override
NO_LTB_FACTOR no override
ltb_factor equivalent uniform moment factor for LTB value
has_moment_amplification_factor_strong_axis is the moment amplification factor (strong axis) overridden
MOMENT_AMPLIFICATION_FACTOR_STRONG_AXIS member has override
NO_MOMENT_AMPLIFICATION_FACTOR_STRONG_AXIS no override
moment_amplification_factor_strong_axis moment amplification factor (strong axis) override value
has_moment_amplification_factor_weak_axis is the moment amplification factor (weak axis) overridden
MOMENT_AMPLIFICATION_FACTOR_WEAK_AXIS member has override
NO_MOMENT_AMPLIFICATION_FACTOR_WEAK_AXIS no override
moment_amplification_factor_weak_axis moment amplification factor (weak axis) override value

Note

The format of the record depends on whether the member is MT_STEEL, MT_CONCRETE, or MT_UNDEF. For example a steel member references a restraint property; others do not.

Index


MODAL_DAMP

MODAL_DAMP | case | zeta

Description

Modal damping ratio

Parameters

case analysis case
zeta modal damping

Index


MODAL_GEO_STIFF

MODAL_GEO_STIFF | case | stiff

Description

Modal geometric stiffness

Parameters

case analysis case
stiff modal geometric stiffness [N/m]

Index


MODAL_MASS

MODAL_MASS | case | mass

Description

Modal mass

Parameters

case analysis case
mass modal mass [kg]

Index


MODAL_STIFF

MODAL_STIFF | case | stiff

Description

Modal stiffness

Parameters

case analysis case
stiff modal stiffness [N/m]

Index


MODE

MODE | case | mode

Description

Mode number

Parameters

case analysis case
mode mode number

Index


MODE_DAMPING

MODE_DAMPING | num | name | table | const

Description

Damping table definition

*** DEPRECATED ***

Parameters

num record number
name name
table table of damping values
const default damping

Index


MODE_IN_RESP

MODE_IN_RESP | case | item | mode

Description

Mode in response spectrum analysis

Parameters

case analysis case
item response item
mode response item mode

Index


MODE_MULT

MODE_MULT | case | item | mult

Description

Modal multiplier in response spectrum analysis

Parameters

case analysis case
item response item
mult response item modal multiplier
three values for CQC3 combination

Index


MODE_PROB

MODE_PROB | case | probability

Description

Buckling mode probability of being global

Parameters

case analysis case
probability probability

Index


MOMENT

MOMENT | elem | case | pos | x | y | z

Description

1D element moment

Parameters

elem element number
case analysis case
pos position
0 | 1
x,y,z moments [N.m]

Index


MOMENT_1D

MOMENT_1D | elem | case | pos | x | y | z

Description

1D element moment

Parameters

elem element number
case analysis case
pos position on element
0 ≤ pos <= 1
x,y,z moments [N/m]

Index


MOMENT_2D

MOMENT_2D | elem | case | pos | xx | yy | xy

Description

2D element moment

Parameters

elem element number
case analysis case
pos position on element
-1 | 0 | 1 ... (-1 centre)
xx,yy,xy moment tensor [N]

Index


MV_BRIDGE_LOAD

MV_BRIDGE_LOAD | num | name | group | path | type | start | end | interval | vehicle | intensity

Description

Moving bridge load definition

Parameters

num record number
name name
group group number
path path number
type load type
KEL knife edge load
VEHICLE vehicle
start start position [m]
end end position [m]
interval interval [m]
vehicle vehicle
see BASIC_BRIDGE_LOAD for details of standard vehicles
intensity load intensity [N][-]

Index


NL_SPRING_CURVE

NL_SPRING_CURVE | num | name | tran | table

Description

Non-linear spring curve definition

*** DEPRECATED ***

Parameters

num record number
name name
tran translation or rotation
TRAN translational
ROT rotational
table table of points [m]

Index


NODE

NODE.3 | num | name | colour | x | y | z | restraint | axis |
mesh_size | springProperty | massProperty | damperProperty

NODE.2 | num | name | colour | x | y | z |
is_grid { | grid_plane | datum | grid_line_a | grid_line_b } | axis |
is_rest { | rx | ry | rz | rxx | ryy | rzz } |
is_stiff { | Kx | Ky | Kz | Kxx | Kyy | Kzz } |
is_mesh { | mesh_size | radius | tie_to_mesh | column_rigidity | column_prop | column_node |
column_angle | column_factor | column_slab_factor }

NODE.1 | num | x | y | z | axis |
rx | ry | rz | rxx | ryy | rzz |
Kx | Ky | Kz | Kxx | Kyy | Kzz

Description

Node coordinate definition

Parameters

num node number
name name
colour colour (ref. colour syntax)
x,y,z coordinates, if 'is grid' then grid coordinates, otherwise global [m]
is_grid grid node data are included, or not
GRID | NO_GRID
{{
grid_plane GRID: grid plane reference (used as the datum for x, y, z)
datum GRID: coordinate datum is the grid line intersection, otherwise grid plane origin
INTERSECTION | ORIGIN
grid_line_a GRID: grid line reference A (by name)
grid_line_b GRID: grid line reference B (by name)
}}
axis axis
GLOBAL
# axis number
restraint restraint string ("free", "pin", "fix" or custom string from "x", "y", "z", "xx", "yy", "zz" e.g. "zxxyy"
is_rest restraint data are included, or not
REST | NO_REST
{{
rx,ry,... restraint condition
0 free
1 restrained
}}
is_stiff support stiffness data are included, or not
STIFF | NO_STIFF
{{
Kx,Ky,... STIFF: nodal stiffnesses [N/m][Nm]
}}
is_mesh mesh generation data are included, or not
MESH | NO_MESH
{{
mesh_size MESH: desirable element edge length around point
radius MESH: radius of influence for edge length
tie_to_mesh MESH: node will be tied to mesh by tied interface
YES | NO
column_rigidityMESH: column rigidity will be generated
YES | NO
column_prop MESH: column property number
column_node MESH: column orientation node
column_angleMESH: column orientation angle
column_factorMESH: column dimension factor
column_slab_factorMESH: column slab thickness factor
}}

Index


OP_VIEW

OP_VIEW.7 | sid | flags | 0 | name | left | top | right | bottom | orient | paper | mode | cases | nodes | elements | members | assemblies | num_op ( | data | axis ) | units | ext_min | ext_max | sub_data | format | num_worst | num_disp | num_force | layer

OP_VIEW.6 | sid | flags | name | left | top | right | bottom | orient | paper | mode | cases | nodes | elements | members | assemblies | num_op ( | data | axis ) | units | ext_min | ext_max | sub_data | format | num_worst | num_disp | num_force | layer

Description

Output View (note: OP_VIEW.7 will be reverted in a future version. For applications that write custom GWA for GSA to read, we recommend explicitly writing OP_VIEW.6 to avoid needing to update your code.)

Parameters

sid string ID
flags output flags in [...] separated by commas
PRINTTAG view is in print mode
WINDOWMAX window is maximized
BYCASE output by case
BYPROP output by property
BYGROUP output by group
OMITTABLE omit table
OMITSUMMARY omit summary
UPDATEWITHNODESEL update with node selection (GSA use only)
UPDATEWITHELEMSEL update with element selection
UPDATEWITHMEMBSEL update with member selection
UPDATEWITHASSMSEL update with assembly selection
EXTENTPERCENT extents as percentage
EXTENTMAGN extent as magnitude
EXTENTEXCLUSIVE extent is exclusive
EL1DDISPAUTOPTS interesting points for displacements on 1D elements
EL1DFRCAUTOPTS interesting points for forces on 1D elements
EL2DAVERAGE 2D results averaged at nodes
EL2DCENTREONLY 2D results at centre only
ENVSUBJECTONLY envelope subject component only
SINGLEROWPERENT single row per entity
UNITSSPEC units are specified (GSA use only)
NUMFORMATSPEC numeric format specified (GSA use only)
STRIPEYOUTPUT stripey output
REFSBYNUM references by number
REFSBYNAME references by name
INCLENTNAMESINRESULTS include name in results
CLOSEWHENRESDEL close when results are deleted
INTRESONTRUSS report at internal point on bars
FULLPOPFIELDS fully populate fields
name view name
left window left position (pixels)
top window top position
right window right position
bottom window bottom position
orient print orientation
1 portrait
2 landscape
paper print paper size (integer depends on printer)
mode view mode
0 undefined
1 rich text
2 rich text(tabbed)
cases cases see lists
nodes nodes see lists
elementselements see lists
members members see lists
assembliesassemblies see lists
num_op number of output tables
((
datadata reference
axisaxis
))
axis output axis
n user axis id
0 global axis set
-1 local axis set
-10 default - axis depend on context
-11 x elevation axis set
-12 y elevation axis set
-13 global cylindrical axis set
units see units
ext_min minimum extent of subject component
-Infinity minimum not set
value minumum value
ext_max maximum extent of subject component
Infinity maximum not set
value maximum value
subject data reference of subject component for enveloping
format see numeric format
num_worstnumber of worst values
num_dispnumber of intermediate displacement points
num_forcenumber of intermediate force points
layer 2D element layer
0 none
1 bottom
2 middle
3 top

Description

Lists (in output views)

Parameters

type list type
1 node
2 element
3 member
4 case
11 assembly
num number of items
{{
item list item
n item
-1 TO (to specify a range)
-2 NOT (to specify exclusions)
-3 STEP (to specify the granularity of a range)
-4 ALL (to specify all)
-5 NONE (to specify none)
-6 * (to specify the highest item)
-7 AND (to specify items that match both of two conditions)
-8 OR (to specify items that match one of two conditions - implied if omitted)
-9 LEFT ("(" to clarify the order of evaluation in expressions)
-10 RIGHT (")")
-11 NAME ("" to refer to a list by name)
-12 LIST (# to refer to a list by id)
-13 NODE (N node prefix (optional))
-14 ELEM (E element prefix (optional))
-15 PROP (P property prefix)
-16 PB (beam property prefix)
-17 PS (spring property prefix)
-18 PM (mass property prefix)
-19 PA (2D (area) property prefix)
-20 PL (link property prefix)
-21 PC (cable property prefix)
-22 PG (spacer (geodesic) property prefix)
-23 PV (3D (volume) property prefix)
-24 EGROUP (G group prefix)
-32 PD (damper property prefix)
-34 X (nodes on global x line passing through the following node)
-35 Y (ditto for y)
-37 Z (ditto for z)
-36 XY (nodes on global xy plane passing through the following node)
-39 YZ (ditto for yz)
-38 ZX (ditto for zx)
-43 MODE (M mode prefix)
-45 CCASE (C combination case prefix)
-46 ACASE (A analysis case prefix)
-47 LCASE (L load case prefix (optional))
-48 PERM (P permutation prefix)
-49 TASK (T task prefix)
-50 M (material prefix)
-51 MS (steel material prefix)
-52 MC (concrete material prefix)
-53 MA (aluminium material prefix)
-54 MG (glass material prefix)
-55 MP (FRP material prefix)
-57 MT (timber material prefix)
-58 MF (fabric material prefix)
-59 MU (generic material prefix)
-60 ML (soil material prefix)
namename of list (only if item is NAME)
}}

Description

Units (in output views)

Parameters

force_string force unit string
force_factor force factor compared to SI
length_string length unit string
length_factor length factor compared to SI
mass_string mass unit string
mass_factor mass factor compared to SI
time_string time unit string
time_factor time factor compared to SI
temp_string temperature unit string
temp_factor temperature factor compared to SI
disp_string displacement unit string
disp_factor displacement factor compared to SI
stress_string stress unit string
stress_factor stress factor compared to SI
accel_string acceleration unit string
accel_factor acceleration factor compared to SI
prop_string property length unit string
prop_factor property length factor compared to SI

Description

Numeric format (in output views)

Parameters

format format option
1 engineering
2 decimal
3 scientific
eng_fig number of significant figures in engineering format
dec_placenumber of decimal places
sig_fig number of significant figures in scientific format
zero tolerance for numbers distinguished from zero

Index


PART_FAC

PART_FAC | case | option | x | y | z

Description

Participation factor

Parameters

case analysis case
option type option
TRAN translational
ROT rotational
x,y,z values [-][M]

Index


PATH

PATH | num | name | type | group | alignment | left | right | factor | num_marked_lanes

Description

Path definition

Parameters

num record number
name name
type path type
LANE
FOOTWAY
TRACK
VEHICLE
CWAY_1WAY
CWAY_2WAY
group group number
alignment alignment number
left left / centre offset [m]
right right offset / gauge [m]
factor left factor
num_marked_lanesnumber of marked lanes

Index


PATH_LOAD

PATH_LOAD.2 | num | path | type | variable_load | vudl_fac | vehicle | vehicle_fac | exclusion | vehicle2 | vehicle_fac2 | exclusion2 PATH_LOAD.1 | num | path | type | vudl | vudl_fac | kel | vehicle | vehicle_fac | exclusion | vehicle2 | vehicle_fac2 | exclusion2

Description

Path loading definition

Parameters

num record number
path path number
type load type
variable_loadrecord number of user defined variable load or
NO_VUDL
HA_UK
HA_UK_WITH_KEL
HA_HK
HA_HK_WITH_KEL
CS454_ALL2
CS454_ALL2_UDL_ONLY
FOOT_UK
FOOT_HK
ONEKN_UDL
ONEKN_UDL_WITH_KEL18000LB
ONEKN_UDL_WITH_KEL200KN
SIDEWALK_AASHTO
SIDEWALK_LRFD
EC1UK_FOOT
AS_5100_FOOTWAY_VARI
AS_5100_FOOTWAY_CONST
vudl variable UDL
vudl_fac VUDL factor
kel knife edge load [N]
vehicle vehicle
see BASIC_BRIDGE_LOAD for details of standard vehicles
vehicle_fac vehicle factor
exclusion vehicle exclusion length [m]
vehicle2 second vehicle
see BASIC_BRIDGE_LOAD for details of standard vehicles
vehicle_fac2second vehicle factor
exclusion2 second vehicle exclusion length [m]

Index


PATH_LOAD_AUTO

PATH_LOAD_AUTO.2 | num | path | type | variable_load | vudl_fac | vehicle | vehicle_fac | exclusion | vehicle2 | vehicle_fac2 | exclusion2 PATH_LOAD_AUTO.1 | num | path | type | vudl | vudl_fac | kel | vehicle | vehicle_fac | exclusion | vehicle2 | vehicle_fac2 | exclusion2

Description

Automatically generated path load definition

Parameters

num record number
path path number
type load type
User Vehicle
User Vehicle + Variable Load
User Variable Load
HA (UK)
HA (Hong Kong)
HB
HB + HA (UK)
HB + HA (Hong Kong)
Foot (UK)
Foot (Hong Kong)
RL
Shadow HB + HA (UK)
Shadow HB + HA (Hong Kong)
Sidewalk (AASHTO)
Sidewalk (LRFD)
UIC71-RU
H20-44
HS20-44
HL-93
M1600
S1600
M1600-Triaxle
SM1600
AS Footway Vari
AS Footway Const
SV-TT
SV-TRAIN
SV-150
SV-100
SV-80
HA + SV-TT
HA + SV-Train
HA + SV-150
HA + SV-100
HA + SV-80
EC1:Lane1
EC1:Lane2
EC1:Lane3
EC1:Lane4
EC1:Remainder
EC1:Lane1Comb
EC1:Lane2Comb
EC1:Lane3Comb
EC1:Lane4Comb
EC1:Rem Comb
EC1:Lane1freq
EC1:Lane2freq
EC1:Lane3freq
EC1:Lane4freq
EC1:Rem freq
EC1UK:FootOnVerge
EC1:LM3 Generic
EC1UK:SV80&Lane1freq
EC1UK:SV100&Lane1freq
EC1UK:SV196&Lane1freq
EC1UK:SOV250&Lane1freq
EC1UK:SOV350&Lane1freq
EC1UK:SOV450&Lane1freq
EC1UK:SOV600&Lane1freq
EC1UK:shadow SV80&Lane2freq
EC1UK:shadow SV100&Lane2freq
EC1UK:shadow SV196&Lane2freq
variable_loadrecord number of user defined variable load or
NO_VUDL
HA_UK
HA_UK_WITH_KEL
HA_HK
HA_HK_WITH_KEL
CS454_ALL2
CS454_ALL2_UDL_ONLY
FOOT_UK
FOOT_HK
ONEKN_UDL
ONEKN_UDL_WITH_KEL18000LB
ONEKN_UDL_WITH_KEL200KN
SIDEWALK_AASHTO
SIDEWALK_LRFD
EC1UK_FOOT
AS_5100_FOOTWAY_VARI
AS_5100_FOOTWAY_CONST
vudl variable UDL
vudl_fac VUDL factor
kel knife edge load [N]
vehicle vehicle
see BASIC_BRIDGE_LOAD for details of standard vehicles
vehicle_fac vehicle factor
exclusion exclusion length [m]

Index


PERIOD

PERIOD | case | option | period

Description

Period in response spectrum analysis

Parameters

case analysis case
option period option
DES design
ANAL analysis
EMP empirical
period period value [s]
three values for CQC3 combination

Index


PILE_INTERACTION

PILE_INTERACTION | nodes | area | x | y | z | perim | elev | z | vert

Description

pile-soil interaction definition

Parameters

nodes node list
area automatically calculate interaction area
AUTO automatic calculation of area
AREA specify area
x,y,z dimension of the interaction areas in x, y, z [m]
perim perimeter length of pile [m]
elev automatically calculate elevation level of interaction
AUTO automatic determination of elevation
ELEV specify the area
z elevation of interaction [m]
vert vertical interaction only
VERT vertical only
FULL full interaction

Index


POLYLINE

POLYLINE | num | name | colour | grid_plane | num_dim | desc

Description

polyline definition

Parameters

num record number
name name
colour colour (ref. colour syntax)
grid_plane grid plane
num_dim number of dimensions, 2 or 3
desc description of the polyline in text format e.g. (1,0,0)(2,3,4)(-1,1,-1)...

Index


POLYLINE_2D

POLYLINE_2D.2 | num | name | desc

POLYLINE_2D.1 | num | name | num_point ( | point_x | point_y )

Description

2D polyline definition

*** DEPRECATED ***

Parameters

num record number
name name
desc description of the 2D polyline in text format e.g. (1,0)(2,3)(-1,1)...
num_point number of poly points
((
point_x x coordinate
point_y y coordinate
))

Index


PROP_2D

PROP_2D.8 | num | name | colour | type | axis | mat | mat_type | grade | design | profile | ref_pt | ref_z | mass | flex | shear | inplane | weight |

PROP_2D.8 | num | name | colour | LOAD | support | edge | axis

PROP_2D.7 | num | name | colour | type | axis | mat | mat_type | grade | design | profile | ref_pt | ref_z | mass | flex | shear | inplane | weight |

PROP_2D.7 | num | name | colour | LOAD | support | edge

PROP_2D.5 | num | name | colour | type | axis | mat | mat_type | grade | design | profile | ref_pt | ref_z | mass | flex | shear | inplane | weight | is_env { | energy | CO2A | CO2B | CO2C | CO2D | recycle | user }

PROP_2D.5 | num | name | colour | LOAD | support | edge

PROP_2D.3 | num | name | colour | type | axis | mat | mat_type | grade | design | thick | ref_pt | ref_z | mass | flex | inplane | weight | is_env { | energy | CO2A | CO2B | CO2C | CO2D | recycle | user }

PROP_2D.3 | num | name | colour | LOAD | support | edge

PROP_2D.2 | num | name | colour | axis | mat | type | thick | mass | bending | inplane | weight | is_env { | energy | CO2A | CO2B | CO2C | CO2D | recycle | user }

PROP_2D.2 | num | name | colour | axis | mat | LOAD | support | edge

PROP_2D.1 | num | name | axis | mat | type | thick | mass | bending

Description

2D element property definition

Parameters

num record number
name name
colour colour (ref. colour syntax)
type property type
STRESS plane stress element
FABRIC fabric element
PLATE flat plate element
SHELL flat shell element
CURVED curved shell elements (cannot be analysed in GSA)
WALL wall element (not used)
STRESS plane stress element
STRAIN plane strain element
AXI axisymmetric element
LOAD load element
axis axis
mat analysis material
if version 7 or earlier and mat<0 then the |mat| is the number of layers followed by the layer values
layer material
layer thickness
layer angle
mat_type grade material type
STEEL
CONCRETE
FRP
ALUMINIUM
GLASS
TIMBER
GENERIC
FABRIC (type FABRIC)
grade grade reference
design design property
profile profile of 2D section
thickness(unit) solid slab (m if no unit - version 7 or earlier)
thickness(unit) solid slab (unit required - version 8 or later)
thickness(unit) D angle CAT profile decking slab (catalogue) (if no unit mm is assumed)
thickness(unit) D angle STD d t b1 b22 b3 b4 b5 decking slab (standard) (if no unit mm is assumed)
thickness(unit) H top void% hollow slab (if no unit mm is assumed)
(unit) L (material thickness angle) ... layered composite (if no unit mm is assumed)
thick thickness [m]
ref_pt reference surface
CENTROID
TOP_CENTRE
BOT_CENTRE
ref_z z offset from reference surface
mass additional mass per unit area [kg/m²]
flex stiffness modifier for bending
>0 bending stiffness b^3/12 [m⊃3]
<0 -factor on stiffness
n% percentage factor on stiffness
shear stiffness modifier for shear effects
>0 shear thickness [m]
<0 -factor on stiffness
n% percentage factor on stiffness
inplane stiffness modifier for in-plane effects
>0 in-plane thickness [m]
<0 -factor on stiffness
n% percentage factor on stiffness
weight modifier for mass/weight effects
>0 in-plane thickness [m]
<0 -factor on thickness
n% percentage factor on thickness
bending thickness modifier for bending
>0 bending thickness [m]
<0 -factor on thickness
n% percentage factor on thickness
is_env environmental data are included, or not
ENV | NO_ENV
{{
energy embodied energy [/m]
CO2 CO2 and stage [m]
recycle recycled content [%]
notes notes
}}
support support pattern
AUTO automatic determination of support condition
ALL supported on all edges
THREE supported on 3 sides
TWO supported on 2 (opposite) sides
TWO_ADJ supported on 2 (adjacent) sides
ONE supported on 1 side (no moment)
ONE_MOM supported on 1 side (including moment)
ONE_WAY One-way spanning
TWO_WAY Two-way spanning
*For versions before PROP_2D.5 add "SUP_" to the beginning of the support text : i.e. SUP_AUTO
edge reference edge for loading

Index


PROP_3D

PROP_3D | num | name | colour | axis | mat | mat_type | grade

Description

3D property definition

Parameters

num record number
name name
colour colour (ref. colour syntax)
axis axis
mat analysis material
mat_type material type
UNDEF
STEEL
CONCRETE
ALUMINIUM
GLASS
FRP
TIMBER
grade naterial grade

Index


PROP_CABLE

PROP_CABLE.4 | num | name | colour | stiff | mass | type | alpha | damp | is_env { | energy | carbon | recycle | user }

PROP_CABLE.2 | num | name | colour | stiff | mass | alpha | damp | is_env { | energy | carbon | recycle | user }

PROP_CABLE.1 | num | name | stiff | mass | alpha | damp

Description

Cable property definition

Parameters

num record number
name name
colour colour (ref. colour syntax)
stiff stiffness (AE) [N]
mass mass per unit length [kg/m]
type cable type
NORMAL
SLIDING
alpha temperature coefficient of expansion [/°C]
damp material damping fraction
is_env environmental data are included, or not
ENV | NO_ENV
{{
energy embodied energy [/m]
carbon embodied carbon [m]
recycle recycled content [%]
notes notes
}}

Index


PROP_DAMP

PROP_DAMP.2 | num | name | colour | type | damp_x | damp_y | damp_z | damp_xx | damp_yy | damp_zz

PROP_DAMP.1 | num | name | colour | axis | type | damp_x | damp_y | damp_z | damp_xx | damp_yy | damp_zz

Description

Damper property definition

Parameters

num record number
name name
colour colour (ref. colour syntax)
axis damper axis
LOCAL
GLOBAL
# axis number
type damper type
TRAN translational (1 dof)
ROTN rotational (1 dof)
GENERAL general
damp_x damping value in x direction [N.s/m]
damp_y damping value in y direction [N.s/m]
damp_z damping value in z direction [N.s/m]
damp_xx damping value in xx direction [N.m/(rad/s)]
damp_yy damping value in yy direction [N.m/(rad/s)]
damp_zz damping value in zz direction [N.m/(rad/s)]

Index


PROP_LINK

PROP_LINK.2 | num | name | colour | type | x | y | z | xx | yy | zz

PROP_LINK.1 | num | name | type | x | y | z | xx | yy | zz

Description

Link property definition

Parameters

num record number
name name
colour colour (ref. colour syntax)
type link type
ALL all directions
PLANE_XY xy plane
PLANE_YZ yz plane
PLANE_ZX zx plane
PLATE_XY xy plate
PLATE_YZ yz plate
PLATE_ZX zx plate
?_PIN as above except that constrained node rotations are excluded
BAR link as rigid bar (GsRelax only)
TENS link supports tension only (Gsrelax only)
COMP link supports compression only (Gsrelax only)
CUSTOM custom link
TENSION TENS (deprecated)
COMPRESSION COMP (deprecated)
x,y,... linked condition (for custom links)
0 free
1 constrained

Index


PROP_MASS

PROP_MASS.3 | num | name | colour | mass | Ixx | Iyy | Izz | Ixy | Iyz | Izx | mod { | mod_x | mod_y | mod_z }

PROP_MASS.2 | num | name | colour | axis | mass | Ixx | Iyy | Izz | Ixy | Iyz | Izx | mod { | mod_x | mod_y | mod_z }

PROP_MASS.1 | num | name | axis | mass | Ixx | Iyy | Izz | Ixy | Iyz | Izx

Description

Mass property definition

Parameters

num record number
name name
colour colour (ref. colour syntax)
axis mass axis (for inertia)
LOCAL
GLOBAL
# axis number
mass mass [kg]
Ixx,Iyy,... inertia tensor [kg.m²]
mod mass is modified for each direction
MOD masses are modified
DEF defined mass is used
{{
mod_x modified x mass
+ve mass value
-ve -1 × proportion of mass
mod_y modified y mass
mod_z modified z mass
}}

Index


PROP_SEC

PROP_SEC.3 | num | name | colour | mat | grade | anal | desc | cost | ref_point | off_y | off_z |

PROP_SEC.2 | num | name | colour | type | desc | anal | mat | grade |

PROP_SEC.1 | num | name | colour | anal | desc | prin | type | cost | is_prop { | area | I11 | I22 | J | K11 | K22 } | is_mod { | area_to_by | area_m | I11_to_by | I11_m | I22_to_by | I22_m | J_to_by | J_m | K11_to_by | K11_m | K22_to_by | K22_m | mass | stress } | is_env { | energy | carbon | recycle | user }

Description

Section property definition

Note

See SECTION_MOD for property modifiers

Parameters

num record number
name name
colour colour (ref. colour syntax)
mat material type
GENERIC
STEEL
CONCRETE
ALUMINIUM
GLASS
FRP
TIMBER
grade design material
anal analysis material
desc section description
cost cost per unit mass
ref_point base reference point
CENTROID
TOP_LEFT
TOP_CENTRE
TOP_RIGHT
MID_LEFT
MID_RIGHT
BOT_LEFT
BOT_CENTRE
BOT_RIGHT
off_y section y offset from base reference point
off_z section z offset from base reference point
type member type
GENERIC
BEAM
COLUMN
prin not used
type section type
NA not-applicable
WELDED welded
ROLLED hot rolled
FORMED formed
is_prop property data are included, or not (see note below)
PROP | NO_PROP
{{
area area
I11 Iyy
I22 Izz
J J
K11 shear area Kyy
K22 shear area Kzz
}}
is_mod section modification data are included, or not
MOD_PROP | NO_MOD_PROP
{{
area_to_by area modifier is value, or factor
TO | BY
area_m area modifier [-/m²] <0 by / >0 to
I11_to_by Iyy modifier is value, or factor
TO | BY
I11_m Iyy modifier [-/m⁴] <0 by / >0 to
I22_to_by Izz modifier is value, or factor
TO | BY
I22_m Izz modifier [-/m⁴] <0 by / >0 to
J_to_by J modifier is value, or factor
TO | BY
J_m J value [-/m⁴] <0 by / >0 to
K11_to_by shear area Kyy modifier is value, or factor
TO | BY
K11_m shear area yKy modifier <0 by / >0 to
K22_to_by shear area Kzz modifier is value, or factor
TO | BY
K22_m shear area Kzz modifier <0 by / >0 to
mass mass adjustment with area
YES base mass on modified area
NO use unmodified area
stress stress calculation option
NO_MOD don't calculate stress when section is modified
USE_UNMOD use unmodified properties
USE_MOD use modified proerties
}}
is_env environmental data are included, or not
ENV | NO_ENV
{{
energy embodied energy [/m]
carbon embodied carbon [m]
recycle recycled content [%]
user user parameter [/m]
}}

Note

Property values are only required if desc is EXP (explicit), for other sections the values are established on reading record

Index


PROP_SPACER

PROP_SPACER.2 | num | name | colour | axis | spacer_type | length_type | stiffness | ratio

PROP_SPACER.1 | num | name | axis | spacer_type | length_type | stiffness | ratio

Description

Spacer property definition

Parameters

num record number
name name
colour colour (ref. colour syntax)
axis axis
spacer_type type of spacer
GEODESIC | FREE | BAR
length_type spacer leg length type
PROPORTIONAL proportional
RATIO ratio
PROJECTED_RATIO_XY XY plane projected ratio
PROJECTED_RATIO_XX X axis projected ratio
PROJECTED_PROPORTIONAL projected length proportional
stiffness spacer stiffness (AE) [N]
0 defaults to (average sum of initial scalar forces at node)/20
ratio spacer leg ratio

Index


PROP_SPR

PROP_SPR.4 | num | name | colour | SPRING | curve_x | stiff_x | curve_y | stiff_y | curve_z | stiff_z | curve_xx | stiff_xx | curve_yy | stiff_yy | curve_zz | stiff_zz | damping

PROP_SPR.4 | num | name | colour | DAMPER | damping_x | damping_y | damping_z | damping_xx | damping_yy | damping_zz

PROP_SPR.4 | num | name | colour | MATRIX | matrix | damping

PROP_SPR.4 | num | name | colour | FRICTION | stiff_x | stiff_y | stiff_z | friction | damping

PROP_SPR.4 | num | name | colour | type | stiff_x | damping | +ve_lock_up | -ve_lock_up

PROP_SPR.3 | num | name | colour | axis | SPRING | curve_x | stiff_x | curve_y | stiff_y | curve_z | stiff_z | curve_xx | stiff_xx | curve_yy | stiff_yy | curve_zz | stiff_zz | damping

PROP_SPR.3 | num | name | colour | axis | DAMPER | damping_x | damping_y | damping_z | damping_xx | damping_yy | damping_zz

PROP_SPR.3 | num | name | colour | axis | MATRIX | matrix | damping

PROP_SPR.3 | num | name | colour | axis | FRICTION | stiff_x | stiff_y | stiff_z | friction | damping

PROP_SPR.3 | num | name | colour | axis | type | stiff_x | damping | +ve_lock_up | -ve_lock_up

PROP_SPR.2 | num | name | colour | axis | type | curve_x | stiff_x | curve_y | stiff_y | curve_z | stiff_z | damping

PROP_SPR.2 | num | name | colour | axis | MATRIX | matrix | damping

PROP_SPR.1 | num | name | axis | type | curve_x | stiff_x | curve_y | stiff_y | curve_z | stiff_z | damping

PROP_SPR.1 | num | name | axis | MATRIX | matrix | damping

Description

Spring property definition

Parameters

num record number
name name
colour colour (ref. colour syntax)
axis spring axis
LOCAL
GLOBAL
# axis number
type spring type
TENSION tension only
COMPRESSION compression only
CONNECTOR connector
LOCKUP lock up
GAP gap
TRAN translational (old files only)
ROTN rotational (old files only)
curve_x non-linear spring curve ref in x direction, if 0, the spring in this direction is elastic
stiff_x stiffness value in x direction [N/m], if curve_x is not 0, this will not be used.
curve_y non-linear spring curve ref in y direction, if 0, the spring in this direction is elastic
stiff_y stiffness value in y direction [N/m], if curve_y is not 0, this will not be used.
curve_z non-linear spring curve ref in z direction, if 0, the spring in this direction is elastic
stiff_z stiffness value in z direction [N/m], if curve_z is not 0, this will not be used.
curve_xx non-linear spring curve ref in xx direction, if 0, the spring in this direction is elastic
stiff_xx stiffness value in xx direction [N/m], if curve_xx is not 0, this will not be used.
curve_yy non-linear spring curve ref in yy direction, if 0, the spring in this direction is elastic
stiff_yy stiffness value in yy direction [N/m], if curve_yy is not 0, this will not be used.
curve_zz non-linear spring curve ref in zz direction, if 0, the spring in this direction is elastic
stiff_zz stiffness value in zz direction [N/m], if curve_zz is not 0, this will not be used.
damping_x damping value in x direction [N.s/m]
damping_y damping value in y direction [N.s/m]
damping_z damping value in z direction [N.s/m]
damping_xx damping value in xx direction [N.m/(rad/s)]
damping_yy damping value in yy direction [N.m/(rad/s)]
damping_zz damping value in zz direction [N.m/(rad/s)]
matrix matrix of stiffness
damping spring damping value
+ve_lock_up +ve lock up value
-ve_lock_up -ve lock up value
friction friction coefficient

Index


RAFT_INTERACTION

RAFT_INTERACTION | nodes | area | x | y | elev | z | p_min | p_max

Description

Raft-soil interaction definition

Parameters

nodes node list
area automatically calculate interaction area
AUTO_AREA_YES
AUTO_AREA_NO
x,y interaction area dimension in z and y [m]
elev automatically calculate elevation level of interaction
AUTO_ELEV_YES
AUTO_ELEV_NO
z elevation of interaction [m]
p_min,p_max minimum and maximum pressure limits [Pa]

Index


RC2D_PROP

RC2D_PROP.4 | num | name | theta_a | theta_b | z_ta | z_ba | z_tb | z_bb | thick_op { | thick } | rebar | area_ba | area_bb | area_ta | area_tb | add_ecc | add_ecc_mod | comp_op { | comp_min } | min_ecc_op { | min_ecc } | soln | limit | x_d_max | strain | phi_delta | phi_c | phi_t

RC2D_PROP.3 | num | name | theta_a | theta_b | z_ta | z_ba | z_tb | z_bb | thick_op { | thick } | rebar | area_ba | area_bb | area_ta | area_tb | add_ecc | add_ecc_mod | add_ecc_dir | comp_op { | comp_min } | min_ecc_op { | min_ecc } | soln | limit | x_d_max | strain | phi_delta

RC2D_PROP.2 | num | name | theta_a | theta_b | z_ta | z_ba | z_tb | z_bb | thick_op | thick | concrete | rebar | area_ba | area_bb | area_ta | area_tb | add_ecc | comp_op { | comp_ta | comp_ba | comp_tb | comp_bb } | gamma_c | gamma_s | phi_c | phi_t | min_ecc_op | min_ecc | soln | limit | x_d_max | phi_delta

RC2D_PROP.1 | num | name | theta_a | theta_b | z_ta | z_ba | z_tb | z_bb | thick_op { | thick | } conc_op | fc | rebar_op | fy | area_ba | area_bb | area_ta | area_tb | add_ecc | fc_op { | fc_data } | gamma_c_op | gamma_c | fy_op { | fy_data } | gamma_s_op | gamma_s | phi_op { | phi_data } | min_ecc_op | min_ecc | comp_op { | comp_ba | comp bb | comp_ta | comp_tb }

Description

Reinforced concrete slab design properties

Parameters

num record number
name name
theta_a reinforcement angle A
theta_b reinforcement angle B
z_ta,z_ba surface to axis distance at top and bottom in A direction
z_tb,z_bb surface to axis distance at top and bottom in B direction
thick_op thickness option
ANALYSIS use analysis thickness
USER user defined thickness
{{
thick user defined slab thickness (omitted if thick_op is ANALYSIS)
}}
rebar rebar grade
area_ba minimum area or rebar per unit width at top in A direction
area_bb minimum area or rebar per unit width for bottom in A direction
area_ta minimum area or rebar per unit width for top in A direction
area_tb minimum area or rebar per unit width for top in B direction
add_ecc user defined additional eccentricity
add_ecc_mod user defined additional eccentricity two-way modifier
add_ecc_dir user defined additional eccentricity two-way principal direction
comp_op override the minimum compression reinforcement
USER user defined
CODE design code specified
{{
comp_min minimum compression area (omitted if CODE)
comp_ta minimum compression reinforcement at top in A direction
comp_ba minimum compression reinforcement at bottom in A direction
comp_tb minimum compression reinforcement at top in B direction
comp_bb minimum compression reinforcement at bottom in B direction
}}
min_ecc_op option for minimum eccentricity
USER user defined
CODE design code specified
{{
min_ecc minimum eccentricity (omitted if CODE)
}}
soln calculation method
FAST fast method
RIGOROUS rigorous method
limit maximum limit of reinforcement ratio for using fast calculation method, i.e. if reinforcement ratio higher than this, rigorous method will be used regardless
x_d_max maximum x over depth ratio
strain design strain limit
phi_delta crack rotation limit in degrees
phi_c strength reduction factor for axial compression (ASSHTO, ACI & Australia codes)
phi_t strength reduction factor for axial tension and bending (ASSHTO, ACI & Australia codes)
concrete concrete grade
conc_op concrete grade option
STANDARD standard
USER user defined
fc the concrete grade name (standard) or the concrete strength (user defined)
rebar_op rebar grade option
STANDARD standard
USER user defined
fy the rebar grade name (standard) or the rebar strength (user defined)
fc_op concrete property option
DERIVED derived from concrete cube strength according to design code
MODIFIED user defined
{{
fc_data concrete properties (omitted if fc_op is DERIVED)
1st item uncracked compressive design strength
2nd item cracked compressive design strength
3rd item tensile design strength
4th item compressive plateau strain
5th item maximum axial compressive strain
6th item maximum flexural compressive strain
7th item minimum ratio of depth to neutral axis to effective depth in flexural situations
8th item maximum ratio of depth to neutral axis to effective depth in flexural situations
9th item proportion of depth to neutral axis over which constant stress acts
}}
gamma_c_op option for partial safety factor of concrete
DERIVED derived according to design code
MODIFIED user defined
gamma_c gamma_c (omitted if gamac_op is DERIVED)
fy_op rebar property option
DERIVED derived from rebar characteristic strength according to design code
MODIFIED user defined
{{
fy_data it should be omitted if fy_op is DERIVED, otherwise the following items (rebar properties) should be given
1st item design strength in tension
2nd item design strength in compression
3rd item elastic modulus
4th item maximum linear stress
5th item yield strain in tension
6th item yield strain in compression
}}
gamma_s_op option for partial safety factor of rebar
DERIVED derived according to design code
MODIFIED user defined
gamma_s partial safety factor for rebar (omitted if gammas_op is DERIVED)
phi_op option for strength reduction factors
DERIVED derived according to design code
MODIFIED user defined
{{
phi_data strength reduction factors (omitted for version 2 if phi_op is DERIVED)
1st item strength reduction factor for axial compression
2nd item strength reduction factor for axial tension and bending
}}

Index


REACT_FORCE

REACT_FORCE | node | case | x | y | z

Description

Node reaction force

Parameters

node node number
case analysis case
x,y,z forces [N]

Index


REACT_MOMENT

REACT_MOMENT | node | case | x | y | z

Description

Node reaction moment

Parameters

node node number
case analysis case
x,y,z moments [N.m]

Index


REGION

REGION.4 | ref | name | colour | plane | region | nodes | lines | areas | CM2_MESHTOOLS | split | triangle | odd | opti | target | gradation | quality | shape | offset | elem | soil | size

REGION.4 | ref | name | colour | plane | region | nodes | lines | areas | QUAD_BUILD | mesh_step | mesh_density | rigorous | shape | offset | elem | soil | size

REGION.3 | ref | name | colour | plane | region | nodes | lines | areas | CM2_MESHTOOLS | opti | target | gradation | quality | shape | offset | elem | soil

REGION.3 | ref | name | colour | plane | region | nodes | lines | areas | QUAD_BUILD | mesh_step | mesh_density | rigorous | shape | offset | elem | soil

REGION.2 | ref | name | colour | plane | region | nodes | lines | areas | mesh_step | mesh_density | rigorous | shape | CAD_format | bandwidth | offset | elem | soil | mesh_op

REGION.1 | ref | name | plane | region | nodes | lines | areas | mesh_step | mesh_density | rigorous | shape | CAD_format | bandwidth | offset | elem

Description

region definition

Parameters

ref number
name name
colour colour (ref. colour syntax)
plane grid plane reference (used in mesh generation as the projection plane)
region region type
UNDEF | GENERAL | 2D_MESH | RIGID
nodes node references
lines line references
areas area references
mesh mesh generator option
QUAD_BUILD quad-build mesh generator attributes
CM2_MESHTOOLS CM2 MeshTools mesh generator attributes
split split badly shaped quads into tri elements
YES | NO
triangle create triangle elements during mesh generation
YES | NO
odd allow odd number of elements to be genarated along a line
YES | NO
opti optimization level of MeshTools in range 1 to 10
defualt value = 3
target target element size at the interior region
0.0 is the default value for the MeshTools
gradation smooth gradation from boundary to interior region in range from 0 to 1
0.5 is the default value for the MeshTools
quality shape quality weight
0 indicates size quality prevails
1 indicates shape quality prevails
0.6 is the default value for the MeshTools
mesh_step meshgen: mesh step type
CONSTANT | LINEAR
mesh_densitymeshgen: mesh density
FINE | DENSE | SPARSE
rigorous meshgen: fast or rigorous
FAST | RIGOROUS
shape element type
QUAD4 | QUAD8 | QUAD9
CAD_format meshgen: CAD-friendly input data format
YES | NO
bandwidth meshgen: renumber for minimum bandwidth
YES | NO
offset offset generated 2D elements downwards by half thickness
YES | NO
elem generate 1D elements from aligned members
YES | NO
soil meshgen: create soil spring support constraints per generated 2D element
YES | NO
size region's element size
mesh_op mesh generation option
SIMPLE simple mesh generation
QUAD_BUILD mesh generation by Quad Build
UNDEF undefined option

Index


RESID_DISP

RESID_DISP | case | value

Description

Residual displacement

Parameters

case analysis case
value residual displacement [m]

Index


RESID_FORCE

RESID_FORCE | case | value

Description

Residual force

Parameters

case analysis case
value residual force [N]

Index


RESID_MOMENT

RESID_MOMENT | case | value

Description

Residual moment

Parameters

case analysis case
value residual moment [N.m]

Index


RESP_FORCE

RESP_FORCE | case | fx | fy | fz

Description

Forces in response analysis

Parameters

case analysis case
fx force in x direction
fy force in y direction
fz force in z direction

Index


RESP_MOMENT

RESP_MOMENT | case | mx | my | mz

Description

Moments in response analysis

Parameters

case analysis case
mx moment in x direction
my moment in y direction
mz moment in z direction

Note

See RESP_ORIGIN for details of origin.

Index


RESP_ORIGIN

RESP_ORIGIN | case | x | y | z

Description

Origin for response analysis

Parameters

case analysis case
x x coordinate of response origin
y x coordinate of response origin
z x coordinate of response origin

Index


RESP_SCALE

RESP_SCALE | case | force | disp

Description

Scale factors in response analysis

Parameters

case analysis case
force force scaling
in x,y and z direction
disp displacement scaling
in x,y and z direction

Index


RIGID

RIGID.3 | name | primary_node | type | constrained_nodes | stage | parent_member

RIGID.2 | name | primary_node | type | constrained_nodes | stage

RIGID.1 | primary_node | type | constrained_nodes | stage

Description

Rigid constraint definition

Parameters

name tigid constraint name
primary_nodeprimary node
type link type
ALL all directions
XY_PLANE xy plane
YZ_PLANE yz plane
ZX_PLANE zx plane
XY_PLATE xy plate
YZ_PLATE yz plate
ZX_PLATE zx plate
PIN all directions, pin at constrained node
XY_PLANE_PIN xy plane, pin at constrained node
YZ_PLANE_PIN yz plane, pin at constrained node
ZX_PLANE_PIN zx plane, pin at constrained node
XY_PLATE_PIN xy plate, pin at constrained node
YZ_PLATE_PIN yz plate, pin at constrained node
ZX_PLATE_PIN zx plate, pin at constrained node
<link> explicit definition of the link type (see note)
constrained_nodes list of constrained nodes
stage list of stages in which constraint is active
parent_memberThe member from which the constraint was generated

Note

Custom links are written in the form constrained_node:primary_node-consatrained_node:primary_node e.g. X:XYY-Y:YXX give a linkage so that the constrained node x displacement depends on the primary node x and yy displacements and the constrained node y displacement depends on the primary node y and xx displacements

Index


ROTN

ROTN | node | case | x | y | z

Description

Nodal rotation

Parameters

node node number
case analysis case
x,y,z rotations [-]

Index


ROTN_ELEM

ROTN_ELEM | elem | case | pos | x | y | z

Description

element rotation

Parameters

elem element number
case analysis case
pos position on element
0 | 1 | ...
x,y,z rotations [-]

Index


ROT_ACC

ROT_ACC | node | case | x | y | z

Description

Nodal rotational acceleration

Parameters

node node number
case analysis case
x,y,z rotational accelerations [/s²]

Index


ROT_VEL

ROT_VEL | node | case | x | y | z

Description

Nodal rotational velocity

Parameters

node node number
case analysis case
x,y,z rotational velocities [/s]

Index


SECTION

SECTION.7 | ref | colour | name | memb | pool | point | refY | refZ | mass | fraction | cost | left | right | slab | num { <comp> }

SECTION.7 | ref | colour | name | memb:EXPLICIT | t

SECTION.6 | ref | colour | name | memb | pool | point | refY | refZ | mass | fraction | cost | mod | left | right | slab

SECTION.6 | ref | colour | name | memb:EXPLICIT | mat

SECTION.3 | ref | name | memb | mod | axes | point | ref Y| refZ | mass | fraction | cost | mod | left | right | slab

SECTION.3 | ref | name | memb:EXPLICIT | mod | mat

SECTION.2 | ref | name | memb | point | refY | refZ | mass | fraction | cost | mod | left | right | slab

SECTION.2 | ref | name | memb:EXPLICIT | mat | matType | mat | area | Iyy | Izz | J | ky | kz | vol | mass | fraction | cost

Description

Section

Parameters

ref section reference
name section name
colour colour
memb member type
GENERIC Generic
BEAM Beam
COLUMN Column
SLAB Slab/Wall
RIBSLAB Ribbed Slab
COMPOS Composite Beam
PILE Pile
EXPLICIT Explicit (defined by A, Iyy, Izz, J, ky, kz)
pool pool reference
mod modifier reference - no longer used
axes axis option - no longer used
point reference point on section
CENTROID
TOP_LEFT
TOP_CENTRE
TOP_RIGHT
MIDDLE_LEFT
MIDDLE_RIGHT
BOTTOM_LEFT
BOTTOM_CENTRE
BOTTOM_RIGHT
refY y offset from basic reference point
refZ z offset from basic reference point
matType material type
anal analysis material
area section area
Iyy section Iyy
Izz section Izz
J section torsion constant|
ky y shear area factor
kz z shear area factor
vol volume per unit length
mass additional (non-structural) mass per unit length
fractionadditional mass fraction (modifies rho.volume)
cost cost
left fraction attributed to left end (beams)
right fraction attributed to right end (beams)
slab width of slab members (overridden for composite
beam by left and right values in Composite definition)
num number of components
{{
comp component definitions SECTION_COMP
}}

Index


SECTION_COMP

SECTION_COMP | ref | name | matAnal | matType | matRef | desc | offset_y | offset_z | rotn | reflect | pool

Description

Section component

Parameters

ref record.component number
name component name
matAnal analysis material
matType material type
matRef material reference
desc component section description
offset_yy offset of component in section
offset_zz offset of component in section
rotn rotation of component in section
reflect reflection of component in section
NONE no reflection
Y_AXIS reflection about a Y axis
Z AXIS reflection about a Z axis
BOTH reflection about both horizontal and vertical axis
pool section pool
taperTypetapered section type
NONE no taper
SIMPLE Simple
HOR_TAPER Horizontal/taper
LINEAR Linear taper
HAUNCH Haunched taper
FISH_BELLY Fish belly
taperPosposition defining taper

Index


SECTION_CONC

SECTION_CONC | ref | grade | agg

Description

Section concrete attributes

Parameters

ref section.component
grade concrete grade
agg aggregate size

Index


SECTION_HOLE

SECTION_HOLE.3 | ref | tag | shape | area | pos_y | pos_z SECTION_HOLE.2 | ref | shape | area | pos_y | pos_z

Description

Holes in section

Parameters

ref record.component number
tag position tag
shape hole shape
CIRCLE
SQUARE
area area of hole
pos_y y position of hole
pos_z z position of hole

Index


SECTION_MARKUP

SECTION_MARKUP.1 | ref | entity | ys | zs | ye | ze | text

Description

Section markup

Parameters

ref record.component number
entity entity type
UNDEF
POINT
LINE
TEXT
ys y coordinate of start
zs z coordinate of start
ye y coordinate of end (0 if unused)
ze z coordinate of end (0 if unused)
text markup text

Index


SECTION_MOD

SECTION_MOD | ref | name | mod | centroid | stress | opArea | area | prin | opIyy | Iyy | opIzz | Izz | opJ | J | opKy | ky | opKz | kz | opVol | vol | mass

Description

Section modifiers

Parameters

ref section reference
name name
mod modifications apply to
GEOMETRY geometry
STIFF stiffness
centroiduse centroid as reference point in analysis
SEC as specified in section
CEN centroid
stress stresses based on modifications
NONE no modification
UNMOD use unmodified
MOD use modified
opArea area modification option
BY modify by
TO modify to
area area factor
prin stiffness in principal axes
UV principal
YZ local (ignode cross terms)
opIyy Iyy modification option
Iyy Iyy factor
opIzz Izz modification option
Izz Izz factor
opJ J modification option
J J factor
opKy ky modification option
kz ky factor
opKz kz modification option
kz kz factor
opVol volume per unit length modification option
vol volume per unit length factor
mass additional non-structural mass/length

Index


SECTION_SMEAR

SECTION_SMEAR | ref | mat | fraction | bar | pitch | cover

Description

Smeared reinforcement in section

Parameters

ref section.component reference
mat reinforcement material
fraction fraction of reinforcement in section (by area)
bar bar size
pitch bar pitch
cover bar cover

Index


SECTION_STEEL

SECTION_STEEL | ref | grade | plasElas | netGross | exposed | beta | type | plate | lock

Description

Section component steel definition

Parameters

ref record.component number
grade material grade
plasElasmax plastic : elastic ratio
netGrossnet : gross area ratio
exposed exposed perimeter area ratio
beta beta value for bolted angles (IS and EC3)
type section type
UNDEF undefined
ROLLED Hot rolled/finished
WELDED Welded
FORMED Cold formed
LWELDED Lightly welded
STRESS Cold formed (stress relieved)
plate plate type
UNDEF undefined
FLAMECUT Flame cut
ASROLLED As rolled
lock lock section type
LOCK type locked
NO_LOCK type not locked

Index


SETTLE

SETTLE.2 | name | list | case | dir | value

SETTLE.1 | list | case | dir | value

Description

Settlement definition

Parameters

name name of the load
list list of nodes
case load case number
dir load direction
X | Y | Z | XX | YY | ZZ
value settlement [m]

Index


SET_AT

SET_AT | record | key | <data>

Description

Set data

Parameters

record record number
key key word
<data> data for key

Index


SHEAR_2D

SHEAR_2D | elem | case | pos | x | y

Description

2D element through thickness shear force

Parameters

elem element number
case analysis case
pos position on element
-1 | 0 | 1 ... (-1 centre)
x,y forces [N/m]

Index


SID

SID | sid

Description

Revit ID

Parameters

sid Revit ID

Index


SOAP_STRESS_1D

SOAP_STRESS_1D | num | name | axis | stress

Description

1D element soap-stress property definition

Parameters

num record number
name name
axis axis
stress soap stress [N]

Index


SOAP_STRESS_2D

SOAP_STRESS_2D | num | name | stressX | stressY

Description

2D element soap-stress property definition

Parameters

num record number
name name
stressX soap stress in X [N/m]
stressY soap stress in Y [N/m]

Index


SOIL_CURVE

SOIL_CURVE | num | desc | points | { strain | factor }

Description

Raft non-linear curve definition

Parameters

num record number
name name
points number of points
{{
strain strain value
factor factor
}}

Index


SOIL_PROFILE

SOIL_PROFILE.3 | num | profile | id | layer | colour | top | num | Etop | Ebot | nu | curve | prop

SOIL_PROFILE.2 | num | id | profile | colour | top | num | Etop | Ebot | nu | curve | prop

SOIL_PROFILE.1 | num | id | profile | top | num | Etop | Ebot | nu | curve | prop

Description

Raft soil profile definition

Parameters

num profile number
profile profile name
id layer number
layer layer name
colour layer colour
top top level [m]
num number of intervals
Etop,Ebot E at top and bottom [Pa]
nu Poisson's ratio
curve non-linear curve number
prop pile soil interaction property

Index


SOIL_PSI_CURVE

SOIL_PSI_CURVE | num | desc | points | { rel_disp | factor }

Description

Raft pile soil interaction curve definition

Parameters

num record number
desc description
point number of points
{{
rel_disp normalised relative displacement between pile and soil
factor stress factor
}}

Index


SOIL_PSI_PROP

SOIL_PSI_PROP | num | name | Xcurve | Ycurve | Zcurve | Bcurve | Xtop | Xbot | Ytop | Ybot | Ztop | Zbot | Btop | Bbot

Description

Raft pile soil interaction property definition

Parameters

num record number
name name
ref reference number, the one refered by soil profile
Xcurve pile soil interaction curve for x direction interaction
Ycurve pile soil interaction curve for y direction interaction
Zcurve pile soil interaction curve for z direction interaction
Bcurve pile soil interaction curve for pile base vertical interaction
Xtop yield stress at top of the soil layer in x direction
Xbot yield stress at bottom of the soil layer in x direction
Ytop yield stress at top of the soil layer in y direction
Ybot yield stress at bottom of the soil layer in y direction
Ztop yield stress at top of the soil layer in z direction
Zbot yield stress at bottom of the soil layer in z direction
Btop yield stress at top of the soil layer for column base
Bbot yield stress at bottom of the soil layer for column base

Index


SOIL_RECT_LOAD

SOIL_RECT_LOAD.2 | num | name | orient | x | y | z | angle | dim_x | dim_y | load_norm | shear_x | shear_y |

Description

Soil rectangular loads definition - loads directly on soil

Parameters

num record number
orient orientation of loaded plane
HORIZ horizontal
VERT vertical
x x coordinate of centre of loading area [m]
y y coordinate of centre of loading area [m]
z z coordinate of centre of loading area [m]
angle rotation angle of the loading plane - angle between local x and Global X [°]
dim_x x dimension of loaded area
dim_y y dimension of loaded area
load_norm normal load [Pa]
shear_x shear pressure load in local x direction [Pa]
shear_y shear pressure load in local y direction [Pa]

Index


SOIL_ZONE

SOIL_ZONE | num | name | x_min | x_max | y_min | y_max | profile

Description

Raft soil zone definition

Parameters

num record number
name name
x_min,x_max x extents [m]
y_min,y_max y extents [m]
profile soil profile

Index


SPACER_TOL

SPACER_TOL | leg_length

*** DEPRECATED ***

Index


SPEC

SPEC | type | x | y | z | xx | yy | zz | edge

Description

General specification

Parameters

type structure type
SPACE
PLANE
GRID
PL_STRS plane stress
PL_STRN plane strain
AXI axisymmetric
x,y,... global restraints
0 free
1 restrained
edge edge load option
EDGE_PRES pressure load on 2D element edges
EDGE_FPERL force/length load on 2D element edges

Index


SPECTRUM

SPECTRUM | num | name | AS1170-07 | soil | Kp | Z | Su | Sp | design | CQC | scale | damp

Description

AS11770-07 response spectrum definition

Parameters

num spectrum number
name name
soil soil type
A | B | C | D | E
Kp probability factor
Z hazard design factor
Su structural ductility
Sp structural performance factor
design flag to identify design spectrum
TRUE | FALSE
CQC damping option for CQC combinations
CODE code damping
CONST override with constant value for CQC damping
TABLE use table of damping value
MODE modal damping
scale scale spectrum accelerations
CODE code spectrum - nod scaling
NEWMARK_50 Newmark-Hall : 50th percentile
NEWMARK_84 Newmark-Hall : 84th percentile
ISO_19901 ISO 19901
damp damping value (value not percentage)
value if damping is CONST
table if damping is TABLE
n/a if damping id CODE or MODE

Index


SPECTRUM

SPECTRUM | num | name | ASCE7-05 | soil | Ss | S1 | Tl | R | Cd | occupancy | frame | height | short | calc | CQC | scale | damp

SPECTRUM | num | name | ASCE7-10 | soil | Ss | S1 | Tl | R | Cd | occupancy | frame | height | short | calc | CQC | scale | damp

Description

ASCE7 response spectrum definition

Parameters

num spectrum number
name name
soil soil type
A | B | C | D | E
Ss short period response
S1 1s response
Tl long period transition
R R factor
Cd Deflection amplification factor
occupancy occupancy category
I | II | III | IV
frame frame type
MOMENT moment resisting frames
COUPLED coupled walls
BRACED braced frames
WALLS walls, walls frame systems
OTHER other systems
height building height
short flag to ignore short period reduction
TRUE | FALSE
calc calculation scaling
CODE
ELASTIC
INELASTIC
CQC damping option for CQC combinations
CODE code damping
CONST override with constant value for CQC damping
TABLE use table of damping value
MODE modal damping
scale scale spectrum accelerations
CODE code spectrum - nod scaling
NEWMARK_50 Newmark-Hall : 50th percentile
NEWMARK_84 Newmark-Hall : 84th percentile
ISO_19901 ISO 19901
damp damping value (value not percentage)
value if damping is CONST
table if damping is TABLE
n/a if damping id CODE or MODE

Index


SPECTRUM

SPECTRUM | num | name | EC8:1994 | soil | AgR | xi | q | design | CQC | scale | damp

SPECTRUM | num | name | EC8:2003 | soil | type | AgR | I | xi | q | design | CQC | scale | damp

SPECTRUM | num | name | EC8:2004 | soil | type | AgR | I | xi | q | qd | lower | design | CQC | scale | damp

Description

Eurocode 8 response spectrum definition

Parameters

num spectrum number
name name
soil soil type
A | B | C EC8 1994
A | B | C | D | E EC8 2003, 2004
type spectrumm type
AgR ground accelerations
I importance
xi spectral damping
q q factor
qd qd (displacement) factor
lower lower bound factor (beta)
design flag to identify design spectrum
TRUE | FALSE
CQC damping option for CQC combinations
CODE code damping
CONST override with constant value for CQC damping
TABLE use table of damping value
MODE modal damping
scale scale spectrum accelerations
CODE code spectrum - nod scaling
NEWMARK_50 Newmark-Hall : 50th percentile
NEWMARK_84 Newmark-Hall : 84th percentile
ISO_19901 ISO 19901
damp damping value (value not percentage)
value if damping is CONST
table if damping is TABLE
n/a if damping id CODE or MODE

Index


SPECTRUM

SPECTRUM | num | name | FEMA356 | soil | Ss | S1 | beta | Ct | C3 | vertical | short | CQC | scale | damp

Description

FEMA 356 response spectrum definition

Parameters

num spectrum number
name name
soil soil type
A | B | C | D | E
Ss short period response
S1 1s response
beta beta damping factor
Ct construction type
STEEL | CONC | EBF | WOOD | OTHER
C3 C3 factor
vertical flag for vertical spectrum
short flag to ignore short period reduction
TRUE | FALSE
CQC damping option for CQC combinations
CODE code damping
CONST override with constant value for CQC damping
TABLE use table of damping value
MODE modal damping
scale scale spectrum accelerations
CODE code spectrum - nod scaling
NEWMARK_50 Newmark-Hall : 50th percentile
NEWMARK_84 Newmark-Hall : 84th percentile
ISO_19901 ISO 19901
damp damping value (value not percentage)
value if damping is CONST
table if damping is TABLE
n/a if damping id CODE or MODE

Index


SPECTRUM

SPECTRUM | num | name | GB50011-01 | intensity | high | site | building | group | frequent | zeta | Treduce | Tg | alpha_max | CQC | scale | damp

SPECTRUM | num | name | GB50011-10 | intensity | high | site | building | group | frequent | zeta | Treduce | Tg | alpha_max | CQC | scale | damp

Description

GB50011 response spectrum definition

Parameters

num spectrum number
name name
intensity seismic intensity
6 | 7 | 8 | 9
high region with higher intensity
LOW | HIGH
site site type
I | II | III | IV 2001
I0 | I1 | II | III | IV 2010
building building category
A | B | C | D
must be C for this version
group seismic design group
1 | 2 | 3
frequent frequency of seismic occurance
FREQUENT | RARE GB 50011
zeta damping
Treduce period reduction factor
Tg characteristic period
alpha_max horizontal seismic influence coefficient
CQC damping option for CQC combinations
CODE code damping
CONST override with constant value for CQC damping
TABLE use table of damping value
MODE modal damping
scale scale spectrum accelerations
CODE code spectrum - nod scaling
NEWMARK_50 Newmark-Hall : 50th percentile
NEWMARK_84 Newmark-Hall : 84th percentile
ISO_19901 ISO 19901
damp damping value (value not percentage)
value if damping is CONST
table if damping is TABLE
n/a if damping id CODE or MODE

Index


SPECTRUM

SPECTRUM | num | name | IBC:2000 | soil | Ss | S1 | Ie | R | frame | vertical | short | CQC | scale | damp

SPECTRUM | num | name | IBC:2006 | soil | Ss | S1 | Tl | R | Cd | occupancy | frame | height | short | calc | CQC | scale | damp

SPECTRUM | num | name | IBC:2009 | soil | Ss | S1 | Tl | R | Cd | occupancy | frame | height | short | calc | CQC | scale | damp

SPECTRUM | num | name | IBC:2015 | soil | Ss | S1 | Tl | R | Cd | occupancy | frame | height | short | calc | CQC | scale | damp

Description

IBC response spectrum definition

Parameters

num spectrum number
name name
soil soil type
A | B | C | D | E
Ss,S1 short period and 1s response
Tl long period transition
R R factor
Cd Deflection amplification factor
occupancy occupancy category
I | II | III | IV
frame frame construction type
STEEL | CONC | EBF | OTHER
vertical flag for vertical spectrum
height building height
short flag to ignore short period reduction
TRUE | FALSE
calc calculation basis
CODE code based scaling
ELASTIC no scaling (ignore I, R Cd)
INELASTIC no base shaer scaling (use I, R, Cd)
CQC damping option for CQC combinations
CODE code damping
CONST override with constant value for CQC damping
TABLE use table of damping value
MODE modal damping
scale scale spectrum accelerations
CODE code spectrum - nod scaling
NEWMARK_50 Newmark-Hall : 50th percentile
NEWMARK_84 Newmark-Hall : 84th percentile
ISO_19901 ISO 19901
damp damping value (value not percentage)
value if damping is CONST
table if damping is TABLE
n/a if damping id CODE or MODE //

Index


SPECTRUM

SPECTRUM | num | name | IS1893 | zone | soil | I | R | xi | vertical | short | CQC | scale | damp

Description

IS1893 response spectrum definition

Parameters

num spectrum number
name name
zone seismic zone
II | III | IV | V
soil soil type
I | II | III IS 1893
I importance
R R factor
xi damping
vertical flag for vertical spectrum
short flag to ignore short period reduction
TRUE | FALSE
CQC damping option for CQC combinations
CODE code damping
CONST override with constant value for CQC damping
TABLE use table of damping value
MODE modal damping
scale scale spectrum accelerations
CODE code spectrum - nod scaling
NEWMARK_50 Newmark-Hall : 50th percentile
NEWMARK_84 Newmark-Hall : 84th percentile
ISO_19901 ISO 19901
damp damping value (value not percentage)
value if damping is CONST
table if damping is TABLE
n/a if damping id CODE or MODE

Index


SPECTRUM

SPECTRUM | num | name | ITALY | zone | soil | xi | q | design | short | CQC | scale | damp

Description

Italian response spectrum definition

Parameters

num spectrum number
name name
zone seismic zone
1 | 2 | 3 | 4
soil soil type
A | B | C | D | E
xi damping
q q factor
design flag to identify design spectrum
TRUE | FALSE
short flag to ignore short period reduction
TRUE | FALSE
CQC damping option for CQC combinations
CODE code damping
CONST override with constant value for CQC damping
TABLE use table of damping value
MODE modal damping
scale scale spectrum accelerations
CODE code spectrum - nod scaling
NEWMARK_50 Newmark-Hall : 50th percentile
NEWMARK_84 Newmark-Hall : 84th percentile
ISO_19901 ISO 19901
damp damping value (value not percentage)
value if damping is CONST
table if damping is TABLE
n/a if damping id CODE or MODE

Index


SPECTRUM

SPECTRUM | num | name | UBC:1994 | UBCzone | soil | I | Rw | period | shear | vertical | short | CQC | scale | damp

SPECTRUM | num | name | UBC:1997 | UBCzone | soil | I | R | period | Ct | shear | source | dist | vertical | short | calc | CQC | scale | damp

Description

UBC response spectrum definition

Parameters

num spectrum number
name name
UBCzone UBC zone
1 | 2A | 2B | 3 | 4
soil soil type
S1 | S2 | S3 UBC 94
SA | SB | SC | SD | SE UBC 97
I importance factor
R,Rw R,Rw factor
period period
Ct construction type
STEEL | CONC | EBF | OTHER
shear target base shear
80 | 90 | 100
source source type
A | B | C
dist distance from source ≥ 2000m ≤ 15000m
vertical flag for vertical spectrum
TRUE | FALSE
short flag to ignore short period reduction
TRUE | FALSE
calc calculation basis
CODE code based scaling
ELASTIC no scaling (ignore I, R Cd)
INELASTIC no base shaer scaling (use I, R, Cd)
CQC damping option for CQC combinations
CODE code damping
CONST override with constant value for CQC damping
TABLE use table of damping value
MODE modal damping
scale scale spectrum accelerations
CODE code spectrum - nod scaling
NEWMARK_50 Newmark-Hall : 50th percentile
NEWMARK_84 Newmark-Hall : 84th percentile
ISO_19901 ISO 19901
damp damping value (value not percentage)
value if damping is CONST
table if damping is TABLE
n/a if damping id CODE or MODE

Index


SPECTRUM

SPECTRUM | num | name | USER | abscissa | ordinate | num points | table_desc

Description

User defined response spectrum definition

Parameters

num spectrum number
name name
abscissa value type on abscissa
PERIOD | FREQ
ordinate value type on ordinate
DISP | VEL | ACCEL
num_point number of points
table_desc description of the spectrum table in text format e.g. (0,1)(0.5,1)(1.0,0.7)(2.0,0.4)... in unit of '[s] or [/s]', '[m] or [m/s] or [m/s2]'

Index


SPEC_ACC

SPEC_ACC | case | item |acc

Description

Spectral acceleration in response spectrum analysis

Parameters

case analysis case
item response item
acc response item spectral acceleration [m/s²]
three values for CQC3 combination

Index


SPEC_BRIDGE

SPEC_BRIDGE | code | uls1 | uls3 | sls1 | uls_unit | sls_unit | num_infl

SPEC_BRIDGE | CODE_EC1_UK | LC1 | LC3 | LC4 | LC1_veh | num_infl

SPEC_BRIDGE | CODE_EC1_LM1 | LC1 | LC3 | LC4 | LC1_veh | num_infl

SPEC_BRIDGE | CODE_AUS_5100_2 | WL | HL | HLP_pos | HLP_factor | SM1600_factor | offset | num_infl

SPEC_BRIDGE | CODE_US_AASHTO_17 | HLC | impact | num_infl

SPEC_BRIDGE | CODE_US_LRFD_3 | num_infl

SPEC_BRIDGE | CODE_NONE | railway | path_loading | num_infl

Description

Bridge analysis specification

Parameters

code bridge design code
CODE_UK_BD37
CODE_HK_SDM
UK_BD21_HB
UK_BD86_SV-TT
UK_BD86_SV-Train
UK_BD86_SV-150
UK_BD86_SV-100
UK_BD86_SV-80
UK_CS454_HB
uls1 uls combination 1
ULSCOMBO1_YES
ULSCOMBO1_NO
uls3 uls combination 3
ULSCOMBO3_YES
ULSCOMBO3_NO
sls1 sls combination 1
SLSCOMBO1_YES
SLSCOMBO1_NO
uls_unit number of uls HB units
sls_unit number of sls HB units
num_infl number of influence points
LC1 characteristic load
LC1_YES
LC1_NO
LC3 combination load
LC3_YES
LC3_NO
LC4 frequent load
LC4_YES
LC4_NO
LC1_veh vehicle of characteristic load
NONE
SV80
SV100
SV196
SOV250
SOV350
SOV450
SOV600
WL Walkway loading
AUS_WALKLOAD_NONE
AUS_WALKLOAD_VARIABLE
AUS_WALKLOAD_CONSTANT
HL Heavy loads
AUS_HEAVYLOAD_NONE
AUS_HEAVYLOAD_HLP320
AUS_HEAVYLOAD_HLP400
HLP_pos HLP lateral position
AUS_HLPPOS_LHS
AUS_HLPPOS_RHS
AUS_HLPPOS_EITHER
AUS_HLPPOS_SPECIFIED
HLP_factor HLP load factor
SM1600_factorSM1600 load factor
HLP_offset HLP offset (length unit)
HLC Highway loading class
US_LOADCLASS_H15_44
US_LOADCLASS_H20_44
US_LOADCLASS_HS15_44
US_LOADCLASS_HS20_44
impact impact fraction (percentage expressed by decimal point number)
railway UIC and UK railway loading
RAILWAY_YES
RAILWAY_NO
path_loadingpath loading used when bridge code is NONE
UK_HK
US
EC_UK
EC_LM1
EC_GENERIC
EC_USER
AUS
UK_ACCESS

Index


SPEC_BRIDGE_NDP

SPEC_BRIDGE_NDP | alpha_q1_veh | alpha_q2_veh | alpha_q3_veh | alpha_q1_udl | alpha_q2_udl | alpha_q3_udl | alpha_q4_udl | alpha_qr_udl | chi_0_ts | chi_0_udl | chi_0_ped | chi_0_pedrd | chi_0_lm3 | chi_1_ts | chi_1_udl | chi_1_ped | chi_1_pedrd | chi_1_lm3 | foot_on_verge

Description

National Determined Parameters used when bridge code "EC1_User" is selected

Index


SPEC_CONC_DESIGN

SPEC_CONC_DESIGN | code | country

Description

Concrete design code

Parameters

code concrete design code
country country code (e.g. UK, US, DE, HK, ...) (optional)

Note

The country codes are as per ISO 3166

Index


SPEC_DESIGN

SPEC_DESIGN | steel design code | rc beam design code | rc slab design code

*** DEPRECATED ***

Index


SPEC_LOAD_DESIGN

SPEC_LOAD_DESIGN | code

Description

Load design code

Parameters

code load design code

Index


SPEC_RAFT

SPEC_RAFT | rigid | e_ratio | p_ratio | method

Description

Raft analysis specification

Parameters

rigid rigid boundary level
e_ratio maximum Young's modulus ration of top and bottom of a soil layer
p_ratio global Poisson's ratio
method Mindlin analysis method
WEIGHTED_AVERAGE
GREATEST_STIFFNESS
DISP_POINT_STIFFNESS

Index


SPEC_STEEL_DESIGN

SPEC_STEEL_DESIGN | code

Description

Steel design code

Parameters

code steel design code

Index


SPRING_FORCE

SPRING_FORCE | node | case | x | y | z

Description

Nodal spring force

Parameters

node node number
case analysis case
x,y,z spring forces [N]

Index


SPRING_MOMENT

SPRING_MOMENT | node | case | x | y | z

Description

Nodal spring moment

Parameters

node node number
case analysis case
x,y,z spring moment [N.m]

Index


SPR_MATRIX

SPR_MATRIX | num | name | k11 | k12 | k13 | k14 | k15 | k16 | k22 | k23 | k24 | k25 | k26 | k33 | k34 | k35 | k36 | k44 | k45 | k46 | k55 | k56 | k66 |

Description

General spring matrix

Parameters

num record number
name name
kij stiffness value

Index


STEEL_BEAM_DES

STEEL_BEAM_DES | num | name | grade | area_ratio | plas_elas | over | Lyy | Lzz | Llt | { fy | fu | E | fact | } temp | expo | perim

Description

Steel beam design properties

Parameters

num record number
name name
grade steel grade
area_ratio net:gross area ratio
plas_elas plastic:elastic ratio
over override effective lengths
CALC calculate the effective lengths
OVER override the calculated effective lengths
Lyy,Lzz,Llt effective lengths
fy design strength (if grade is USER_DEFINED)
fu tensile strength ( ditto )
E Elastic modulus ( ditto )
fact strength factor ( ditto )
temp temperature
expo exposure type
EXPO_ALL all faces exposed
EXPO_3SIDES_PROTECT protected member with 3 faces exposed
EXPO_3SIDES_UNPROTECT unprotected member with 3 faces exposed
perim exposed perimeter area ratio (not currently used)

Index


STEEL_POOL

STEEL_POOL | num | name

Description

Steel section pools

Parameters

num record number
name pool name

Note

Sections are given a pool reference

Index


STOREY_ACTIVE_INERTIA

STOREY_ACTIVE_INERTIA | case | storey | Ixx | Iyy | Izz | Ixy | Iyz | Izx

Description

Structure inertia

Parameters

case analysis case
storey storey
Ixx,Iyy,... inertia tensor [kg.m²]

Index


STOREY_ACTIVE_MASS

STOREY_ACTIVE_MASS | case | storey | x | y | z

Description

Storey active mass

Parameters

case analysis case
storey storey
x storey active mass, x direction [kg]
y storey active mass, y direction [kg]
z storey active mass, z direction [kg]

Index


STOREY_CENTRE_MASS

STOREY_CENTRE_MASS | case | storey | x | y | z

Description

Structure centre of mass

Parameters

case analysis case
storey storey
x,y,z coordinates of centre of mass [m]

Index


STOREY_ELEV

STOREY_ELEV | num | name | elev | above | below

Description

Storey definition

*** DEPRECATED ***

Parameters

num record number
name name
elev elevation [m]
above tolerance above elevation included in storey [m]
below tolerance below elevation included in storey [m]

Index


STOREY_INERTIA

STOREY_INERTIA | case | storey | Ixx | Iyy | Izz | Ixy | Iyz | Izx

Description

Storey inertia

Parameters

case analysis case
storey storey
Ixx,Iyy,... inertia tensor [kg.m²]

Index


STOREY_MASS

STOREY_MASS | case | storey | value

Description

Storey mass

Parameters

case analysis case
storey storey
value storey mass [kg]

Index


STRAIN_ENERGY

STRAIN_ENERGY | elem | case | energy

Description

Element strain energy

Parameters

elem element number
case analysis case
energy element strain energy [N.m]

Index


STRESS_2D

STRESS_2D | elem | case | pos | layer | xx | yy | zz | xy | yz | zx

Description

2D element stress

Parameters

elem element number
case analysis case
pos position on element
-1 | 0 | 1 ... (-1 centre)
layer through thickness layer
TOP | MIDDLE | BOTTOM
xx,yy,... stresses [N/m²]

Index


STRESS_3D

STRESS_3D | elem | case | pos | xx | yy | zz | xy | yz | zx

Description

3D element stress

Parameters

elem element number
case analysis case
pos position on element
0 | 1 | ... nodes, face centres and centre
xx,yy,... stresses [N/m²]

Index


ST_BRIDGE_LOAD

ST_BRIDGE_LOAD | num | name | group | path | type | start | end | vehicle | intensity | effect

Description

Static bridge load definition

Parameters

num record number
name name
group group number
path path number
type load type
UDL uniform
KEL knife edge load
VEHICLE vehicle
start start position [m]
end end position [m]
vehicle vehicle
see BASIC_BRIDGE_LOAD for details of standard vehicles
intensity load intensity [N/m][N][-]
effect load effect

Index


TASK

TASK.2 | task | name | stage | GSS | solution | mode_1 | mode_2 | num_iter | p_delta | p_delta_case | prestress | result | <blank> | geometry | lower | upper | raft | residual | shift | stiff | mass_filter | max_cycle

TASK.1 | task | name | stage | GSS | solution | mode_1 | mode_2 | num_iter | p_delta | p_delta_case | prestress | result | front_op | vector | x | y | z | <blank> | geometry | lower | upper | <blank> | residual | shift | stiff | mass_filter | max_cycle

Description

Analysis task definition

Parameters

task task number
name task name
stage analysis stage
GSS GSS solver
solution solution type
UNDEF no solution specified
STATIC
MODAL
RITZ
BUCKLING
STATIC_P_DELTA
MODAL_P_DELTA
RITZ_P_DELTA
MASS
STABILITY
STABILITY_P_DELTA
STATIC_NL_P_DELTA used internally only
INFLUENCE used internally in bridge analysis
:NUMBER_OF_MODES Modal analysis for fixed number of modes
:FREQUENCY_CUTOFF Modal analysis for all modes between two frequencies
:TARGET_MASS Modal analysis for a specified target mass
:TARGET_MASS_MASIL Modal analysis for a specified target mass using MASIL
mode_1 mode parameter 1
STABILITY(_P_DELTA) number of high modes
start mode
mode_2 mode parameter 2
STABILITY(_P_DELTA) number of low modes
number of modes
numiter number of iterations
p_delta static p-delta option
DEFINE one p-delta case used for all analysis cases
SELF each analysis case defines its own p-delta case
An analysis case n provides the p-delta effects
Cn combination case n provides the p-delta effects
p_delta_caseP-delta case description
prestress prestress case description
result results (ref. result syntax)
front_op front order option
GEO geometric ordering
RCMK reverse Cuthill-McKee ordering
CMK Cuthill-McKee ordering
MIN minimum degree ordering
NODE nodal ordering
vector front vector type
AUTO GSA determines from order
USER user defined front vector
x,y, z front vector (if USER)
geometry 2D element geometry checks
ERROR treat geometry check failures as errors
SEVERE treat geometry check failures as severe warnings
lower lower cut-off (frequency or load factor)
NONE none set
value cut-off value
upper upper cut-off (frequency or load factor)
NONE none set
value cut-off value
residual save residual to file
RESID_NO don't save
RESID_NOCONV save if not converged
RESID_YES always save
shift shift applied in eigensolver - the eigenvalue shift represents shift in either load factor or (frequency in Hz × 2π)²
stiff stiffness factor
mass_filtereffective mass ratio for filtering modes
max_cycle maximum number of cycles for iterative solutions

TASK.2 | task | name | stage | GSS | STATIC_EXP_NL | scheme | init_load | num_cycle | residual_type | force_redsidual | moment_residual | elem_geo_K_1D | elem_geo_K_2D | elem_geo_K_3D | residual_check | mass_update_cycle | mass_type | mass_factor | inertia_factor | mass_power | inertia_power | damping_type | damping_trans | damping_rotn | result | show_progress | progress_update_cycle | progress_node | progress_dir | show_graphic | graphic_cycle

Parameters

task task number
name task name
stage analysis stage
GSS GSS solver
STATIC_EXP_NL solution of explicit nonlinear analysis
scheme load scheme
SINGLE single load increment
AUTO automatic load increment
init_load initial loads or initial analysis case
NONE no initial load
load_description load description of the initial loads, e.g. 1,4L1+1.6L2
analysis case description analysis case used as initial case, e.g. A1 or A3
num_cycle maximum number of cycles to be run
residual_type residual is relative of absolute
RELATIVE relative residual
ABSOLUTE absolute residual
force_redsidual accepted force residual
moment_residual accepted moment residual
elem_geo_K_1D geometric stiffness of 1D elements
KG_1D_YES 1D element geometric stiffness is considered
KG_1D_NO 1D element geometric stiffness is not considered
elem_geo_K_2D geometric stiffness of 2D elements
KG_2D_YES 2D element geometric stiffness is considered
KG_2D_NO 2D element geometric stiffness is not considered
elem_geo_K_3D geometric stiffness of 3D elements
KG_3D_YES 3D element geometric stiffness is considered
KG_3D_NO 3D element geometric stiffness is not considered
residual_check number of cycle to check residuals; 0 means automatic
mass_update_cyclenumber of cycle to update dummy mass ; 0 means automatic
mass_type dummy mass type
MASS_FACTOR_AUTO dummy mass factors are calculated and modified automatically during the analysis
MASS_FACTOR_DEFINED dummy mass factors are defined by users and keep constant during the analysis
mass_factor dummy mass factor
inertia_factor dummy inertia factor
mass_power dummy mass power factor
inertia_power dummy inertia power factor
damping_type type of damping
DAMPING_AUTO damping modified automatically during the analysis
DAMPING_DEFINED damping is defined by the users and kept unchanged
damping_trans percentage of damping in translational direction
damping_rotn percentage of damping for rotational direction
result results (ref. result syntax)
show_progress show analysis progress dialog box
SHOW_PROGRESS_YES show analysis progress dialog box during analysis
SHOW_PROGRESS_NO do not show analysis progress dialog box during analysis
progress_cycle cycle number to update progress dialog box
progress_node node number of the displacement is shown on progress dialog box
progress_dir direction of the displacement of progress_node to be shown
X X direction displacement
Y Y direction displacement
Z Z direction displacement
XY displacement in XY plane
|U| resultant displacement
XX rotation about X axis
YY rotation about Y axis
ZZ rotation about Z axis
|R| resultant rotation
show_graphic show analysis progress on graphic view
SHOW_GRAPHIC_YES
SHOW_GRAPHIC_NO
graphic_update number of cycles to update graphic view

TASK.2 | task | name | stage | GSS | EXP_TIME_HIST | geo_non | end_time | num_curve |< { curve, desc } ... > | ini_anal | elem_mass_fac | mass_desc | mass_dir | load_mass_fac | damper | rayleigh | freq_1 | xi_1 |freq_2 | xi_2 | num_time | < { end_time | interval } ... > | select | sel_node | sel_elem | time_step | mass_scale_fac | progress | progress_node | progress_dir | elem_time | result | result_sel | max_cycle

Parameters

task task number
name task name
stage analysis stage
geo_non geometric nonlinear
GEO_NONLINEAR
GEO_LINEAR
end_time end time of analysis in second
num_curve number of load curve / description pairs
curve load curve number
desc load description
ini_anal initial analysis case number, its analysis results will be used as the starting point for this analysis
elem_mass_fac element mass factor
mass_desc load desciption that are used to generate extra mass from load
mass_dir direction of the load that are used to generate mass
X | Y | Z
load_mass_fac factor to modify the generated mass from loads
damper damper element option
DAMPER damper element damping is considered
NONE damper element damping is ignored
rayleigh Rayleigh damping option
RAYLEIGH consider rayleigh damping
NONE ignore rayleigh damping
{{
freq_1 first frequency for Rayleigh damping
xi_1 first damping ratio
freq_2 second frequency
xi_2 second damping ratio
}}
num_time number of time ranges for saving the whole model
end_time time at end of time range
interval time interval in time range
select time interval for saving selected node and element results, minus number is the factor of analysis time step
sel_node selected node list for saving results
sel_elem selected element list for saving results
time_step analysis time step
negative percentage of smallest element critical time step
positive user defined absolute time step
mass_scale_fac maximum mass scaling factor that can be used
progress show progress dialog
PROG_DLG_YES
PROG_DLG_NO
progress_node node number for chart dialog
progress_dir displacement direction of the above for chart dialog
X | Y | Z
elem_time write required analysis time step by each element as user module
ELEM_TIME_YES | ELEM_TIME_NO
result results (ref. result syntax)
result_sel selected time-history node and element results (ref. result syntax)
max_cycle maximum number of cycles

TASK.1 | task | name | stage | GSRELAX | solution | scheme | num_case | beam_geo | shell_geo | first_inc | min_inc | max_inc | cycle | num_cycle | residual | force | moment | disp_ctrl | disp_node | disp_dir | disp_value | load_ctrl | load_factor | elem_list | cases | report_cycle | graphic_cycle | save_residual | damp_type | damp_disp | damp_rotn | mass_factor | inertia_factor | mass_power | inertia_power | auto_mass | auto_damp | save_elem | save_spacer | show_progress | show_graphic | result

Parameters

task task number
name task name
stage analysis stage
GSRELAX GsRelax solver
solution solution type
UNDEF no solution specified
STATIC_EXP_NL | STATIC_NL the two solutions are the same and both are nonlinear static analysis
FORM_FINDING
BUCKLING_MEMBER
scheme load scheme
nonlinear analysis SINGLE | AUTO
form finding FORM_FIND | SOAP_FORM | FORCE_FORM
Component buckling MEMB_BUCKLE
num_case number of analysis cases in the task
beam_geo beam geometric stiffness
BEAM_GEO_YES beam geometric stiffness is considered
BEAM_GEO_NO beam geometric stiffness is ignored
shell_geo shell geometric stiffness
SHELL_GEO_YES shell element geometric stiffness is considered
SHELL_GEO_NO shell element geometric stiffness is ignored
first_inc % of first load increment - used by automatic load increment analysis
min_inc % of minimum load increment
max_inc % of maximum load increment
cycle cycle control
CYCLE
TIME
num_cycle maximum number of cycles or maximum minutes to be run
residual relative of absolute residual
REL relative residual
ABS absolute residual
force force residual value
moment l moment residual value
disp_ctrl displacement in control? used by automatic load increment analysis
DISP_CTRL_YES
DISP_CTRL_NO
disp_node node where displacement control in checked
disp_dir direction of the displacement control
disp_value limiting displacement value
load_ctrl load factor in control? used by automatic load increment analysis
LOAD_CTRL_YES
LOAD_CTRL_NO
load_factor control load factor
elem_list element list, used by component buckling analysis
cases the list of analysis case number belong to this task, e.g. 2 3 4
report_cycle number of cycles between progress dialog box updates
graphic_cycle number of cycles between graphic updates
save_residual residual saving option
RESID_NO don't save
RESID_NOCONV save if not converged
RESID_YES always save
damp_type type of damping
DAMP_ARTIFICIAL
DAMP_VISCOUS
damp_disp percentage of damping for displacement
damp_rotn percentage of damping for rotation
mass_factor dummy mass factor
inertia_factor dummy inertia factor
mass_power dummy mass factor
inertia_power dummy inertia factor
auto_mass automatic dummy mass option
AUTO_MASS_YES
AUTO_MASS_NO
auto_damp automatic damping option
AUTO_DAMP_YES
AUTO_DAMP_NO
save_elem save element force as load after form-finding
FF_SAVE_ELEM_FORCE_YES
FF_SAVE_ELEM_FORCE_NO
save_spacer save spacer force as load after form-finding
FF_SAVE_SPACER_FORCE_TO_ELEM
FF_SAVE_SPACER_FORCE_TO_SPACER
FF_SAVE_SPACER_FORCE_TO_NONE
show_progress show progress dialog box
SHOW_PROGRESS_FULL
SHOW_PROGRESS_SUM
SHOW_PROGRESS_NONE
show_graphic show graphic view progress
SHOW_GRAPHIC_YES
SHOW_GRAPHIC_NO
result results (ref. result syntax)

TASK.2 | task | name | stage | GSSPEC | DYNAMIC_RESP | mode_task | combination | axis | spectrum_x | modes_x | spectrum_y | modes_y | spectrum_z | modes_z | include_combined | rigorous | result | source | num_drift < | drift_name | drift_x | drift_y | drift_storey > | num_disp < | disp_name | node1 | node2 | disp_axis > TASK.2 | task | name | stage | GSSPEC | DYNAMIC_RESP | mode_task | CQC3 | spectrum | modes | cqc3_a | vertical | rigorous | result | source | num_drift < | drift_name | drift_x | drift_y | drift_storey > | num_disp < | disp_name | node1 | node2 | disp_axis > TASK.1 | task | name | stage | GSSPEC | DYNAMIC_RESP | mode_task | combination | axis | include_x | spectrum_x | modes_x | include_y | spectrum_y | modes_y | include_z | spectrum_z | modes_z | rigorous | rigid | f_rigid | f1 | f2 | damp_calc | damp_scale | damping | result | source | num_drift < | drift_name | drift_x | drift_y | drift_storey > | num_disp < | disp_name | node1 | node2 | disp_axis >

Parameters

task task number
name task name
stage analysis stage
GSSPEC GsSpec solver
DYNAMIC_RESP solution of response spectrum analysis
mode_task task containing modal results
combination basic combination method
SRSS square roor sum of squares
CQC complete quadratic combination
ROSENBLUTH modified Rosenbluth
ABSSUM absolute sum
axis combination axis
spectrum(_x/y/z) spectrum in x/y/z direction
0 means exclude
modes(_x/y/z) list of modes in x/y/z direction
include_combined include basic combination results
NONE
SRSS
CQC3 CQC3 combined results
spectrum spectrum used in CQC3 combination
modes list of modes in CQC3 combination
cqc3_a CQC3 combination factor a
vertical whether vertical direction response is included in the combination
INCLUDE_VERTICAL vertical direction response is included
EXCLUDE_VERTICAL vertical direction response is excluded
rigorous analysis option
RIGOROUS
FAST
result results (ref. result syntax)//
source source associated with task
num_drift number of drift positions
drift_name name for drift position
drift_x,drift_y position for drift calculation
drift_storey storey list
num_disp number of relative displacement pairs
disp_name name for displacement pair
disp_1,disp_2 displacement nodes
disp_axis axis for output
rigid rigid method
NO_RIGID ignore rigid component (only option available)
GUPTA Gupta (general modal combination)
LINDLEY_YOW Lindley-Yow
f_rigid rigid frequency
f1 lower transition frequency
f2 upper transition frequency

TASK.2 | task | name | stage | GSSPEC | PSEUDO_RSA | mode_task | combination | axis | spectrum_x | modes_x | spectrum_y | modes_y | spectrum_z | modes_z | include_combined | rigorous | result | source | num_drift < | drift_name | drift_x | drift_y | drift_storey > | num_disp < | disp_name | node1 | node2 | disp_axis > | mode < | freq | mass | mx | my | mz > TASK.2 | task | name | stage | GSSPEC | PSEUDO_RSA | mode_task | CQC3 | spectrum | modes | cqc3_a | vertical | rigorous | result | source | num_drift < | drift_name | drift_x | drift_y | drift_storey > | num_disp < | disp_name | node1 | node2 | disp_axis > | mode < | freq | mass | mx | my | mz > TASK.1 | task | name | stage | GSSPEC | PSEUDO_RSA | mode_task | combination | axis | include_x | spectrum_x | modes_x | include_y | spectrum_y | modes_y | include_z | spectrum_z | modes_z | rigorous | rigid | f_rigid | f1 | f2 | damp_calc | damp_scale | damping | result | source | num_drift < | drift_name | drift_x | drift_y | drift_storey > | num_disp < | disp_name | node1 | node2 | disp_axis > | mode < | freq | mass | mx | my | mz >

Parameters

task task number
name task name
stage analysis stage
GSSPEC GsSpec solver
PSEUDO_RSA solution of pseudo response spectrun analysis
mode_task task containing modal results
combination basic combination method
SRSS square roor sum of squares
CQC complete quadratic combination
ROSENBLUTH modified Rosenbluth
ABSSUM absolute sum
axis combination axis
spectrum(_x/y/z) spectrum in x/y/z direction
0 means exclude
modes(_x/y/z) list of modes in x/y/z direction
include_combined include basic combination results
NONE
SRSS
combination_spectrumthe response spectrum number to be used in the combination
CQC3 CQC3 combined results
spectrum spectrum used in CQC3 combination
modes list of modes in CQC3 combination
cqc3_a CQC3 combination factor a
vertical whether vertical direction response is included in the combination
INCLUDE_VERTICAL vertical direction response is included
EXCLUDE_VERTICAL vertical direction response is excluded
rigorous analysis option
RIGOROUS
FAST
result results (ref. result syntax)//
source source associated with task
num_drift number of drift positions
drift_name name for drift position
drift_x,drift_y position for drift calculation
drift_storey storey list
num_disp number of relative displacement pairs
disp_name name for displacement pair
disp_1,disp_2 displacement nodes
disp_axis axis for output
mode number of modal sets
freq frequency
mass modal mass
mx effective mass in x
my effective mass in y
mz effective mass in z
rigid rigid method
NO_RIGID ignore rigid component (only option available)
GUPTA Gupta (general modal combination)
LINDLEY_YOW Lindley-Yow
f_rigid rigid frequency
f1 lower transition frequency
f2 upper transition frequency

TASK.1 | task | name | stage | GSSPEC | HARMONIC | mode_task |load | low_freq | high_freq | freq_inc | damping | damp_table | damp_ratio | result

Parameters

task task number
name task name
stage analysis stage
GSSPEC GsSpec solver
HARMONIC solution
mode_task task containing modal results
load load description
low_freq start load frequency
high_freq end load frequency
freq_inc load frequency increment
damping damping type
CONST constant damping for all modes
FREQ use a feequency damping table
MODE override a constant damping with mode specific values
MATERIAL use damping calculated from material
damp_table damping table reference
ref reference to frequency table (FREQ)
table table description (MODE)
0 unused (CONST, MATERIAL)
damp_ratio percentage of critical damping ratio, e.g. 3.0 represents 3.0%
result results (ref. result syntax)

TASK.1 | task | name | stage | GSSPEC | TIME_HISTORY | mode_task | LOAD_EXCITE | load | history | time_out | time_hist | stop | step | damping | damp_table | damp_ratio | results TASK | task | name | stage | GSSPEC | TIME_HISTORY | mode_task | BASE_EXCITE | accel | accel_x | accel_y | accel_y | history | time_out | time_hist | stop | step | damping | damp_table | damp_ratio | results

Parameters

task task number
name task name
stage analysis stage
GSSPEC GsSpec solver
TIME_HISTORY solution
mode_task task containing modal results
excite_type type of excitation
BASE_EXCITE base acceleration excitation
LOAD_EXCITE dynamic load excitation
load load description (LOAD_EXCITE only)
accel the absolute value of maximum base acceleration (BASE_EXCITE only)
accel_x x component of direction cosine of base acceleration vector
accel_y y component of direction cosine of base acceleration vector
accel_z z component of direction cosine of base acceleration vector
history load curve reference for time history
time_out time interval for output
time_hist time interval for time-history output
stop stop time
step time step
0 auto
damping damping type
CONST constant damping for all modes
FREQ use a feequency damping table
MODE override a constant damping with mode specific values
MATERIAL use damping calculated from material
damp_table damping table reference
ref reference to frequency table (FREQ)
table table description (MODE)
0 unused (CONST, MATERIAL)
damp_ratio percentage of critical damping ratio, e.g. 3.0 represents 3.0%

TASK.1 | task | name | stage | GSSPEC | FOOTFALL | mode_task | excite_nodes | resp_nodes | damping | damp_table | damp_ratio | num_step | mass | low_freq | high_freq | fw_curve | resp_dir | walking | method | result | num_mode { | mode | steps }

Parameters

task task number
name task name
stage analysis stage
GSSPEC GsSpec solver
FOOTFALL solution
mode_task task containing modal results
excite_nodes excitation node list, if self-excitation is used, use "none"
resp_nodes response node list
damping damping type
CONST constant damping for all modes
FREQ use a feequency damping table
MODE override a constant damping with mode specific values
MATERIAL use damping calculated from material
damp_table damping table reference
ref reference to frequency table (FREQ)
table table description (MODE)
0 unused (CONST, MATERIAL)
damp_ratio percentage of critical damping ratio, e.g. 3.0 represents 3.0%
num_step if it is constant number of walking steps for all modes, this is an integer number of walking steps
ifit is variable walking steps for different modes, it is a table string in this format "(1,32) (2,16) (4, 8) ...(9,1):55"
Thestring before ':' define the table of mode and step relationship, the number after ':' is the default walking step if mode is not defined in the table
mass the mass of the walker
low_freq the lowest walking frequency to be considered
high_freq the highest walking frequency to be considered
fw_curve Frequency weighting curve to be used, -1 is standard Wb, -2 is standard Wd, -3 is standard Wg, 1, 2, 3 ... are used defined frequency weighting curve
resp_dir Direction of responses
RESP_Z Z (vertical) responses
RESP_X X (horizontal) responses
RESP_Y Y (horizontal) responses
RESP_XY horizontal responses
walking method to determine footfall loads
FLOOR_CCIP walking on floor (CCIP method)
FLOOR_SCI walking on floor (SCI method)
STAIR_ARUP walking on stair (Arup method)
STAIR_SCI walking on stair (SCI method)
FLOOR_AISC walking on floor (AISC SDGS11 method)
FLOOR_AISC_2ND walking on floor (AISC SDG11 method 2nd edition)
STAIR_AISC_2ND walking on stair (AISC SDG11 method 2nd edition)
RUN_FLOOR_AISC_2ND running on floor (AISC SDG11 method 2nd edition)
method excitation method
SELF_EXC self-excitation (excite the current response node only)
FULL_EXC full excitation (excite all nodes in the excitation node list)
FULL_OPT full optimisation (similar to FULL_EXC but with optimisation )

TASK.1 | task | name | stage | GSSPEC | PERIODIC | mode_task | dlf | load | low_freq | high_freq | freq_inc | damping | damp_table | damp_ratio | result

Parameters

task task number
name task name
stage analysis stage
GSSPEC GsSpec solver
PERIODIC solution
mode_task task containing modal results
dlf dynamic load factor record used in this task
load load description
low_freq lowest frequency
high_freq highest frequency
freq_inc increment of frequency
damping damping type
CONST constant damping for all modes
FREQ use a feequency damping table
MODE override a constant damping with mode specific values
MATERIAL use damping calculated from material
damp_table damping table reference
ref reference to frequency table (FREQ)
table table description (MODE)
0 unused (CONST, MATERIAL)
damp_ratio percentage of critical damping ratio, e.g. 3.0 represents 3.0%
result results (ref. result syntax)

TASK.2 | task | name | stage | GSRAFT | solver | solution | method | plate | max_iter | rel | rel_disp | and_or | abs | abs_disp | damping | K | mod | soil | PDisp | write | cycle | report | graphic | magnify | contour | result

Parameters

task task number
name task name
stage analysis stage
solver static solver (GSS)
solution see GSS and GSRELAX tasks
method solution method
SPARSE_DIRECT
PARALLEL_DIRECT
CONJGRADIENT
SKYLINE
plate plate formulation method
MINDLIN
MITC
max_iter maximum number of iterations
rel relative displacement limit
REL_YES | REL_NO
rel_disp relative displacement value
and_or combined option
AND | OR
abs absolute displacement limit
ABS_YES | ABS_NO
abs_disp absolute displacement value
damping damping value
K initial value of K
mod modify K
MODK_YES
MODK_NO
soil include (SOIL_YES) or ignore (SOIL_NO) soil horizontal displacements
SOIL_YES
SOIL_NO
PDisp PDisp solution
MINDLIN
BOUSSINESQ
write write Pdisp data
PDISP_YES
PDISP_NO
cycle cycles between Pdisp output
report generate report
REPORT_YES | REPORT_NO
graphic generate graphics
GRAPHIC_YES | GRAPHIC_NO
magnify magnification factor
contour display contours
CONTOUR_YES | CONTOUR_NO
result results (ref. result syntax)

TASK.2 | task | name | stage | GSBRIDGE | start_case | end_case | infl_anal | optimize | expand | static_anal | result

Parameters

task task number
name task name
stage analysis stage
solver solver
GSBRIDGE
start_case starting case
end_case last case
infl_anal do influence analysis
INFL_YES
INFL_NO
optimize optimize load
OPT_YES
OPT_NO
expand expand bridge loads
EXP_YES
EXP_NO
static_anal run static analysis
STATIC_YES
STATIC_NO
result results (ref. result syntax)

TASK.1 | task | name | stage | ENVELOPE | case_desc | worst | centre | num_ref | refs()

Parameters

task task number
name task name
stage analysis stage
solver solver
ENVELOPE
case_desc case description
worst worst cases
WORST_YES
WORST_NO
centre centre value
CENTRE_YES
CENTRE_NO
num_refs number of references
refs() references are written as integers that correspond to Data::DataRef items

TASK.1 | task | name | stage | DYNA | end | max_cycle | step | mass_scale | output_model | output_select | threads | memory | shell_4 | shell_3 | beam | k | excite | add_mass | mass_case | mass_dir | mass_factor | dampers | rayleigh |freq_1 | freq_2 | damp_1 | damp_2 | load_curve | excite_x | excite_y | excite_z | base | nodes | elements | assembly

Parameters

task task number
name task name
stage analysis stage
solver solver
DYNA
end termination time
max_cycle maximum num er of cycles
step time step
mass_scale mass scaling time step
output_model time interval for plot file
output_select time interval for time history file
threads number of threads
memory memory in GB
shell_4 shell formulation for quad elements
shell_3 shell formulation for tri elements
HUGHES_LIU
BELYTSCHKO_TSAY
BCIZ_TRI_SHELL
C0_TRI_SHELL triangle
SR_HUGHES_LIU triangle
SR_COROT_HUGHES_LIU
BELYTSCHKO_LEVIATHAN
BELYTSCHKO_TSAY_MEMB
BELYTSCHKO_WONG_CHANG
FAST_HUGHES_LIU
INTEGRATED_SHELL
beam beam formulation
HUGHES_LIU
BELYTSCHKO_SCHWER
CABLE
excite excitation
LOAD_EXCITE
BASE_EXCITE
add_mass mass derived from loads
ADD_MASS include mass from loads
NO_MASS no mass from loads
mass_case case definition for mass
mass_dir direction for mass
X
Y
Z
mass_factor scale factor for mass
discrete include discrete dampers
rayleigh include Rayleigh damping
freq_1 frequency 1 for Rayleigh damping
freq_2 frequency 2 for Rayleigh damping
damp_1 damping at frequency 1
damp_2 damping at frequency 1
load_curve load curve for load excitation
excite_x base excitation in x
excite_y base excitation in y
excite_z base excitation in z
base base node list
nodes time history node list
elements time history element list
assembly assembly list for cut sections

TASK | task | name | stage | solver | solution

Parameters

task task number
name task name
stage analysis stage
solver solver
GENERIC
NASTRAN
DYNA
OPENSEES

TASK | task | name | stage | EXT | solution | solver

Description

Analysis task definition

Parameters

task task number
name task name
stage analysis stage
EXT external solver
solution solution type
UNDEF no solution specified
STATIC
MODAL
BUCKLING
TIME_HIST
solver solver used to produce results

Index


TASK_INFO

TASK_INFO | task | exclude

TASK_INFO | task | mass_op | factor | mass_case | direction | scale | Kdamp | Mdamp | ignore_offset | buckling_op | exclude | mass_x | mass_y | mass_z

TASK_INFO | task | buckling_op | exclude

TASK_INFO | task | mass_op | factor | mass_case | direction | scale | ritz_x | ritz_y | ritz_z | Kdamp | Mdamp | ignore_offset | buckling_op | exclude

Description

Analysis task details definition

Parameters

task task number
mass_op mass option
DIAG use diagonal mass matrix
CONS use consistent mass matrix
NONE ignore masses other than mass elements
factor scale factor on mass
mass_case case description for additional mass
direction direction of force to convert to mass
scale scale factor
Kdamp stiffness damping factor
Mdamp mass damping factor
ignore_offsetignore offsets in element mass matrix
buckling_op buckling option (P-Δ; & buckling solution)
BEAM beam lateral torsional effects included
BAR beams treated as bars
PIN not used
NO_TOR suppress torsional destabilizing terms
NO_LAT_TOR suppress torsional and lateral-torsional destabilizing terms
exclude list of elements excluded from consideration Kg matrix
mass_x target mass ratio in x direction
mass_y target mass ratio in y direction
mass_z target mass ratio in z direction
ritz_x number of Ritz vector in x direction
ritz_y number of Ritz vector in y direction
ritz_z number of Ritz vector in z direction

Index


TASK_TAG

TASK_TAG | task | tag

Description

Task is tagged (enabled)

Parameters

task task number
tags task enabled
YES
NO

Index


TIED

TIED.3 | name | type | constrained_entities | primary_elements | link | tol | stage

TIED.2 | name | type | constrained_entities | primary_elements | tol | stage

TIED.1 | type | constrained_entities | primary_node | tol | stage

Description

Tied interface definition

Parameters

name tied interface name
type constrained list type
NODE node list
ELEMENT element list
constrained_entities list of constrained entities
primary_elements list of primary elements
link link type
AUTO determined from constrained type
TIED tied interface (element to element)
RIGID rigid connection (node to element) based on 'constrained' node
tol tolerance for nodes to be tied
stage list of stages in which constraint is active

Index


TIME

TIME | case | time

Description

Time for result set

Parameters

case analysis case
time time

Index


TITLE

TITLE | title | sub-title | calc | job_no | initials

Description

Title

Parameters

title job title
sub-title job subtitle
calc calculation header
job_no job number
initials initials

Index


TOL

TOL | vertical | node | grid_edge | grid_angle | spacer_leg | memb_angle | memb_edge | refinement | elem_plane | member_curve

Description

Tolerance specification

Parameters

vertical vertical element tolerance [tan(angle)]
node node coincidence tolerance
grid_edge grid loading edge tolerance [m]
grid_angle grid edge straightness tolerance [deg.]
spacer_leg bar spacer leg length tolerance for form-finding [m]
memb_angle max. difference of element orientation angle for members [deg.]
memb_edge max. distance from centre line for members [m]
refinement grid loading refinement tolerance, in range 0 to 4
elem_plane planar element tolerance [tan(angle)]
member_curveelement offset from the curved member

Index


TOTAL_BASE_SHEAR

TOTAL_BASE_SHEAR | case | option | value

Description

Total base shear in response spectrum analysis

Parameters

case analysis case
option value type
DYNAMIC dynamic calculation
DISP displacement based value (UBC)
FORCE force based value (UBC)
REACT reaction calculation
value base shear value [N]
three values for CQC3 combination

Index


TOTAL_FORCE

TOTAL_FORCE | case | option | x | y | z

Description

Total force

Parameters

node node number
case analysis case
option total force option
APP_DISP applied displacements
NODE nodes
ELEM_1D 1D elements
ELEM_2D 2D elements
ELEM_3D 3D elements
GRAV gravity
INERTIA inertia (dynamic response)
REACT reactions
SUPPORT spring supports
SPRING grounded springs
SOIL soil
IGNORED ignored loading
WEIGHT weight
x,y,z forces [N]

Index


TOTAL_MOMENT

TOTAL_MOMENT | case | option | value

Description

Total moment

Parameters

node node number
case analysis case
option total moment option
APP_DISP applied displacements
NODE nodes
ELEM_1D 1D elements
ELEM_2D 2D elements
ELEM_3D 3D elements
GRAV gravity
INERTIA inertia (dynamic response)
REACT reactions
SUPPORT spring supports
SPRING grounded springs
SOIL soil
IGNORED ignored loading
WEIGHT weight
x,y,z moments [N.m]

Index


UBC_METHOD

UBC_METHOD | case | option

Description

UBC method in response spectrum analysis

Parameters

case analysis case
option UBC method
A | B

Index


UNIT_DATA

UNIT_DATA | option | name | factor

Description

Unit descriptions

Parameters

option unit type
FORCE N, kN, MN, lbf, kip, tf
LENGTH long lengths - m, cm, mm, ft, in
DISP small length - as LENGTH
SECTION section properties - as LENGTH
MASS kg, t, kt, g, lb, Ton, slug, kip.s2/in, kip.s2/ft, lbf.s2/in, lbf.s2/ft, kip
TIME s, ms, min, h d
TEMP °C (C), K °F (F)
STRESS stress and pressure - Pa, kPa, MPa, GPa, N/m2, N/mm2, kip/in2, psi, psf, ksi
ACCEL ground accelerations - m/s2, cm/s2, mm/s2, ft/s2, in/s2, g, %g, milli-g, Gal
ENERGY energy - J, kJ, MJ, GJ, kWh, in.lbf, ft.lbf, ca., Btu
STRAIN strain - ' ', %, m, micro
name name
factor factor by which a value is multiplied to convert it from SI to the specified unit

Note

The factor is only required if the name is not one recognised by the program. UNIT_DATA records can be introduced anywhere in the input; units will be adjusted as they are encountered. All length related values in text file records use the LENGTH option

Index


UNIT_DATA

UNIT_DATA.1 | option | name | factor

Description

Unit descriptions

Parameters

option unit type
FORCE N, kN, MN, lbf, kip, tf
LENGTH long lengths - m, cm, mm, ft, in
DISP small length - as LENGTH
SECTION section properties - as LENGTH
MASS kg, t, kt, g, lb, Ton, slug, kip.s2/in, kip.s2/ft, lbf.s2/in, lbf.s2/ft, kip
TIME s, ms, min, h d
TEMP °C (C), K °F (F)
STRESS stress and pressure - Pa, kPa, MPa, GPa, N/m2, N/mm2, kip/in2, psi, psf, ksi
ACCEL ground accelerations - m/s2, cm/s2, mm/s2, ft/s2, in/s2, g, %g, milli-g, Gal
ENERGY energy - J, kJ, MJ, GJ, kWh, in.lbf, ft.lbf, ca., Btu
name name
factor factor by which a value is multiplied to convert it from SI to the specified unit

Note

The factor is only required if the name is not one recognised by GSA. UNIT_DATA records can be introduced anywhere in the input; units will be adjusted as they are encountered. All length related values in GWA records use the LENGTH option

Index


UNRES_MASS

UNRES_MASS | case | x | y | z

Description

Structure unrestrained mass

*** DEPRECATED ***

Parameters

case analysis case
x,y,z unrestrained mass in the global directions [kg]

Index


USER_MOD_ELEM

USER_MOD_ELEM.2 | module | elem | pos | value

USER_MOD_ELEM.1 | module | elem | pos_1 | value

Description

Element user module data

Parameters

module module number
0 highest element user module
-1 highest element user module -1
-2 highest element user module -2 etc
elem element number
pos position on element
if 1D position along element in millionths of element length; e.g. pos 0 is end 1; pos 1000000 is end 2
else position on element; e.g. pos 0 is the first node in the topology list
CENTRE or -1 element centre (2D element only)
pos_1 position on element
if (pos < num_topo) position on element; e.g. pos 0 is end 1
if (pos ≥ num_topo) DISCARDED (was: intermediate position: pos+1-num_topo (1D element only))
CENTRE or -1 element centre (2D element only)
value value at pos

Index


USER_MOD_ELEM_TITLE

USER_MOD_ELEM_TITLE.2 | module | name | colour | axis | dir | dimension | blob | is_centre

USER_MOD_ELEM_TITLE.1 | module | name | dimension | blob | is_centre

Description

Element user module title

Parameters

module module number
0 highest element user module +1
name module name
colour colour (ref. colour syntax)
axis axis
LOCAL
GLOBAL
# axis number
dir diagram direction
X | Y | Z | NONE specify NONE for in-picture-plane on 1D elements
dimension units for module (ref. dimension syntax)
blob contour type
BLOB blob at data points
BLOB_SHIFT blob shifted from data points
CONT continuous contours
is_centre user module is configured for centre values only on 2D elements, or not
CENTRE_ONLY_2D | NOT_CENTRE_ONLY_2D

Index


USER_MOD_MEMBER

USER_MOD_MEMBER.2 | module | member | pos | value

USER_MOD_MEMBER.1 | module | member | pos_1 | value

Description

Member user module data

Parameters

module module number
0 highest member user module
-1 highest member user module -1
-2 highest member user module -2 etc
member member number
pos position on member
pos_1 position on member
if 1D position along element in millionths of member length; e.g. pos 0 is end 1; pos 1000000 is end 2
else pos is topology-1; e.g. pos 0 is end 1
if (pos < num_topo) topology: pos+1; e.g. pos 0 is end 1
if (pos ≥ num_topo) DISCARDED (was: intermediate position: pos+1-num_topo)
value value at pos

Index


USER_MOD_MEMBER_TITLE

USER_MOD_MEMBER_TITLE.2 | module | name | colour | axis | dir | dimension | blob

USER_MOD_MEMBER_TITLE.1 | module | name | dimension | blob

Description

Member user module title

Parameters

module module number
0 highest member user module +1
name module name
colour colour (ref. colour syntax)
axis axis
LOCAL
GLOBAL
# axis number
dir diagram direction
X | Y | Z | NONE specify NONE for in-picture-plane
dimension units for module
blob contour type
BLOB blob at data points
BLOB_SHIFT blob shifted from data points
CONT continuous contours

Note

See USER_MOD_ELEM_TITLE for details of unit types.

Index


USER_MOD_NODE

USER_MOD_NODE | module | node | value

Description

Node user module data

Parameters

module module number
0 highest node user module
-1 highest node user module -1
-2 highest node user module -2 etc
node node number
value nodal value

Index


USER_MOD_NODE_TITLE

USER_MOD_NODE_TITLE.2 | module | name | colour | axis | dir | dimension

USER_MOD_NODE_TITLE.1 | module | name | dimension

Description

Node user module title

Parameters

module module number
0 highest node user module +1
name module name
colour colour (ref. colour syntax)
axis axis
LOCAL
GLOBAL
# axis number
dir diagram direction
X | Y | Z
dimension units for module

Note

See USER_MOD_ELEM_TITLE for details of unit types.

Index


USER_VEHICLE

USER_VEHICLE | no | name | width | num_axle | { axle | offset | load_left | load_right }

Description

User vehicle definition

Parameters

num record number
name name
width vehicle width [m]
num_axle number of load points
{{
axle_pos axle position [m]
axle_offset offset from centre-line [m]
axle_left load on left side [N]
axle_right load on right side [N]
}}

Index


VARIABLE_LOAD

VARIABLE_LOAD.2 | num | name | option | type | unit | num_seg | { seg_a | seg_n | seg_tran } | kel_type | const_kel

Description

Variable load definition

Parameters

num record number
name name
option curved or straight line
UKHK UK/Hong Kong code load
EC1UK Eurocode 1 (UK) loading
AASHTO AASHTO loading
CS454ALL2 CS454 ALL2 loading
LINEAR Linear loading
type force per length or force per area
LINE
AREA
trans transition point unit
LENGTH
AREA
num_seg number of segments
{{
seg_a segment force [N/m]
seg_n segment index
seg_tran segment transition [m] - no transition point for last segment
e.g. 2 segments, the data are 'seg_a(1), seg_n(1), seg_tran(1), seg_a(2), seg_n(2)'
}}
kel_type constant KEL or KEL to CS454
CONSTANT constant value as specified by const_kel
CS454 CS454 KEL definition
const_kel kel force [N]

Index


VEL

VEL | node | case | x | y | z

Description

Nodal velocity

Parameters

node node number
case analysis case
x,y,z velocities [m/s]

Index


VIEW_LIST

VIEW_LIST (not published)

Index


VIRTUAL_ENERGY

VIRTUAL_ENERGY | elem | case | energy

Description

Element virtual energy (stability analysis)

Parameters

elem element number
case analysis case
energy element virtual energy [N.m]

Index


colour_syntax

colour_syntax

Description

syntax for colour fields

Parameters

<null> colour undefined
NO_RGB colour undefined
<colour_string>one of
BLACK
MAROON
DARK_RED
RED
ORANGE_RED
DARK_GREEN
GREEN
OLIVE
DARK_ORANGE
ORANGE
GOLD
LAWN_GREEN
LIME
CHARTREUSE
YELLOW
DARK_GOLDENROD
SADDLE_BROWN
CHOCOLATE
GOLDENROD
FIREBRICK
FOREST_GREEN
OLIVE_DRAB
BROWN
SIENNA
DARK_OLIVE_GREEN
GREEN_YELLOW
LIMEGREEN
YELLOW_GREEN
CRIMSON
PERU
TOMATO
DARK_SLATE_GREY
CORAL
SEA_GREEN
INDIAN_RED
SANDY_BROWN
DIM_GREY
DARK_KHAKI
MIDNIGHT_BLUE
MEDIUM_SEA_GREEN
SALMON
DARK_SALMON
LIGHT_SALMON
SPRING_GREEN
NAVY
PURPLE
TEAL
GREY
LIGHT_CORAL
INDIGO
MEDIUM_VIOLET_RED
BURLYWOOD
DARK_BLUE
DARK_MAGENTA
DARK_SLATE_BLUE
DARK_CYAN
TAN
KHAKI
ROSY_BROWN
DARK_SEA_GREEN
SLATE_GREY
LIGHT_GREEN
DEEP_PINK
PALE_VIOLET_RED
PALE_GREEN
LIGHT_SLATE_GREY
MEDIUM_SPRING_GREEN
CADET_BLUE
DARK_GREY
LIGHT_SEA_GREEN
MEDIUM_AQUAMARINE
PALE_GOLDENROD
NAVAJO_WHITE
WHEAT
HOT_PINK
STEEL_BLUE
MOCCASIN
PEACH_PUFF
SILVER
LIGHT_PINK
BISQUE
PINK
DARK_ORCHID
MEDIUM_TURQUOISE
MEDIUM_BLUE
SLATE_BLUE
BLANCHED_ALMOND
LEMON_CHIFFON
TURQUOISE
DARK_TURQUOISE
LIGHT_GOLDENROD_YELLOW
DARK_VIOLET
MEDIUM_ORCHID
LIGHT_GREY
AQUAMARINE
PAPAYA_WHIP
ORCHID
ANTIQUE_WHITE
THISTLE
MEDIUM_PURPLE
GAINSBORO
BEIGE
CORNSILK
PLUM
LIGHT_STEEL_BLUE
LIGHT_YELLOW
ROYAL_BLUE
MISTY_ROSE
BLUE_VIOLET
LIGHT_BLUE
POWDERBLUE
LINEN
OLDLACE
SKYBLUE
CORNFLOWER_BLUE
MEDIUM_SLATE_BLUE
VIOLET
PALE_TURQUOISE
SEASHELL
FLORAL_WHITE
HONEYDEW
IVORY
LAVENDER_BLUSH
WHITE_SMOKE
LIGHT_SKY_BLUE
LAVENDER
SNOW
MINT_CREAM
BLUE
MAGENTA
DODGER_BLUE
DEEP_SKY_BLUE
ALICE_BLUE
GHOST_WHITE
CYAN
LIGHT_CYAN
AZURE
WHITE
RGB(<colorref>)red, green, blue values (0 to 0xFFFFFF), where
0x0000FF red
0x00FF00 green
0xFF0000 blue
Note: order is BBGGRR
RGB(<r>,,)red, green, blue values (0 to 255)
i integer representation of colour (legacy)

Index


dimension_syntax

dimension_syntax

Description

syntax for dimension fields

Parameters

<null> dimension undefined
NULL dimension undefined
<dimension_string>one of
<i>base units
FORCE N
LENGTH m
MASS kg
DISP m (not used in gwa format)
PROP_LEN m (not used in gwa format)
TIME s
TEMPERATURE °C
PRESSURE Pa
GRD_ACCEL m/s2
ENERGY J
VEL m/s
ANGLE rad (radian)
STRAIN ε (micro-strain)
<i>derived units
WORK J
MOMENT Nm
STRESS N/m2
FORCE_PER_LENGTH N/m
MOMENT_PER_LENGTH Nm/m
MOMENT_PER_ROTATION Nm/rad
EI N/m2
WARP_CONST m6
AREA m2
1ST_MOMENT_AREA m3
2ND_MOMENT_AREA m4
VOLUME m3
PER_LENGTH 1/m
PER_AREA 1/m2
PER_VOLUME 1/m3
CS_AREA m2
CS_AREA_PER_LENGTH m2/m
CURVATURE 1/m
INERTIA kgm2
DENSITY kg/m3
AREA_DENSITY kg/m2
WEIGHT_DENSITY N/m3
MASS_PER_LENGTH kg/m
PER_MASS 1/kg
ANGULAR_VELOCITY rad/s
ANGULAR_ACCELERATION rad/s2
FLOW_RATE m3/s
FREQUENCY Hz
ANGULAR_FREQUENCY rad/s
PERIOD s
THERMAL_EXPANSION 1/°C
TEMPERATURE_GRADIENT °C/m
IMPULSE Ns
IMPULSE_PER_AREA Ns/m2
IMPULSE_PER_LENGTH Ns/m
MOMENTUM kgm/s
ANGULAR_MOMENTUM kgm2/s
I_PER_LENGTH m4/m
VOLUME_PER_AREA m3/m2
DAMPING Ns/m
ENERGY_DENSITY J/m3
ENERGY_PER_LENGTH J/m
COMPLIANCE m2/N
DEGREE °
PERCENT %

Index


result_syntax

result_syntax

Description

syntax for results selection

Parameters

result results to be stored - a string where the letters have the following meaning
- no results
D displacements
V velocities
A accelerations
R reactions
C constraints
M mass
E element displacements
F forces and moments
N 2D element forces N & Q and moments M
S 2D element stresses
B 3D element stresses
U strain energy
T total loads and total reactions
* values at centre only for 2D/3D results

Index


Index

ACC
ADD
ALIGN
ANAL
ANAL_STAGE
ANAL_STAGE_MAT
ANAL_STAGE_PROP
AREA
ASSEMBLY
AXIAL_FORCE_DISP
AXIS
BASE_REACT
BASE_SHEAR
BASE_SHEAR_EQN
BASIC_BRIDGE_LOAD
BLANK
BLOCK
BRIDGE_LOAD
BRIDGE_OPTI_SUM_EC1
BRIDGE_OPTI_SUM_UKHK
BRIDGE_OPTI_SUM_US
CARRIAGEWAY_PATH
CASES_IN_RESP
CASE_DESC
CENTRE_MASS
COMBINATION
CONDITION
CONS_EQN
CONS_FORCE
CONS_MOMENT
CURRENCY
CUSTOM_OP_VIEW
DAMPER_FORCE
DAMPER_MOMENT
DAMP_IN_RESP
DELETE
DESIGN
DESIGN_STEEL_REST_PROP
DESIGN_TASK
DISP
DISP_ELEM
DISP_NODE
DLF_CURVE
EFF_MASS
EL
ENV_PARAM
ENV_RES_ELEM
ENV_RES_NODE
ERROR_NORM
ETA_IN_RESP
EXIST
EXPLICIT_HOURGLASS_ENERGY
EXPLICIT_KINETIC_ENERGY
EXPLICIT_STRAIN_ENERGY
EXPLICIT_TIME
FOOTFALL
FORCE
FORCE_1D
FORCE_2D
FORCE_DENSITY_1D
FORCE_DENSITY_2D
FREQ
FREQ_DAMPING
FREQ_IN_RESP
FREQ_WT_CURVE
FRONT
GEN_REST
GET
GET_ALL
GRID_LAYOUT
GRID_LINE
GRID_PLANE
GRID_SURFACE
GRID_TOL
GR_VIEW
GSS_PARAM
HIGHEST
INERTIA
INERTIA_ACT
INERTIA_NODE
INF_BEAM
INF_BEAM_RES
INF_NODE
INF_NODE_RES
INF_POS
JOINT
LINE
LIST
LOAD_1D_THERMAL
LOAD_2D_EDGE
LOAD_2D_FACE
LOAD_2D_PRE
LOAD_2D_STRN
LOAD_2D_TENDON
LOAD_2D_THERMAL
LOAD_3D_FACE
LOAD_3D_THERMAL
LOAD_BEAM
LOAD_BEAM_DIST
LOAD_BEAM_LENG
LOAD_BEAM_LINE
LOAD_BEAM_PATCH
LOAD_BEAM_POINT
LOAD_BEAM_POLY
LOAD_BEAM_PRE
LOAD_BEAM_STRN
LOAD_BEAM_TEN
LOAD_BEAM_TRILIN
LOAD_BEAM_UDL
LOAD_CURVE
LOAD_FAC
LOAD_FACTOR_DISP
LOAD_GRAV
LOAD_GRAVITY
LOAD_GRID_AREA
LOAD_GRID_LINE
LOAD_GRID_POINT
LOAD_NODE
LOAD_TITLE
LOCATION
LOCKED
LOCKED
MASS
MASS_ACT
MASS_IN_RESP
MASS_NODE
MAT
MATRIX
MAT_ALUMINIUM
MAT_ANAL
MAT_ANAL
MAT_ANAL
MAT_ANAL
MAT_ANAL
MAT_ANAL
MAT_ANAL
MAT_CONCRETE
MAT_CURVE
MAT_CURVE_PARAM
MAT_FABRIC
MAT_FRP
MAT_GLASS
MAT_ISO
MAT_REBAR
MAT_STEEL
MAT_TIMBER
MEMB
MODAL_DAMP
MODAL_GEO_STIFF
MODAL_MASS
MODAL_STIFF
MODE
MODE_DAMPING
MODE_IN_RESP
MODE_MULT
MODE_PROB
MOMENT
MOMENT_1D
MOMENT_2D
MV_BRIDGE_LOAD
NL_SPRING_CURVE
NODE
OP_VIEW
PART_FAC
PATH
PATH_LOAD
PATH_LOAD_AUTO
PERIOD
PILE_INTERACTION
POLYLINE
POLYLINE_2D
PROP_2D
PROP_3D
PROP_CABLE
PROP_DAMP
PROP_LINK
PROP_MASS
PROP_SEC
PROP_SPACER
PROP_SPR
RAFT_INTERACTION
RC2D_PROP
REACT_FORCE
REACT_MOMENT
REGION
RESID_DISP
RESID_FORCE
RESID_MOMENT
RESP_FORCE
RESP_MOMENT
RESP_ORIGIN
RESP_SCALE
RIGID
ROTN
ROTN_ELEM
ROT_ACC
ROT_VEL
SECTION
SECTION_COMP
SECTION_CONC
SECTION_HOLE
SECTION_MARKUP
SECTION_MOD
SECTION_SMEAR
SECTION_STEEL
SETTLE
SET_AT
SHEAR_2D
SID
SOAP_STRESS_1D
SOAP_STRESS_2D
SOIL_CURVE
SOIL_PROFILE
SOIL_PSI_CURVE
SOIL_PSI_PROP
SOIL_RECT_LOAD
SOIL_ZONE
SPACER_TOL
SPEC
SPECTRUM
SPECTRUM
SPECTRUM
SPECTRUM
SPECTRUM
SPECTRUM
SPECTRUM
SPECTRUM
SPECTRUM
SPECTRUM
SPEC_ACC
SPEC_BRIDGE
SPEC_BRIDGE_NDP
SPEC_CONC_DESIGN
SPEC_DESIGN
SPEC_LOAD_DESIGN
SPEC_RAFT
SPEC_STEEL_DESIGN
SPRING_FORCE
SPRING_MOMENT
SPR_MATRIX
STEEL_BEAM_DES
STEEL_POOL
STOREY_ACTIVE_INERTIA
STOREY_ACTIVE_MASS
STOREY_CENTRE_MASS
STOREY_ELEV
STOREY_INERTIA
STOREY_MASS
STRAIN_ENERGY
STRESS_2D
STRESS_3D
ST_BRIDGE_LOAD
TASK
TASK_INFO
TASK_TAG
TIED
TIME
TITLE
TOL
TOTAL_BASE_SHEAR
TOTAL_FORCE
TOTAL_MOMENT
UBC_METHOD
UNIT_DATA
UNIT_DATA
UNRES_MASS
USER_MOD_ELEM
USER_MOD_ELEM_TITLE
USER_MOD_MEMBER
USER_MOD_MEMBER_TITLE
USER_MOD_NODE
USER_MOD_NODE_TITLE
USER_VEHICLE
VARIABLE_LOAD
VEL
VIEW_LIST
VIRTUAL_ENERGY
colour_syntax
dimension_syntax
result_syntax


17 Sep 2024 at 13:29
© Oasys Ltd 2024