Notation conversion, get_num_pieces function, and misc.

README.md

@@ -48,7 +48,7 @@ There are some default engine settings used by this wrapper. For increasing Stoc
 }
 ```
 
-You can change them, as well as the default search depth, during your Stockfish class initialization:
+You can change them, as well as the search depth, during your Stockfish class initialization:
 ```python
 stockfish = Stockfish(path="/Users/zhelyabuzhsky/Work/stockfish/stockfish-9-64", depth=18, parameters={"Threads": 2, "Minimum Thinking Time": 30})
 ```
@@ -58,6 +58,11 @@ These parameters can also be updated at any time by calling the "update_engine_p
 stockfish.update_engine_parameters({"Hash": 2048, "UCI_Chess960": "true"}) # Gets stockfish to use a 2GB hash table, and also to play Chess960.
 ```
 
+As for the depth, it can also be updated, by using the following function. Note that if you don't set depth to a value yourself, the python module will initialize it to 15 by default.
+```python
+stockfish.set_depth(12)
+```
+
 When you're done using the Stockfish engine process, you can send the "quit" uci command to it with:
 ```python
 stockfish.send_quit_command()
@@ -121,6 +126,7 @@ e2e4
 ```
 
 ### Check is move correct with current position
+Returns True if the passed in move is legal in the current position.
 ```python
 stockfish.is_move_correct('a2a3')
 ```
@@ -129,17 +135,33 @@ True
 ```
 
 ### Get info on the top n moves
+Returns a list of dictionaries, where each dictionary represents a move's info. Each dictionary will contain a value for the 'Move' key,
+and either the 'Centipawn' or 'Mate' value will be a number (the other will be None). Positive values mean advantage for White, negative means
+advantage for Black. E.g., 'Mate': 3 means that White can mate in three moves, 'Mate': -2 means Black mates in two moves, 'Centipawn': -20 means the
+evaluation is -0.20 (0.20 advantage in Black's favour).
+E.g., for an example position where White is to move, and the top moves are either a mate, winning material, or being slightly worse:
 ```python
 stockfish.get_top_moves(3)
 ```
 ```text
 [
-    {'Move': 'f5h7', 'Centipawn': None, 'Mate': 1},
-    {'Move': 'f5d7', 'Centipawn': 713, 'Mate': None},
-    {'Move': 'f5h5', 'Centipawn': -31, 'Mate': None}
+    {'Move': 'f5h7', 'Centipawn': None, 'Mate': 1}, # the move f5h7 leads to a mate in 1
+    {'Move': 'f5d7', 'Centipawn': 713, 'Mate': None}, # f5d7 leads to an evaluation of +7.13
+    {'Move': 'f5h5', 'Centipawn': -31, 'Mate': None} # f5h5 leads to an evaluation of -0.31
 ]
 ```
 
+### Get current board evaluation in centipawns or mate in x
+```python 
+stockfish.get_evaluation()
+```
+Positive is advantage white, negative is advantage black.
+```text
+{"type":"cp", "value":12} # This being the return value would mean White is better by 0.12.
+
+{"type":"mate", "value":-3} # This being the return value would mean Black can checkmate in 3.
+```
+
 ### Get Stockfish's win/draw/loss stats for the side to move in the current position  
 Before calling this function, it is recommended that you first check if your version of Stockfish is recent enough to display WDL stats. To do this,  
 use the "does_current_engine_version_have_wdl_option()" function below.
@@ -168,11 +190,6 @@ stockfish.set_skill_level(15)
 stockfish.set_elo_rating(1350)
 ```
 
-### Set current engine's depth
-```python
-stockfish.set_depth(15)
-```
-
 ### Get current engine's parameters
 ```python
 stockfish.get_parameters()
@@ -258,16 +275,6 @@ stockfish.get_board_visual(False)
   h   g   f   e   d   c   b   a
 ```
 
-### Get current board evaluation in centipawns or mate in x
-```python 
-stockfish.get_evaluation()
-```
-Positive is advantage white, negative is advantage black
-```text
-{"type":"cp", "value":12}
-{"type":"mate", "value":-3}
-```
-
 ### Run benchmark
 
 #### BenchmarkParameters
@@ -311,6 +318,12 @@ stockfish.is_development_build_of_engine()
 False
 ```
 
+### Send the "ucinewgame" command to the Stockfish engine process. 
+The main effect this command has is clearing SF's transposition table, and for most use cases it's probably not worth doing this. Frequently sending this command can end up being a bottleneck on performance.
+```python
+stockfish.send_ucinewgame_command()
+```
+
 ### Find what is on a certain square
 If the square is empty, the None object is returned. Otherwise, one of 12 enum members of a custom  
 Stockfish.Piece enum will be returned. Each of the 12 members of this enum is named in the following pattern:  
@@ -334,6 +347,19 @@ stockfish.will_move_be_a_capture("e5d6")  # returns Stockfish.Capture.EN_PASSANT
 stockfish.will_move_be_a_capture("f1e2")  # returns Stockfish.Capture.NO_CAPTURE  
 ```
 
+### Convert human-style notation into the notation Stockfish uses
+The argument is a string representing the move, written in some form that's used by humans. E.g., for using an e4-pawn to capture on d5, a string like
+"e4xd5" or "exd5" could be sent in as a valid argument. The function would then return "e4d5".
+```python
+stockfish.convert_human_notation_to_sf_notation("e4xd5") # returns "e4d5"
+```
+Or, say there are two rooks on a5 and b6, and an enemy piece on a6. The following are all valid "human-style" notations for the a5-rook capturing on a6: "Raxa6", "Raa6", "R5xa6", "R5a6".
+```python
+stockfish.convert_human_notation_to_sf_notation("Raxa6") # returns "a5a6"
+```
+It's also valid for the argument to already be in the style Stockfish uses. E.g., sending in "a5a6" to the function just gets "a5a6" back.
+If an invalid argument (bad syntax, or an illegal move) is sent to the function, a ValueError will be raised.
+
 ### StockfishException
 
 The `StockfishException` is a newly defined Exception type. It is thrown when the underlying Stockfish process created by the wrapper crashes. This can happen when an incorrect input like an invalid FEN (for example ```8/8/8/3k4/3K4/8/8/8 w - - 0 1``` with both kings next to each other) is given to Stockfish. \