1 #!/bin/bash
3 # Copyright 2012-2015 Johns Hopkins University (Author: Daniel Povey).
4 # Apache 2.0.
6 # This script does decoding with a neural-net. If the neural net was built on
7 # top of fMLLR transforms from a conventional system, you should provide the
8 # --transform-dir option.
10 # Begin configuration section.
11 stage=1
12 transform_dir= # dir to find fMLLR transforms.
13 nj=4 # number of decoding jobs. If --transform-dir set, must match that number!
14 acwt=0.1 # Just a default value, used for adaptation and beam-pruning..
15 cmd=run.pl
16 beam=15.0
17 frames_per_chunk=50
18 max_active=7000
19 min_active=200
20 ivector_scale=1.0
21 lattice_beam=8.0 # Beam we use in lattice generation.
22 iter=final
23 num_threads=1 # if >1, will use gmm-latgen-faster-parallel
24 parallel_opts= # ignored now.
25 scoring_opts=
26 skip_scoring=false
27 feat_type=
28 online_ivector_dir=
29 minimize=false
30 # End configuration section.
32 echo "$0 $@" # Print the command line for logging
34 [ -f ./path.sh ] && . ./path.sh; # source the path.
35 . parse_options.sh || exit 1;
37 if [ $# -ne 3 ]; then
38 echo "Usage: $0 [options] <graph-dir> <data-dir> <decode-dir>"
39 echo "e.g.: steps/nnet3/decode.sh --nj 8 \\"
40 echo "--online-ivector-dir exp/nnet2_online/ivectors_test_eval92 \\"
41 echo " exp/tri4b/graph_bg data/test_eval92_hires $dir/decode_bg_eval92"
42 echo "main options (for others, see top of script file)"
43 echo " --transform-dir <decoding-dir> # directory of previous decoding"
44 echo " # where we can find transforms for SAT systems."
45 echo " --config <config-file> # config containing options"
46 echo " --nj <nj> # number of parallel jobs"
47 echo " --cmd <cmd> # Command to run in parallel with"
48 echo " --beam <beam> # Decoding beam; default 15.0"
49 echo " --iter <iter> # Iteration of model to decode; default is final."
50 echo " --scoring-opts <string> # options to local/score.sh"
51 echo " --num-threads <n> # number of threads to use, default 1."
52 echo " --parallel-opts <opts> # e.g. '--num-threads 4' if you supply --num-threads 4"
53 exit 1;
54 fi
56 graphdir=$1
57 data=$2
58 dir=$3
59 srcdir=`dirname $dir`; # Assume model directory one level up from decoding directory.
60 model=$srcdir/$iter.mdl
63 [ ! -z "$online_ivector_dir" ] && \
64 extra_files="$online_ivector_dir/ivector_online.scp $online_ivector_dir/ivector_period"
66 for f in $graphdir/HCLG.fst $data/feats.scp $model $extra_files; do
67 [ ! -f $f ] && echo "$0: no such file $f" && exit 1;
68 done
70 sdata=$data/split$nj;
71 cmvn_opts=`cat $srcdir/cmvn_opts` || exit 1;
72 thread_string=
73 [ $num_threads -gt 1 ] && thread_string="-parallel --num-threads=$num_threads"
75 mkdir -p $dir/log
76 [[ -d $sdata && $data/feats.scp -ot $sdata ]] || split_data.sh $data $nj || exit 1;
77 echo $nj > $dir/num_jobs
80 ## Set up features.
81 if [ -z "$feat_type" ]; then
82 if [ -f $srcdir/final.mat ]; then feat_type=lda; else feat_type=raw; fi
83 echo "$0: feature type is $feat_type"
84 fi
86 splice_opts=`cat $srcdir/splice_opts 2>/dev/null`
88 case $feat_type in
89 raw) feats="ark,s,cs:apply-cmvn $cmvn_opts --utt2spk=ark:$sdata/JOB/utt2spk scp:$sdata/JOB/cmvn.scp scp:$sdata/JOB/feats.scp ark:- |";;
90 lda) feats="ark,s,cs:apply-cmvn $cmvn_opts --utt2spk=ark:$sdata/JOB/utt2spk scp:$sdata/JOB/cmvn.scp scp:$sdata/JOB/feats.scp ark:- | splice-feats $splice_opts ark:- ark:- | transform-feats $srcdir/final.mat ark:- ark:- |"
91 ;;
92 *) echo "$0: invalid feature type $feat_type" && exit 1;
93 esac
94 if [ ! -z "$transform_dir" ]; then
95 echo "$0: using transforms from $transform_dir"
96 [ ! -s $transform_dir/num_jobs ] && \
97 echo "$0: expected $transform_dir/num_jobs to contain the number of jobs." && exit 1;
98 nj_orig=$(cat $transform_dir/num_jobs)
100 if [ $feat_type == "raw" ]; then trans=raw_trans;
101 else trans=trans; fi
102 if [ $feat_type == "lda" ] && \
103 ! cmp $transform_dir/../final.mat $srcdir/final.mat && \
104 ! cmp $transform_dir/final.mat $srcdir/final.mat; then
105 echo "$0: LDA transforms differ between $srcdir and $transform_dir"
106 exit 1;
107 fi
108 if [ ! -f $transform_dir/$trans.1 ]; then
109 echo "$0: expected $transform_dir/$trans.1 to exist (--transform-dir option)"
110 exit 1;
111 fi
112 if [ $nj -ne $nj_orig ]; then
113 # Copy the transforms into an archive with an index.
114 for n in $(seq $nj_orig); do cat $transform_dir/$trans.$n; done | \
115 copy-feats ark:- ark,scp:$dir/$trans.ark,$dir/$trans.scp || exit 1;
116 feats="$feats transform-feats --utt2spk=ark:$sdata/JOB/utt2spk scp:$dir/$trans.scp ark:- ark:- |"
117 else
118 # number of jobs matches with alignment dir.
119 feats="$feats transform-feats --utt2spk=ark:$sdata/JOB/utt2spk ark:$transform_dir/$trans.JOB ark:- ark:- |"
120 fi
121 elif grep 'transform-feats --utt2spk' $srcdir/log/train.1.log >&/dev/null; then
122 echo "$0: **WARNING**: you seem to be using a neural net system trained with transforms,"
123 echo " but you are not providing the --transform-dir option in test time."
124 fi
125 ##
127 if [ ! -z "$online_ivector_dir" ]; then
128 ivector_period=$(cat $online_ivector_dir/ivector_period) || exit 1;
129 ivector_opts="--online-ivectors=scp:$online_ivector_dir/ivector_online.scp --online-ivector_period=$ivector_period"
130 fi
132 if [ $stage -le 1 ]; then
133 $cmd --num-threads $num_threads JOB=1:$nj $dir/log/decode.JOB.log \
134 nnet3-latgen-faster$thread_string $ivector_opts \
135 --frames-per-chunk=$frames_per_chunk \
136 --minimize=$minimize --max-active=$max_active --min-active=$min_active --beam=$beam \
137 --lattice-beam=$lattice_beam --acoustic-scale=$acwt --allow-partial=true \
138 --word-symbol-table=$graphdir/words.txt "$model" \
139 $graphdir/HCLG.fst "$feats" "ark:|gzip -c > $dir/lat.JOB.gz" || exit 1;
140 fi
142 # The output of this script is the files "lat.*.gz"-- we'll rescore this at
143 # different acoustic scales to get the final output.
146 if [ $stage -le 2 ]; then
147 if ! $skip_scoring ; then
148 [ ! -x local/score.sh ] && \
149 echo "Not scoring because local/score.sh does not exist or not executable." && exit 1;
150 echo "score best paths"
151 local/score.sh $scoring_opts --cmd "$cmd" $data $graphdir $dir
152 echo "score confidence and timing with sclite"
153 fi
154 fi
155 echo "Decoding done."
156 exit 0;