BaseMaterialImpl.h

Go to the documentation of this file.

//  ************************************************************************************************
//
//  BornAgain: simulate and fit reflection and scattering
//
//! @file      Sample/Material/BaseMaterialImpl.h
//! @brief     Defines basic material implementation interface.
//!
//! @homepage  http://www.bornagainproject.org
//! @license   GNU General Public License v3 or higher (see COPYING)
//! @copyright Forschungszentrum Jülich GmbH 2018
//! @authors   Scientific Computing Group at MLZ (see CITATION, AUTHORS)
//
//  ************************************************************************************************
 
#ifdef SWIG
#error no need to expose this header to Swig
#endif
 
#ifndef USER_API
#ifndef BORNAGAIN_SAMPLE_MATERIAL_BASEMATERIALIMPL_H
#define BORNAGAIN_SAMPLE_MATERIAL_BASEMATERIALIMPL_H
 
#include <heinz/Complex.h>
#include <heinz/Vectors3D.h>
 
class RotMatrix;
class SpinMatrix;
class WavevectorInfo;
 
enum class MATERIAL_TYPES { InvalidMaterialType = -1, RefractiveMaterial = 0, MaterialBySLD };
 
//! Interface for material implementation classes.
//! Inherited by MagneticMaterialImpl, which has further children.
//! @ingroup materials
 
class BaseMaterialImpl {
public:
    //! Constructs basic material with name
    BaseMaterialImpl(const std::string& name)
        : m_name(name)
    {
    }
 
    virtual ~BaseMaterialImpl() = default;
 
    //! Returns pointer to a copy of material
    virtual BaseMaterialImpl* clone() const = 0;
 
    //! Constructs a material with inverted magnetization
    virtual BaseMaterialImpl* inverted() const = 0;
 
    //! Returns refractive index.
    virtual complex_t refractiveIndex(double wavelength) const = 0;
 
    //! Returns squared refractive index.
    virtual complex_t refractiveIndex2(double wavelength) const = 0;
 
    //! Indicates whether the interaction with the material is scalar.
    //! This means that different polarization states will be diffracted equally
    virtual bool isScalarMaterial() const = 0;
 
    virtual bool isMagneticMaterial() const = 0;
 
    //! Returns the magnetization (in A/m)
    virtual R3 magnetization() const = 0;
 
    //! Returns underlying material data
    virtual complex_t materialData() const = 0;
 
    //! Returns type of material implementation
    virtual MATERIAL_TYPES typeID() const = 0;
 
    //! Returns (\f$ \pi/\lambda^2 \f$ - sld), sld being the scattering length density
    virtual complex_t scalarSubtrSLD(double lambda0) const = 0;
 
    //! Returns (\f$ \pi/\lambda^2 \f$ - sld) matrix with magnetization corrections
    virtual SpinMatrix polarizedSubtrSLD(const WavevectorInfo& wavevectors) const = 0;
 
    virtual BaseMaterialImpl* rotatedMaterial(const RotMatrix& transform) const = 0;
 
    //! Prints object data
    virtual std::string print() const = 0;
 
    //! Returns name of the material
    const std::string& matName() const { return m_name; }
 
private:
    const std::string m_name;
};
 
#endif // BORNAGAIN_SAMPLE_MATERIAL_BASEMATERIALIMPL_H
#endif // USER_API