浏览代码

Renamed MLAgentsSDK to UnitySDK. (#1170)

/develop-generalizationTraining-TrainerController
GitHub 6 年前
当前提交
ffffe131
共有 13 个文件被更改,包括 36 次插入36 次删除
  1. 38
      .gitignore
  2. 6
      docs/Basic-Guide.md
  3. 2
      docs/Installation.md
  4. 2
      docs/Learning-Environment-Create-New.md
  5. 2
      docs/Learning-Environment-Examples.md
  6. 4
      docs/Learning-Environment-Executable.md
  7. 2
      docs/Migrating.md
  8. 2
      docs/Training-Curriculum-Learning.md
  9. 8
      docs/dox-ml-agents.conf
  10. 2
      ml-agents/mlagents/envs/exception.py
  11. 2
      protobuf-definitions/make.bat
  12. 2
      UnitySDK/Assets/ML-Agents/Scripts/Academy.cs
  13. 0
      /UnitySDK

38
.gitignore


/MLAgentsSDK/[Ll]ibrary/
/MLAgentsSDK/[Tt]emp/
/MLAgentsSDK/[Oo]bj/
/MLAgentsSDK/[Bb]uild/
/MLAgentsSDK/[Bb]uilds/
/MLAgentsSDK/[Pp]ackages/
/MLAgentsSDK/[Uu]nity[Pp]ackage[Mm]anager/
/MLAgentsSDK/Assets/AssetStoreTools*
/MLAgentsSDK/Assets/Plugins*
/MLAgentsSDK/Assets/Gizmos*
/UnitySDK/[Ll]ibrary/
/UnitySDK/[Tt]emp/
/UnitySDK/[Oo]bj/
/UnitySDK/[Bb]uild/
/UnitySDK/[Bb]uilds/
/UnitySDK/[Pp]ackages/
/UnitySDK/[Uu]nity[Pp]ackage[Mm]anager/
/UnitySDK/Assets/AssetStoreTools*
/UnitySDK/Assets/Plugins*
/UnitySDK/Assets/Gizmos*
# Tensorflow Model Info
/models

*MLAgentsSDK.log
*UnitySDK.log
/MLAgentsSDK/.vs/
/UnitySDK/.vs/
/MLAgentsSDKExportedObj/
/MLAgentsSDK.consulo/
/UnitySDKExportedObj/
/UnitySDK.consulo/
*.csproj
*.unityproj
*.sln

*.pidb.meta
# Unity3D Generated File On Crash Reports
/MLAgentsSDK/sysinfo.txt
/UnitySDK/sysinfo.txt
# Builds
*.apk

*.x86
# Tensorflow Sharp Files
/MLAgentsSDK/Assets/ML-Agents/Plugins/Android*
/MLAgentsSDK/Assets/ML-Agents/Plugins/iOS*
/MLAgentsSDK/Assets/ML-Agents/Plugins/Computer*
/MLAgentsSDK/Assets/ML-Agents/Plugins/System*
/UnitySDK/Assets/ML-Agents/Plugins/Android*
/UnitySDK/Assets/ML-Agents/Plugins/iOS*
/UnitySDK/Assets/ML-Agents/Plugins/Computer*
/UnitySDK/Assets/ML-Agents/Plugins/System*
# Generated doc folders
/docs/html

6
docs/Basic-Guide.md


1. Launch Unity
2. On the Projects dialog, choose the **Open** option at the top of the window.
3. Using the file dialog that opens, locate the `MLAgentsSDK` folder
3. Using the file dialog that opens, locate the `UnitySDK` folder
within the the ML-Agents toolkit project and click **Open**.
4. Go to **Edit** > **Project Settings** > **Player**
5. For **each** of the platforms you target (**PC, Mac and Linux Standalone**,

**Plugins** > **Computer**.
**Note**: If you don't see anything under **Assets**, drag the
`MLAgentsSDK/Assets/ML-Agents` folder under **Assets** within Project window.
`UnitySDK/Assets/ML-Agents` folder under **Assets** within Project window.
![Imported TensorFlowsharp](images/imported-tensorflowsharp.png)

[above](#play-an-example-environment-using-pretrained-model).
1. Move your model file into
`MLAgentsSDK/Assets/ML-Agents/Examples/3DBall/TFModels/`.
`UnitySDK/Assets/ML-Agents/Examples/3DBall/TFModels/`.
2. Open the Unity Editor, and select the **3DBall** scene as described above.
3. Select the **Ball3DBrain** object from the Scene hierarchy.
4. Change the **Type of Brain** to **Internal**.

2
docs/Installation.md


git clone https://github.com/Unity-Technologies/ml-agents.git
The `MLAgentsSDK` directory in this repository contains the Unity Assets to add
The `UnitySDK` directory in this repository contains the Unity Assets to add
to your projects. The `python` directory contains python packages which provide
trainers, a python API to interface with Unity, and a package to interface with
OpenAI Gym.

2
docs/Learning-Environment-Create-New.md


1. Launch the Unity Editor and create a new project named "RollerBall".
2. In a file system window, navigate to the folder containing your cloned
ML-Agents repository.
3. Drag the `ML-Agents` folder from `MLAgentsSDK/Assets` to the Unity Editor
3. Drag the `ML-Agents` folder from `UnitySDK/Assets` to the Unity Editor
Project window.
Your Unity **Project** window should contain the following assets:

2
docs/Learning-Environment-Examples.md


The Unity ML-Agents toolkit contains an expanding set of example environments
which demonstrate various features of the platform. Environments are located in
`MLAgentsSDK/Assets/ML-Agents/Examples` and summarized below. Additionally, our
`UnitySDK/Assets/ML-Agents/Examples` and summarized below. Additionally, our
[first ML Challenge](https://connect.unity.com/challenges/ml-agents-1) contains
environments created by the community.

4
docs/Learning-Environment-Executable.md


1. Launch Unity.
2. On the Projects dialog, choose the **Open** option at the top of the window.
3. Using the file dialog that opens, locate the `MLAgentsSDK` folder within the
3. Using the file dialog that opens, locate the `UnitySDK` folder within the
ML-Agents project and click **Open**.
4. In the **Project** window, navigate to the folder
`Assets/ML-Agents/Examples/3DBall/`.

your internal brain by following the steps below:
1. Move your model file into
`MLAgentsSDK/Assets/ML-Agents/Examples/3DBall/TFModels/`.
`UnitySDK/Assets/ML-Agents/Examples/3DBall/TFModels/`.
2. Open the Unity Editor, and select the **3DBall** scene as described above.
3. Select the **Ball3DBrain** object from the Scene hierarchy.
4. Change the **Type of Brain** to **Internal**.

2
docs/Migrating.md


### Important
* The Unity project `unity-environment` has been renamed `MLAgentsSDK`.
* The Unity project `unity-environment` has been renamed `UnitySDK`.
* The `python` folder has been renamed to `ml-agents`. It now contains two
packages, `mlagents.env` and `mlagents.trainers`. `mlagents.env` can be used
to interact directly with a Unity environment, while `mlagents.trainers`

2
docs/Training-Curriculum-Learning.md


Once our curriculum is defined, we have to use the reset parameters we defined
and modify the environment from the agent's `AgentReset()` function. See
[WallJumpAgent.cs](https://github.com/Unity-Technologies/ml-agents/blob/master/MLAgentsSDK/Assets/ML-Agents/Examples/WallJump/Scripts/WallJumpAgent.cs)
[WallJumpAgent.cs](https://github.com/Unity-Technologies/ml-agents/blob/master/UnitySDK/Assets/ML-Agents/Examples/WallJump/Scripts/WallJumpAgent.cs)
for an example. Note that if the Academy's __Max Steps__ is not set to some
positive number the environment will never be reset. The Academy must reset
for the environment to reset.

8
docs/dox-ml-agents.conf


# spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
# Note: If this tag is empty the current directory is searched.
INPUT = ../MLAgentsSDK/Assets/ML-Agents/Scripts/Academy.cs \
../MLAgentsSDK/Assets/ML-Agents/Scripts/Agent.cs \
../MLAgentsSDK/Assets/ML-Agents/Scripts/Monitor.cs \
../MLAgentsSDK/Assets/ML-Agents/Scripts/Decision.cs
INPUT = ../UnitySDK/Assets/ML-Agents/Scripts/Academy.cs \
../UnitySDK/Assets/ML-Agents/Scripts/Agent.cs \
../UnitySDK/Assets/ML-Agents/Scripts/Monitor.cs \
../UnitySDK/Assets/ML-Agents/Scripts/Decision.cs
# This tag can be used to specify the character encoding of the source files
# that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses

2
ml-agents/mlagents/envs/exception.py


"You can check the logfile for more information at {}".format(log_file_path))
except:
logger.error("An error might have occured in the environment. "
"No MLAgentsSDK.log file could be found.")
"No UnitySDK.log file could be found.")
super(UnityTimeOutException, self).__init__(message)

2
protobuf-definitions/make.bat


# COMPILER=[DIRECTORY]
SRC_DIR=proto/mlagents/envs/communicator_objects
DST_DIR_C=../MLAgentsSDK/Assets/ML-Agents/Scripts/CommunicatorObjects
DST_DIR_C=../UnitySDK/Assets/ML-Agents/Scripts/CommunicatorObjects
DST_DIR_P=../ml-agents
PROTO_PATH=proto

2
UnitySDK/Assets/ML-Agents/Scripts/Academy.cs


var pythonParameters = brainBatcher.SendAcademyParameters(academyParameters);
Random.InitState(pythonParameters.Seed);
Application.logMessageReceived += HandleLog;
logPath = Path.GetFullPath(".") + "/MLAgentsSDK.log";
logPath = Path.GetFullPath(".") + "/UnitySDK.log";
logWriter = new StreamWriter(logPath, false);
logWriter.WriteLine(System.DateTime.Now.ToString());
logWriter.WriteLine(" ");

/MLAgentsSDK → /UnitySDK

正在加载...
取消
保存