MPM Input Files

MPM simulations are run using OSParticulas and NairnMPM. Some of the key features of these code engines (with links) are listed here. The documentation on this page explains how to run MPM calculations by described all the sections of input command files.

Input Command File Overview

When using NairnFEAMPM or NairnFEAMPMViz to set up calculations, the input command files are usually script files written using the custom scripting language. When you interpret these scripts, the applications will create an XML input command file that is needed to drive the code engines. Click this link to see a sample scripted MPM input command file for simulation of two colliding disks.

Alternatively, you can directly create XML input command files. Because this approach cannot use the language control options of a scripting language, it is much less powerful then scripting methods and much harder to customize for a range of simulations. If you do use the manual XML method, the files must conform to the structure defined here. Click this link to see a sample XML MPM input command file for simulation of two colliding disks.

Documentation Notes

Scripted input files are comprised of a series of commands an XML input files are comprised of a series of XML elements. This documentation will explain these commands and elements using the style:

 Command (arg1),(arg2),<(arg3)>,<(arg4)>
 <Command attr1='(arg1)' attr2='(arg2)'>(arg3)</Command>

where

• Command is the command name.
• (arg1),(arg2), etc., specify arguments whose function will be explained along with the command.
• <(arg3)> - enclosing an argument in angle brackets indicates an optional argument. If the argument is omitted, the code will assume some default value.
• attr1, attr2, etc., are attributes to the XML element.

Main Header

This section defines the type of analysis to run and provides an optional description of the calculations. When using a scripting language, the header is created automatically and its content is controlled by commands defined below. When manually writing XML files, the header, which is required, is defined in a single header block:

<Header>
  (commands)
</Header>

The possible header commands are

• Analysis Command - pick the type of MPM analysis to run.
• Annotation Commands - these commands let you annotate the calculations.
• Processors Command - pick number of processors for parallel code.
• Setting Developer Flags

MPM Header

This section defines many settings and features for the MPM calculations. When using a scripting language, the MPM header is created automatically by various commands defined in this section. When writing XML input files, all these commands must be within a single MPM header block:

<MPMHeader>
  (commands)
</MPMHeader>

The possible MPM header commands are given below by categories.

• MPM Methods and Simulation Timing - these commands determine the MPM method to use, the time step, and the maximum simulations time.
• MPM Archiving Options - these commands determine which results are archived and where they are saved.
• MPM Global Archiving Options - these commands determine which results are archived in a global results file.
• Multimaterial MPM - these commands configure the calculations to run in multimaterial mode.
• Crack Settings - these commands define various simulation features when using cracks.
• Diffusion Calculations - this command activates diffusion calculations.
• Damping Options - these commands set up grid-based damping options.
• LeaveLimit Command - this command determine what happens when particles leave the grid.

Defining Material Models

Each material point is assigned a material type. NairnMPM and OSParticulas support numerous material models. For plasticity materials, each material type can choose from among a set of hardening laws. Finally, when using explicit cracks, the material points along the cracks can be assigned to various traction laws. The information on these options are in the following sections:

• Material Models - all material models available for MPM simulations
• Hardening Laws - all hardening laws available for plasticity materials
• Traction Laws - all traction laws available for modeling cohesive zones on cracks

Thermal Calculations

MPM simulations can do thermal calculations that account for thermal strains in the stress analysis and can model thermal conduction. The commands in this section activate thermal calculations.