Description

A particle with a crystalline inner structure, made of smaller particles, and an outer shape described by a particle form factor.

Definition at line 27 of file MesoCrystal.h.

Inheritance diagram for MesoCrystal:

[legend]

Collaboration diagram for MesoCrystal:

[legend]

Public Member Functions
	MesoCrystal (const Crystal &crystal, const IFormFactor &formfactor)

	~MesoCrystal () override

double	abundance () const

void	checkNodeArgs () const
	Raises exception if a parameter value is invalid. More...

std::string	className () const final
	Returns the class name, to be hard-coded in each leaf class that inherits from INode. More...

MesoCrystal *	clone () const override
	Returns a clone of this ISampleNode object. More...

std::vector< const Material * >	containedMaterials () const
	Returns set of unique materials contained in this ISampleNode. More...

virtual std::vector< std::unique_ptr< IParticle > >	decompose () const
	Decompose in constituent IParticle objects. More...

bool	isMagnetic () const
	Returns true if there is any magnetic material in this ISampleNode. More...

virtual const Material *	material () const
	Returns nullptr, unless overwritten to return a specific material. More...

std::vector< const INode * >	nodeChildren () const override
	Returns all children. More...

std::vector< const INode * >	nodeOffspring () const
	Returns all descendants. More...

const IFormFactor *	outerShape () const

virtual std::vector< ParaMeta >	parDefs () const
	Returns the parameter definitions, to be hard-coded in each leaf class. More...

R3	particlePosition () const
	Returns particle position. More...

const Crystal &	particleStructure () const

IParticle *	rotate (const IRotation &rotation)
	Rotates the particle, and returns this. More...

const IRotation *	rotation () const
	Returns rotation object. More...

void	setAbundance (double abundance)
	Sets particle abundance. More...

void	setParticlePosition (double x, double y, double z)
	Sets relative position of the particle's reference point in the coordinate system of parent. More...

void	setParticlePosition (R3 position)
	Sets relative position of the particle's reference point in the coordinate system of parent. More...

void	setRotation (const IRotation &rotation)
	Sets transformation. More...

virtual void	transferToCPP ()
	Used for Python overriding of clone (see swig/tweaks.py) More...

IParticle *	translate (R3 translation)
	Translates the particle, and returns this. More...

Protected Attributes
double	m_abundance {1.0}

std::vector< double >	m_P

R3	m_position

std::unique_ptr< IRotation >	m_rotation

Private Member Functions
	MesoCrystal (Crystal crystal, IFormFactor formfactor)

Private Attributes
const std::unique_ptr< Crystal >	m_crystal
	Crystalline inner structure. More...

const std::unique_ptr< IFormFactor >	m_meso_formfactor
	Outer shape of the mesocrystal. More...

Constructor & Destructor Documentation

◆ MesoCrystal() [1/2]

MesoCrystal::MesoCrystal	(	const Crystal &	crystal,
		const IFormFactor &	formfactor
	)

Definition at line 27 of file MesoCrystal.cpp.

     : MesoCrystal(crystal.clone(), formfactor.clone())
 {
 }

Referenced by clone().

◆ ~MesoCrystal()

MesoCrystal::~MesoCrystal ( )

overridedefault

◆ MesoCrystal() [2/2]

MesoCrystal::MesoCrystal	(	Crystal *	crystal,
		IFormFactor *	formfactor
	)

private

Definition at line 21 of file MesoCrystal.cpp.

     : m_crystal(crystal)
     , m_meso_formfactor(formfactor)
 {
 }

Member Function Documentation

◆ abundance()

double IParticle::abundance ( ) const

inlineinherited

Definition at line 38 of file IParticle.h.

38 { return m_abundance; }

IParticle::m_abundance

double m_abundance

Definition: IParticle.h:78

References IParticle::m_abundance.

Referenced by SampleToPython::defineParticleLayouts(), and IParticle::setAbundance().

◆ checkNodeArgs()

void INode::checkNodeArgs ( ) const

inherited

Raises exception if a parameter value is invalid.

