Skip to content

Removing the deprecated module, see PR #2791 for more info.#2842

Merged
orbeckst merged 7 commits intoMDAnalysis:developfrom
bieniekmateusz:deprWatHBL
Jul 14, 2020
Merged

Removing the deprecated module, see PR #2791 for more info.#2842
orbeckst merged 7 commits intoMDAnalysis:developfrom
bieniekmateusz:deprWatHBL

Conversation

@bieniekmateusz
Copy link
Member

@bieniekmateusz bieniekmateusz commented Jul 12, 2020

Fixes

Changes made in this Pull Request:

  • Removed the module wateranalysis.HydrogenBondLifetimes, with test cases and documentation
  • The example documentation now refers the user to the new module MDAnalysis.analysis.hydrogenbonds.hbond_analysis to help users switch. This could be left for some time. Please let me know if you'd rather have it cleaned up straight away.

I am not sure about the references. One way to go about this is to publish our own paper with @p-j-smith and then sort it out. Another is to remove original any reference to HBL straight away.

Related to PR #2791. Co-authored-by: @p-j-smith

PR Checklist

  • Tests?
  • Docs?
  • CHANGELOG updated?
  • Issue raised/referenced?

co-authored-by: p-j-smith <paul.smith@kcl.ac.uk>
@codecov
Copy link

codecov bot commented Jul 12, 2020

Codecov Report

Merging #2842 into develop will increase coverage by 0.00%.
The diff coverage is n/a.

Impacted file tree graph

@@           Coverage Diff            @@
##           develop    #2842   +/-   ##
========================================
  Coverage    92.20%   92.20%           
========================================
  Files          184      184           
  Lines        24103    24079   -24     
  Branches      3134     3115   -19     
========================================
- Hits         22224    22202   -22     
+ Misses        1814     1812    -2     
  Partials        65       65           
Impacted Files Coverage Δ
...DAnalysis/analysis/hydrogenbonds/hbond_analysis.py 98.63% <ø> (ø)
package/MDAnalysis/analysis/waterdynamics.py 95.58% <ø> (-0.56%) ⬇️
package/MDAnalysis/core/universe.py 96.95% <0.00%> (ø)
package/MDAnalysis/core/_get_readers.py 96.05% <0.00%> (ø)
util.py 88.10% <0.00%> (+0.08%) ⬆️
coordinates/base.py 94.82% <0.00%> (+0.28%) ⬆️
auxiliary/base.py 91.31% <0.00%> (+0.56%) ⬆️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update d266b0b...28f33bd. Read the comment docs.

Copy link
Member

@orbeckst orbeckst left a comment

Choose a reason for hiding this comment

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

Please add an entry to CHANGELOG that the class was removed. See inline for comment on docs. Thanks!

protein and residue 42. If the hydrogen bond lifetimes are very stable, we can
assume that residue 38 is hydrophilic, on the other hand, if the are very
unstable, we can assume that residue 38 is hydrophobic::
The class Analyzing hydrogen bond lifetimes (HBL)
Copy link
Member

Choose a reason for hiding this comment

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

Instead of saying that it has been removed just say that there are other ways to analyze water dynamics is the ...lifetimes() method.

Add a See Also section for the hbond_analysis module.

co-authored-by: p-j-smith <paul.smith@kcl.ac.uk>
Copy link
Member

@orbeckst orbeckst left a comment

Choose a reason for hiding this comment

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

Some small issues with the docs, see inline comments.

I also checked the docs for lifetime and there are some formatting issues. Could you please also fix the following in this PR

  • lifetime: the first line Computes and returns the time-autocorrelation (HydrogenBondLifetimes) the summarizes the function is formatted as an enumeration(?). Should look like all other methods.
  • under Example uses ... near In order to compute the hydrogen bond lifetime, after finding hydrogen bonds one can use the lifetime function: the text … hbonds.run() tau_timeseries, timeseries = hbonds.lifetime() should be formatted properly (as code block?)

@orbeckst orbeckst self-assigned this Jul 13, 2020
@orbeckst orbeckst added the remove-2.0 deprecated in 1.0 and to be removed in 2.0 label Jul 14, 2020
bieniekmateusz and others added 5 commits July 14, 2020 13:27
Co-authored-by: Oliver Beckstein <orbeckst@gmail.com>
co-authored-by: p-j-smith <paul.smith@kcl.ac.uk>
co-authored-by: p-j-smith <paul.smith@kcl.ac.uk>
@orbeckst orbeckst merged commit d1c5575 into MDAnalysis:develop Jul 14, 2020
@orbeckst
Copy link
Member

Thank you @bieniekmateusz and @p-j-smith !

PicoCentauri pushed a commit to PicoCentauri/mdanalysis that referenced this pull request Mar 30, 2021
…alysis#2842)

* remove the deprecated waterdynamics.HydrogenBondLifetimes class, see PR MDAnalysis#2791 for more info.
* update waterdynamics docs and link to the replacement,
   hydrogenbonds.hbond_analysis.HydrogenBondAnalysis.liftetime
* corrected doc formatting in hydrogenbonds.hbond_analysis
* update CHANGELOG

co-authored-by: p-j-smith <paul.smith@kcl.ac.uk>
@IAlibay IAlibay mentioned this pull request May 13, 2021
@fiona-naughton fiona-naughton added maintainability deprecation Deprecated functionality to give advance warning for API changes. labels Sep 25, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

deprecation Deprecated functionality to give advance warning for API changes. maintainability remove-2.0 deprecated in 1.0 and to be removed in 2.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants