Home

Awesome

Controllable Sentence Simplification

This repository contains the original implementation of the ACCESS model (AudienCe-CEntric Sentence Simplification) presented in Controllable Sentence Simplification.

The version that was used at submission time is on branch submission.

Getting Started

Dependencies

Installing

git clone git@github.com:facebookresearch/access.git
cd access
pip install -e .
pip install --force-reinstall easse@git+git://github.com/feralvam/easse.git@580ec953e4742c3ae806cc85d867c16e9f584505
pip install --force-reinstall fairseq@git+https://github.com/louismartin/fairseq.git@controllable-sentence-simplification

pip install torch==1.2
pip install sacrebleu==1.3.7

How to use

Evaluate the pretrained model on WikiLarge:

python scripts/evaluate.py

Simplify text with the pretrained model

python scripts/generate.py < my_file.complex

Train a model

python scripts/train.py

Pretrained model

The fairseq checkpoint of our model with the best scores can be found here. The model's output simplifications can be viewed on the EASSE HTML report.

References

If you use this code, please cite:
L. Martin, B. Sagot, E. De la Clergerie, A. Bordes, Controllable Sentence Simplification

Author

If you have any question, please contact the author: Louis Martin (louismartincs@gmail.com)

License

See the LICENSE file for more details.