浏览代码
Revert "Release v0.5 (Develop) (#1203)" (#1222)
Revert "Release v0.5 (Develop) (#1203)" (#1222)
This reverts commit 448aac65dc891bad04a23a02d275f6a1d2704e1e./develop-generalizationTraining-TrainerController
GitHub
6 年前
当前提交
f8df71a0
共有 113 个文件被更改,包括 5930 次插入 和 6678 次删除
-
41.gitignore
-
5CODE_OF_CONDUCT.md
-
60CONTRIBUTING.md
-
7Dockerfile
-
201LICENSE
-
104README.md
-
2config/curricula/push-block/PushBlockBrain.json
-
2config/curricula/test/TestBrain.json
-
2config/curricula/wall-jump/BigWallBrain.json
-
2config/curricula/wall-jump/SmallWallBrain.json
-
24config/trainer_config.yaml
-
2docs/API-Reference.md
-
2docs/Background-TensorFlow.md
-
129docs/Basic-Guide.md
-
33docs/FAQ.md
-
6docs/Feature-Memory.md
-
2docs/Feature-Monitor.md
-
96docs/Getting-Started-with-Balance-Ball.md
-
4docs/Glossary.md
-
15docs/Installation-Windows.md
-
37docs/Installation.md
-
4docs/Learning-Environment-Best-Practices.md
-
89docs/Learning-Environment-Create-New.md
-
6docs/Learning-Environment-Design-Academy.md
-
147docs/Learning-Environment-Design-Agents.md
-
48docs/Learning-Environment-Design-Brains.md
-
28docs/Learning-Environment-Design-External-Internal-Brains.md
-
14docs/Learning-Environment-Design-Heuristic-Brains.md
-
56docs/Learning-Environment-Design-Player-Brains.md
-
90docs/Learning-Environment-Design.md
-
80docs/Learning-Environment-Examples.md
-
116docs/Learning-Environment-Executable.md
-
4docs/Limitations.md
-
24docs/ML-Agents-Overview.md
-
64docs/Migrating.md
-
4docs/Readme.md
-
29docs/Training-Curriculum-Learning.md
-
24docs/Training-Imitation-Learning.md
-
64docs/Training-ML-Agents.md
-
2docs/Training-PPO.md
-
12docs/Training-on-Amazon-Web-Service.md
-
17docs/Training-on-Microsoft-Azure.md
-
18docs/Using-Docker.md
-
18docs/Using-TensorFlow-Sharp-in-Unity.md
-
8docs/Using-Tensorboard.md
-
8docs/dox-ml-agents.conf
-
611docs/images/banner.png
-
129docs/images/player_brain.png
-
79docs/images/scene-hierarchy.png
-
309docs/images/unity-logo-rgb.png
-
26docs/localized/zh-CN/docs/Getting-Started-with-Balance-Ball.md
-
4docs/localized/zh-CN/docs/Installation.md
-
4docs/localized/zh-CN/docs/Learning-Environment-Create-New.md
-
14docs/localized/zh-CN/docs/Learning-Environment-Design.md
-
42docs/localized/zh-CN/docs/Learning-Environment-Examples.md
-
2docs/localized/zh-CN/docs/ML-Agents-Overview.md
-
188ml-agents/README.md
-
2ml-agents/mlagents/envs/environment.py
-
2ml-agents/mlagents/envs/exception.py
-
4ml-agents/mlagents/trainers/bc/models.py
-
2ml-agents/mlagents/trainers/bc/policy.py
-
8ml-agents/mlagents/trainers/bc/trainer.py
-
45ml-agents/mlagents/trainers/curriculum.py
-
64ml-agents/mlagents/trainers/meta_curriculum.py
-
38ml-agents/mlagents/trainers/models.py
-
4ml-agents/mlagents/trainers/policy.py
-
2ml-agents/mlagents/trainers/ppo/models.py
-
2ml-agents/mlagents/trainers/ppo/policy.py
-
15ml-agents/mlagents/trainers/ppo/trainer.py
-
2ml-agents/mlagents/trainers/trainer.py
-
134ml-agents/mlagents/trainers/trainer_controller.py
-
2ml-agents/setup.py
-
2ml-agents/tests/mock_communicator.py
-
14ml-agents/tests/trainers/test_curriculum.py
-
28ml-agents/tests/trainers/test_meta_curriculum.py
-
2ml-agents/tests/trainers/test_trainer_controller.py
-
2protobuf-definitions/make.bat
-
79MLAgentsSDK/ProjectSettings/ProjectSettings.asset
-
2MLAgentsSDK/ProjectSettings/ProjectVersion.txt
-
12MLAgentsSDK/Assets/ML-Agents/Scripts/CoreBrainInternal.cs.meta
-
4MLAgentsSDK/Assets/ML-Agents/Scripts/Academy.cs
-
2MLAgentsSDK/Assets/ML-Agents/Scripts/CoreBrainInternal.cs
-
999MLAgentsSDK/Assets/ML-Agents/Examples/WallJump/TFModels/WallJump.bytes
-
319MLAgentsSDK/Assets/ML-Agents/Examples/WallJump/Scenes/WallJump.unity
-
246MLAgentsSDK/Assets/ML-Agents/Examples/Soccer/Scenes/SoccerTwos.unity
-
999MLAgentsSDK/Assets/ML-Agents/Examples/Soccer/TFModels/Soccer.bytes
-
999MLAgentsSDK/Assets/ML-Agents/Examples/Pyramids/TFModels/Pyramids.bytes
-
257MLAgentsSDK/Assets/ML-Agents/Examples/PushBlock/Scenes/PushBlock.unity
-
999MLAgentsSDK/Assets/ML-Agents/Examples/PushBlock/TFModels/PushBlock.bytes
-
2MLAgentsSDK/Assets/ML-Agents/Examples/PushBlock/TFModels/PushBlock.bytes.meta
-
224MLAgentsSDK/Assets/ML-Agents/Examples/Hallway/Scenes/Hallway.unity
-
443MLAgentsSDK/Assets/ML-Agents/Examples/Hallway/Scenes/HallwayIL.unity
-
972MLAgentsSDK/Assets/ML-Agents/Examples/Hallway/TFModels/Hallway.bytes
-
4MLAgentsSDK/Assets/ML-Agents/Examples/Hallway/TFModels/Hallway.bytes.meta
-
999MLAgentsSDK/Assets/ML-Agents/Examples/GridWorld/TFModels/GridWorld_3x3.bytes
-
998MLAgentsSDK/Assets/ML-Agents/Examples/GridWorld/TFModels/GridWorld_5x5.bytes
-
154MLAgentsSDK/Assets/ML-Agents/Examples/GridWorld/Scenes/GridWorld.unity
-
86MLAgentsSDK/Assets/ML-Agents/Examples/GridWorld/Scripts/GridAgent.cs
-
102MLAgentsSDK/Assets/ML-Agents/Examples/Basic/Scenes/Basic.unity
-
175MLAgentsSDK/Assets/ML-Agents/Examples/Basic/TFModels/Basic.bytes
|
|||
# Contribution Guidelines |
|||
|
|||
Thank you for your interest in contributing to the ML-Agents toolkit! We are |
|||
incredibly excited to see how members of our community will use and extend the |
|||
ML-Agents toolkit. To facilitate your contributions, we've outlined a brief set |
|||
of guidelines to ensure that your extensions can be easily integrated. |
|||
Thank you for your interest in contributing to the ML-Agents toolkit! We are incredibly |
|||
excited to see how members of our community will use and extend the ML-Agents toolkit. |
|||
To facilitate your contributions, we've outlined a brief set of guidelines |
|||
to ensure that your extensions can be easily integrated. |
|||
## Communication |
|||
### Communication |
|||
First, please read through our [code of conduct](CODE_OF_CONDUCT.md), as we |
|||
expect all our contributors to follow it. |
|||
First, please read through our [code of conduct](CODE_OF_CONDUCT.md), |
|||
as we expect all our contributors to follow it. |
|||
Second, before starting on a project that you intend to contribute to the |
|||
ML-Agents toolkit (whether environments or modifications to the codebase), we |
|||
**strongly** recommend posting on our |
|||
[Issues page](https://github.com/Unity-Technologies/ml-agents/issues) |
|||
and briefly outlining the changes you plan to make. This will enable us to |
|||
provide some context that may be helpful for you. This could range from advice |
|||
and feedback on how to optimally perform your changes or reasons for not doing |
|||
it. |
|||
Second, before starting on a project that you intend to contribute |
|||
to the ML-Agents toolkit (whether environments or modifications to the codebase), |
|||
we **strongly** recommend posting on our |
|||
[Issues page](https://github.com/Unity-Technologies/ml-agents/issues) and |
|||
briefly outlining the changes you plan to make. This will enable us to provide |
|||
some context that may be helpful for you. This could range from advice and |
|||
feedback on how to optimally perform your changes or reasons for not doing it. |
|||
## Git Branches |
|||
### Git Branches |
|||
Starting with v0.3, we adopted the |
|||
Starting with v0.3, we adopted the |
|||
Consequently, the `master` branch corresponds to the latest release of |
|||
Consequently, the `master` branch corresponds to the latest release of |
|||
|
|||
* Corresponding changes to documentation, unit tests and sample environments (if |
|||
applicable) |
|||
* Corresponding changes to documentation, unit tests and sample environments |
|||
(if applicable) |
|||
## Environments |
|||
### Environments |
|||
We are also actively open to adding community contributed environments as |
|||
examples, as long as they are small, simple, demonstrate a unique feature of |
|||
the platform, and provide a unique non-trivial challenge to modern |
|||
We are also actively open to adding community contributed environments as |
|||
examples, as long as they are small, simple, demonstrate a unique feature of |
|||
the platform, and provide a unique non-trivial challenge to modern |
|||
PR explaining the nature of the environment and task. |
|||
PR explaining the nature of the environment and task. |
|||
## Style Guide |
|||
### Style Guide |
|||
When performing changes to the codebase, ensure that you follow the style guide |
|||
of the file you're modifying. For Python, we follow |
|||
[PEP 8](https://www.python.org/dev/peps/pep-0008/). |
|||
For C#, we will soon be adding a formal style guide for our repository. |
|||
When performing changes to the codebase, ensure that you follow the style |
|||
guide of the file you're modifying. For Python, we follow |
|||
[PEP 8](https://www.python.org/dev/peps/pep-0008/). For C#, we will soon be |
|||
adding a formal style guide for our repository. |
|
|||
Apache License |
|||
Version 2.0, January 2004 |
|||
http://www.apache.org/licenses/ |
|||
|
|||
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION |
|||
|
|||
1. Definitions. |
|||
|
|||
"License" shall mean the terms and conditions for use, reproduction, |
|||
and distribution as defined by Sections 1 through 9 of this document. |
|||
|
|||
"Licensor" shall mean the copyright owner or entity authorized by |
|||
the copyright owner that is granting the License. |
|||
|
|||
"Legal Entity" shall mean the union of the acting entity and all |
|||
other entities that control, are controlled by, or are under common |
|||
control with that entity. For the purposes of this definition, |
|||
"control" means (i) the power, direct or indirect, to cause the |
|||
direction or management of such entity, whether by contract or |
|||
otherwise, or (ii) ownership of fifty percent (50%) or more of the |
|||
outstanding shares, or (iii) beneficial ownership of such entity. |
|||
|
|||
"You" (or "Your") shall mean an individual or Legal Entity |
|||
exercising permissions granted by this License. |
|||
|
|||
"Source" form shall mean the preferred form for making modifications, |
|||
including but not limited to software source code, documentation |
|||
source, and configuration files. |
|||
|
|||
"Object" form shall mean any form resulting from mechanical |
|||
transformation or translation of a Source form, including but |
|||
not limited to compiled object code, generated documentation, |
|||
and conversions to other media types. |
|||
|
|||
"Work" shall mean the work of authorship, whether in Source or |
|||
Object form, made available under the License, as indicated by a |
|||
copyright notice that is included in or attached to the work |
|||
(an example is provided in the Appendix below). |
|||
|
|||
"Derivative Works" shall mean any work, whether in Source or Object |
|||
form, that is based on (or derived from) the Work and for which the |
|||
editorial revisions, annotations, elaborations, or other modifications |
|||
represent, as a whole, an original work of authorship. For the purposes |
|||
of this License, Derivative Works shall not include works that remain |
|||
separable from, or merely link (or bind by name) to the interfaces of, |
|||
the Work and Derivative Works thereof. |
|||
|
|||
"Contribution" shall mean any work of authorship, including |
|||
the original version of the Work and any modifications or additions |
|||
to that Work or Derivative Works thereof, that is intentionally |
|||
submitted to Licensor for inclusion in the Work by the copyright owner |
|||
or by an individual or Legal Entity authorized to submit on behalf of |
|||
the copyright owner. For the purposes of this definition, "submitted" |
|||
means any form of electronic, verbal, or written communication sent |
|||
to the Licensor or its representatives, including but not limited to |
|||
communication on electronic mailing lists, source code control systems, |
|||
and issue tracking systems that are managed by, or on behalf of, the |
|||
Licensor for the purpose of discussing and improving the Work, but |
|||
excluding communication that is conspicuously marked or otherwise |
|||
designated in writing by the copyright owner as "Not a Contribution." |
|||
|
|||
"Contributor" shall mean Licensor and any individual or Legal Entity |
|||
on behalf of whom a Contribution has been received by Licensor and |
|||
subsequently incorporated within the Work. |
|||
|
|||
2. Grant of Copyright License. Subject to the terms and conditions of |
|||
this License, each Contributor hereby grants to You a perpetual, |
|||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable |
|||
copyright license to reproduce, prepare Derivative Works of, |
|||
publicly display, publicly perform, sublicense, and distribute the |
|||
Work and such Derivative Works in Source or Object form. |
|||
|
|||
3. Grant of Patent License. Subject to the terms and conditions of |
|||
this License, each Contributor hereby grants to You a perpetual, |
|||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable |
|||
(except as stated in this section) patent license to make, have made, |
|||
use, offer to sell, sell, import, and otherwise transfer the Work, |
|||
where such license applies only to those patent claims licensable |
|||
by such Contributor that are necessarily infringed by their |
|||
Contribution(s) alone or by combination of their Contribution(s) |
|||
with the Work to which such Contribution(s) was submitted. If You |
|||
institute patent litigation against any entity (including a |
|||
cross-claim or counterclaim in a lawsuit) alleging that the Work |
|||
or a Contribution incorporated within the Work constitutes direct |
|||
or contributory patent infringement, then any patent licenses |
|||
granted to You under this License for that Work shall terminate |
|||
as of the date such litigation is filed. |
|||
|
|||
4. Redistribution. You may reproduce and distribute copies of the |
|||
Work or Derivative Works thereof in any medium, with or without |
|||
modifications, and in Source or Object form, provided that You |
|||
meet the following conditions: |
|||
|
|||
(a) You must give any other recipients of the Work or |
|||
Derivative Works a copy of this License; and |
|||
|
|||
(b) You must cause any modified files to carry prominent notices |
|||
stating that You changed the files; and |
|||
|
|||
(c) You must retain, in the Source form of any Derivative Works |
|||
that You distribute, all copyright, patent, trademark, and |
|||
attribution notices from the Source form of the Work, |
|||
excluding those notices that do not pertain to any part of |
|||
the Derivative Works; and |
|||
|
|||
(d) If the Work includes a "NOTICE" text file as part of its |
|||
distribution, then any Derivative Works that You distribute must |
|||
include a readable copy of the attribution notices contained |
|||
within such NOTICE file, excluding those notices that do not |
|||
pertain to any part of the Derivative Works, in at least one |
|||
of the following places: within a NOTICE text file distributed |
|||
as part of the Derivative Works; within the Source form or |
|||
documentation, if provided along with the Derivative Works; or, |
|||
within a display generated by the Derivative Works, if and |
|||
wherever such third-party notices normally appear. The contents |
|||
of the NOTICE file are for informational purposes only and |
|||
do not modify the License. You may add Your own attribution |
|||
notices within Derivative Works that You distribute, alongside |
|||
or as an addendum to the NOTICE text from the Work, provided |
|||
that such additional attribution notices cannot be construed |
|||
as modifying the License. |
|||
|
|||
You may add Your own copyright statement to Your modifications and |
|||
may provide additional or different license terms and conditions |
|||
for use, reproduction, or distribution of Your modifications, or |
|||
for any such Derivative Works as a whole, provided Your use, |
|||
reproduction, and distribution of the Work otherwise complies with |
|||
the conditions stated in this License. |
|||
|
|||
5. Submission of Contributions. Unless You explicitly state otherwise, |
|||
any Contribution intentionally submitted for inclusion in the Work |
|||
by You to the Licensor shall be under the terms and conditions of |
|||
this License, without any additional terms or conditions. |
|||
Notwithstanding the above, nothing herein shall supersede or modify |
|||
the terms of any separate license agreement you may have executed |
|||
with Licensor regarding such Contributions. |
|||
|
|||
6. Trademarks. This License does not grant permission to use the trade |
|||
names, trademarks, service marks, or product names of the Licensor, |
|||
except as required for reasonable and customary use in describing the |
|||
origin of the Work and reproducing the content of the NOTICE file. |
|||
|
|||
7. Disclaimer of Warranty. Unless required by applicable law or |
|||
agreed to in writing, Licensor provides the Work (and each |
|||
Contributor provides its Contributions) on an "AS IS" BASIS, |
|||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or |
|||
implied, including, without limitation, any warranties or conditions |
|||
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A |
|||
PARTICULAR PURPOSE. You are solely responsible for determining the |
|||
appropriateness of using or redistributing the Work and assume any |
|||
risks associated with Your exercise of permissions under this License. |
|||
|
|||
8. Limitation of Liability. In no event and under no legal theory, |
|||
whether in tort (including negligence), contract, or otherwise, |
|||
unless required by applicable law (such as deliberate and grossly |
|||
negligent acts) or agreed to in writing, shall any Contributor be |
|||
liable to You for damages, including any direct, indirect, special, |
|||
incidental, or consequential damages of any character arising as a |
|||
result of this License or out of the use or inability to use the |
|||
Work (including but not limited to damages for loss of goodwill, |
|||
work stoppage, computer failure or malfunction, or any and all |
|||
other commercial damages or losses), even if such Contributor |
|||
has been advised of the possibility of such damages. |
|||
|
|||
9. Accepting Warranty or Additional Liability. While redistributing |
|||
the Work or Derivative Works thereof, You may choose to offer, |
|||
and charge a fee for, acceptance of support, warranty, indemnity, |
|||
or other liability obligations and/or rights consistent with this |
|||
License. However, in accepting such obligations, You may act only |
|||
on Your own behalf and on Your sole responsibility, not on behalf |
|||
of any other Contributor, and only if You agree to indemnify, |
|||
defend, and hold each Contributor harmless for any liability |
|||
incurred by, or claims asserted against, such Contributor by reason |
|||
of your accepting any such warranty or additional liability. |
|||
|
|||
END OF TERMS AND CONDITIONS |
|||
|
|||
APPENDIX: How to apply the Apache License to your work. |
|||
|
|||
To apply the Apache License to your work, attach the following |
|||
boilerplate notice, with the fields enclosed by brackets "{}" |
|||
replaced with your own identifying information. (Don't include |
|||
the brackets!) The text should be enclosed in the appropriate |
|||
comment syntax for the file format. We also recommend that a |
|||
file or class name and description of purpose be included on the |
|||
same "printed page" as the copyright notice for easier |
|||
identification within third-party archives. |
|||
|
|||
Copyright 2017 Unity Technologies |
|||
|
|||
Licensed under the Apache License, Version 2.0 (the "License"); |
|||
you may not use this file except in compliance with the License. |
|||
You may obtain a copy of the License at |
|||
|
|||
http://www.apache.org/licenses/LICENSE-2.0 |
|||
|
|||
Unless required by applicable law or agreed to in writing, software |
|||
distributed under the License is distributed on an "AS IS" BASIS, |
|||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
|||
See the License for the specific language governing permissions and |
|||
limitations under the License. |