rblock.scalevol

Syntax

b = rblock.scalevol(rb,f)

Scale the rigid block. The rigid block is scaled so that its {volume per unit thickness in 2D; volume in 3D} is f. The pebbles are scaled, their positions are modified, and the volume is updated.

Note

  • All pebbles of the scaled rigid block must fall within the model domain for the operation to succeed.

  • If the volume or moment of inertia has been previously specified by the user either via rblock attribute or via FISH (rblock.vol, rblock.moi.prin.real, or rblock.moi.real), the principal moment of inertia is in a fixed state and will not be scaled. See the rblock.moi.fix intrinsic for further details.

Returns:

b - boolean indicating success/failure of operation

Arguments:

rb - rigid block pointer

f - volume