Add function to plot PF coil dimensions in summary plot

[chris-ashe]

This pull request introduces a new visualization for plotting the dimensions of PF (Poloidal Field) coils in the summary plotting workflow. The main change is the addition of the plot_pf_dimensions function, which visually annotates PF coil positions and dimensions on the plot, and its integration into the summary plotting routine.

New PF Coil Visualization

• Added plot_pf_dimensions function to summary.py, which plots the PF coil locations, dimensions, and annotations (ΔR and ΔZ) on a given axis, enhancing the clarity of PF coil geometry in the plots.

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.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 1.85185% with 53 lines in your changes missing coverage. Please review.
✅ Project coverage is 49.15%. Comparing base (cd715d2) to head (3d10b02).
⚠️ Report is 3 commits behind head on main.

Files with missing lines	Patch %	Lines
process/core/io/plot/summary.py	1.85%	53 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4499      +/-   ##
==========================================
- Coverage   49.30%   49.15%   -0.16%     
==========================================
  Files         151      151              
  Lines       29611    29707      +96     
==========================================
+ Hits        14599    14601       +2     
- Misses      15012    15106      +94     

☔ 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.

[clmould]

I'm happy with these changes, just want a modeller to check the new figure first before I merge :)

[mkovari]

Looks nice. Why not add the dimensions of the CS (since it is a PF coil)?

[chris-ashe]

Looks nice. Why not add the dimensions of the CS (since it is a PF coil)?

The CS has its own page and dimension plot a few pages down in the summary. I will probably remove the CS from that plotting function and use the one that shows the full structure for all general plotting

[mkovari]

The OUT.DAT lists the coils as 0 to 5, not 1 to 6.

Geometry of PF coils, central solenoid and plasma:
 
Coil      R(m)    Z(m)    dR(m)    dZ(m)    turns
PF 0      5.57    9.64    1.36     1.36       506
PF 1      5.57  -10.9     1.46     1.46       587
PF 2     16.9     2.67    1.11     1.11       185
PF 3     16.9    -2.67    1.11     1.11       185
PF 4     15.4     7.47    0.769    0.769      118
PF 5     15.4    -7.47    0.769    0.769      118
CS        2.28    0       0.547   15.9       4650
Plasma    8       0       5.33     9.87         1

(To be honest I don't know why.)

[chris-ashe]

The OUT.DAT lists the coils as 0 to 5, not 1 to 6.

Geometry of PF coils, central solenoid and plasma:
 
Coil      R(m)    Z(m)    dR(m)    dZ(m)    turns
PF 0      5.57    9.64    1.36     1.36       506
PF 1      5.57  -10.9     1.46     1.46       587
PF 2     16.9     2.67    1.11     1.11       185
PF 3     16.9    -2.67    1.11     1.11       185
PF 4     15.4     7.47    0.769    0.769      118
PF 5     15.4    -7.47    0.769    0.769      118
CS        2.28    0       0.547   15.9       4650
Plasma    8       0       5.33     9.87         1

(To be honest I don't know why.)

Shall make an issue to fix this, should really index the coils from 1

[mkovari]

Shall make an issue to fix this, should really index the coils from 1

I agree.

[j-a-foster]

Happy with changes.

[clmould]

#4502 to fix PF coil numbering