EDEM Dynamics Coupling Quick Start Guide

Size: px

Start display at page:

Download "EDEM Dynamics Coupling Quick Start Guide"

Nathaniel Scott
5 years ago
Views:

1 EDEM Dynamics Coupling Quick Start Guide Table of Contents Introduction EDEM version and licensing Compile Microsoft Visual C++ Express Running the Example Coupled Simulations Updated a Dynamic Coupling Code Trouble shooting DEM Solutions Page 1 of 12

2 Introduction EDEM version and licensing The user should have installed EDEM or later and have a coupling license. The libraries and header files necessary for the coupling may be updated between releases; check in src\api\coupling the versions available in your installation. Earlier EDEM version Needed EDEM EDEM 2.6 EDEM Latest Coupling Version IEDEMCouplingV2_0_0.h IEDEMCouplingV2_1_0.h IEDEMCouplingV2_2_0.h In this guide the latest versions are used, EDEM and IEDEMCouplingV2_2_0.h. Guidelines are given to compile for different versions of the dynamics coupling. In the rest of this document, EDEM is assumed to be installed in the default location: C:\Program Files\DEM Solutions The compiling instructions are tailored for Microsoft Visual Studio / Visual C++ Express Edition. Compiling and Running the Example Coupled Simulation The example coupling program controls the dynamics of a small box that is free to move with 6 degrees of freedom. The file Free_Body_C++.zip can be unzipped to a directory of the users choice. The zip file contains both the source code and the accompanying EDEM deck for running a simulation. The libedemcouplingclientv2_2_0.lib in EDEM folder will be the same version as the EDEM installer 32-bit or 64-bit, therefore you will be able to compile in the same version as current installed EDEM using the libraries at the installation folders. DEM Solutions Page 2 of 12

$Extract the zip file. For example C:\Dynamics Coupling 2.$ Start Microsoft Visual C++ Express 2013 3. Create a project of console application.

3 Compile with Microsoft Visual C++ Express 2013 Compiling the Example Dynamics Code 1. Extract the zip file. For example C:\Dynamics Coupling 2. Start Microsoft Visual C++ Express Create a project of console application. One of the difference respect compiling an API model where a DLL is produced. Then click OK and next pop-up window click Next. DEM Solutions Page 3 of 12

4 4. Select empty project and Unselect Security Development Lifecycle (SDL) checks as below and click Finish DEM Solutions Page 4 of 12

$5. Add the Free_Body.cpp in C:\Dynamics Coupling\ to the source folder of your project.$

5 5. Add the Free_Body.cpp in C:\Dynamics Coupling\ to the source folder of your project. It is possible to just drag and drop the file from the window explorer into the Source File section in the Solution Explorer. 6. Ensure the project is configured to build a release version program using a 64 bit configuration. For users using Visual C++ Express Edition 2010 please refer to the 64 bits compiling guide on the forum. 7. Before building the MBD_Coupling program, ensure the project is configured to build correctly. Right click on the MBD_Coupling project, FreeBody in the solution explorer and click Properties: a. Set the correct Platform Toolset : i. For 32 and 64 bits All configurations b. Make sure that you have set All Configurations and All Platforms. c. Select Configuration Properties > C/C++ > General. Select Additional Include Directories > <Edit > DEM Solutions Page 5 of 12

$d. Add the following paths: i. C:\Program Files\DEM Solutions\EDEM 2.$ $6\src\Api\Core e. Click OK and click on on the bottom right corner 8.$

6 d. Add the following paths: i. C:\Program Files\DEM Solutions\EDEM 2.6\src\Api\Coupling ii. C:\Program Files\DEM Solutions\EDEM 2.6\src\Api\Core e. Click OK and click on on the bottom right corner 8. Next, select Configuration Properties > Linker > General DEM Solutions Page 6 of 12

$a. In the right-hand pane of the Property Pages update the Additional Include Directories to contain: i. C:\Program Files\DEM Solutions\EDEM 2.$

