struct.link.model.gap.pos

Syntax

m = struct.link.model.gap.pos(p<,idof>)

Get the positive (tensile) gap component of each 1-D force-displacement model. Will return a 1x6 matrix with the values in all six degrees-of-freedom, or if the optional idof argument is provided, the value in one specific degree-of-freedom.

This value will only affect force calculations if the gap-use flag is on; see the struct.link.model.gap function. The relative displacement is defined as the displacement of the link target minus the displacement of the link host node in the node local coordinate system. See the struct.link.model.disp function.

Returns:

m - a 1x6 matrix representing the positive gap component of each 1-D force-displacement model, or a single value in a specific degree-of-freedom

Arguments:

p - a structural link pointer

idof - an optional degree-of-freedom, from 1 to 6