这段代码是ESPnet案例里面的aishell的asr里面的运行总脚本asr.sh 传送门
解析参数
#!/usr/bin/env bash
# Set bash to 'debug' mode, it will exit on :
# -e 'error', -u 'undefined variable', -o ... 'error in pipeline', -x 'print commands',
set -e
set -u
set -o pipefail
log() {
local fname=${BASH_SOURCE[1]##*/}
echo -e "$(date '+%Y-%m-%dT%H:%M:%S') (${fname}:${BASH_LINENO[0]}:${FUNCNAME[1]}) $*"
}
min() {
local a b
a=$1
for b in "$@"; do
if [ "${b}" -le "${a}" ]; then
a="${b}"
fi
done
echo "${a}"
}
SECONDS=0
# General configuration 总体配置
stage=1 # 从指定位置开始进程 Processes starts from the specified stage.
stop_stage=10000 # 从指定位置结束进程 Processes is stopped at the specified stage.
skip_data_prep=false # 跳过数据处理阶段 Skip data preparation stages.
skip_train=false # 跳过训练阶段 Skip training stages.
skip_eval=false # 跳过解码和评估阶段 Skip decoding and evaluation stages.
skip_upload=true # 跳过打包和上传阶段 Skip packing and uploading stages.
skip_upload_hf=true # 跳过上传到huggingface阶段 Skip uploading to hugging face stages.
ngpu=1 # 使用GPU数量 The number of gpus ("0" uses cpu, otherwise use gpu).
num_nodes=1 # 节点数量 The number of nodes.
nj=32 # 并行数量 The number of parallel jobs.
inference_nj=32 # 解码阶段的并行数量 The number of parallel jobs in decoding.
gpu_inference=false # 是否执行GPU解码 Whether to perform gpu decoding.
dumpdir=dump # 转存功能的目录 Directory to dump features.
expdir=exp # 保存实验的目录 Directory to save experiments.
python=python3 # 指定执行espnet命令的python Specify python to execute espnet commands.
# Data preparation related 数据准备相关
local_data_opts= # 这个选项给到了local/data.sh The options given to local/data.sh.
# Speed perturbation related # 速度扰动相关
speed_perturb_factors= # 扰动音素:"0.9 1.0 1.1" perturbation factors, e.g. "0.9 1.0 1.1" (separated by space).
# Feature extraction related # 特征提取相关
feats_type=raw # 特征类型(raw 或者 fbank_pitch) Feature type (raw or fbank_pitch).
audio_format=flac # 音频格式 Audio format: wav, flac, wav.ark, flac.ark (only in feats_type=raw).
fs=16k # 采样率 Sampling rate.
min_wav_duration=0.1 # 最小音频时长 Minimum duration in second.
max_wav_duration=20 # 最大音频时长 Maximum duration in second.
# Tokenization related 分词相关
token_type=bpe # 分词类型 Tokenization type (char or bpe).
nbpe=30 # BPE词表的大小 The number of BPE vocabulary.
bpemode=unigram # 分词模式 Mode of BPE (unigram or bpe).
oov="<unk>" # 集外词符号 Out of vocabulary symbol.
blank="<blank>" # CTC的blank符号 CTC blank symbol
sos_eos="<sos/eos>" # sos和eos符号 sos and eos symbole
bpe_input_sentence_size=100000000 # 句子输入的长度 Size of input sentence for BPE.
bpe_nlsyms= # 非语言符号列表,用逗号分隔,表示BPE non-linguistic symbols list, separated by a comma, for BPE
bpe_char_cover=1.0 # 建模BPE时的字符覆盖 character coverage when modeling BPE
# Ngram model related # Ngram模型相关
use_ngram=false # 使用语言模型
ngram_exp= # 语言模型生成路径
ngram_num=3 # 语言模型3-gram
# Language model related # 语言模型相关
use_lm=true # 使用语言模型进行ASR解码 Use language model for ASR decoding.
lm_tag= # 对语音模型训练结果目录添加后缀 Suffix to the result dir for language model training.
lm_exp= # 指定目录路径给实验LM模型 Specify the directory path for LM experiment.
# 如果目录指定,则lm_tag无效 If this option is specified, lm_tag is ignored.
lm_stats_dir= # 指定目录LM统计量的目录 Specify the directory path for LM statistics.
lm_config= # 用于语言模型训练的配置 Config for language model training.
lm_args= # 用于语言模型训练的参数 Arguments for language model training, e.g., "--max_epoch 10".
# 注意 将重写lm配置里面的参数 Note that it will overwrite args in lm config.
use_word_lm=false # 是否使用单词语言模型 Whether to use word language model.
num_splits_lm=1 # 用于语料库的分裂数量 Number of splitting for lm corpus.
# shellcheck disable=SC2034
word_vocab_size=10000 # 词典的大小 Size of word vocabulary.
# ASR model related ASR模型相关
asr_tag= # ASR模型训练的结果路径的后缀 Suffix to the result dir for asr model training.
asr_exp= # 指定ASR实验的路径 Specify the directory path for ASR experiment.
# 如果指定,则asr_tag 忽略 If this option is specified, asr_tag is ignored.
asr_stats_dir= # 指定ASR统计量目录 Specify the directory path for ASR statistics.
asr_config= # 用于ASR模型训练的配置 Config for asr model training.
asr_args= # 用于ASR模型训练参数的配置 Arguments for asr model training, e.g., "--max_epoch 10".
# 注意: Note that it will overwrite args in asr config.
pretrained_model= # 预训练模型加载 Pretrained model to load
ignore_init_mismatch=false # 忽略初始不匹配 Ignore initial mismatch
feats_normalize=global_mvn # 标准化层类型 Normalizaton layer type.
num_splits_asr=1 # 语料库的分裂数 Number of splitting for lm corpus.
# Upload model related 上传模型相关
hf_repo=
# Decoding related 解码相关
use_k2=false # 是否使用基于k2的解码器 Whether to use k2 based decoder
k2_ctc_decoding=true #
use_nbest_rescoring=true # 是否使用transformer解码器 use transformer-decoder
# 使用transformer 语言模型对nbest重打分 and transformer language model for nbest rescoring
num_paths=1000 # k2.random_paths的第三个参数 The 3rd argument of k2.random_paths.
nll_batch_size=100 # 在计算nll时,影响GPU内存的使用情况在重打分期间 Affect GPU memory usage when computing nll
# during nbest rescoring
k2_config=./conf/decode_asr_transformer_with_k2.yaml
use_streaming=false # 是否使用流解码 Whether to use streaming decoding
use_maskctc=false # 是否使用maskctc解码 Whether to use maskctc decoding
batch_size=1
inference_tag= # 解码后缀 Suffix to the result dir for decoding.
inference_config= # 解码配置 Config for decoding.
inference_args= # 解码参数 Arguments for decoding, e.g., "--lm_weight 0.1".
# Note that it will overwrite args in inference config.
inference_lm=valid.loss.ave.pth # 用于解码的语言模型 Language model path for decoding.
inference_ngram=${ngram_num}gram.bin
inference_asr_model=valid.acc.ave.pth # 用于解码的ASR模型 ASR model path for decoding.
# e.g.
# inference_asr_model=train.loss.best.pth
# inference_asr_model=3epoch.pth
# inference_asr_model=valid.acc.best.pth
# inference_asr_model=valid.loss.ave.pth
download_model= # 下载模型从模型动物园,并使用它解码 Download a model from Model Zoo and use it for decoding.
# [Task dependent] Set the datadir name created by local/data.sh 通过local/data.sh 设置data目录的名字
train_set= # 训练数据名字设置 Name of training set. #
valid_set= # 用于监视/微调网络训练验证集数据名字的设置 Name of validation set used for monitoring/tuning network training.
test_sets= # 测试集名称设置 Names of test sets. Multiple items (e.g., both dev and eval sets) can be specified.
bpe_train_text= # bpe训练的文本文件路径设置 Text file path of bpe training set.
lm_train_text= # 语言模型训练的文本文件路径设置 Text file path of language model training set.
lm_dev_text= # 语言模型开发集的文本文件路径。 Text file path of language model development set.
lm_test_text= # 语言模型评估文本文件路径 Text file path of language model evaluation set.
nlsyms_txt=none # 如果存在,则为非语言符号列表。 Non-linguistic symbol list if existing.
cleaner=none # 文本清理器 Text cleaner.
g2p=none # g2p方法(如果为token_type=phn时需要)。 g2p method (needed if token_type=phn).
lang=noinfo # 语料库的语言类型。 The language type of corpus.
score_opts= # 显示评分的选项 The options given to sclite scoring
local_score_opts= # The options given to local/score.sh.
asr_speech_fold_length=800 # 在ASR训练过程中,语音数据的折叠长度。 fold_length for speech data during ASR training.
asr_text_fold_length=150 # 文本数据的折叠长度。 fold_length for text data during ASR training.
lm_fold_length=150 # 语言模型的折叠长度。 fold_length for LM training.
help_message=$(cat << EOF
Usage: $0 --train-set "<train_set_name>" --valid-set "<valid_set_name>" --test_sets "<test_set_names>"
Options:
# General configuration
--stage # Processes starts from the specified stage (default="${stage}").
--stop_stage # Processes is stopped at the specified stage (default="${stop_stage}").
--skip_data_prep # Skip data preparation stages (default="${skip_data_prep}").
--skip_train # Skip training stages (default="${skip_train}").
--skip_eval # Skip decoding and evaluation stages (default="${skip_eval}").
--skip_upload # Skip packing and uploading stages (default="${skip_upload}").
--ngpu # The number of gpus ("0" uses cpu, otherwise use gpu, default="${ngpu}").
--num_nodes # The number of nodes (default="${num_nodes}").
--nj # The number of parallel jobs (default="${nj}").
--inference_nj # The number of parallel jobs in decoding (default="${inference_nj}").
--gpu_inference # Whether to perform gpu decoding (default="${gpu_inference}").
--dumpdir # Directory to dump features (default="${dumpdir}").
--expdir # Directory to save experiments (default="${expdir}").
--python # Specify python to execute espnet commands (default="${python}").
# Data preparation related
--local_data_opts # The options given to local/data.sh (default="${local_data_opts}").
# Speed perturbation related
--speed_perturb_factors # speed perturbation factors, e.g. "0.9 1.0 1.1" (separated by space, default="${speed_perturb_factors}").
# Feature extraction related
--feats_type # Feature type (raw, fbank_pitch or extracted, default="${feats_type}").
--audio_format # Audio format: wav, flac, wav.ark, flac.ark (only in feats_type=raw, default="${audio_format}").
--fs # Sampling rate (default="${fs}").
--min_wav_duration # Minimum duration in second (default="${min_wav_duration}").
--max_wav_duration # Maximum duration in second (default="${max_wav_duration}").
# Tokenization related
--token_type # Tokenization type (char or bpe, default="${token_type}").
--nbpe # The number of BPE vocabulary (default="${nbpe}").
--bpemode # Mode of BPE (unigram or bpe, default="${bpemode}").
--oov # Out of vocabulary symbol (default="${oov}").
--blank # CTC blank symbol (default="${blank}").
--sos_eos # sos and eos symbole (default="${sos_eos}").
--bpe_input_sentence_size # Size of input sentence for BPE (default="${bpe_input_sentence_size}").
--bpe_nlsyms # Non-linguistic symbol list for sentencepiece, separated by a comma. (default="${bpe_nlsyms}").
--bpe_char_cover # Character coverage when modeling BPE (default="${bpe_char_cover}").
# Language model related
--lm_tag # Suffix to the result dir for language model training (default="${lm_tag}").
--lm_exp # Specify the directory path for LM experiment.
# If this option is specified, lm_tag is ignored (default="${lm_exp}").
--lm_stats_dir # Specify the directory path for LM statistics (default="${lm_stats_dir}").
--lm_config # Config for language model training (default="${lm_config}").
--lm_args # Arguments for language model training (default="${lm_args}").
# e.g., --lm_args "--max_epoch 10"
# Note that it will overwrite args in lm config.
--use_word_lm # Whether to use word language model (default="${use_word_lm}").
--word_vocab_size # Size of word vocabulary (default="${word_vocab_size}").
--num_splits_lm # Number of splitting for lm corpus (default="${num_splits_lm}").
# ASR model related
--asr_tag # Suffix to the result dir for asr model training (default="${asr_tag}").
--asr_exp # Specify the directory path for ASR experiment.
# If this option is specified, asr_tag is ignored (default="${asr_exp}").
--asr_stats_dir # Specify the directory path for ASR statistics (default="${asr_stats_dir}").
--asr_config # Config for asr model training (default="${asr_config}").
--asr_args # Arguments for asr model training (default="${asr_args}").
# e.g., --asr_args "--max_epoch 10"
# Note that it will overwrite args in asr config.
--pretrained_model= # Pretrained model to load (default="${pretrained_model}").
--ignore_init_mismatch= # Ignore mismatch parameter init with pretrained model (default="${ignore_init_mismatch}").
--feats_normalize # Normalizaton layer type (default="${feats_normalize}").
--num_splits_asr # Number of splitting for lm corpus (default="${num_splits_asr}").
# Decoding related
--inference_tag # Suffix to the result dir for decoding (default="${inference_tag}").
--inference_config # Config for decoding (default="${inference_config}").
--inference_args # Arguments for decoding (default="${inference_args}").
# e.g., --inference_args "--lm_weight 0.1"
# Note that it will overwrite args in inference config.
--inference_lm # Language model path for decoding (default="${inference_lm}").
--inference_asr_model # ASR model path for decoding (default="${inference_asr_model}").
--download_model # Download a model from Model Zoo and use it for decoding (default="${download_model}").
--use_streaming # Whether to use streaming decoding (default="${use_streaming}").
--use_maskctc # Whether to use maskctc decoding (default="${use_streaming}").
# [Task dependent] Set the datadir name created by local/data.sh
--train_set # Name of training set (required).
--valid_set # Name of validation set used for monitoring/tuning network training (required).
--test_sets # Names of test sets.
# Multiple items (e.g., both dev and eval sets) can be specified (required).
--bpe_train_text # Text file path of bpe training set.
--lm_train_text # Text file path of language model training set.
--lm_dev_text # Text file path of language model development set (default="${lm_dev_text}").
--lm_test_text # Text file path of language model evaluation set (default="${lm_test_text}").
--nlsyms_txt # Non-linguistic symbol list if existing (default="${nlsyms_txt}").
--cleaner # Text cleaner (default="${cleaner}").
--g2p # g2p method (default="${g2p}").
--lang # The language type of corpus (default=${lang}).
--score_opts # The options given to sclite scoring (default="{score_opts}").
--local_score_opts # The options given to local/score.sh (default="{local_score_opts}").
--asr_speech_fold_length # fold_length for speech data during ASR training (default="${asr_speech_fold_length}").
--asr_text_fold_length # fold_length for text data during ASR training (default="${asr_text_fold_length}").
--lm_fold_length # fold_length for LM training (default="${lm_fold_length}").
EOF
)
预处理阶段 检查参数
log "$0 $*"
# Save command line args for logging (they will be lost after utils/parse_options.sh)
run_args=$(pyscripts/utils/print_args.py $0 "$@")
. utils/parse_options.sh
if [ $# -ne 0 ]; then
log "${help_message}"
log "Error: No positional arguments are required."
exit 2
fi
. ./path.sh
. ./cmd.sh
# Check required arguments
[ -z "${train_set}" ] && { log "${help_message}"; log "Error: --train_set is required"; exit 2; };
[ -z "${valid_set}" ] && { log "${help_message}"; log "Error: --valid_set is required"; exit 2; };
[ -z "${test_sets}" ] && { log "${help_message}"; log "Error: --test_sets is required"; exit 2; };
# Check feature type
if [ "${feats_type}" = raw ]; then
data_feats=${dumpdir}/raw
elif [ "${feats_type}" = fbank_pitch ]; then
data_feats=${dumpdir}/fbank_pitch
elif [ "${feats_type}" = fbank ]; then
data_feats=${dumpdir}/fbank
elif [ "${feats_type}" == extracted ]; then
data_feats=${dumpdir}/extracted
else
log "${help_message}"
log "Error: not supported: --feats_type ${feats_type}"
exit 2
fi
# Use the same text as ASR for bpe training if not specified.
[ -z "${bpe_train_text}" ] && bpe_train_text="${data_feats}/${train_set}/text"
# Use the same text as ASR for lm training if not specified.
[ -z "${lm_train_text}" ] && lm_train_text="${data_feats}/${train_set}/text"
# Use the same text as ASR for lm training if not specified.
[ -z "${lm_dev_text}" ] && lm_dev_text="${data_feats}/${valid_set}/text"
# Use the text of the 1st evaldir if lm_test is not specified
[ -z "${lm_test_text}" ] && lm_test_text="${data_feats}/${test_sets%% *}/text"
# Check tokenization type
if [ "${lang}" != noinfo ]; then
token_listdir=data/${lang}_token_list
else
token_listdir=data/token_list
fi
bpedir="${token_listdir}/bpe_${bpemode}${nbpe}"
bpeprefix="${bpedir}"/bpe
bpemodel="${bpeprefix}".model
bpetoken_list="${bpedir}"/tokens.txt
chartoken_list="${token_listdir}"/char/tokens.txt
# NOTE: keep for future development.
# shellcheck disable=SC2034
wordtoken_list="${token_listdir}"/word/tokens.txt
if [ "${token_type}" = bpe ]; then
token_list="${bpetoken_list}"
elif [ "${token_type}" = char ]; then
token_list="${chartoken_list}"
bpemodel=none
elif [ "${token_type}" = word ]; then
token_list="${wordtoken_list}"
bpemodel=none
else
log "Error: not supported --token_type '${token_type}'"
exit 2
fi
if ${use_word_lm}; then
log "Error: Word LM is not supported yet"
exit 2
lm_token_list="${wordtoken_list}"
lm_token_type=word
else
lm_token_list="${token_list}"
lm_token_type="${token_type}"
fi
# Set tag for naming of model directory
if [ -z "${asr_tag}" ]; then
if [ -n "${asr_config}" ]; then
asr_tag="$(basename "${asr_config}" .yaml)_${feats_type}"
else
asr_tag="train_${feats_type}"
fi
if [ "${lang}" != noinfo ]; then
asr_tag+="_${lang}_${token_type}"
else
asr_tag+="_${token_type}"
fi
if [ "${token_type}" = bpe ]; then
asr_tag+="${nbpe}"
fi
# Add overwritten arg's info
if [ -n "${asr_args}" ]; then
asr_tag+="$(echo "${asr_args}" | sed -e "s/--/\_/g" -e "s/[ |=/]//g")"
fi
if [ -n "${speed_perturb_factors}" ]; then
asr_tag+="_sp"
fi
fi
if [ -z "${lm_tag}" ]; then
if [ -n "${lm_config}" ]; then
lm_tag="$(basename "${lm_config}" .yaml)"
else
lm_tag="train"
fi
if [ "${lang}" != noinfo ]; then
lm_tag+="_${lang}_${lm_token_type}"
else
lm_tag+="_${lm_token_type}"
fi
if [ "${lm_token_type}" = bpe ]; then
lm_tag+="${nbpe}"
fi
# Add overwritten arg's info
if [ -n "${lm_args}" ]; then
lm_tag+="$(echo "${lm_args}" | sed -e "s/--/\_/g" -e "s/[ |=/]//g")"
fi
fi
# The directory used for collect-stats mode
if [ -z "${asr_stats_dir}" ]; then
if [ "${lang}" != noinfo ]; then
asr_stats_dir="${expdir}/asr_stats_${feats_type}_${lang}_${token_type}"
else
asr_stats_dir="${expdir}/asr_stats_${feats_type}_${token_type}"
fi
if [ "${token_type}" = bpe ]; then
asr_stats_dir+="${nbpe}"
fi
if [ -n "${speed_perturb_factors}" ]; then
asr_stats_dir+="_sp"
fi
fi
if [ -z "${lm_stats_dir}" ]; then
if [ "${lang}" != noinfo ]; then
lm_stats_dir="${expdir}/lm_stats_${lang}_${lm_token_type}"
else
lm_stats_dir="${expdir}/lm_stats_${lm_token_type}"
fi
if [ "${lm_token_type}" = bpe ]; then
lm_stats_dir+="${nbpe}"
fi
fi
# The directory used for training commands
if [ -z "${asr_exp}" ]; then
asr_exp="${expdir}/asr_${asr_tag}"
fi
if [ -z "${lm_exp}" ]; then
lm_exp="${expdir}/lm_${lm_tag}"
fi
if [ -z "${ngram_exp}" ]; then
ngram_exp="${expdir}/ngram"
fi
if [ -z "${inference_tag}" ]; then
if [ -n "${inference_config}" ]; then
inference_tag="$(basename "${inference_config}" .yaml)"
else
inference_tag=inference
fi
# Add overwritten arg's info
if [ -n "${inference_args}" ]; then
inference_tag+="$(echo "${inference_args}" | sed -e "s/--/\_/g" -e "s/[ |=]//g")"
fi
if "${use_lm}"; then
inference_tag+="_lm_$(basename "${lm_exp}")_$(echo "${inference_lm}" | sed -e "s/\//_/g" -e "s/\.[^.]*$//g")"
fi
if "${use_ngram}"; then
inference_tag+="_ngram_$(basename "${ngram_exp}")_$(echo "${inference_ngram}" | sed -e "s/\//_/g" -e "s/\.[^.]*$//g")"
fi
inference_tag+="_asr_model_$(echo "${inference_asr_model}" | sed -e "s/\//_/g" -e "s/\.[^.]*$//g")"
if "${use_k2}"; then
inference_tag+="_use_k2"
inference_tag+="_k2_ctc_decoding_${k2_ctc_decoding}"
inference_tag+="_use_nbest_rescoring_${use_nbest_rescoring}"
fi
fi
阶段1 数据处理阶段
if ! "${skip_data_prep}"; then
if [ ${stage} -le 1 ] && [ ${stop_stage} -ge 1 ]; then
log "Stage 1: Data preparation for data/${train_set}, data/${valid_set}, etc."
# [Task dependent] Need to create data.sh for new corpus
local/data.sh ${local_data_opts}
fi
阶段2 增加速度扰度阶段
if [ ${stage} -le 2 ] && [ ${stop_stage} -ge 2 ]; then
if [ -n "${speed_perturb_factors}" ]; then
log "Stage 2: Speed perturbation: data/${train_set} -> data/${train_set}_sp"
for factor in ${speed_perturb_factors}; do
if [[ $(bc <<<"${factor} != 1.0") == 1 ]]; then
scripts/utils/perturb_data_dir_speed.sh "${factor}" "data/${train_set}" "data/${train_set}_sp${factor}"
_dirs+="data/${train_set}_sp${factor} "
else
# If speed factor is 1, same as the original
_dirs+="data/${train_set} "
fi
done
utils/combine_data.sh "data/${train_set}_sp" ${_dirs}
else
log "Skip stage 2: Speed perturbation"
fi
fi
if [ -n "${speed_perturb_factors}" ]; then
train_set="${train_set}_sp"
fi
阶段3 格式化wav.scp,特征提取
if [ ${stage} -le 3 ] && [ ${stop_stage} -ge 3 ]; then
if [ "${feats_type}" = raw ]; then
log "Stage 3: Format wav.scp: data/ -> ${data_feats}"
# ====== Recreating "wav.scp" ======
# Kaldi-wav.scp, which can describe the file path with unix-pipe, like "cat /some/path |",
# shouldn't be used in training process.
# "format_wav_scp.sh" dumps such pipe-style-wav to real audio file
# and it can also change the audio-format and sampling rate.
# If nothing is need, then format_wav_scp.sh does nothing:
# i.e. the input file format and rate is same as the output.
for dset in "${train_set}" "${valid_set}" ${test_sets}; do
if [ "${dset}" = "${train_set}" ] || [ "${dset}" = "${valid_set}" ]; then
_suf="/org"
else
_suf=""
fi
utils/copy_data_dir.sh --validate_opts --non-print data/"${dset}" "${data_feats}${_suf}/${dset}"
rm -f ${data_feats}${_suf}/${dset}/{segments,wav.scp,reco2file_and_channel,reco2dur}
_opts=
if [ -e data/"${dset}"/segments ]; then
# "segments" is used for splitting wav files which are written in "wav".scp
# into utterances. The file format of segments:
# <segment_id> <record_id> <start_time> <end_time>
# "e.g. call-861225-A-0050-0065 call-861225-A 5.0 6.5"
# Where the time is written in seconds.
_opts+="--segments data/${dset}/segments "
fi
# shellcheck disable=SC2086
scripts/audio/format_wav_scp.sh --nj "${nj}" --cmd "${train_cmd}" \
--audio-format "${audio_format}" --fs "${fs}" ${_opts} \
"data/${dset}/wav.scp" "${data_feats}${_suf}/${dset}"
echo "${feats_type}" > "${data_feats}${_suf}/${dset}/feats_type"
done
elif [ "${feats_type}" = fbank_pitch ]; then
log "[Require Kaldi] Stage 3: ${feats_type} extract: data/ -> ${data_feats}"
for dset in "${train_set}" "${valid_set}" ${test_sets}; do
if [ "${dset}" = "${train_set}" ] || [ "${dset}" = "${valid_set}" ]; then
_suf="/org"
else
_suf=""
fi
# 1. Copy datadir
utils/copy_data_dir.sh --validate_opts --non-print data/"${dset}" "${data_feats}${_suf}/${dset}"
# 2. Feature extract
_nj=$(min "${nj}" "$(<"${data_feats}${_suf}/${dset}/utt2spk" wc -l)")
steps/make_fbank_pitch.sh --nj "${_nj}" --cmd "${train_cmd}" "${data_feats}${_suf}/${dset}"
utils/fix_data_dir.sh "${data_feats}${_suf}/${dset}"
# 3. Derive the the frame length and feature dimension
scripts/feats/feat_to_shape.sh --nj "${_nj}" --cmd "${train_cmd}" \
"${data_feats}${_suf}/${dset}/feats.scp" "${data_feats}${_suf}/${dset}/feats_shape"
# 4. Write feats_dim
head -n 1 "${data_feats}${_suf}/${dset}/feats_shape" | awk '{ print $2 }' \
| cut -d, -f2 > ${data_feats}${_suf}/${dset}/feats_dim
# 5. Write feats_type
echo "${feats_type}" > "${data_feats}${_suf}/${dset}/feats_type"
done
elif [ "${feats_type}" = fbank ]; then
log "Stage 3: ${feats_type} extract: data/ -> ${data_feats}"
log "${feats_type} is not supported yet."
exit 1
elif [ "${feats_type}" = extracted ]; then
log "Stage 3: ${feats_type} extract: data/ -> ${data_feats}"
# Assumming you don't have wav.scp, but feats.scp is created by local/data.sh instead.
for dset in "${train_set}" "${valid_set}" ${test_sets}; do
if [ "${dset}" = "${train_set}" ] || [ "${dset}" = "${valid_set}" ]; then
_suf="/org"
else
_suf=""
fi
# Generate dummy wav.scp to avoid error by copy_data_dir.sh
<data/"${dset}"/cmvn.scp awk ' { print($1,"<DUMMY>") }' > data/"${dset}"/wav.scp
utils/copy_data_dir.sh --validate_opts --non-print data/"${dset}" "${data_feats}${_suf}/${dset}"
# Derive the the frame length and feature dimension
_nj=$(min "${nj}" "$(<"${data_feats}${_suf}/${dset}/utt2spk" wc -l)")
scripts/feats/feat_to_shape.sh --nj "${_nj}" --cmd "${train_cmd}" \
"${data_feats}${_suf}/${dset}/feats.scp" "${data_feats}${_suf}/${dset}/feats_shape"
pyscripts/feats/feat-to-shape.py "scp:head -n 1 ${data_feats}${_suf}/${dset}/feats.scp |" - | \
awk '{ print $2 }' | cut -d, -f2 > "${data_feats}${_suf}/${dset}/feats_dim"
echo "${feats_type}" > "${data_feats}${_suf}/${dset}/feats_type"
done
else
log "Error: not supported: --feats_type ${feats_type}"
exit 2
fi
fi
阶段4 移除短句子以及空句子数据
if [ ${stage} -le 4 ] && [ ${stop_stage} -ge 4 ]; then
log "Stage 4: Remove long/short data: ${data_feats}/org -> ${data_feats}"
# NOTE(kamo): Not applying to test_sets to keep original data
for dset in "${train_set}" "${valid_set}"; do
# Copy data dir
utils/copy_data_dir.sh --validate_opts --non-print "${data_feats}/org/${dset}" "${data_feats}/${dset}"
cp "${data_feats}/org/${dset}/feats_type" "${data_feats}/${dset}/feats_type"
# Remove short utterances
_feats_type="$(<${data_feats}/${dset}/feats_type)"
if [ "${_feats_type}" = raw ]; then
_fs=$(python3 -c "import humanfriendly as h;print(h.parse_size('${fs}'))")
_min_length=$(python3 -c "print(int(${min_wav_duration} * ${_fs}))")
_max_length=$(python3 -c "print(int(${max_wav_duration} * ${_fs}))")
# utt2num_samples is created by format_wav_scp.sh
<"${data_feats}/org/${dset}/utt2num_samples" \
awk -v min_length="${_min_length}" -v max_length="${_max_length}" \
'{ if ($2 > min_length && $2 < max_length ) print $0; }' \
>"${data_feats}/${dset}/utt2num_samples"
<"${data_feats}/org/${dset}/wav.scp" \
utils/filter_scp.pl "${data_feats}/${dset}/utt2num_samples" \
>"${data_feats}/${dset}/wav.scp"
else
# Get frame shift in ms from conf/fbank.conf
_frame_shift=
if [ -f conf/fbank.conf ] && [ "$(<conf/fbank.conf grep -c frame-shift)" -gt 0 ]; then
# Assume using conf/fbank.conf for feature extraction
_frame_shift="$(<conf/fbank.conf grep frame-shift | sed -e 's/[-a-z =]*\([0-9]*\)/\1/g')"
fi
if [ -z "${_frame_shift}" ]; then
# If not existing, use the default number in Kaldi (=10ms).
# If you are using different number, you have to change the following value manually.
_frame_shift=10
fi
_min_length=$(python3 -c "print(int(${min_wav_duration} / ${_frame_shift} * 1000))")
_max_length=$(python3 -c "print(int(${max_wav_duration} / ${_frame_shift} * 1000))")
cp "${data_feats}/org/${dset}/feats_dim" "${data_feats}/${dset}/feats_dim"
<"${data_feats}/org/${dset}/feats_shape" awk -F, ' { print $1 } ' \
| awk -v min_length="${_min_length}" -v max_length="${_max_length}" \
'{ if ($2 > min_length && $2 < max_length) print $0; }' \
>"${data_feats}/${dset}/feats_shape"
<"${data_feats}/org/${dset}/feats.scp" \
utils/filter_scp.pl "${data_feats}/${dset}/feats_shape" \
>"${data_feats}/${dset}/feats.scp"
fi
# Remove empty text
<"${data_feats}/org/${dset}/text" \
awk ' { if( NF != 1 ) print $0; } ' >"${data_feats}/${dset}/text"
# fix_data_dir.sh leaves only utts which exist in all files
utils/fix_data_dir.sh "${data_feats}/${dset}"
done
# shellcheck disable=SC2002
cat ${lm_train_text} | awk ' { if( NF != 1 ) print $0; } ' > "${data_feats}/lm_train.txt"
fi
阶段5 生成分词列表阶段
if [ ${stage} -le 5 ] && [ ${stop_stage} -ge 5 ]; then
if [ "${token_type}" = bpe ]; then
log "Stage 5: Generate token_list from ${bpe_train_text} using BPE"
mkdir -p "${bpedir}"
# shellcheck disable=SC2002
cat ${bpe_train_text} | cut -f 2- -d" " > "${bpedir}"/train.txt
if [ -n "${bpe_nlsyms}" ]; then
_opts_spm="--user_defined_symbols=${bpe_nlsyms}"
else
_opts_spm=""
fi
spm_train \
--input="${bpedir}"/train.txt \
--vocab_size="${nbpe}" \
--model_type="${bpemode}" \
--model_prefix="${bpeprefix}" \
--character_coverage=${bpe_char_cover} \
--input_sentence_size="${bpe_input_sentence_size}" \
${_opts_spm}
{
echo "${blank}"
echo "${oov}"
# Remove <unk>, <s>, </s> from the vocabulary
<"${bpeprefix}".vocab awk '{ if( NR != 1 && NR != 2 && NR != 3 ){ print $1; } }'
echo "${sos_eos}"
} > "${token_list}"
elif [ "${token_type}" = char ] || [ "${token_type}" = word ]; then
log "Stage 5: Generate character level token_list from ${lm_train_text}"
_opts="--non_linguistic_symbols ${nlsyms_txt}"
# The first symbol in token_list must be "<blank>" and the last must be also sos/eos:
# 0 is reserved for CTC-blank for ASR and also used as ignore-index in the other task
${python} -m espnet2.bin.tokenize_text \
--token_type "${token_type}" \
--input "${data_feats}/lm_train.txt" --output "${token_list}" ${_opts} \
--field 2- \
--cleaner "${cleaner}" \
--g2p "${g2p}" \
--write_vocabulary true \
--add_symbol "${blank}:0" \
--add_symbol "${oov}:1" \
--add_symbol "${sos_eos}:-1"
else
log "Error: not supported --token_type '${token_type}'"
exit 2
fi
# Create word-list for word-LM training
if ${use_word_lm} && [ "${token_type}" != word ]; then
log "Generate word level token_list from ${data_feats}/lm_train.txt"
${python} -m espnet2.bin.tokenize_text \
--token_type word \
--input "${data_feats}/lm_train.txt" --output "${lm_token_list}" \
--field 2- \
--cleaner "${cleaner}" \
--g2p "${g2p}" \
--write_vocabulary true \
--vocabulary_size "${word_vocab_size}" \
--add_symbol "${blank}:0" \
--add_symbol "${oov}:1" \
--add_symbol "${sos_eos}:-1"
fi
fi
else
log "Skip the stages for data preparation"
fi
数据处理阶段到这里结束
阶段6 LM搜集统计量阶段
if ! "${skip_train}"; then
if "${use_lm}"; then
if [ ${stage} -le 6 ] && [ ${stop_stage} -ge 6 ]; then
log "Stage 6: LM collect stats: train_set=${data_feats}/lm_train.txt, dev_set=${lm_dev_text}"
_opts=
if [ -n "${lm_config}" ]; then
# To generate the config file: e.g.
# % python3 -m espnet2.bin.lm_train --print_config --optim adam
_opts+="--config ${lm_config} "
fi
# 1. Split the key file
_logdir="${lm_stats_dir}/logdir"
mkdir -p "${_logdir}"
# Get the minimum number among ${nj} and the number lines of input files
_nj=$(min "${nj}" "$(<${data_feats}/lm_train.txt wc -l)" "$(<${lm_dev_text} wc -l)")
key_file="${data_feats}/lm_train.txt"
split_scps=""
for n in $(seq ${_nj}); do
split_scps+=" ${_logdir}/train.${n}.scp"
done
# shellcheck disable=SC2086
utils/split_scp.pl "${key_file}" ${split_scps}
key_file="${lm_dev_text}"
split_scps=""
for n in $(seq ${_nj}); do
split_scps+=" ${_logdir}/dev.${n}.scp"
done
# shellcheck disable=SC2086
utils/split_scp.pl "${key_file}" ${split_scps}
# 2. Generate run.sh
log "Generate '${lm_stats_dir}/run.sh'. You can resume the process from stage 6 using this script"
mkdir -p "${lm_stats_dir}"; echo "${run_args} --stage 6 \"\$@\"; exit \$?" > "${lm_stats_dir}/run.sh"; chmod +x "${lm_stats_dir}/run.sh"
# 3. Submit jobs
log "LM collect-stats started... log: '${_logdir}/stats.*.log'"
# NOTE: --*_shape_file doesn't require length information if --batch_type=unsorted,
# but it's used only for deciding the sample ids.
# shellcheck disable=SC2086
${train_cmd} JOB=1:"${_nj}" "${_logdir}"/stats.JOB.log \
${python} -m espnet2.bin.lm_train \
--collect_stats true \
--use_preprocessor true \
--bpemodel "${bpemodel}" \
--token_type "${lm_token_type}"\
--token_list "${lm_token_list}" \
--non_linguistic_symbols "${nlsyms_txt}" \
--cleaner "${cleaner}" \
--g2p "${g2p}" \
--train_data_path_and_name_and_type "${data_feats}/lm_train.txt,text,text" \
--valid_data_path_and_name_and_type "${lm_dev_text},text,text" \
--train_shape_file "${_logdir}/train.JOB.scp" \
--valid_shape_file "${_logdir}/dev.JOB.scp" \
--output_dir "${_logdir}/stats.JOB" \
${_opts} ${lm_args} || { cat "${_logdir}"/stats.1.log; exit 1; }
# 4. Aggregate shape files
_opts=
for i in $(seq "${_nj}"); do
_opts+="--input_dir ${_logdir}/stats.${i} "
done
# shellcheck disable=SC2086
${python} -m espnet2.bin.aggregate_stats_dirs ${_opts} --output_dir "${lm_stats_dir}"
# Append the num-tokens at the last dimensions. This is used for batch-bins count
<"${lm_stats_dir}/train/text_shape" \
awk -v N="$(<${lm_token_list} wc -l)" '{ print $0 "," N }' \
>"${lm_stats_dir}/train/text_shape.${lm_token_type}"
<"${lm_stats_dir}/valid/text_shape" \
awk -v N="$(<${lm_token_list} wc -l)" '{ print $0 "," N }' \
>"${lm_stats_dir}/valid/text_shape.${lm_token_type}"
fi
阶段7 语言模型开始训练阶段
if [ ${stage} -le 7 ] && [ ${stop_stage} -ge 7 ]; then
log "Stage 7: LM Training: train_set=${data_feats}/lm_train.txt, dev_set=${lm_dev_text}"
_opts=
if [ -n "${lm_config}" ]; then
# To generate the config file: e.g.
# % python3 -m espnet2.bin.lm_train --print_config --optim adam
_opts+="--config ${lm_config} "
fi
if [ "${num_splits_lm}" -gt 1 ]; then
# If you met a memory error when parsing text files, this option may help you.
# The corpus is split into subsets and each subset is used for training one by one in order,
# so the memory footprint can be limited to the memory required for each dataset.
_split_dir="${lm_stats_dir}/splits${num_splits_lm}"
if [ ! -f "${_split_dir}/.done" ]; then
rm -f "${_split_dir}/.done"
${python} -m espnet2.bin.split_scps \
--scps "${data_feats}/lm_train.txt" "${lm_stats_dir}/train/text_shape.${lm_token_type}" \
--num_splits "${num_splits_lm}" \
--output_dir "${_split_dir}"
touch "${_split_dir}/.done"
else
log "${_split_dir}/.done exists. Spliting is skipped"
fi
_opts+="--train_data_path_and_name_and_type ${_split_dir}/lm_train.txt,text,text "
_opts+="--train_shape_file ${_split_dir}/text_shape.${lm_token_type} "
_opts+="--multiple_iterator true "
else
_opts+="--train_data_path_and_name_and_type ${data_feats}/lm_train.txt,text,text "
_opts+="--train_shape_file ${lm_stats_dir}/train/text_shape.${lm_token_type} "
fi
# NOTE(kamo): --fold_length is used only if --batch_type=folded and it's ignored in the other case
log "Generate '${lm_exp}/run.sh'. You can resume the process from stage 7 using this script"
mkdir -p "${lm_exp}"; echo "${run_args} --stage 7 \"\$@\"; exit \$?" > "${lm_exp}/run.sh"; chmod +x "${lm_exp}/run.sh"
log "LM training started... log: '${lm_exp}/train.log'"
if echo "${cuda_cmd}" | grep -e queue.pl -e queue-freegpu.pl &> /dev/null; then
# SGE can't include "/" in a job name
jobname="$(basename ${lm_exp})"
else
jobname="${lm_exp}/train.log"
fi
# shellcheck disable=SC2086
${python} -m espnet2.bin.launch \
--cmd "${cuda_cmd} --name ${jobname}" \
--log "${lm_exp}"/train.log \
--ngpu "${ngpu}" \
--num_nodes "${num_nodes}" \
--init_file_prefix "${lm_exp}"/.dist_init_ \
--multiprocessing_distributed true -- \
${python} -m espnet2.bin.lm_train \
--ngpu "${ngpu}" \
--use_preprocessor true \
--bpemodel "${bpemodel}" \
--token_type "${lm_token_type}"\
--token_list "${lm_token_list}" \
--non_linguistic_symbols "${nlsyms_txt}" \
--cleaner "${cleaner}" \
--g2p "${g2p}" \
--valid_data_path_and_name_and_type "${lm_dev_text},text,text" \
--valid_shape_file "${lm_stats_dir}/valid/text_shape.${lm_token_type}" \
--fold_length "${lm_fold_length}" \
--resume true \
--output_dir "${lm_exp}" \
${_opts} ${lm_args}
fi
阶段8 计算困惑度
if [ ${stage} -le 8 ] && [ ${stop_stage} -ge 8 ]; then
log "Stage 8: Calc perplexity: ${lm_test_text}"
_opts=
# TODO(kamo): Parallelize?
log "Perplexity calculation started... log: '${lm_exp}/perplexity_test/lm_calc_perplexity.log'"
# shellcheck disable=SC2086
${cuda_cmd} --gpu "${ngpu}" "${lm_exp}"/perplexity_test/lm_calc_perplexity.log \
${python} -m espnet2.bin.lm_calc_perplexity \
--ngpu "${ngpu}" \
--data_path_and_name_and_type "${lm_test_text},text,text" \
--train_config "${lm_exp}"/config.yaml \
--model_file "${lm_exp}/${inference_lm}" \
--output_dir "${lm_exp}/perplexity_test" \
${_opts}
log "PPL: ${lm_test_text}: $(cat ${lm_exp}/perplexity_test/ppl)"
fi
else
log "Stage 6-8: Skip lm-related stages: use_lm=${use_lm}"
fi
阶段9 Ngram训练阶段
if "${use_ngram}"; then
mkdir -p ${ngram_exp}
fi
if [ ${stage} -le 9 ] && [ ${stop_stage} -ge 9 ]; then
if "${use_ngram}"; then
log "Stage 9: Ngram Training: train_set=${data_feats}/lm_train.txt"
cut -f 2- -d " " ${data_feats}/lm_train.txt | lmplz -S "20%" --discount_fallback -o ${ngram_num} - >${ngram_exp}/${ngram_num}gram.arpa
build_binary -s ${ngram_exp}/${ngram_num}gram.arpa ${ngram_exp}/${ngram_num}gram.bin
else
log "Stage 9: Skip ngram stages: use_ngram=${use_ngram}"
fi
fi
阶段10 ASR收集统计量阶段
if [ ${stage} -le 10 ] && [ ${stop_stage} -ge 10 ]; then
_asr_train_dir="${data_feats}/${train_set}"
_asr_valid_dir="${data_feats}/${valid_set}"
log "Stage 10: ASR collect stats: train_set=${_asr_train_dir}, valid_set=${_asr_valid_dir}"
_opts=
if [ -n "${asr_config}" ]; then
# To generate the config file: e.g.
# % python3 -m espnet2.bin.asr_train --print_config --optim adam
_opts+="--config ${asr_config} "
fi
_feats_type="$(<${_asr_train_dir}/feats_type)"
if [ "${_feats_type}" = raw ]; then
_scp=wav.scp
if [[ "${audio_format}" == *ark* ]]; then
_type=kaldi_ark
else
# "sound" supports "wav", "flac", etc.
_type=sound
fi
_opts+="--frontend_conf fs=${fs} "
else
_scp=feats.scp
_type=kaldi_ark
_input_size="$(<${_asr_train_dir}/feats_dim)"
_opts+="--input_size=${_input_size} "
fi
# 1. Split the key file
_logdir="${asr_stats_dir}/logdir"
mkdir -p "${_logdir}"
# Get the minimum number among ${nj} and the number lines of input files
_nj=$(min "${nj}" "$(<${_asr_train_dir}/${_scp} wc -l)" "$(<${_asr_valid_dir}/${_scp} wc -l)")
key_file="${_asr_train_dir}/${_scp}"
split_scps=""
for n in $(seq "${_nj}"); do
split_scps+=" ${_logdir}/train.${n}.scp"
done
# shellcheck disable=SC2086
utils/split_scp.pl "${key_file}" ${split_scps}
key_file="${_asr_valid_dir}/${_scp}"
split_scps=""
for n in $(seq "${_nj}"); do
split_scps+=" ${_logdir}/valid.${n}.scp"
done
# shellcheck disable=SC2086
utils/split_scp.pl "${key_file}" ${split_scps}
# 2. Generate run.sh
log "Generate '${asr_stats_dir}/run.sh'. You can resume the process from stage 10 using this script"
mkdir -p "${asr_stats_dir}"; echo "${run_args} --stage 10 \"\$@\"; exit \$?" > "${asr_stats_dir}/run.sh"; chmod +x "${asr_stats_dir}/run.sh"
# 3. Submit jobs
log "ASR collect-stats started... log: '${_logdir}/stats.*.log'"
# NOTE: --*_shape_file doesn't require length information if --batch_type=unsorted,
# but it's used only for deciding the sample ids.
# shellcheck disable=SC2086
${train_cmd} JOB=1:"${_nj}" "${_logdir}"/stats.JOB.log \
${python} -m espnet2.bin.asr_train \
--collect_stats true \
--use_preprocessor true \
--bpemodel "${bpemodel}" \
--token_type "${token_type}" \
--token_list "${token_list}" \
--non_linguistic_symbols "${nlsyms_txt}" \
--cleaner "${cleaner}" \
--g2p "${g2p}" \
--train_data_path_and_name_and_type "${_asr_train_dir}/${_scp},speech,${_type}" \
--train_data_path_and_name_and_type "${_asr_train_dir}/text,text,text" \
--valid_data_path_and_name_and_type "${_asr_valid_dir}/${_scp},speech,${_type}" \
--valid_data_path_and_name_and_type "${_asr_valid_dir}/text,text,text" \
--train_shape_file "${_logdir}/train.JOB.scp" \
--valid_shape_file "${_logdir}/valid.JOB.scp" \
--output_dir "${_logdir}/stats.JOB" \
${_opts} ${asr_args} || { cat "${_logdir}"/stats.1.log; exit 1; }
# 4. Aggregate shape files
_opts=
for i in $(seq "${_nj}"); do
_opts+="--input_dir ${_logdir}/stats.${i} "
done
# shellcheck disable=SC2086
${python} -m espnet2.bin.aggregate_stats_dirs ${_opts} --output_dir "${asr_stats_dir}"
# Append the num-tokens at the last dimensions. This is used for batch-bins count
<"${asr_stats_dir}/train/text_shape" \
awk -v N="$(<${token_list} wc -l)" '{ print $0 "," N }' \
>"${asr_stats_dir}/train/text_shape.${token_type}"
<"${asr_stats_dir}/valid/text_shape" \
awk -v N="$(<${token_list} wc -l)" '{ print $0 "," N }' \
>"${asr_stats_dir}/valid/text_shape.${token_type}"
fi
阶段11 ASR训练开始阶段
if [ ${stage} -le 11 ] && [ ${stop_stage} -ge 11 ]; then
_asr_train_dir="${data_feats}/${train_set}"
_asr_valid_dir="${data_feats}/${valid_set}"
log "Stage 11: ASR Training: train_set=${_asr_train_dir}, valid_set=${_asr_valid_dir}"
_opts=
if [ -n "${asr_config}" ]; then
# To generate the config file: e.g.
# % python3 -m espnet2.bin.asr_train --print_config --optim adam
_opts+="--config ${asr_config} "
fi
_feats_type="$(<${_asr_train_dir}/feats_type)"
if [ "${_feats_type}" = raw ]; then
_scp=wav.scp
# "sound" supports "wav", "flac", etc.
if [[ "${audio_format}" == *ark* ]]; then
_type=kaldi_ark
else
_type=sound
fi
_fold_length="$((asr_speech_fold_length * 100))"
_opts+="--frontend_conf fs=${fs} "
else
_scp=feats.scp
_type=kaldi_ark
_fold_length="${asr_speech_fold_length}"
_input_size="$(<${_asr_train_dir}/feats_dim)"
_opts+="--input_size=${_input_size} "
fi
if [ "${feats_normalize}" = global_mvn ]; then
# Default normalization is utterance_mvn and changes to global_mvn
_opts+="--normalize=global_mvn --normalize_conf stats_file=${asr_stats_dir}/train/feats_stats.npz "
fi
if [ "${num_splits_asr}" -gt 1 ]; then
# If you met a memory error when parsing text files, this option may help you.
# The corpus is split into subsets and each subset is used for training one by one in order,
# so the memory footprint can be limited to the memory required for each dataset.
_split_dir="${asr_stats_dir}/splits${num_splits_asr}"
if [ ! -f "${_split_dir}/.done" ]; then
rm -f "${_split_dir}/.done"
${python} -m espnet2.bin.split_scps \
--scps \
"${_asr_train_dir}/${_scp}" \
"${_asr_train_dir}/text" \
"${asr_stats_dir}/train/speech_shape" \
"${asr_stats_dir}/train/text_shape.${token_type}" \
--num_splits "${num_splits_asr}" \
--output_dir "${_split_dir}"
touch "${_split_dir}/.done"
else
log "${_split_dir}/.done exists. Spliting is skipped"
fi
_opts+="--train_data_path_and_name_and_type ${_split_dir}/${_scp},speech,${_type} "
_opts+="--train_data_path_and_name_and_type ${_split_dir}/text,text,text "
_opts+="--train_shape_file ${_split_dir}/speech_shape "
_opts+="--train_shape_file ${_split_dir}/text_shape.${token_type} "
_opts+="--multiple_iterator true "
else
_opts+="--train_data_path_and_name_and_type ${_asr_train_dir}/${_scp},speech,${_type} "
_opts+="--train_data_path_and_name_and_type ${_asr_train_dir}/text,text,text "
_opts+="--train_shape_file ${asr_stats_dir}/train/speech_shape "
_opts+="--train_shape_file ${asr_stats_dir}/train/text_shape.${token_type} "
fi
log "Generate '${asr_exp}/run.sh'. You can resume the process from stage 11 using this script"
mkdir -p "${asr_exp}"; echo "${run_args} --stage 11 \"\$@\"; exit \$?" > "${asr_exp}/run.sh"; chmod +x "${asr_exp}/run.sh"
# NOTE(kamo): --fold_length is used only if --batch_type=folded and it's ignored in the other case
log "ASR training started... log: '${asr_exp}/train.log'"
if echo "${cuda_cmd}" | grep -e queue.pl -e queue-freegpu.pl &> /dev/null; then
# SGE can't include "/" in a job name
jobname="$(basename ${asr_exp})"
else
jobname="${asr_exp}/train.log"
fi
# shellcheck disable=SC2086
${python} -m espnet2.bin.launch \
--cmd "${cuda_cmd} --name ${jobname}" \
--log "${asr_exp}"/train.log \
--ngpu "${ngpu}" \
--num_nodes "${num_nodes}" \
--init_file_prefix "${asr_exp}"/.dist_init_ \
--multiprocessing_distributed true -- \
${python} -m espnet2.bin.asr_train \
--use_preprocessor true \
--bpemodel "${bpemodel}" \
--token_type "${token_type}" \
--token_list "${token_list}" \
--non_linguistic_symbols "${nlsyms_txt}" \
--cleaner "${cleaner}" \
--g2p "${g2p}" \
--valid_data_path_and_name_and_type "${_asr_valid_dir}/${_scp},speech,${_type}" \
--valid_data_path_and_name_and_type "${_asr_valid_dir}/text,text,text" \
--valid_shape_file "${asr_stats_dir}/valid/speech_shape" \
--valid_shape_file "${asr_stats_dir}/valid/text_shape.${token_type}" \
--resume true \
--init_param ${pretrained_model} \
--ignore_init_mismatch ${ignore_init_mismatch} \
--fold_length "${_fold_length}" \
--fold_length "${asr_text_fold_length}" \
--output_dir "${asr_exp}" \
${_opts} ${asr_args}
fi
else
log "Skip the training stages"
fi
下载预训练模型
if [ -n "${download_model}" ]; then
log "Use ${download_model} for decoding and evaluation"
asr_exp="${expdir}/${download_model}"
mkdir -p "${asr_exp}"
# If the model already exists, you can skip downloading
espnet_model_zoo_download --unpack true "${download_model}" > "${asr_exp}/config.txt"
# Get the path of each file
_asr_model_file=$(<"${asr_exp}/config.txt" sed -e "s/.*'asr_model_file': '\([^']*\)'.*$/\1/")
_asr_train_config=$(<"${asr_exp}/config.txt" sed -e "s/.*'asr_train_config': '\([^']*\)'.*$/\1/")
# Create symbolic links
ln -sf "${_asr_model_file}" "${asr_exp}"
ln -sf "${_asr_train_config}" "${asr_exp}"
inference_asr_model=$(basename "${_asr_model_file}")
if [ "$(<${asr_exp}/config.txt grep -c lm_file)" -gt 0 ]; then
_lm_file=$(<"${asr_exp}/config.txt" sed -e "s/.*'lm_file': '\([^']*\)'.*$/\1/")
_lm_train_config=$(<"${asr_exp}/config.txt" sed -e "s/.*'lm_train_config': '\([^']*\)'.*$/\1/")
lm_exp="${expdir}/${download_model}/lm"
mkdir -p "${lm_exp}"
ln -sf "${_lm_file}" "${lm_exp}"
ln -sf "${_lm_train_config}" "${lm_exp}"
inference_lm=$(basename "${_lm_file}")
fi
fi
阶段12 解码
if ! "${skip_eval}"; then
if [ ${stage} -le 12 ] && [ ${stop_stage} -ge 12 ]; then
log "Stage 12: Decoding: training_dir=${asr_exp}"
if ${gpu_inference}; then
_cmd="${cuda_cmd}"
_ngpu=1
else
_cmd="${decode_cmd}"
_ngpu=0
fi
_opts=
if [ -n "${inference_config}" ]; then
_opts+="--config ${inference_config} "
fi
if "${use_lm}"; then
if "${use_word_lm}"; then
_opts+="--word_lm_train_config ${lm_exp}/config.yaml "
_opts+="--word_lm_file ${lm_exp}/${inference_lm} "
else
_opts+="--lm_train_config ${lm_exp}/config.yaml "
_opts+="--lm_file ${lm_exp}/${inference_lm} "
fi
fi
if "${use_ngram}"; then
_opts+="--ngram_file ${ngram_exp}/${inference_ngram}"
fi
# 2. Generate run.sh
log "Generate '${asr_exp}/${inference_tag}/run.sh'. You can resume the process from stage 12 using this script"
mkdir -p "${asr_exp}/${inference_tag}"; echo "${run_args} --stage 12 \"\$@\"; exit \$?" > "${asr_exp}/${inference_tag}/run.sh"; chmod +x "${asr_exp}/${inference_tag}/run.sh"
if "${use_k2}"; then
# Now only _nj=1 is verified if using k2
asr_inference_tool="espnet2.bin.asr_inference_k2"
_opts+="--is_ctc_decoding ${k2_ctc_decoding} "
_opts+="--use_nbest_rescoring ${use_nbest_rescoring} "
_opts+="--num_paths ${num_paths} "
_opts+="--nll_batch_size ${nll_batch_size} "
_opts+="--k2_config ${k2_config} "
else
if "${use_streaming}"; then
asr_inference_tool="espnet2.bin.asr_inference_streaming"
elif "${use_maskctc}"; then
asr_inference_tool="espnet2.bin.asr_inference_maskctc"
else
asr_inference_tool="espnet2.bin.asr_inference"
fi
fi
for dset in ${test_sets}; do
_data="${data_feats}/${dset}"
_dir="${asr_exp}/${inference_tag}/${dset}"
_logdir="${_dir}/logdir"
mkdir -p "${_logdir}"
_feats_type="$(<${_data}/feats_type)"
if [ "${_feats_type}" = raw ]; then
_scp=wav.scp
if [[ "${audio_format}" == *ark* ]]; then
_type=kaldi_ark
else
_type=sound
fi
else
_scp=feats.scp
_type=kaldi_ark
fi
# 1. Split the key file
key_file=${_data}/${_scp}
split_scps=""
if "${use_k2}"; then
# Now only _nj=1 is verified if using k2
_nj=1
else
_nj=$(min "${inference_nj}" "$(<${key_file} wc -l)")
fi
for n in $(seq "${_nj}"); do
split_scps+=" ${_logdir}/keys.${n}.scp"
done
# shellcheck disable=SC2086
utils/split_scp.pl "${key_file}" ${split_scps}
# 2. Submit decoding jobs
log "Decoding started... log: '${_logdir}/asr_inference.*.log'"
# shellcheck disable=SC2086
${_cmd} --gpu "${_ngpu}" JOB=1:"${_nj}" "${_logdir}"/asr_inference.JOB.log \
${python} -m ${asr_inference_tool} \
--batch_size ${batch_size} \
--ngpu "${_ngpu}" \
--data_path_and_name_and_type "${_data}/${_scp},speech,${_type}" \
--key_file "${_logdir}"/keys.JOB.scp \
--asr_train_config "${asr_exp}"/config.yaml \
--asr_model_file "${asr_exp}"/"${inference_asr_model}" \
--output_dir "${_logdir}"/output.JOB \
${_opts} ${inference_args}
# 3. Concatenates the output files from each jobs
for f in token token_int score text; do
if [ -f "${_logdir}/output.1/1best_recog/${f}" ]; then
for i in $(seq "${_nj}"); do
cat "${_logdir}/output.${i}/1best_recog/${f}"
done | sort -k1 >"${_dir}/${f}"
fi
done
done
fi
阶段13 打分
if [ ${stage} -le 13 ] && [ ${stop_stage} -ge 13 ]; then
log "Stage 13: Scoring"
if [ "${token_type}" = phn ]; then
log "Error: Not implemented for token_type=phn"
exit 1
fi
for dset in ${test_sets}; do
_data="${data_feats}/${dset}"
_dir="${asr_exp}/${inference_tag}/${dset}"
for _type in cer wer ter; do
[ "${_type}" = ter ] && [ ! -f "${bpemodel}" ] && continue
_scoredir="${_dir}/score_${_type}"
mkdir -p "${_scoredir}"
if [ "${_type}" = wer ]; then
# Tokenize text to word level
paste \
<(<"${_data}/text" \
${python} -m espnet2.bin.tokenize_text \
-f 2- --input - --output - \
--token_type word \
--non_linguistic_symbols "${nlsyms_txt}" \
--remove_non_linguistic_symbols true \
--cleaner "${cleaner}" \
) \
<(<"${_data}/utt2spk" awk '{ print "(" $2 "-" $1 ")" }') \
>"${_scoredir}/ref.trn"
# NOTE(kamo): Don't use cleaner for hyp
paste \
<(<"${_dir}/text" \
${python} -m espnet2.bin.tokenize_text \
-f 2- --input - --output - \
--token_type word \
--non_linguistic_symbols "${nlsyms_txt}" \
--remove_non_linguistic_symbols true \
) \
<(<"${_data}/utt2spk" awk '{ print "(" $2 "-" $1 ")" }') \
>"${_scoredir}/hyp.trn"
elif [ "${_type}" = cer ]; then
# Tokenize text to char level
paste \
<(<"${_data}/text" \
${python} -m espnet2.bin.tokenize_text \
-f 2- --input - --output - \
--token_type char \
--non_linguistic_symbols "${nlsyms_txt}" \
--remove_non_linguistic_symbols true \
--cleaner "${cleaner}" \
) \
<(<"${_data}/utt2spk" awk '{ print "(" $2 "-" $1 ")" }') \
>"${_scoredir}/ref.trn"
# NOTE(kamo): Don't use cleaner for hyp
paste \
<(<"${_dir}/text" \
${python} -m espnet2.bin.tokenize_text \
-f 2- --input - --output - \
--token_type char \
--non_linguistic_symbols "${nlsyms_txt}" \
--remove_non_linguistic_symbols true \
) \
<(<"${_data}/utt2spk" awk '{ print "(" $2 "-" $1 ")" }') \
>"${_scoredir}/hyp.trn"
elif [ "${_type}" = ter ]; then
# Tokenize text using BPE
paste \
<(<"${_data}/text" \
${python} -m espnet2.bin.tokenize_text \
-f 2- --input - --output - \
--token_type bpe \
--bpemodel "${bpemodel}" \
--cleaner "${cleaner}" \
) \
<(<"${_data}/utt2spk" awk '{ print "(" $2 "-" $1 ")" }') \
>"${_scoredir}/ref.trn"
# NOTE(kamo): Don't use cleaner for hyp
paste \
<(<"${_dir}/text" \
${python} -m espnet2.bin.tokenize_text \
-f 2- --input - --output - \
--token_type bpe \
--bpemodel "${bpemodel}" \
) \
<(<"${_data}/utt2spk" awk '{ print "(" $2 "-" $1 ")" }') \
>"${_scoredir}/hyp.trn"
fi
sclite \
${score_opts} \
-r "${_scoredir}/ref.trn" trn \
-h "${_scoredir}/hyp.trn" trn \
-i rm -o all stdout > "${_scoredir}/result.txt"
log "Write ${_type} result in ${_scoredir}/result.txt"
grep -e Avg -e SPKR -m 2 "${_scoredir}/result.txt"
done
done
[ -f local/score.sh ] && local/score.sh ${local_score_opts} "${asr_exp}"
# Show results in Markdown syntax
scripts/utils/show_asr_result.sh "${asr_exp}" > "${asr_exp}"/RESULTS.md
cat "${asr_exp}"/RESULTS.md
fi
else
log "Skip the evaluation stages"
fi
阶段14 打包model
packed_model="${asr_exp}/${asr_exp##*/}_${inference_asr_model%.*}.zip"
if [ -z "${download_model}" ]; then
# Skip pack preparation if using a downloaded model
if [ ${stage} -le 14 ] && [ ${stop_stage} -ge 14 ]; then
log "Stage 14: Pack model: ${packed_model}"
_opts=
if "${use_lm}"; then
_opts+="--lm_train_config ${lm_exp}/config.yaml "
_opts+="--lm_file ${lm_exp}/${inference_lm} "
_opts+="--option ${lm_exp}/perplexity_test/ppl "
_opts+="--option ${lm_exp}/images "
fi
if [ "${feats_normalize}" = global_mvn ]; then
_opts+="--option ${asr_stats_dir}/train/feats_stats.npz "
fi
if [ "${token_type}" = bpe ]; then
_opts+="--option ${bpemodel} "
fi
if [ "${nlsyms_txt}" != none ]; then
_opts+="--option ${nlsyms_txt} "
fi
# shellcheck disable=SC2086
${python} -m espnet2.bin.pack asr \
--asr_train_config "${asr_exp}"/config.yaml \
--asr_model_file "${asr_exp}"/"${inference_asr_model}" \
${_opts} \
--option "${asr_exp}"/RESULTS.md \
--option "${asr_exp}"/RESULTS.md \
--option "${asr_exp}"/images \
--outpath "${packed_model}"
fi
fi
阶段15 上传model到zenodo
if ! "${skip_upload}"; then
if [ ${stage} -le 15 ] && [ ${stop_stage} -ge 15 ]; then
log "Stage 15: Upload model to Zenodo: ${packed_model}"
log "Warning: Upload model to Zenodo will be deprecated. We encourage to use Hugging Face"
# To upload your model, you need to do:
# 1. Sign up to Zenodo: https://zenodo.org/
# 2. Create access token: https://zenodo.org/account/settings/applications/tokens/new/
# 3. Set your environment: % export ACCESS_TOKEN="<your token>"
if command -v git &> /dev/null; then
_creator_name="$(git config user.name)"
_checkout="
git checkout $(git show -s --format=%H)"
else
_creator_name="$(whoami)"
_checkout=""
fi
# /some/where/espnet/egs2/foo/asr1/ -> foo/asr1
_task="$(pwd | rev | cut -d/ -f2 | rev)"
# foo/asr1 -> foo
_corpus="${_task%/*}"
_model_name="${_creator_name}/${_corpus}_$(basename ${packed_model} .zip)"
# Generate description file
cat << EOF > "${asr_exp}"/description
This model was trained by ${_creator_name} using ${_task} recipe in <a href="https://github.com/espnet/espnet/">espnet</a>.
<p> </p>
<ul>
<li><strong>Python API</strong><pre><code class="language-python">See https://github.com/espnet/espnet_model_zoo</code></pre></li>
<li><strong>Evaluate in the recipe</strong><pre>
<code class="language-bash">git clone https://github.com/espnet/espnet
cd espnet${_checkout}
pip install -e .
cd $(pwd | rev | cut -d/ -f1-3 | rev)
./run.sh --skip_data_prep false --skip_train true --download_model ${_model_name}</code>
</pre></li>
<li><strong>Results</strong><pre><code>$(cat "${asr_exp}"/RESULTS.md)</code></pre></li>
<li><strong>ASR config</strong><pre><code>$(cat "${asr_exp}"/config.yaml)</code></pre></li>
<li><strong>LM config</strong><pre><code>$(if ${use_lm}; then cat "${lm_exp}"/config.yaml; else echo NONE; fi)</code></pre></li>
</ul>
EOF
# NOTE(kamo): The model file is uploaded here, but not published yet.
# Please confirm your record at Zenodo and publish it by yourself.
# shellcheck disable=SC2086
espnet_model_zoo_upload \
--file "${packed_model}" \
--title "ESPnet2 pretrained model, ${_model_name}, fs=${fs}, lang=${lang}" \
--description_file "${asr_exp}"/description \
--creator_name "${_creator_name}" \
--license "CC-BY-4.0" \
--use_sandbox false \
--publish false
fi
else
log "Skip the uploading stage"
fi
阶段16 上传模型到HuggingFace
if ! "${skip_upload_hf}"; then
if [ ${stage} -le 16 ] && [ ${stop_stage} -ge 16 ]; then
[ -z "${hf_repo}" ] && \
log "ERROR: You need to setup the variable hf_repo with the name of the repository located at HuggingFace, follow the following steps described here https://github.com/espnet/espnet/blob/master/CONTRIBUTING.md#132-espnet2-recipes" && \
exit 1
log "Stage 16: Upload model to HuggingFace: ${hf_repo}"
gitlfs=$(git lfs --version 2> /dev/null || true)
[ -z "${gitlfs}" ] && \
log "ERROR: You need to install git-lfs first" && \
exit 1
dir_repo=${expdir}/hf_${hf_repo//"/"/"_"}
[ ! -d "${dir_repo}" ] && git clone https://huggingface.co/${hf_repo} ${dir_repo}
if command -v git &> /dev/null; then
_creator_name="$(git config user.name)"
_checkout="git checkout $(git show -s --format=%H)"
else
_creator_name="$(whoami)"
_checkout=""
fi
# /some/where/espnet/egs2/foo/asr1/ -> foo/asr1
_task="$(pwd | rev | cut -d/ -f2 | rev)"
# foo/asr1 -> foo
_corpus="${_task%/*}"
_model_name="${_creator_name}/${_corpus}_$(basename ${packed_model} .zip)"
# copy files in ${dir_repo}
unzip -o ${packed_model} -d ${dir_repo}
# Generate description file
# shellcheck disable=SC2034
hf_task=automatic-speech-recognition
# shellcheck disable=SC2034
espnet_task=ASR
# shellcheck disable=SC2034
task_exp=${asr_exp}
eval "echo \"$(cat scripts/utils/TEMPLATE_HF_Readme.md)\"" > "${dir_repo}"/README.md
this_folder=${PWD}
cd ${dir_repo}
if [ -n "$(git status --porcelain)" ]; then
git add .
git commit -m "Update model"
fi
git push
cd ${this_folder}
fi
else
log "Skip the uploading to HuggingFace stage"
fi
log "Successfully finished. [elapsed=${SECONDS}s]"