User`s guide

Release 7.5 MADYMO Coupling Manual

2 Interface Version

2.1 Introduction

With the introduction of MADYMO 6.3.1, a coupling interface is used. This interface has new

features, yet provides full backwards compatibility to enable seamless integration with older

PARTNER executables that do not have this interface build-in.

2.2 Features of the 6.3.1 interface and onwards

The interface provides two features:

Automatic Kinematic Output Scaling MADYMO can scale its kinematic output to the length

units of the PARTNER. To enable this, set the AUTO_SCALE_ANI keyword under COU-

PLING to "ON". The default behaviour is "OFF", to enable backwards compatibility.

Communication of failure exit to PARTNER codes MADYMO sends an error termination ﬂag

to the PARTNER code, such that it can write an abnormal termination message to the

screen. Also, the PARTNER code can send such a ﬂag to MADYMO, causing MADYMO

to write an abnormal termination message to the log and reprint ﬁle.

For both features applies that the PARTNER executable must support this, meaning that they

must also use the interface.

2.2.1 Identiﬁng the Interface

When MADYMO notices that the PARTNER executable is using an older interface, MADYMO

will not use these features and fall back on a version that the PARTNER software does support.

In this way, the largest common version of the interface is used. This version is the

effective

interface version

. The reprint ﬁle reﬂects this version under the — COUPLING INTERFACE

— section.

When this

effective interface version

is not reﬂected in the reprint ﬁle, an older version of MA-

DYMO (version 6.3 or earlier) is used. These versions are always build with interface version

0, and therefore do not have the abovementioned improvements.

2.3 Interface History

This section reﬂects what MADYMO releases are build with which interface versions, newest

ﬁrst. For a detailed list of supported and tested platforms, consult the MADYMO public down-

load area at