TCL Command UNIT

Syntax

UNIT arg1 arg2 arg3 IMPERIAL imptype ifrac

UNIT arg1 arg2 arg3 factor IMPERIAL imptype ifrac

UNIT arg1 arg2 arg3 factor text IMPERIAL imptype ifrac

Each command starts with its name in capital letters, followed by its arguments. The number and types of arguments vary. In certain cases, the arg-i determines the rules on its follow-up arguments.

Description

The Allplan Bridge unit system distinguishes between units for model input and units for results output. The changes of units for model input have an effect on the evaluation of mathematical expressions by the integrated TCL formula interpreter. It is recommended to select these units when starting the project and to adjust the formulas and tables used to them. The subsequent change of an unit may require the adjustment of the formulas and tables. The change of the result units are always possible.

Arguments

Minimum quantity: 3

arg1

Value	Dimension	Meaning
SETDB	KEYWORD	The setting is applied to the model. The unit is used for all subsequent entries in the TCL file that refer to this unit.
LOCAL	KEYWORD	The unit is used only for all subsequent entries in the TCL file that refer to this unit. The setting in the model does not change.

arg2

Value	Dimension	Meaning
ANGLED	KEYWORD	Angle unit at model input
ANGLE	KEYWORD	Angle unit for results (e.g. rotations)
LCROSSD	KEYWORD	Length unit in cross sections
LCROSS	KEYWORD	Length unit for cross section results
LSTRUCTD	KEYWORD	Length unit for structural objects
LSTRUCT	KEYWORD	Length unit for structural results (e.g. displacements)
STATION	KEYWORD	Length unit for station values
TEMP	KEYWORD	Temperature unit
AREINF	KEYWORD	Area unit for reinforcement
ASTRAND	KEYWORD	Area unit for cross sections of tendons
EMOD	KEYWORD	Unit of modulus of elasticity
STRESS	KEYWORD	Unit of stresses
FORCE	KEYWORD	Unit of forces
MOMENT	KEYWORD	Unit of moments
DEVIATION	KEYWORD	Unit of deviation
LSMALL	KEYWORD	Unit for very small lengths
GAMMA	KEYWORD	Unit of specific weight
ACC	KEYWORD	Unit of acceleration

arg3

Value

Dimension

Meaning

"\[symb\]"

KEYWORD

The units are recognized by predefined symbols. If the symbol is not recognized, then the factor for conversion must be specified (cf. arg4).

Angle: symb = deg || gon || rad || %

Length: symb = m || dm || cm || mm || in || ft || yd

Area: symb = m² || dm² || cm² || mm² || in² || ft² || yd²

Temperature: symb = °C || °F || °K

Stress, E-Modulus: symb = kN/m² || N/mm² || MN/m² || MPa || Pa || ksi

Force: symb = N || kN || MN || kip

Moment: symb = Nm || kNm || MNm || kipft || kipin

Deviation: symb = rad/m || deg/m || rad/ft

Weight: symb = kN/m³ || lb/ft³ || kg/m³ || kip/ft3

Acceleration: symb = m/s² || ft/s²

symbol

TEXT

User defined symbol

factor

Value

Dimension

Meaning

TEXT

When using predefined units, it is not necessary to specify the factor for the internal unit.

factor

DOUBLE

Factor for conversion to internal (metric) unit for user-defined unit

v_intern = v_user * factor

text

Value	Dimension	Meaning
text	TEXT	Any text describing the unit

IMPERIAL

The keyword may be input as 4th, 5th or 6th argument. This is followed by 2 more arguments.

imptype

Value	Dimension	Meaning
FTINDECIM	KEYWORD	Feet + decimal inches
FTINEXACT	KEYWORD	Feet + exact inches
FTINFRACT	KEYWORD	Feet + inches in fractions
INCHEXACT	KEYWORD	Exact (=Feet in decimals or fractions)
INCHFRACT	KEYWORD	Inches in fractions

ifrac

Value	Dimension	Meaning
ifrac	INT	Number of fractions, z.B. 2, 4, 8, 16, 32, 64, 128, 256

Scopes

Scopes in which the current scope or command can be used.

Examples

UNIT SETDB AREINF "\[cm²\]" "" "Square centimeter to Meter"

The unit for the reinforcement area in the model and in the file is set. The factor is predefined.

UNIT SETDB LCROSSD "\[ft\]" "" "Feet to Meter" IMPERIAL FTINFRACT 16

The unit for the cross section lengths in the model and in the file is set. The factor is predefined. The representation of the imperial unit is defined.