From 4f82a0b3c3cd71f682a5c447638672f53851f923 Mon Sep 17 00:00:00 2001
From: Petr Baudis <pasky@ucw.cz>
Date: Sat, 7 Jan 2012 18:45:29 +0100
Subject: [PATCH] tools/sgf-ratemove.sh: New tool to do what was just described
 in README up to now

---
 README                | 42 +++++++++++++-----------------------------
 tools/sgf-ratemove.sh | 31 +++++++++++++++++++++++++++++++
 2 files changed, 44 insertions(+), 29 deletions(-)
 create mode 100755 tools/sgf-ratemove.sh

diff --git a/README b/README
index a8ff0cb..88539d8 100644
--- a/README
+++ b/README
@@ -119,43 +119,27 @@ Pachi can also help you analyze your games by being able to provide
 its opinion on various positions. The user interface is very rudimentary,
 but the ability is certainly there.
 
-There are currently two Pachi interfaces provided for this purpose. One
-possibility is to evaluate all moves within a given game and show how
+There are currently several Pachi interfaces provided for this purpose.
+
+Winrate Development
+~~~~~~~~~~~~~~~~~~~
+
+Pachi can evaluate all moves within a given game and show how
 the winrates for both players evolved - i.e. who was winning at which
 game stage. This is implemented using the `tools/sgf-analyse.pl` script.
 See the comment on top of the script about its usage.
 
-Alternatively, Pachi can evaluate all available moves in a given situation
+Move Ranking
+~~~~~~~~~~~~
+
+Pachi can evaluate all available moves in a given situation
 and for each give a value between 0 and 1 representing perceived
 likelihood of winning the game if one would play that move. I.e. it can
 suggest which moves would be good and bad in a single given situation.
 
-To achieve the latter, follow few simple steps:
-
-1. Take an SGF record of your game and generate a GTP file from it:
-
-	tools/sgf2gtp.pl <file.sgf >file.gtp
-
-2. Open the file.gtp in your favorite plaintext editor and trim it after
-(remove all lines following) the move producing the situation you wish
-to analyze.
-
-3. Instead, add the following line at the bottom of file.gtp:
-
-	0 uct_evaluate black
-
-(replace `black` with `white` if it is white to play).
-
-4. Run Pachi as follows:
-
-	./pachi -t =500 -d 0 <file.gtp | sed -n '/^=0/,${s/^=0 //;p}'
-
-If you want to know more details on what is Pachi thinking about the
-various moves, remove the `-d 0` and `| sed -n ...` parts. To improve
-the accuracy of values (at the expense of run time), raise the value
-of 500 (try 2000 or 10000; 100000 will usually already take couple of
-hours). The values will be most useful in the middle game; in fuseki
-and most yose situations, expect a lot of noise.
+To achieve the latter, note the number of move at the situation you
+want to evaluate and run the `tools/sgf-ratemove.sh` script.
+See the comment on top of the script about its usage.
 
 
 Framework
diff --git a/tools/sgf-ratemove.sh b/tools/sgf-ratemove.sh
new file mode 100755
index 0000000..390139a
--- /dev/null
+++ b/tools/sgf-ratemove.sh
@@ -0,0 +1,31 @@
+#!/bin/sh
+# Simple script using Pachi for rating all moves in a given situation.
+# Pachi will analyse each followup move and suggest a winrate for it;
+# higher is better.
+#
+# Usage: tools/sgf-ratemove.sh SGF MOVENUM PACHIARGS...
+#
+# Note that this script assumes dynkomi=none and does not show
+# dynamic komi information. (Would be trivial to add but it's tricky
+# to interpret the data.)
+#
+# This script is dirty and insecure for untrusted input!
+#
+# Example: tools/sgf-ratemove.sh progame.sgf 120 -t =500 -d 0
+# ...to get 500 simulations per each possible move in programe.sgf
+# at move 120.
+# 
+# If you want to know more details on what is Pachi thinking about the
+# various moves, remove the `-d 0` part. To improve the accuracy of values
+# (at the expense of run time), raise the value of 500 (try 2000 or 10000;
+# 100000 will usually already take couple of hours). The values will be
+# most useful in the middle game; in fuseki and most yose situations,
+# expect a lot of noise.
+
+sgf=$1; shift
+movenum=$1; shift
+tools/sgf2gtp.pl -g -n $movenum <"$sgf" |
+	sed -e 's/genmove/0 uct_evaluate/' |
+	./pachi "$@" |
+	sed -ne '/^=0/,${s/^=0 //;p}' |
+	sort -n -t ' ' -k 2
-- 
2.11.4.GIT