Add generic vol avg profile function

[chris-ashe]

This pull request introduces a new utility function for calculating the volume-averaged value of a radially normalized profile and adds detailed documentation explaining the mathematical derivation behind this calculation. These changes improve both code reusability and the clarity of the underlying physics for future developers and users.

New functionality

• Added calculate_vol_avg_of_profile() to process/models/physics/profiles.py, which computes the volume-averaged value of a normalized radial profile, including comprehensive input validation.

Documentation improvements

• Added a new section to plasma_profiles.md that explains the derivation and usage of the volume-averaging calculation, including all relevant equations and context.

Checklist

I confirm that I have completed the following checks:

• My changes follow the PROCESS style guide
• 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.

[je-cook]

Am I mistaken here or is all of the changes hiding the main change which is just this?:

    return 2.0 * sp.integrate.simpson(
        profile_y * profile_x,
        x=profile_x,
        dx=profile_x[1] - profile_x[0],
    )

[chris-ashe]

Am I mistaken here or is all of the changes hiding the main change which is just this?:

    return 2.0 * sp.integrate.simpson(
        profile_y * profile_x,
        x=profile_x,
        dx=profile_x[1] - profile_x[0],
    )

Yes, still WIP and needs cherry-picked

[codecov-commenter]

Codecov Report

❌ Patch coverage is 10.00000% with 9 lines in your changes missing coverage. Please review.
✅ Project coverage is 49.84%. Comparing base (bd5e644) to head (6bee04b).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
process/models/physics/profiles.py	10.00%	9 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4568      +/-   ##
==========================================
- Coverage   49.85%   49.84%   -0.02%     
==========================================
  Files         151      151              
  Lines       29875    29885      +10     
==========================================
+ Hits        14894    14895       +1     
- Misses      14981    14990       +9     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.