Add model type output to physics plot proc

[chris-ashe]

This pull request introduces several improvements and corrections to plasma physics documentation, plotting routines, and constraint definitions. The main themes are: enhanced plot summaries and visualizations, improved model labeling and clarity in plots, and consistent use of SI units (especially superscript formatting) throughout constraint equations and documentation.

Plotting and Visualization Improvements:

• Added a new function, plot_max_normalised_beta_comparison, to visualize and compare different models of maximum normalized beta (β_N) using violin and box plots, including statistical summaries (average, standard deviation, median). This plot is integrated into the main plotting routine.
• Improved axis titles and labels for clarity and scientific accuracy in several comparison plots, such as explicitly using LaTeX notation for physical quantities (f_\text{BS}, $P_\text{LH}, $I_p, etc.).

Model and Output Labeling Enhancements:

• Updated plot text to include the full names of the models used for bootstrap current fraction, normalized internal inductance, L-H threshold, and density limit, improving interpretability of plot outputs.
  Documentation and Reference Updates:

• Added a section on the ITER physics basis definition for separatrix elongation in the plasma geometry documentation, including the relevant formula and citation.

Constraint Equation and Unit Consistency:

• Standardized all SI units in constraint equation decorators and docstrings to use superscript formatting (e.g., MW/m³ instead of MW/m3), and made related docstring corrections for clarity and consistency.

These changes collectively improve the scientific accuracy, clarity, and usability of the codebase and its outputs.## Description

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 21.24711% with 341 lines in your changes missing coverage. Please review.
✅ Project coverage is 52.14%. Comparing base (14ef433) to head (d160390).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
process/models/physics/physics.py	4.71%	263 Missing ⚠️
process/models/physics/plasma_current.py	5.88%	32 Missing ⚠️
process/core/io/plot/summary.py	12.12%	29 Missing ⚠️
process/models/physics/bootstrap_current.py	75.86%	7 Missing ⚠️
process/models/physics/density_limit.py	76.19%	5 Missing ⚠️
process/models/physics/plasma_geometry.py	42.85%	4 Missing ⚠️
process/models/physics/profiles.py	90.90%	1 Missing ⚠️

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #4214   +/-   ##
=======================================
  Coverage   52.13%   52.14%           
=======================================
  Files         148      148           
  Lines       30419    30515   +96     
=======================================
+ Hits        15858    15911   +53     
- Misses      14561    14604   +43     

☔ View full report in Codecov by Sentry.
📢 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.

[Copilot]

Pull request overview

This PR enhances PROCESS physics reporting by emitting the selected model type alongside key physics outputs and plotting annotations, and by adding ITER Physics Basis (IPB) elongation as a first-class quantity for output/documentation.

Changes:

• Add human-readable model labels (full_name / description) to several physics IntEnums and surface them in text output + summary plots.
• Add/reuse a shared PlasmaGeom.calculate_iter_physics_basis_elongation() helper, output kappa_ipb, and document the IPB elongation definition.
• Improve output/plot labeling (symbols, units with superscripts) across physics outputs and constraints metadata.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
tests/unit/models/physics/test_plasma_geom.py	Adds a unit test for the new ITER Physics Basis elongation helper.
process/models/physics/profiles.py	Extends PlasmaProfileShapeType enum with a human-readable description.
process/models/physics/plasma_geometry.py	Adds IPB elongation calculation helper and outputs kappa_ipb; improves geometry output labels.
process/models/physics/plasma_fields.py	Improves magnetic field output labels with symbols.
process/models/physics/plasma_current.py	Adds model-name-aware output for plasma current and diamagnetic current sections.
process/models/physics/physics.py	Refactors/updates plasma outputs to include selected model names; reorganizes profile output into a helper method.
process/models/physics/density_limit.py	Adds density limit model selection output + exposes i_density_limit and nd_plasma_electrons_max more explicitly.
process/models/physics/confinement_time.py	Switches IPB elongation calculation to call the shared geometry helper.
process/models/physics/bootstrap_current.py	Adds model-name-aware output and cleans up bootstrap fraction labeling.
process/core/solver/constraints.py	Updates constraint unit strings to use superscripts (e.g., m³, m²) and adjusts related doc text.
process/core/io/plot/summary.py	Adds model names to plot annotations and introduces a “Max Normalised Beta comparison” plot.
documentation/source/physics-models/plasma_geometry.md	Documents IPB elongation definition and adds a new reference.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

plot_max_normalised_beta_comparison passes scalar values (from mfile.get(..., scan=scan)) directly into axis.violinplot()/axis.boxplot(). Matplotlib expects each dataset to be a 1D sequence; scalars will raise at runtime (0-d arrays are not sized). Consider switching this to a simple bar/scatter comparison across models, or wrap each value as a 1-element list/array and set explicit positions + x tick labels so the plot is meaningful (and avoid plotting all points at x=1).

[Copilot]

The local stats variables are named avg_density_limit / std_density_limit / median_density_limit, but they are computed from max normalised beta values. Renaming these to beta-specific names would avoid confusion when maintaining or extending this plotting code.

Suggested change

	avg_density_limit = np.mean(data_values)
	std_density_limit = np.std(data_values)
	median_density_limit = np.median(data_values)
	# Plot average, standard deviation, and median as text
	axis.text(
	1.1,
	0.15,
	rf"Average: {avg_density_limit:.4f}",
	transform=axis.transAxes,
	fontsize=9,
	)
	axis.text(
	1.1,
	0.1,
	rf"Standard Dev: {std_density_limit:.4f}",
	avg_beta_norm_max = np.mean(data_values)
	std_beta_norm_max = np.std(data_values)
	median_beta_norm_max = np.median(data_values)
	# Plot average, standard deviation, and median as text
	axis.text(
	1.1,
	0.15,
	rf"Average: {avg_beta_norm_max:.4f}",
	transform=axis.transAxes,
	fontsize=9,
	)
	axis.text(
	1.1,
	0.1,
	rf"Standard Dev: {std_beta_norm_max:.4f}",

[Copilot]

The docstring for calculate_iter_physics_basis_elongation is internally inconsistent: it says the calculation is “based on the aspect ratio and a scaling factor”, but the implementation uses plasma volume, major radius, and minor radius directly. Also the reference text includes stray "None" tokens in the author names; please clean up the citation so it renders correctly in docs and generated outputs.

[Copilot]

Footnote [^9] has malformed author names ("None Otto Kardaun" / "None Alexander Chudnovskiy"). Please fix the citation metadata/text so the rendered documentation doesn’t include "None" in the author list.

Suggested change

	[^9]: None Otto Kardaun, N. K. Thomsen, and None Alexander Chudnovskiy, “Corrections to a sequence of papers in Nuclear Fusion,” Nuclear Fusion, vol. 48, no. 9, pp. 099801099801, Aug. 2008, doi: https://doi.org/10.1088/0029-5515/48/9/099801.
	[^9]: Otto Kardaun, N. K. Thomsen, and Alexander Chudnovskiy, “Corrections to a sequence of papers in Nuclear Fusion,” Nuclear Fusion, vol. 48, no. 9, pp. 099801099801, Aug. 2008, doi: https://doi.org/10.1088/0029-5515/48/9/099801.

[j-a-foster]

Happy with changes.