# cmat add command

Syntax

contact cmat add <i > keyword ... range

Primary keywords:

Adds a new entry to the CMAT. If i is not specified or if i is greater than the total number of entries minus one, then the new entry is added to the end of the CMAT; otherwise, the new entry is inserted at slot i (i>0) while incrementing subsequent entry indices as necessary. The range token is mandatory and must be specified last.

By default, only mechanical contacts are considered.

The information in the entry is specified with the following keywords.

inheritance s b ...

The inheritance for the contact model property s is set to b.

mechanical

Apply to mechanical contacts.

method sm <sa a> ...

The contact model method sm, along with its specific list of argument names and values, is registered with this CMAT entry and will be invoked at contact creation.

model keyword

Specify the contact model. The list of built-in mechanical contact models is given in the “Built-in Contact Models” section. Users may also implement custom contact models (see “User-Defined Contact Models” for further information) and register them in the CMAT.

arrlinear

Specify the Adhesive Rolling Resistance Linear Model contact model.

bilinear

Specify the Bilinear Contact Model contact model.

burger

Specify the Burger’s Model contact model.

fish

Specify the FISH Model contact model.

flatjoint

Specify the Flat-Joint Model contact model.

hertz

Specify the Hertz Model contact model.

hysteretic

Specify the Hysteretic Model contact model.

linear

Specify the Linear Model contact model.

linearcbond

Specify the Linear Contact Bond Model contact model.

lineardipole (3D ONLY)

Specify the Linear Dipole Model contact model.

linearpbond

Specify the Linear Parallel Bond Model contact model.

null

Specify the Null Model contact model.

rrlinear

Specify the Rolling Resistance Linear Model contact model.

smoothjoint

Specify the Smooth-Joint Model contact model.

softbond

Specify the Soft-Bond Model contact model.

property s a<inheritance b > ...

The contact model property named s is set to a. If the inheritance keyword is specified, the inheritance for this property is set to b.

proximity fd

The detection distance is set to fd.

thermal

Apply to thermal contacts.