♻️ Refactor Availability module part1

[chris-ashe]

This pull request updates the naming conventions and documentation for the plant availability models and related variables to improve clarity and consistency across the codebase, documentation, and example data files. The changes also introduce more detailed documentation for each availability model and its associated calculations.

🔄 Renames

• iavail -> i_plant_availability
• tbktrepl -> t_blkt_replace_yrs
• tdivrepl -> t_div_replace_yrs
• t_operation -> t_plant_operational_total_yrs
• cfactr -> f_t_plant_available
• cdrlife -> life_hcd_fpy
• tlife -> life_plant
• divlife -> life_div_fpy
• divlife_cal -> life_div

Documentation improvements and variable renaming:

• Renamed the switch for selecting the plant availability model from iavail to i_plant_availability, and the overall plant availability factor from cfactr to f_t_plant_available throughout documentation/eng-models/plant-availability.md, documentation/io/python-lib-guide.md, and all example data files. [1] [2] [3] [4] [5] [6]
• Updated variable names for component lifetimes and other outputs in example data files, such as divlife to life_div_fpyv_fpy, cdrlife to life_hcd_fpy, tlife to life_plant, and cfactr to f_t_plant_available. [1] [2] [3] [4] [5] [6] [7] [8]
• Expanded and clarified the documentation in plant-availability.md to describe the Taylor-Ward, Morris, and Spherical Tokamak (ST) models, including their input parameters, calculation methods, and relevant equations. New sections detail planned and unplanned unavailability calculations for various subsystems. [1] [2] [3]
• Added section dividers and improved formatting for model-specific documentation, making it easier to navigate and understand the calculation flow and dependencies between variables. [1] [2] [3]
• Updated references and notes in the documentation to match the new variable names and provide clearer context for users. [1] [2]

These changes ensure consistent naming, clearer documentation, and easier maintenance and extension of the plant availability models.## 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 76.99115% with 26 lines in your changes missing coverage. Please review.
✅ Project coverage is 45.98%. Comparing base (cc15436) to head (bffa82c).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
process/availability.py	79.68%	13 Missing ⚠️
process/costs.py	14.28%	6 Missing ⚠️
process/objectives.py	0.00%	3 Missing ⚠️
process/scan.py	0.00%	3 Missing ⚠️
process/ife.py	0.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3942      +/-   ##
==========================================
- Coverage   46.03%   45.98%   -0.05%     
==========================================
  Files         123      123              
  Lines       28970    29074     +104     
==========================================
+ Hits        13335    13371      +36     
- Misses      15635    15703      +68     

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

[kj5248]

Just a couple more missed

[kj5248]

All seems good now just needs to pass tests

[kj5248]

I have re-approved this. Good catch on i_plant_availabilityt_availability, I had only checked for the old still being around in the big mfiles

[kj5248]

Just noticed this on double check

[kj5248]

Two got missed. Also noticed a file disappeared from examples: examples/data/scan_MFILE.DAT? Not sure if that is intentional.