gp.force.unbal

Syntax

Vector Access

v := gp.force.unbal(gp<,i>)

Get the unbalanced force at a gridpoint after the last cycle. Returns a vector, unless an optional component argument i is supplied, in which case it returns the component value.

Note that unlike versions of FLAC3D prior to 7.0 this version returns the net unbalanced force after the last step. This includes all sources, including forces due to gravity and applied conditions. This value is not updated during a cycle to reflect the current unbalanced force.

See also the FISH intrinsics gp.force.unbal.current and gp.force.unbal.add.

Returns:

v - last unbalanced force vector or component

Arguments:

gp - grid point pointer

i - optional vector component, from 1 to 3