Software created to design molecules for COVID thereputics. The repository will cotnain both the packages and analysis scripts created to assess the performn of our techniques.
The necessary packages for running this package are listed in environment.yml
.
Install them with Conda:
conda env create --file environment.yml
The core of this repository is a minimal port of the MolDQN approach of Zhou et al. from Tensorflow with a custom environment description to Keras with OpenAI Gym environment specifications.
This port is currently missing the bootstrapped version of the DQN used by Zhou et al.
DISCLAIMER: The main logic for this package is copied from Google's implementation of DQN. Files directly taken from Google's repository are marked with the original Google copyright and license headers in the files.
The run_rl.py
script trains the RL agent and has a few command line options for expeirmenting with the training process.
Run python run_rl.py --help
to see the command line options.
Running the script with default settings (i.e., python run_rl.py
) should take less than 10 minutes.
Each run of this agent will produce a subdirectory of ./rl_tests/
that contains the configuration used for the experiment
and a log containing records at each step:
episode
: Episode numberstep
: Step number within that episodeepsilon
: Degree of randomness used in selecting next stepsmiles
: State of the molecule after choosing an action in this stepreward
: Observed reward value for choosing that actionq
: The predicted Q value for this moverandom
: Whether move was randomly-selected or based onargmax(q)
loss
: Training loss for the Q network at each step