Merge pull request #1931 from Unity-Technologies/release-v0.8

Release v0.8

Author: eshvk

.circleci/config.yml

@@ -20,24 +20,27 @@ jobs:
           command: |
             python3 -m venv venv
             . venv/bin/activate
-            cd ml-agents && pip install -e .
+            cd ml-agents-envs && pip install -e .
+            cd ../ml-agents && pip install -e .
+            pip install pytest-cov==2.6.1 codacy-coverage==1.3.11
+            cd ../gym-unity && pip install -e .
 
       - save_cache:
           paths:
             - ./venv
           key: v1-dependencies-{{ checksum "ml-agents/setup.py" }}
 
       - run:
-          name: Run Tests
+          name: Run Tests for ml-agents and gym_unity
           command: |
             . venv/bin/activate
-            cd ml-agents/ && pytest tests/
             mkdir test-reports
-            pytest --junitxml=test-reports/junit.xml
+            pytest --cov=mlagents --cov-report xml --junitxml=test-reports/junit.xml -p no:warnings
+            python-codacy-coverage -r coverage.xml
 
       - store_test_results:
-          path: ml-agents/test-reports
+          path: test-reports
 
       - store_artifacts:
-          path: ml-agents/test-reports
-          destination: ml-agents/test-reports
+          path: test-reports
+          destination: test-reports

.gitignore

@@ -59,6 +59,9 @@
 /UnitySDK/Assets/ML-Agents/Plugins/System.Numerics*
 /UnitySDK/Assets/ML-Agents/Plugins/System.ValueTuple*
 
+# Plugins
+/UnitySDK/Assets/ML-Agents/VideoRecorder*
+
 # Generated doc folders
 /docs/html
 

Dockerfile

@@ -122,9 +122,15 @@ RUN apt-get update && apt-get -y upgrade
 # xvfb is used to do CPU based rendering of Unity
 RUN apt-get install -y xvfb
 
+# Install ml-agents-envs package locally
+COPY ml-agents-envs /ml-agents-envs
+WORKDIR /ml-agents-envs
+RUN pip install -e .
+
+# Install ml-agents package next
 COPY ml-agents /ml-agents
 WORKDIR /ml-agents
-RUN pip install .
+RUN pip install -e .
 
 # port 5005 is the port used in in Editor training.
 EXPOSE 5005

README.md

@@ -3,6 +3,8 @@
 <img src="docs/images/image-banner.png" align="middle" width="3000"/>
 
 # Unity ML-Agents Toolkit (Beta)
+[![docs badge](https://img.shields.io/badge/docs-reference-blue.svg)](docs/Readme.md)
+[![license badge](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE)
 
 **The Unity Machine Learning Agents Toolkit** (ML-Agents) is an open-source
 Unity plugin that enables games and simulations to serve as environments for
@@ -32,6 +34,8 @@ developer communities.
 * Visualizing network outputs within the environment
 * Simplified set-up with Docker
 * Wrap learning environments as a gym
+* Utilizes the Unity Inference Engine
+* Train using concurrent Unity environment instances
 
 ## Documentation
 

UnitySDK/Assets/ML-Agents/Editor/AgentEditor.cs

@@ -28,9 +28,16 @@ public override void OnInspectorGUI()
                 "agentParameters.onDemandDecision");
             SerializedProperty cameras = serializedAgent.FindProperty(
                 "agentParameters.agentCameras");
+            SerializedProperty renderTextures = serializedAgent.FindProperty(
+                "agentParameters.agentRenderTextures");
 
             EditorGUILayout.PropertyField(brain);
 
+            if (cameras.arraySize > 0 && renderTextures.arraySize > 0)
+            {
+                EditorGUILayout.HelpBox("Brain visual observations created by first getting all cameras then all render textures.", MessageType.Info);    
+            }
+            
             EditorGUILayout.LabelField("Agent Cameras");
             for (int i = 0; i < cameras.arraySize; i++)
             {
@@ -51,6 +58,28 @@ public override void OnInspectorGUI()
             }
 
             EditorGUILayout.EndHorizontal();
+            
+            EditorGUILayout.LabelField("Agent RenderTextures");
+            for (int i = 0; i < renderTextures.arraySize; i++)
+            {
+                EditorGUILayout.PropertyField(
+                    renderTextures.GetArrayElementAtIndex(i),
+                    new GUIContent("RenderTexture " + (i + 1).ToString() + ": "));
+            }
+
+            EditorGUILayout.BeginHorizontal();
+            if (GUILayout.Button("Add RenderTextures", EditorStyles.miniButton))
+            {
+                renderTextures.arraySize++;
+            }
+
+            if (GUILayout.Button("Remove RenderTextures", EditorStyles.miniButton))
+            {
+                renderTextures.arraySize--;
+            }
+
+            EditorGUILayout.EndHorizontal();
+
 
             EditorGUILayout.PropertyField(
                 maxSteps,

UnitySDK/Assets/ML-Agents/Editor/BrainParametersDrawer.cs

@@ -97,7 +97,7 @@ private static void DrawVectorObservation(Rect position, SerializedProperty prop
                 property.FindPropertyRelative(NumVecObsPropName),
                 new GUIContent("Stacked Vectors",
                     "Number of states that will be stacked before " +
-                    "beeing fed to the neural network."));
+                    "being fed to the neural network."));
             position.y += LineHeight;
             EditorGUI.indentLevel--; 
         }

UnitySDK/Assets/ML-Agents/Editor/Tests/RayPerceptionTests.cs

@@ -0,0 +1,37 @@
+using UnityEngine;
+using NUnit.Framework;
+
+
+namespace MLAgents.Tests
+{
+    public class RayPerceptionTests : MonoBehaviour
+    {
+        [Test]
+        public void TestPerception3D()
+        {
+            var angles = new[] {0f, 90f, 180f};
+            var tags = new[] {"test", "test_1"};
+            
+            var go = new GameObject("MyGameObject");
+            RayPerception3D rayPer3D = go.AddComponent<RayPerception3D>();
+            var result = rayPer3D.Perceive(1f, angles ,
+                tags, 0f, 0f);
+            Debug.Log(result.Count);
+            Assert.IsTrue(result.Count == angles.Length * (tags.Length + 2));
+        }
+
+        [Test]
+        public void TestPerception2D()
+        {
+            var angles = new[] {0f, 90f, 180f};
+            var tags = new[] {"test", "test_1"};
+            
+            var go = new GameObject("MyGameObject");
+            RayPerception2D rayPer2D = go.AddComponent<RayPerception2D>();
+            var result = rayPer2D.Perceive(1f, angles,
+                tags);
+            Debug.Log(result.Count);
+            Assert.IsTrue(result.Count == angles.Length * (tags.Length + 2));
+        }
+    }
+}