material_interaction_properties command

Purpose

Command for defining the interaction properties of a pair of materials.

Note

This command is supported by Aspherix GPU.

Syntax

material_interaction_properties material1_name material2_name keyword value

material1_name, material2_name = name of the interacting materials, obligatory entries (no keyword!)

Legacy keyword:

on_impact: used when custom materials are not defined through the custom_material_properties (in that case: mandatory for standard material / custom material interaction, optional for custom material / custom material interaction).

Options:

  • convert_to_liquid, convert_to_liquid_advanced, convert_to_liquid_with_coating, convert_to_liquid_multiphase, tag or delete (for standart and advanced droplet pairs).

  • reflect, tag or delete (for standard photon pairs).

  • ignore (for standart droplet-droplet and photon-photon pairs).

Please always use the custom_material_properties instead for defining custom materials and their interactions!

Additional keywords:

Additionally, a contact-model dependent list of keyword / value pairs is appended (e.g., youngsModulus, poissonsRatio, coefficientFriction, and so on). The documentation of each physics model contains information about the required properties.

Examples

material_interaction_properties glass steel coefficientRestitution 0.9
material_interaction_properties glass rubber coefficientRestitution 0.7 coefficientFriction 0.4
material_interaction_properties glass rubber coefficientRestitution 0.7 coefficientFriction temp_friction.csv

Description

This command allows to define the interaction properties of a pair of materials. The names of the two materials are obligatory entries.

Multiple instances of the command can be used to define different pairs of materials. The required keywords depend on the particular particle and wall contact model.

Note

The two materials must be different, to specify the interaction properties of a material with itself, use the material_properties command.

Note, some models (e.g. tangential model history/tempdep) can use parameters dependent upon state variables (e.g. coefficient of friction dependent on temperature). For details see: material properties.

The Property Framework (PF) is a more general implementation of this interdependency, see material properties for a more detailed description (NB: this feature might not be available with your license yet). One functionality of the PF that might be useful for material interaction properties is the ‘weighting_variable’, which allows to fine tune the value of the interaction property.

Restrictions

The lack or incomplete specification of material interaction properties might generate an error depending on the model employed.