OUTPUT_DEBUG

Output
Attention: This command is in the beta stage and the format may change over time.
*OUTPUT_DEBUG
message
Parameter definition
VariableDescription
message Debug message
Description

This command is used to debug and to identify mistakes in command files. It outputs user-defined debug messages to impetus.info, together with current repeat loop variables, INCLUDE offsets and coordinate transformation parameters. A debug message is limited to 80 characters.

The coordinate transformation is presented in the format:

$\displaystyle{ \bar{\mathbf x} = {\mathbf A} {\mathbf x} + {\mathbf x}_0}$

where ${\mathbf x}$ is the original coordinate, $\bar{\mathbf x}$ is the transformed coordinate, ${\mathbf A}$ is a rotation/scaling matrix and ${\mathbf x}_0$ represents a translation. ${\mathbf A}$ and ${\mathbf x}_0$ can be the result of multiple layers of INCLUDE with different translations, scalings ans rotations.

Example
User-defined debug information

A number of cubes are generated with COMPONENT_BOX and with the ~repeat command. There is maximum allowed coordinate $x0=1.8$. A debug command is added to warn if this limit is exceeded.

*UNIT_SYSTEM
SI
*PARAMETER
%id = 0, "index"
%Nx = 10, "number of boxes in x-direction"
%Ny = 5, "number of boxes in y-direction"
%L = 0.01, "box size"
#
# --- MESH ---
#
~repeat [%Nx]
~repeat [%Ny]
*PARAMETER
%id = %id + 1
%x0 = 0.1*r1 + 0.2*r2
%y0 = 0.2*r1 + 0.1*r2
*COMPONENT_BOX
[%id], 1, 1, 1, 1
[%x0], [%y0], 0, [%x0+%L], [%y0+%L], [%L]
~if %x0 > 1.8
*OUTPUT_DEBUG
"Too large coordinate x0 =[%x0]"
~end_if
~end_repeat
~end_repeat
#
# --- MATERIAL ---
#
*MAT_RIGID
"boxes"
1, 1000.0
#
# --- PART ---
#
*PART
"boxes"
1, 1
*END

A debug section is added to the impetus.info file. In this specific case, with the information:

[ OUTPUT DEBUG ]
.
DEBUG MESSAGE "Too large coordinate x0 = 0.190E+01"
File name main.k
Line number 19
Repeat cycle r1 9
Repeat cycle r2 5
Repeat cycle r3 0
nid_offset 0
eid_offset 0
pid_offset 0
mid_offset 0
gid_offset 0
x0(:) 0.000E+00 0.000E+00 0.000E+00
A(1,:) 1.000E+00 0.000E+00 0.000E+00
A(2,:) 0.000E+00 1.000E+00 0.000E+00
A(3,:) 0.000E+00 0.000E+00 1.000E+00
.
DEBUG MESSAGE "Too large coordinate x0 = 2"
File name main.k
Line number 19
Repeat cycle r1 10
Repeat cycle r2 5
Repeat cycle r3 0
nid_offset 0
eid_offset 0
pid_offset 0
mid_offset 0
gid_offset 0
x0(:) 0.000E+00 0.000E+00 0.000E+00
A(1,:) 1.000E+00 0.000E+00 0.000E+00
A(2,:) 0.000E+00 1.000E+00 0.000E+00
A(3,:) 0.000E+00 0.000E+00 1.000E+00