# MBSimPhysics - XML Documentation

XML-Namespace: http://www.mbsim-env.de/MBSimPhysics

Contents

- 1 Introduction
- 2 Nomenclature
  - 2.1 Legend
  - 2.2 An element
  - 2.3 A choice of element
  - 2.4 A sequence of elements
  - 2.5 Nested sequences/choices
  - 2.6 Child Elements
- 3 Elements
  - <mbsim:FloatingFrameLink>
    - <Aerodynamics>
    - <Buoyancy>
    - <Drag>
  - <mbsim:Function>
    - <GravityFunction>
  - <mbsim:MechanicalLink>
    - <UniversalGravitation>
    - <Weight>
- 4 Simple Types

# 1 Introduction

In dem Modul MBSimPhysics sind physikalische Modelle, wie z.B. das Newtonsche Gravitationsgesetz, enthalten.

# 2 Nomenclature

## 2.1 Legend

Icon | Description
--- | ---
<element> | A XML element of name 'element'
attrName | A XML attribute of name 'attrName'
namespace | A XML namespace of name 'namespace'
type | A XML element or attribute type of name 'type'
required | A required XML attribute
0-2 | A occurance of XML elements or attributes

## 2.2 An element

<ElementName> 0-2 elementType
attrName1 required typeOfTheAttribute
attrName2 optional typeOfTheAttribute

Documentation of the element.

The upper nomenclature defines a XML element named ElementName with (if given) a minimal occurance of 0 and a maximal occurance of 2. The element is of type elementType.
A occurance of optional means 0-1.
The element has two attributes named attrName1 and attrName2 of type typeOfTheAttribute. A attribute can be optional or required.

## 2.3 A choice of element

- 1-2
- <ElemenetA>
- <ElemenetB>

The upper nomenclature defines a choice of elements. Only one element of the given ones can be used. The choice has, if given, a minimal occurance of 1 and a maximal maximal occurence of 2.
A occurance of optional means 0-1.

## 2.4 A sequence of elements

- 0-3
- <ElemenetA>
- <ElemenetB>

The upper nomenclature defines a sequence of elements. Each element must be given in that order. The sequence has, if given, a minimal occurance of 0 and a maximal maximal occurence of 3.
A occurance of optional means 0-1.

## 2.5 Nested sequences/choices

- 1-2
- <ElemenetA>
- - 0-3
  - <ElemenetC>
  - <ElemenetD>
- <ElemenetB>

Sequences and choices can be nested like above.

## 2.6 Child Elements

- 1-2
- <ParantElemenet>
  - - 0-3
    - <ChildElemenetA>
    - <ChildElemenetB>

A indent indicates child elements for a given element.

# 3 Elements

<mbsim:FloatingFrameLink>

This element is defined by the XML Schema (Project) with the namespace http://www.mbsim-env.de/MBSim, which is included by this XML Schema (Project). See the documentation of the included XML Schema (Project) for this element.

<Aerodynamics>
Object properties

Abstract Element: | false
Inherits: | <mbsim:FloatingFrameLink>
Inherited by: |
Attributes: |

Object documentation
Aerodynamische Kraft aus Luftwiderstand, Auftrieb und Seitenkraft.
Child Elements

- All Elements from <mbsim:FloatingFrameLink>
- - <densityFunction>
    Dichte des Mediums als Funktion der Höhe. Die Höhe ist der y-Abstand von Koordinatensystem 2 gegenüber 1 gemessen im Koordinatensystem 1.
    - - <mbsim:Function>
      - <pv:Embed>
  - <coefficientFunction>
    Dreidimensionaler Vektor als Funktion der Cardan-Winkel beta (erster Parameter) und gamma (zweiter Parameter). Die beiden Winkel beschreiben die Orientierung der Anströmgeschwindigkeit gegenüber dem Koordinatensystem 2. Die Elemente des Vektors bestehen aus dem Produkt des Strömungsbeiwerts (x,y und z) mit der zugehörigen Referenzfläche. In diesem Fall ist für referenceSurface für gewöhnlich 1 zu wählen. Der Strömungsbeiwert in x-Richtung entspricht dem Widerstandsbeiwert, der Strömungsbeiwert in y-Richtung dem Auftriebsbeiwert. Wenn vom Koordinatensystem 2 x Richtung Norden, z Richtung Osten und y Richtung Zenit zeigt dann entspricht -beta = Azimut und gamma = Elevation.
    - - <mbsim:Function>
      - <pv:Embed>
  - <referenceSurface> optional pv:areaScalar
    Referenzfläche. Der aerodynamische Kraftvektor (alle drei Komponenten) wird mit dieser Referenzfläche multipliziert. Wenn die Referenzfläche bereits in den Komponenten von coefficientFunction enthalten ist wird dieser Wert für gewöhnlich zu 1 definiert. 1 wenn nicht angegeben.
  - <windSpeed> optional pv:velocityVector
    Vektor der Windgeschwindigkeit, gemessen im Koordinatensystem 1. [0;0;0] wenn nicht angegeben.
  - <enableOpenMBV> optional
    Wenn angegeben, wird die aeordynamische Kraft durch einen Pfeil in OpenMBV visualisiert.

    <Aerodynamics name="VALUE" xmlns="http://www.mbsim-env.de/MBSimPhysics">
      <plotFeature xmlns="http://www.mbsim-env.de/MBSim"/>
      <plotAttribute name="VALUE" xmlns="http://www.mbsim-env.de/MBSim"/>
      <connect ref1="VALUE" ref2="VALUE" xmlns="http://www.mbsim-env.de/MBSim"/>
      <frameOfReference xmlns="http://www.mbsim-env.de/MBSim">VALUE</frameOfReference> <!-- optional -->
      <densityFunction>
        <Function xmlns="http://www.mbsim-env.de/MBSim"/> <!-- abstract -->
      </densityFunction>
      <coefficientFunction>
        <Function xmlns="http://www.mbsim-env.de/MBSim"/> <!-- abstract -->
      </coefficientFunction>
      <referenceSurface>VALUE</referenceSurface> <!-- optional -->
      <windSpeed>VALUE</windSpeed> <!-- optional -->
      <enableOpenMBV/> <!-- optional -->
    </Aerodynamics>

<Buoyancy>
Object properties

Abstract Element: | false
Inherits: | <mbsim:FloatingFrameLink>
Inherited by: |
Attributes: |

Object documentation
Auftrieb.
Child Elements

- All Elements from <mbsim:FloatingFrameLink>
- - <displacedVolume> pv:volumeScalar
    Verdrängtes Volumen.
  - <densityFunction>
    Dichte des Mediums als Funktion der Höhe. Die Höhe ist der y-Abstand von Koordinatensystem 2 gegenüber 1 gemessen im Koordinatensystem 1.
    - - <mbsim:Function>
      - <pv:Embed>
  - <gravityFunction>
    Definition des Schwerefelds als Funktion der Höhe. Die Höhe ist der y-Abstand von Koordinatensystem 2 gegenüber 1 gemessen im Koordinatensystem 1.
    - - <mbsim:Function>
      - <pv:Embed>
  - <enableOpenMBV> optional
    Wenn angegeben, wird die Auftriebskraft durch einen Pfeil in OpenMBV visualisiert.

    <Buoyancy name="VALUE" xmlns="http://www.mbsim-env.de/MBSimPhysics">
      <plotFeature xmlns="http://www.mbsim-env.de/MBSim"/>
      <plotAttribute name="VALUE" xmlns="http://www.mbsim-env.de/MBSim"/>
      <connect ref1="VALUE" ref2="VALUE" xmlns="http://www.mbsim-env.de/MBSim"/>
      <frameOfReference xmlns="http://www.mbsim-env.de/MBSim">VALUE</frameOfReference> <!-- optional -->
      <displacedVolume>VALUE</displacedVolume>
      <densityFunction>
        <Function xmlns="http://www.mbsim-env.de/MBSim"/> <!-- abstract -->
      </densityFunction>
      <gravityFunction>
        <Function xmlns="http://www.mbsim-env.de/MBSim"/> <!-- abstract -->
      </gravityFunction>
      <enableOpenMBV/> <!-- optional -->
    </Buoyancy>

<Drag>
Object properties

Abstract Element: | false
Inherits: | <mbsim:FloatingFrameLink>
Inherited by: |
Attributes: |

Object documentation
Reibungswiderstand.
Child Elements

- All Elements from <mbsim:FloatingFrameLink>
- - <dragFunction>
    Reibkraft als Funktion der Relativgeschwindigkeit von Koordinatensystem 2 gegenüber 1.
    - - <mbsim:Function>
      - <pv:Embed>
  - <enableOpenMBV> optional
    Wenn angegeben, wird die Reibungskraft durch einen Pfeil in OpenMBV visualisiert.

    <Drag name="VALUE" xmlns="http://www.mbsim-env.de/MBSimPhysics">
      <plotFeature xmlns="http://www.mbsim-env.de/MBSim"/>
      <plotAttribute name="VALUE" xmlns="http://www.mbsim-env.de/MBSim"/>
      <connect ref1="VALUE" ref2="VALUE" xmlns="http://www.mbsim-env.de/MBSim"/>
      <frameOfReference xmlns="http://www.mbsim-env.de/MBSim">VALUE</frameOfReference> <!-- optional -->
      <dragFunction>
        <Function xmlns="http://www.mbsim-env.de/MBSim"/> <!-- abstract -->
      </dragFunction>
      <enableOpenMBV/> <!-- optional -->
    </Drag>

<mbsim:Function>

This element is defined by the XML Schema (Project) with the namespace http://www.mbsim-env.de/MBSim, which is included by this XML Schema (Project). See the documentation of the included XML Schema (Project) for this element.

<GravityFunction>
Object properties

Abstract Element: | false
Inherits: | <mbsim:Function>
Inherited by: |
Attributes: |

Object documentation
Funktion des Schwerefelds in Abhängigkeit von der Höhe.
Child Elements

- All Elements from <mbsim:Function>
- - <standardGravity> optional pv:accelerationScalar
    Standardbeschleunigung \( g_0 \) . Standarmäßig die mittlere Erdbeschleunigung.
  - <meanRadius> optional pv:lengthScalar
    Mittlerer Radius des Körpers \( r \) . Standarmäßig der mittlere Erdradius.

    <GravityFunction name="VALUE" xmlns="http://www.mbsim-env.de/MBSimPhysics">
      <plotFeature xmlns="http://www.mbsim-env.de/MBSim"/>
      <plotAttribute name="VALUE" xmlns="http://www.mbsim-env.de/MBSim"/>
      <standardGravity>VALUE</standardGravity> <!-- optional -->
      <meanRadius>VALUE</meanRadius> <!-- optional -->
    </GravityFunction>

<mbsim:MechanicalLink>

This element is defined by the XML Schema (Project) with the namespace http://www.mbsim-env.de/MBSim, which is included by this XML Schema (Project). See the documentation of the included XML Schema (Project) for this element.

<UniversalGravitation>
Object properties

Abstract Element: | false
Inherits: | <mbsim:MechanicalLink>
Inherited by: |
Attributes: |

Object documentation
Gravitationskraft nach dem Newtonschen Gravitationsgesetz.
Child Elements

- All Elements from <mbsim:MechanicalLink>
- - <connect>
    ref1 required mbsim:ObjectReferenceType
    ref2 required mbsim:ObjectReferenceType
    Definition der beiden Körper, zwischen denen die Gravitationskraft wirken soll.
  - <gravitationalConstant> optional pv:unknownScalar
    Gravitationskonstante.
  - <enableOpenMBV> optional
    Wenn angegeben, wird die Gravitationskraft durch einen Pfeil in OpenMBV visualisiert.

    <UniversalGravitation name="VALUE" xmlns="http://www.mbsim-env.de/MBSimPhysics">
      <plotFeature xmlns="http://www.mbsim-env.de/MBSim"/>
      <plotAttribute name="VALUE" xmlns="http://www.mbsim-env.de/MBSim"/>
      <connect ref1="VALUE" ref2="VALUE"/>
      <gravitationalConstant>VALUE</gravitationalConstant> <!-- optional -->
      <enableOpenMBV/> <!-- optional -->
    </UniversalGravitation>

<Weight>
Object properties

Abstract Element: | false
Inherits: | <mbsim:MechanicalLink>
Inherited by: |
Attributes: |

Object documentation
Gewichtskraft.
Child Elements

- All Elements from <mbsim:MechanicalLink>
- - <connect>
    ref1 mbsim:FrameReferenceType
    ref2 required mbsim:ObjectReferenceType
    Definition des Bezugssystems und des Körpers, auf den die Gewichtskraft wirken soll. Das Bezugssystem ist standarmäßig das übergeordente I-System.
  - <gravityFunction>
    Definition des Schwerefelds als Funktion der Höhe. Die Höhe ist der y-Abstand des Körpers gegenüber dem Bezugssystem gemessen im Koordinatensystem im Bezugssystem.
    - - <mbsim:Function>
      - <pv:Embed>
  - <enableOpenMBV> optional
    Wenn angegeben, wird die Gewichtskraft durch einen Pfeil in OpenMBV visualisiert.

    <Weight name="VALUE" xmlns="http://www.mbsim-env.de/MBSimPhysics">
      <plotFeature xmlns="http://www.mbsim-env.de/MBSim"/>
      <plotAttribute name="VALUE" xmlns="http://www.mbsim-env.de/MBSim"/>
      <connect ref1="VALUE" ref2="VALUE"/>
      <gravityFunction>
        <Function xmlns="http://www.mbsim-env.de/MBSim"/> <!-- abstract -->
      </gravityFunction>
      <enableOpenMBV/> <!-- optional -->
    </Weight>

# 4 Simple Types

Generated with MBXMLUtils on 2024-09-12T00:00:41Z