File: OffspecDetector.h

package info (click to toggle)
bornagain 23.0-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 103,948 kB
  • sloc: cpp: 423,131; python: 40,997; javascript: 11,167; awk: 630; sh: 318; ruby: 173; xml: 130; makefile: 51; ansic: 24
file content (84 lines) | stat: -rw-r--r-- 3,201 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
//  ************************************************************************************************
//
//  BornAgain: simulate and fit reflection and scattering
//
//! @file      Device/Detector/OffspecDetector.h
//! @brief     Defines class OffspecDetector.
//!
//! @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)
//
//  ************************************************************************************************

#ifndef BORNAGAIN_DEVICE_DETECTOR_OFFSPECDETECTOR_H
#define BORNAGAIN_DEVICE_DETECTOR_OFFSPECDETECTOR_H

#include "Base/Axis/Scale.h"
#include "Base/Type/CloneableVector.h"
#include "Device/Pol/PolFilter.h"
#include "Param/Node/INode.h"

class IDetectorResolution;
class Pixel;

//! A detector with coordinate axes along angles phi and alpha.

class OffspecDetector : /*public ICloneable,*/ public INode {
public:
    //! Returns a detector with given phi and alpha axes.
    //! @param n_phi number of phi-axis bins
    //! @param phi_min low edge of first phi-bin
    //! @param phi_max upper edge of last phi-bin
    //! @param n_alpha number of alpha-axis bins
    //! @param alpha_min low edge of first alpha-bin
    //! @param alpha_max upper edge of last alpha-bin
    OffspecDetector(size_t n_phi, double phi_min, double phi_max, size_t n_alpha, double alpha_min,
                    double alpha_max);

    OffspecDetector(const OffspecDetector& other);
    ~OffspecDetector() override = default;

#ifndef SWIG
    OffspecDetector* clone() const /* override */;
#endif // SWIG

    std::string className() const override { return "OffspecDetector"; }

    //! Sets the polarization analyzer characteristics of the detector
    void setAnalyzer(const R3& Bloch_vector = {}, double mean_transmission = 0.5);

    //! One axis of the complete detector.
    //! Any region of interest is not taken into account.
    const Scale& axis(size_t index) const;

    //! Calculate axis index for given global index
    size_t axisBinIndex(size_t index, size_t k_axis) const;

    //! Returns total number of pixels.
    //! Any region of interest is not taken into account.
    size_t totalSize() const;

    //! Creates an Pixel for the given Datafield object and index
    Pixel* createPixel(size_t index) const;

    //! Returns index of pixel that contains the specular wavevector.
    //! If no pixel contains this specular wavevector, the number of pixels is
    //! returned. This corresponds to an overflow index.
    size_t indexOfSpecular(double alpha, double phi) const;

    //! Returns detection properties
    const PolFilter& analyzer() const { return m_pol_analyzer; }

private:
    //! Returns flattened index computed from two axis indices.
    size_t getGlobalIndex(size_t x, size_t y) const;

    const CloneableVector<const Scale> m_axes;
    PolFilter m_pol_analyzer;
    // TODO now unused, restore https://jugit.fz-juelich.de/mlz/bornagain/-/issues/1113
    // std::unique_ptr<IDetectorResolution> m_resolution;
};

#endif // BORNAGAIN_DEVICE_DETECTOR_OFFSPECDETECTOR_H