Skip to content

Add explanation for compound step methods #3014

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

Merged
merged 9 commits into from
Jul 30, 2018

Conversation

huangy22
Copy link
Contributor

@huangy22 huangy22 commented Jun 7, 2018

Address the issue #2083.

@junpenglao
Copy link
Member

Thanks for the PR! However, I think it is better to draft a doc instead of putting the information in the docstring.

@huangy22
Copy link
Contributor Author

huangy22 commented Jun 8, 2018

Thanks for the reply! I wonder if you could point me to some examples to give me an idea about the format and where should I put this doc? Sorry that I don't have much experience in writing documentations for packages and would really appreciate some help :-)

@junpenglao
Copy link
Member

You can have a look at this two PRs:
#2391
#2173

For this doc, I suggest you to put a notebook in https://github.com/pymc-devs/pymc3/tree/master/docs/source/notebooks, and then index it in https://github.com/pymc-devs/pymc3/blob/master/docs/source/examples.rst under Howto

@@ -193,7 +193,21 @@ def sample(draws=500, step=None, init='auto', n_init=200000, start=None, trace=N
live_plot_kwargs=None, compute_convergence_checks=True, use_mmap=False, **kwargs):
"""Draw samples from the posterior using the given step methods.

Multiple step methods are supported via compound step methods.
Multiple step methods are supported via compound step methods. When compound steps are involved, it takes a list of
Copy link
Member

Choose a reason for hiding this comment

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

Please reverse these changes.

@junpenglao
Copy link
Member

Look good to me mostly, could you please upgrade your pymc3 version to the newest one and rerun your notebook?

@@ -193,7 +193,7 @@ def sample(draws=500, step=None, init='auto', n_init=200000, start=None, trace=N
live_plot_kwargs=None, compute_convergence_checks=True, use_mmap=False, **kwargs):
"""Draw samples from the posterior using the given step methods.

Multiple step methods are supported via compound step methods.
Multiple step methods are supported via compound step methods.
Copy link
Member

Choose a reason for hiding this comment

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

This isn't required.

@junpenglao junpenglao removed the WIP label Jul 30, 2018
@junpenglao junpenglao merged commit 452d5e2 into pymc-devs:master Jul 30, 2018
@junpenglao
Copy link
Member

Thanks @huangy22! And congrats on the first contribution ;-)

@huangy22
Copy link
Contributor Author

Thank you for all your help @junpenglao and @twiecki ! :-)

@huangy22 huangy22 deleted the doc.step_method branch July 30, 2018 14:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants