BornAgain  1.18.0
Simulate and fit neutron and x-ray scattering at grazing incidence
InterferenceFunction2DSuperLattice Class Reference
Inheritance diagram for InterferenceFunction2DSuperLattice:
Collaboration diagram for InterferenceFunction2DSuperLattice:

Public Member Functions

 InterferenceFunction2DSuperLattice (const Lattice2D &lattice, unsigned size_1, unsigned size_2)
 
 InterferenceFunction2DSuperLattice (double length_1, double length_2, double alpha, double xi, unsigned size_1, unsigned size_2)
 
 ~InterferenceFunction2DSuperLattice () final
 
InterferenceFunction2DSuperLatticeclone () const override final
 
void accept (INodeVisitor *visitor) const override final
 
void setSubstructureIFF (const IInterferenceFunction &sub_iff)
 
const IInterferenceFunctionsubstructureIFF () const
 
double evaluate (const kvector_t q, double outer_iff=1.0) const override final
 
unsigned domainSize1 () const
 
unsigned domainSize2 () const
 
void setIntegrationOverXi (bool integrate_xi)
 
bool integrationOverXi () const
 
const Lattice2Dlattice () const
 
std::vector< const INode * > getChildren () const override final
 
void setPositionVariance (double var)
 
double positionVariance () const
 
virtual double getParticleDensity () const
 
virtual bool supportsMultilayer () const
 
double DWfactor (kvector_t q) const
 
virtual const Materialmaterial () const
 
std::vector< const Material * > containedMaterials () const
 
virtual void transferToCPP ()
 
virtual std::string treeToString () const
 
void registerChild (INode *node)
 
virtual void setParent (const INode *newParent)
 
const INodeparent () const
 
INodeparent ()
 
int copyNumber (const INode *node) const
 
std::string displayName () const
 
ParameterPoolcreateParameterTree () const
 
ParameterPoolparameterPool () const
 
std::string parametersToString () const
 
RealParameterregisterParameter (const std::string &name, double *parpointer)
 
void registerVector (const std::string &base_name, kvector_t *p_vec, const std::string &units="nm")
 
void setParameterValue (const std::string &name, double value)
 
void setVectorValue (const std::string &base_name, kvector_t value)
 
RealParameterparameter (const std::string &name) const
 
virtual void onChange ()
 
void removeParameter (const std::string &name)
 
void removeVector (const std::string &base_name)
 
void setName (const std::string &name)
 
const std::string & getName () const
 

Static Public Member Functions

static InterferenceFunction2DSuperLatticecreateSquare (double lattice_length, double xi, unsigned size_1, unsigned size_2)
 
static InterferenceFunction2DSuperLatticecreateHexagonal (double lattice_length, double xi, unsigned size_1, unsigned size_2)
 
static std::string XComponentName (const std::string &base_name)
 
static std::string YComponentName (const std::string &base_name)
 
static std::string ZComponentName (const std::string &base_name)
 

Protected Member Functions

double iff_no_inner (const kvector_t q, double outer_iff) const
 

Protected Attributes

double m_position_var
 
const size_t m_NP
 
std::vector< double > m_P
 

Private Member Functions

double iff_without_dw (const kvector_t q) const override final
 
void setLattice (const Lattice2D &lattice)
 
double interferenceForXi (double xi) const
 

Private Attributes

bool m_integrate_xi
 
std::unique_ptr< Lattice2DmP_lattice
 
std::unique_ptr< IInterferenceFunctionmP_substructure
 
unsigned m_size_1
 
unsigned m_size_2
 
double m_outer_iff
 
double m_qx
 
double m_qy
 
double m_xi
 
const INodem_parent {nullptr}
 
std::string m_name
 
std::unique_ptr< ParameterPoolm_pool
 

Detailed Description

Interference function of a 2D superlattice with a configurable interference function for each lattice site.

Definition at line 25 of file InterferenceFunction2DSuperLattice.h.

Constructor & Destructor Documentation

◆ InterferenceFunction2DSuperLattice() [1/2]

InterferenceFunction2DSuperLattice::InterferenceFunction2DSuperLattice ( const Lattice2D lattice,
unsigned  size_1,
unsigned  size_2 
)

Definition at line 25 of file InterferenceFunction2DSuperLattice.cpp.

