Skip to content

Update OneShiftOnly doc#5155

Merged
prckent merged 3 commits into
QMCPACK:developfrom
ye-luo:update-opt-doc
Sep 4, 2024
Merged

Update OneShiftOnly doc#5155
prckent merged 3 commits into
QMCPACK:developfrom
ye-luo:update-opt-doc

Conversation

@ye-luo
Copy link
Copy Markdown
Contributor

@ye-luo ye-luo commented Sep 3, 2024

Proposed changes

Clarify how to choose and adjust minwalkers

What type(s) of changes does this code introduce?

  • Documentation or build script changes

Does this introduce a breaking change?

  • No

What systems has this change been tested on?

epyc-server

Checklist

  • Yes. This PR is up to date with current the current state of 'develop'

Comment thread docs/methods.rst Outdated
If optimization gets stuck with proposed parameter sets being constantly rejected, decrease ``minwalkers``.
When the energy gradually converges, keeping a large ``minwalkers`` is necessary to prevent accepting risky parameter sets.
Continuing optimization with more parameters from a partially converged wavefunction should also use large ``minwalkers``,
for example adding three-body Jastrow factor to converged one-body and two-body Jastrow factors.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

It sounds like this process is expected to take several job submissions, Is it actually made clear elsewhere in the manual how to do this?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Peter: We need more examples. Another strategy is also to freeze/unfreeze parameters.

This updated text is a good improvement. It needs a little smoothing for language and I think specific examples of small and large values for minwalkers in the text would help with readability. One also has to search to find the acceptable range of values for minwalkers and what it is.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@PDoakORNL It can be done with several jobs, it can also be done within a single job using https://qmcpack.readthedocs.io/en/develop/methods.html#variational-parameter-selection with a bit waste of computation evaluating zeros.

To reach control free optimization, we need to minimize the set of controlling knobs, understand how they behave and then develop a smart scheme. As @PDoakORNL mentioned, examples are important and I also think some FAQs are needed.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

So this seems like an improvement for sure. Unless you're planning to write more now I think it could just go in.

Copy link
Copy Markdown
Contributor

@prckent prckent left a comment

Choose a reason for hiding this comment

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

Updated. I'll start the CI and merge process but please check for typos.

@prckent
Copy link
Copy Markdown
Contributor

prckent commented Sep 4, 2024

Test this please

@prckent prckent enabled auto-merge September 4, 2024 18:50
@prckent prckent merged commit 100d5f1 into QMCPACK:develop Sep 4, 2024
@ye-luo ye-luo deleted the update-opt-doc branch January 17, 2025 22:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants