This commit corrects issues related to the changing property names in
MergeWorkspacesWithLimits and TotScatCalculateSelfScattering

re: #27445

This commit makes several changes requested during code review including:

- Rename CalculateSelfScatteringCorrection to TotScatCalculateSelfScattering
- Removing unnecessary __init__ function
- Correcting property docstring for CalFileName
- Changing CalFileName into a FileProperty

re: #27445

This commit removes the _merge_workspace_with_limits function that had been
previously removed in a different commit, It was accidentally returned to the script
when the branch had to be rebased after a commit message had to be changed to
match the required level of detail and proper formatting regarding the method of
referencing git issues, that being 'Re' followed by hash then the number.

Re #27445

This commit removes the _calculate_self_scattering_correction function in
polaris_algs that is now covered by the CalculateSelfScatteringCorrection algorithm.

Re #27445

This commit creates a documentation rst file for MergeWorkspacesWithLimits
Along with the workflow diagram dot file. It also makes changes to the
MergeWorkspacesWithLimits algorithm to include a name and version that
is required by the documentation compiler.

This commit corrects a mistake in the property names for
CalcuateSelfScatteringCorrection.

This commit removes the commented out command to the
_merge_workspaces_with_limits function in polaris_algs in place of the workflow
algorithm.

This commit creates a blank rst file that will later contain the documentation for
CalculateSelfScatteringCorrection.

Re #27445

This commit creates a workflow algorithm named MergeWorkspacesWithLimits
that handles the merging of the focused workspaces in the polaris scripts.

This commit removes a duplicated _load_qlims function in polaris_algs mistakenly added in commit 4c588e.

This commit adds a black line at the end of the CalculateSelfScatteringCorrection algorithm.

Re #27445

This commit creates a workflow algorithm named CalculateSelfScatteringCorrection
that handles the calculate of the placzek self scattering correction to be subtracted
from the focused data in the polaris scripts.

Re #27445

This commit fixes missed line that would allow the index for the max range spectra
to be updated

Re #27444

This commit moves the code for reading the supplies q limits into its own function.
This also fixes a bug that cause an error when trying to read a lim file path that is in
a unicode format.

Re #27444

This commit adds a catch for if the workspaces or q_lims file have an infinite range

Re #27444

This commit fixes missed line that would allow the index for the max range spectra
to be updated

Re #27444

This commit moves the code for reading the supplies q limits into its own function.
This also fixes a bug that cause an error when trying to read a lim file path that is in
a unicode format.

Re #27444

This commit changes the previously hard coded index for matching spectra to
instead use the workspace with the larges range of x values as these produces the
smoothest match around the edges of the workspaces data.

Re #27444

This commit changes the usage of ConjoinSpectra to a loop using ConjoinWorkspace.
This is done because using ConjoinSpectra the focused workspace can have a
mismatch between specnumbers and index

Re #27444

previous filename used POL+run_number, now loads
POLARIS+run_number_.nxs

this commit cehckes the position of monitor detectors for extraction
before use with FitIncidentSpectrum in _calculate_self_scattering_correction

as q_lims is a required paramiter for the function it would raise an error
if trying to run without it, even when it is not needed for merge_Banks=false
this change automaticaly sets q_lims to none when none is given as kwargs

CalculatePlaczekSelfScattering outputs non-distrebution workspace
correction to CalculatePlaczekSelfScattering algorithm and POLARIS
_generate_grouped_ts_pdf function makes self scattering correction
to the correct order of magnetude after processing

CalculatePlaczekSelfScattering outputs non-distrebution workspace
correction to CalculatePlaczekSelfScattering algorithm and POLARIS
_generate_grouped_ts_pdf function makes self scattering correction
to the correct order of magnetude after processing

Placzek correction will be covered in issue #26986

Also fixes FitIncidentSpectrum.py and CalculatePlaczekSelfScattering so
that output workspace has same x units

this calculates a background based on the mean value of the flatist 5 percent
of the fitted incident spectrum, based on the first derivitive