|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270 |
- {
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "# Unity ML-Agents Toolkit\n",
- "## Environment Basics\n",
- "This notebook contains a walkthrough of the basic functions of the Python API for the Unity ML-Agents toolkit. For instructions on building a Unity environment, see [here](https://github.com/Unity-Technologies/ml-agents/blob/master/docs/Getting-Started-with-Balance-Ball.md)."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### 1. Set environment parameters\n",
- "\n",
- "Be sure to set `env_name` to the name of the Unity environment file you want to launch. Ensure that the environment build is in `../envs`."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 1,
- "metadata": {},
- "outputs": [],
- "source": [
- "env_name = \"../envs/Bachelorarbeit-Cozmo\" # Name of the Unity environment binary to launch\n",
- "train_mode = True # Whether to run the environment in training or inference mode"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### 2. Load dependencies\n",
- "\n",
- "The following loads the necessary dependencies and checks the Python version (at runtime). ML-Agents Toolkit (v0.3 onwards) requires Python 3."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 2,
- "metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "Python version:\n",
- "3.6.7 |Anaconda, Inc.| (default, Oct 28 2018, 19:44:12) [MSC v.1915 64 bit (AMD64)]\n"
- ]
- }
- ],
- "source": [
- "import matplotlib.pyplot as plt\n",
- "import numpy as np\n",
- "import sys\n",
- "\n",
- "from mlagents.envs import UnityEnvironment\n",
- "\n",
- "%matplotlib inline\n",
- "\n",
- "print(\"Python version:\")\n",
- "print(sys.version)\n",
- "\n",
- "# check Python version\n",
- "if (sys.version_info[0] < 3):\n",
- " raise Exception(\"ERROR: ML-Agents Toolkit (v0.3 onwards) requires Python 3\")"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### 3. Start the environment\n",
- "`UnityEnvironment` launches and begins communication with the environment when instantiated.\n",
- "\n",
- "Environments contain _brains_ which are responsible for deciding the actions of their associated _agents_. Here we check for the first brain available, and set it as the default brain we will be controlling from Python."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 3,
- "metadata": {},
- "outputs": [
- {
- "name": "stderr",
- "output_type": "stream",
- "text": [
- "INFO:mlagents.envs:\n",
- "'Academy' started successfully!\n",
- "Unity Academy name: Academy\n",
- " Number of Brains: 1\n",
- " Number of Training Brains : 1\n",
- " Reset Parameters :\n",
- "\t\t\n",
- "Unity brain name: CozmoLearning\n",
- " Number of Visual Observations (per agent): 1\n",
- " Vector Observation space size (per agent): 0\n",
- " Number of stacked Vector Observation: 1\n",
- " Vector Action space type: discrete\n",
- " Vector Action space size (per agent): [3, 3, 3]\n",
- " Vector Action descriptions: forward, left-right, rotate\n"
- ]
- }
- ],
- "source": [
- "env = UnityEnvironment(file_name=env_name)\n",
- "\n",
- "# Set the default brain to work with\n",
- "default_brain = env.brain_names[0]\n",
- "brain = env.brains[default_brain]"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### 4. Examine the observation and state spaces\n",
- "We can reset the environment to be provided with an initial set of observations and states for all the agents within the environment. In ML-Agents, _states_ refer to a vector of variables corresponding to relevant aspects of the environment for an agent. Likewise, _observations_ refer to a set of relevant pixel-wise visuals for an agent."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 4,
- "metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "Agent state looks like: \n",
- "[]\n",
- "Agent observations look like:\n"
- ]
- },
- {
- "data": {
- "image/png": "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\n",
- "text/plain": [
- "<Figure size 432x288 with 1 Axes>"
- ]
- },
- "metadata": {
- "needs_background": "light"
- },
- "output_type": "display_data"
- }
- ],
- "source": [
- "# Reset the environment\n",
- "env_info = env.reset(train_mode=train_mode)[default_brain]\n",
- "\n",
- "# Examine the state space for the default brain\n",
- "print(\"Agent state looks like: \\n{}\".format(env_info.vector_observations[0]))\n",
- "\n",
- "# Examine the observation space for the default brain\n",
- "for observation in env_info.visual_observations:\n",
- " print(\"Agent observations look like:\")\n",
- " if observation.shape[3] == 3:\n",
- " plt.imshow(observation[0,:,:,:])\n",
- " else:\n",
- " plt.imshow(observation[0,:,:,0])"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### 5. Take random actions in the environment\n",
- "Once we restart an environment, we can step the environment forward and provide actions to all of the agents within the environment. Here we simply choose random actions based on the `action_space_type` of the default brain. \n",
- "\n",
- "Once this cell is executed, 10 messages will be printed that detail how much reward will be accumulated for the next 10 episodes. The Unity environment will then pause, waiting for further signals telling it what to do next. Thus, not seeing any animation is expected when running this cell."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 5,
- "metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "Total reward this episode: 0.0\n",
- "Total reward this episode: 0.0\n",
- "Total reward this episode: 0.0\n",
- "Total reward this episode: 0.0\n",
- "Total reward this episode: 0.0\n",
- "Total reward this episode: 0.0\n",
- "Total reward this episode: 0.0\n",
- "Total reward this episode: 0.0\n",
- "Total reward this episode: 0.0\n",
- "Total reward this episode: 0.0\n"
- ]
- }
- ],
- "source": [
- "for episode in range(10):\n",
- " env_info = env.reset(train_mode=train_mode)[default_brain]\n",
- " done = False\n",
- " episode_rewards = 0\n",
- " while not done:\n",
- " action_size = brain.vector_action_space_size\n",
- " if brain.vector_action_space_type == 'continuous':\n",
- " env_info = env.step(np.random.randn(len(env_info.agents), \n",
- " action_size[0]))[default_brain]\n",
- " else:\n",
- " action = np.column_stack([np.random.randint(0, action_size[i], size=(len(env_info.agents))) for i in range(len(action_size))])\n",
- " env_info = env.step(action)[default_brain]\n",
- " episode_rewards += env_info.rewards[0]\n",
- " done = env_info.local_done[0]\n",
- " print(\"Total reward this episode: {}\".format(episode_rewards))"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### 6. Close the environment when finished\n",
- "When we are finished using an environment, we can close it with the function below."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 6,
- "metadata": {},
- "outputs": [],
- "source": [
- "env.close()"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": []
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": []
- }
- ],
- "metadata": {
- "anaconda-cloud": {},
- "kernelspec": {
- "display_name": "Python 3",
- "language": "python",
- "name": "python3"
- },
- "language_info": {
- "codemirror_mode": {
- "name": "ipython",
- "version": 3
- },
- "file_extension": ".py",
- "mimetype": "text/x-python",
- "name": "python",
- "nbconvert_exporter": "python",
- "pygments_lexer": "ipython3",
- "version": "3.6.7"
- }
- },
- "nbformat": 4,
- "nbformat_minor": 1
- }
|