@@ -0,0 +1,2745 @@
+/*%0A * Copyright 2016 Will Knez %3Cwbknez.dev@gmail.com%3E%0A *%0A * Licensed under the Apache License, Version 2.0 (the %22License%22);%0A * you may not use this file except in compliance with the License.%0A * You may obtain a copy of the License at%0A *%0A *     http://www.apache.org/licenses/LICENSE-2.0%0A *%0A * Unless required by applicable law or agreed to in writing, software%0A * distributed under the License is distributed on an %22AS IS%22 BASIS,%0A * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.%0A * See the License for the specific language governing permissions and%0A * limitations under the License.%0A */%0A%0Apackage com.solsticesquared.schelling.move;%0A%0Aimport com.solsticesquared.schelling.Agent;%0Aimport com.solsticesquared.schelling.SchellingExplorer;%0A%0Aimport java.util.ArrayList;%0A%0A/**%0A * Represents a mechanism for performing a single %22movement%22 step in a%0A * simulation, whereby one agent (or agents) try and move to a new location.%0A */%0Apublic interface MovementMethod %7B%0A%0A    /**%0A     * Returns the minimum number of agents that must be in an agent list in%0A     * order for this movement method to work.%0A     *%0A     * @return The minimum number of agents required.%0A     */%0A    int getMinimumNumberOfAgentsRequired();%0A%0A    /**%0A     * Performs a single %22movement%22 operation on the specified list of agents%0A     * using some arbitrary logic.%0A     *%0A     * %3Cp%3E%0A     *     The specifics of the algorithm used are irrelevant, however there%0A     *     are two important requirements that all implementations must meet:%0A     *     %3Col%3E%0A     *         %3Cli%3EThe agent, or agents, that are moved must removed from%0A     *         the specified agent list.%3C/li%3E%0A     *         %3Cli%3EThe agent, or agents, that are moved must have their%0A     *         positions updated before this method completes; this also%0A     *         applies to the empty cell list (that is why it consists of%0A     *         mutable coordinate objects).%3C/li%3E%0A     *     %3C/ol%3E%0A     * %3C/p%3E%0A     *%0A     * %3Cp%3E%0A     *     However, it should be noted that this project guarantees that by%0A     *     the time this method is called, all appropriate pre-requisites%0A     *     have been met.  In particular, the number of agents required for a%0A     *     single, successful movement operation (as defined by%0A     *     %7B@link #getMinimumNumberOfAgentsRequired()%7D) have been verified;%0A     *     there is no need for implementations to check.%0A     * %3C/p%3E%0A     *%0A     * @param agents%0A     *        The list of agents to use.%0A     * @param model%0A     *        The model to use.%0A     * @throws NullPointerException%0A     *         If either %7B@code agents%7D or %7B@code model%7D are %7B@code null%7D.%0A     */%0A    void move(final ArrayList%3CAgent%3E agents,%0A              final SchellingExplorer model);%0A%7D%0A

Add mechanism for performing a single movement operation on an agent list.