Implemented cloneInvertB() on ISample classes and use a MultiLayer with inverted magnetic field for the outgoing scattering states if necessary; refactored MagneticCoefficientsMap

more work on class and method comments

Insert new header comment block, remove old one, manually improve file comments (defines / implements), change brief function description to doxygen format, remove some outcommented code