* Move suboptions out of top-level "method" parameter into separate

  parameters; the top-level method parameter is now just
    keyword method "what should this thorn do for each apparent horizon?"
    {
    # these options are mostly for testing/debugging
    "horizon function"      :: "evaluate the LHS function H(h)"
    "test Jacobian"         :: "compute/print the J[H(h)] Jacobian matrix"

    # this is for normal apparent horizon finding
    "find horizon"          :: "find the apparent horizon"
    } "find horizon"
  The keyword strings have changed a bit, but since most users will
  not need to change the default value, this shouldn't change their
  parameter files.
* Revise driver logic to clean up handling of the different values
  of the top-level method parameter.
* Slightly tweak output format for BH diagnostics, and documentation
  (thorn guide) to make it explicit that what we're calculating is the
  irreducible mass of the apparent horizon.


Modified Files:
	param.ccl doc/documentation.tex par/misner-run.par
	run/test-ahfinderdirect/misc/Kerr.par
	run/test-ahfinderdirect/misc/try-5.par
	run/test-ahfinderdirect/misc/try-7.5-debug.par
	run/test-ahfinderdirect/misc/try-7.5.par
	run/test-ahfinderdirect/misc/try-9.par src/driver/driver.hh
	src/driver/find_horizons.cc src/driver/setup.cc
Added Files:
	# new par file to compute/print the analytical horizon
	# for this Kerr/Schild test, for comparison with numerical ones
	run/test-ahfinderdirect/misc/try-7.5-horizon.par


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

1 files changed, 7 insertions, 6 deletions

diff --git a/doc/documentation.tex b/doc/documentation.tex
index 68fcbe2..5236c65 100644
--- a/doc/documentation.tex
+++ b/doc/documentation.tex
@@ -787,12 +787,13 @@ $\bar{\bf x}^i \equiv \int\! {\bf x}^i \, dS \big/ \int\! dS$
 is computed about as accurately, but is quite coordinate-dependent
 and gives only an approximate estimate of the black hole position.
 
-The apparent horizon mass is currently defined (very crudely) as
-$m \equiv \sqrt{A/16\pi}$.  Even for Kerr spacetime this formula
-deviates significantly from the true black hole mass if the spin
-is large.  (For example, for spin~$0.6$, $0.8$, and $0.999$ this
-gives $m/m_\text{true} = 0.949$, $0.894$, and $0.723$.)  A better
-technique would be to use the ``isolated horizons'' formalism of
+At present the only mass estimate available for an apparent horizon
+is the irreducible mass $m_\text{irreducible} \equiv \sqrt{A/16\pi}$.
+Note that even for Kerr spacetime, this formula deviates significantly
+from the ADM black hole mass if the spin is large.  (For example,
+for spin~$0.6$, $0.8$, and $0.999$, gives
+$m_\text{irreducible}/m_\text{ADM} = 0.949$, $0.894$, and $0.723$.)
+It would be better to (also) use the ``isolated horizons'' formalism of
 \cite{AEIDevelopment_AHFinderDirect_Dreyer-etal-2002-isolated-horizons};
 at some point this thorn may be enhanced to do this.