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

finalize 1.0.0 #261

Merged
merged 7 commits into from
Nov 1, 2022
Merged

finalize 1.0.0 #261

merged 7 commits into from
Nov 1, 2022

Conversation

orbeckst
Copy link
Member

- add tests
- add deprecation docs
- raise warnings at stacklevel 2 so that they appear for decorrelate() and friends
@codecov
Copy link

codecov bot commented Oct 31, 2022

Codecov Report

Merging #261 (c57934a) into master (3809fdf) will increase coverage by 0.03%.
The diff coverage is 100.00%.

@@            Coverage Diff             @@
##           master     #261      +/-   ##
==========================================
+ Coverage   98.65%   98.69%   +0.03%     
==========================================
  Files          26       26              
  Lines        1711     1759      +48     
  Branches      352      363      +11     
==========================================
+ Hits         1688     1736      +48     
  Misses          3        3              
  Partials       20       20              
Impacted Files Coverage Δ
src/alchemlyb/workflows/abfe.py 99.66% <ø> (ø)
src/alchemlyb/workflows/base.py 100.00% <ø> (ø)
src/alchemlyb/convergence/__init__.py 100.00% <100.00%> (ø)
src/alchemlyb/convergence/convergence.py 100.00% <100.00%> (ø)
src/alchemlyb/preprocessing/subsampling.py 100.00% <100.00%> (ø)

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

@orbeckst orbeckst added this to the 1.0.0 milestone Oct 31, 2022
@orbeckst orbeckst requested a review from xiki-tempula November 1, 2022 09:33
Copy link
Collaborator

@xiki-tempula xiki-tempula left a comment

Choose a reason for hiding this comment

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

Many thanks for finalising the release just some minor doc comments.

This function computes :math:`R_c` from `equation 16`_ from [Fan2021]_.
The code is modified based on Shujie Fan's (@VOD555) work. Zhiyi Wu
(@xiki-tempula) improved the performance of the original algorithm by
pre-computing block averages for fractional increments of `precision`.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Shujie Fan's (@VOD555) work has already implemented the pre-computing block averages. His work uses the normal python for loop and I have improved the performance by vectorise it using numpy array.

Copy link
Member Author

Choose a reason for hiding this comment

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

thanks, reworded

"""Convert a dhdl DataFrame to a series for subsampling.

The series is generated by summing over all energy components (axis 1 of
`df`), as for ``method='all'`` in :func:`u_nk2series`. Normally, `df` only
contains a single energy component.
Copy link
Collaborator

Choose a reason for hiding this comment

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

I think it might not be very good to have Normally in

Normally, df only contains a single energy component.

If one use split protocol in Gromacs, the dhdl will always have more than one column and using the phrase Normally might indicate that having more than one column in dHdl is abnormal. I think it might be good to change it to

Most df` only contains a single energy component.

Copy link
Member Author

Choose a reason for hiding this comment

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

thanks, reworded

@orbeckst
Copy link
Member Author

orbeckst commented Nov 1, 2022 via email

- finalize CHANGES (reformatting, consolidating of entries)
- add @DrDomenicoMarson to contributors for 1.0.0
- add versionadded 1.0.0 to docs where necessary
- CHANGES note pymbar 3.x for 1.0, see issue #205
- docs:
  - Only list functions in convergence submodule.
  - updated text
  - added Fan 2020 reference
  - fix reST
  - add Klimovich citation for normal fwdbck convergence
- functions
  - use *same* kwarg for tolerance: `tol` for Rc and Ac (changed
    A_c `diff` to `tol`)
  - update A_c/R_c docs to use `tol`
  - explicitly set tol=2 in tests
- include everyone in AUTHORS
- sort alphabetically
- updated to most recent year
Note that sphinx is still complaining about duplicate object descriptions
in workflows.base.WorkflowBase, namely any of the attributes.
Copy link
Collaborator

@xiki-tempula xiki-tempula left a comment

Choose a reason for hiding this comment

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

LGTM

@orbeckst orbeckst self-assigned this Nov 1, 2022
@orbeckst orbeckst merged commit be76199 into master Nov 1, 2022
@orbeckst orbeckst deleted the finalize-1.0.0 branch November 1, 2022 17:14
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.

2 participants