AngularSpecScan Class Reference

Scan type with inclination angles as coordinate values and a unique wavelength. More...

Inheritance diagram for AngularSpecScan:

Collaboration diagram for AngularSpecScan:

Public Member Functions
	AngularSpecScan (double wl, const IAxis &inc_angle)
	AngularSpecScan (double wl, int nbins, double alpha_i_min, double alpha_i_max)
	Sets angle-defined specular scan. More...
	AngularSpecScan (double wl, std::vector< double > inc_angle)
	~AngularSpecScan () override
const ScanResolution *	angleResolution () const
AngularSpecScan *	clone () const override
virtual const IAxis *	coordinateAxis () const override
	Returns coordinate axis assigned to the data holder. More...
std::vector< double >	createIntensities (const std::vector< SpecularSimulationElement > &sim_elements) const override
	Returns intensity vector corresponding to convolution of given simulation elements. More...
std::vector< double >	footprint (size_t i, size_t n_elements) const override
	Returns footprint correction factor for a range of simulation elements of size n_elements and starting from element with index i. More...
virtual const IFootprintFactor *	footprintFactor () const override
	Returns IFootprintFactor object pointer. More...
std::vector< SpecularSimulationElement >	generateSimulationElements (const Instrument &instrument) const override
	Generates simulation elements for specular simulations. More...
size_t	numberOfSimulationElements () const override
	Returns the number of simulation elements. More...
void	setAbsoluteAngularResolution (const IRangedDistribution &distr, const std::vector< double > &std_dev)
	Sets angular resolution values via IRangedDistribution and values of standard deviations. More...
void	setAbsoluteAngularResolution (const IRangedDistribution &distr, double std_dev)
void	setAbsoluteWavelengthResolution (const IRangedDistribution &distr, const std::vector< double > &std_dev)
	Sets wavelength resolution values via IRangedDistribution and values of standard deviations. More...
void	setAbsoluteWavelengthResolution (const IRangedDistribution &distr, double std_dev)
void	setAngleResolution (const ScanResolution &resolution)
	Sets angle resolution values via ScanResolution object. More...
void	setFootprintFactor (const IFootprintFactor *f_factor)
	Sets footprint correction factor. More...
void	setRelativeAngularResolution (const IRangedDistribution &distr, const std::vector< double > &rel_dev)
	Sets angular resolution values via IRangedDistribution and values of relative deviations (that is, rel_dev equals standard deviation divided by the mean value). More...
void	setRelativeAngularResolution (const IRangedDistribution &distr, double rel_dev)
void	setRelativeWavelengthResolution (const IRangedDistribution &distr, const std::vector< double > &rel_dev)
	Sets wavelength resolution values via IRangedDistribution and values of relative deviations (that is, rel_dev equals standard deviation divided by the mean value). More...
void	setRelativeWavelengthResolution (const IRangedDistribution &distr, double rel_dev)
void	setWavelengthResolution (const ScanResolution &resolution)
	Sets wavelength resolution values via ScanResolution object. More...
virtual void	transferToCPP ()
	Used for Python overriding of clone (see swig/tweaks.py) More...
double	wavelength () const
const ScanResolution *	wavelengthResolution () const

Private Types
using	DistrOutput = std::vector< std::vector< ParameterSample > >

Private Member Functions
DistrOutput	applyIncResolution () const
DistrOutput	applyWlResolution () const
void	checkInitialization ()

Private Attributes
std::unique_ptr< IFootprintFactor >	m_footprint
const std::unique_ptr< IAxis >	m_inc_angle
DistrOutput	m_inc_res_cache
std::unique_ptr< ScanResolution >	m_inc_resolution
const double	m_wl
DistrOutput	m_wl_res_cache
std::unique_ptr< ScanResolution >	m_wl_resolution

Detailed Description

Scan type with inclination angles as coordinate values and a unique wavelength.

Features footprint correction.

Definition at line 27 of file AngularSpecScan.h.

Member Typedef Documentation

DistrOutput

using AngularSpecScan::DistrOutput = std::vector<std::vector<ParameterSample> >

private

Definition at line 109 of file AngularSpecScan.h.

