Home
EDEM Simulator
EDEM Simulator is a powerful solver used for fast and efficient simulations.
Set Simulator Parameters
You can set simulation parameters such as the Time Step, simulation time, grid options, and Simulator Engine for the CPU mode, along with the GPU parameters.
Export Simulation Results
While running simulations, you can export simulation results to assess the behavior of the simulation during processing without the need for stopping and post-processing in EDEM Analyst.
Generate images on Linux Headless machines
Generating images on Linux machines requires a running Xorg server. This issue occurs on cloud computing clusters and other headless machines, which generally do not have a running Xorg server.

Welcome
What's New
New features and enhancements available in EDEM.
Release Notes
This document contains information about the EDEM release, such as key features and enhancements, bug fixes, and known issues.
About EDEM
EDEM is a high-performance simulation software for bulk and granular materials.
Get Started with EDEM
The EDEM user interface comprises three icons for each simulation component - Creator, Simulator, and Analyst.
EDEM Creator
EDEM Creator is the pre-processor for creating an EDEM simulation model, including setting up equipment and defining the generation of bulk materials.
EDEM Simulator
EDEM Simulator is a powerful solver used for fast and efficient simulations.
- Set Simulator Parameters
  You can set simulation parameters such as the Time Step, simulation time, grid options, and Simulator Engine for the CPU mode, along with the GPU parameters.
  - Time Steps
    A Time Step is the amount of time between iterations (calculations) in EDEM Simulator.
  - Set Data Save
    You can configure settings that determine the simulation data saved, the type of data to be saved, save interval, and data compression.
  - Export Simulation Results
    While running simulations, you can export simulation results to assess the behavior of the simulation during processing without the need for stopping and post-processing in EDEM Analyst.
    - Export Results Data
      You can export csv files from your simulation during run time. This allows you to generate results from your simulation without the need to save Time Step data out, therefore, reducing the data storage requirements for the simulation.
    - Add Queries to a Simulation
      You can define queries with a unique Start Time, End Time, and Interval Time similar to those in EDEM Analyst.
    - Export images during run-time
      You can generate images of the simulation automatically during run-time. This is most useful during simulation monitoring on remote machines or machines that do not have graphical output.
    - Generate images on Linux Headless machines
      Generating images on Linux machines requires a running Xorg server. This issue occurs on cloud computing clusters and other headless machines, which generally do not have a running Xorg server.
  - Simulator Grid (CPU Engine only)
    The main computational challenge in DEM simulations is the detection of contacts. EDEM Simulator can examine each cell and analyze only those that contain two or more elements (and hence a possible contact) by dividing the domain into grid cells, saving processing time.
  - Track Collision Data
    During a simulation, EDEM can record data about both contacts and collisions.
  - Preserve Contact Between Triangles
    You can preserve the contact history for a particle passing from one element to another.
- Start and Stop a Simulation
  The current simulation time along with all the previous time steps are displayed in the Viewer Controls pane.
- Dynamic Domain
  When you define a Geometry object as a Dynamic Domain, all material inside the object will be active, and EDEM excludes any stationary material outside the object from any calculations, therefore, improving simulation speed. Dynamic Domain is based on the method outlined in Mio et al., 2009.
- Select the EDEM Simulator Engine
  You can run a simulation in CPU or GPU engine mode. However, the GPU mode requires supported GPU hardware.
- Run EDEM in Batch Mode
  EDEM's Command Line Interface allows you to run EDEM in batch mode without using the GUI.
- Reduce Simulation Time
  The time taken by the Simulator to perform a single iteration, t_iteration, is affected quite significantly by the simulation parameters.
EDEM Analyst
EDEM Analyst is the post-processor used to analyze and visualize the results of your simulation.
EDEM Contact Models
A Contact Model describes how elements behave when they come into contact with each other.
EDEM Cal Utility
EDEM Cal is a utility which works with EDEM and is designed to assist in performing calibration.
GPU CUDA Guide
The EDEM CUDA GPU module uses the latest General Purpose Computing on Graphical Processing Units (GPU) technology.
Programming Guide
The EDEM Programming Guide describes the EDEM API.
Coupling Interface Programming Guide
The Coupling Interface Programming Guide provides an overview of how to use the EDEM Coupling Interface to couple with a generic CFD code and/or Multi Body dynamics codes.
EDEMpy
EDEMpy is a Python library for accessing EDEM data from .h5 files (the underlying EDEM file format). EDEMpy does not require prior knowledge of advanced programming.
EDEM Solver Capabilities
EDEM contains four solver engines.
Appendix
This section provides additional information about how to estimate simulation time, supported EDEM File types, attribute definitions, and so on.
EDEM Terminology
Definitions of terms used in EDEM.
References and Bibliography
This section cites the contributions made by various authors and sources that have been used as reference material for EDEM, and the specifics of how they have been applied can be found in the individual contact model sections.

Generate images on Linux Headless machines

Generating images on Linux machines requires a running Xorg server. This issue occurs on cloud computing clusters and other headless machines, which generally do not have a running Xorg server.

To generate images on Linux Headless machines:

As a workaround, install the `xvfb` package, and then prefix the EDEM command with `xvfb-run` as follows:

xvfb-run edem …

This will start a virtual Xorg server, which does not require graphical output.

Note: You may need to manually set the DISPLAYenvironment variable to point to the correct Xorg server

If an Xorg server is not available, image export is not supported and must be disabled.
To disable it without starting EDEM, edit the following line in the .dfg file:
```
“PROCESSOR:IMAGE GENERATION:ACTIVE=BOOLEAN:TRUE” by changing “TRUE” to “FALSE”
```
.

This limitation may be resolved in a future version of EDEM.