In this assignment we will be using OpenAI's gym to try out some techniques to train agents in the Cartpole Environment.
In this assignment you are going to implement the Deep-Q, REINFORCE and REINFORCE with BASELINE training algorithms. You'll also get familiar with the gym library through the Cartpole environment.
Please click here to get the stencil code.
Do not change the stencil except where specified. You are welcome to write your own helper functions, however, changing the stencil's method signatures will break the autograder
Q-Learning is the method of training an agent to learn so-called "q values" associated with taking an action when in a particular state. A q-value is a proxy for reward that also incorporates predicted future returns as well. To maximize cumulative reward, it makes sense to take the action with the highest predicted q-value at every timestep, which becomes our policy. Refer to the lecture slides for more details and a formal statement of the problem.
Head over to deep_q.py
, here you will design your net for Deep Q learning
Task 1.1 [DeepQModel Forward Pass]: Fill out the __init__
and call
methods for DeepQModel. The model should take a state/batch of states as input and output the predicted q-value of taking each action.
We recommend constructing an MLP using tf.keras.Sequential
.
You should initialize your target model to be a copy of your prediction model in the constuctor.
You'll need to build your prediction model \(Q\) (check out the .build
hint below), make a copy of \(Q\) to be your target model, then copy the weights to the new target model.
You may find tf.keras.models.clone_model
, .set_weights
, and .get_weights
helpful for this part!
For this assignment, optimizers should be created in the model __init__
, you can then access the optimizer when training by using model.optimizer
.
About .build
Tensorflow doesn't actually make the weights for a layer until it is called on an input. This way, it can stay generalizable to several different inputs (think about how dense layers don't need to have an input shape specified!)
We can force TF to build weights by calling <insert model/layer_name>.build(input_shape=<insert shape iterable>)
Note: In our case, the forward pass should take in a state and return the predicted reward for each action. The Q-value for a particular action can then be acquired by indexing the output vector.
An equally valid way to implement the network is to append the action to the state as input and have the network return the predicted q-value of the state action pair. You should not use this implementation for this assignment since it will not play nice with the autograder but feel free to come back to this assignment later on and make the necessary adjustments to train the network in this way.
Task 1.2 [DeepQModel Loss]: Implement the loss function for a DQN.
Keep in mind each batch is a list of 5 items: batch_states, batch_actions, batch_rewards, batch_next_states, batch_done. Each is a list of length batch_size. Each example in the batch is independent so each example is non-consecutive and can be from different episodes entirely.
The loss function per example is as follows: \[\mathcal{L}(Q, \hat{Q}, s, a, r, s^{`}, d) = \left(Q(s,a)-\left[r + \gamma*(1-\mathbb{1}_{d})*\max_{a^{`}}\{\hat{Q}(s^{`},a^{`})\}\right] \right)^2\] Where \(s\) is the current state, \(a\) is the action taken, \(s^{` }\) is the next state, \(r\) is the reward, \(\gamma\) is the discount factor (usually .99), \(d\) is a boolean which is True if the game terminated after this action, false otherwise. \(Q\) is the prediction network and \(\hat{Q}\) is the target network.
As typical, you should vectorize this function and return the mean loss over each example in the batch.
Now that we have a model, we need a way to train it!
Note: assignment.py
has several functions, many of which you will implement, some of which you won't have to worry about. Here is a breakdown of the different functions:
visualize_data
and visualize_episode
are utility methods we will use to visualize your trained agents and rewards acquired over the course of training. You don't have to worry about these, but you should look at their function signatures if you want to use them during/after training.discount
and train_trajectory
are helper functions for REINFORCE and REINFORCE with BASELINE. You'll implement these later and use them to train with those algorithms but for now you can skip past them.train_reinforce_episode
and train_deep_q_episode
should train the passed model on the passed environment for 1 episode. train_deep_q_episode
has extra args for batch_size
, memory
and epsilon
which are applied in the training algorithm for deep Q learning. You will be filling out train_deep_q_episode
shortly.train
is used to run a single training episode, it will call either train_reinforce/deep_q_episode
depending on what model was passed in.Task 1.3 [Prepare to train a DeepQModel part 1]: Implement train_deep_q_episode
.
train_deep_q_episode
should
memory
should be a (state, action, reward, next_state, done)
tuple.batch_size
many examples from the memoryNote: When simulating an episode, you can interact with the environment with
- env.step(action)
and env.sample()
Task 1.4 [Prepare to train a DeepQModel part 2]: Implement train.
train
should
isinstance
for this)DeepQModel
and the memory is empty, initialize a memory of around 50 samples using random actions. Before calling train_deep_q_episode
, be sure to truncate the memory to 1000 examples.Reinforce
or ReinforceWithBaseline
, just call train_reinforce_episode
None
for Reinforce
and ReinforceWithBaseline
You should know: Truncating the memory might at first seem like a bad idea since we are losing out on training data. This method has lots of merits however. Consider that our oldest examples are likely to contain worse state-action pairs that are not helpful to the training process. We'd prefer not to keep learning from bad examples and focus on state-action pairs that are closer to optimal.
Task 1.4 [Train a DeepQModel]: You can run main
by using the command line python assignment.py DEEP_Q
. You can adjust the main function to tweek the num_episodes
, how often episodes are visualized, etc. but the default values should work well. Ensure you can train a DeepQModel
with average reward > 110.
REINFORCE is a policy gradient algorithm so instead of trying to learn the reward values it directly optimizes for the policy function.
Task 2.1 [Reinforce initialization and call]: Implement the init and call
method for Reinforce
, we recommend a small MLP for this.
Task 2.2 [Reinforce loss function]: Implement loss_func
for REINFORCE
.
The loss is given by \[\mathcal{L}(s, a, r) = -\log(A(s,a))*\gamma r \] Where \(A\) is the predicted log probability of taking action, \(a\), from state, \(s\). \(\gamma\) is the discount applied to the reward \(r\).
Note: A couple hints when implementing Reinforce.loss_func
gather_nd
to get the probabilities associated with each actionTask 2.3 [Prepare to train REINFORCE, discount]: Head over to assignment.py
here you will find the discount
function. Given a list of rewards, \(r\), and discount rate \(\gamma\), you should return a list, \(d\), where
\[d[i] = \sum_{j=0}^i \gamma^j*r[j] \]
An example of expected behavior is provided in the handout.
Task 2.4 [Prepare to train REINFORCE, generate_trajectory]:
Here you will simulate 1 episode using the model to generate the policy, you should return lists of all states, actions and rewards experienced during the episode.
Note: Recall that policy gradient methods output a probability distribution over the action space and that this distribution is a representation of our policy. Thus, you should sample from this distribution rather than take a maximum predicted action.
Task 2.5 [Train REINFORCE]: Put your model, generate_trajectory
and discount
together to implement train_reinforce_model
which should train on one simulated episode.
Be sure to adjust train
to call train_reinforce_model
when using Reinforce
and ReinforceWithBaseline
models if you didn't do so in Task 1.4.
You should now be able to train REINFORCE by running python assignment.py REINFORCE
Task 3.1 [ReinforceWithBaseline]: At this point, all you have to do are fill in the methods for ReinforceWithBaseline
then you can run python assignment.py REINFORCE_BASELINE
to train using the new model. We leave the details for this, the last task for 2470, to you (with a few helpful hints below).
Hints:
tf.stop_gradient
around the \(Adv\) when computing actor loss, if you do not, then the actor loss gradient will continue to propagate through the critic network. Consult the box below if you are unsure why this is necessaryYou should know: When you completed BERAS, the gradient method may have seem overly generalized and it may have been hard to imagine cases in which a search algorithm would have been useful. The above loss function is a perfect example of why the generalization is important. With a single GradientTape we can compute every gradient we need across both networks at once.
Think back to your gradient method and consider how it would have handled the \(Adv\) term in the Actor loss. Since \(Adv\) is parameterized, its weight gradients would have been computed and its weights then updated had we not used tf.stop_gradient
.
Congratulations you have completed your last assignment for CSCI 2470!
After submitting your work, there is some extra heft built into the stencil code to be able to train these networks using any gym
environment, just add the name as a command line argument, such as python assignment.py REINFORCE LunarLander-v2
. Cartpole is a very easy environment so you will likely need to run more episodes when training on other environments. That said, it can be a lot of fun to watch a network learn a more complicated environment with better graphics!