clump.scalesphere

Syntax

b = clump.scalesphere(c,f)

Scale the clump to an equivalent sphere. The clump is scaled so that its {area in 2D; volume in 3D} is the same as a {circle in 2D; sphere in 3D} of diameter f. The pebbles are scaled, their positions are modified, and the volume is updated.

Note

  • All pebbles of the scaled clump 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 clump attribute or via FISH (clump.vol, clump.moi.prin.real, or clump.moi.real), the principal moment of inertia is in a fixed state and will not be scaled. See the clump.moi.fix intrinsic for further details.
Returns:

b - boolean indicating success/failure of operation

Arguments:

c - clump pointer

f - diameter of {a circle in 2D; sphere in 3D}