Mapdl.cnkmod(itype='', knum='', value='', **kwargs)

Modifies contact element key options.



Contact element type number as defined on the ET command.


Number of the KEYOPT to be modified (KEYOPT(KNUM)).


Value to be assigned to the KEYOPT.


The CNKMOD command has the same syntax as the KEYOPT command. However, it is valid only in the SOLUTION processor. This command is intended only for use in a linear perturbation analysis, and can only be used to modify certain contact element KEYOPT values as described below.

Modifying KEYOPT(12)

One use for this command is to modify contact interface behavior between load steps in a linear perturbation analysis; it allows the user to control the contact status locally per contact pair. For this application, this command is limited to changing the contact interface behavior key option: KEYOPT(12) of CONTA171, CONTA172, CONTA173, CONTA174, CONTA175, CONTA176, and CONTA177; and KEYOPT(10) of CONTA178.

When used for this purpose, the command adjusts the contact status from the linear perturbation base analysis (at the point of restart) as described in the table below. Note that CNKMOD allows you to take points in the base analysis that are near contact (within the pinball region) and modify them to be treated as “in contact” in the perturbation analysis; see the “1 - near-field” row with KEYOPT(12) values set to 4 or 5. CNKMOD also allows you to take points that are sliding in the base analysis and treat them as sticking in the perturbation analysis, irrespective of the MU value; see the “2 - sliding” row with KEYOPT(12) values set to 1,3, 5, or 6.

Table: 128:: : Adjusted Contact Status with CNKMOD is Issued

(if outside of the adjusted pinball region)

(if inside of the adjusted pinball region)

(if outside of the adjusted pinball region)

(if inside of the adjusted pinball region)

If an open gap exists at the end of the previous load step and the contact status is adjusted as sliding or sticking due to a “bonded” or “no separation” contact behavior definition, then the program will treat it as near-field contact when executing CNKMOD in the subsequent load steps.

In the linear perturbation analysis procedure, contact status can also be controlled or modified by the PERTURB command. The contact status always follows local controls defined by the CNKMOD command first, and is then adjusted by the global sticking or bonded setting (ContKey = STICKING or BONDED) on the PERTURB command (see the PERTURB command for details).

Modifying KEYOPT(3)

Another use for this command is to change the units of normal contact stiffness (contact element real constant FKN) in a linear perturbation modal analysis that is used to model brake squeal. For contact elements CONTA171, CONTA172, CONTA173, and CONTA174, KEYOPT(3) controls the units of normal contact stiffness. You can issue the command CNKMOD,ITYPE,3,1 during the first phase of the linear perturbation analysis in order to change the units of normal contact stiffness from FORCE/LENGTH3 (in the base analysis) to FORCE/LENGTH. Note that KEYOPT(3) = 1 is valid only when a penalty-based algorithm is used (KEYOPT(2) = 0 or 1) and the absolute normal contact stiffness value is explicitly specified (that is, a negative value input for real constant FKN).