Added BeamFinder support.  The beam finder, when enabled, will rank all emitting tokens based upon their position in the beam and their ranking when compared to the best scoring token for a frame.
Added BeamFinder support.  The beam finder, when enabled, will rank
all emitting tokens based upon their position in the beam and their
ranking when compared to the best scoring token for a frame.

The beam finder reports the average and maximum absolute and relative
beams for all tokens making up the winning hypothesis.  It also keeps
track of the overall maximum beam.

The output of the beam finder can be analyzed and used to select
absolute and relative beam sizes to optimize speed and/or accuracy.

To enable the beamfinder set the property:

edu.cmu.sphinx.util.BeamFinder.enable

to true.


Typically, the beam finder is run with a very wide beam. Also note
that since the WordPruningBreadthFirstSearchManager does not keep all
tokens (it drops tokens that are not word/unit tokens) it will not
work well the beam finder.


git-svn-id: a8b04003a33e1d3e001b9d20391fa392a9f62d91@1996 94700074-3cef-4d97-a70e-9c8c206c02f5

deepstupid/sphinx5