以构建英-中NMT为例，在linux上运行，fairseq版本为0.8.0
环境准备
Requirements：
- fairseq：pytorch包，包括许多网络结构，https://github.com/pytorch/fairseq
- mosesdecoder：机器翻译的标准数据处理工具， https://github.com/moses-smt/mosesdecoder
- subword-nmt：bpe分词工具，https://github.com/rsennrich/subword-nmt
- jieba：中文分词工具，https://github.com/fxsjy/jieba
除了jieba，其它我习惯是下载包在本地运行
Data：
准备raw双语数据，一句一行，英中各存为三个文件，分别是训练集，验证集，测试集，如下：
目录结构：
以下的命令都是在主目录下运行
数据预处理
1.序列化处理
用MOSES对句子进行序列化处理，说白了就是在每个句子的单词和标点符号之间插入空格：
perl requirements/mosesdecoder-master/scripts/tokenizer/tokenizer.perl \
-l en < data/en-zh/train.en-zh.en > data/en-zh/train.en-zh.tok.en
类似的，英中的剩下几个文件都作同样的处理（可以观察一下处理前后文件内容的不同之处）
2.中文分词
进行分词，只有中文数据需要进行此步骤，在这里用jieba分词工具：
python -m jieba -d " " data/en-zh/train.en-zh.tok.zh > data/en-zh/temp.txt
mv data/en-zh/temp.txt data/en-zh/train.en-zh.tok.zh
# 和英的文件名进行统一，方便后续操作
3.bpe分词
bpe分词是更细粒度的分词，可以减少词表大小，此外对性能也有帮助。
首先用双语数据学习bpecode（这个过程时间比较长，可以用别人学习好的）：
Python requirements/subword-nmt/learn_joint_bpe_and_vocab.py \
-i data/en-zh/train.en-zh.tok.en -o data/en-zh/bpecode.en --write-vocabulary data/en-zh/voc.en
然后用bpecode对数据进行bpe分词：
python requirements/subword-nmt/apply_bpe.py \
-c data/en-zh/bpecode.en < data/en-zh/train.en-zh.tok.en > data/en-zh/train.en-zh.tok.bpe.en
# 对 valid、test进行同样操作
类似的，对中文数据进行上述的bpe分词处理
4.生成词表以及二进制数据
用fairseq提供的数据预处理脚本进行预处理，以生成词表文件和可以直接输入模型的二进制文件：
PYTHONPATH=fairseq-0.8.0 python fairseq-0.8.0/preprocess.py \
--source-lang en--target-lang zh --workers 4 --trainpref data/en-zh/train.en-zh.tok.bpe \
--validpref data/en-zh/valid.en-zh.tok.bpe --testpref data/en-zh/test.en-zh.tok.bpe --destdir data/en-zh/data-bin
处理完可以看到在data/en-zh/data-bin 目录下生成了词表和许多二进制文件：
以上就是数据预处理的过程，比较繁琐，建议用脚本完成，详情见 github
训练
数据处理完后，接下来就是训练，训练的参数实在太多了，github上脚本的参数是大家都通用的，下面列了几个常用的，具体看官方文档：
PYTHONPATH=fairseq-0.8.0 CUDA_VISIBLE_DEVICES=1 nohup python fairseq-0.8.0/train.py \
data/en-zh/data-bin -a transformer --optimizer adam -s en -t zh --dropout 0.3 --max-tokens 4096 \
--criterion label_smoothed_cross_entropy --num-workers 8 --save-dir model/en-zh &
可以指定多卡，训练完成之后，会在model/en-zh下生成许多.pt的模型文件
解码
训练完成后就可以用模型文件来进行预测，称之为解码
PYTHONPATH=fairseq-0.8.0 CUDA_VISIBLE_DEVICES=1 python fairseq-0.8.0/generate.py \
data/en-zh/data-bin --path model/en-zh/checkpoint_best.pt --batch-size 128 --beam 5 > temp.txt
默认用测试集进行解码，解码得到的文件是这样的：
其中，
S 源语
T 目标语（答案）
H 预测的句子，H前的数字是这个句子的预测概率的log再除总长度
P 每个单词的预测概率的log，全部相加除句子总长度等于H
后处理
解码得到的文本中有bpe符号和许多的train过程中的输出信息，进行后处理提取预测文本。
首先得到所有的预测句子：
grep ^H temp.txt | cut -f3- > temp2.txt
然后去除bpe符号
sed -r 's/(@@ )| (@@ ?$)//g' < temp2.txt > temp3.txt
可以计算一下bleu，答案是用tokenized后的文件，不是原生文件：
perl requirements/mosesdecoder-master/scripts/generic/multi-bleu.perl data/en-zh/test.en-zh.tok.zh < temp3.txt
如果要提取纯预测文本，需要进行detokenizer：
perl requirements/mosesdecoder-master/scripts/tokenizer/detokenizer.perl -l zh < temp3.txt > predict.txt