Definition at line 27 of file INode.cpp.

 {
     size_t nP = m_P.size();
     if (parDefs().size() != nP) {
         std::cerr << "BUG in class " << className() << std::endl;
         std::cerr << "#m_P = " << nP << std::endl;
         std::cerr << "#PDf = " << parDefs().size() << std::endl;
         for (const ParaMeta& pm : parDefs())
             std::cerr << "  PDf: " << pm.name << std::endl;
         ASSERT(0);
     }
     ASSERT(parDefs().size() == nP);
     for (size_t i = 0; i < nP; ++i) {
         const ParaMeta pm = parDefs()[i];
  
         RealLimits limits = RealLimits::limitless();
         if (pm.vMin == -INF) {
             ASSERT(pm.vMax == +INF);
             // nothing to do
         } else if (pm.vMax == +INF) {
             ASSERT(pm.vMin == 0);
             limits = RealLimits::nonnegative();
         } else {
             limits = RealLimits::limited(pm.vMin, pm.vMax);
         }
         limits.check(pm.name, m_P[i]);
     }
 }

References ASSERT, RealLimits::check(), INode::className(), INF, RealLimits::limited(), RealLimits::limitless(), INode::m_P, ParaMeta::name, RealLimits::nonnegative(), INode::parDefs(), ParaMeta::vMax, and ParaMeta::vMin.

Referenced by BarGauss::BarGauss(), BarLorentz::BarLorentz(), Bipyramid4::Bipyramid4(), Box::Box(), CantellatedCube::CantellatedCube(), Cone::Cone(), ConstantBackground::ConstantBackground(), CosineRippleBox::CosineRippleBox(), CosineRippleGauss::CosineRippleGauss(), CosineRippleLorentz::CosineRippleLorentz(), Cylinder::Cylinder(), DistributionCosine::DistributionCosine(), DistributionGate::DistributionGate(), DistributionGaussian::DistributionGaussian(), DistributionLogNormal::DistributionLogNormal(), DistributionLorentz::DistributionLorentz(), DistributionTrapezoid::DistributionTrapezoid(), Dodecahedron::Dodecahedron(), EllipsoidalCylinder::EllipsoidalCylinder(), FootprintGauss::FootprintGauss(), FootprintSquare::FootprintSquare(), FuzzySphere::FuzzySphere(), GaussSphere::GaussSphere(), HemiEllipsoid::HemiEllipsoid(), HollowSphere::HollowSphere(), HorizontalCylinder::HorizontalCylinder(), Icosahedron::Icosahedron(), LongBoxGauss::LongBoxGauss(), LongBoxLorentz::LongBoxLorentz(), PlatonicOctahedron::PlatonicOctahedron(), PlatonicTetrahedron::PlatonicTetrahedron(), Prism3::Prism3(), Prism6::Prism6(), Profile1DCauchy::Profile1DCauchy(), Profile1DCosine::Profile1DCosine(), Profile1DGate::Profile1DGate(), Profile1DGauss::Profile1DGauss(), Profile1DTriangle::Profile1DTriangle(), Profile1DVoigt::Profile1DVoigt(), Profile2DCauchy::Profile2DCauchy(), Profile2DCone::Profile2DCone(), Profile2DGate::Profile2DGate(), Profile2DGauss::Profile2DGauss(), Profile2DVoigt::Profile2DVoigt(), Pyramid2::Pyramid2(), Pyramid3::Pyramid3(), Pyramid4::Pyramid4(), Pyramid6::Pyramid6(), RotationEuler::RotationEuler(), RotationX::RotationX(), RotationY::RotationY(), RotationZ::RotationZ(), SawtoothRippleBox::SawtoothRippleBox(), SawtoothRippleGauss::SawtoothRippleGauss(), SawtoothRippleLorentz::SawtoothRippleLorentz(), Sphere::Sphere(), Spheroid::Spheroid(), TruncatedCube::TruncatedCube(), TruncatedSphere::TruncatedSphere(), and TruncatedSpheroid::TruncatedSpheroid().

Here is the call graph for this function:

◆ className()

std::string MesoCrystal::className ( ) const

inlinefinalvirtual

Returns the class name, to be hard-coded in each leaf class that inherits from INode.

Implements INode.

Definition at line 34 of file MesoCrystal.h.

34 { return "MesoCrystal"; }

◆ clone()

MesoCrystal * MesoCrystal::clone ( ) const

overridevirtual

Returns a clone of this ISampleNode object.

Implements IParticle.

Definition at line 34 of file MesoCrystal.cpp.

 {
     auto* result = new MesoCrystal(m_crystal->clone(), m_meso_formfactor->clone());
     result->setAbundance(m_abundance);
     if (m_rotation)
         result->setRotation(*m_rotation);
     result->setParticlePosition(m_position);
     return result;
 }

References MesoCrystal(), IParticle::m_abundance, m_crystal, m_meso_formfactor, IParticle::m_position, and IParticle::m_rotation.

Here is the call graph for this function:

◆ containedMaterials()

std::vector< const Material * > ISampleNode::containedMaterials ( ) const

inherited

Returns set of unique materials contained in this ISampleNode.

Definition at line 25 of file ISampleNode.cpp.

 {
     std::vector<const Material*> result;
     if (const Material* p_material = material())
         result.push_back(p_material);
     for (const auto* child : nodeChildren()) {
         if (const auto* sample = dynamic_cast<const ISampleNode*>(child)) {
             for (const Material* p_material : sample->containedMaterials())
                 result.push_back(p_material);
         }
     }
     return result;
 }

References ISampleNode::material(), and INode::nodeChildren().

Referenced by SampleUtils::Multilayer::ContainsCompatibleMaterials(), SampleToPython::initLabels(), and ISampleNode::isMagnetic().

Here is the call graph for this function:

◆ decompose()

std::vector< std::unique_ptr< IParticle > > IParticle::decompose ( ) const

virtualinherited

Decompose in constituent IParticle objects.

Reimplemented in ParticleComposition.

Definition at line 52 of file IParticle.cpp.

 {
     std::vector<std::unique_ptr<IParticle>> result;
     result.emplace_back(this->clone());
     return result;
 }

References IParticle::clone().

Referenced by Compute::Slicing::createParticleInSlice().

Here is the call graph for this function:

◆ isMagnetic()

bool ISampleNode::isMagnetic ( ) const

inherited

Returns true if there is any magnetic material in this ISampleNode.

Definition at line 39 of file ISampleNode.cpp.

 {
     const auto materials = containedMaterials();
     return std::any_of(materials.cbegin(), materials.cend(),
                        [](const Material* mat) { return mat->isMagneticMaterial(); });
 }

References ISampleNode::containedMaterials().

Referenced by reSample::make().

Here is the call graph for this function:

◆ material()

virtual const Material* ISampleNode::material ( ) const

inlinevirtualinherited

Returns nullptr, unless overwritten to return a specific material.

Reimplemented in Particle, and Layer.

Definition at line 36 of file ISampleNode.h.

36 { return nullptr; }

Referenced by ISampleNode::containedMaterials().

◆ nodeChildren()

std::vector< const INode * > MesoCrystal::nodeChildren ( ) const

overridevirtual

Returns all children.

Reimplemented from IParticle.

Definition at line 44 of file MesoCrystal.cpp.

 {
     return std::vector<const INode*>()
            << IParticle::nodeChildren() << m_crystal << m_meso_formfactor;
 }

References m_crystal, m_meso_formfactor, and IParticle::nodeChildren().

Here is the call graph for this function:

◆ nodeOffspring()

std::vector< const INode * > INode::nodeOffspring ( ) const

inherited

Returns all descendants.

Definition at line 61 of file INode.cpp.

 {
     std::vector<const INode*> result;
     result.push_back(this);
     for (const auto* child : nodeChildren()) {
         for (const auto* p : child->nodeOffspring())
             result.push_back(p);
     }
     return result;
 }

References INode::nodeChildren().

Here is the call graph for this function:

◆ outerShape()

const IFormFactor* MesoCrystal::outerShape ( ) const

inline

Definition at line 37 of file MesoCrystal.h.

37 { return m_meso_formfactor.get(); }

References m_meso_formfactor.

◆ parDefs()

virtual std::vector<ParaMeta> INode::parDefs ( ) const

inlinevirtualinherited

Returns the parameter definitions, to be hard-coded in each leaf class.

Reimplemented in ConstantBackground, GaussSphere, FuzzySphere, RotationEuler, RotationZ, RotationY, RotationX, Crystal, Layer, HexagonalLattice2D, SquareLattice2D, BasicLattice2D, LayerRoughness, TruncatedSpheroid, TruncatedSphere, TruncatedCube, Spheroid, Sphere, SawtoothRippleLorentz, SawtoothRippleGauss, SawtoothRippleBox, Pyramid6, Pyramid4, Pyramid3, Pyramid2, Prism6, Prism3, PlatonicTetrahedron, PlatonicOctahedron, LongBoxLorentz, LongBoxGauss, Icosahedron, HorizontalCylinder, HollowSphere, HemiEllipsoid, EllipsoidalCylinder, Dodecahedron, Cylinder, CosineRippleLorentz, CosineRippleGauss, CosineRippleBox, Cone, CantellatedCube, Box, Bipyramid4, BarLorentz, BarGauss, Profile2DVoigt, Profile2DCone, Profile2DGate, Profile2DGauss, Profile2DCauchy, Profile1DVoigt, Profile1DCosine, Profile1DTriangle, Profile1DGate, Profile1DGauss, Profile1DCauchy, MisesGaussPeakShape, MisesFisherGaussPeakShape, LorentzFisherPeakShape, GaussFisherPeakShape, IsotropicLorentzPeakShape, IsotropicGaussPeakShape, ParticleLayout, InterferenceTwin, InterferenceRadialParaCrystal, InterferenceHardDisk, Interference2DSuperLattice, Interference2DParaCrystal, Interference1DLattice, DistributionTrapezoid, DistributionCosine, DistributionLogNormal, DistributionGaussian, DistributionLorentz, DistributionGate, ResolutionFunction2DGaussian, PolFilter, FootprintSquare, and FootprintGauss.

Definition at line 51 of file INode.h.

51 { return {}; }

Referenced by INode::checkNodeArgs(), and IFormFactor::pythonConstructor().

◆ particlePosition()

R3 IParticle::particlePosition ( ) const

inlineinherited

Returns particle position.

Definition at line 46 of file IParticle.h.

46 { return m_position; }

References IParticle::m_position.

Referenced by ParticleComposition::decompose().

◆ particleStructure()

const Crystal & MesoCrystal::particleStructure ( ) const

Definition at line 50 of file MesoCrystal.cpp.

 {
     ASSERT(m_crystal);
     return *m_crystal;
 }

References ASSERT, and m_crystal.

◆ rotate()

IParticle * IParticle::rotate ( const IRotation & rotation )

inherited

Rotates the particle, and returns this.

Definition at line 41 of file IParticle.cpp.

 {
     if (m_rotation)
         m_rotation.reset(createProduct(rotation, *m_rotation));
     else
         m_rotation.reset(rotation.clone());
     m_position = rotation.transformed(m_position);
     return this;
 }

References IRotation::clone(), createProduct(), IParticle::m_position, IParticle::m_rotation, IParticle::rotation(), and IRotation::transformed().

Referenced by ExemplarySamples::createBoxCompositionRotateZandY(), ExemplarySamples::createCoreShellBoxRotateZandY(), ExemplarySamples::createLayersWithAbsorptionBySLD(), ExemplarySamples::createLayersWithAbsorptionWithFF(), ExemplarySamples::createMagneticRotation(), ExemplarySamples::createRotatedPyramids(), ExemplarySamples::createTransformBox(), and ParticleComposition::decompose().

Here is the call graph for this function:

◆ rotation()

const IRotation * IParticle::rotation ( ) const

inherited

Returns rotation object.

Definition at line 31 of file IParticle.cpp.

 {
     return m_rotation.get();
 }

References IParticle::m_rotation.

Referenced by Particle::Particle(), ParticleComposition::decompose(), IParticle::rotate(), and IParticle::setRotation().

◆ setAbundance()

void IParticle::setAbundance ( double abundance )

inlineinherited

Sets particle abundance.

Parameters

abundance proportion of this type of particles normalized to the total number of particles in the layout.

Definition at line 43 of file IParticle.h.

43 { m_abundance = abundance; }

IParticle::abundance

double abundance() const

Definition: IParticle.h:38

References IParticle::abundance(), and IParticle::m_abundance.

Referenced by ParticleLayout::addParticle().

Here is the call graph for this function:

◆ setParticlePosition() [1/2]

void IParticle::setParticlePosition	(	double	x,
		double	y,
		double	z
	)

inlineinherited

Sets relative position of the particle's reference point in the coordinate system of parent.

Parameters

x	x-coordinate in nanometers
y	y-coordinate in nanometers
z	z-coordinate in nanometers

Definition at line 58 of file IParticle.h.

58 { m_position = R3(x, y, z); }

References IParticle::m_position.

◆ setParticlePosition() [2/2]

void IParticle::setParticlePosition ( R3 position )

inlineinherited

Sets relative position of the particle's reference point in the coordinate system of parent.

Parameters

position relative position vector (components are in nanometers)

Definition at line 51 of file IParticle.h.

51 { m_position = position; }

References IParticle::m_position.

◆ setRotation()

void IParticle::setRotation ( const IRotation & rotation )

inherited

Sets transformation.

Definition at line 36 of file IParticle.cpp.

 {
     m_rotation.reset(rotation.clone());
 }

References IRotation::clone(), IParticle::m_rotation, and IParticle::rotation().

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 32 of file ICloneable.h.

◆ translate()

IParticle * IParticle::translate ( R3 translation )

inherited

Translates the particle, and returns this.

Definition at line 25 of file IParticle.cpp.

 {
     m_position += translation;
     return this;
 }

References IParticle::m_position.

Referenced by ParticleComposition::addParticle(), ExemplarySamples::createMagneticRotation(), ExemplarySamples::createMagneticSpheres(), ExemplarySamples::createMagneticSubstrateZeroField(), ExemplarySamples::createSuperLattice(), and ParticleComposition::decompose().

Member Data Documentation

◆ m_abundance

double IParticle::m_abundance {1.0}

protectedinherited

Definition at line 78 of file IParticle.h.

Referenced by IParticle::abundance(), clone(), Particle::clone(), ParticleComposition::clone(), ParticleCoreShell::clone(), and IParticle::setAbundance().

◆ m_crystal

const std::unique_ptr<Crystal> MesoCrystal::m_crystal

private

Crystalline inner structure.

Definition at line 43 of file MesoCrystal.h.

Referenced by clone(), nodeChildren(), and particleStructure().

◆ m_meso_formfactor

const std::unique_ptr<IFormFactor> MesoCrystal::m_meso_formfactor

private

Outer shape of the mesocrystal.

Definition at line 44 of file MesoCrystal.h.

Referenced by clone(), nodeChildren(), and outerShape().

◆ m_P

std::vector<double> INode::m_P

protectedinherited

Definition at line 63 of file INode.h.

Referenced by IFootprintFactor::IFootprintFactor(), INode::checkNodeArgs(), IProfile1D::pythonConstructor(), IProfile2D::pythonConstructor(), IFormFactor::pythonConstructor(), Profile1DVoigt::pythonConstructor(), and Profile2DVoigt::pythonConstructor().

◆ m_position

R3 IParticle::m_position

protectedinherited

Definition at line 79 of file IParticle.h.

Referenced by clone(), Particle::clone(), ParticleComposition::clone(), ParticleCoreShell::clone(), IParticle::particlePosition(), IParticle::rotate(), IParticle::setParticlePosition(), and IParticle::translate().

◆ m_rotation

std::unique_ptr<IRotation> IParticle::m_rotation

protectedinherited

Definition at line 80 of file IParticle.h.

Referenced by clone(), Particle::clone(), ParticleComposition::clone(), ParticleCoreShell::clone(), IParticle::nodeChildren(), IParticle::rotate(), IParticle::rotation(), and IParticle::setRotation().

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

/home/build/builds/o5h8MZZm/0/mlz/bornagain/Sample/Particle/MesoCrystal.h
/home/build/builds/o5h8MZZm/0/mlz/bornagain/Sample/Particle/MesoCrystal.cpp

Description

Public Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Constructor & Destructor Documentation

◆ MesoCrystal() [1/2]

◆ ~MesoCrystal()

◆ MesoCrystal() [2/2]

Member Function Documentation

◆ abundance()

◆ checkNodeArgs()

◆ className()

◆ clone()

◆ containedMaterials()

◆ decompose()

◆ isMagnetic()

◆ material()

◆ nodeChildren()

◆ nodeOffspring()

◆ outerShape()

◆ parDefs()

◆ particlePosition()

◆ particleStructure()

◆ rotate()

◆ rotation()

◆ setAbundance()

◆ setParticlePosition() [1/2]

◆ setParticlePosition() [2/2]

◆ setRotation()

◆ transferToCPP()

◆ translate()

Member Data Documentation

◆ m_abundance

◆ m_crystal

◆ m_meso_formfactor

◆ m_P

◆ m_position

◆ m_rotation