EDEM API - Contact Model Example: Removing Particles

Renan
Renan
Altair Employee
edited May 23 in Altair Exchange

Overview

The Particle Manager function in EDEM API allows access to the scale, total number of particles, and multi-sphere particle element positions and also includes the ability to remove particles from a simulation.

 
This example shows the Particle Removal function applied to a Salt Spreader simulation. Salt particles are removed when they hit a plane positioned to track the passage of particles. The removal occurs when particles contact a geometry section called 'tracker'. The tracking planes are colored from yellow to red, depending on the number of impacts. The tracking plane coloring is set using the API Custom Geometry Properties.

The required output in this example is the total distribution of salt across the different planes. Removing and recording the material per plane significantly reduces the simulation time, compared to tracking each individual particle. This also improves the post-processing ability, as seen by the visualizations in the image below.

The same functionality can be applied to other simulations and industries, for example when simulating fertilizer spreaders in the agricultural industry, when removing material during chemical reactions in chemical or steel manufacturing or as part of a material breakage model.

 image

Update January 2022 - this model has been updated to the EDEM API Version 3.3 for CPU and also updated to use CUDA API for GPU processing.

Update May 2024 - the model has been updated to version 3.6 of the API.

Usage/Installation Instructions

To run:

  • Place the RemoveParticles.dll and RemoveParticles.cu in the same folder as the required simulation .dem file
  • Go to the Physics > Particle to Geometry section and Edit Contact Chain.  Add RemoveParticles from the Plug-in models area (note this has already been done for the supplied example)
  • Once the RemoveParticles model has been added, click on it then click on the wheel button. Make sure that the geometry named "tracker" is selected from the drop down menu
  • The model can then be run with the tracker code on CPU or CUDA GPU.
Please take a look at the code for use in your own project. We’d appreciate it if you would post any of your own modifications or code snippets to help other users. Feel free to use this forum for asking questions about this contact model.
Tagged:

Comments

  • satri
    satri Altair Community Member
    edited October 2023

    Hey is it possible to extract the information into a file or can i get it from the GUI while post-processing? because i don't see that option of logging to a file in the API files

  • satri
    satri Altair Community Member
    edited October 2023

    I am looking for particle ID and the position where the particle was removed

    getGeometryParameterData function probably has the data but how do i call just that function? and extract the information

  • satri
    satri Altair Community Member
    edited October 2023

    Hey Can someone please tell me how to export the mass-deposited data i am trying to export it an the export option is not at all active please tell me why does this happen?

    image

  • Community Guest
    Community Guest New Altair Community Member
    edited July 3

    Hi Everyone I am using EDEM 2021.2 and Ansys 2023 R1. When I try to use the RemoveParticle.dill Api file I got the error of The library interface version (3.6.0) is not supported by this release. What is the possible solution for this. I am new user of EDEM coupling. Thanks in Advamce

  • Renan
    Renan
    Altair Employee
    edited July 3
    Community Guest said:

    Hi Everyone I am using EDEM 2021.2 and Ansys 2023 R1. When I try to use the RemoveParticle.dill Api file I got the error of The library interface version (3.6.0) is not supported by this release. What is the possible solution for this. I am new user of EDEM coupling. Thanks in Advamce

    Hi,

    Version 3.6 of the API only works with EDEM 2023.1 or newer versions. You have to update EDEM in order to use this API.

    Best regards,

    Renan

  • Community Guest
    Community Guest New Altair Community Member
    edited July 4
    Renan Calmon_20325 said:

    Hi,

    Version 3.6 of the API only works with EDEM 2023.1 or newer versions. You have to update EDEM in order to use this API.

    Best regards,

    Renan

    how can I get its older version?

     

  • Renan
    Renan
    Altair Employee
    edited July 4
    Community Guest said:

    how can I get its older version?

     

    Hi,
    It really recommended that you update EDEM since the 2021.2 version is no longer supported. However, if, for some reason, you can't update EDEM, you can try downgrading the API version to a version that is compatible with version 2021.2. You must ensure that all functions are compatible with the older version

    Regards,
    Renan

Categories