7 a. In the right-hand pane of the Property Pages update the Additional Include Directories to contain: i. C:\Program Files\DEM Solutions\EDEM 2.6\lib\ - All the Libraries are place in this folder, in versions EDEM b. Click on OK and click on on bottom right corner 9. Finally, select Configuration Properties > Linker > Input a. In the right-hand pane of the Property Pages update the Additional Dependencies to contain: i. libedemcouplingclientv2_2_0.lib DEM Solutions Page 7 of 12

8 b. Click on OK and click on on bottom right corner The project should now be configured to compile correctly. It can be built to create the executable DEM Solutions Page 8 of 12

Running Coupled Simulations The example simulation can be run by the compiled coupling code. To perform a coupled simulation with rigid body dynamics: 1.

dem deck 3. Ensure the simulation is set at time 0s 4. To prepare EDEM for a coupled simulation go to Tools > CFD Coupling Options > Show Coupling Server 5.

9 Running Coupled Simulations The example simulation can be run by the compiled coupling code. To perform a coupled simulation with rigid body dynamics: 1. The first version with MBD Coupling is Check latest version of the Coupling Interface installed in your EDEM installation. a. For using latest version of Coupling Interface load EDEM Load Free_Body.dem deck 3. Ensure the simulation is set at time 0s 4. To prepare EDEM for a coupled simulation go to Tools > CFD Coupling Options > Show Coupling Server 5. Click on the Start button in the Coupling Server widget to prepare EDEM for an incoming connection 6. Execute the example program (FreeBody.exe), remember that release version is faster than debug. Use Debug version to test your code and debugging. DEM Solutions Page 9 of 12

10 7. Watch the Coupling Server widget in EDEM change to a connected status and the console window 8. The coupling simulation will automatically start and run for the allotted simulation time and automatically complete 9. To stop the simulation at any time closes the command prompt that the example programs is running from or click at the coupling server in EDEM. DEM Solutions Page 10 of 12

Updated a Dynamic Coupling Code When the EDEM Coupling version is updated, new functions are implemented to improve usability, extend range of applications to increase robustness for Multi-physic

11 Updated a Dynamic Coupling Code When the EDEM Coupling version is updated, new functions are implemented to improve usability, extend range of applications to increase robustness for Multi-physic solutions. Still code from old versions of the coupling will be able to use in newer EDEM versions as the IEDEMCouplingV2_2_0.h and the associated libraries libedemcouplingcouplingv2_2_0.lib and libedemcouplingcouplingv2_2_0.dll are backward compatible with their V2_0_0 counterparts. As an example, look the old versions of FreeBody.cpp. The only change needed in this case is to set IEDEMCouplingV2_0_0.h to IEDEMCouplingV2_2_0.h Now follow the instructions for compiling but make sure that you refer to the EDEM 2.6 installation folders for the Additional Include Directories and point toward the correct library in the linker section, respectively step 7 and steps 8-9 of the Compile with Microsoft Visual C++ Express 2013: Library Location Library name Coupling Header file Version lib\ libedemcouplingclientv2_0_0.lib IEDEMCouplingV2_0_0.h lib\ libedemcouplingclientv2_1_0.lib IEDEMCouplingV2_1_0.h lib\ libedemcouplingclientv2_2_0.lib IEDEMCouplingV2_2_0.h DEM Solutions Page 11 of 12

For example if you have EDEM 64 bits and you are trying to compile in 32 bits, then the libedemcouplingclientv2_1_0.

12 Trouble shooting Linker Library directory is incorrectly set. Check the setting at the Linker > General > Additional Library Directories Linker Library is not in the appropriate version. For example if you have EDEM 64 bits and you are trying to compile in 32 bits, then the libedemcouplingclientv2_1_0.lib will be in 64 bits, giving you errors in the compiling. In that case you would need the library in 32bits from the EDEM 32 bits and point it in the correct path at the Linker > General > Additional Library Directory Wrong type of application selected. Go to Linker > System, make sure that Subsystem is set to Console. If not, set it and click Apply. DEM Solutions Page 12 of 12

Setting up a Project and Debugging with Visual Studio

Setting up a Project and Debugging with Visual Studio Contents Setup Visual Studio to compile a DLL ---------------------------------------------------------------- 1 Step 1: Install Visual Studio Express