bfs_brute_force 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d9930b15a9a8a806ab35bd20859d81154d3cd8c2
-  data.tar.gz: 5f86c835cef8195335c7c522bce1b4b9b3d60f09
+  metadata.gz: 7f879c91d242290c63e4954462f7c59bf549f6ab
+  data.tar.gz: 776c1866683f05ecddf9abaa3d2e14dc83c99e51
 SHA512:
-  metadata.gz: 482eaa39bd9e01336086bb52ef921f811b43166095bb5268db83c0b46a8b3728d924b4e23d9c1419810dc7bcdff9d65ad4aa6a111ad6bb2c35a4148820f2ef67
-  data.tar.gz: f4118407512dc990b627e8fb5479de802c89601d73d9f9f6eccefa5514cf50d453995fd8a25c3bbd59519e095427949c361775e82e262e33649f46cd87d148a9
+  metadata.gz: 05b9e57c22e4ced97848b53ec57049cc281e4fb40ab9e3bee0009b3c9744709a67d1a8cefed45c000940afca6a5ab214cf9b80b38e3c81f4d312e6cbda6ccfbe
+  data.tar.gz: c9cdbccc02109c2bc20735bf5e8730de003ee35a1cf184f309303baab0113e6a8e6a3939c1d1e7be24fecd1d35a75515e5caea649ab98a5afe9c55ecb9577eb5

data/.gitignore

@@ -12,3 +12,4 @@
 *.o
 *.a
 mkmf.log
+example/Gemfile.lock

data/README.md

@@ -1,5 +1,7 @@
 # BfsBruteForce
 
