-
Notifications
You must be signed in to change notification settings - Fork 339
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
Example notebook for proton radiography custom source capability #1054
Example notebook for proton radiography custom source capability #1054
Conversation
Check out this pull request on See visual diffs & provide feedback on Jupyter Notebooks. Powered by ReviewNB |
Codecov ReportAll modified and coverable lines are covered by tests ✅
Additional details and impacted files@@ Coverage Diff @@
## master #1054 +/- ##
==========================================
+ Coverage 96.89% 96.90% +0.01%
==========================================
Files 70 70
Lines 6920 6925 +5
==========================================
+ Hits 6705 6711 +6
+ Misses 215 214 -1 ☔ View full report in Codecov by Sentry. |
@rocco8773 Can you take a look at this one? |
@pheuer Yes, I'll take a look over it. Give me today/tomorrow to get to it. Thanks. |
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.
@pheuer Here's a partial review of the notebook. The notebook looks to be in good condition, but there are a few things to address.
- As you can see in my first cell comment, Sphinx's normal linking mechanisms don't work in notebooks. Instead we have to manually create links using markdown's syntax. Can you go through your notebook and add these links to documentation whenever you're referencing
plasmapy
's functionality or any external pkgs likenumpy
. - This notebook is long enough that it might warrant making a table of contents at the top of the notebook. If you feel you'd like to go this way, take a look at the Fit Function notebook and/or Floating Potential notebook.
- Can you please optimize the plot sizes and font sizes? More so the font sizes. The font sizes are a little too small for readability in a web browser. For tips you can again refer to the Fit Function and Floating Potential notebooks.
- [optional] When plotting the particle distributions, it might be easier for users to interpret the plots if they are normalized to the total number of particles in the distribution
N / No / dSigma
. If you go this route,No
should be included somewhere in the plot.
docs/notebooks/proton_radiography_particle_tracing_custom_source.ipynb
Outdated
Show resolved
Hide resolved
docs/notebooks/proton_radiography_particle_tracing_custom_source.ipynb
Outdated
Show resolved
Hide resolved
docs/notebooks/proton_radiography_particle_tracing_custom_source.ipynb
Outdated
Show resolved
Hide resolved
docs/notebooks/proton_radiography_particle_tracing_custom_source.ipynb
Outdated
Show resolved
Hide resolved
docs/notebooks/proton_radiography_particle_tracing_custom_source.ipynb
Outdated
Show resolved
Hide resolved
docs/notebooks/proton_radiography_particle_tracing_custom_source.ipynb
Outdated
Show resolved
Hide resolved
docs/notebooks/proton_radiography_particle_tracing_custom_source.ipynb
Outdated
Show resolved
Hide resolved
@rocco8773 Great, thanks for the review. I think I've addressed all your comments |
Co-authored-by: Erik Everson <[email protected]>
…/pheuer/PlasmaPy into prad_custom_source_example_ipynb
Co-authored-by: Erik Everson <[email protected]>
Co-authored-by: Erik Everson <[email protected]>
Co-authored-by: Erik Everson <[email protected]>
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.
Thanks for sticking with this. Everything looks really good!
That last thing that's needed is a change log entry for rot_a_to_b
, so create a 1054.feature.rst
for this.
No problem - change log entry created! |
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.
All looks good. I'm going to wait for the checks to pass and then I'll merge. Thanks for the hard work!
This PR adds an example notebook demonstrating how users can use
SyntheticProtonRadiograph
to create synthetic proton radiographs using custom lists of initialized particles, and how this capability allows the creation of synthetic radiographs with arbitrary source fluence profiles.(Previously
load_particles
wasn't used in any of the example notebooks)This PR also now includes minor changes to the other PRad notebooks too (mostly adding links).
TODO:
rot_a_to_b()
in mathematics. Requires making atest_mathematics.py
file.