structure node initialize command

Syntax

structure node initialize keyword ... <range>

Primary keywords:

displacement    displacement-x    displacement-y    displacement-z    displacement-rotational    displacement-rotational-x    displacement-rotational-y    displacement-rotational-z    position    position-x    position-y    position-z    ratio-target    velocity    velocity-x    velocity-y    velocity-z    velocity-rotational    velocity-rotational-x    velocity-rotational-y    velocity-rotational-z

Initialize displacement, velocity and position of all structure nodes in the range.

Displacements and velocities can be specified in either the global or node-local coordinate systems via the local keyword. When specifying values in the node-local system, it is best to first define the orientation of that system. The orientation of the node-local system is set automatically at the start of a set of cycles (or when the model cycle 0 command is executed), based on the type of elements that use the node (as described here). It is suggested that one execute a model cycle 0 command before assigning values in the node-local system. If a velocity component is initialized, then this component should also be fixed with the structure node fix command.

displacement v <[nodeinitializeblock]>

translational displacement

displacement-x f <[nodeinitializeblock]>

translational displacement (\(x\)-component)

displacement-y f <[nodeinitializeblock]>

translational displacement (\(y\)-component)

displacement-z f <[nodeinitializeblock]>(3D ONLY)

translational displacement (\(z\)-component)

displacement-rotational v <[nodeinitializeblock]>

rotational displacement

displacement-rotational-x f <[nodeinitializeblock]>(3D ONLY)

rotational displacement (\(x\)-component)

displacement-rotational-y f <[nodeinitializeblock]>(3D ONLY)

rotational displacement (\(y\)-component)

displacement-rotational-z f <[nodeinitializeblock]>(3D ONLY)

rotational displacement (\(z\)-component)

position v <[nodeinitializeblock]>

position of node (global system). This is used for positioning of structural elements, and must be used after creating the node, but before executing any cycles. A node that is moved into a zone will have its link deleted (if one is present) and will have a new link created with attachment conditions corresponding to the type of structural element using the node (see this table). If more than one element type is using the node, then the attachment condition will correspond with the first element type in the following list: liner, geogrid, pile, cable, shell, and beam. Thus, if a node is being used by both a geogrid and a cable, then the attachment condition after moving this node will correspond with that of a geogrid.

position-x f <[nodeinitializeblock]>

\(x\)-coordinate of node (global system). See position above.

position-y f <[nodeinitializeblock]>

\(y\)-coordinate of node (global system). See position above.

position-z f <[nodeinitializeblock]>(3D ONLY)

\(z\)-coordinate of node (global system). See position above.

ratio-target f <[nodeinitializeblock]>

Sets the target local force ratio that is considered to be converged for mechanical calculations. The default value is 1e-4. A local force ratio of this value will result in a convergence value of 1.0 for the node. See the convergence keyword in the model solve command.

velocity v <[nodeinitializeblock]>

translational velocity

velocity-x f <[nodeinitializeblock]>

translational velocity (\(x\)-component)

velocity-y f <[nodeinitializeblock]>

translational velocity (\(y\)-component)

velocity-z f <[nodeinitializeblock]>(3D ONLY)

translational velocity (\(z\)-component)

velocity-rotational v <[nodeinitializeblock]>

rotational velocity

velocity-rotational-x f <[nodeinitializeblock]>(3D ONLY)

rotational velocity (\(x\)-component)

velocity-rotational-y f <[nodeinitializeblock]>(3D ONLY)

rotational velocity (\(y\)-component)

velocity-rotational-z f <[nodeinitializeblock]>(3D ONLY)

rotational velocity (\(z\)-component)

structure node initialize Keyword Block

The initialization values specified with the structure node initialize command may be optionally modified with the keywords below.

They apply (except where noted with regard to the local keyword), to all of the major keywords of the command: displacement, displacement-rotational, displacement-rotational-x, displacement-rotational-y, displacement-rotational-z, displacement-x, displacement-y, displacement-z, position, position-x, position-y, position-z, ratio-target, velocity, velocity-rotational, velocity-rotational-x, velocity-rotational-y, velocity-rotational-z, velocity-x, velocity-y and velocity-z.

add f

Add the specified value to the existing value.

gradient v <origin v >

Apply a gradient to the scalar-value provided.

local

Specify that the value supplied for the keyword is in the local coordinate system of the gridpoint (if any). By default values are initialize in the global system.

multiply f

Multiply the existing value by the specified value.

vary v

Apply a linear variation to the scalar-value provided.