User Tools

Site Tools


Metadata to use Human Body Models in the PIPER framework

Metadata files describing what needs to be interpreted by PIPER modules (e.g. anatomy, relationships, mesh) are needed to use a Human Body Model (HBM) within PIPER. The benefits of separate metadata files include:

  • users can create/update metadata without changing the software
  • information about models are not hard coded in the software (preventing licensing issues).

The contents of the metadata files is typically generic (e.g. a node number for a landmark, a part number for a bone). More information can be found in the online manual and a general introduction is available in this youtube video from the PIPER final workshop.

However, whether this information needs to be treated as confidential and whether distributing it would violate the HBM license has to be determined with the HBM owner and the exact licensing terms. If you develop or modify metadata, you are responsible for resolving possible licensing issues prior to distributing them (as with all models and software you use).

Also, basic metadata (e.g. describing the skin and bones) may not sufficient for some modules. For example, positioning using lightweight physics simulation requires bone descriptions with properly oriented normal, a skeletal structure and specific landmarks for the spine positioning. Positioning using the contour module requires defining contours.

Specific requirements are defined in the manual. It is hoped that the amount of information that has to be defined can be reduced in the future. For now, please note that the software performance can be largely affected by the metadata definition, and that some of the modules may not work properly without specific metadata.

This page aims to provide an brief summary of the metadata availability (with licensing info when relevant) and module support.

Status: metadata developed during the PIPER EU project (and updated later).

The following metadata were developed during the PIPER project. The PIPER project is not affiliated with any of the third parties model owners. While these files can help you developing new metadata, please note that they all have licenses that need to be followed (e.g. you cannot reuse something released under GPL inside something you will release under proprietary license, but you may use something released under CC-BY-4.0 under specific conditions). Please check the specific licenses…

PIPER child model

Metadata for the PIPER child model includes support for most modules (the contour modules are experimental). They are distributed with the model under the same Open Source license (GPLv3 +liability and Open Science clauses).

GHBMC M50 occupant model v4.1 in LS Dyna

The PIPER project version of the metadata for the GHBMC M50 occupant model v4.1 includes support for all modules (except child scaling of course). After discussing explicitly the contents of the specific files with the GHBMC, the files are available shortly under the Creative Commons CC-BY-4.0 license at the following link: GHBMC_M50-O_v4-1-1_2013-09-01 (metadata_released 2017-11-10 package updated 2018-02-22 to add the contourCL file).

These are the files that were used during the development of the software. There were also more limited efforts for the pedestrian.

More details about the GHBMC models can be found on the GHBMC and Elemance websites.

GHBMC M50-O occupant model v4.5 in LS Dyna

The metadata for the version 4.1 were updated to the version 4.4 for internal use and then to version 4.5 by the CEESAR (Thanks to David Poulard)

The files are available for download here

Please check the readme.txt before using (the original model needs to be slightly modified to use a consistent format).

Please note we are working on an update for the version 5.0.


Thums occupant AM50 v4.02 in LS Dyna

The PIPER project version of the metadata for the Thums occupant AM50 v4.02 in LS Dyna includes support for all modules except the contour module and the child scaling.

The files will be distributed by JSOL. THUMS users should send an email to (Contact Person: Takahiko Miyachi). Please note that files cannot be exchanged directly between users. Any modification to the Metadata is welcomed and should be sent to the same email address. Changes should be clearly documented as they will be reviewed before release.

ViVA model (version 20160912)

The PIPER project version of the metadata for the ViVA model includes only very basic support (to import basically). It is available on the gitlab under the same license as ViVA (GPLv3 +additional clauses).

More information about the ViVA model is available here.

Status: metadata developed by third parties

You are encouraged to develop new metadata (you should still be careful with the license) and we know of several ongoing efforts… While the PIPER project is not affiliated with these efforts, we are very happy they are ongoing. We will try to keep track of activities to limit redundancies and help people communicate. You can contact us if you would like us to mention your effort here (in case we did not find it).

Elemance metadata for the GHBMC models

Elemance publicly released metadata for :

  • the GHBMC M50 occupant v4.5,
  • the M50 pedestrian v1.2.

We don't know yet which PIPER modules are supported. Please check their website for more technical and licensing information:

ViVA metadata

ViVA metadata were developed by Christian Kleinbach (Thanks!) based on the early effort within PIPER. They are available on the gitlab here:

metadata.txt · Last modified: 2019/06/25 16:23 by admin