Command manual

Command list

INCLUDE

Input handling
*INCLUDE
"Optional title"
filename
$sf_x$, $sf_y$, $sf_z$, nid_offset, eid_offset, pid_offset, mid_offset, gid_offset
$x_0$, $y_0$, $z_0$, $x_1$, $y_1$, $z_1$
$\bar{x}_{x}$, $\bar{x}_{y}$, $\bar{x}_{z}$, $\bar{y}_{x}$, $\bar{y}_{y}$, $\bar{y}_{z}$

Parameter definition

VariableDescription
filename The path and the name of file to be included
$sf_x$, $sf_y$, $sf_z$ Scale factors for nodal coordinates in x, y and z directions
default: 1
nid_offset Number to add to all node IDs
eid_offset Number to add to all element IDs
pid_offset Number to add to all part IDs
mid_offset Number to add to all material, damage, EOS and thermal property command IDs
gid_offset Number to add to all other command IDs
$x_0$, $y_0$, $z_0$ Start point for mesh translation
$x_1$, $y_1$, $z_1$ End point for mesh translation
$\bar{x}_{x}$, $\bar{x}_{y}$, $\bar{x}_{z}$ New direction of x-axis
default: (1,0,0)
$\bar{y}_{x}$, $\bar{y}_{y}$, $\bar{y}_{z}$ New direction of y-axis
default: (0,1,0)

Description

This command is used to merge a file with the input. The data in the included file can be transformed (optional). A point in the original configuration $\mathbf{x}$ will be moved to location $\mathbf{x}'$ according to:

$\mathbf{x}' = \mathbf{x_1} + \left[ \begin{array}{ccc} \bar{x}_x & \bar{y}_x & \bar{z}_x \\ \bar{x}_y & \bar{y}_y & \bar{z}_y \\ \bar{x}_z & \bar{y}_z & \bar{z}_z \end{array} \right] \cdot \left[ \begin{array}{ccc} sf_x & & \\ & sf_y & \\ & & sf_z \end{array} \right] \left( \mathbf{x} - \mathbf{x_0} \right)$

Hence, a point $\mathbf{x}_0$ in the original configuration will be moved to $\mathbf{x}_1$. This is the base point for both scaling operations and rotations.