+[![Gem Version](https://badge.fury.io/rb/bfs_brute_force.png)](http://badge.fury.io/rb/bfs_brute_force)
+
 Lazy breadth first brute force search for solutions to puzzles.
 
 This ruby gem provides an API for representing the initial state
@@ -32,41 +34,47 @@ Each instance of your State subclass must:
 2. Determine if the state is a win condition of the puzzle (```solved?```)
 3. Provide a generator for reaching all possible next states (```next_states```)
 
-### Example Puzzle
+### Simple Addition Example Puzzle
 
-Imagine a simple puzzle where you are given a starting number, an
-ending number, and you can only perform one of three addition
-operations (adding one, ten, or one hundred).
+Using the moves "Add 10" and "Add 1," find the shortest number
+of moves from a starting number to a final number.
 
 To use ```BfsBruteForce``` you will create your
 ```BfsBruteForce::State``` subclass as follows:
-    require 'bfs_brute_force'
 
     class AdditionPuzzleState < BfsBruteForce::State
-      attr_reader :value
-
-      def initialize(start, final)
-        @start = start
-        @value = start
+      def initialize(value, final)
+        @value = value
         @final = final
       end
-
+  
+      # (see BfsBruteForce::State.solved?)
       def solved?
         @value == @final
       end
-
-      def to_s
-        "<#{self.class} puzzle from #{@start} to #{@final}>"
-      end
-
+  
+      # Call yield for every next state in your puzzle
+      # This puzzle has two legal moves from every state: Add 10, and Add 1
+      #
+      # (see BfsBruteForce::State.next_states)
       def next_states(already_seen)
+        # If there are no more available states to analyze,
+        # {BfsBruteForce::Solver#solve} will throw a {BfsBruteForce::NoSolution}
+        # exception.
         return if @value > @final
-
-        [1, 10, 100].each do |n|
-          new_value = @value + n
-          if already_seen.add?(new_value)
-            yield "Add #{n}", AdditionPuzzleState.new(new_value, @final)
-          end
+  
+        # already_seen is a set passed to every call of next_states.
+        # You can use this set to record which states you have previously
+        # visited, from a shorter path, avoiding having to visit that
+        # same state again.
+        #
+        # Set#add?(x) will return nil if x is already in the set
+        if already_seen.add?(@value + 10)
+          yield "Add 10", AdditionPuzzleState.new(@value + 10, @final)
+        end
+  
+        if already_seen.add?(@value + 1)
+          yield "Add 1", AdditionPuzzleState.new(@value + 1, @final)
         end
       end
     end
@@ -80,7 +88,7 @@ evaluated state is already known to not be a solution.
 Inside of ```next_states``` you should yield two arguments for every
 valid next state of the puzzle:
 
-1. A string, naming the move required to get to the next state
+1. A user defined string, naming the move required to get to the next state
 2. The next state, as a new instance of your ```BfsBruteForce::State``` class.
 
 Now that you have your ```BfsBruteForce::State``` class, you can
@@ -89,13 +97,77 @@ initialize it with your starting puzzle state, and pass it to
 has a ```moves``` method, which returns an array of the move
 names yielded by your ```next_states``` method:
 
-    solver   = BfsBruteForce::Solver.new
-    solution = solver.solve(AdditionPuzzleState.new(0, 42))
+    # Find shortest path from 0 to 42
+    initial_state = AdditionPuzzleState.new 0, 42
+
+    solver = BfsBruteForce::Solver.new
+    moves  = solver.solve(initial_state).moves
 
-    solution.moves.each_with_index do |move, index|
-      puts "Move %02d) %s" % [index + 1, move]
+    moves.each_with_index do |move, index|
+      puts "Move %d) %s" % [index + 1, move]
     end
 
+Running this code will produce the following output:
+
+    Move 1) Add 10
+    Move 2) Add 10
+    Move 3) Add 10
+    Move 4) Add 10
+    Move 5) Add 1
+    Move 6) Add 1
+
+See [example/simple_addition.rb](example/simple_addition.rb) for the full solution.
+
+### Two Knights Example Puzzle
+
+Swap the white and black knights, using standard chess moves.
+This is the "two knights" puzzle from an old video game, The 11th Hour.
+
+Initial board layout:
+
+      +----+
+    4 | BK |
+      +----+----+----+----+
+    3 |    |    |    | WK |
+      +----+----+----+----+
+    2 | BK | WK |    |
+      +----+----+----+
+    1 |    |    |
+      +----+----+
+        a    b    c    d
+
+    BK = Black Knight
+    WK = White Knight
+
+See [example/two_knights.rb](example/two_knights.rb) for a working solution.
+
+### Four Bishops Example Puzzle
+
+Swap black and white bishops, following standard chess movement
+rules, except that bishops may not move to a square that would allow
+them to be captured by an enemy bishop (they may not put themselves
+in "check").
+
+This is the "four bishops" puzzle from an old video game, The 7th Guest.
+
+Initial Board layout:
+
+      +----+----+----+----+----+
+    4 | BB |    |    |    | WB |
+      +----+----+----+----+----+
+    3 | BB |    |    |    | WB |
+      +----+----+----+----+----+
+    2 | BB |    |    |    | WB |
+      +----+----+----+----+----+
+    1 | BB |    |    |    | WB |
+      +----+----+----+----+----+
+        a    b    c    d    e
+
+    BB = Black Bishop
+    WB = White Bishop
+
+See [example/four_bishops.rb](example/four_bishops.rb) for a working solution.
+
 ## License
 
 Copyright (c) 2014 Joe Sortelli

data/example/.ruby-gemset

@@ -0,0 +1 @@
+bfs_brute_force-example

data/example/.ruby-version

@@ -0,0 +1 @@
+ruby-2.1.4

data/example/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+# Use gem from the source code in this git repo
+gem 'bfs_brute_force',
+    :git    => File.join(File.dirname(__FILE__), '..'),
+    :branch => 'HEAD'

data/example/README.md

@@ -0,0 +1,13 @@
+# BfsBruteForce Example Code
+
+These examples can be run directly, if you have installed the gem
+in your local environment.
+
+    % gem install bfs_brute_force
+    % ./two_knights.rb
+
+Or you can run the examples against the latest source in your local
+```bfs_brute_force``` git repo, by using the ```run_example.rb```
+script, which will use ```bundler``` to load the gem from source.
+
+    % ./run_example.rb two_knights.rb

data/example/four_bishops.rb

@@ -0,0 +1,590 @@
+#!/usr/bin/env ruby
+
+require 'bfs_brute_force'
+
+# Puzzle:
+#
+# Swap black and white bishops, following standard chess movement
+# rules, except that bishops may not move to a square that would allow
+# them to be captured by an enemy bishop (they may not put themselves
+# in "check").
+#
+# This is the "four bishops" puzzle from an old video game, The 7th Guest.
+#
+# Initial Board layout:
+#
+#       +----+----+----+----+----+
+#     4 | BB |    |    |    | WB |
+#       +----+----+----+----+----+
+#     3 | BB |    |    |    | WB |
+#       +----+----+----+----+----+
+#     2 | BB |    |    |    | WB |
+#       +----+----+----+----+----+
+#     1 | BB |    |    |    | WB |
+#       +----+----+----+----+----+
+#         a    b    c    d    e
+#
+#     BB = Black Bishop
+#     WB = White Bishop
+
+class FourBishopsState < BfsBruteForce::State
+  # Legal moves: from_position => [to_position, ...]
+  @@moves = {
+    :a1 => [:b2, :c3, :d4],
+    :a2 => [:b1, :b3, :c4],
+    :a3 => [:b2, :b4, :c1],
+    :a4 => [:b3, :c2, :d1],
+    :b1 => [:a2, :c2, :d3, :e4],
+    :b2 => [:a1, :a3, :c1, :c3, :d4],
+    :b3 => [:a2, :a4, :c2, :c4, :d1],
+    :b4 => [:a3, :c3, :d2, :e1],
+    :c1 => [:a3, :b2, :d2, :e3],
+    :c2 => [:a4, :b1, :b3, :d1, :d3, :e4],
+    :c3 => [:a1, :b2, :b4, :d2, :d4, :e1],
+    :c4 => [:a2, :b3, :d3, :e2],
+    :d1 => [:a4, :b3, :c2, :e2],
+    :d2 => [:b4, :c1, :c3, :e1, :e3],
+    :d3 => [:b1, :c2, :c4, :c4, :e2],
+    :d4 => [:a1, :b2, :c3, :e3],
+    :e1 => [:b4, :c3, :d2],
+    :e2 => [:c4, :d1, :d3],
+    :e3 => [:c1, :d2, :d4],
+    :e4 => [:b1, :c2, :d3]
+  }
+
+  def initialize(bishops = nil)
+    # State of the board: position => bishop
+    @bishops = bishops || {
+      :a1 => :BB, :a2 => :BB, :a3 => :BB, :a4 => :BB,
+      :e1 => :WB, :e2 => :WB, :e3 => :WB, :e4 => :WB
+    }
+  end
+
+  # (see BfsBruteForce::State#solved)
+  def solved?
+    @bishops == {
+      :a1 => :WB, :a2 => :WB, :a3 => :WB, :a4 => :WB,
+      :e1 => :BB, :e2 => :BB, :e3 => :BB, :e4 => :BB
+    }
+  end
+
+  # Yield all not previously seen states from the current state
+  # (see BfsBruteForce::State#already_seen)
+  def next_states(already_seen)
+    @bishops.each do |from, bishop|
+      enemy   = bishop == :WB ? :BB : :WB
+      illegal = @bishops.select {|_, b| b == enemy}.flat_map {|p, _| @@moves[p]}
+
+      @@moves[from].reject do |to|
+        # Skip illegal positions
+        @bishops[to] or illegal.include?(to)
+      end.each do |to|
+        new_bishops = @bishops.merge(to => bishop)
+        new_bishops.delete from
+
+        if already_seen.add?(new_bishops)
+          state = FourBishopsState.new new_bishops
+          move  = "Move #{bishop} from #{from} to #{to}\n#{state}"
+          yield move, state
+        end
+      end
+    end
+  end
+
+  def to_s
+    fmt = %Q{
+        +----+----+----+----+----+
+      4 | %s | %s | %s | %s | %s |
+        +----+----+----+----+----+
+      3 | %s | %s | %s | %s | %s |
+        +----+----+----+----+----+
+      2 | %s | %s | %s | %s | %s |
+        +----+----+----+----+----+
+      1 | %s | %s | %s | %s | %s |
+        +----+----+----+----+----+
+          a    b    c    d    e
+    }
+    fmt % [
+      :a4, :b4, :c4, :d4, :e4,
+      :a3, :b3, :c3, :d3, :e3,
+      :a2, :b2, :c2, :d2, :e2,
+      :a1, :b1, :c1, :d1, :e1
+    ].map {|index| @bishops[index] || '  '}
+  end
+end
+
+solver = BfsBruteForce::Solver.new
+moves  = solver.solve(FourBishopsState.new).moves
+
+puts moves
+
+# Running this code will produce the following output:
+#
+# Move BB from a2 to b3
+#
+#         +----+----+----+----+----+
+#       4 | BB |    |    |    | WB |
+#         +----+----+----+----+----+
+#       3 | BB | BB |    |    | WB |
+#         +----+----+----+----+----+
+#       2 |    |    |    |    | WB |
+#         +----+----+----+----+----+
+#       1 | BB |    |    |    | WB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from a3 to b2
+#
+#         +----+----+----+----+----+
+#       4 | BB |    |    |    | WB |
+#         +----+----+----+----+----+
+#       3 |    | BB |    |    | WB |
+#         +----+----+----+----+----+
+#       2 |    | BB |    |    | WB |
+#         +----+----+----+----+----+
+#       1 | BB |    |    |    | WB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from e1 to b4
+#
+#         +----+----+----+----+----+
+#       4 | BB | WB |    |    | WB |
+#         +----+----+----+----+----+
+#       3 |    | BB |    |    | WB |
+#         +----+----+----+----+----+
+#       2 |    | BB |    |    | WB |
+#         +----+----+----+----+----+
+#       1 | BB |    |    |    |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from e2 to d3
+#
+#         +----+----+----+----+----+
+#       4 | BB | WB |    |    | WB |
+#         +----+----+----+----+----+
+#       3 |    | BB |    | WB | WB |
+#         +----+----+----+----+----+
+#       2 |    | BB |    |    |    |
+#         +----+----+----+----+----+
+#       1 | BB |    |    |    |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from a4 to d1
+#
+#         +----+----+----+----+----+
+#       4 |    | WB |    |    | WB |
+#         +----+----+----+----+----+
+#       3 |    | BB |    | WB | WB |
+#         +----+----+----+----+----+
+#       2 |    | BB |    |    |    |
+#         +----+----+----+----+----+
+#       1 | BB |    |    | BB |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from e3 to d2
+#
+#         +----+----+----+----+----+
+#       4 |    | WB |    |    | WB |
+#         +----+----+----+----+----+
+#       3 |    | BB |    | WB |    |
+#         +----+----+----+----+----+
+#       2 |    | BB |    | WB |    |
+#         +----+----+----+----+----+
+#       1 | BB |    |    | BB |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from b2 to d4
+#
+#         +----+----+----+----+----+
+#       4 |    | WB |    | BB | WB |
+#         +----+----+----+----+----+
+#       3 |    | BB |    | WB |    |
+#         +----+----+----+----+----+
+#       2 |    |    |    | WB |    |
+#         +----+----+----+----+----+
+#       1 | BB |    |    | BB |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from b4 to a3
+#
+#         +----+----+----+----+----+
+#       4 |    |    |    | BB | WB |
+#         +----+----+----+----+----+
+#       3 | WB | BB |    | WB |    |
+#         +----+----+----+----+----+
+#       2 |    |    |    | WB |    |
+#         +----+----+----+----+----+
+#       1 | BB |    |    | BB |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from d3 to b1
+#
+#         +----+----+----+----+----+
+#       4 |    |    |    | BB | WB |
+#         +----+----+----+----+----+
+#       3 | WB | BB |    |    |    |
+#         +----+----+----+----+----+
+#       2 |    |    |    | WB |    |
+#         +----+----+----+----+----+
+#       1 | BB | WB |    | BB |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from b3 to c4
+#
+#         +----+----+----+----+----+
+#       4 |    |    | BB | BB | WB |
+#         +----+----+----+----+----+
+#       3 | WB |    |    |    |    |
+#         +----+----+----+----+----+
+#       2 |    |    |    | WB |    |
+#         +----+----+----+----+----+
+#       1 | BB | WB |    | BB |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from d1 to e2
+#
+#         +----+----+----+----+----+
+#       4 |    |    | BB | BB | WB |
+#         +----+----+----+----+----+
+#       3 | WB |    |    |    |    |
+#         +----+----+----+----+----+
+#       2 |    |    |    | WB | BB |
+#         +----+----+----+----+----+
+#       1 | BB | WB |    |    |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from e4 to c2
+#
+#         +----+----+----+----+----+
+#       4 |    |    | BB | BB |    |
+#         +----+----+----+----+----+
+#       3 | WB |    |    |    |    |
+#         +----+----+----+----+----+
+#       2 |    |    | WB | WB | BB |
+#         +----+----+----+----+----+
+#       1 | BB | WB |    |    |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from d2 to c1
+#
+#         +----+----+----+----+----+
+#       4 |    |    | BB | BB |    |
+#         +----+----+----+----+----+
+#       3 | WB |    |    |    |    |
+#         +----+----+----+----+----+
+#       2 |    |    | WB |    | BB |
+#         +----+----+----+----+----+
+#       1 | BB | WB | WB |    |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from a1 to c3
+#
+#         +----+----+----+----+----+
+#       4 |    |    | BB | BB |    |
+#         +----+----+----+----+----+
+#       3 | WB |    | BB |    |    |
+#         +----+----+----+----+----+
+#       2 |    |    | WB |    | BB |
+#         +----+----+----+----+----+
+#       1 |    | WB | WB |    |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from c2 to a4
+#
+#         +----+----+----+----+----+
+#       4 | WB |    | BB | BB |    |
+#         +----+----+----+----+----+
+#       3 | WB |    | BB |    |    |
+#         +----+----+----+----+----+
+#       2 |    |    |    |    | BB |
+#         +----+----+----+----+----+
+#       1 |    | WB | WB |    |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from b1 to c2
+#
+#         +----+----+----+----+----+
+#       4 | WB |    | BB | BB |    |
+#         +----+----+----+----+----+
+#       3 | WB |    | BB |    |    |
+#         +----+----+----+----+----+
+#       2 |    |    | WB |    | BB |
+#         +----+----+----+----+----+
+#       1 |    |    | WB |    |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from c4 to a2
+#
+#         +----+----+----+----+----+
+#       4 | WB |    |    | BB |    |
+#         +----+----+----+----+----+
+#       3 | WB |    | BB |    |    |
+#         +----+----+----+----+----+
+#       2 | BB |    | WB |    | BB |
+#         +----+----+----+----+----+
+#       1 |    |    | WB |    |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from e2 to c4
+#
+#         +----+----+----+----+----+
+#       4 | WB |    | BB | BB |    |
+#         +----+----+----+----+----+
+#       3 | WB |    | BB |    |    |
+#         +----+----+----+----+----+
+#       2 | BB |    | WB |    |    |
+#         +----+----+----+----+----+
+#       1 |    |    | WB |    |    |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from c3 to e1
+#
+#         +----+----+----+----+----+
+#       4 | WB |    | BB | BB |    |
+#         +----+----+----+----+----+
+#       3 | WB |    |    |    |    |
+#         +----+----+----+----+----+
+#       2 | BB |    | WB |    |    |
+#         +----+----+----+----+----+
+#       1 |    |    | WB |    | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from d4 to c3
+#
+#         +----+----+----+----+----+
+#       4 | WB |    | BB |    |    |
+#         +----+----+----+----+----+
+#       3 | WB |    | BB |    |    |
+#         +----+----+----+----+----+
+#       2 | BB |    | WB |    |    |
+#         +----+----+----+----+----+
+#       1 |    |    | WB |    | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from c1 to e3
+#
+#         +----+----+----+----+----+
+#       4 | WB |    | BB |    |    |
+#         +----+----+----+----+----+
+#       3 | WB |    | BB |    | WB |
+#         +----+----+----+----+----+
+#       2 | BB |    | WB |    |    |
+#         +----+----+----+----+----+
+#       1 |    |    |    |    | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from a3 to c1
+#
+#         +----+----+----+----+----+
+#       4 | WB |    | BB |    |    |
+#         +----+----+----+----+----+
+#       3 |    |    | BB |    | WB |
+#         +----+----+----+----+----+
+#       2 | BB |    | WB |    |    |
+#         +----+----+----+----+----+
+#       1 |    |    | WB |    | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from c2 to d1
+#
+#         +----+----+----+----+----+
+#       4 | WB |    | BB |    |    |
+#         +----+----+----+----+----+
+#       3 |    |    | BB |    | WB |
+#         +----+----+----+----+----+
+#       2 | BB |    |    |    |    |
+#         +----+----+----+----+----+
+#       1 |    |    | WB | WB | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from a2 to b1
+#
+#         +----+----+----+----+----+
+#       4 | WB |    | BB |    |    |
+#         +----+----+----+----+----+
+#       3 |    |    | BB |    | WB |
+#         +----+----+----+----+----+
+#       2 |    |    |    |    |    |
+#         +----+----+----+----+----+
+#       1 |    | BB | WB | WB | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from c4 to d3
+#
+#         +----+----+----+----+----+
+#       4 | WB |    |    |    |    |
+#         +----+----+----+----+----+
+#       3 |    |    | BB | BB | WB |
+#         +----+----+----+----+----+
+#       2 |    |    |    |    |    |
+#         +----+----+----+----+----+
+#       1 |    | BB | WB | WB | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from c3 to b4
+#
+#         +----+----+----+----+----+
+#       4 | WB | BB |    |    |    |
+#         +----+----+----+----+----+
+#       3 |    |    |    | BB | WB |
+#         +----+----+----+----+----+
+#       2 |    |    |    |    |    |
+#         +----+----+----+----+----+
+#       1 |    | BB | WB | WB | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from e3 to d4
+#
+#         +----+----+----+----+----+
+#       4 | WB | BB |    | WB |    |
+#         +----+----+----+----+----+
+#       3 |    |    |    | BB |    |
+#         +----+----+----+----+----+
+#       2 |    |    |    |    |    |
+#         +----+----+----+----+----+
+#       1 |    | BB | WB | WB | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from c1 to b2
+#
+#         +----+----+----+----+----+
+#       4 | WB | BB |    | WB |    |
+#         +----+----+----+----+----+
+#       3 |    |    |    | BB |    |
+#         +----+----+----+----+----+
+#       2 |    | WB |    |    |    |
+#         +----+----+----+----+----+
+#       1 |    | BB |    | WB | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from d1 to b3
+#
+#         +----+----+----+----+----+
+#       4 | WB | BB |    | WB |    |
+#         +----+----+----+----+----+
+#       3 |    | WB |    | BB |    |
+#         +----+----+----+----+----+
+#       2 |    | WB |    |    |    |
+#         +----+----+----+----+----+
+#       1 |    | BB |    |    | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from b1 to e4
+#
+#         +----+----+----+----+----+
+#       4 | WB | BB |    | WB | BB |
+#         +----+----+----+----+----+
+#       3 |    | WB |    | BB |    |
+#         +----+----+----+----+----+
+#       2 |    | WB |    |    |    |
+#         +----+----+----+----+----+
+#       1 |    |    |    |    | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from d3 to e2
+#
+#         +----+----+----+----+----+
+#       4 | WB | BB |    | WB | BB |
+#         +----+----+----+----+----+
+#       3 |    | WB |    |    |    |
+#         +----+----+----+----+----+
+#       2 |    | WB |    |    | BB |
+#         +----+----+----+----+----+
+#       1 |    |    |    |    | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from b4 to d2
+#
+#         +----+----+----+----+----+
+#       4 | WB |    |    | WB | BB |
+#         +----+----+----+----+----+
+#       3 |    | WB |    |    |    |
+#         +----+----+----+----+----+
+#       2 |    | WB |    | BB | BB |
+#         +----+----+----+----+----+
+#       1 |    |    |    |    | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from d4 to a1
+#
+#         +----+----+----+----+----+
+#       4 | WB |    |    |    | BB |
+#         +----+----+----+----+----+
+#       3 |    | WB |    |    |    |
+#         +----+----+----+----+----+
+#       2 |    | WB |    | BB | BB |
+#         +----+----+----+----+----+
+#       1 | WB |    |    |    | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from b2 to a3
+#
+#         +----+----+----+----+----+
+#       4 | WB |    |    |    | BB |
+#         +----+----+----+----+----+
+#       3 | WB | WB |    |    |    |
+#         +----+----+----+----+----+
+#       2 |    |    |    | BB | BB |
+#         +----+----+----+----+----+
+#       1 | WB |    |    |    | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move WB from b3 to a2
+#
+#         +----+----+----+----+----+
+#       4 | WB |    |    |    | BB |
+#         +----+----+----+----+----+
+#       3 | WB |    |    |    |    |
+#         +----+----+----+----+----+
+#       2 | WB |    |    | BB | BB |
+#         +----+----+----+----+----+
+#       1 | WB |    |    |    | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#
+# Move BB from d2 to e3
+#
+#         +----+----+----+----+----+
+#       4 | WB |    |    |    | BB |
+#         +----+----+----+----+----+
+#       3 | WB |    |    |    | BB |
+#         +----+----+----+----+----+
+#       2 | WB |    |    |    | BB |
+#         +----+----+----+----+----+
+#       1 | WB |    |    |    | BB |
+#         +----+----+----+----+----+
+#           a    b    c    d    e
+#