Setting Material Point Initial Velocity
When material points are created than can be assigned an initial velocity or an initial angular momentum using the commands described below.
Setting Initial Velocity
In scripted input files, the initial velocities are set using parameters to the Region command. The velocities apply to all particles in the region.
In XML input files, the velocity attributes on the <Body> command can only be constants and they set a constant velocity to all particles in the region. To set velocities with a user defined function, intersperse the following commands within the <Body> element:
<vel0X>(velx)</vel0X>, <vel0Y>(velz)</vel0Y>, <vel0Z>(velz)</vel0Z>
These commands set each component of initial velocity of the particles created in the current region after the command using the supplied user defined functions of particle position (x, y, and z). If used, they override the values used in vx, vy, and vz attributes of the <Body> command. The function value should be in velocity units. If multiple commands are used in a single region, the new function replaces the previous one for all subsequently created material points. A command with empty value reverts to zero initial velocity.
Note that XML input files, unlike scripted files, can apply different functions to different groups of particles within a single <Body> command. To do the same in scripted input files, simply create multiple Region command blocks.
Setting Initial Angular Momentum
In scripted input files, the AngularMom0 command sets the initial angular momentum for all particles in the current region (it is only available in OSParticulas). In 2D simulations, the command takes one argument:
AngularMom0 (Lp0z)
while for 3D simulations, it takes 3 arguments:
AngularMom0 (Lp0x),(Lp0y),(Lp0z)
where (Lp0x), (Lp0y), and (Lp0z) are numerical values or user-defined functions of particle position (x, y, and z) that give the initial angular momentum per unit mass in length2/time units. The initial values apply to all particles in the current region, including particles created in shape commands before the AngularMom0 command.
In XML input files, the initial angular momenta are set by interspersing the following commands within the <Body> element:
<Lp0X>(Lp0x)</Lp0X> <Lp0Y>(Lp0y)</Lp0Y> <Lp0Z>(Lp0z)</Lp0ZZ>
These commands set initial angular momentum of the particles in the current region. The value is interpreted as a user-defined function of particle position (x, y, z) that evaluates to angular momentum per unit mass in length2/time units. If multiple commands are used in a single <Body> element, the new function replaces the previous one for all subsequently created material points. A command with empty value reverts to zero angular momentum. This initial setting only has an effect for simulations that track particle spin.
Note that XML input files, unlike scripted files, can apply different functions to different groups of particles within a single <Body> command. To do the same in scripted input files, simply create multiple Region command blocks.
Initial Angular Velocity
Note that the above commands are setting angular momentum and not angular velocity. The setting to get a particular angular velocity (ω radians per time units) depends are particle locations and dimensions. For particles at typical starting positions, the angular momentum for given ω would be:
- 2D, 4 particles per cell: [math]\displaystyle{ L_{p,z} = {3\over 16}\left(\Delta x^2+\Delta y^2\right)\omega }[/math]
- 2D, 1 particle per cell: [math]\displaystyle{ L_{p,z} = {1\over 4}\left(\Delta x^2+\Delta y^2\right)\omega }[/math]
where Δx and Δy are cell dimensions for the grid cell containing the particle. Simulations with more particles per cell would need to set different angular momenta for different particle locations, which is currently not possible. One alternative is to use an average value noting that fraction in the above angular momenta will range from 1/8 to 1/4 depending on particle location.
For 3D simulations, the equations are the same except may involve all three axes. The equation for each axis (e.g., [math]\displaystyle{ L_{p,x} }[/math]) depends on cell dimensions in the other two directions (e.g., Δy and Δz).