2. BODY Namelist

The BODY namelists define initial material distributions and initial values of the field unknowns. They are processed in the order they appear in the input file, and identify the specified part of the computational domain not claimed by any preceding BODY namelist. Any “background”-type BODY must appear last. Each namelist is used to specify a geometry and initial state. The geometry is specified via the variables using an acceptable combination of surface_name, axis, fill, height, length, mesh_material_number, radius, rotation_angle, rotation_pt, and translation_pt, hereafter referred to as geometry-type parameters. The initial state is specified using material_name, velocity, conc or conc_func, and temperature or temperature_function.

Namelist Usage

Required/Optional:

Required

Single/Multiple Instances:

Multiple

2.1. Namelist Variables

axis

The axis to be used for defining a cylinder or plane.

Type:

string

Default:

none

Valid Values:

“x”, “y”, “z”

fill

The side of the surface to which material is to be inserted for this body.

Type:

string

Default:

inside

Valid Values:

“inside”, “outside”

height

Height of a cylinder body.

Type:

real

Default:

(none)

Valid Values:

\({}>0\)

length

Length of each side of the box body, or the coefficients of an ellipse or ellipsoid body.

Type:

real triplet

Default:

(none)

Valid Values:

\({}>0\)

material_name

Name of the material, or material phase in the case of a multi-phase material, that occupies the volume of this body.

Type:

string

Default:

none

mesh_material_number

List of cell set IDs (Exodus element block IDs) that define the material body. This variable is only meaningful when surface_name is “from mesh file”.

Type:

integer list

Default:

none

conc

The constant initial values of the multi-component scalar field in the material body. To specify a function use conc_func instead. This is a vector-valued variable with elements that correspond to the different components of the scalar field. Each component must be assigned an initial value by either this variable or conc_func.

Type:

real

Default:

none

conc_func

The names of FUNCTION namelists defining functions that give the initial values of the multi-component scalar field. The functions are expected to be functions of \((x,y,z)\). This is a vector-valued variable with elements that correspond to the different components of the scalar field. Each component must be assigned an initial value by either this variable or conc.

Type:

string

Default:

none

radius

Radius of the geometric body (cylinder, sphere, ellipsoid).

Type:

real

Default:

none

Valid Values:

\({}>0\)

rotation_angle

Angle (degrees) about the (x,y,z) axes this body is to be rotated. This variable is only supported for “plane: and “cylinder” body types.

Type:

real triplet

Default:

\(0.0, 0.0, 0.0\)

rotation_pt

Location of the point about which this body is to be rotated. This variable is only supported for “plane” and “cylinder” body types.

Type:

real triplet

Default:

\(0.0, 0.0, 0.0\)

surface_name

Type of surface characterizing the interface topology for this body. The available options are:

Value

Description

“background”

background body will occupy all space which has not been claimed by previously listed BODY namelists. If provided, it must be the final BODY namelist provided. When specified, no other geometry-type parameters are relevant.

“plane”

A plane is specified using axis, rotation_angle, rotation_pt, and fill to define the normal direction, and translation_pt to provide a point on the plane surface. The normal vector is an outward normal, such that the region defined is in the opposite direction of the normal vector unless fill is “outside”.

“box”

A box is specified using translation_pt as the center, length for the length of x, y, and z sides respectively, and fill to invert the shape. This shape does not support rotation.

“sphere”

A sphere is specified using translation_pt as the center, radius, and fill to invert the shape.

“ellipsoid”

An ellipsoid of the form \((x-x_0)^2/{l_1}^2 + (y-y_0)^2/{l_2}^2 + (z-z_0)^2/{l_3}^2 <= 1\) is specified using translation_pt for the center \((x_0,y_0,z_0)\), length for \(l_1, l_2, l_3\), and fill to invert the shape. This shape does not support rotation.

“ellipse”

An infinitely long elliptic cylinder of the form \((x-x_0)^2/{l_1}^2 + (y-y_0)^2/{l_2}^2 <= 1\) is specified using translation_pt as the center, length for \(l_1, l_2\), and fill to invert the shape. This shape does not support rotation, and will be aligned the z axis.

“cylinder”

A cylinder is specified using translation_pt for the center of the base, axis, rotation_angle, and rotation_pt to define the orientation, radius, height, and fill to invert the shape.

Type:

string

Default:

none

temperature

Initial constant temperature of the material body.

Type:

real

Default:

none

Notes:

Either temperature or temperature_function must specified, but not both.

temperature_function

The name of a FUNCTION namelist that defines the initial temperature function for the material body. That function is expected to be a function of \((x,y,z)\).

Type:

string

Default:

none

Notes:

Either temperature or temperature_function must specified, but not both.

translation_pt

Location to which each surface origin of this body is translated.

Type:

real triplet

Default:

\(0.0, 0.0, 0.0\)

velocity

Initial velocity of the fluid material body.

Type:

real triplet

Default:

\(0.0, 0.0, 0.0\)