romainlaroche / spibb Goto Github PK

This project can be used to reproduce the finite MDPs experiments presented in:

• the ICML2019 paper: Safe Policy Improvement with Baseline Bootstrapping, by Romain Laroche, Paul Trichelair, and Rémi Tachet des Combes. (SPIBB)
• the ECML-PKDD2019 paper: Safe Policy Improvement with Soft Baseline Bootstrapping, by Kimia Nadjahi, Romain Laroche, and Rémi Tachet des Combes. (Soft-SPIBB)

For the DQN implementation of SPIBB and Soft-SPIBB, please refer to the git repository at this address.

The project is implemented in Python 3.5 and requires numpy and scipy.

We include the following:

• Libraries of the following algorithms:

  • basic RL,
  • SPIBB:
    • Pi_b-SPIBB,
    • Pi_{\leq b}-SPIBB,
  • Soft-SPIBB:
    • Exact-Soft-SPIBB (1-step or not),
    • Approx-Soft-SPIBB (1-step or not),
  • HCPI:
    • doubly-robust,
    • importance_sampling,
    • weighted_importance_sampling,
    • weighted_per_decision_IS,
    • per_decision_IS,
  • Robust MDP,
  • and Reward-adjusted MDP.

• Environments:

  • Gridworld environment,
  • Random MDPs environment.

• SPIBB experiments:

  • Gridworld experiment of Section 3.1. Run:

    python gridworld_main.py #name_of_experiment# #random_seed#

  • Gridworld experiment with random behavioural policy of Section 3.2. Run:

    python gridworld_random_behavioural_main.py #name_of_experiment# #random_seed#

  • Random MDPs experiment of Section 3.3. Run:

    python randomMDPs_main.py #name_of_experiment# #random_seed#

• Soft-SPIBB Random MDPs experiment of Section 4.1.Run:

  python soft_randomMDPs_main.py #name_of_experiment# #random_seed#

We DO NOT include the following:

• The hyper-parameter search (Appendix C.2 in SPIBB paper): it should be easy to re-implement.
• The figure generator: it has too many specificities to be made understandable for a user at the moment. Also, it is not hard to re-implement one's own visualization tools.
• The multi-CPU implementation: its structure is too much dependent on the cluster tools.

This project is BSD-licensed.

Please use the following bibtex entry if you use this code for SPIBB:

@inproceedings{Laroche2019,
    title={Safe Policy Improvement with Baseline Bootstrapping},
    author={Laroche, Romain and Trichelair, Paul and Tachet des Combes, R\'emi},
    booktitle={Proceedings of the 36th International Conference on Machine Learning (ICML)},
    year={2019}
}

Please use the following bibtex entry if you use this code for Soft-SPIBB:

@inproceedings{NadjahiLarocheTachet2019,
    title={Safe Policy Improvement with Soft Baseline Bootstrapping},
    author={Nadjahi, Kimia and Laroche, Romain and Tachet des Combes, R\'emi},
    booktitle={Proceedings of the 2019 European Conference on Machine Learning and Principles and Practice of Knowledge Discovery in Databases (ECML-PKDD)},
    year={2019}
}