Constructor & Destructor Documentation

AngularSpecScan() [1/3]

AngularSpecScan::AngularSpecScan	(	double	wl,
		std::vector< double >	inc_angle
	)

Definition at line 44 of file AngularSpecScan.cpp.

    : m_wl(wl)
    , m_inc_angle(std::make_unique<PointwiseAxis>("inc_angles", std::move(inc_angle)))
    , m_wl_resolution(ScanResolution::scanEmptyResolution())
    , m_inc_resolution(ScanResolution::scanEmptyResolution())
{
    checkInitialization();
}

References checkInitialization().

Referenced by clone().

Here is the call graph for this function:

AngularSpecScan() [2/3]

AngularSpecScan::AngularSpecScan	(	double	wl,
		const IAxis &	inc_angle
	)

Definition at line 53 of file AngularSpecScan.cpp.

    : m_wl(wl)
    , m_inc_angle(inc_angle.clone())
    , m_wl_resolution(ScanResolution::scanEmptyResolution())
    , m_inc_resolution(ScanResolution::scanEmptyResolution())
{
    checkInitialization();
}

References checkInitialization().

Here is the call graph for this function:

AngularSpecScan() [3/3]

AngularSpecScan::AngularSpecScan	(	double	wl,
		int	nbins,
		double	alpha_i_min,
		double	alpha_i_max
	)

Sets angle-defined specular scan.

The first parameter is always a wavelength in nm. Second parameter is either a numpy array of incident angles in radians or an IAxis object with angle values. Alternatively an axis can be defined in-place, then the second passed parameter is the number of bins, third - minimum on-axis angle value, fourth - maximum on-axis angle value.

Definition at line 62 of file AngularSpecScan.cpp.

    : m_wl(wl)
    , m_inc_angle(std::make_unique<FixedBinAxis>("inc_angles", nbins, alpha_i_min, alpha_i_max))
    , m_wl_resolution(ScanResolution::scanEmptyResolution())
    , m_inc_resolution(ScanResolution::scanEmptyResolution())
{
    checkInitialization();
}

References checkInitialization().

Here is the call graph for this function:

~AngularSpecScan()

AngularSpecScan::~AngularSpecScan ( )

overridedefault

Member Function Documentation

angleResolution()

const ScanResolution* AngularSpecScan::angleResolution ( ) const

inline

Definition at line 66 of file AngularSpecScan.h.

{ return m_inc_resolution.get(); }

References m_inc_resolution.

Referenced by TransformFromDomain::setSpecularBeamItem().

applyIncResolution()

AngularSpecScan::DistrOutput AngularSpecScan::applyIncResolution ( ) const

private

Definition at line 274 of file AngularSpecScan.cpp.

{
    if (m_inc_res_cache.empty())
        m_inc_res_cache = m_inc_resolution->generateSamples(m_inc_angle->binCenters());
    return m_inc_res_cache;
}

References m_inc_angle, m_inc_res_cache, and m_inc_resolution.

Referenced by createIntensities(), footprint(), and generateSimulationElements().

applyWlResolution()

AngularSpecScan::DistrOutput AngularSpecScan::applyWlResolution ( ) const

private

Definition at line 267 of file AngularSpecScan.cpp.

{
    if (m_wl_res_cache.empty())
        m_wl_res_cache = m_wl_resolution->generateSamples(m_wl, m_inc_angle->size());
    return m_wl_res_cache;
}

References m_inc_angle, m_wl, m_wl_res_cache, and m_wl_resolution.

Referenced by createIntensities(), and generateSimulationElements().

checkInitialization()

void AngularSpecScan::checkInitialization ( )

private

Definition at line 253 of file AngularSpecScan.cpp.

{
    if (m_wl <= 0.0)
        throw std::runtime_error(
            "Error in AngularSpecScan::checkInitialization: wavelength shell be positive");
 
    const std::vector<double> axis_values = m_inc_angle->binCenters();
    if (!std::is_sorted(axis_values.begin(), axis_values.end()))
        throw std::runtime_error("Error in AngularSpecScan::checkInitialization: q-vector values "
                                 "shall be sorted in ascending order.");
 
    // TODO: check for inclination angle limits after switching to pointwise resolution.
}

