Various minor fixes, plus adding (prototype) glossary page.

git-svn-id: https://svn.code.sf.net/p/kaldi/code/trunk@5214 5e6a8d80-dfce-4ca6-a32a-6e07a63d50c8

egs/wsj/s5/steps/nnet2/train_more.sh

@@ -57,6 +57,8 @@ if [ $# != 3 ]; then
   echo "Usage: $0 [opts] <input-model> <egs-dir> <exp-dir>"
   echo " e.g.: $0 exp/nnet4c/final.mdl exp/nnet4c/egs exp/nnet5c/"
   echo "see also the older script update_nnet.sh which creates the egs itself"
+  echo "You probably now want to use train_more2.sh, which uses the newer,"
+  echo "more compact egs format."
   echo ""
   echo "Main options (for others, see top of script file)"
   echo "  --config <config-file>                           # config file containing options"

src/bin/show-alignments.cc

@@ -33,7 +33,7 @@ int main(int argc, char *argv[]) {
         "Usage:  show-alignments  [options] <phone-syms> <model> <alignments-rspecifier>\n"
         "e.g.: \n"
         " show-alignments phones.txt 1.mdl ark:1.ali\n"
-        "See also: ali-to-phones\n";
+        "See also: ali-to-phones, copy-int-vector\n";
     ParseOptions po(usage);
 
     po.Read(argc, argv);

src/doc/glossary.dox

+// doc/glossary.dox
+
+// Copyright 2015  Johns Hopkins University (author: Daniel Povey)
+
+// See ../../COPYING for clarification regarding multiple authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+
+//  http://www.apache.org/licenses/LICENSE-2.0
+
+// THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
+// WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
+// MERCHANTABLITY OR NON-INFRINGEMENT.
+// See the Apache 2 License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ \page glossary  Glossary of terms
+
+ This page contains a glossary of terms that Kaldi users might want to know
+ about.  The current content here consists just of a few examples; more content
+ will be added shortly.  The easiest way to search in this page is to use the
+ search function of your browser.  For convenience the definition of each
+ term's section is preceded and followed by a colon, so for
+ instance, typing ctrl-f ":lattice:" would take you to the section for "lattice".
+ 
+
+<div style="text-indent: -1.5em;  padding-left: 1.5em;">
+
+
+<b>:alignment:</b> A representation of the sequence of HMM states taken by the
+Viterbi (best-path) alignment of an utterance.  In Kaldi an alignment is
+synonymous with a sequence of <b>transition-ids</b>.  Most of the time an
+alignment is derived from aligning the reference transcript of an utterance,
+in which case it is called a <b>forced alignment</b>.  <b>lattices</b> also
+contain alignment information as sequences of transition-ids for each word
+sequence in the lattice.  The program \ref bin/show-alignments.cc "show-alignments" shows 
+alignments in a human-readable format.
+
+<b>:forced alignment:</b> see <b>alignment</b>.
+
+<b>:lattice:</b>  A representation of alternative likely transcriptions of an utterance, together
+ with associated alignment and cost information.  See \ref lattices.
+
+<b>:transition-id:</b> a one-based index that encodes the pdf-id (i.e. the clustered context-dependent HMM state),
+the phone identity, and information about whether we took the self-loop or forward transition in the HMM.
+Appears in lattices, decoding graphs and alignments.  See \ref transition_model.
+
+<b>:transition model:</b> The TransitionModel object encodes the transition probabilities
+of the HMMs, and also various other important integer mappings; see \ref transition_model.
+This object is generally written at the start of model files.  The program
+\ref bin/show-transitions.cc "show-transitions" shows these.
+
+</div>
+
+*/

src/doc/mainpage.dox

@@ -40,6 +40,7 @@
    - \subpage dependencies
    - \subpage legal
    - \subpage tutorial
+   - \subpage glossary
    - \subpage data_prep
    - \subpage build_setup 
    - \subpage style 

src/nnet2/nnet-component-test.cc

@@ -682,7 +682,7 @@ void UnitTestSpliceComponent() {
       const_dim =  RandInt(0, 10),
       left_context = RandInt(-5, 0),
       right_context = RandInt(0, 5),
-      num_chunks = RandInt(0, 20); 
+      num_chunks = RandInt(1, 20); 
         // multiple chunks are required as splice component
         // has separate index computation logic for more than one chunks
   KALDI_LOG << " Feat_dim :" << feat_dim << " const_dim: " << const_dim  ;