Karlsruhe Institute of Technology (KIT) Logo

Master Motor Map

Whole-body human reference model and tools for unifying representations of whole-body human motion

MMM Data Format

The MMM data format is an extendable XML-based format for storing model-based motions.

Therefore the MMM framework consists of a Plug-In-Architecture to easily extend the current dataformat with new sensor data.

See [Legacy] MMM Data Format for an old dataformat without the usage of plug-ins.

The Basic MMM Motion Data Format

The main tag which encapsulates the MMM related motion data is <MMM version="2.0"> ... </MMM>. Within these tags a motion is addressed via the <Motion name="my name"> ... </Motion> XML structure. A Motion is divided into <Model> and <Sensors>.

<Model> tag

The motion can be optionally linked to a specific XML model. Therefore the filepath of the model needs to be specified in the 'path'-attribute.
In case of the MMM Reference Model, the model file can optionally be further processed in order to change its parameters by a MMM Model Processor. The <ModelProcessorConfig>-tag specifies the model processor by a type and serves configuration parameters for it.
Here is an example:

<Motion name="ExampleMotion">
<Model path="../Model/Winter/mmm.xml">
<ModelProcessorConfig type="Winter">
<Height>1.7</Height>
<Mass>75</Mass>
</ModelProcessorConfig>
</Model>
...
</Motion>

<Sensors> tag

Each motion can contain multiple sensors consisting of a specific sensor type and optionally a unique name or a description, specified in the xml attributes. A sensor has an optional configuration (<Configuration>) to specify the sensor (e.g. position). Furthermore a sensor includes several measurements (<Measurement>) containing sensor data at particular moments in a motion (timestep-attribute). This constitutes a skeletal structure to be more specified in the corresponding Sensor Plug-In.
Here is an example:

<Motion name="ExampleMotion">
...
<Sensors>
<Sensor type="..." name="..." description="...">
<Configuration>
...
</Configuration>
<Data>
<Measurement timestep="0.0">
...
</Measurement>
<Measurement timestep="0.1">
...
</Measurement>
...
</Data>
</Sensor>
...
</Sensors>
</Motion>
KoroiBot Logo WALK-MAN Logo Xperience Logo SecondHands Logo TimeStorm Logo I-SUPPORT Logo
PACO-PLUS Logo SFB-588 Logo SPP1527 Logo