net.algart.model3d.common.movement.model
Class ElasticBallsInteractionRule

java.lang.Object
  net.algart.model3d.common.movement.model.ElasticBallsInteractionRule

All Implemented Interfaces:

InteractionRule, SymmetricInteractionRule

public final class ElasticBallsInteractionRule
extends java.lang.Object
implements SymmetricInteractionRule

Interaction between two elastic balls. In this class, isApplicable method returns true if and only if both items are instances of ElasticBall, and in this case calculateForce method fills resultXYZ vector by some force F, depending on the volume of intersection of these 2 spheres and, if their friction coefficients are not zero, on their relative velocities. The precise behaviour of this rule is not specified, but it corresponds to the general specification of the elastic balls in ElasticBall class.

Note that the interaction, specified by this class, is symmetric. Also note that if two spheres do not intersect, than the interaction force F=0.

This class is immutable and thread-safe: there are no ways to modify settings of the created instance.

AlgART Laboratory 2010

Since:

JDK 1.5

Version:

1.0

Author:

Daniel Alievsky

ElasticBallsInteractionRule

public ElasticBallsInteractionRule()

isApplicable

public boolean isApplicable(Item toItem,
                            Item byItem)

Description copied from interface: InteractionRule

Checks whether this interaction type is applicable to the given items. If this method returns false, there is a guarantee that InteractionRule.calculateForce(double[], Item, Item, double) method fills its result (first 3 elements of resultXYZ array) by 0.0. If this method returns true, then with high probability InteractionRule.calculateForce(double[], Item, Item, double) method returns a non-zero force.

The arguments of this method can be null; in this case, this method returns false.

Specified by:

isApplicable in interface InteractionRule

Parameters:

toItem - the item to which byItem acts; can be null, then this method returns false.

byItem - the acting item; can be null, then this method returns false.

Returns:

true if this interaction type can be used for this pair; false if byItem cannot act to toItem.

calculateForce

public boolean calculateForce(double[] resultXYZ,
                              Item toItem,
                              Item byItem,
                              double time)

Description copied from interface: InteractionRule

Calculates the force F=(F_x,F_y,F_z) of the action of byItem to toItem and returns it in first 3 elements of resultXYZ array (x-component F_x resultXYZ[0], y-component F_y in resultXYZ[1], z-component F_z in resultXYZ[2]). Returns false if the force is zero. Usually returns true is the force is non-zero, by it is allowed to return true even if it is zero.

This method must work correctly (return false and zero resulting force) also in all situations, when InteractionRule.isApplicable(Item, Item) method returns false.

Specified by:

calculateForce in interface InteractionRule

Parameters:

resultXYZ - resulting force (x-component in resultXYZ[0], y-component in resultXYZ[1], z-component in resultXYZ[2]).

toItem - the item to which byItem acts.

byItem - the acting item.

time - the current time (some interaction can change behaviour in time).

Returns:

if false, there is a guarantee that returned force is zero.