28  : IInterferenceFunction(0), m_integrate_xi(false), mP_substructure(nullptr), m_size_1(size_1),
29  m_size_2(size_2)
30 {
31  setName("Interference2DSuperLattice");
34 }
IInterferenceFunction(const NodeMeta &meta, const std::vector< double > &PValues)
void setName(const std::string &name)
unsigned m_size_2
Size of the finite lattice in lattice units.
std::unique_ptr< IInterferenceFunction > mP_substructure
IFF of substructure.
void setSubstructureIFF(const IInterferenceFunction &sub_iff)
bool m_integrate_xi
Integrate over the orientation xi.
Default interference function (i.e.

References lattice(), setLattice(), IParameterized::setName(), and setSubstructureIFF().

Referenced by clone(), createHexagonal(), and createSquare().

Here is the call graph for this function:

◆ InterferenceFunction2DSuperLattice() [2/2]

InterferenceFunction2DSuperLattice::InterferenceFunction2DSuperLattice ( double  length_1,
double  length_2,
double  alpha,
double  xi,
unsigned  size_1,
unsigned  size_2 
)

Constructor of two-dimensional interference function.

Parameters
length_1length of first lattice vector in nanometers
length_2length of second lattice vector in nanometers
alphaangle between lattice vectors in radians
xirotation of lattice with respect to x-axis (beam direction) in radians
size_1correlation length in direction 1
size_2correlation length in direction 2

Definition at line 43 of file InterferenceFunction2DSuperLattice.cpp.

45  : InterferenceFunction2DSuperLattice(BasicLattice(length_1, length_2, alpha, xi), size_1,
46  size_2)
47 {
48 }
InterferenceFunction2DSuperLattice(const Lattice2D &lattice, unsigned size_1, unsigned size_2)

◆ ~InterferenceFunction2DSuperLattice()

InterferenceFunction2DSuperLattice::~InterferenceFunction2DSuperLattice ( )
finaldefault

Member Function Documentation

◆ clone()

InterferenceFunction2DSuperLattice * InterferenceFunction2DSuperLattice::clone ( ) const
finaloverridevirtual

Returns a clone of this ISample object.

Implements IInterferenceFunction.

Definition at line 52 of file InterferenceFunction2DSuperLattice.cpp.

53 {
55  ret->setPositionVariance(m_position_var);
56  ret->setSubstructureIFF(*mP_substructure);
57  ret->setIntegrationOverXi(integrationOverXi());
58  return ret;
59 }

References integrationOverXi(), InterferenceFunction2DSuperLattice(), IInterferenceFunction::m_position_var, m_size_1, m_size_2, mP_lattice, and mP_substructure.

Here is the call graph for this function:

◆ accept()

void InterferenceFunction2DSuperLattice::accept ( INodeVisitor visitor) const
inlinefinaloverridevirtual

Calls the INodeVisitor's visit method.

Implements INode.

Definition at line 35 of file InterferenceFunction2DSuperLattice.h.

35 { visitor->visit(this); }
virtual void visit(const BasicLattice *)
Definition: INodeVisitor.h:154

◆ setSubstructureIFF()

void InterferenceFunction2DSuperLattice::setSubstructureIFF ( const IInterferenceFunction sub_iff)

Definition at line 61 of file InterferenceFunction2DSuperLattice.cpp.

62 {
63  mP_substructure.reset(sub_iff.clone());
65 }
virtual IInterferenceFunction * clone() const =0
Returns a clone of this ISample object.
void registerChild(INode *node)
Definition: INode.cpp:58

References IInterferenceFunction::clone(), mP_substructure, and INode::registerChild().

Referenced by InterferenceFunction2DSuperLattice().

Here is the call graph for this function:

◆ substructureIFF()

const IInterferenceFunction & InterferenceFunction2DSuperLattice::substructureIFF ( ) const

Definition at line 67 of file InterferenceFunction2DSuperLattice.cpp.

68 {
69  return *mP_substructure;
70 }

References mP_substructure.

◆ createSquare()

InterferenceFunction2DSuperLattice * InterferenceFunction2DSuperLattice::createSquare ( double  lattice_length,
double  xi,
unsigned  size_1,
unsigned  size_2 
)
static

Creates square lattice.

Definition at line 76 of file InterferenceFunction2DSuperLattice.cpp.

78 {
79  return new InterferenceFunction2DSuperLattice(SquareLattice(lattice_length, xi), size_1,
80  size_2);
81 }

References InterferenceFunction2DSuperLattice().

Referenced by SuperLatticeBuilder::buildSample().

Here is the call graph for this function:

◆ createHexagonal()

InterferenceFunction2DSuperLattice * InterferenceFunction2DSuperLattice::createHexagonal ( double  lattice_length,
double  xi,
unsigned  size_1,
unsigned  size_2 
)
static

Creates hexagonal lattice.

Definition at line 87 of file InterferenceFunction2DSuperLattice.cpp.

89 {
90  return new InterferenceFunction2DSuperLattice(HexagonalLattice(lattice_length, xi), size_1,
91  size_2);
92 }

References InterferenceFunction2DSuperLattice().

Here is the call graph for this function:

◆ evaluate()

double InterferenceFunction2DSuperLattice::evaluate ( const kvector_t  q,
double  outer_iff = 1.0 
) const
finaloverridevirtual

Evaluates the interference function for a given wavevector transfer.

Reimplemented from IInterferenceFunction.

Definition at line 94 of file InterferenceFunction2DSuperLattice.cpp.

95 {
96  m_outer_iff = outer_iff;
97  m_qx = q.x();
98  m_qy = q.y();
99  if (!m_integrate_xi)
100  return interferenceForXi(mP_lattice->rotationAngle());
101  return RealIntegrator().integrate([&](double xi) -> double { return interferenceForXi(xi); },
102  0.0, M_TWOPI)
103  / M_TWOPI;
104 }
#define M_TWOPI
Definition: MathConstants.h:49
T y() const
Returns y-component in cartesian coordinate system.
Definition: BasicVector3D.h:66
T x() const
Returns x-component in cartesian coordinate system.
Definition: BasicVector3D.h:64
To integrate a real function of a real variable.
Definition: Integrator.h:24
double integrate(const std::function< double(double)> &f, double lmin, double lmax)
Definition: Integrator.cpp:27

References RealIntegrator::integrate(), interferenceForXi(), m_integrate_xi, m_outer_iff, m_qx, m_qy, M_TWOPI, mP_lattice, BasicVector3D< T >::x(), and BasicVector3D< T >::y().

Here is the call graph for this function:

◆ domainSize1()

unsigned InterferenceFunction2DSuperLattice::domainSize1 ( ) const
inline

Definition at line 46 of file InterferenceFunction2DSuperLattice.h.

46 { return m_size_1; }

References m_size_1.

◆ domainSize2()

unsigned InterferenceFunction2DSuperLattice::domainSize2 ( ) const
inline

Definition at line 47 of file InterferenceFunction2DSuperLattice.h.

47 { return m_size_2; }

References m_size_2.

◆ setIntegrationOverXi()

void InterferenceFunction2DSuperLattice::setIntegrationOverXi ( bool  integrate_xi)

Definition at line 106 of file InterferenceFunction2DSuperLattice.cpp.

107 {
108  m_integrate_xi = integrate_xi;
109  mP_lattice->setRotationEnabled(!m_integrate_xi); // deregister Xi in the case of integration
110 }

References m_integrate_xi, and mP_lattice.

◆ integrationOverXi()

bool InterferenceFunction2DSuperLattice::integrationOverXi ( ) const
inline

Definition at line 50 of file InterferenceFunction2DSuperLattice.h.

50 { return m_integrate_xi; }

References m_integrate_xi.

Referenced by clone().

◆ lattice()

const Lattice2D & InterferenceFunction2DSuperLattice::lattice ( ) const

Definition at line 112 of file InterferenceFunction2DSuperLattice.cpp.

113 {
114  if (!mP_lattice)
115  throw std::runtime_error("InterferenceFunctionFinite2DLattice::lattice() -> Error. "
116  "No lattice defined.");
117  return *mP_lattice;
118 }

References mP_lattice.

Referenced by InterferenceFunction2DSuperLattice(), and setLattice().

◆ getChildren()

std::vector< const INode * > InterferenceFunction2DSuperLattice::getChildren ( ) const
finaloverridevirtual

Returns a vector of children (const).

Reimplemented from INode.

Definition at line 120 of file InterferenceFunction2DSuperLattice.cpp.

121 {
122  return std::vector<const INode*>() << mP_lattice << mP_substructure;
123 }

References mP_lattice, and mP_substructure.

◆ iff_without_dw()

double InterferenceFunction2DSuperLattice::iff_without_dw ( const kvector_t  q) const
finaloverrideprivatevirtual

Calculates the structure factor without Debye-Waller factor.

Implements IInterferenceFunction.

Definition at line 125 of file InterferenceFunction2DSuperLattice.cpp.

126 {
127  using MathFunctions::Laue;
128 
129  const double a = mP_lattice->length1();
130  const double b = mP_lattice->length2();
131  const double xialpha = m_xi + mP_lattice->latticeAngle();
132 
133  const double qadiv2 = (q.x() * a * std::cos(m_xi) + q.y() * a * std::sin(m_xi)) / 2.0;
134  const double qbdiv2 = (q.x() * b * std::cos(xialpha) + q.y() * b * std::sin(xialpha)) / 2.0;
135  const double ampl = Laue(qadiv2, m_size_1) * Laue(qbdiv2, m_size_2);
136  return ampl * ampl / (m_size_1 * m_size_2);
137 }
double Laue(const double x, size_t N)
Real Laue function: .

References MathFunctions::Laue(), m_size_1, m_size_2, m_xi, mP_lattice, BasicVector3D< T >::x(), and BasicVector3D< T >::y().

Here is the call graph for this function:

◆ setLattice()

void InterferenceFunction2DSuperLattice::setLattice ( const Lattice2D lattice)
private

Definition at line 139 of file InterferenceFunction2DSuperLattice.cpp.

140 {
141  mP_lattice.reset(lattice.clone());
142  registerChild(mP_lattice.get());
143 }
virtual Lattice2D * clone() const =0

References Lattice2D::clone(), lattice(), mP_lattice, and INode::registerChild().

Referenced by InterferenceFunction2DSuperLattice().

Here is the call graph for this function:

◆ interferenceForXi()

double InterferenceFunction2DSuperLattice::interferenceForXi ( double  xi) const
private

Definition at line 145 of file InterferenceFunction2DSuperLattice.cpp.

146 {
147  m_xi = xi; // TODO ASAP don't set as collateratel effect; rm mutable
148  const kvector_t q = kvector_t(m_qx, m_qy, 0.0);
149  const double outer_iff = iff_no_inner(q, m_outer_iff);
150  const double delta_xi = xi - mP_lattice->rotationAngle();
151  return mP_substructure->evaluate(q.rotatedZ(-delta_xi), outer_iff);
152 }
BasicVector3D< double > kvector_t
Definition: Vectors3D.h:21
BasicVector3D< T > rotatedZ(double a) const
Returns result of rotation around z-axis.
double iff_no_inner(const kvector_t q, double outer_iff) const
Calculates the structure factor in the absence of extra inner structure.

References IInterferenceFunction::iff_no_inner(), m_outer_iff, m_qx, m_qy, m_xi, mP_lattice, mP_substructure, and BasicVector3D< T >::rotatedZ().

Referenced by evaluate().

Here is the call graph for this function:

◆ setPositionVariance()

void IInterferenceFunction::setPositionVariance ( double  var)
inherited

Sets the variance of the position for the calculation of the DW factor It is defined as the variance in each relevant dimension.

Definition at line 40 of file IInterferenceFunction.cpp.

41 {
42  if (var < 0.0)
43  throw std::runtime_error("IInterferenceFunction::setPositionVariance: "
44  "variance should be positive.");
45  m_position_var = var;
46 }

References IInterferenceFunction::m_position_var.

Referenced by FiniteSquareLatticeBuilder::buildSample(), and SuperLatticeBuilder::buildSample().

◆ positionVariance()

double IInterferenceFunction::positionVariance ( ) const
inlineinherited

Returns the position variance.

Definition at line 39 of file IInterferenceFunction.h.

39 { return m_position_var; }

References IInterferenceFunction::m_position_var.

Referenced by SampleToPython::defineInterferenceFunctions().

◆ getParticleDensity()

virtual double IInterferenceFunction::getParticleDensity ( ) const
inlinevirtualinherited

If defined by this interference function's parameters, returns the particle density (per area).

Otherwise, returns zero or a user-defined value

Reimplemented in InterferenceFunctionHardDisk, InterferenceFunctionFinite2DLattice, InterferenceFunction2DParaCrystal, and InterferenceFunction2DLattice.

Definition at line 43 of file IInterferenceFunction.h.

43 { return 0.0; }

◆ supportsMultilayer()

virtual bool IInterferenceFunction::supportsMultilayer ( ) const
inlinevirtualinherited

Indicates if this interference function can be used with a multilayer (DWBA mode)

Reimplemented in InterferenceFunctionFinite3DLattice, and InterferenceFunction3DLattice.

Definition at line 46 of file IInterferenceFunction.h.

46 { return true; }

Referenced by LayoutStrategyBuilder::createStrategy(), and IInterferenceFunction::DWfactor().

◆ DWfactor()

double IInterferenceFunction::DWfactor ( kvector_t  q) const
inherited

Evaluates the Debye-Waller factor for a given wavevector transfer.

Definition at line 48 of file IInterferenceFunction.cpp.

49 {
50  // remove z component for two dimensional interference functions:
51  if (supportsMultilayer())
52  q.setZ(0.0);
53  return std::exp(-q.mag2() * m_position_var);
54 }
double mag2() const
Returns magnitude squared of the vector.
void setZ(const T &a)
Sets z-component in cartesian coordinate system.
Definition: BasicVector3D.h:75
virtual bool supportsMultilayer() const
Indicates if this interference function can be used with a multilayer (DWBA mode)

References IInterferenceFunction::m_position_var, BasicVector3D< T >::mag2(), BasicVector3D< T >::setZ(), and IInterferenceFunction::supportsMultilayer().

Referenced by IInterferenceFunction::iff_no_inner().

Here is the call graph for this function:

◆ iff_no_inner()

double IInterferenceFunction::iff_no_inner ( const kvector_t  q,
double  outer_iff 
) const
protectedinherited

Calculates the structure factor in the absence of extra inner structure.

Definition at line 56 of file IInterferenceFunction.cpp.

57 {
58  return DWfactor(q) * (iff_without_dw(q) * outer_iff - 1.0) + 1.0;
59 }
double DWfactor(kvector_t q) const
Evaluates the Debye-Waller factor for a given wavevector transfer.
virtual double iff_without_dw(const kvector_t q) const =0
Calculates the structure factor without Debye-Waller factor.

References IInterferenceFunction::DWfactor(), and IInterferenceFunction::iff_without_dw().

Referenced by IInterferenceFunction::evaluate(), and interferenceForXi().

Here is the call graph for this function:

◆ material()

◆ containedMaterials()

std::vector< const Material * > ISample::containedMaterials ( ) const
inherited

Returns set of unique materials contained in this ISample.

Definition at line 23 of file ISample.cpp.

24 {
25  std::vector<const Material*> result;
26  if (const Material* p_material = material())
27  result.push_back(p_material);
28  for (auto child : getChildren()) {
29  if (const ISample* sample = dynamic_cast<const ISample*>(child)) {
30  for (const Material* p_material : sample->containedMaterials())
31  result.push_back(p_material);
32  }
33  }
34  return result;
35 }
virtual std::vector< const INode * > getChildren() const
Returns a vector of children (const).
Definition: INode.cpp:64
Pure virtual base class for sample components and properties related to scattering.
Definition: ISample.h:28
virtual const Material * material() const
Returns nullptr, unless overwritten to return a specific material.
Definition: ISample.h:37
A wrapper for underlying material implementation.
Definition: Material.h:29

References INode::getChildren(), and ISample::material().

Referenced by MultiLayerUtils::ContainsCompatibleMaterials(), anonymous_namespace{ProcessedSample.cpp}::ContainsMagneticMaterial(), and SampleToPython::initLabels().

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.

◆ treeToString()

std::string INode::treeToString ( ) const
virtualinherited

Returns multiline string representing tree structure below the node.

Definition at line 53 of file INode.cpp.

54 {
55  return NodeUtils::nodeToString(*this);
56 }
std::string nodeToString(const INode &node)
Returns multiline string representing tree structure starting from given node.
Definition: NodeUtils.cpp:67

References NodeUtils::nodeToString().

Here is the call graph for this function:

◆ registerChild()

void INode::registerChild ( INode node)
inherited

Definition at line 58 of file INode.cpp.

59 {
60  ASSERT(node);
61  node->setParent(this);
62 }
#define ASSERT(condition)
Definition: Assert.h:26
virtual void setParent(const INode *newParent)
Definition: INode.cpp:69

References ASSERT, and INode::setParent().

Referenced by ParticleLayout::addAndRegisterAbstractParticle(), ParticleCoreShell::addAndRegisterCore(), MultiLayer::addAndRegisterInterface(), MultiLayer::addAndRegisterLayer(), ParticleCoreShell::addAndRegisterShell(), Layer::addLayout(), ParticleComposition::addParticlePointer(), Beam::Beam(), Crystal::Crystal(), IDetector::IDetector(), Simulation::initialize(), MesoCrystal::initialize(), Instrument::Instrument(), Beam::operator=(), Instrument::operator=(), Particle::Particle(), ParticleDistribution::ParticleDistribution(), IParticle::rotate(), ParticleLayout::setAndRegisterInterferenceFunction(), Simulation::setBackground(), InterferenceFunction1DLattice::setDecayFunction(), InterferenceFunction2DLattice::setDecayFunction(), Instrument::setDetector(), IDetector::setDetectorResolution(), Beam::setFootprintFactor(), Particle::setFormFactor(), InterferenceFunctionFinite3DLattice::setLattice(), InterferenceFunction2DLattice::setLattice(), InterferenceFunction2DParaCrystal::setLattice(), setLattice(), InterferenceFunctionFinite2DLattice::setLattice(), InterferenceFunctionRadialParaCrystal::setProbabilityDistribution(), InterferenceFunction2DParaCrystal::setProbabilityDistributions(), ConvolutionDetectorResolution::setResolutionFunction(), IParticle::setRotation(), LayerInterface::setRoughness(), and setSubstructureIFF().

Here is the call graph for this function:

◆ setParent()

void INode::setParent ( const INode newParent)
virtualinherited

Reimplemented in SampleProvider.

Definition at line 69 of file INode.cpp.

70 {
71  m_parent = newParent;
72 }
const INode * m_parent
Definition: INode.h:81

References INode::m_parent.

Referenced by INode::registerChild(), SampleProvider::setBuilder(), and SampleProvider::setParent().

◆ parent() [1/2]

const INode * INode::parent ( ) const
inherited

◆ parent() [2/2]

INode * INode::parent ( )
inherited

Definition at line 79 of file INode.cpp.

80 {
81  return const_cast<INode*>(m_parent);
82 }
Base class for tree-like structures containing parameterized objects.
Definition: INode.h:49

References INode::m_parent.

◆ copyNumber()

int INode::copyNumber ( const INode node) const
inherited

Returns copyNumber of child, which takes into account existence of children with same name.

Definition at line 84 of file INode.cpp.

85 {
86  if (node->parent() != this)
87  return -1;
88 
89  int result(-1), count(0);
90  for (auto child : getChildren()) {
91 
92  if (child == nullptr)
93  throw std::runtime_error("INode::copyNumber() -> Error. Nullptr as child.");
94 
95  if (child == node)
96  result = count;
97 
98  if (child->getName() == node->getName())
99  ++count;
100  }
101 
102  return count > 1 ? result : -1;
103 }
const INode * parent() const
Definition: INode.cpp:74
const std::string & getName() const

References INode::getChildren(), IParameterized::getName(), and INode::parent().

Referenced by INode::displayName().

Here is the call graph for this function:

◆ displayName()

std::string INode::displayName ( ) const
inherited

Returns display name, composed from the name of node and it's copy number.

Definition at line 105 of file INode.cpp.

106 {
107  std::string result = getName();
108  if (m_parent) {
109  int index = m_parent->copyNumber(this);
110  if (index >= 0)
111  result = result + std::to_string(index);
112  }
113  return result;
114 }
int copyNumber(const INode *node) const
Returns copyNumber of child, which takes into account existence of children with same name.
Definition: INode.cpp:84

References INode::copyNumber(), IParameterized::getName(), and INode::m_parent.

Referenced by NodeUtils::nodePath(), and anonymous_namespace{NodeUtils.cpp}::nodeString().

Here is the call graph for this function:

◆ createParameterTree()

ParameterPool * INode::createParameterTree ( ) const
virtualinherited

Creates new parameter pool, with all local parameters and those of its children.

Reimplemented from IParameterized.

Definition at line 116 of file INode.cpp.

117 {
118  std::unique_ptr<ParameterPool> result(new ParameterPool);
119 
121  it.first();
122  while (!it.isDone()) {
123  const INode* child = it.getCurrent();
124  const std::string path = NodeUtils::nodePath(*child, this->parent()) + "/";
125  child->parameterPool()->copyToExternalPool(path, result.get());
126  it.next();
127  }
128 
129  return result.release();
130 }
ParameterPool * parameterPool() const
Returns pointer to the parameter pool.
Iterator through INode tree of objects.
Definition: NodeIterator.h:90
Container with parameters for IParameterized object.
Definition: ParameterPool.h:30
void copyToExternalPool(const std::string &prefix, ParameterPool *other_pool) const
Copies parameters of given pool to other pool, prepeding prefix to the parameter names.
std::string nodePath(const INode &node, const INode *root=nullptr)
Returns path composed of node's displayName, with respect to root node.
Definition: NodeUtils.cpp:82

References ParameterPool::copyToExternalPool(), NodeIterator< Strategy >::first(), NodeIterator< Strategy >::getCurrent(), NodeIterator< Strategy >::isDone(), NodeIterator< Strategy >::next(), NodeUtils::nodePath(), IParameterized::parameterPool(), and INode::parent().

Referenced by ParticleDistribution::generateParticles(), Simulation::runSimulation(), DepthProbeSimulation::validateParametrization(), OffSpecSimulation::validateParametrization(), and SpecularSimulation::validateParametrization().

Here is the call graph for this function:

◆ parameterPool()

ParameterPool* IParameterized::parameterPool ( ) const
inlineinherited

Returns pointer to the parameter pool.

Definition at line 38 of file IParameterized.h.

38 { return m_pool.get(); } // has non-const usages!
std::unique_ptr< ParameterPool > m_pool
parameter pool (kind of pointer-to-implementation)

References IParameterized::m_pool.

Referenced by pyfmt2::argumentList(), SampleBuilderNode::borrow_builder_parameters(), INode::createParameterTree(), INode::INode(), IParameterized::IParameterized(), anonymous_namespace{NodeUtils.cpp}::poolToString(), SampleBuilderNode::reset(), and IDistribution1D::setUnits().

◆ parametersToString()

std::string IParameterized::parametersToString ( ) const
inherited

Returns multiline string representing available parameters.

Definition at line 40 of file IParameterized.cpp.

41 {
42  std::ostringstream result;
43  std::unique_ptr<ParameterPool> P_pool(createParameterTree());
44  result << *P_pool << "\n";
45  return result.str();
46 }
virtual ParameterPool * createParameterTree() const
Creates new parameter pool, with all local parameters and those of its children.

References IParameterized::createParameterTree().

Here is the call graph for this function:

◆ registerParameter()

RealParameter & IParameterized::registerParameter ( const std::string &  name,
double *  parpointer 
)
inherited

Definition at line 48 of file IParameterized.cpp.

49 {
50  return m_pool->addParameter(
51  new RealParameter(name, data, getName(), [&]() -> void { onChange(); }));
52 }
virtual void onChange()
Action to be taken in inherited class when a parameter has changed.
Wraps a parameter of type double.
Definition: RealParameter.h:32

References IParameterized::getName(), IParameterized::m_pool, and IParameterized::onChange().

Referenced by BasicLattice::BasicLattice(), Beam::Beam(), CylindersInBABuilder::CylindersInBABuilder(), DetectionProperties::DetectionProperties(), HexagonalLattice::HexagonalLattice(), IInterferenceFunction::IInterferenceFunction(), INode::INode(), InterferenceFunction1DLattice::InterferenceFunction1DLattice(), InterferenceFunction2DParaCrystal::InterferenceFunction2DParaCrystal(), InterferenceFunctionHardDisk::InterferenceFunctionHardDisk(), InterferenceFunctionRadialParaCrystal::InterferenceFunctionRadialParaCrystal(), InterferenceFunctionTwin::InterferenceFunctionTwin(), Lattice2D::Lattice2D(), LayerRoughness::LayerRoughness(), MultiLayer::MultiLayer(), ParticleDistribution::ParticleDistribution(), PlainMultiLayerBySLDBuilder::PlainMultiLayerBySLDBuilder(), IParticle::registerAbundance(), ParticleLayout::registerParticleDensity(), Layer::registerThickness(), IParameterized::registerVector(), ParticleLayout::registerWeight(), ResolutionFunction2DGaussian::ResolutionFunction2DGaussian(), ResonatorBuilder::ResonatorBuilder(), Lattice2D::setRotationEnabled(), SquareLattice::SquareLattice(), and TriangularRippleBuilder::TriangularRippleBuilder().

Here is the call graph for this function:

◆ registerVector()

void IParameterized::registerVector ( const std::string &  base_name,
kvector_t p_vec,
const std::string &  units = "nm" 
)
inherited

Definition at line 54 of file IParameterized.cpp.

56 {
57  registerParameter(XComponentName(base_name), &((*p_vec)[0])).setUnit(units);
58  registerParameter(YComponentName(base_name), &((*p_vec)[1])).setUnit(units);
59  registerParameter(ZComponentName(base_name), &((*p_vec)[2])).setUnit(units);
60 }
RealParameter & registerParameter(const std::string &name, double *parpointer)
static std::string XComponentName(const std::string &base_name)
static std::string YComponentName(const std::string &base_name)
static std::string ZComponentName(const std::string &base_name)
RealParameter & setUnit(const std::string &name)

References IParameterized::registerParameter(), RealParameter::setUnit(), IParameterized::XComponentName(), IParameterized::YComponentName(), and IParameterized::ZComponentName().

Referenced by Beam::Beam(), DetectionProperties::DetectionProperties(), InterferenceFunctionTwin::InterferenceFunctionTwin(), MultiLayer::MultiLayer(), Lattice::registerBasisVectors(), and IParticle::registerPosition().

Here is the call graph for this function:

◆ setParameterValue()

void IParameterized::setParameterValue ( const std::string &  name,
double  value 
)
inherited

Definition at line 62 of file IParameterized.cpp.

63 {
64  if (name.find('*') == std::string::npos && name.find('/') == std::string::npos) {
65  m_pool->setParameterValue(name, value);
66  } else {
67  std::unique_ptr<ParameterPool> P_pool{createParameterTree()};
68  if (name.find('*') != std::string::npos)
69  P_pool->setMatchedParametersValue(name, value);
70  else
71  P_pool->setParameterValue(name, value);
72  }
73 }
int setMatchedParametersValue(const std::string &wildcards, double value)
Sets value of the nonzero parameters that match pattern ('*' allowed), or throws.

References IParameterized::createParameterTree(), IParameterized::m_pool, and ParameterPool::setMatchedParametersValue().

Referenced by AsymRippleBuilder::buildSample(), and IParameterized::setVectorValue().

Here is the call graph for this function:

◆ setVectorValue()

void IParameterized::setVectorValue ( const std::string &  base_name,
kvector_t  value 
)
inherited

Definition at line 75 of file IParameterized.cpp.

76 {
77  setParameterValue(XComponentName(base_name), value.x());
78  setParameterValue(YComponentName(base_name), value.y());
79  setParameterValue(ZComponentName(base_name), value.z());
80 }
T z() const
Returns z-component in cartesian coordinate system.
Definition: BasicVector3D.h:68
void setParameterValue(const std::string &name, double value)

References IParameterized::setParameterValue(), BasicVector3D< T >::x(), IParameterized::XComponentName(), BasicVector3D< T >::y(), IParameterized::YComponentName(), BasicVector3D< T >::z(), and IParameterized::ZComponentName().

Here is the call graph for this function:

◆ parameter()

RealParameter * IParameterized::parameter ( const std::string &  name) const
inherited

◆ onChange()

◆ removeParameter()

void IParameterized::removeParameter ( const std::string &  name)
inherited

◆ removeVector()

void IParameterized::removeVector ( const std::string &  base_name)
inherited

Definition at line 93 of file IParameterized.cpp.

94 {
95  removeParameter(XComponentName(base_name));
96  removeParameter(YComponentName(base_name));
97  removeParameter(ZComponentName(base_name));
98 }
void removeParameter(const std::string &name)

References IParameterized::removeParameter(), IParameterized::XComponentName(), IParameterized::YComponentName(), and IParameterized::ZComponentName().

Referenced by IParticle::registerPosition().

Here is the call graph for this function:

◆ XComponentName()

std::string IParameterized::XComponentName ( const std::string &  base_name)
staticinherited

◆ YComponentName()

std::string IParameterized::YComponentName ( const std::string &  base_name)
staticinherited

Definition at line 105 of file IParameterized.cpp.

106 {
107  return base_name + "Y";
108 }

Referenced by IParameterized::registerVector(), IParameterized::removeVector(), and IParameterized::setVectorValue().

◆ ZComponentName()

std::string IParameterized::ZComponentName ( const std::string &  base_name)
staticinherited

Definition at line 110 of file IParameterized.cpp.

111 {
112  return base_name + "Z";
113 }

Referenced by IParameterized::registerVector(), IParameterized::removeVector(), and IParameterized::setVectorValue().

◆ setName()

void IParameterized::setName ( const std::string &  name)
inlineinherited

Definition at line 68 of file IParameterized.h.

68 { m_name = name; }
std::string m_name

References IParameterized::m_name.

Referenced by BasicLattice::BasicLattice(), Beam::Beam(), Layer::clone(), ConvolutionDetectorResolution::ConvolutionDetectorResolution(), LayersWithAbsorptionBuilder::createSampleByIndex(), Basic2DParaCrystalBuilder::createSampleByIndex(), ParticleInVacuumBuilder::createSampleByIndex(), SimpleMagneticRotationBuilder::createSampleByIndex(), Crystal::Crystal(), DetectionProperties::DetectionProperties(), DistributionHandler::DistributionHandler(), FormFactorBAPol::FormFactorBAPol(), FormFactorCoreShell::FormFactorCoreShell(), FormFactorCrystal::FormFactorCrystal(), FormFactorDecoratorMaterial::FormFactorDecoratorMaterial(), FormFactorDecoratorPositionFactor::FormFactorDecoratorPositionFactor(), FormFactorDecoratorRotation::FormFactorDecoratorRotation(), FormFactorDWBA::FormFactorDWBA(), FormFactorDWBAPol::FormFactorDWBAPol(), FormFactorWeighted::FormFactorWeighted(), HexagonalLattice::HexagonalLattice(), IDetector::IDetector(), DepthProbeSimulation::initialize(), GISASSimulation::initialize(), OffSpecSimulation::initialize(), SpecularSimulation::initialize(), SpecularDetector1D::initialize(), MesoCrystal::initialize(), Particle::initialize(), ParticleComposition::initialize(), INode::INode(), Instrument::Instrument(), InterferenceFunction1DLattice::InterferenceFunction1DLattice(), InterferenceFunction2DLattice::InterferenceFunction2DLattice(), InterferenceFunction2DParaCrystal::InterferenceFunction2DParaCrystal(), InterferenceFunction2DSuperLattice(), InterferenceFunction3DLattice::InterferenceFunction3DLattice(), InterferenceFunctionFinite2DLattice::InterferenceFunctionFinite2DLattice(), InterferenceFunctionFinite3DLattice::InterferenceFunctionFinite3DLattice(), InterferenceFunctionHardDisk::InterferenceFunctionHardDisk(), InterferenceFunctionNone::InterferenceFunctionNone(), InterferenceFunctionRadialParaCrystal::InterferenceFunctionRadialParaCrystal(), InterferenceFunctionTwin::InterferenceFunctionTwin(), ISampleBuilder::ISampleBuilder(), IsGISAXSDetector::IsGISAXSDetector(), Lattice::Lattice(), Layer::Layer(), LayerInterface::LayerInterface(), LayerRoughness::LayerRoughness(), MultiLayer::MultiLayer(), Beam::operator=(), SampleBuilderNode::operator=(), ParticleCoreShell::ParticleCoreShell(), ParticleDistribution::ParticleDistribution(), ParticleLayout::ParticleLayout(), RectangularDetector::RectangularDetector(), SampleBuilderNode::reset(), ResolutionFunction2DGaussian::ResolutionFunction2DGaussian(), SampleBuilderNode::SampleBuilderNode(), SampleBuilderNode::setSBN(), SphericalDetector::SphericalDetector(), and SquareLattice::SquareLattice().

◆ getName()

Member Data Documentation

◆ m_integrate_xi

bool InterferenceFunction2DSuperLattice::m_integrate_xi
private

Integrate over the orientation xi.

Definition at line 62 of file InterferenceFunction2DSuperLattice.h.

Referenced by evaluate(), integrationOverXi(), and setIntegrationOverXi().

◆ mP_lattice

std::unique_ptr<Lattice2D> InterferenceFunction2DSuperLattice::mP_lattice
private

◆ mP_substructure

std::unique_ptr<IInterferenceFunction> InterferenceFunction2DSuperLattice::mP_substructure
private

IFF of substructure.

Definition at line 64 of file InterferenceFunction2DSuperLattice.h.

Referenced by clone(), getChildren(), interferenceForXi(), setSubstructureIFF(), and substructureIFF().

◆ m_size_1

unsigned InterferenceFunction2DSuperLattice::m_size_1
private

Definition at line 65 of file InterferenceFunction2DSuperLattice.h.

Referenced by clone(), domainSize1(), and iff_without_dw().

◆ m_size_2

unsigned InterferenceFunction2DSuperLattice::m_size_2
private

Size of the finite lattice in lattice units.

Definition at line 65 of file InterferenceFunction2DSuperLattice.h.

Referenced by clone(), domainSize2(), and iff_without_dw().

◆ m_outer_iff

double InterferenceFunction2DSuperLattice::m_outer_iff
mutableprivate

Definition at line 66 of file InterferenceFunction2DSuperLattice.h.

Referenced by evaluate(), and interferenceForXi().

◆ m_qx

double InterferenceFunction2DSuperLattice::m_qx
mutableprivate

Definition at line 67 of file InterferenceFunction2DSuperLattice.h.

Referenced by evaluate(), and interferenceForXi().

◆ m_qy

double InterferenceFunction2DSuperLattice::m_qy
mutableprivate

Definition at line 68 of file InterferenceFunction2DSuperLattice.h.

Referenced by evaluate(), and interferenceForXi().

◆ m_xi

double InterferenceFunction2DSuperLattice::m_xi
mutableprivate

Definition at line 69 of file InterferenceFunction2DSuperLattice.h.

Referenced by iff_without_dw(), and interferenceForXi().

◆ m_position_var

◆ m_parent

const INode* INode::m_parent {nullptr}
privateinherited

Definition at line 81 of file INode.h.

Referenced by INode::displayName(), INode::parent(), and INode::setParent().

◆ m_NP

const size_t INode::m_NP
protectedinherited

Definition at line 86 of file INode.h.

Referenced by INode::INode().

◆ m_P

std::vector<double> INode::m_P
protectedinherited

Definition at line 87 of file INode.h.

Referenced by INode::INode(), and IFootprintFactor::setWidthRatio().

◆ m_name

std::string IParameterized::m_name
privateinherited

Definition at line 72 of file IParameterized.h.

Referenced by IParameterized::getName(), and IParameterized::setName().

◆ m_pool

std::unique_ptr<ParameterPool> IParameterized::m_pool
privateinherited

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