Difference between revisions of "Connect Four"
(21 intermediate revisions by the same user not shown) | |||
Line 33: | Line 33: | ||
===connectfour.core=== | ===connectfour.core=== | ||
[https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/connectfour/core/Board.html interface Board] | [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/connectfour/core/Board.html interface Board] | ||
− | : [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/connectfour/core/Board.html#isDone-- isDone()] | + | : [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/connectfour/core/Board.html#isDone()-- isDone()] |
− | : [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/connectfour/core/Board.html# | + | : [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/connectfour/core/Board.html#getWinner()-- getWinner()] |
− | : [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/connectfour/core/Board.html#createNextBoard | + | : [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/connectfour/core/Board.html#getCurrentPlayer()-- getCurrentPlayer()] |
+ | : [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/connectfour/core/Board.html#getTurnsPlayed()-- getTurnsPlayed()] | ||
+ | : [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/connectfour/core/Board.html#createNextBoard(int) createNextBoard(int column)] | ||
− | + | ===java.util=== | |
− | ===java.util | + | [https://docs.oracle.com/javase/8/docs/api/java/util/Optional.html class Optional<T>] |
− | [https://docs.oracle.com/javase/8/docs/api/java/util/ | ||
− | |||
− | [https://docs.oracle.com/javase/8/docs/api/java/util/ | + | ===java.util.function=== |
− | :[https://docs.oracle.com/javase/8/docs/api/java/util/ | + | [https://docs.oracle.com/javase/8/docs/api/java/util/function/ToDoubleFunction.html interface ToDoubleFunction<T>] |
− | :[https://docs.oracle.com/javase/8/docs/api/java/util/ | + | : [https://docs.oracle.com/javase/8/docs/api/java/util/function/ToDoubleFunction.html#applyAsDouble-T- applyAsDouble(value)] |
− | --> | + | |
+ | [https://docs.oracle.com/javase/8/docs/api/java/util/function/IntPredicate.html interface IntPredicate] | ||
+ | : [https://docs.oracle.com/javase/8/docs/api/java/util/function/IntPredicate.html#test-int- test(value)] | ||
+ | |||
+ | =Mistakes To Avoid= | ||
+ | {{Warning|Do NOT be lured in be [https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html#MIN_VALUE Double.MIN_VALUE]. Use [https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html#NEGATIVE_INFINITY Double.NEGATIVE_INFINITY] instead.}} | ||
+ | |||
+ | {{Warning|<br>If you are going to use [https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html#NaN Double.NaN] to indicate an invalid/unsearched column (which as an implementation detail, is not the worst choice) [https://www.baeldung.com/java-not-a-number be sure you know what you are doing].<br>Double.NaN's semantics can absolutely be leveraged, but it can be tricky.}} | ||
=Code To Implement= | =Code To Implement= | ||
+ | NOTE: While you should defer to the IntPredicate searchAtDepth for when to continue to search (test returns true) or when to return an evaluation (test returns false), it is up to you to decide when to search in parallel and when to fall back to sequential search. | ||
==Negamax== | ==Negamax== | ||
− | + | ===negamaxKernel=== | |
+ | This private method will do the lion's share of the search. At each invocation either evaluating the board (if appropriate) selecting the evaluation which is worst for the opponent. | ||
− | + | For this assignment, there are two conditions when is appropriate to evaluation the board via the specified <code>heuristic</code>: | |
+ | # the <code>board</code> state indicates that the game is over. | ||
+ | # the <code>searchAtDepth</code> predicate test fails for the current depth. | ||
− | {{ | + | {{CodeToImplement|ConnectFour|negamaxKernel<br>selectNextColumn|connectfour.studio}} |
− | {{ | + | {{Parallel|private static double negamaxKernel(Board board, ToDoubleFunction<Board> heuristic, IntPredicate searchAtDepth, |
+ | int currentDepth)}} | ||
+ | |||
+ | |||
+ | ===selectNextColumn=== | ||
+ | This public method will leverage <code>negamaxKernel</code> to search, but returns the (optional) column index of the chosen best move rather than the evaluation. If there is no move to make, the method should return [https://docs.oracle.com/javase/8/docs/api/java/util/Optional.html#empty-- Optional.empty()]. | ||
+ | |||
+ | {{Parallel|public static Optional<Integer> selectNextColumn(Board board, ToDoubleFunction<Board> heuristic, IntPredicate searchAtDepth)}} | ||
==Win or Lose Heuristic== | ==Win or Lose Heuristic== | ||
− | {{CodeToImplement|WinOrLoseHeuristic| | + | {{CodeToImplement|WinOrLoseHeuristic|applyAsDouble|connectfour.studio}} |
+ | |||
+ | {{Sequential|public double applyAsDouble(Board board)}} | ||
+ | |||
+ | Evaluate the current state of the [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/connectfour/core/Board.html Board]. You should return a negative number if you have lost. You should return less negative numbers for losses that occur later. Put another way, draws should return 0. Losses on the final turn should return -1. Losses on the third to last turn should return -3. Wins should return the analogous positive numbers. | ||
− | + | Interestingly (at least to the Professor), if you build your algorithm in an expected way, you will only need to handle draws as well as (wins or losses). Which one is it? Wins? Or losses? | |
==OpenEndedHeuristic (Optional)== | ==OpenEndedHeuristic (Optional)== | ||
− | {{CodeToImplement|OpenEndedHeuristic| | + | {{CodeToImplement|OpenEndedHeuristic|applyAsDouble|connectfour.challenge}} |
− | {{Sequential|public double | + | {{Sequential|public double applyAsDouble(Board board)}} |
=Testing Your Solution= | =Testing Your Solution= | ||
+ | ==Correctness== | ||
+ | {{TestSuite|ConnectFourTestSuite|connnectfour.studio}} | ||
+ | |||
+ | Some preliminary tests use a simple end game board, destined for a draw, where the last three searches will end in Optional.of(6). | ||
+ | |||
+ | [[File:Simple end game test board.png|300px]] | ||
+ | |||
==Visualization== | ==Visualization== | ||
− | {{Viz|ConnectFourViz|connnectfour. | + | {{Viz|ConnectFourViz|connnectfour.viz.game}} |
[[File:ConnectFourViz.png|400px]] | [[File:ConnectFourViz.png|400px]] | ||
− | |||
− | |||
− |
Latest revision as of 05:22, 15 March 2020
credit for this assignment: Finn Voichick and Dennis Cosgrove
Motivation
Minimax is an important concept in game theory and search.
Negamax is a variant which relies on
While this technique is applicable to Chess (as Deep Blue employed to defeat Kasparov), we choose Connect Four as our context since it has a simpler game mechanic.
While the core part of searches like Minimax may be easy to parallelize, critical aspects such as alpha-beta pruning are more challenging.
Background
Video
Tutorial
Wikipedia
The Core Questions
- What are the tasks?
- What is the data?
- Is the data mutable?
- If so, how is it shared?
Code To Use
connectfour.core
java.util
java.util.function
Mistakes To Avoid
Warning:Do NOT be lured in be Double.MIN_VALUE. Use Double.NEGATIVE_INFINITY instead. |
Warning: If you are going to use Double.NaN to indicate an invalid/unsearched column (which as an implementation detail, is not the worst choice) be sure you know what you are doing. Double.NaN's semantics can absolutely be leveraged, but it can be tricky. |
Code To Implement
NOTE: While you should defer to the IntPredicate searchAtDepth for when to continue to search (test returns true) or when to return an evaluation (test returns false), it is up to you to decide when to search in parallel and when to fall back to sequential search.
Negamax
negamaxKernel
This private method will do the lion's share of the search. At each invocation either evaluating the board (if appropriate) selecting the evaluation which is worst for the opponent.
For this assignment, there are two conditions when is appropriate to evaluation the board via the specified heuristic
:
- the
board
state indicates that the game is over. - the
searchAtDepth
predicate test fails for the current depth.
class: | ConnectFour.java | |
methods: | negamaxKernel selectNextColumn |
|
package: | connectfour.studio | |
source folder: | student/src/main/java |
method: private static double negamaxKernel(Board board, ToDoubleFunction<Board> heuristic, IntPredicate searchAtDepth,
int currentDepth)
(parallel implementation required)
selectNextColumn
This public method will leverage negamaxKernel
to search, but returns the (optional) column index of the chosen best move rather than the evaluation. If there is no move to make, the method should return Optional.empty().
method: public static Optional<Integer> selectNextColumn(Board board, ToDoubleFunction<Board> heuristic, IntPredicate searchAtDepth)
(parallel implementation required)
Win or Lose Heuristic
class: | WinOrLoseHeuristic.java | |
methods: | applyAsDouble | |
package: | connectfour.studio | |
source folder: | student/src/main/java |
method: public double applyAsDouble(Board board)
(sequential implementation only)
Evaluate the current state of the Board. You should return a negative number if you have lost. You should return less negative numbers for losses that occur later. Put another way, draws should return 0. Losses on the final turn should return -1. Losses on the third to last turn should return -3. Wins should return the analogous positive numbers.
Interestingly (at least to the Professor), if you build your algorithm in an expected way, you will only need to handle draws as well as (wins or losses). Which one is it? Wins? Or losses?
OpenEndedHeuristic (Optional)
class: | OpenEndedHeuristic.java | |
methods: | applyAsDouble | |
package: | connectfour.challenge | |
source folder: | student/src/main/java |
method: public double applyAsDouble(Board board)
(sequential implementation only)
Testing Your Solution
Correctness
class: | ConnectFourTestSuite.java | |
package: | connnectfour.studio | |
source folder: | testing/src/test/java |
Some preliminary tests use a simple end game board, destined for a draw, where the last three searches will end in Optional.of(6).
Visualization
class: | ConnectFourViz.java | VIZ |
package: | connnectfour.viz.game | |
source folder: | student/src//java |