mention select.plane script

and give an example of how to use it to show the shape of an AH
in the xy plane


git-svn-id: http://svn.einsteintoolkit.org/cactus/EinsteinAnalysis/AHFinderDirect/trunk@1411 f88db872-0e4f-0410-b76b-b9085cfa78c5

1 files changed, 17 insertions, 0 deletions

diff --git a/doc/documentation.tex b/doc/documentation.tex
index 5c6551f..8b6e28a 100644
--- a/doc/documentation.tex
+++ b/doc/documentation.tex
@@ -1508,6 +1508,23 @@ splot 'h.t105.h4.gp' using 4:5:6 with lines
 \end{verbatim}
 which will plot the 3-D shape of the apparent horizon surface.
 
+The \verb|src/misc| directory of the \thorn{AHFinderDirect} source
+code contains several perl scripts which are useful in visualizing
+\thorn{AHFinderDirect} output.  In particular, the script \verb|select.plane|
+selects a particular 2-D plane.  If you put this in your Unix path,
+it can be used with a gnuplot command like
+\begin{verbatim}
+splot '<select.plane xy <h.t105.h4.gp' using 4:5 with lines
+\end{verbatim}
+to show the shape of an apparent horizon in the xy plane.%%%
+\footnote{%%%
+	 Note that this script isn't very smart: it doesn't
+	 know about the \thorn{AHFinderDirect} local coordinate
+	 origin.  That is, for example, if you select the $xy$
+	 plane, you're selecting the \emph{global} $xy$ plane
+	 ($z=0$).
+	 }%%%
+
 Another Visualization option is OpenDX (\verb|http://www.opendx.org/|).
 Thomas Radke's has written some OpenDX macros
 \program{ImportAHFinderDirectGnuplot.net}