/**
 * This interface provides the means for an implementing class to be
 * notified of room changes that occur in the MobileClient class.  When
 * a room change occurs within the MobileClient class, the
 * LocationTracker interface's roomChanged() method is called in order
 * to notify application classes that implement the LocationTracker
 * interface.
 * <p>
 * Any Java class that creates a MobileClient object needs to implement
 * the LocationTracker interface so that the MobileClient class can
 * notify the Java class of any room changes that occur.
 *
 * @author Tony Offer
 * @author Chris Palistrant
 * @version 1.0
 */
public interface LocationTracker {
    
    /**
     * This method is called by the MobileClient class when a change in
     * room location occurs.  A HashMap describing the distribution of
     * room detections is passed into this method so that objects
     * implementing the LocationTracker interface can determine the room
     * in which it most likely exists.
     *
     * @param distribution    HashMap containing the most recent
     *                        ultrasound detections and their
     *                        corresponding relative magnitudes.
     */
    void roomChanged(java.util.HashMap distribution);
}