CONTACT: Defining Contact Surfaces
CONTACT: Defining Contact Surfaces
CONTACT(_sliding)The *CONTACT keyword has 10 sub-categories. The following can be edited in PRIMER:
| * CONTACT |
Traditional Ansys LS-DYNA contact types.
|
| *CONTACT_1D | One-dimensional "slidelines" for reinforcing bars in concrete. |
| *CONTACT_ENTITY | Geometric definitions of rigid bodies. Generally used when DYNA is coupled to other codes. |
| *CONTACT_GUIDED_CABLE | A sliding contact that guides 1D elements. |
| *CONTACT_INTERIOR | Internal contact for solid elements. Used to prevent crushable materials collapsing in on themselves and turning inside-out. |
| *CONTACT_RIGID_SURFACE | A rigid surface contact definition. |
| The following contact sub-types cannot be edited in PRIMER. | |
| *CONTACT_AUTO_MOVE | Moves the surface B in a contact definition to close the initial gap between surface A and surface B. |
| *CONTACT_COUPLING | Defines a coupling surface for MADYMO to couple Ansys LS-DYNA with deformable and rigid parts within MADYMO |
| *CONTACT_GEBOD | Contact between a "Gebod" dummy and the structural FE mesh. |
| *CONTACT_2D | Two dimensional contact for use with 2D and Axisymmetric elements. |
|
This figure shows the main contact menu
.
PEN_CHECK Runs the penetration checker for contacts.
The functions currently available have their standard meanings. (See Standard Keyword Top Level Menu Options) is a function for dispalying contact contents, and is described below. |
|
|
||||||
The data on the front panel here is required (even if zero) for all "sliding" contact types, but there are extra, optional data entries at the top of the panel that may be required:
|
GIVE_LABEL/TITLE
Allows you to define the name and label.
Ansys LS-DYNA has an optional _TITLE suffix to the * CONTACT_<type> keyword that is enabled if this is defined. |
|
|
Optional data... Defining data on optional *CONTACT cards A, B, C, D & E All contact types may have additional data for optional cards A, B, C, D & E in Ansys LS-DYNA. The exact options available will depend upon the contact type, for example the Airbag thickness vs time loadcurve is not valid for the (eroding) contact type used in this example. The red [ ?-LC ] symbol on this panel is used to denote the fact that a loadcurve value is implied in this context if a negative number is input, whereas zero or a positive number is a simple constant. Pressing this button will give a selection menu of possible loadcurves. (A green [ ?LC ] means that a positive value implies a loadcurve.) When you have completed entries on this panel returns you to the master panel shown above. |
|
_<type> data... Special data input for this contact surface type. A few contact surface types have mandatory <type> data cards. If this is the case the [_<type>_data...] button on the main panel will be live. In this example the _ERODING_... contact type requires the extra data shown here; but other contact types will require different data. As with the optional data cards, will return you to the main contact input panel. |
|
|
Special input for thermal contact types.
As with the other optional card panels the button will return you to the master contact definition panel. |
|
Saving the contact definition.
Once you have entered the minimum amount of data required to define this contact the button will be made live, and this permits you to save this definition. (If it is not live the missing fields will be highlighted in red.) The definition will be checked and any errors listed, an then it will saved permanently in this model.
Until you press this the definition remains volatile, and will be lost if you exit this panel in any other way.
will display only the contents of the contact.
KEYWORD Using the generic keyword editor to process contacts
|
|
The generic keyword editor for *CONTACT works in exactly the same way as normal, with the exception that an extra "pseudo" keyword has been added to manage the display of the five optional contact cards A to E. |
|
|
The reason for this is that all *CONTACT definitions occupy at least three rows of data, some use four, and if extra keyword suffices are added then more lines may be used. Adding all five optional cards makes each keyword entry very tall, and most optional fields are not used, so the keyword editor would show many lines - mostly full of zeros - for only one or two contacts if these were always shown. |
|
|
Therefore, for each contact, you must choose how many optional cards are to be "live" by setting the pseudo-suffix " ". When the keyword editor is started each contact definition will have this suffix initialised to the current status, determined by scanning optional cards A to E for non-zero values or parameter usages, and will be preset accordingly. If you want to add data to later rows, not currently active, you will first need to change this suffix to the appropriate setting, just like changing any other keyword suffix, whereupon the relevant rows will be shown in the editor. This pseudo-suffix is purely an artifice in the keyword editor, the suffix will not be shown on the *CONTACT card when the deck is written to a keyword file. |
|
|
||||
|
RECURSIVE_COPY Controlling the extent of a copy operation for segment based contacts. If "recursive" copying is used then any segment sets, (and thus their associated segments), in the subject contacts are duplicated; and the newly created contacts will reference these duplicates. Without "recursive" copying the new contacts will reference the same segment sets as the old ones. This is illustrated in the examples below, using the same 3 contacts: |
|
|
|
|
|
With RECURSIVE_COPY selected. In the left box recursive copying has picked up segment sets and their constituent segment. |
With no recursive copying.
In the right box, without recursive copying, only the contact definitions are copied. |
|
Note that for contacts recursive copying only affects segment sets and their segments. A contact defined by parts, elements or nodes will not attempt to copy these in the "recursive" case. |
|
MODIFY Modifying the attributes of an existing contact surface
This functions in exactly the same way as , using the same panels as above. The only difference is that the initial state of the panels is already set with the attributes of the contact surface to be modified.
DELETE Deleting existing contact surfaces
The operation works exactly the same way as described above, except that the chosen surfaces are deleted. The switch also operates in a similar fashion:
- If is switched on any segment sets, plus their segments, referenced by the contacts to be deleted are marked for deletion.
- If recursive deletion is not used only the contact definitions themselves are removed.
Note also that the standard deletion rules described in Section 6.4.1 still apply: contacts and/or segment sets will only be deleted if nothing else (which is to remain) depends on them.
SKETCH Sketch the chosen contact surfaces on the current image
allows the user to select and sketch individual contact surfaces on the current graphics image. Contacts are drawn in terms of the parts, elements, segments and nodes that they include.
Contact surfaces can be sketched using custom colours, which can be adjusted via Display > Colour, see COLOUR... Setting Item Colours in Plots. When the display colours are set to their 'Default', the sketching colours for surfA and surfB will be green and red respectively.
| Default colour | Contact sketch |
|---|---|
![]() | ![]() |
| User defined contact colour (white and grey) | Contact sketch |
![]() | ![]() |
LIST Summarise the contents of contactsallows the user to select any or all contacts and to list a summary of their attributes to the screen. A listing shows contact number, title and type, plus the total in each model. A typical listing is shown here. |
|
CHECK
Runs the standard checking function on the selected contacts. Each contact will be listed either as "OK", or a summary of the errors encountered will be printed. (This is the same as the command during contact editing.)
RENUMBERRaises the standard renumbering panel for contacts in the chosen model, allowing you to renumber some or all of them. To renumber a single contact it may be easier to it and update its label. |
ONLY
Allows you to visualize what is included in the contact.
Select contacts you wish to display and click . will display the contacts selected. will display the contents of the contacts selected. For the contents option, you can also optionaly choose to just display currently visible contents of the selected contacts.
PART
Allows you to get a popup listing of which contacts the selected part(s) are in.
Select one or more parts and click .
If multiple parts are selected, the output will start with a list of contacts that includes any of the selected parts and will later include details of individual parts.
WRITE
To write a Contact file, type a file-name into the text box or use the folder button to find the path where you want the file to be written.
Once a valid file-name and file-path have been selected, the user can choose to immediately write all the contacts which have been loaded by clicking on the button.
The other option is to select the required contact from the contact list and then write the selected contacts by clicking on the button which will become active if at least one contact is selected.
The Images are written out on a white background by default but this can be changed to the currently loaded background colour by clicking on the toggle button. You can also change the image height and width by entering the required pixel values into the corresponding text boxes.
The user also has the option of deciding whether the images or the penetration data is written into the excel file. This can be done by using the and toggle buttons.
FRICTION
There are now a variety of ways of setting friction coefficient values used in contacts:
- The *CONTACT card.
- The *CONTROL_CONTACT card.
- *PART_CONTACT cards.
- *DEFINE_FRICTION cards.
If you have a combination of the above methods, it can be difficult to understand which friction coefficient values are used in your model. tools in PRIMER allow you to investigate these values.
Write Friction Values
Select one or more CONTACT(s) for which you wish to write friction details into an Excel or a CSV file.
Type a file-name into the text box or use the folder button to find the path where you want the file to be written. Once a valid file-name and file-path have been selected, hit .
The Images are written out on a white background by default but this can be changed to the currently loaded background colour by clicking on the toggle button. You can also change the image height and width by entering the required pixel values into the corresponding text boxes.
Visualise Friction Values
Once in a mode, select a PART to investigate contact friction values. After part selection, list of all the contact which refers to the selected part will be shown.
Select a CONTACT from the list followed by All the parts in the selected contact will be shown in the exploded views. Lines with friction values will be drawn between the selected part and all the exploded parts.
The number of contour levels can be between 1 and 13. You can control the number of levels used for contouring, or provide min and max value to set up contour bands automatically.
PEN_CHECK Checking initial penetrations and crossed edgesThe contact penetration checker may be run from:
|
Calling the penetration checker from the top menu panelRuns the checker on all contacts in turn in "summary" mode, producing a listing of penetrations and crossed edges for each one, but no details. Note - the number of penetrations may exceed the number of penetrating nodes as there may be >1 penetration on a node. This is useful as an initial scan to look for problems meriting further attention. As Summarise all but displayed as Quality check warnings on tree. This allows the user to access the detailed Pen Check for each contact directly.
writes all qualifying (above user threshold) part vs part interactions to a .csv file. Runs the checker in detailed mode on the contact selected.
By default the contact check will be performed using MPP methods with the exception of the minimum threshold for reported penetrations. PRIMER uses the minimum of the SMP threshold (calculated from element sizes) and 0.001 (the hard-wired Ansys LS-Dyna threshold). This is far more sensible for models in metre units. However, the user may over-ride this and apply their own value for MPP threshold. |
Calling the penetration checker from the Create/Edit panelThe command in this context runs the checker on the current (scratch) contact definition currently being edited. Contact penetration checking is covered in more detail in Contact Penetration Checking
|
Visualising contact surfacesContacts may be selected for explicit display in the ity Viewing panel panel.They are drawn in terms of the parts, elements, nodes and segments that define them. Where boxes are used to delimit contacts these are displayed if switched on in the "Associated data" section.
They may also be drawn via the SKETCH functions above. |
|
|
Special display modes for contact surfacesSince contacts are drawn in terms of the structural elements or segments that define them it would be difficult to distinguish a contact from normal structure if both were rendered in the same way. Therefore PRIMER use different forms of display to distinguish contacts from ordinary structure. By default contacts are drawn using a technique called "stippling", as shown here, in which alternate pixels are omitted. This gives a distinctive slighty fuzzy appearance, but also allows graphics of other items behind the contact to be visible. In this example a contact covers the whole of the dummy's head, but internal structure (beams and accelerometers) is visible through the stippled contact. |
|
|
Other display modes for contacts are available in the panel. Various degrees of stippling give different effects. It is also possible to revert to the "old" PRIMER method of drawing the contacts solid shaded with cross-hatched lines added, however this is slow to render and is not recommended. Rather than trying to describe the effects here it is suggested that the curious try experimenting |
|
Duplicates during input*CONTACT cards can have the suffix _TITLE in which case they must also be given a specific label. If two or more such cards have the same label then normally PRIMER would treat this as an input error and reject the input deck. However it transpires that Ansys LS-DYNA has some special logic to deal with this situation, meaning that duplicate contact definitions are (semi) legal:
Therefore from PRIMER 13 onwards the treatment of duplicate contact cards during keyword input has been modified as follows:
Warning: Although Ansys LS-DYNA will accept this practice it is recommended that you do not use it . Not only is it a "hostage to fortune" that relies on non-standard and undocumented Ansys LS-DYNA behaviour, but also the labels ultimately assigned to contact surfaces in Ansys LS-DYNA will depend on the order in which they are read, and changing include file order will affect this. It is strongly recommended that you either eliminate duplicate definitions, or relabel them explicitly to make them unique.
Note: This treatment of duplicate contact definitions is not standard PRIMER behaviour, and applies only to the *CONTACT keyword. The standard treatment of duplicate labelled keyword is controlled by the panel during keyword input, and is described in : Permit duplicate definitions.
|



