MatrixRTCoefficients_v3.h

Go to the documentation of this file.

// ************************************************************************** //
//
//  BornAgain: simulate and fit scattering at grazing incidence
//
//! @file     Sample/RT/MatrixRTCoefficients_v3.h
//! @brief    Defines class MatrixRTCoefficients_v3.
//!
//! @homepage  http://www.bornagainproject.org
//! @license   GNU General Public License v3 or higher (see COPYING)
//! @copyright Forschungszentrum Jülich GmbH 2020
//! @authors   Scientific Computing Group at MLZ (see CITATION, AUTHORS)
//
// ************************************************************************** //
 
#ifndef BORNAGAIN_CORE_RT_MATRIXRTCOEFFICIENTS_V3_H
#define BORNAGAIN_CORE_RT_MATRIXRTCOEFFICIENTS_V3_H
 
#include "Base/Vector/Vectors3D.h"
#include "Sample/RT/ILayerRTCoefficients.h"
#include <vector>
 
//! Specular reflection and transmission coefficients in a layer in case
//! of magnetic interactions between the scattered particle and the layer.
//! @ingroup algorithms_internal
 
class MatrixRTCoefficients_v3 : public ILayerRTCoefficients
{
public:
    friend class SpecularMagneticNewStrategy;
    friend class SpecularMagneticNewNCStrategy;
    friend class SpecularMagneticNewNCTestingStrategy;
    friend class SpecularMagneticNewTanhStrategy;
    friend class SpecularMagnetic_v3ConsistencyTest;
    friend class SpecularMagnetic_v3ConsistencyTest_ScalarMagneticAmplitudes_Test;
    friend class SpecularMagnetic_v3ConsistencyTest_AmplitudesBackwardsBackwards_Test;
    template <class sampleClass> friend class TestSimulation;
 
    MatrixRTCoefficients_v3(double kz_sign, Eigen::Vector2cd eigenvalues, kvector_t b,
                            double magnetic_SLD);
    MatrixRTCoefficients_v3(const MatrixRTCoefficients_v3& other);
    ~MatrixRTCoefficients_v3() override;
 
    MatrixRTCoefficients_v3* clone() const override;
 
    //! The following functions return the transmitted and reflected amplitudes
    //! for different incoming beam polarizations and eigenmodes
    Eigen::Vector2cd T1plus() const override;
    Eigen::Vector2cd R1plus() const override;
    Eigen::Vector2cd T2plus() const override;
    Eigen::Vector2cd R2plus() const override;
    Eigen::Vector2cd T1min() const override;
    Eigen::Vector2cd R1min() const override;
    Eigen::Vector2cd T2min() const override;
    Eigen::Vector2cd R2min() const override;
    //! Returns z-part of the two wavevector eigenmodes
    Eigen::Vector2cd getKz() const override;
    double magneticSLD() const { return m_magnetic_SLD; }
 
    Eigen::Matrix2cd computeP() const;
    Eigen::Matrix2cd computeInverseP() const;
 
    Eigen::Matrix2cd computeDeltaMatrix(double thickness);
 
    Eigen::Matrix2cd getReflectionMatrix() const override { return m_R; };
 
private:
    double m_kz_sign; //! wave propagation direction (-1 for direct one, 1 for time reverse)
    Eigen::Vector2cd m_lambda; //!< eigenvalues for wave propagation
    kvector_t m_b;             //!< unit magnetic field vector
    double m_magnetic_SLD;
 
    Eigen::Matrix2cd m_T;
    Eigen::Matrix2cd m_R;
 
    // helper functions to compute DWBA compatible amplitudes used in the T1plus() etc. functions
    Eigen::Matrix2cd TransformationMatrix(Eigen::Vector2d selection) const;
    Eigen::Matrix2cd T1Matrix() const;
    Eigen::Matrix2cd T2Matrix() const;
 
    Eigen::Matrix2cd pMatrixHelper(double sign) const;
};
 
#endif // BORNAGAIN_CORE_RT_MATRIXRTCOEFFICIENTS_V3_H