Home
GPU CUDA Guide
The EDEM CUDA GPU module uses the latest General Purpose Computing on Graphical Processing Units (GPU) technology.
GPU CUDA API Guide
CUDA requires that all functions be declared according to where they are going to be called and executed.
GPU CUDA Class Declarations
You can use multiple different particle types with the CUDA API. The CUDA API operates with a generalized set of classes and functions.

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.
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.
- Set up Hardware
  This section describes the tests necessary to run EDEM CUDA GPU such as GPU Device and Connectivity tests.
- Set GPU CUDA Simulator Parameters
  The EDEM GPU CUDA solver engine will automatically allocate the required memory and resources as the simulation runs.
- Run GPU from the Command Line
  To run EDEM GPU from the command line, specify the simulator engine with the flag “-E” followed by the corresponding engine number.
- GPU CUDA Known Issues and Limitations
  The EDEM 2022.3 GPU CUDA Solver Engine contains the following known issues.
- GPU CUDA Troubleshooting
  The following tips may help resolve any issues while using the EDEM GPU Solver Engine.
- GPU CUDA API Guide
  CUDA requires that all functions be declared according to where they are going to be called and executed.
  - GPU CUDA Class Declarations
    You can use multiple different particle types with the CUDA API. The CUDA API operates with a generalized set of classes and functions.
  - GPU CUDA Getter and Setter Functions
    A range of Getter and Setter functions have been implemented in order to maintain backward compatibility going forwards with the CUDA API,
  - Debug GPU CUDA
    EDEM displays the errors in a dialog box when your simulation is started. An additional method for debugging which allows you to obtain real-time information from the simulation is to run an attached simulation through the command line.
  - GPU CUDA Main Functions
    The main function naming in the CUDA API follows a convention where the file name should not prefix the main function names.
  - GPU CUDA Data Precision
    In the CUDA API, you can specify the precision with which you want the data to be handled. This allows the API scripts to leverage the speed benefits of the hybrid and single precision solvers.
  - CUDA Asserts
    The CUDA Solver has an additional option to enable asserts for enhanced error diagnostics.
  - GPU CUDA Header Files
    The GPU CUDA Header files are not required to develop a CUDA API plugin, but can be used for a better editing experience including syntax highlighting and Intellisense. They also allow API users to quickly get the most recent versions of the various CUDA functions that have been added in between releases. The Header files for the EDEM CUDA API are now located at: INSTALL_DIRECTORY\EDEM\src\Api\Cuda.
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.

GPU CUDA Class Declarations

You can use multiple different particle types with the CUDA API. The CUDA API operates with a generalized set of classes and functions.

To use GPU CUDA class declarations:

To retrieve the radius of an element in CUDA for a Multi-Sphere or a Sphero-Cylinder, use the following operation:

element1.getPhysicalRadius() ;

The closest equivalent operation which would work for polyhedral particles is:

element1.getVolumeSphereRadius();

This is not a syntactical difference, but rather a real difference in the value. In this case it is due to the fact that Polyhedral particles do not have an inherent radius like Multi-Spheres and Sphero-Cylinders.

When developing API scripts on CUDA, use the following resources to understand the available functionality:

Internal EDEM API documentation - Details the EDEM-specific CUDA functions and classes and can be found at the following location:<EDEM install directory>\202X.X\EDEM\src\Api\Help.
- Select any html file.
CUDA Documentation - Details standard CUDA functionality.
For the complete documentation, see https://docs.nvidia.com/cuda/index.html
Example code is available on the Altair community page: https://community.altair.com/community.

For more information about implementation of different functions, see GPU CUDA Getter and Setter Functions.