Release
Use the Release node to release grains into the model from a selected set of domains. The release times, initial values of the grains’ degrees of freedom such as positions, velocities and temperature, and initial value of any auxiliary dependent variables can be specified.
The grains are released sequentially at each release time. For each grain, a release position and radius are first determined based on the options provided in the Initial Position and the Released Grain Properties sections. An attempt is made to release the grain at this position, and the attempt is considered successful only if the new grain does not overlap with any existing grains or wall elements. Alternatively, a maximum amount of allowed overlap can also be specified.
If the attempt is deemed successful, the grain is released at the release position. Alternatively, an unsuccessful attempt can be followed by a number of attempts at nearby release positions. Once the maximum number of attempts is reached, the grain is discarded, and the next grain is attempted.
Release Times
Select a Distribution function: List of values (default), Uniform, Normal, or Lognormal.
List of Values
Enter Release times (SI unit: s), or click the Range button () to select and define a range of specific times. At each release time, grains are released with initial position and velocity as defined in the following sections.
Uniform
Enter the Number of values, along with the First time value (SI unit: s) and the Last time value (SI unit: s). In addition, select whether the Sampling from distribution should be Deterministic or Random. When Deterministic is selected, an array of length Number of values of uniformly spaced release times is generated. This array starts with the First time value and ends with the Last time value exactly. The release times are reproducible each time the solution is computed.
When Random is selected, an array of random numbers of length Number of values, with a minimum lower limit of the First time value and maximum upper limit of the Last time value is generated. In this case, a release time of exactly the first and last time values is extremely unlikely.
Normal and Lognormal
Enter the Number of values along with the Mean (SI unit: s) and the Standard deviation (SI unit: s). In addition, select whether the Sampling from distribution should be Deterministic or Random. When Deterministic is selected, an ordered array of length Number of values of normally distributed release times is generated. The release times are more closely spaced around the value entered for the Mean and the spacing of the release time drops off according to the value of the Standard deviation. The release times are reproducible each time the solution is computed.
When Random is selected, the normal or lognormal distribution is generated by pseudorandom sampling, so there may be some statistical error.
Initial Values
Position
Select a Position from the list: Random (the default) or Density.
Random
For Random the grains are released at random positions within the selected entities. If grains are released at multiple release times, the initial positions are uniquely generated for each release time. By contrast, for Density the grains positions are the same at each release time.
The grain positions are determined in the following way. First a random mesh element is selected for each grain with a probability proportional to the element size, so that grains are more likely to be released from larger mesh elements than smaller elements. After the mesh element is selected, random local coordinates are chosen within the element, then converted to global coordinates. A grain is then attempted to be placed at this location.
Density
For Density the grains are positioned in the selected domains by sampling from a user-defined spatial distribution. Enter a value or expression for the Density proportional to ρ (dimensionless). The default is 1.
The Density proportional to field is an expression; the resulting grain distribution approximately has a density that is proportional to this expression. The resulting distribution looks a bit random, and it depends on the underlying mesh.
Select a Release distribution accuracy order between 1 and 5 (the default is 5), which determines the integration order that is used when computing the number of grains to release within each mesh element. The higher the accuracy order, the more accurately grains will be distributed among the mesh elements.
The Position refinement factor (default 0) must be a nonnegative integer. When the refinement factor is 0, each grain is always assigned a unique position, but the density is taken as a uniform value over each mesh element. If the refinement factor is a positive integer, the distribution of grains within each mesh element is weighted according to the density. Further increasing the Position refinement factor increases the number of evaluation points within each mesh element.
Velocity
Enter values or expressions for the components of the initial grain velocity v0 (SI unit: m/s) based on space dimension. The defaults are 0 m/s.
Temperature
This section is only shown when the Compute grain temperature checkbox is selected in the physics interface Grain Temperature section. Enter a value or expression for the initial grain temperature Tg,0 (SI unit: K). The default value is 293.15 K.
Angular Velocity in body-fixed frame
Enter values or expressions for the components of the initial angular velocity in the body-fixed frame ω0 (SI unit: rad/s).
Released Grain Properties
This section is used to specify the total number of grains and the distribution of the grain properties to be released per release time. Select a Distribution of released grain properties: Number of grains (default), Number fraction, Mass fraction, or Volume fraction.
When Number of grains is selected, enter the number of grains to be released for each grain type corresponding to a Grain Properties node. The default value for the first row in the table is 1, and it is 0 for all other rows.
When one of the Number fraction, Mass fraction, or Volume fraction options is selected, enter the Number of grains per release (default 1). Then enter the values of the corresponding fractions of the distribution for each grain type. The default value for the first row in the table is 1, and it is 0 for all other rows. The fractional values are normalized internally so that their sum is 1 even if the provided values do not add up to 1.
The values of the distribution can be numerical values or parameters defined in the Parameters node.
The grains are released sequentially, and each grain is associated with a Grain Properties node with a probability dictated by the user-specified distributions.
Initial Value of Auxiliary Dependent Variables
This section is available if an Auxiliary Dependent Variable has been added to the model. For each of the Auxiliary Dependent Variables (rp) added to the model, enter an initial value (rp0). The default value is 0.
Advanced Settings
Enter a nonnegative value or expression for the Maximum allowed normal overlap (SI unit: m/s). The default is 0 m. This value is used to control the amount of overlap that is acceptable between a grain being considered for release and existing grains or wall elements.
Enter a value or expression for the Number of release attempts per grain (default 10). This value controls the number of release positions that are attempted for each grain.
If User Defined is selected from the Seeds for random number generator list in the physics interface Advanced Settings section, the Seed for random number generator text field is available. Enter the seed value of the pseudorandom number generator (PRNG) used by this feature. The default value is 1. The PRNG is used to generate random numbers for sampling grain release times, positions, grain properties, and initial values of auxiliary dependent variables.