mpoint create command

Syntax

mpoint create keyword ...

Primary keywords:

group    id    position    position-x    position-y    position-z    volume

Create a single mpoint.

Note

• A model domain must be specified prior to mpoint creation.

• While cycling, mpoints can only be created before cycle point 0 (i.e., when the timestep is calculated).

group s <slot slot > ...

The group slot slot is set to s for the newly created mpoint. If the slot keyword is not specified, then the group name is assigned to the slot with name Default.

id i

Mpoint ID. If not specified, then the next available ID is used. An error is raised if an mpoint with the specified ID already exists in the system.

position v

Mpoint position that is the origin by default.

position-x f

The \(x\)-component of the mpoint position that is 0 by default.

position-y f

The \(y\)-component of the mpoint position that is 0 by default.

position-z f (3D ONLY)

The \(z\)-component of the mpoint position that is 0 by default.

volume f

Mpoint volume, where f > 0. An exception is thrown if an mpoint with zero volume exists in the model when cycling starts. The equivalent sphere radius is automatically assigned to the mpoint.