# # Unity ML-Agents Toolkit # ## ML-Agent Learning (Behavioral Cloning) # Contains an implementation of Behavioral Cloning Algorithm import logging import numpy as np from mlagents.envs import AllBrainInfo from mlagents.trainers.bc.trainer import BCTrainer logger = logging.getLogger("mlagents.trainers") class OnlineBCTrainer(BCTrainer): """The OnlineBCTrainer is an implementation of Online Behavioral Cloning.""" def __init__(self, brain, trainer_parameters, training, load, seed, run_id): """ Responsible for collecting experiences and training PPO model. :param trainer_parameters: The parameters for the trainer (dictionary). :param training: Whether the trainer is set for training. :param load: Whether the model should be loaded. :param seed: The seed the model will be initialized with :param run_id: The The identifier of the current run """ super(OnlineBCTrainer, self).__init__( brain, trainer_parameters, training, load, seed, run_id ) self.param_keys = [ "brain_to_imitate", "batch_size", "time_horizon", "summary_freq", "max_steps", "batches_per_epoch", "use_recurrent", "hidden_units", "learning_rate", "num_layers", "sequence_length", "memory_size", "model_path", ] self.check_param_keys() self.brain_to_imitate = trainer_parameters["brain_to_imitate"] self.batches_per_epoch = trainer_parameters["batches_per_epoch"] self.n_sequences = max( int(trainer_parameters["batch_size"] / self.policy.sequence_length), 1 ) def __str__(self): return """Hyperparameters for the Imitation Trainer of brain {0}: \n{1}""".format( self.brain_name, "\n".join( [ "\t{0}:\t{1}".format(x, self.trainer_parameters[x]) for x in self.param_keys ] ), ) def add_experiences( self, curr_info: AllBrainInfo, next_info: AllBrainInfo, take_action_outputs ): """ Adds experiences to each agent's experience history. :param curr_info: Current AllBrainInfo (Dictionary of all current brains and corresponding BrainInfo). :param next_info: Next AllBrainInfo (Dictionary of all current brains and corresponding BrainInfo). :param take_action_outputs: The outputs of the take action method. """ # Used to collect teacher experience into training buffer info_teacher = curr_info[self.brain_to_imitate] next_info_teacher = next_info[self.brain_to_imitate] for agent_id in info_teacher.agents: self.demonstration_buffer[agent_id].last_brain_info = info_teacher for agent_id in next_info_teacher.agents: stored_info_teacher = self.demonstration_buffer[agent_id].last_brain_info if stored_info_teacher is None: continue else: idx = stored_info_teacher.agents.index(agent_id) next_idx = next_info_teacher.agents.index(agent_id) if stored_info_teacher.text_observations[idx] != "": info_teacher_record, info_teacher_reset = ( stored_info_teacher.text_observations[idx].lower().split(",") ) next_info_teacher_record, next_info_teacher_reset = ( next_info_teacher.text_observations[idx].lower().split(",") ) if next_info_teacher_reset == "true": self.demonstration_buffer.reset_update_buffer() else: info_teacher_record, next_info_teacher_record = "true", "true" if info_teacher_record == "true" and next_info_teacher_record == "true": if not stored_info_teacher.local_done[idx]: for i in range(self.policy.vis_obs_size): self.demonstration_buffer[agent_id][ "visual_obs%d" % i ].append(stored_info_teacher.visual_observations[i][idx]) if self.policy.use_vec_obs: self.demonstration_buffer[agent_id]["vector_obs"].append( stored_info_teacher.vector_observations[idx] ) if self.policy.use_recurrent: if stored_info_teacher.memories.shape[1] == 0: stored_info_teacher.memories = np.zeros( ( len(stored_info_teacher.agents), self.policy.m_size, ) ) self.demonstration_buffer[agent_id]["memory"].append( stored_info_teacher.memories[idx] ) self.demonstration_buffer[agent_id]["actions"].append( next_info_teacher.previous_vector_actions[next_idx] ) super(OnlineBCTrainer, self).add_experiences( curr_info, next_info, take_action_outputs ) def process_experiences(self, current_info: AllBrainInfo, next_info: AllBrainInfo): """ Checks agent histories for processing condition, and processes them as necessary. Processing involves calculating value and advantage targets for model updating step. :param current_info: Current AllBrainInfo :param next_info: Next AllBrainInfo """ info_teacher = next_info[self.brain_to_imitate] for l in range(len(info_teacher.agents)): teacher_action_list = len( self.demonstration_buffer[info_teacher.agents[l]]["actions"] ) horizon_reached = ( teacher_action_list > self.trainer_parameters["time_horizon"] ) teacher_filled = ( len(self.demonstration_buffer[info_teacher.agents[l]]["actions"]) > 0 ) if (info_teacher.local_done[l] or horizon_reached) and teacher_filled: agent_id = info_teacher.agents[l] self.demonstration_buffer.append_update_buffer( agent_id, batch_size=None, training_length=self.policy.sequence_length, ) self.demonstration_buffer[agent_id].reset_agent() super(OnlineBCTrainer, self).process_experiences(current_info, next_info)