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

Add FAQ section about OOM. #1385

Merged
merged 3 commits into from Jun 22, 2020
Merged

Conversation

hvy
Copy link
Member

@hvy hvy commented Jun 18, 2020

Motivation

Follow-up to #1380.

Now that we don't do any GC collection sweep by default, OOM might become an issue for certain users (as described in tickets that can be tracked from the above PR). A section in the FAQ might alleviate some of the problem.

Description of the changes

Introduces a section in the FAQ about OOM, and adds a reference to it from the API reference for gc_after_trial.

@hvy hvy added the document Documentation related. label Jun 18, 2020
@HideakiImamura HideakiImamura self-assigned this Jun 18, 2020
Copy link
Member

@HideakiImamura HideakiImamura left a comment

Choose a reason for hiding this comment

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

Looks great!

@toshihikoyanase toshihikoyanase self-assigned this Jun 19, 2020
Copy link
Member

@toshihikoyanase toshihikoyanase left a comment

Choose a reason for hiding this comment

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

Thank you for your PR. I have two comments.

  1. How about adding a keyword OOM to this section? It can be seen in the titles of existing issues, and I think it improves searchability. But, not a strong opinion.
    https://github.com/optuna/optuna/search?q=oom&type=Issues

  2. Do we mention the ChainerMNStudy? It has no gc_after_trial or callbacks, and we need to call gc.collect() in objective functions. On the other hand, it may be too specific to most of the users.

@hvy
Copy link
Member Author

hvy commented Jun 19, 2020

Thanks for your feedback, I addressed both your points. PTAL.

Copy link
Member

@toshihikoyanase toshihikoyanase left a comment

Choose a reason for hiding this comment

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

LGTM. Thank you for your update.

@toshihikoyanase toshihikoyanase merged commit 9ea2ebd into optuna:master Jun 22, 2020
@toshihikoyanase toshihikoyanase added this to the v2.0.0 milestone Jun 22, 2020
@hvy hvy deleted the doc-oom-gc-collect branch June 22, 2020 04:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
document Documentation related.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants