-
Notifications
You must be signed in to change notification settings - Fork 1
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
Convert remaining docstrings to numpydoc style #66
Conversation
Codecov ReportAll modified and coverable lines are covered by tests ✅
Additional details and impacted files@@ Coverage Diff @@
## main #66 +/- ##
==========================================
+ Coverage 89.07% 89.15% +0.07%
==========================================
Files 35 35
Lines 1355 1355
==========================================
+ Hits 1207 1208 +1
+ Misses 148 147 -1 ☔ View full report in Codecov by Sentry. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
No problems with the changes, comments are things that I noticed I should've added to the docstrings when writing them in the first place 😅
Returns | ||
------- | ||
pd.DataFrame | ||
Dataframe with Inf replaced with NaN. | ||
""" | ||
df = df.replace(np.inf, np.nan) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not sure why we have a whole function that creates a copy, assigns it to the input, then returns the input, but it was here before so I won't question it.
Though it does seem like overkill when
df.replace(np.inf, np.nan, inplace=True)
does literally the same thing.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes it does seem like overkill! I guess it is needed elsewhere in BrainGlobe
Co-authored-by: Will Graham <[email protected]>
Description
What is this PR
Why is this PR needed?
Some docstrings are still in reST format.
What does this PR do?
Updates all remaining docstrings to
numpydoc
format.References
For #19
How has this PR been tested?
All tests pass locally.
Is this a breaking change?
No
Does this PR require an update to the documentation?
No
Checklist: