Miscellaneous code review comments to add comments, remove redundant brackets
Also added comment to the sample environment concept page to explain where
Mantid will search for the attenuation profile file

Signed-off-by: Steven Hahn <hahnse@ornl.gov>

Signed-off-by: Steven Hahn <hahnse@ornl.gov>

Signed-off-by: Steven Hahn <hahnse@ornl.gov>

Signed-off-by: Steven Hahn <hahnse@ornl.gov>

Runs clang-tidy pass by ref across the codebase to fix-up various
warnings we are seeing in cppcheck

Signed-off-by: Steven Hahn <hahnse@ornl.gov>

Signed-off-by: Steven Hahn <hahnse@ornl.gov>

Signed-off-by: Steven Hahn <hahnse@ornl.gov>

Signed-off-by: Steven Hahn <hahnse@ornl.gov>

Signed-off-by: Steven Hahn <hahnse@ornl.gov>

While the primary use of the new attenuation profile file feature is expected
to be via the sample environment xml file, it also makes sense to add it into
any algorithms where the material properties can be specified. So I've added a
new attenuation profile parameter to the SetSampleMaterial and LoadSampleEnvironment
algorithms. The validations on these algorithms means they can't be called using
postional arguments so have inserted the new parameter in the logical place next
to the absorption cross section

Have updated the docs to explain how the attenuation profile file is used

Also updated class_maker.py

This commit replaces all header guards in DataHandling with #pragma once

Reuse map from NeXus file getEntries prevents creation and destruction
of std::map
addressing clang-format

This commit fixes garbled code resulting from a mistake during merging master
It also removes an in correctly named file that has since been replaced with a correctly spelled one.

Remove commented out code in LoadStlFactory.h
Remove redundant inline specifier from MeshFileIO and redundant clauses
in switch statements
Edits to two documentation files that are impacted by the addition of the
stl path feature to the environment definition .xml files

The format of the sample environment xml file has been extended to support
loading a .stl file for each environment component. An example spec file
has been created in ISIS/Pearl.xml. This can be used when running the
Algorithm SetSample
Various SampleEnvironmentXXX units have been moved out the Geometry package
into the DataHandling package to facilitate this because they needed to
access the STL loading code in DataHandling
SetSample contains some features for overriding the sample geometry if the
geometry is a CSGObject. This has been sidestepped for mesh geometries.
The methods setId and setMaterial have been moved up to IObject because
it's useful to have them applicable to all objects (CSG, mesh)
Some of the repeated code in SetSample, LoadSampleEnvironment (and now
SampleEnvironmentSpecParser) has been centralised in a new class LoadStlFactory
Also changed container logic so that if there's only one container specified
in the env spec file you don't need to specify it in SetSample
Centralise code relating to scaling mesh vertices and handling of units
into the LoadShape class and rename it MeshFileIO now that SaveStl is also
descended from this class
Move repeated code to choose Ascii or binary STL reader into a factory class

This creates the framework for a saveRMCProfile algorithm that would be used for saving spectral density data in a format that can be read by RMCProfile.
TODO get propper format of metadata

re: #27774

This commit refactors the the SavePDFGui algorithm to have two seperate functions, one for metadata and one for axis data. This makes any future changes simpler and makes the algorithm easy to duplicate with different metadata for different formats

re: #27774

This commit adds a decstrings of the SavePDFGui.

re: #27774

Keeping with integer arithmetic during the conversion
means that the time resolution cannot go below 1us and
artifacts in the data are produced.
Added tests for data/sample logs for small bin widths.