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

Chore/docstrings #88

Merged
merged 16 commits into from
Jun 19, 2024
Merged

Chore/docstrings #88

merged 16 commits into from
Jun 19, 2024

Conversation

tiaguinho-code
Copy link
Collaborator

Adding docstrings to all functions in nmrcraft directory and also added the poster to the readme.

@tiaguinho-code
Copy link
Collaborator Author

Poster is 1000DPI so 8MB. Maybe that's a bit chunky, we can have different resolutions and you guys decide whats best for the readme experience

@tiaguinho-code tiaguinho-code added the documentation Improvements or additions to documentation label Jun 14, 2024
Copy link
Owner

@mlederbauer mlederbauer left a comment

Choose a reason for hiding this comment

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

Super nice work, thanks a lot Tiago! Particularly the examples are very nice to add to the dataloader docstring. I think it’s good to go, however there were two things that would be good to address before merging

(i) Poster resolution: Is there a particular reason we save the poster in multiple resolutions?

(ii) Visualizer and Classifier: Do we call these modules/python files in our workflow? If I remember correctly, we implemented all functionality of those files in our code, but do not need the file itself anymore. Could you kindly check if we “need” the Visualizer/Classifier for running the code and, if not, delete them? Just to not cause any confusion when the TAs review the code.

Thanks a lot in advance!!

@@ -104,7 +104,9 @@ When the parameter `max_eval` is set to a high value such as 20, expect the whol

# 🖼️Poster

If you were not able to visit our beautiful poster at ETH Zurich on May 30th 2024, you can access our poster [here](TODO)!
If you were not able to visit our beautiful poster at ETH Zurich on May 30th 2024, you can access our poster [here](assets/Poster.pdf)!
Copy link
Owner

Choose a reason for hiding this comment

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

Thanks a lot for taking care of this!

Copy link
Owner

Choose a reason for hiding this comment

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

Do we need the poster in the other resolutions?

@@ -31,6 +31,37 @@


class DataLoader:
"""
Copy link
Owner

Choose a reason for hiding this comment

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

Super nice very clean and explanatory docstrings!

Copy link
Owner

Choose a reason for hiding this comment

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

Do we even need the visualizer anymore or is it depreceated, since we running the visualization via scripts/visualize_results?

Copy link
Owner

Choose a reason for hiding this comment

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

If it is not needed anymore, I would suggest to delete the file for keeping a better overview

Copy link
Owner

Choose a reason for hiding this comment

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

The only plotting function we use in visualize_results are those from nmrcraft/analysis/plotting

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

I'd suggest only starting to delete stuff once we're fully there with a working reproduce script and do all the deleting in a deletion PR (just in case)

Copy link
Owner

Choose a reason for hiding this comment

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

Same here, I very much appreciate the awesome overview of the module with the docstirngs and explanations, but isn’t this depreciated, as we are not calling the Classifier in scripts/training/one_target.py or multiple_targets.py anymore?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

not sure, just went all out

same here as above where I'd like to keep stuff until the very end

Copy link
Owner

Choose a reason for hiding this comment

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

Very nicew, one option would be to rename this file to dataframe , dataframe_utils or something else? BUt this is completely optional

@mlederbauer
Copy link
Owner

Could you kindly select the poster resolution that we need (@kbiniek ), after that we can merge to main. Thanks a lot in advance !!

Copy link
Owner

@mlederbauer mlederbauer left a comment

Choose a reason for hiding this comment

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

LEt’s remove the redundant scripts later.

@mlederbauer mlederbauer merged commit 4868d4c into main Jun 19, 2024
1 check passed
@mlederbauer mlederbauer deleted the chore/docstrings branch June 19, 2024 11:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants