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

3208 update the plasma profiles section of the docs to include all new models #3256

Conversation

chris-ashe
Copy link
Collaborator

@chris-ashe chris-ashe commented Jul 23, 2024

Description

This change sees a large expansion to the documentation for the plasma profiles.
All functions that calculate the plasma profiles are now documented along with full derivations of all the maths involved.
The profiles.py and plasma_profiles.py files have also been updated to be more pythonic with some functions now utilising modern library's

The re-derivation for the pedestal profiles showed some errors in the original calculations which showed periodic variation in the core temperature value for increasing $\alpha_T$. The top figure is the newly derived continuous function, the middle is the non-continuous function for non-integer values and the bottom plot is the difference between the two.
image

Checklist

I confirm that I have completed the following checks:

  • I have justified any large differences in the regression tests caused by this pull request in the comments.
  • I have added new tests where appropriate for the changes I have made.
  • If I have had to change any existing unit or integration tests, I have justified this change in the pull request comments.
  • If I have made documentation changes, I have checked they render correctly.
  • I have added documentation for my change, if appropriate.

chris-ashe added 14 commits July 8, 2024 15:57
Refactor the Profile class in profiles.py to improve code structure and readability. Also, add detailed documentation to explain the purpose and functionality of the class and its methods.
Update the navigation structure in the mkdocs.yml file to include sub-pages for the Profiles section. This change adds separate pages for the Overview, Density Profile, Temperature Profile, and Profile Base Class. It also updates the Composition & Impurities page and adds a new Radiation page. This improves the organization and accessibility of the Plasma Profiles documentation.
Refactor the Profile class in profiles.py to enhance code structure and readability. Additionally, add comprehensive documentation to clarify the purpose and functionality of the class and its methods.
Update the parameterization method in the PlasmaProfile class to handle the case where ipedestal is equal to 0. This improves the accuracy and reliability of the plasma profile calculations.
@chris-ashe chris-ashe added the Documentation Improvements or additions to documentation label Jul 23, 2024
@chris-ashe chris-ashe self-assigned this Jul 23, 2024
@chris-ashe chris-ashe linked an issue Jul 23, 2024 that may be closed by this pull request
18 tasks
@chris-ashe chris-ashe requested a review from stuartmuldrew July 23, 2024 07:47
Copy link
Collaborator

@j-a-foster j-a-foster left a comment

Choose a reason for hiding this comment

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

Made spelling and grammar corrections to docs and pointed out some in the docstrings of ncore and tcore. Once they're dealt with, happy for this to be merged.

process/profiles.py Outdated Show resolved Hide resolved
process/profiles.py Outdated Show resolved Hide resolved
@chris-ashe chris-ashe removed the request for review from stuartmuldrew July 24, 2024 10:16
@chris-ashe chris-ashe removed the request for review from timothy-nunn July 24, 2024 10:16
Copy link
Collaborator

@j-a-foster j-a-foster left a comment

Choose a reason for hiding this comment

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

Happy with the changes and for this to be merged.

@chris-ashe chris-ashe merged commit 6167cf9 into main Jul 24, 2024
18 of 22 checks passed
@chris-ashe chris-ashe deleted the 3208-update-the-plasma-profiles-section-of-the-docs-to-include-all-new-models branch July 24, 2024 13:53
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.

Update the plasma profiles section of the docs to include all new models
2 participants