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:

.gwa - default text file
.txt - tab separated text file
.csv - comma separated (or locale specific list separated) 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

Keyword	Change
LOAD_GRAVITY	Loaded 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_VIEW	Integer 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

Description

Alignment definition

Parameters

num

record number

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

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.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

Description

area definition

Parameters

ref

number

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

Description

Assembly definition

Parameters

num

record number

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

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

Description

Basic bridge load definition

Parameters

num

record number

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

Description

Blocks

Parameters

num	block number
name	name
colour	colour (ref. colour syntax)
member_list	member 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

*** DEPRECATED ***

Index

BRIDGE_OPTI_SUM_EC1

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

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

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

Description

Carriageway path

Parameters

num

record number

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

Description

Combination case title definition

Parameters

case

combination case

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.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

*** DEPRECATED ***

Index

DESIGN_STEEL_REST_PROP

Description

Steel design restraint property

*** DEPRECATED ***

Parameters

num

record number

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

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

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

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

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_angle

orientation 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)

{

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

{

offset x

offset y

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

Description

Environmental parameters

Parameters

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 CO₂e - product stage

CO2e_B

embodied CO₂e (not used)

CO2e_C

embodied CO₂e - end of life stage

CO2e_D

embodied CO₂e - beyond building life

eCO2

embodied CO₂

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

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_factor	transient 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

Description

Grid layout definition

Parameters

num

record number

name

explicit

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

Description

Grid line definition

Parameters

num

record number

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

Description

Grid plane definition

Parameters

num

record number

name

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

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

Description

Grid surface definition

Parameters

num

record number

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

Description

GSS solver parameters

Parameters

task

task number

solver

solver method (unused)

preconditioner

conjugate 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

Description

Beam influence definition

Parameters

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

Description

Beam influence results

Parameters

case	analysis case
num_infl	number of influence lines
num_zone	number of zones
(	(
num_zone_pos	number of positions
(	(
zone_pos_value	values
)	)
)	)

Index

INF_NODE

Description

Node influence definition

Parameters

name

action

action number

node

factor

multiplier

type

influence type

FORCE | DISP

axis

influence axis

dir

influence direction

X | Y | Z | XX | YY | ZZ

Index

INF_NODE_RES

Description

Node influence results

Parameters

case	analysis case
num_infl	number of influence lines
num_zone	number of zones
(	(
num_zone_pos	number of positions
(	(
zone_pos_value	values
)	)
)	)

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

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_MESHTOOLS

CM2 MeshTools mesh generator attributes

step_definition

meshgen: 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_start

MeshTools: length of the element at the start of the line (if step size specified)

elem_len_end

MeshTools: 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

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.1 | element list | case | type | value

Description

Beam thermal load definition

Parameters

name

name of the load

entity

type entity type

ELEMENT

entity

list list of loaded entities

element

list 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

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

Description

2D element face load definition

Parameters

name

name of the load

entity

type 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.1 | element list | case | dir | value

Description

2D element prestress load definition

Parameters

name

name of the load

entity

type 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.1 | element list | case | dir | value

Description

2D element initial strain load definition

Parameters

name

name of the load

entity

type 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

Description

2D element prestress load definition

Parameters

name

name of the load

entity

type 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.1 | element list | case | type | values(n)

Description

2D element thermal load definition

Parameters

name

name of the load

entity

type 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

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

Description

3D element thermal load definition

Parameters

name

name of the load

entity

type 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

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

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.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

entity

type entity type

MEMBER
ELEMENT

entity

list list of loaded entities

element

list list of elements

case

load case number

value

change in length [m]

Index

LOAD_BEAM_LINE

Description

1D entity linear load definition

Parameters

name

name of the load

entity

type entity type

MEMBER
ELEMENT

entity

list list of loaded entities

element

list 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

Description

1D entity patch load definition

Parameters

name

name of the load

entity

type entity type

MEMBER
ELEMENT

entity

list list of loaded entities

element

list 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

Description

1D entity point load definition

Parameters

name

name of the load

entity

type entity type

MEMBER
ELEMENT

entity

list list of loaded entities

element

list 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

*** DEPRECATED ***

Index

LOAD_BEAM_PRE

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

entity

type entity type

MEMBER
ELEMENT

entity

list list of loaded entities

element

list list of elements

case

load case number

value

load value [N]

Index

LOAD_BEAM_STRN

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

entity

type entity type

MEMBER
ELEMENT

entity

list list of loaded entities

element

list list of elements

case

load case number

value

strain value [-]

Index

LOAD_BEAM_TEN

Description

Beam tendon prestress load definition

Parameters

name

name of the load

entity

type entity type

MEMBER
ELEMENT

entity

list list of loaded entities

element

list list of elements

case

load case number

value

load value [N]

y,z

load position in section [m]

Index

LOAD_BEAM_TRILIN

Description

1D entity tri-linear load definition

Parameters

name

name of the load

entity

type entity type

MEMBER
ELEMENT

entity

list list of loaded entities

element

list 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

Description

1D entity uniform load definition

Parameters

name

name of the load

entity

type entity type

MEMBER
ELEMENT

entity

list list of loaded entities

element

list 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

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.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

entity

type entity type

MEMBER
ELEMENT

entity

list list of loaded entities

element

list list of elements

nodelist

list of nodes

case

load case number

x gravitational acceleration

y gravitational acceleration

z gravitational acceleration

Note

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

Index

LOAD_GRID_AREA

Description

Grid area load definition

Parameters

name

name of the load

grid_surface

grid 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

Description

Grid line load definition

Parameters

name

name of the load

grid_surface

grid 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

Description

Grid point load definition

Parameters

name

name of the load

grid_surface

grid 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

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.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

LOCATION

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

mod

modified from standard

TRUE
FALSE

elastic modulus

strength

Poisson's ratio

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

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

colour

colour (ref. colour syntax)

Young's modulus [N/m²]

Poisson's ratio

rho

density [kg/m³]

alpha

coefficient of thermal expansion [/°C]

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

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

colour

colour (ref. colour syntax)

Young's modulus in x [N/m]

Young's modulus in y [N/m]

Poisson's ratio in xy

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_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

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

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

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_c

plastic 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

Description

Material models

Parameters

num

material model number (if not embedded)

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

Description

Isotropic-elastic material (with yield) definition

Parameters

num

record number

name

desc

material description

MT_STEEL
MT_CONCRETE
MT_ALUMINIUM
MT_GLASS
MT_WOOD

Young's modulus [N/m²]

Poisson's ratio

shear modulus [N/m²]

rho

density [kg/m³]

alpha

coefficient of thermal expansion [/°C]

yield

yield stress [N/m²]

ultimate

ultimate stress [N/m²]

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

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 CO₂ 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 CO₂ 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

yield strength

ultimate tensile strength

hardening modulus

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_t

eta_c

bond coefficient for anchorage (EC2)

eta_t

bond coefficient for cracking (EC2)

prestress bond factor (EC2)

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.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.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.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

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_intersector

meshing 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_type

analysis 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)

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_1, k_2 stiffness - one value for each K above

restraint_end_1

restraint (for effective length calculation) at end 1

restraint_end_2

restraint 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

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_internal

automatic 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_factor

is 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

Description

Moving bridge load definition

Parameters

num

record number

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

tran

translation or rotation

TRAN	translational
ROT	rotational

table

table of points [m]

Index

NODE

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

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

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_rigidity

MESH: column rigidity will be generated

YES | NO

column_prop

MESH: column property number

column_node

MESH: column orientation node

column_angle

MESH: column orientation angle

column_factor

MESH: column dimension factor

column_slab_factor

MESH: column slab thickness factor

}

Index

OP_VIEW

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

elements

elements see lists

members

members see lists

assemblies

assemblies see lists

num_op

number of output tables

(

data

data reference

axis

)

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_worst

number of worst values

num_disp

number of intermediate displacement points

num_force

number 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)

name

name 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_place

number 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

Description

Path definition

Parameters

num

record number

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_lanes

number of marked lanes

Index

PATH_LOAD

Description

Path loading definition

Parameters

num

record number

path

path number

type

load type

variable_load

record 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_fac2

second vehicle factor

exclusion2

second vehicle exclusion length [m]

Index

PATH_LOAD_AUTO

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_load

record 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

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

elevation of interaction [m]

vert

vertical interaction only

VERT	vertical only
FULL	full interaction

Index

POLYLINE

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

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.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.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.2 | num | name | colour | axis | mat | type | thick | mass | bending | inplane | weight | is_env { | energy | CO2A | CO2B | CO2C | CO2D | recycle | user }

Description

2D element property definition

Parameters

num

record number

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

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

}

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)
	*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

Description

3D property definition

Parameters

num

record number

name

colour

colour (ref. colour syntax)

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 }

Description

Cable property definition

Parameters

num

record number

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

}

Index

PROP_DAMP

Description

Damper property definition

Parameters

num

record number

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

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

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.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

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

I11

Iyy

I22

Izz

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

Description

Spacer property definition

Parameters

num

record number

name

colour

colour (ref. colour syntax)

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

Description

Spring property definition

Parameters

num

record number

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

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

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

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

the concrete grade name (standard) or the concrete strength (user defined)

rebar_op

rebar grade option

STANDARD	standard
USER	user defined

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

Description

region definition

Parameters

ref

number

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_density

meshgen: 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.1 | primary_node | type | constrained_nodes | stage

Description

Rigid constraint definition

Parameters

name

tigid constraint name

primary_node

primary 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_member

The 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.3 | ref | name | memb:EXPLICIT | mod | mat

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

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

section torsion constant|

y shear area factor

z shear area factor

vol

volume per unit length

mass

additional (non-structural) mass per unit length

fraction

additional mass fraction (modifies rho.volume)

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

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_y

y offset of component in section

offset_z

z 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

taperType

tapered section type

NONE	no taper
SIMPLE	Simple
HOR_TAPER	Horizontal/taper
LINEAR	Linear taper
HAUNCH	Haunched taper
FISH_BELLY	Fish belly

taperPos

position 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

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

y coordinate of start

z coordinate of start

y coordinate of end (0 if unused)

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

mod

modifications apply to

GEOMETRY	geometry
STIFF	stiffness

centroid

use 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 factor

opKy

ky modification option

ky factor

opKz

kz modification option

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

Description

Section component steel definition

Parameters

ref

record.component number

grade

material grade

plasElas

max plastic : elastic ratio

netGross

net : 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.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.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

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

Description

Soil rectangular loads definition - loads directly on soil

Parameters

num

record number

orient

orientation of loaded plane

HORIZ	horizontal
VERT	vertical

x coordinate of centre of loading area [m]

y coordinate of centre of loading area [m]

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

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

soil

soil type

A | B | C | D | E

probability factor

hazard design factor

structural ductility

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

Description

ASCE7 response spectrum definition

Parameters

num

spectrum number

name

soil

soil type

A | B | C | D | E

short period response

1s response

long period transition

R factor

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

soil

soil type

A \| B \| C	EC8 1994
A \| B \| C \| D \| E	EC8 2003, 2004

type

spectrumm type

AgR

ground accelerations

importance

spectral damping

q factor

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

Description

FEMA 356 response spectrum definition

Parameters

num

spectrum number

name

soil

soil type

A | B | C | D | E

short period response

1s response

beta

beta damping factor

construction type

STEEL | CONC | EBF | WOOD | OTHER

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

Description

GB50011 response spectrum definition

Parameters

num

spectrum number

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

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

soil

soil type

A | B | C | D | E

Ss,S1

short period and 1s response

long period transition

R factor

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

zone

seismic zone

II | III | IV | V

soil

soil type

I | II | III

IS 1893

importance

R factor

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

Description

Italian response spectrum definition

Parameters

num

spectrum number

name

zone

seismic zone

1 | 2 | 3 | 4

soil

soil type

