Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improvements to Training-ML-Agents #3776

Merged
merged 12 commits into from
Apr 15, 2020
Merged

Improvements to Training-ML-Agents #3776

merged 12 commits into from
Apr 15, 2020

Conversation

mmattar
Copy link

@mmattar mmattar commented Apr 14, 2020

  • Removed duplicate documentation
  • Moved CLI descriptions to learn.py
  • Reorganized "Training with mlagents-learn" into 5 sub-sections

Proposed change(s)

Describe the changes made in this PR.

Useful links (Github issues, JIRA tickets, ML-Agents forum threads etc.)

Types of change(s)

  • Bug fix
  • New feature
  • Code refactor
  • Breaking change
  • Documentation update
  • Other (please describe)

Checklist

  • Added tests that prove my fix is effective or that my feature works
  • Updated the changelog (if applicable)
  • Updated the documentation (if applicable)
  • Updated the migration guide (if applicable)

Other comments

- Removed duplicate documentation
- Moved CLI descriptions to learn.py
- Reorganized "Training with mlagents-learn" into 5 sub-sections
help="The starting port for environment communication. Each concurrent Unity environment "
"instance will get assigned a port sequentially, starting from the base-port. Each instance "
"will use the port (base_port + worker_id), where the worker_id is sequential IDs given to "
"each instance from 0 to (num_envs - 1). Note that When training using the Editor rather "
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"each instance from 0 to (num_envs - 1). Note that When training using the Editor rather "
"each instance from 0 to (num_envs - 1). Note that when training using the Editor rather "

@mmattar mmattar requested a review from ervteng April 14, 2020 22:14
@mmattar
Copy link
Author

mmattar commented Apr 14, 2020

@ervteng - @chriselion has already reviewed/approved but wanted a quick pass from you.

**Note:** The default port TensorBoard uses is 6006. If there is an existing session
running on port 6006 a new session can be launched on an open port using the --port
option.
If you enable the `--debug` flag in the command line, the trainer metrics are logged to a CSV file
Copy link
Contributor

@ervteng ervteng Apr 14, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unfortunately none of these things are correct anymore, I think we can just remove the whole Debugging section.

The CSV is still created under the summaries/ directory, but is slated to be deprecated and replaced with a JSON file, so it's probably OK if we don't mention it.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So should we remove now and bring back once we add the JSON file?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

And also, remove the --debug option from the CLI?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1 for remove now and bring back once we add the JSON file.

The --debug CLI option is still there, but it doesn't really help the user in debugging training (it's mostly for us), nor does it log the CSV. So it probably doesn't go in this doc. Is it OK if we just leave it to the --help menu to describe?

docs/Training-ML-Agents.md Outdated Show resolved Hide resolved
Marwan Mattar added 8 commits April 14, 2020 19:18
Will update the UIE page in a separate PR.
commit 9600d0f
Author: Marwan Mattar <marwan@unity3d.com>
Date:   Tue Apr 14 17:45:33 2020 -0700

    Various doc improvements (#3775)

    * Various doc improvements

    For Using-Virtual-Environment.md:
    - Made a note regarding updating setuptools and pip.
    - Changed lists from "-" to "*"

    For Using-Tensorboard.md:
    - Changed the ordered list to use "1."

    For Training-on-Microsoft-Azure-Custom-Instance.md:
    - Deleted as it was not linked anywhere

    For FAQ.md
    - Removed stale issues given upgrade to 2018.3

    For Readme.md
    - Added links for Reward Signals, Self-Play and Profiling Trainers

    For Learning-Environment-Executable.md
    - Changed the ordered list to use "1."

    For Learning-Environment-Examples.md
    - Minor rewording of intro paragraphs

    * consolidating custom instances page in main page

    So we have a single page for Azure.

    Adding warning note for deprecated docs

    * Fixing doc links that are failing CI

commit 34db9c2
Author: Vincent-Pierre BERGES <vincentpierre@unity3d.com>
Date:   Tue Apr 14 14:06:16 2020 -0700

    Removing dark mode from screenshots (#3772)

commit 1e164cc
Author: Chris Elion <chris.elion@unity3d.com>
Date:   Tue Apr 14 13:08:18 2020 -0700

    [MLA-488] Fix observations in demonstration drawer (#3771)

    * WIP observation shapes

    * WIP observation shapes

    * fix Observation shape serialization

    * rename field, redo screenshot

    * docstring

    * changelog
@mmattar mmattar merged commit a333838 into master Apr 15, 2020
@delete-merged-branch delete-merged-branch bot deleted the develop-mm-docs-training branch April 15, 2020 18:58
@github-actions github-actions bot locked as resolved and limited conversation to collaborators May 15, 2021
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants