This repo contains code and data for reproducing the experiments in Evaluating Gender Bias in Machine Translation Gabriel Stanovsky, Noah A. Smith, and Luke Zettlemoyer, (ACL 2019).
@InProceedings{Stanovsky2019ACL,
author = {Gabriel Stanovsky and Noah A. Smith and Luke Zettlemoyer},
title = {Evaluating Gender Bias in Machine Translation},
booktitle = {ACL},
month = {June},
year = {2019},
address = {Florence, Italy},
publisher = {Association for Computational Linguistics}
}
- fast_align: install and point an environment variable called
FAST_ALIGN_BASE
to its root folder (the one containing thebuild
folder).
-
Download and install Morfeusz2. Bindings for python and instruction are available at: http://morfeusz.sgjp.pl/download/en
-
Download custom spaCy model (name should being with
pl_spacy_model_morfeusz
) from http://zil.ipipan.waw.pl/SpacyPL -
Install downloaded spaCy model:
python -m pip install PATH/TO/pl_spacy_model_morfeusz-x.x.x.tar.gz
./install.sh
This is the entry point for all our experiments: scripts/evaluate_all_languages.sh.
Run all of the following from the src
folder. Output logs will be written to the given
path.
-
For the general gender accuracy number, run:
../scripts/evaluate_all_languages.sh ../data/aggregates/en.txt path/to/output/folder/
-
For evaluating pro-sterotypical translations, run:
../scripts/evaluate_all_languages.sh ../data/aggregates/en_pro.txt path/to/output/folder/
-
For evaluating anti-sterotypical translations, run:
../scripts/evaluate_all_languages.sh ../data/aggregates/en_anti.txt path/to/output/folder/
- Translate the file in
data/aggregates/en.txt
to the languages in our evaluation method. - Put the transalations in
translations/your-mt-system/en-targetLanguage.txt
where each sentence is in a new line, which has the following formatoriginal-sentence ||| translated sentence
. See this file for an example. - Add your translator in the
mt_systems
enumeration in the evaluation script.