A | B | C | D | E

damping

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

Description

UBC response spectrum definition

Parameters

num

spectrum number

name

UBCzone

UBC zone

1 | 2A | 2B | 3 | 4

soil

soil type

S1 \| S2 \| S3	UBC 94
SA \| SB \| SC \| SD \| SE	UBC 97

importance factor

R,Rw

R,Rw factor

period

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

Description

User defined response spectrum definition

Parameters

num

spectrum number

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_EC1_UK | LC1 | LC3 | LC4 | LC1_veh | num_infl

SPEC_BRIDGE | CODE_EC1_LM1 | LC1 | LC3 | LC4 | LC1_veh | 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

Walkway loading

AUS_WALKLOAD_NONE
AUS_WALKLOAD_VARIABLE
AUS_WALKLOAD_CONSTANT

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_factor

SM1600 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_loading

path 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

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

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

design strength (if grade is USER_DEFINED)

tensile strength ( ditto )

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

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

Description

Static bridge load definition

Parameters

num

record number

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

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

num

iter 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_case

P-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

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_filter

effective mass ratio for filtering modes

max_cycle

maximum number of cycles for iterative solutions

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_cycle

number 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

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)

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

lower transition frequency

upper transition frequency

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_spectrum

the 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

effective mass in x

effective mass in y

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

lower transition frequency

upper transition frequency

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)

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

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

it is variable walking steps for different modes, it is a table string in this format "(1,32) (2,16) (4, 8) ...(9,1):55"

The

string 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 )

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)

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

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)

Parameters

task

task number

name

task name

stage

analysis stage

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)

Parameters

task

task number

name

task name

stage

analysis stage

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

Parameters

task

task number

name

task name

stage

analysis stage

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

Parameters

task

task number

name

task name

stage

analysis stage

solver

GENERIC
NASTRAN
DYNA
OPENSEES

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 | 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_offset

ignore 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

TIED

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

Description

Title

Parameters

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

Index

TOL

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_curve	element 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

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

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

Description

Element user module title

Parameters

module

module number

0	highest element user module +1

name

module name

colour

colour (ref. colour syntax)

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.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

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.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

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

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

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)

integer representation of colour (legacy)

Index

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/s²
ENERGY	J
VEL	m/s
ANGLE	rad (radian)
STRAIN	ε (micro-strain)
<i>derived units
WORK	J
MOMENT	Nm
STRESS	N/m²
FORCE_PER_LENGTH	N/m
MOMENT_PER_LENGTH	Nm/m
MOMENT_PER_ROTATION	Nm/rad
EI	N/m²
WARP_CONST	m⁶
AREA	m²
1ST_MOMENT_AREA	m³
2ND_MOMENT_AREA	m⁴
VOLUME	m³
PER_LENGTH	1/m
PER_AREA	1/m²
PER_VOLUME	1/m³
CS_AREA	m²
CS_AREA_PER_LENGTH	m²/m
CURVATURE	1/m
INERTIA	kgm²
DENSITY	kg/m³
AREA_DENSITY	kg/m²
WEIGHT_DENSITY	N/m³
MASS_PER_LENGTH	kg/m
PER_MASS	1/kg
ANGULAR_VELOCITY	rad/s
ANGULAR_ACCELERATION	rad/s²
FLOW_RATE	m³/s
FREQUENCY	Hz
ANGULAR_FREQUENCY	rad/s
PERIOD	s
THERMAL_EXPANSION	1/°C
TEMPERATURE_GRADIENT	°C/m
IMPULSE	Ns
IMPULSE_PER_AREA	Ns/m²
IMPULSE_PER_LENGTH	Ns/m
MOMENTUM	kgm/s
ANGULAR_MOMENTUM	kgm²/s
I_PER_LENGTH	m⁴/m
VOLUME_PER_AREA	m³/m²
DAMPING	Ns/m
ENERGY_DENSITY	J/m³
ENERGY_PER_LENGTH	J/m
COMPLIANCE	m²/N
DEGREE	°
PERCENT	%

Index

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

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