MpC

CI4

.3.0

MpCCI

I Overview

MpCCI 4.3.0-2 DocumentationPart I OverviewPDF versionSeptember 3, 2013

MpCCI is a registered trademark of Fraunhofer SCAIwww.mpcci.de

Fraunhofer Institute for Algorithms and Scientific Computing SCAISchloss Birlinghoven, 53754 Sankt Augustin, Germany

Abaqus and SIMULIA are trademarks or registered trademarks of Dassault Syste`mesANSYS, FLUENT and ANSYS Icepak are trademarks or registered trademarks of Ansys, Inc.Elmer is an open source software developed by CSCFINE/Hexa, FINE/Open and FINE/Turbo are trademarks of NUMECA InternationalFlowmaster is a registered trademark of Flowmaster Group NVFLUX is a registered trademark of Cedrat of Grenoble, FranceJMAG is a registered trademark of The JSOL CorporationMATLAB is a registered trademark of The MathWorks, Inc.MSC Adams, MSC.Marc, MD NASTRAN and MSC NASTRAN are trademarks or registered trademarks ofMSC.Software CorporationOpenFOAM is a registered trademark of SGI Corp.PERMAS is a registered trademark of Intes GmbHRadTherm is a registered trademark of ThermoAnalytics Inc.STAR-CCM+ and STAR-CD are registered trademarks of CD adapco Group

ActivePerl has a Community License Copyright of Active State Corp.FlexNet Publisher is a registered trademark of Flexera Software.Java is a registered trademark of Oracle and/or its affiliates.Linux is a registered trademark of Linus TorvaldsMac OS X is a registered trademark of Apple Inc.OpenSSH has a copyright by Tatu Ylonen, Espoo, FinlandPerl has a copyright by Larry Wall and othersUNIX is a registered trademark of The Open GroupWindows, Windows XP, Windows Vista and Windows 7 are registered trademarks of Microsoft Corp.

I Overview Contents

I Overview Contents

Preface 4

Typographical Conventions 6

Contents of all MpCCI Manuals 26

MpCCI 4.3.0-2 I 3

Preface I Overview

Preface

MpCCI Coupling-Environment is the standard for simulation code coupling.In this manual MpCCI will be used as abbreviation for MpCCI Coupling-Environment.

MpCCI has been developed at the Fraunhofer Institute SCAI in order to provide an application independentinterface for the coupling of different simulation codes.

Codes Supported by MpCCI

MpCCI enables a direct communication between the coupled codes by providing adapters for a growingnumber of commercial codes. These code adapters make use of the already existing application program-ming interfaces (APIs) of the simulation tools. This technique allows for an easy installation of MpCCI atthe end users site without changing the standard installation of the simulation codes.

A list of currently supported codes is given in the Release Notes.

Internal Architecture

The MpCCI environment consists of several components:

MpCCI Code Adapter allow to adapt MpCCI to commercial codes through their standard code APIswithout any changes in the source of the simulation code.

The MpCCI Graphical User Interface provides a comfortable way to define the coupling setup and tostart the simulation - independent of the codes involved in the coupled application.

The MpCCI Coupling Server is the heart of the MpCCI system. Environment handling, communi-cation between the codes, neighborhood computation and interpolation are part of this kernel.

Standardized Quantities

One major advantage of having compatible code adapters for all codes supported by MpCCI is the standard-ization of coupling parameters and procedures independent from the used code pairing. MpCCI providesunified quantity definitions for

Global quantities: time, iteration, residuals Mass source and sink: production species Momentum sources: e. g. Lorentz forces Energy sources: e. g. joule heat Material properties: e. g. electrical conductivity Boundary condition values: e. g. temperature or pressure Boundary condition gradients: e. g. heat flux density Grid data: nodal positions or displacements And chemical components: e. g. for reaction kinetics

4 I MpCCI 4.3.0-2

I Overview Preface

MpCCI Manuals

The MpCCI documentation is split up into several manuals which are also called parts. Each part aims ata special kind of readers.

Release Notes The Release Notes contain information on changes versus prior versions of MpCCI. Theyare thus interesting for users, who have some experience with earlier versions of MpCCI.

Installation Guide The Installation Guide describes how to install MpCCI. It also contains informationabout the licensing.

Getting Started is intended for new users of MpCCI. The most important features of MpCCI are describedby following a typical setup of a coupled simulation.

User Manual The User Manual contains a complete overview of the functions and features of MpCCI. Thisincludes information on code coupling, command line options and functions of the MpCCI GUI.

Codes Manual The Codes Manual contains code-specific information. For each code which can be coupledwith MpCCI a section is included.

Tutorial is a collection of examples which are explained in detail.

Programmers Guide The Programmers Guide is intended for users who want to write their own codeadapters.

How To is a collection of best practice cases.

FSIMapper The FSIMapper Guide is intended for users who want to transfer quantity values from theCFD to the FEM mesh as one-way file based coupling.

MpCCI 4.3.0-2 I 5

Typographical Conventions I Overview

Typographical Conventions

This manual adheres to a set of typographical conventions so that you can recognize actions and items.The following list illustrates each of the conventions:

Text you enter from the keyboard or outputs is written in a typewriter font and surrounded by agray box, e. g. : mpcci gui

Filenames are enclosed in quotation marks, "example.txt". All paths are given with a slash (/)as directory separator, e. g. "mpcci/doc/pdf". On Windows systems this must be replaced by abackslash (\).

Meta variables represent values and are enclosed in angle brackets as in . They canappear everywhere and always should be replaced by appropriate values.

Environment variables are always written in uppercase typewriter letters, like VARIABLE. Buttons in the MpCCI GUI look like buttons, e. g. Next . Entries of the menu have a colored background, sub-menus are separated by an arrow. E. g.

FileOpen Project means the submenu Open Project of the File menu. Other options which can be selected are written like Option. Names of software are written in a sans-serif font, like MpCCI. Links can be clicked directly in the PDF version of the manual and are marked blue there, this

applies to links within the manual like . IV-2 Setting up a Coupled Simulation / or to web pageswww.mpcci.de.

6 I MpCCI 4.3.0-2

I Overview Contents of all MpCCI Manuals

Contents of all MpCCI Manuals

I Overview 1

Preface 4

Typographical Conventions 6

Contents of all MpCCI Manuals 26

II Release Notes 1

1 Introduction MpCCI 4.3 6

2 Changes and New Features in MpCCI 4.3.0-2 72.1 MpCCI Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.2 New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.2.1 Iterative Coupling for Fluid-Structure Interactions . . . . . . . . . . . . . . . . . . . . . . . 72.2.2 Non-matching time steps and coupling setup . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.2.3 Support of new codes MSC Adams and MATLAB . . . . . . . . . . . . . . . . . . . . . . . . . 82.2.4 MpCCI Visualizer and MpCCI Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.2.5 FSIMapper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92.3 Further Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92.3.1 Coupling Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92.3.2 MpCCI API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.3.3 MpCCI Grid Morpher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.3.4 MpCCI Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.3.5 MpCCI Visualizer and MpCCI Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112.3.6 MpCCI GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112.3.7 Code Specific Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

3 Changes and New Features in the Earlier Releases 153.1 MpCCI 4.2.1-2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153.1.1 MpCCI GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153.1.2 Code Specific Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153.2 MpCCI 4.2.1-1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153.2.1 Code Specific Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153.3 MpCCI 4.2.0-1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163.3.1 MpCCI Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163.3.2 New FSIMapper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173.3.3 Coupling Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173.3.4 MpCCI API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183.3.5 MpCCI Grid Morpher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183.3.6 MpCCI Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183.3.7 MpCCI Visualizer and MpCCI Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193.3.8 Batch System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193.3.9 MpCCI GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193.3.10 Code Specific Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193.4 MpCCI 4.1.1-2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243.4.1 MpCCI Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

MpCCI 4.3.0-2 I 7

Contents of all MpCCI Manuals I Overview

3.4.2 Code Specific Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243.5 MpCCI 4.1.1-1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253.5.1 Coupling Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253.5.2 MpCCI Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253.5.3 MpCCI Visualizer and MpCCI Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253.5.4 Batch System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253.5.5 Code Specific Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253.6 MpCCI 4.1.0-2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263.6.1 Coupling Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263.6.2 MpCCI Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263.6.3 MpCCI GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263.6.4 Code Specific Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263.7 MpCCI 4.1.0-1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273.7.1 MpCCI Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273.7.2 MpCCI Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273.7.3 Coupling Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283.7.4 MpCCI API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283.7.5 MpCCI Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283.7.6 MpCCI Visualizer and MpCCI Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283.7.7 Batch System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283.7.8 MpCCI GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293.7.9 Code Specific Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293.8 MpCCI 4.0.1-4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313.8.1 Code Specific Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313.9 MpCCI 4.0.1-3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313.9.1 Coupling Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313.9.2 MpCCI Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323.9.3 Code Specific Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323.10 MpCCI 4.0.1-2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333.10.1 MpCCI Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333.10.2 Code Specific Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333.11 MpCCI 4.0.1-1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333.11.1 Coupling Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333.11.2 MpCCI Visualizer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343.11.3 Batch System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343.11.4 MpCCI GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343.11.5 Code Specific Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343.12 MpCCI 4.0.0-1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353.12.1 Coupling Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353.12.2 MpCCI Visualizer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353.12.3 Batch System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363.12.4 MpCCI GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363.12.5 Code Specific Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363.13 MpCCI 4.0.0-0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363.13.1 Installation, Configuration and Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363.13.2 Coupling Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373.13.3 MpCCI Visualizer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373.13.4 MpCCI GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383.13.5 Code Specific Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

4 Prerequisites for MpCCI Installation 40

8 I MpCCI 4.3.0-2

I Overview Contents of all MpCCI Manuals

5 Supported Platforms in MpCCI 4.3 415.1 Platforms Supported by the MpCCI 4.3 Server . . . . . . . . . . . . . . . . . . . . . . . . . . 415.2 Codes Supported by MpCCI 4.3 on Different Platforms . . . . . . . . . . . . . . . . . . . . . 42

6 Known Bugs and Limitations in MpCCI 4.3 446.1 MpCCI Visualizer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446.2 Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

III Installation Guide 1

1 Installation Overview 5

2 Before the Installation 72.1 Downloading MpCCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.2 Where to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.3 The Perl Interpreter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92.4 The Java Runtime Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.5 OpenSSH for Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.6 MpCCI-RSH for Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3 Installation of the MpCCI Software 123.1 Multi-platform for UNIX, Linux and Microsoft Windows . . . . . . . . . . . . . . . . . . . . . 123.2 Local Microsoft Windows Installation with the MSI . . . . . . . . . . . . . . . . . . . . . . . 13

4 Immediately After the Installation - Quick Installation Tests without a License 154.1 Your Home Directory under Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . 154.2 Testing the MpCCI Working Environment and Perl . . . . . . . . . . . . . . . . . . . . . . . 154.3 Testing whether MpCCI Finds Your Simulation Codes . . . . . . . . . . . . . . . . . . . . . . 16

5 Licensing 185.1 Request for a License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185.2 Installing and Activating a License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195.2.1 Configure a License Manager as UNIX service . . . . . . . . . . . . . . . . . . . . . . . . . . 195.2.2 Configure a License Manager as Windows service . . . . . . . . . . . . . . . . . . . . . . . . . 205.3 Defining the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225.4 Multiple License Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235.5 Testing the License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

6 Configuring the MpCCI Users Environment 256.1 Accessing Remote Hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256.2 Configuring MpCCI via Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 26

7 Testing the MpCCI Installation and Communication 28

8 Troubleshooting 298.1 Secure shell in general . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298.2 OpenSSH under Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298.3 rsh, rcp and rlogin under Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

9 Installing Perl 33

10 Installing Java 35

MpCCI 4.3.0-2 I 9

Contents of all MpCCI Manuals I Overview

IV Getting Started 1

1 Multi-Physics Computation with MpCCI 41.1 Multi-Physics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.2 Solution of Coupled Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.3 Code Coupling with MpCCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2 Setting up a Coupled Simulation 72.1 A Simple Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.2 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.2.1 CFD Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.2.2 FE Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.3 Starting the MpCCI GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92.4 Models Step Choosing Codes and Model Files . . . . . . . . . . . . . . . . . . . . . . . . . 92.5 Coupling Step Definition of Coupling Regions and Quantities . . . . . . . . . . . . . . . . 112.5.1 Define Coupling Regions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.5.2 Select the Components for each Interconnected Code . . . . . . . . . . . . . . . . . . . . . . 132.5.3 Specify the Quantities which will be Exchanged . . . . . . . . . . . . . . . . . . . . . . . . . 132.6 Monitors Step Definition of Quantities for Monitoring . . . . . . . . . . . . . . . . . . . . 142.7 Edit Step Further Coupling Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142.8 Go Step Starting Server and Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.8.1 Configuring the Initial Exchange Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.8.2 Setting Option Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.8.3 Starting the Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182.8.4 Interrupting the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

3 Checking the Results 243.1 The MpCCI Visualizer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243.2 Post-Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

V User Manual 1

1 Introduction 71.1 Basic Structure of MpCCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2 The MpCCI Software Package 92.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92.2 The MpCCI Home Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.3 Environment and Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112.3.1 MPCCI ARCH - Architecture Tokens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.3.2 MPCCI DEBUG - for Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132.3.3 MPCCI TINFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132.4 MpCCI Project and Output Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.4.1 MpCCI Project Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.4.2 MpCCI Server Input Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.4.3 Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.4.4 Tracefile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.5 The MpCCI Resource Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162.6 Temporary Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.7 Third Party Software Used by MpCCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192.7.1 Perl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192.7.2 Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

10 I MpCCI 4.3.0-2

I Overview Contents of all MpCCI Manuals

2.7.3 Remote Shell and Remote Copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

3 Code Coupling 203.1 Multi-Physics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203.1.1 Physical Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203.1.2 Coupling Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213.2 Mesh Checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223.2.1 Mesh Motion Checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233.2.2 Bounding Box Checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233.2.3 Domain Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243.2.4 Slave Node Mark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263.3 Data Exchange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263.3.1 Association . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273.3.2 Interpolation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293.3.3 Handling of Coupled Quantities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323.4 Coupling Algorithms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383.4.1 Course of the Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383.4.2 Stationary Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393.4.3 Transient Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403.4.4 Iterative Coupling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463.4.5 Exchange of Time Step Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503.4.6 Subcycling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503.4.7 Non-matching Time Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523.4.8 Restarting a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553.5 Running MpCCI in a Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563.5.1 Client-Server Structure of MpCCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563.5.2 Hostlist Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573.5.3 Remote Shell and Remote Copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583.6 Coupled Analysis in Batch Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583.6.1 General Approach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583.6.2 Job Scheduler Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

4 Graphical User Interface 744.1 Starting and Exiting MpCCI GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744.1.1 Starting MpCCI GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744.1.2 Exiting MpCCI GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754.2 MpCCI GUI Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754.2.1 File Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764.2.2 Batch Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764.2.3 License Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 774.2.4 Tools Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784.2.5 Preferences Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784.2.6 Codes Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784.2.7 Help Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794.3 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794.3.1 Code Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794.3.2 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794.3.3 Changing the Model - Implications for the Setup . . . . . . . . . . . . . . . . . . . . . . . . 804.4 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 814.4.1 Coupling Components with Different Dimensions . . . . . . . . . . . . . . . . . . . . . . . . 814.4.2 Copying Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 814.4.3 Editing Component Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

MpCCI 4.3.0-2 I 11

Contents of all MpCCI Manuals I Overview

4.4.4 Generate Regions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824.4.5 Options Part . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 834.4.6 Global Quantity Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 834.4.7 Specific Quantity Properties for sender, receiver . . . . . . . . . . . . . . . . . . . . . . . . . 834.4.8 Quantity Sender . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844.4.9 Predefined Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844.4.10 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 874.5 Monitors Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 874.6 Edit Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 884.6.1 Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 894.6.2 Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 914.6.3 Relation Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 934.6.4 Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 934.7 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 964.7.1 Configuring the MpCCI Coupling Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 964.7.2 Coupling Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 984.8 Remote File Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 994.8.1 File Browser Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 994.8.2 How to mount a new file system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

5 Command Line Interface 1025.1 Using the Command Line Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1025.2 Overview of All Subcommands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1035.3 Starting MpCCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1055.3.1 mpcci fsimapper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1065.3.2 mpcci gui . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1075.3.3 mpcci morpher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1085.3.4 mpcci observe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1115.3.5 mpcci visualize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1125.3.6 mpcci monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1135.3.7 mpcci ccvxcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1145.3.8 mpcci xterm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1155.4 Information and Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1165.4.1 mpcci arch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1175.4.2 mpcci doc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1185.4.3 mpcci info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1195.4.4 mpcci env . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1215.4.5 mpcci home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1225.4.6 mpcci where . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1235.5 Installation and Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1245.5.1 mpcci license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1255.5.2 mpcci list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1265.5.3 mpcci lmutil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1275.5.4 mpcci ssh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1285.5.5 mpcci test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1295.5.6 mpcci update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1325.6 Job Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1335.6.1 mpcci backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1345.6.2 mpcci batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1355.6.3 mpcci batch LSF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1375.6.4 mpcci batch PBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1385.6.5 mpcci batch N1GE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

12 I MpCCI 4.3.0-2

I Overview Contents of all MpCCI Manuals

5.6.6 mpcci batch LoadLeveler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1405.6.7 mpcci batch GLOBUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1415.6.8 mpcci clean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1425.6.9 mpcci kill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1435.6.10 mpcci ps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1455.6.11 mpcci ptoj . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1465.6.12 mpcci server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1475.6.13 mpcci top . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

6 MpCCI Visualizer 1526.1 Using the MpCCI Visualizer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1526.1.1 Data Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1526.1.2 Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1526.1.3 Starting the Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1536.1.4 Starting the Visualizer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1536.2 MpCCI Visualizer for .ccvx and online monitoring . . . . . . . . . . . . . . . . . . . . . . . . . 1536.2.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1536.2.2 Main Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1546.2.3 Menus and Toolbars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1546.2.4 Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1596.2.5 Viewport Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1656.2.6 Preferences Viewer Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1686.2.7 Preferences Server Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1706.2.8 Store Animated Files Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1706.2.9 Error Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1726.2.10 Command Line Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1736.3 Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

7 MpCCI Grid Morpher 1757.1 Using the MpCCI Grid Morpher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1757.1.1 Options description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

VI Codes Manual 1

1 Overview 121.1 Common MpCCI Subcommands for Simulation Codes . . . . . . . . . . . . . . . . . . . . . . 131.2 Unit Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

2 Abaqus 162.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182.2.2 Restart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182.2.3 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182.2.4 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192.2.5 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

MpCCI 4.3.0-2 I 13

Contents of all MpCCI Manuals I Overview

2.2.6 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222.2.7 Post-Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242.4 Code Adapter Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252.4.1 Patched Input File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252.4.2 Update Code Adapter Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252.5 Co-Simulation Restart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

3 ANSYS 283.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283.1.6 Supported ANSYS product variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313.2.2 APDL Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353.2.3 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393.2.4 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393.2.5 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423.2.6 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433.4 Code Adapter Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443.5 Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

4 ANSYS Icepak 474.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474.1.1 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474.1.2 Supported Quantities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474.2 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

5 FINE/Hexa 505.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515.4 Code Adapter Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525.5 Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

6 FINE/Open 536.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

14 I MpCCI 4.3.0-2

I Overview Contents of all MpCCI Manuals

6.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546.2.2 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546.2.3 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556.2.4 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556.2.5 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576.2.6 Post-Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596.4 Code Adapter Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606.5 Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

7 FINE/Turbo 617.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627.2.2 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637.2.3 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647.2.4 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647.2.5 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657.2.6 Post-Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

8 Flowmaster 688.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698.2.2 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718.2.3 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718.2.4 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738.4 Code Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748.5 Trouble Shooting, Open Issues and Known Bugs . . . . . . . . . . . . . . . . . . . . . . . . . 75

9 FLUENT 769.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 779.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 779.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 779.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

MpCCI 4.3.0-2 I 15

Contents of all MpCCI Manuals I Overview

9.2.2 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 799.2.3 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 799.2.4 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 819.2.5 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 829.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 869.4 Code Adapter Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 879.4.1 The MpCCI UDF Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 879.4.2 UDF-Hooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 889.5 Trouble shooting, open issues and known bugs . . . . . . . . . . . . . . . . . . . . . . . . . . 919.6 Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

10 FLUX 9310.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9310.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9310.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9310.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9310.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9310.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9310.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9410.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9410.2.2 pyFlux Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9510.2.3 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9810.2.4 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9810.2.5 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10010.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10110.4 Code Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

11 JMAG 10311.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10311.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10311.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10311.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10311.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10311.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10311.1.6 Supported JMAG Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10411.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10411.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10411.2.2 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10711.2.3 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10711.2.4 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10811.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10811.4 Code Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

12 MATLAB 11012.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11012.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11012.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11012.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11012.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11012.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11012.1.6 Supported MATLAB Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11112.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

16 I MpCCI 4.3.0-2

I Overview Contents of all MpCCI Manuals

12.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11112.2.2 MpCCI MEX Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11312.2.3 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11712.2.4 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11712.2.5 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11912.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11912.4 Code Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

13 MD NASTRAN 12113.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12113.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12113.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12113.1.3 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12113.1.4 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12113.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12213.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12213.2.2 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12313.2.3 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12413.2.4 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12413.2.5 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12513.2.6 Post-Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12613.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12713.4 Code Adapter Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12713.5 Trouble Shooting, Open Issues and Known Bugs . . . . . . . . . . . . . . . . . . . . . . . . . 128

14 MSC Adams 12914.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12914.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12914.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12914.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12914.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12914.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12914.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13014.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13014.2.2 Dynamic or Kinematic Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13014.2.3 Static Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13114.2.4 Multiple Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13114.2.5 Iterative Coupling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13114.2.6 MSC Adams Template Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13114.2.7 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13114.2.8 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13314.2.9 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13414.2.10 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13714.2.11 Post-Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13714.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13814.4 Code Adapter Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13914.4.1 Patched Input File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

MpCCI 4.3.0-2 I 17

Contents of all MpCCI Manuals I Overview

15 MSC.Marc 14115.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14115.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14115.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14115.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14115.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14115.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14215.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14315.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14315.2.2 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14315.2.3 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14415.2.4 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14415.2.5 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14515.2.6 Post-Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14615.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

16 OpenFOAM 14816.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14816.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14816.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14816.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14816.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14816.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14816.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14916.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14916.2.2 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15116.2.3 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15116.2.4 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15216.2.5 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15316.2.6 Post-Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15416.3 Grid Morphing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15416.3.1 MpCCI Grid Morpher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15416.3.2 OpenFOAM Grid Morpher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15516.4 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15716.5 Code Adapter Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

17 RadTherm 15917.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15917.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15917.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15917.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15917.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15917.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15917.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16017.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16017.2.2 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16017.2.3 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16117.2.4 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16117.2.5 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16217.2.6 Post-Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16517.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16517.4 Code Adapter Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

18 I MpCCI 4.3.0-2

I Overview Contents of all MpCCI Manuals

18 STAR-CCM+ 16718.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16718.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16718.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16718.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16718.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16718.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16818.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16818.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16818.2.2 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16918.2.3 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16918.2.4 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17018.2.5 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17218.2.6 Post-Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17518.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17618.4 Grid Morphing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17618.5 Code Adapter Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17718.5.1 Java Macro Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17718.6 Trouble Shooting, Open Issues and Known Bugs . . . . . . . . . . . . . . . . . . . . . . . . . 191

19 STAR-CD 19219.1 Quick Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19219.1.1 Supported Coupling Schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19219.1.2 Supported Platforms and Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19219.1.3 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19319.1.4 Adapter Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19319.1.5 Prerequisites for a Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19319.2 Coupling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19319.2.1 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19319.2.2 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19519.2.3 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19619.2.4 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19819.2.5 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20019.2.6 Post-Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20019.3 Code-Specific MpCCI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20119.4 Grid Morphing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20219.4.1 MpCCI Grid Morpher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20219.4.2 Restart with MpCCI Grid Morpher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20319.4.3 pro-STAR Grid Morpher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20419.5 Code Adapter Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20719.5.1 STAR-CD 4.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20719.5.2 Automatic Model Preparation STAR-CD 4.x . . . . . . . . . . . . . . . . . . . . . . . . . . . 20719.6 Trouble Shooting, Open Issues and Known Bugs . . . . . . . . . . . . . . . . . . . . . . . . . 209

VII Tutorial 1

1 Introduction 7

MpCCI 4.3.0-2 I 19

Contents of all MpCCI Manuals I Overview

2 Vortex-Induced Vibration of a Thin-Walled Structure 92.1 Problem Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92.2 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92.2.1 Fluid Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.2.2 Solid Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112.3 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112.4 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162.5 Monitors Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.6 Edit Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.7 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.8 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232.9 Discussion of Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

3 Elastic Flap in a Duct 293.1 Problem Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293.2 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293.2.1 Solid Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293.2.2 Fluid Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313.3 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323.4 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373.5 Monitors Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403.6 Edit Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403.7 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413.8 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523.8.1 Starting the Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523.8.2 End of the Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533.9 Discussion of Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

4 Elastic Flap in Water 564.1 Problem Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564.2 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564.2.1 Solid Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564.2.2 Fluid Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574.3 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584.4 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594.5 Monitors Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614.6 Edit Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614.7 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624.8 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644.9 Discussion of Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

5 Exhaust Manifold 685.1 Problem Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685.2 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695.2.1 Solid Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695.2.2 Fluid Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 705.2.3 Uncoupled Flow Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 715.2.4 Prepare Models for Coupled Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 715.3 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725.4 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755.5 Monitors Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765.6 Edit Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

20 I MpCCI 4.3.0-2

I Overview Contents of all MpCCI Manuals

5.7 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765.8 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 835.9 Post-processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

6 Busbar System 866.1 Problem Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 866.2 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 876.2.1 Fluid Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 876.2.2 Electromagnetic Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 876.3 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 886.4 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 916.5 Monitors Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 946.6 Edit Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 946.7 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 946.8 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 986.9 Discussion of Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

7 Pipe Nozzle 1017.1 Problem Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1017.2 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1017.2.1 Fluid Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1027.2.2 Solid Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1047.3 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1047.4 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1077.5 Monitors Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1087.6 Edit Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1087.7 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1087.8 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1137.9 Discussion of Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

8 Cube in a Duct Heater 1168.1 Problem Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1168.2 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1168.2.1 Radiation Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1178.2.2 Fluid Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1178.3 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1188.4 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1208.5 Monitors Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1228.6 Edit Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1228.7 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1228.8 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1268.8.1 Starting the Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1268.8.2 End of the Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1278.9 Discussion of Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

9 Y-Junction 1319.1 Problem Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1319.2 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1319.2.1 Network Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1329.2.2 Fluid Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1359.3 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1379.4 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

MpCCI 4.3.0-2 I 21

Contents of all MpCCI Manuals I Overview

9.5 Monitors Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1439.6 Edit Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1439.7 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1449.8 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1489.8.1 Starting the Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1489.9 Discussion of Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

10 Spring Mass System 15410.1 Problem Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15410.2 Model Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15410.2.1 Model Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15410.2.2 Model A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15510.2.3 Model B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15610.3 Models Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15810.4 Coupling Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16010.5 Monitors Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16510.6 Edit Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16510.7 Go Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16510.7.1 Iterative Coupling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16510.7.2 Explicit Coupling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16910.8 Running the Computation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17110.8.1 Starting the Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17110.9 Discussion of Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17110.9.1 Iterative Coupling compared to Explicit Coupling . . . . . . . . . . . . . . . . . . . . . . . . 17110.9.2 Non-matching Time Step Sizes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

VIII Programmers Guide 1

1 Introduction 6

2 MpCCI API 72.1 Code Integration and Simulation Code Requirements . . . . . . . . . . . . . . . . . . . . . . 82.1.1 Data Exchange and Data Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.1.2 MpCCI Interface for Code Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92.2 Code Integration with the MpCCI API Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.2.1 A Simple Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.2.2 Step-by-Step Procedure for Code Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . 132.2.3 Code Coupling with the Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222.3 Code Configuration Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242.4 MpCCI GUI Configuration File gui.xcf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252.4.1 Code Information: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252.4.2 Codes Menu: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252.4.3 Models Step: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262.4.4 Component Types: . . . . . . . . . . . . . . . . . . . . . . . . 272.4.5 List of quantities: . . . . . . . . . . . . . . . . . . . . . . . . . . . 272.4.6 Go Step: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292.4.7 Environments for Scanner, Starter, Stopper and Killer . . . . . . . . . . . . . . . . . . . . . 302.4.8 General MpCCI GUI Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312.4.9 Testing gui.xcf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362.5 Perl Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372.5.1 Using Information from gui.xcf in Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

22 I MpCCI 4.3.0-2

I Overview Contents of all MpCCI Manuals

2.5.2 Scanner.pm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372.5.3 Starter.pm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382.5.4 Stopper.pm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392.5.5 Info.pm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392.5.6 Subcmd.pm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402.5.7 Testing the Perl Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402.6 MpCCI Adapter Implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412.6.1 How to Initialize the Code? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412.6.2 How to Define the Mesh? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422.6.3 How to Transfer Data? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432.6.4 How to Terminate the Coupling? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442.6.5 How to Notify a Remeshing? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442.7 MpCCI Coupling Manager Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452.7.1 Definition of Output Functions: umpcci msg functs . . . . . . . . . . . . . . . . . . . . . . 462.7.2 Definition of Output Prefix: umpcci msg prefix . . . . . . . . . . . . . . . . . . . . . . . . . 472.7.3 Get Transfer Information: ampcci tinfo init . . . . . . . . . . . . . . . . . . . . . . . . . . 482.7.4 Connect and Initialize an MpCCI Server: mpcci init . . . . . . . . . . . . . . . . . . . . . . 492.7.5 Configure the Code Adapter: ampcci config . . . . . . . . . . . . . . . . . . . . . . . . . . 502.7.6 Definition of Part: smpcci defp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512.7.7 Delete a Part: smpcci delp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532.7.8 Definition of Nodes: smpcci pnod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542.7.9 Definition of Elements: smpcci pels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552.7.10 Definition of the Moving Reference Frame: smpcci pmot . . . . . . . . . . . . . . . . . . . . 572.7.11 Definition of the Bae thickness: smpcci pshf . . . . . . . . . . . . . . . . . . . . . . . . . 582.7.12 Data Exchange: ampcci transfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592.7.13 Notifying the Remeshing: ampcci remesh . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612.7.14 End of Coupled Simulation: mpcci quit and mpcci stop . . . . . . . . . . . . . . . . . . . . 622.8 MpCCI Driver Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632.8.1 Description Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 662.8.2 Driver Methods Called before/after some Action . . . . . . . . . . . . . . . . . . . . . . . . . 672.8.3 Driver Mesh Definition Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692.8.4 Driver Data Exchange Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712.9 Data Structures and Predefined Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722.9.1 Supported Element Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722.9.2 Coordinates System Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 802.9.3 Mesh Dimension Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 812.9.4 Moving Reference Frame Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 812.9.5 Remesh Flag Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822.9.6 Transfer Information: MPCCI TINFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822.9.7 Code Specific Information: MPCCI CINFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 872.9.8 Coupling Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 892.9.9 Quantities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 902.9.10 Loop Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 912.9.11 Memory Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

3 Updating MpCCI 3 Code Adapter to MpCCI 4 943.1 MpCCI Coupling Manager Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 943.1.1 Definition of Output Functions: MpCCI Message init . . . . . . . . . . . . . . . . . . . . . . 943.1.2 Initialization: MpCCI Init . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 943.1.3 Get Initial Exchange Mode: MpCCI Get init actions . . . . . . . . . . . . . . . . . . . . . 943.1.4 Data Exchange: MpCCI Transfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 943.1.5 Data Exchange: MpCCI Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

MpCCI 4.3.0-2 I 23

Contents of all MpCCI Manuals I Overview

3.1.6 Definition of Nodes: MpCCI Def nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 953.1.7 Definition of Elements: MpCCI Def elems .