"Swiss Army knife" for all kind of contact warnings.

The tool helps to analyze initial penetrations of the different contact definitions. It also helps to visualize the nodes moved during initialization by LS-DYNA due to detected initial penetrations.


check13 [options] message-file[s]


-list list all warned penetrating nodes
-top ## list and output top ## values (default: ##=5)
-ptol ## list and output only penetrations/separations > ##
-sid #,#,… check only SIDs #,#,…
-bucket show penetration buckets for each interface
-pid print property for penetrating node
-psum print property penetration summary
-rsort sort for remaining distance
default: sort for penetrating distance
-rtol ## list and output only penetrations that have a remaining distance < ##
-title print contact titles if available (read d3hsp-file)
-hsp <file> d3hsp filename if other than "d3hsp" (needed for -title)
-typ print contact type (eg: a3, 13, a13)
-typ -typ print contact type in keyword (eg: SINGLE_SURFACE)
-timestep print contact timestep if available
-all list all contacts (even without any warnings)
(usefull with -timestep and -typ)
-g <d3plot> optional d3plot-file (needed for property info)
default: d3plot
-sel <type>

selected warning type (default=all)

values for <typ> in tied contacts:

tied         - all warnings for tied contacts
sep         - nodes with separation that are moved
offset      - nodes with separation that are not moved for any reason (OFFset remains but tied connection is applied - dangerous!)
far          - nodes with separation that are too FAR away (node is untied)
short       - nodes with separation that would shorten connected beams (node is untied)
notfound - nodes that are not found to lie on any master segment (node is untied)
rigslav    - nodes that are rigid slave nodes (node is untied)
rigmast   - nodes that are found on master segment with any rigid node (node is untied)
conflict    - nodes that conflict with other tied contact definition (node is untied)
untied     - all above warnings with untied nodes (untied nodes of spotwelds should be corrected)

values for <typ> in standard contacts (eg typ13):
typ13   - all warnings for standard contacts that follow below
pen      - nodes penetrating segment
mid      - nodes close to shell midplane
del       - nodes deleted from contact after initialisation
below   - nodes too far below surface
soft2    - element-element contact warnings in soft2 contact
inter    - element-element intersection warnings in soft2 contact (first state)
last      - element-element intersection warnings in soft2 contact (last  state)
curve   - element-element intersection warnings in soft2 contact - LSPP XYcurve output
             and create LSPP XY plotfile "soft2_xy.crv"
mortar - element-element penetration warnings in mortar contact types

-tlast ##

upper time limit for checking of "-sel last"


create Animator session file for displaying nodes via "ide nod xxx"


create Animator4 session file for displaying nodes via "sel nod xxx"
and create Animator4 groups named "id<sid>_<warn-type>"

-key create LS-DYNA keyword file "check13.key" with beams of length of the penetrations -
can be loaded into LS-Post or Animator3
-keyset create LS-DYNA keyword file "check-c.key" with *SET_xxx for penetrating nodes or elements -
can be loaded into LS-PrePost or Animator3/4
-medina create Medina protocol files
-mnode node id for new node creation in Medina protocol
-out <file> print output to <file> (default: STDOUT)
-sprefix ## prefix for session-filenames
-version print version

% DM.check-c -ptol=0.1 -ani -buc -tit -si 13,21 mes00*