References m_inc_angle, and m_wl.

Referenced by AngularSpecScan().

clone()

AngularSpecScan * AngularSpecScan::clone ( ) const

overridevirtual

Implements ISpecularScan.

Definition at line 71 of file AngularSpecScan.cpp.

{
    auto* result = new AngularSpecScan(m_wl, *m_inc_angle);
    result->setFootprintFactor(m_footprint.get());
    result->setWavelengthResolution(*m_wl_resolution);
    result->setAngleResolution(*m_inc_resolution);
    return result;
}

References AngularSpecScan(), m_footprint, m_inc_angle, m_inc_resolution, m_wl, and m_wl_resolution.

Here is the call graph for this function:

coordinateAxis()

virtual const IAxis* AngularSpecScan::coordinateAxis ( ) const

inlineoverridevirtual

Returns coordinate axis assigned to the data holder.

Implements ISpecularScan.

Definition at line 46 of file AngularSpecScan.h.

{ return m_inc_angle.get(); }

References m_inc_angle.

createIntensities()

std::vector< double > AngularSpecScan::createIntensities ( const std::vector< SpecularSimulationElement > &  sim_elements ) const

overridevirtual

Returns intensity vector corresponding to convolution of given simulation elements.

Implements ISpecularScan.

Definition at line 229 of file AngularSpecScan.cpp.

{
    const size_t axis_size = m_inc_angle->size();
    std::vector<double> result(axis_size, 0.0);
 
    const auto wl_weights = extractValues(
        applyWlResolution(), [](const ParameterSample& sample) { return sample.weight; });
    const auto inc_weights = extractValues(
        applyIncResolution(), [](const ParameterSample& sample) { return sample.weight; });
 
    size_t elem_pos = 0;
    for (size_t i = 0; i < axis_size; ++i) {
        double& current = result[i];
        for (size_t k = 0, size_incs = inc_weights[i].size(); k < size_incs; ++k) {
            const double inc_weight = inc_weights[i][k];
            for (size_t j = 0, size_wls = wl_weights[i].size(); j < size_wls; ++j) {
                current += sim_elements[elem_pos].intensity() * inc_weight * wl_weights[i][j];
                ++elem_pos;
            }
        }
    }
    return result;
}

References applyIncResolution(), applyWlResolution(), m_inc_angle, and ParameterSample::weight.

Here is the call graph for this function:

footprint()

std::vector< double > AngularSpecScan::footprint ( size_t  i, size_t  n_elements  ) const

overridevirtual

Returns footprint correction factor for a range of simulation elements of size n_elements and starting from element with index i.

Implements ISpecularScan.

Definition at line 186 of file AngularSpecScan.cpp.

{
    if (start + n_elements > numberOfSimulationElements())
        throw std::runtime_error("Error in AngularSpecScan::footprint: given index exceeds the "
                                 "number of simulation elements");
 
    std::vector<double> result(n_elements, 1.0);
    if (!m_footprint)
        return result;
 
    const size_t n_wl_samples = m_wl_resolution->nSamples();
    const size_t n_inc_samples = m_inc_resolution->nSamples();
 
    const auto sample_values = extractValues(
        applyIncResolution(), [](const ParameterSample& sample) { return sample.value; });
 
    const size_t pos_out = start / (n_wl_samples * n_inc_samples);
    size_t pos_inc = (start - pos_out * n_wl_samples * n_inc_samples) / n_wl_samples;
    size_t pos_wl = (start - pos_inc * n_wl_samples);
    int left = static_cast<int>(n_elements);
    size_t pos_res = 0;
    for (size_t i = pos_out; left > 0; ++i)
        for (size_t k = pos_inc; k < n_inc_samples && left > 0; ++k) {
            pos_inc = 0;
            const double angle = sample_values[i][k];
            const double footprint =
                (angle >= 0 && angle <= M_PI_2) ? m_footprint->calculate(angle) : 1.0;
            for (size_t j = pos_wl; j < n_wl_samples && left > 0; ++j) {
                pos_wl = 0;
                result[pos_res] = footprint;
                ++pos_res;
                --left;
            }
        }
    return result;
}

References applyIncResolution(), m_footprint, m_inc_resolution, M_PI_2, m_wl_resolution, numberOfSimulationElements(), and ParameterSample::value.

Here is the call graph for this function:

footprintFactor()

virtual const IFootprintFactor* AngularSpecScan::footprintFactor ( ) const

inlineoverridevirtual

Returns IFootprintFactor object pointer.

Implements ISpecularScan.

Definition at line 49 of file AngularSpecScan.h.

{ return m_footprint.get(); }

References m_footprint.

generateSimulationElements()

std::vector< SpecularSimulationElement > AngularSpecScan::generateSimulationElements ( const Instrument &  instrument ) const

overridevirtual

Generates simulation elements for specular simulations.

Implements ISpecularScan.

Definition at line 83 of file AngularSpecScan.cpp.

{
    const auto wls = extractValues(applyWlResolution(),
                                   [](const ParameterSample& sample) { return sample.value; });
    const auto incs = extractValues(applyIncResolution(),
                                    [](const ParameterSample& sample) { return sample.value; });
 
    std::vector<SpecularSimulationElement> result;
    result.reserve(numberOfSimulationElements());
    for (size_t i = 0; i < m_inc_angle->size(); ++i) {
        for (size_t k = 0, size_incs = incs[i].size(); k < size_incs; ++k) {
            const double inc = incs[i][k];
            for (size_t j = 0, size_wls = wls[i].size(); j < size_wls; ++j) {
                const double wl = wls[i][j];
                result.emplace_back(SpecularSimulationElement(
                    wl, -inc, instrument, wl >= 0 && inc >= 0 && inc <= M_PI_2));
            }
        }
    }
    return result;
}

References applyIncResolution(), applyWlResolution(), m_inc_angle, M_PI_2, numberOfSimulationElements(), and ParameterSample::value.

Here is the call graph for this function:

numberOfSimulationElements()

size_t AngularSpecScan::numberOfSimulationElements ( ) const

overridevirtual

Returns the number of simulation elements.

Implements ISpecularScan.

Definition at line 223 of file AngularSpecScan.cpp.

{
    return m_inc_angle->size() * m_wl_resolution->nSamples() * m_inc_resolution->nSamples();
}

References m_inc_angle, m_inc_resolution, and m_wl_resolution.

Referenced by footprint(), and generateSimulationElements().

setAbsoluteAngularResolution() [1/2]

void AngularSpecScan::setAbsoluteAngularResolution	(	const IRangedDistribution &	distr,
		const std::vector< double > &	std_dev
	)

Sets angular resolution values via IRangedDistribution and values of standard deviations.

std_dev can be either single-valued or a numpy array. In the latter case the length of the array should coinside with the length of the inclination angle axis.

Definition at line 178 of file AngularSpecScan.cpp.

{
    std::unique_ptr<ScanResolution> resolution(
        ScanResolution::scanAbsoluteResolution(distr, std_dev));
    setAngleResolution(*resolution);
}

References ScanResolution::scanAbsoluteResolution(), and setAngleResolution().

Here is the call graph for this function:

setAbsoluteAngularResolution() [2/2]

void AngularSpecScan::setAbsoluteAngularResolution	(	const IRangedDistribution &	distr,
		double	std_dev
	)

Definition at line 171 of file AngularSpecScan.cpp.

{
    std::unique_ptr<ScanResolution> resolution(
        ScanResolution::scanAbsoluteResolution(distr, std_dev));
    setAngleResolution(*resolution);
}

References ScanResolution::scanAbsoluteResolution(), and setAngleResolution().

Here is the call graph for this function:

setAbsoluteWavelengthResolution() [1/2]

void AngularSpecScan::setAbsoluteWavelengthResolution	(	const IRangedDistribution &	distr,
		const std::vector< double > &	std_dev
	)

Sets wavelength resolution values via IRangedDistribution and values of standard deviations.

std_dev can be either single-valued or a numpy array. In the latter case the length of the array should coinside with the length of the inclination angle axis.

Definition at line 141 of file AngularSpecScan.cpp.

{
    std::unique_ptr<ScanResolution> resolution(
        ScanResolution::scanAbsoluteResolution(distr, std_dev));
    setWavelengthResolution(*resolution);
}

References ScanResolution::scanAbsoluteResolution(), and setWavelengthResolution().

Here is the call graph for this function:

setAbsoluteWavelengthResolution() [2/2]

void AngularSpecScan::setAbsoluteWavelengthResolution	(	const IRangedDistribution &	distr,
		double	std_dev
	)

Definition at line 133 of file AngularSpecScan.cpp.

{
    std::unique_ptr<ScanResolution> resolution(
        ScanResolution::scanAbsoluteResolution(distr, std_dev));
    setWavelengthResolution(*resolution);
}

References ScanResolution::scanAbsoluteResolution(), and setWavelengthResolution().

Here is the call graph for this function:

setAngleResolution()

void AngularSpecScan::setAngleResolution

(

const ScanResolution &

resolution

)

Sets angle resolution values via ScanResolution object.

Definition at line 149 of file AngularSpecScan.cpp.

{
    m_inc_resolution.reset(resolution.clone());
    m_inc_res_cache.clear();
    m_inc_res_cache.shrink_to_fit();
}

References ScanResolution::clone(), m_inc_res_cache, and m_inc_resolution.

Referenced by TransformToDomain::addBeamDivergencesToScan(), setAbsoluteAngularResolution(), setRelativeAngularResolution(), and StandardSimulations::SpecularDivergentBeam().

Here is the call graph for this function:

setFootprintFactor()

void AngularSpecScan::setFootprintFactor

(

const IFootprintFactor *

f_factor

)

Sets footprint correction factor.

Definition at line 105 of file AngularSpecScan.cpp.

{
    m_footprint.reset(f_factor ? f_factor->clone() : nullptr);
}

References IFootprintFactor::clone(), and m_footprint.

Referenced by StandardSimulations::SpecularWithGaussianBeam(), and StandardSimulations::SpecularWithSquareBeam().

Here is the call graph for this function:

setRelativeAngularResolution() [1/2]

void AngularSpecScan::setRelativeAngularResolution	(	const IRangedDistribution &	distr,
		const std::vector< double > &	rel_dev
	)

Sets angular resolution values via IRangedDistribution and values of relative deviations (that is, rel_dev equals standard deviation divided by the mean value).

rel_dev can be either single-valued or a numpy array. In the latter case the length of the array should coinside with the length of the inclination angle axis.

Definition at line 163 of file AngularSpecScan.cpp.

{
    std::unique_ptr<ScanResolution> resolution(
        ScanResolution::scanRelativeResolution(distr, rel_dev));
    setAngleResolution(*resolution);
}

References ScanResolution::scanRelativeResolution(), and setAngleResolution().

Here is the call graph for this function:

setRelativeAngularResolution() [2/2]

void AngularSpecScan::setRelativeAngularResolution	(	const IRangedDistribution &	distr,
		double	rel_dev
	)

Definition at line 156 of file AngularSpecScan.cpp.

{
    std::unique_ptr<ScanResolution> resolution(
        ScanResolution::scanRelativeResolution(distr, rel_dev));
    setAngleResolution(*resolution);
}

References ScanResolution::scanRelativeResolution(), and setAngleResolution().

Here is the call graph for this function:

setRelativeWavelengthResolution() [1/2]

void AngularSpecScan::setRelativeWavelengthResolution	(	const IRangedDistribution &	distr,
		const std::vector< double > &	rel_dev
	)

Sets wavelength resolution values via IRangedDistribution and values of relative deviations (that is, rel_dev equals standard deviation divided by the mean value).

rel_dev can be either single-valued or a numpy array. In the latter case the length of the array should coinside with the length of the inclination angle axis.

Definition at line 125 of file AngularSpecScan.cpp.

{
    std::unique_ptr<ScanResolution> resolution(
        ScanResolution::scanRelativeResolution(distr, rel_dev));
    setWavelengthResolution(*resolution);
}

References ScanResolution::scanRelativeResolution(), and setWavelengthResolution().

Here is the call graph for this function:

setRelativeWavelengthResolution() [2/2]

void AngularSpecScan::setRelativeWavelengthResolution	(	const IRangedDistribution &	distr,
		double	rel_dev
	)

Definition at line 117 of file AngularSpecScan.cpp.

{
    std::unique_ptr<ScanResolution> resolution(
        ScanResolution::scanRelativeResolution(distr, rel_dev));
    setWavelengthResolution(*resolution);
}

References ScanResolution::scanRelativeResolution(), and setWavelengthResolution().

Here is the call graph for this function:

setWavelengthResolution()

void AngularSpecScan::setWavelengthResolution

(

const ScanResolution &

resolution

)

Sets wavelength resolution values via ScanResolution object.

Definition at line 110 of file AngularSpecScan.cpp.

{
    m_wl_resolution.reset(resolution.clone());
    m_wl_res_cache.clear();
    m_wl_res_cache.shrink_to_fit();
}

References ScanResolution::clone(), m_wl_res_cache, and m_wl_resolution.

Referenced by TransformToDomain::addBeamDivergencesToScan(), setAbsoluteWavelengthResolution(), setRelativeWavelengthResolution(), and StandardSimulations::SpecularDivergentBeam().

Here is the call graph for this function:

transferToCPP()

virtual void ICloneable::transferToCPP ( )

inlinevirtualinherited

Used for Python overriding of clone (see swig/tweaks.py)

Definition at line 34 of file ICloneable.h.

wavelength()

double AngularSpecScan::wavelength ( ) const

inline

Definition at line 62 of file AngularSpecScan.h.

{ return m_wl; }

References m_wl.

Referenced by TransformFromDomain::setSpecularBeamItem().

wavelengthResolution()

const ScanResolution* AngularSpecScan::wavelengthResolution ( ) const

inline

Definition at line 65 of file AngularSpecScan.h.

{ return m_wl_resolution.get(); }

References m_wl_resolution.

Referenced by TransformFromDomain::setSpecularBeamItem().

Member Data Documentation

m_footprint

std::unique_ptr<IFootprintFactor> AngularSpecScan::m_footprint

private

Definition at line 117 of file AngularSpecScan.h.

Referenced by clone(), footprint(), footprintFactor(), and setFootprintFactor().

m_inc_angle

const std::unique_ptr<IAxis> AngularSpecScan::m_inc_angle

private

Definition at line 116 of file AngularSpecScan.h.

Referenced by applyIncResolution(), applyWlResolution(), checkInitialization(), clone(), coordinateAxis(), createIntensities(), generateSimulationElements(), and numberOfSimulationElements().

m_inc_res_cache

DistrOutput AngularSpecScan::m_inc_res_cache

mutableprivate

Definition at line 123 of file AngularSpecScan.h.

Referenced by applyIncResolution(), and setAngleResolution().

m_inc_resolution

std::unique_ptr<ScanResolution> AngularSpecScan::m_inc_resolution

private

Definition at line 122 of file AngularSpecScan.h.

Referenced by angleResolution(), applyIncResolution(), clone(), footprint(), numberOfSimulationElements(), and setAngleResolution().

m_wl

const double AngularSpecScan::m_wl

private

Definition at line 115 of file AngularSpecScan.h.

Referenced by applyWlResolution(), checkInitialization(), clone(), and wavelength().

m_wl_res_cache

DistrOutput AngularSpecScan::m_wl_res_cache

mutableprivate

Definition at line 120 of file AngularSpecScan.h.

Referenced by applyWlResolution(), and setWavelengthResolution().

m_wl_resolution

std::unique_ptr<ScanResolution> AngularSpecScan::m_wl_resolution

private

Definition at line 119 of file AngularSpecScan.h.

Referenced by applyWlResolution(), clone(), footprint(), numberOfSimulationElements(), setWavelengthResolution(), and wavelengthResolution().

---

The documentation for this class was generated from the following files:

• /home/www/ba/Core/Scan/AngularSpecScan.h
• /home/www/ba/Core/Scan/AngularSpecScan.cpp