OOF2: The Manual

Name

Limited Average Energy (LimitedAverageEnergy) — Accepts the change that lowers the average energy AND meets specified conditions on homogeneity and shape energy.

Synopsis

LimitedAverageEnergy(alpha,homogeneity,shape_energy)

Details

  • Base class: SkelModCriterion
  • Parameters:

    alpha
    alpha controls the relative importance of element shape and homogeneity. alpha=0 emphasizes shape and ignores homogeneity. alpha=1 emphasizes homogeneity and ignores shape. Type: A real number in the range [0, 1].
    homogeneity
    Minimum acceptable homogeneity. Type: A real number in the range [0, 1].
    shape_energy
    Maximum acceptable shape energy. Type: A real number in the range [0, 1].

Description

This is a variation of the AverageEnergy criterion for accepting or rejecting Skeleton modifications. For a modification to be accepted, it not only has to lower the average effective energy of the associated Elements but it has to satisfy limits in the changes of these Elements. This criterion is best suited for putting finishing touches on the skeleton.

The homogeneity and shape_energy parameters are thresholds that each divide the Elements into two classes: good (homogeneity above the threshold or shape energy below the threshold), and bad (homogeneity below the threshold or shape energy above the threshold). The rule for accepting a modification is that the average energy must decrease, and bad elements must not get worse. Good elements may get worse, but may not cross the thresholds and become bad.