浏览代码
Develop package docs (#3551)
Develop package docs (#3551)
* Improvements to the main repo Readme: put an emphasis on the Releases section. * Improving the installation guide. * Added the first draft of package readme./bug-failed-api-check
GitHub
5 年前
当前提交
6b7155e4
共有 11 个文件被更改，包括 916 次插入 和 469 次删除
-
108README.md
-
93com.unity.ml-agents/Documentation~/index.md
-
160docs/Installation.md
-
35docs/Limitations.md
-
2docs/Readme.md
-
9docs/Using-Docker.md
-
12docs/Using-Virtual-Environment.md
-
951docs/images/unity_package_manager_window.png
-
3com.unity.ml-agents/Documentation~/TableOfContents.md
-
7com.unity.ml-agents/README.md.meta
-
5com.unity.ml-agents/README.md
|
|||
Please see the [ML-Agents README)(https://github.com/Unity-Technologies/ml-agents/blob/master/README.md) |
|||
# About ML-Agents package (`com.unity.ml-agents`) |
|||
|
|||
The Unity ML-Agents package contains the C# SDK for the |
|||
[Unity ML-Agents Toolkit](https://github.com/Unity-Technologies/ml-agents). |
|||
|
|||
The package provides the ability for any Unity scene to be converted into a learning |
|||
environment where character behaviors can be trained using a variety of machine learning |
|||
algorithms. Additionally, it enables any trained behavior to be embedded back into the Unity |
|||
scene. More specifically, the package provides the following core functionalities: |
|||
* Define Agents: entities whose behavior will be learned. Agents are entities |
|||
that generate observations (through sensors), take actions and receive rewards from |
|||
the environment. |
|||
* Define Behaviors: entities that specifiy how an agent should act. Multiple agents can |
|||
share the same Behavior and a scene may have multiple Behaviors. |
|||
* Record demonstrations of an agent within the Editor. These demonstrations can be |
|||
valuable to train a behavior for that agent. |
|||
* Embedding a trained behavior into the scene via the |
|||
[Unity Inference Engine](https://docs.unity3d.com/Packages/com.unity.barracuda@latest/index.html). |
|||
Thus an Agent can switch from a learning behavior to an inference behavior. |
|||
|
|||
Note that this package does not contain the machine learning algorithms for training |
|||
behaviors. It relies on a Python package to orchestrate the training. This package |
|||
only enables instrumenting a Unity scene and setting it up for training, and then |
|||
embedding the trained model back into your Unity scene. |
|||
|
|||
## Preview package |
|||
This package is available as a preview, so it is not ready for production use. |
|||
The features and documentation in this package might change before it is verified for release. |
|||
|
|||
|
|||
## Package contents |
|||
|
|||
The following table describes the package folder structure: |
|||
|
|||
|**Location**|**Description**| |
|||
|---|---| |
|||
|*Documentation~*|Contains the documentation for the Unity package.| |
|||
|*Editor*|Contains utilities for Editor windows and drawers.| |
|||
|*Plugins*|Contains third-party DLLs.| |
|||
|*Runtime*|Contains core C# APIs for integrating ML-Agents into your Unity scene. | |
|||
|*Tests*|Contains the unit tests for the package.| |
|||
|
|||
<a name="Installation"></a> |
|||
|
|||
## Installation |
|||
|
|||
To install this package, follow the instructions in the |
|||
[Package Manager documentation](https://docs.unity3d.com/Manual/upm-ui-install.html). |
|||
|
|||
To install the Python package to enable training behaviors, follow the instructions on our |
|||
[GitHub repository](https://github.com/Unity-Technologies/ml-agents/blob/latest_release/docs/Installation.md). |
|||
|
|||
## Requirements |
|||
|
|||
This version of the Unity ML-Agents package is compatible with the following versions of the Unity Editor: |
|||
|
|||
* 2018.4 and later (recommended) |
|||
|
|||
## Known limitations |
|||
|
|||
### Headless Mode |
|||
|
|||
If you enable Headless mode, you will not be able to collect visual observations |
|||
from your agents. |
|||
|
|||
### Rendering Speed and Synchronization |
|||
|
|||
Currently the speed of the game physics can only be increased to 100x real-time. |
|||
The Academy also moves in time with FixedUpdate() rather than Update(), so game |
|||
behavior implemented in Update() may be out of sync with the agent decision |
|||
making. See |
|||
[Execution Order of Event Functions](https://docs.unity3d.com/Manual/ExecutionOrder.html) |
|||
for more information. |
|||
|
|||
You can control the frequency of Academy stepping by calling |
|||
`Academy.Instance.DisableAutomaticStepping()`, and then calling |
|||
`Academy.Instance.EnvironmentStep()` |
|||
|
|||
### Unity Inference Engine Models |
|||
Currently, only models created with our trainers are supported for running |
|||
ML-Agents with a neural network behavior. |
|||
|
|||
|
|||
## Helpful links |
|||
|
|||
If you are new to the Unity ML-Agents package, or have a question after reading |
|||
the documentation, you can checkout our |
|||
[GitHUb Repository](https://github.com/Unity-Technologies/ml-agents), which |
|||
also includes a number of ways to |
|||
[connect with us](https://github.com/Unity-Technologies/ml-agents#community-and-feedback) |
|||
including our [ML-Agents Forum](https://forum.unity.com/forums/ml-agents.453/). |
|||
|
|||
|
|||
# Limitations |
|||
|
|||
## Unity SDK |
|||
|
|||
### Headless Mode |
|||
|
|||
If you enable Headless mode, you will not be able to collect visual observations |
|||
from your agents. |
|||
|
|||
### Rendering Speed and Synchronization |
|||
|
|||
Currently the speed of the game physics can only be increased to 100x real-time. |
|||
The Academy also moves in time with FixedUpdate() rather than Update(), so game |
|||
behavior implemented in Update() may be out of sync with the agent decision |
|||
making. See |
|||
[Execution Order of Event Functions](https://docs.unity3d.com/Manual/ExecutionOrder.html) |
|||
for more information. |
|||
|
|||
You can control the frequency of Academy stepping by calling |
|||
`Academy.Instance.DisableAutomaticStepping()`, and then calling |
|||
`Academy.Instance.EnvironmentStep()` |
|||
|
|||
### Unity Inference Engine Models |
|||
Currently, only models created with our trainers are supported for running |
|||
ML-Agents with a neural network behavior. |
|||
|
|||
## Python API |
|||
|
|||
### Python version |
|||
|
|||
As of version 0.3, we no longer support Python 2. |
|||
|
|||
See the package-specific Limitations pages: |
|||
* [Unity `com.unity.mlagents` package](../com.unity.ml-agents/Documentation~/index.md) |
|||
* [`mlagents` Python package](../ml-agents/README.md) |
|||
* [`mlagents_envs` Python package](../ml-agents-envs/README.md) |
|||
* [`gym_unity` Python package](../gym-unity/README.md) |
|||
| 之前 | 之后 |
|---|---|
|
|
|
| 宽度: 1002 | 高度: 1150 | 大小: 266 KiB |
|
|||
* [ML-Agents README](https://github.com/Unity-Technologies/ml-agents/blob/master/README.md) |
|||
* [Contributing](../CONTRIBUTING.md) |
|||
* [Code of Conduct](https://github.com/Unity-Technologies/ml-agents/blob/master/CODE_OF_CONDUCT.md) |
|||
|
|||
fileFormatVersion: 2 |
|||
guid: 19a5b5ea41db446cb8e00644c44e308d |
|||
TextScriptImporter: |
|||
externalObjects: {} |
|||
userData: |
|||
assetBundleName: |
|||
assetBundleVariant: |
|||
|
|||
# Unity ML-Agents SDK |
|||
|
|||
Contains the ML-Agents Unity Project, including |
|||
both the core plugin (in `Scripts`), as well as a set |
|||
of example environments (in `Examples`). |
|||
撰写
预览
正在加载...
取消
保存
Reference in new issue