LIGGGHTS WWW Site - LAMMPS WWW Site - LIGGGHTS Documentation - LIGGGHTS Commands

fix seaice/current command

Syntax:

fix ID group-ID seaice/current Ux Uy Cds Cdf keyword value ... 

Examples:

fix NW all seaice/current 0.25 -0.25 0.002 0.001
fix Nwv all seaice/current 0.0 -0.2 0.002 0.0018 wavecur regWaves
fix periodic all seaice/current v_acost 0.0 0.002 0.002 region regID 

Description:

This fix is part of the USER-SEAICE package; it is only enabled if LIGGGHTS was built with that package.

It adds current-generated force and torque to forces/torques acting on each disk-shaped atom in the group.

It is assumed that the current is horizontal, i.e., it does not contribute to the force along the z-axis and to the torque along the x- and y-axes.

The skin drag acting on a given disk is proportional to its upper surface area. The form drag is proportional to the disk diameter times its freeboard, calculated from its thickness and relative density. In the code, a quadratic formula is used for the forces and a linearized formula for the torque.

Any of the 4 quantities defining the current speed components and drag coefficients can be specified as an equal-style or atom-style variable. If the value is a variable, it should be specified as v_name, where name is the variable name. In this case, the variable will be evaluated each timestep. For more details concerning specifying variable forcing, see the documentation of the fix addforce command.

The wavecur option makes it possible to take into account horizontal components of the wave-induced surface current (i.e., the oscillatory motion at the mean water surface, not the mean drift due to waves).

Without the wavecur option, this fix requires one global variable, defining the value of water density, that can be set with the fix property/global command:

fix pg1 all property/global rhoWater scalar 1025.0 

If the wavecur option is used, an additional global variable is required, specifying the wave characteristics, for example:

fix pg2 all property/global regWaves matrix 3 0.75 0.15 0.15 25.0 18.0 20.0 0.0 10.0 -10.0 0.0 20.0 -30.0 

for a superposition of 3 regular waves, or:

fix pg3 all property/global jonswap vector 0.5 12.0 0.0 0.33 20.0 20 0.05 0.5 5 -20.0 20.0 

for a Jonswap spectrum (see fix seaice/waves for a detailed description of the syntax of these commands and the meaning of their arguments). No default values for these constants are predifined and the lack of the above definitions in the input script will produce an error.

If the region keyword is used, the atom must also be in the specified geometric region in order to have the force added to it.


Restart, fix_modify, output, run start/stop, minimize info:

See the documentation of the fix addforce command.

Restrictions: none

Related commands:

fix addforce, fix seaice/coriolis, fix seaice/wind, fix seaice/waves

Default: none

(Herman) Agnieszka Herman, Geosci. Model Devel., submitted (2015).