!ApplyOn_ Subroutines

This is a category of subroutines outlined in treeops.f90, whose principle purpose is to map functions onto broad groups of nodes. The list of parameters may vary between ApplyOn_ subroutines, but they all have two parameters in common: a function f to be applied to every node that meets the ApplyOn_ function's criteria, and the FuncParam object fparam that holds f's parameters.

When ApplyOnFoo(f, fparam) is called, BearCLAW will call f (using the appropriate parameters) on every node that belongs in category Foo. The order in which it does so is dependent on the structure of the current forest and the ApplyOn_ function in question, but when reading BearCLAW code the important thing to know is that f is being called for every relevant object Foo. For instance,

CALL ApplyOnLevel(ROOT_LEVEL, Initialq, params)

is the same as calling Initialq(aNode%Info, params) for every node aNode where aNode%level = ROOT_LEVEL.

Currently, the following ApplyOn_ subroutines exist:

• ApplyOnLevel
• OpenMPApplyOnLevel
• ApplyOnLevelTarget
• ApplyOnLevelPairs
• ApplyOnChildren
• ApplyOnForest
• ApplyOnLevels
• ApplyOnLeaves