TCL Command VARDBL

Syntax

VARDBL arg1 arg2 arg3 arg4 arg5

Description

Input of a variable using units defined in the project.

Arguments

Minimum number: 3

arg1

Value	unit	Meaning
name	TEXT	Name of the variable. The attribute is always assigned to a structural unit. The number of this unit must be placed in front of the name: "{iunit}Attributename"

arg2

Value	unit	Meaning
value	see arg3	The value is unit-dependent (see project settings). The value can be specified as a constant or as a function expression. If applicable, values are possible in imperial representation.
expr	TEXT	Function expression. To make a function expression clearly recognizable, it should be placed in curved brackets. Function calls or combinations thereof are possible. All mathematically meaningful terms supported by the TCL interpreter can be used. The following additional functions allow a wide range of applications:

List of predefined functions

Function	unit	Meaning
MSectDiam_(stype,s,{P1},{P2})	LCROSSD	Distance between two cross-section points P1 and P2 in the station s, which is noted by one of the types stype {0=SGLOBAL, 1=SLOCAL, 2=SXTOL, 5=SLOCEND}
MLen0_(iunit)	LSTRUCTD	Even length of a structural unit iunit in its node
MLen0_(0,{P})	LSTRUCTD	Even length of a structural unit iunit in its cross-section point P
MLen0_(iunit,{cog})	LSTRUCTD	Even length of a structural unit iunit in is center of gravity
MIncl_(...)	ANGLED	Inclination of a structural unit relative to the plan view (not for prisms); the same arguments apply as for the MLen0_ function.
MSectVar_(stype,s,{v})	according to Variable type	Value of the variable v at the station s, which is specified by one of the types stype {0=SGLOBAL, 1=SLOCAL, 2=SXTOL, 5=SLOCEND}
MSectPerim_(stype,s,iunit)	LCROSSD	Outer perimeter of the structural unit iunit in station s, which is noted by one of the types stype {0=SGLOBAL, 1=SLOCAL, 2=SXTOL, 5=SLOCEND}
MSectPerim_(stype,s,0,{b})	LCROSSD	Outer perimeter of the edge iunit in station s, which is noted by one of the types stype {0=SGLOBAL, 1=SLOCAL, 2=SXTOL, 5=SLOCEND}
MSectArea_(stype,s,iunit)	LCROSS**2	Area of the structural unit iunit in station s, which is noted by one of the types stype {0=SGLOBAL, 1=SLOCAL, 2=SXTOL, 5=SLOCEND}
MSectArea_(stype,s,0,{b})	LCROSS**2	Area of the edge iunit in station s, which is noted by one of the types stype {0=SGLOBAL, 1=SLOCAL, 2=SXTOL, 5=SLOCEND}
MVolume(iunit)	LSTRUCT**3	Volume of the structural unit iunit

arg3

Value	unit	Meaning
unit	ENUM	Unit type from the list of project settings (units in the project) or a derived unit
TABS	KEYWORD	Absolute temperature. Depending on the set temperature unit (see project settings), the value is interpreted as an absolute temperature.
1/TEMP	KEYWORD	Reciprocal of the selected temperature unit
FORCE/L	KEYWORD	Force per length
FORCE/L/L	KEYWORD	Force per area
AREINF/L	KEYWORD	Reinforcement area per length
LSTRUCT**3	KEYWORD	Volume
LCROSS**2	KEYWORD	Cross-sectional area
PERCENT	KEYWORD	Percent
NONE	KEYWORD	Unspecified unit of the entered or calculated value

arg4

Value	unit	Meaning
info	TEXT	Descriptive text

arg5

Value	unit	Meaning
guid	GUID	The GUID can either be taken from the list of existing Allplan or Bimplus attributes or it is created automatically by Allplan Civil. As this is a generic concept, not all attributes have been predefined already in Allplan and Bimplus.

Scopes

ATTRIBUTES

Examples

ATTRIBUTES BEGIN

VARDBL "{1}P1P4" "{MSectDiam_( 1, 100.0, {P1}, {P4} )}" LCROSSD "Offset P1->P4 in Station 100.0"

VARDBL "{1}Perimeter" "{MSectPerim_( 1, 100.0, 1 )}" LCROSSD "Perimeter in station 100.0"

VARDBL "{1}Area" "{MSectArea_( 1, 100.0, 1 )}" LCROSS**2 "Area in station 100.0"

VARDBL "{1}Volume" "{MVolume_( 1 )}" LSTRUCT**3 "Volume"

VARDBL "{1}CO2 Tons" "{0.7*(24.5166/9.81)*MVolume_( 1 )}" NONE “Tons CO2, (0.7kg CO2)/(kg of concrete)"

ATTRIBUTES END

The attribute "P1P4" contains the spacing between the points P1 and P4 at the local station 100.0.

The attribute “Perimeter” contains the perimeter of structural unit 1 at local station 100.0.

The attribute “Area” contains the area of structural unit 1 at local station 100.0.

The attribute “Volume” contains the volume of structural unit 1.

The "CO2 Tons" attribute contains the CO2 consumption of structural unit 1 in tonnes. The specified expression combines the necessary physical values to that effect.

CALC BEGIN

VAR "MemberVolume(iunit)" "Abbreviation of the expression (see below)"

DEFINE "MemberVolume(iunit)" "((MSectVar_(2,0.5,{Radius})*\$_clenf_/\$_slenf_)**2)*\$pi*MLen0_(\$iunit,{cog})"

CALC END

....

ATTRIBUTES BEGIN

VARDBL "{2}Length" "{MLen0_( 2,{cog})}" LSTRUCTD “Long Pier20-02"

VARDBL "{2}Inclination" "{MIncl_( 2,{cog})}" ANGLED "Angle Pier20-02"

VARDBL "{2}Radius" "{MSectVar_( 2,0.5,{Radius})}" LCROSSD "radius approx. in the center of the pile"

VARDBL "{2}Volume" "{MemberVolume(2)}" LSTRUCT**3 "Volume Pier20-02"

ATTRIBUTES END

The attribute "Length" contains the straight length of structural unit 2 (pile) at the center of gravity.

The "Inclination" attribute contains the inclination of structural unit 2 (pile) at the center of gravity relative to the plan view.

The "Radius" attribute contains the value of the "Radius" cross-section variable in the center of the pile.

The attribute shows the use of predefined variables. The volume calculated by Parasolid (MVolume_) is determined with the accuracy of the BREP geometry. The volume can be calculated more accurately as the pile is circular. To do this, the area is calculated exactly using the radius and then multiplied by the length (MLen0_). The expression can be very long and has therefore been predefined in the "MemberVolume" variable. Correct usage of the units must be observed. If the unit of the cross-section length differs from that of the structure length, the value of the radius must be adjusted.