Transferring Material

You can use the  icon to store and transfer material, interaction data, Meta-Particles, and Material Block data in a database file between simulations. 

Bulk Materials also contain the Particle Shape and Size Distribution information.

The Materials Database supplied with EDEM does not contain example material types.

By default, the Materials Database (MaterialsDB.h5) is installed at My Documents > Altair > EDEM folder. If you move the Materials Database (for example to a shared network folder for use by multiple clients), you must update the location information in EDEM by selecting Tools > Options > File Locations and then browsing to the new location.

Transferring Materials to and from the Materials Database

Any material or interaction defined in a model can be transferred to the materials database for use in other simulations. Similarly, materials and interactions can be imported from the database into your model.

To transfer a material to or from the database:

  1. In the Bulk Material tab, right-click and select Transfer Material.
  2. In the Transfer dialog box, click the material to transfer.
    The material's properties are displayed.
  3. Click the appropriate arrow to transfer the material to or from the database.
  • If a material in the model and database have the same name but different properties, they are highlighted in red to indicate the conflict.
  • If you continue with the transfer, one material will overwrite the other.
  • If two materials have the same name and the same properties they are both highlighted in green.
  • If a Meta-Particle is in the simulation which matches the Meta-Particle name, but is a different particle definition in the database it will be highlighted in red.
  • If there is a mismatch with the particle properties is used to construct the Meta-Particle, they will be highlighted in yellow.
  • Equipment Materials will automatically be assigned to the Equipment Material section and Bulk Materials will automatically be assigned to the Bulk Material section of the Creator Tree.
  • However, the interaction information has to be transferred separately.

Adding Materials and Material Interactions to the Database

Materials and material interactions can be added to the database by transferring from an existing simulation.

Materials defined in your database are not automatically added to any model. All materials used in a model must be defined directly in that model or explicitly transferred from the materials database.

Saving the Material Block

By clicking this option, the particles inside the current simulation domain are stored in the form of a Material Block in the Material Database.  The current simulation domain is defined as the bounding box as specified in the Creator Tree > Environment > Domain at the Time Step that the save material block option is selected. Saving a Material Block automatically saves the Bulk and Equipment Materials used for it together with the corresponding interactions. All this data will be available in any other EDEM deck through the Material Database.

The Contact Model specific information is also saved, for example if the Bonding V2 model is used the bond contact information is stored in the material block.

The purpose of this tool is to generate a bed of material by just assembling multiple copies of a Material Block. An alternative use of the Material Block is to take the output of one simulation and use it as an input to another, using the Dynamic Block Creation functionality.

In either case, an initial simulation to obtain the Sample Block is necessary before moving back to the Creator to save the Material Block into the Internal Materials Database.

For more information about adding materials, see Adding Bulk Material in the Factories section of the Creator documentation.

(c) 2023 Altair Engineering Inc. All Rights Reserved.

Intellectual Property Rights Notice | Technical Support