Skip to content

Conversation

@se-yi
Copy link

@se-yi se-yi commented Nov 7, 2022

Description

This is the beginning of the creation of Pytorch RL documentation using Sphinx.
The config file was adapted to run the tutorial file within tutorials/sphinx-tutorials/demos_source/.
Running pip install -r tutorials/sphinx-tutorials/requirements_doc.txt installs all packages to generate the documentation.
This is a work in progress, and folder structure and other details will eventually change.

Motivation and Context

This is to re-write tutorial files from notebooks to python scripts.

Why is this change required? What problem does it solve?
If it fixes an open issue, please link to the issue here.
You can use the syntax close #15213 if this solves the issue #15213
Related to issue #628

  • I have raised an issue to propose this change (required for new features and bug fixes)

Types of changes

What types of changes does your code introduce? Remove all that do not apply:

  • Documentation (update in the documentation)

Checklist

Go over all the following points, and put an x in all the boxes that apply.
If you are unsure about any of these, don't hesitate to ask. We are here to help!

  • I have read the CONTRIBUTION guide (required)
  • My change requires a change to the documentation.
  • I have updated the tests accordingly (required for a bug fix or a new feature).
  • I have updated the documentation accordingly.

@facebook-github-bot facebook-github-bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Nov 7, 2022
Copy link
Collaborator

@vmoens vmoens left a comment

Choose a reason for hiding this comment

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

For some reason the rest of the doc has disappeared
With this PR:
image

What the doc looks like as of now
image

@vmoens vmoens changed the title Initial commit for torchrl documentation using Sphinx. Example script is demo.py [Doc] Initial commit for torchrl documentation using Sphinx. Example script is demo.py Nov 7, 2022
Seungeun Yi and others added 3 commits November 8, 2022 19:04
…& modifying knowledge_base.py to locally create python scripts for Sphinx documentation. Cleaned the tutorials/sphinx-tutorials repo and added a second script, tensordict.py
…y. Updated config and content_generation files to be able to use src scripts and the media information.
@vmoens vmoens changed the title [Doc] Initial commit for torchrl documentation using Sphinx. Example script is demo.py [Doc] Integrating tutos in sphinx doc Nov 9, 2022
vmoens and others added 2 commits November 9, 2022 18:12
Bug fixes and syntax changes for:
- docs/source/config.py
- docs/source/content_generation.py
- tutorials/sphinx-tutorials/multi_task.py
- tutorials/sphinx-tutorials/tensordict.py
- tutorials/sphinx-tutorials/tensordict_module.py
- tutorials/sphinx-tutorials/torchrl_demo.py
@codecov
Copy link

codecov bot commented Nov 10, 2022

Codecov Report

Merging #651 (8ffb086) into main (3141723) will not change coverage.
The diff coverage is 100.00%.

❗ Current head 8ffb086 differs from pull request most recent head 1d4e2b8. Consider uploading reports for the commit 1d4e2b8 to get more accurate results

@@           Coverage Diff           @@
##             main     #651   +/-   ##
=======================================
  Coverage   87.68%   87.68%           
=======================================
  Files         119      119           
  Lines       20022    20022           
=======================================
  Hits        17557    17557           
  Misses       2465     2465           
Flag Coverage Δ
habitat-gpu 24.40% <100.00%> (ø)
linux-cpu 85.42% <100.00%> (ø)
linux-gpu 86.15% <100.00%> (ø)
linux-outdeps-gpu 72.69% <100.00%> (ø)
linux-stable-cpu 85.28% <100.00%> (ø)
linux-stable-gpu 86.00% <100.00%> (ø)
macos-cpu 85.15% <100.00%> (ø)
olddeps-gpu 74.88% <100.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files Coverage Δ
torchrl/modules/utils/__init__.py 100.00% <100.00%> (ø)

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

@se-yi
Copy link
Author

se-yi commented Nov 10, 2022

Some bugs to look into:

  • transformer figure not coming up in tensordict_module.py (line 324)
  • coding_ddpg.py has RuntimeError: mat1 and mat2 must have the same dtype (line 653)
  • coding_dqn.py has trouble integrating vidoes (lines 179-180 & lines 738-739). Would it be better to upload the video somewhere and embed a link?

@vmoens vmoens added the documentation Improvements or additions to documentation label Nov 15, 2022
@vmoens vmoens linked an issue Nov 15, 2022 that may be closed by this pull request
1 task
@vmoens vmoens mentioned this pull request Nov 16, 2022
@vmoens vmoens closed this Dec 1, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants