ISimulation2D Class Reference

Abstract base class of OffSpecularSimulation and GISASSimulation. More...

Inheritance diagram for ISimulation2D:

Collaboration diagram for ISimulation2D:

Public Member Functions
	ISimulation2D ()
	ISimulation2D (const Beam &beam, const IDetector &detector)
	ISimulation2D (const Beam &beam, const MultiLayer &sample, const IDetector &detector)
	~ISimulation2D () override
virtual void	accept (INodeVisitor *visitor) const =0
	Calls the INodeVisitor's visit method. More...
void	addMask (const IShape2D &shape, bool mask_value=true)
	Adds mask of given shape to the stack of detector masks. More...
void	addParameterDistribution (const ParameterDistribution &par_distr)
void	addParameterDistribution (const std::string &param_name, const IDistribution1D &distribution, size_t nbr_samples, double sigma_factor=0.0, const RealLimits &limits=RealLimits())
const IBackground *	background () const
Beam &	beam ()
const Beam &	beam () const
ISimulation2D *	clone () const override=0
SimulationResult	convertData (const OutputData< double > &data, bool put_masked_areas_to_zero=true)
	Convert user data to SimulationResult object for later drawing in various axes units. More...
int	copyNumber (const INode *node) const
	Returns copyNumber of child, which takes into account existence of children with same name. More...
ParameterPool *	createParameterTree () const
	Creates new parameter pool, with all local parameters and those of its children. More...
IDetector &	detector ()
const IDetector &	detector () const
IDetector2D &	detector2D ()
const IDetector2D &	detector2D () const
std::string	displayName () const
	Returns display name, composed from the name of node and it's copy number. More...
std::vector< const INode * >	getChildren () const
	Returns a vector of children. More...
IDetector *	getDetector ()
const IDetector *	getDetector () const
const DistributionHandler &	getDistributionHandler () const
const std::string &	getName () const
SimulationOptions &	getOptions ()
const SimulationOptions &	getOptions () const
Instrument &	instrument ()
const Instrument &	instrument () const
virtual size_t	intensityMapSize () const =0
	Returns the total number of the intensity values in the simulation result. More...
void	maskAll ()
	Put the mask for all detector channels (i.e. exclude whole detector from the analysis) More...
virtual void	onChange ()
	Action to be taken in inherited class when a parameter has changed. More...
RealParameter *	parameter (const std::string &name) const
	Returns parameter with given 'name'. More...
ParameterPool *	parameterPool () const
	Returns pointer to the parameter pool. More...
std::string	parametersToString () const
	Returns multiline string representing available parameters. More...
INode *	parent ()
const INode *	parent () const
void	prepareSimulation () override
	Put into a clean state for running a simulation. More...
std::vector< const INode * >	progeny () const
	Returns a vector of all descendants. More...
void	registerChild (INode *node)
RealParameter &	registerParameter (const std::string &name, double *parpointer)
void	registerVector (const std::string &base_name, kvector_t *p_vec, const std::string &units="nm")
void	removeParameter (const std::string &name)
void	removeVector (const std::string &base_name)
virtual SimulationResult	result () const =0
	Returns the results of the simulation in a format that supports unit conversion and export to numpy arrays. More...
void	runMPISimulation ()
	Run a simulation in a MPI environment. More...
void	runSimulation ()
	Run a simulation, possibly averaged over parameter distributions. More...
const MultiLayer *	sample () const
void	setBackground (const IBackground &bg)
void	setDetector (const IDetector2D &detector)
	Sets the detector (axes can be overwritten later) More...
void	setDetectorParameters (size_t n_phi, double phi_min, double phi_max, size_t n_alpha, double alpha_min, double alpha_max)
	Sets spherical detector parameters using angle ranges. More...
void	setDetectorResolutionFunction (const IResolutionFunction2D &resolution_function)
void	setInstrument (const Instrument &instrument_)
void	setName (const std::string &name)
void	setOptions (const SimulationOptions &options)
void	setParameterValue (const std::string &name, double value)
virtual void	setParent (const INode *newParent)
void	setRegionOfInterest (double xlow, double ylow, double xup, double yup)
	Sets rectangular region of interest with lower left and upper right corners defined. More...
void	setSample (const MultiLayer &sample)
	The MultiLayer object will not be owned by the ISimulation object. More...
void	setSampleBuilder (const std::shared_ptr< ISampleBuilder > &sample_builder)
void	setTerminalProgressMonitor ()
	Initializes a progress monitor that prints to stdout. More...
void	setVectorValue (const std::string &base_name, kvector_t value)
void	subscribe (ProgressHandler::Callback_t inform)
virtual void	transferToCPP ()
	Used for Python overriding of clone (see swig/tweaks.py) More...
virtual std::string	treeToString () const
	Returns multiline string representing tree structure below the node. More...

Static Public Member Functions
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
	ISimulation2D (const ISimulation2D &other)
void	addBackgroundIntensity (size_t start_ind, size_t n_elements) override
void	addDataToCache (double weight) override
std::vector< SimulationElement >	generateSimulationElements (const Beam &beam)
	Generate simulation elements for given beam. More...
std::unique_ptr< IComputation >	generateSingleThreadedComputation (size_t start, size_t n_elements) override
	Generate a single threaded computation for a given range of simulation elements. More...
virtual void	initSimulationElementVector ()=0
	Initializes the vector of ISimulation elements. More...
virtual void	initUnitConverter ()
void	moveDataFromCache () override
void	normalize (size_t start_ind, size_t n_elements) override
	Normalize the detector counts to beam intensity, to solid angle, and to exposure angle. More...
size_t	numberOfSimulationElements () const override
	Gets the number of elements this simulation needs to calculate. More...
const SimulationOptions &	options () const
ProgressHandler &	progress ()
virtual void	transferResultsToIntensityMap ()
	Creates the appropriate data structure (e.g. More...
virtual void	updateIntensityMap ()

Protected Attributes
std::vector< double >	m_cache
const size_t	m_NP
std::vector< double >	m_P
std::vector< SimulationElement >	m_sim_elements

Private Member Functions
void	initialize ()
std::vector< double >	rawResults () const override
void	runSingleSimulation (size_t batch_start, size_t batch_size, double weight=1.0)
	Runs a single simulation with fixed parameter values. More...
void	setRawResults (const std::vector< double > &raw_data) override
virtual void	validateParametrization (const ParameterDistribution &) const
	Checks the distribution validity for simulation. More...

Private Attributes
std::unique_ptr< IBackground >	m_background
std::unique_ptr< DetectorContext >	m_detector_context
DistributionHandler	m_distribution_handler
Instrument	m_instrument
std::string	m_name
SimulationOptions	m_options
const INode *	m_parent {nullptr}
std::unique_ptr< ParameterPool >	m_pool
	parameter pool (kind of pointer-to-implementation) More...
ProgressHandler	m_progress
SampleProvider	m_sample_provider

Detailed Description

Abstract base class of OffSpecularSimulation and GISASSimulation.

Holds the common implementations for simulations with a 2D detector

Definition at line 27 of file ISimulation2D.h.

Constructor & Destructor Documentation

ISimulation2D() [1/4]

ISimulation2D::ISimulation2D	(	const Beam &	beam,
		const MultiLayer &	sample,
		const IDetector &	detector
	)

Definition at line 22 of file ISimulation2D.cpp.

    : ISimulation(beam, sample, detector)
{
}

ISimulation2D() [2/4]

ISimulation2D::ISimulation2D	(	const Beam &	beam,
		const IDetector &	detector
	)

Definition at line 28 of file ISimulation2D.cpp.

    : ISimulation(beam, detector)
{
}

ISimulation2D() [3/4]

ISimulation2D::ISimulation2D ( )

default

~ISimulation2D()

ISimulation2D::~ISimulation2D ( )

overridedefault

ISimulation2D() [4/4]

ISimulation2D::ISimulation2D ( const ISimulation2D &  other )

protected

Definition at line 75 of file ISimulation2D.cpp.

    : ISimulation(other), m_sim_elements(other.m_sim_elements), m_cache(other.m_cache)
{
}

Member Function Documentation

accept()

virtual void INode::accept ( INodeVisitor *  visitor ) const

pure virtualinherited

Calls the INodeVisitor's visit method.

Implemented in FormFactorDecoratorMaterial, FormFactorWeighted, FormFactorCrystal, FormFactorCoreShell, Lattice3D, MisesGaussPeakShape, MisesFisherGaussPeakShape, LorentzFisherPeakShape, GaussFisherPeakShape, IsotropicLorentzPeakShape, IsotropicGaussPeakShape, ParticleLayout, InterferenceFunctionHardDisk, InterferenceFunctionFinite3DLattice, InterferenceFunctionFinite2DLattice, InterferenceFunction3DLattice, InterferenceFunction2DSuperLattice, InterferenceFunction2DParaCrystal, InterferenceFunction2DLattice, InterferenceFunction1DLattice, SphericalDetector, SpecularDetector1D, FootprintSquare, FootprintGauss, Beam, OffSpecularSimulation, GISASSimulation, PoissonNoiseBackground, ConstantBackground, FormFactorSphereLogNormalRadius, FormFactorSphereGaussianRadius, FormFactorGaussSphere, FormFactorDecoratorRotation, FormFactorDecoratorPositionFactor, SampleProvider, SampleBuilderNode, ParticleDistribution, ParticleCoreShell, ParticleComposition, Particle, MesoCrystal, Crystal, MultiLayer, Layer, HexagonalLattice2D, SquareLattice2D, BasicLattice2D, FormFactorTruncatedSpheroid, FormFactorTruncatedSphere, FormFactorTruncatedCube, FormFactorTetrahedron, FormFactorSawtoothRippleLorentz, FormFactorSawtoothRippleGauss, FormFactorSawtoothRippleBox, FormFactorPyramid, FormFactorPrism6, FormFactorPrism3, FormFactorLongBoxLorentz, FormFactorLongBoxGauss, FormFactorIcosahedron, FormFactorHollowSphere, FormFactorHemiEllipsoid, FormFactorFullSpheroid, FormFactorFullSphere, FormFactorEllipsoidalCylinder, FormFactorDot, FormFactorDodecahedron, FormFactorCylinder, FormFactorCuboctahedron, FormFactorCosineRippleLorentz, FormFactorCosineRippleGauss, FormFactorCosineRippleBox, FormFactorCone6, FormFactorCone, FormFactorCantellatedCube, FormFactorBox, FormFactorBarLorentz, FormFactorBarGauss, FormFactorAnisoPyramid, FTDistribution2DVoigt, FTDistribution2DCone, FTDistribution2DGate, FTDistribution2DGauss, FTDistribution2DCauchy, FTDistribution1DVoigt, FTDistribution1DCosine, FTDistribution1DTriangle, FTDistribution1DGate, FTDistribution1DGauss, FTDistribution1DCauchy, FTDecayFunction2DVoigt, FTDecayFunction2DGauss, FTDecayFunction2DCauchy, FTDecayFunction1DVoigt, FTDecayFunction1DTriangle, FTDecayFunction1DGauss, FTDecayFunction1DCauchy, InterferenceFunctionTwin, InterferenceFunctionRadialParaCrystal, InterferenceFunctionNone, DistributionTrapezoid, DistributionCosine, DistributionLogNormal, DistributionGaussian, DistributionLorentz, DistributionGate, ResolutionFunction2DGaussian, ConvolutionDetectorResolution, Instrument, RectangularDetector, IsGISAXSDetector, DetectionProperties, SpecularSimulation, DepthProbeSimulation, LayerRoughness, LayerInterface, RotationEuler, RotationZ, RotationY, RotationX, IdentityRotation, and IAbstractParticle.

addBackgroundIntensity()

void ISimulation2D::addBackgroundIntensity ( size_t  start_ind, size_t  n_elements  )

overrideprotectedvirtual

Implements ISimulation.

Definition at line 151 of file ISimulation2D.cpp.

{
    if (!background())
        return;
    for (size_t i = start_ind, stop_point = start_ind + n_elements; i < stop_point; ++i) {
        SimulationElement& element = m_sim_elements[i];
        element.setIntensity(background()->addBackground(element.intensity()));
    }
}

References ISimulation::background(), SimulationElement::intensity(), m_sim_elements, and SimulationElement::setIntensity().

Here is the call graph for this function:

addDataToCache()

void ISimulation2D::addDataToCache ( double  weight )

overrideprotectedvirtual

Implements ISimulation.

Definition at line 161 of file ISimulation2D.cpp.

{
    if (m_sim_elements.size() != m_cache.size())
        throw std::runtime_error("Error in ISimulation2D::addDataToCache(double): cache size"
                                 " not the same as element size");
    for (unsigned i = 0; i < m_sim_elements.size(); i++)
        m_cache[i] += m_sim_elements[i].intensity() * weight;
}

References m_cache, and m_sim_elements.

addMask()

void ISimulation2D::addMask	(	const IShape2D &	shape,
		bool	mask_value = true
	)

Adds mask of given shape to the stack of detector masks.

The mask value 'true' means that the channel will be excluded from the simulation. The mask which is added last has priority.

Parameters

shape	The shape of mask (Rectangle, Polygon, Line, Ellipse)
mask_value	The value of mask

Definition at line 60 of file ISimulation2D.cpp.

{
    detector2D().addMask(shape, mask_value);
}

References IDetector2D::addMask(), and detector2D().

Referenced by StandardSimulations::GISASWithMasks(), StandardSimulations::RectDetWithRoi(), and StandardSimulations::SphericalDetWithRoi().

Here is the call graph for this function:

addParameterDistribution() [1/2]

void ISimulation::addParameterDistribution ( const ParameterDistribution &  par_distr )

inherited

Definition at line 272 of file ISimulation.cpp.

{
    validateParametrization(par_distr);
    m_distribution_handler.addParameterDistribution(par_distr);
}

References DistributionHandler::addParameterDistribution(), ISimulation::m_distribution_handler, and ISimulation::validateParametrization().

Here is the call graph for this function:

addParameterDistribution() [2/2]

void ISimulation::addParameterDistribution ( const std::string &  param_name, const IDistribution1D &  distribution, size_t  nbr_samples, double  sigma_factor = 0.0, const RealLimits &  limits = RealLimits()  )

inherited

Definition at line 264 of file ISimulation.cpp.

{
    ParameterDistribution par_distr(param_name, distribution, nbr_samples, sigma_factor, limits);
    addParameterDistribution(par_distr);
}

Referenced by StandardSimulations::MiniGISASBeamDivergence(), and TransformToDomain::setBeamDistribution().

background()

const IBackground* ISimulation::background ( ) const

inlineinherited

Definition at line 74 of file ISimulation.h.

{ return m_background.get(); }

References ISimulation::m_background.

Referenced by DepthProbeSimulation::addBackgroundIntensity(), addBackgroundIntensity(), SpecularSimulation::addBackgroundIntensity(), and TransformFromDomain::setBackground().

beam() [1/2]

Beam& ISimulation::beam ( )

inlineinherited

Definition at line 58 of file ISimulation.h.

{ return m_instrument.beam(); }

References Instrument::beam(), and ISimulation::m_instrument.

Referenced by StandardSimulations::BasicGISAS00(), StandardSimulations::BasicPolarizedGISAS(), DepthProbeSimulation::createUnitConverter(), OffSpecularSimulation::createUnitConverter(), DepthProbeSimulation::generateSimulationElements(), generateSimulationElements(), DepthProbeSimulation::initialize(), DepthProbeSimulation::initSimulationElementVector(), GISASSimulation::initSimulationElementVector(), OffSpecularSimulation::initSimulationElementVector(), StandardSimulations::MaxiGISAS00(), StandardSimulations::MiniGISASPolarizationMM(), StandardSimulations::MiniGISASPolarizationMP(), StandardSimulations::MiniGISASPolarizationPM(), StandardSimulations::MiniGISASPolarizationPP(), DepthProbeSimulation::normalize(), normalize(), SpecularSimulation::normalize(), OffSpecularSimulation::result(), DepthProbeSimulation::setBeamParameters(), TransformFromDomain::setGISASBeamItem(), TransformFromDomain::setOffSpecularBeamItem(), and TransformFromDomain::setSpecularBeamItem().

Here is the call graph for this function:

beam() [2/2]

const Beam& ISimulation::beam ( ) const

inlineinherited

Definition at line 59 of file ISimulation.h.

{ return m_instrument.beam(); }

References Instrument::beam(), and ISimulation::m_instrument.

Here is the call graph for this function:

clone()

ISimulation2D* ISimulation2D::clone ( ) const

overridepure virtual

Implements ISimulation.

Implemented in OffSpecularSimulation, and GISASSimulation.

convertData()

SimulationResult ISimulation::convertData ( const OutputData< double > &  data, bool  put_masked_areas_to_zero = true  )

inherited

Convert user data to SimulationResult object for later drawing in various axes units.

User data will be cropped to the ROI defined in the simulation, amplitudes in areas corresponding to the masked areas of the detector will be set to zero.

Definition at line 308 of file ISimulation.cpp.

{
    auto converter = UnitConverterUtils::createConverter(*this);
    auto roi_data = UnitConverterUtils::createOutputData(*converter, converter->defaultUnits());
 
    if (roi_data->hasSameDimensions(data)) {
        // data is already cropped to ROI
        if (put_masked_areas_to_zero) {
            detector().iterate(
                [&](IDetector::const_iterator it) {
                    (*roi_data)[it.roiIndex()] = data[it.roiIndex()];
                },
                /*visit_masked*/ false);
        } else {
            roi_data->setRawDataVector(data.getRawDataVector());
        }
 
    } else if (detHasSameDimensions(detector(), data)) {
        // exp data has same shape as the detector, we have to put orig data to smaller roi map
        detector().iterate(
            [&](IDetector::const_iterator it) {
                (*roi_data)[it.roiIndex()] = data[it.detectorIndex()];
            },
            /*visit_masked*/ !put_masked_areas_to_zero);
 
    } else {
        throw std::runtime_error("FitObject::init_dataset() -> Error. Detector and exp data have "
                                 "different shape.");
    }
 
    return SimulationResult(*roi_data, *converter);
}

References UnitConverterUtils::createConverter(), UnitConverterUtils::createOutputData(), ISimulation::detector(), SimulationAreaIterator::detectorIndex(), OutputData< T >::getRawDataVector(), IDetector::iterate(), and SimulationAreaIterator::roiIndex().

Here is the call graph for this function:

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 94 of file INode.cpp.

{
    if (node->parent() != this)
        return -1;
 
    int result(-1), count(0);
    for (auto child : getChildren()) {
 
        if (child == nullptr)
            throw std::runtime_error("INode::copyNumber() -> Error. Nullptr as child.");
 
        if (child == node)
            result = count;
 
        if (child->getName() == node->getName())
            ++count;
    }
 
    return count > 1 ? result : -1;
}

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

Referenced by INode::displayName().

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 IParametricComponent.

Definition at line 126 of file INode.cpp.

{
    std::unique_ptr<ParameterPool> result(new ParameterPool);
 
    for (const INode* child : progeny()) {
        const std::string path = NodeUtils::nodePath(child, parent()) + "/";
        child->parameterPool()->copyToExternalPool(path, result.get());
    }
 
    return result.release();
}

References NodeUtils::nodePath(), INode::parent(), and INode::progeny().

Referenced by ISimulation::runSimulation(), DepthProbeSimulation::validateParametrization(), OffSpecularSimulation::validateParametrization(), and SpecularSimulation::validateParametrization().

Here is the call graph for this function:

detector() [1/2]

IDetector& ISimulation::detector ( )

inlineinherited

Definition at line 63 of file ISimulation.h.

{ return m_instrument.detector(); }

References Instrument::detector(), and ISimulation::m_instrument.

Referenced by SpecularSimulation::SpecularSimulation(), StandardSimulations::BasicGISAS00(), StandardSimulations::BasicPolarizedGISAS(), OffSpecularSimulation::checkInitialization(), ISimulation::convertData(), generateSimulationElements(), generateSingleThreadedComputation(), SpecularSimulation::generateSingleThreadedComputation(), GISASSimulation::intensityMapSize(), OffSpecularSimulation::intensityMapSize(), StandardSimulations::MaxiGISAS00(), StandardSimulations::MiniGISASPolarizationMM(), StandardSimulations::MiniGISASPolarizationMP(), StandardSimulations::MiniGISASPolarizationPM(), StandardSimulations::MiniGISASPolarizationPP(), GISASSimulation::prepareSimulation(), SpecularSimulation::prepareSimulation(), GISASSimulation::result(), DepthProbeSimulation::setBeamParameters(), setDetector(), ISimulation::setDetectorResolutionFunction(), SpecularSimulation::setScan(), OffSpecularSimulation::transferDetectorImage(), OffSpecularSimulation::transferResultsToIntensityMap(), and OffSpecularSimulation::updateIntensityMap().

Here is the call graph for this function:

detector() [2/2]

const IDetector& ISimulation::detector ( ) const

inlineinherited

Definition at line 64 of file ISimulation.h.

{ return m_instrument.detector(); }

References Instrument::detector(), and ISimulation::m_instrument.

Here is the call graph for this function:

detector2D() [1/2]

IDetector2D & ISimulation2D::detector2D

(

)

Definition at line 38 of file ISimulation2D.cpp.

{
    ASSERT(getDetector());
    IDetector2D* p = dynamic_cast<IDetector2D*>(getDetector());
    ASSERT(p);
    return *p;
}

References ASSERT, and ISimulation::getDetector().

Referenced by addMask(), OffSpecularSimulation::createUnitConverter(), generateSimulationElements(), maskAll(), prepareSimulation(), OffSpecularSimulation::result(), setDetectorParameters(), and setRegionOfInterest().

Here is the call graph for this function:

detector2D() [2/2]

const IDetector2D & ISimulation2D::detector2D

(

)

const

Definition at line 46 of file ISimulation2D.cpp.

{
    ASSERT(getDetector());
    const IDetector2D* p = dynamic_cast<const IDetector2D*>(getDetector());
    ASSERT(p);
    return *p;
}

References ASSERT, and ISimulation::getDetector().

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 115 of file INode.cpp.

{
    std::string result = getName();
    if (m_parent) {
        int index = m_parent->copyNumber(this);
        if (index >= 0)
            result = result + std::to_string(index);
    }
    return result;
}

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

Referenced by NodeUtils::nodePath().

Here is the call graph for this function:

generateSimulationElements()

std::vector< SimulationElement > ISimulation2D::generateSimulationElements ( const Beam &  beam )

protected

Generate simulation elements for given beam.

Definition at line 111 of file ISimulation2D.cpp.

{
    const double wavelength = beam.wavelength();
    const double alpha_i = -beam.direction().alpha(); // Defined to be always positive in Beam
    const double phi_i = beam.direction().phi();
    const Eigen::Matrix2cd beam_polarization = beam.getPolarization();
 
    const IDetector2D& detector = detector2D();
    const Eigen::Matrix2cd analyzer_operator = detector.detectionProperties().analyzerOperator();
    const size_t spec_index = detector.indexOfSpecular(beam);
 
    const size_t N = m_detector_context->numberOfSimulationElements();
 
    std::vector<SimulationElement> result;
    result.reserve(N);
    for (size_t element_index = 0; element_index < N; ++element_index) {
        SimulationElement element(wavelength, alpha_i, phi_i,
                                  m_detector_context->createPixel(element_index), beam_polarization,
                                  analyzer_operator,
                                  m_detector_context->detectorIndex(element_index) == spec_index);
        result.emplace_back(std::move(element));
    }
    return result;
}

References Direction::alpha(), DetectionProperties::analyzerOperator(), ISimulation::beam(), IDetector::detectionProperties(), ISimulation::detector(), detector2D(), Beam::direction(), Beam::getPolarization(), m_detector_context, Direction::phi(), ISimulation::result(), and Beam::wavelength().

Referenced by GISASSimulation::initSimulationElementVector(), and OffSpecularSimulation::initSimulationElementVector().

Here is the call graph for this function:

generateSingleThreadedComputation()

std::unique_ptr< IComputation > ISimulation2D::generateSingleThreadedComputation ( size_t  start, size_t  n_elements  )

overrideprotectedvirtual

Generate a single threaded computation for a given range of simulation elements.

Parameters

start	Index of the first element to include into computation
n_elements	Number of elements to process

Implements ISimulation.

Definition at line 100 of file ISimulation2D.cpp.

{
    ASSERT(start < m_sim_elements.size() && start + n_elements <= m_sim_elements.size());
    const auto& begin = m_sim_elements.begin() + static_cast<long>(start);
    const auto polarized =
        this->detector().detectionProperties().analyzerDirection() != kvector_t{};
    return std::make_unique<DWBAComputation>(*sample(), options(), progress(), begin,
                                             begin + static_cast<long>(n_elements), polarized);
}

References DetectionProperties::analyzerDirection(), ASSERT, IDetector::detectionProperties(), ISimulation::detector(), m_sim_elements, ISimulation::options(), FormFactorPrecompute::polarized(), ISimulation::progress(), and ISimulation::sample().

Here is the call graph for this function:

getChildren()

std::vector< const INode * > ISimulation::getChildren ( ) const

virtualinherited

Returns a vector of children.

Reimplemented from INode.

Definition at line 254 of file ISimulation.cpp.

{
    std::vector<const INode*> result;
    result.push_back(&instrument());
    result << m_sample_provider.getChildren();
    if (m_background)
        result.push_back(m_background.get());
    return result;
}

References SampleProvider::getChildren(), ISimulation::instrument(), ISimulation::m_background, ISimulation::m_sample_provider, and ISimulation::result().

Here is the call graph for this function:

getDetector() [1/2]

IDetector* ISimulation::getDetector ( )

inlineinherited

Definition at line 61 of file ISimulation.h.

{ return m_instrument.getDetector(); }

References Instrument::getDetector(), and ISimulation::m_instrument.

Referenced by detector2D(), TransformFromDomain::setDetector(), and TransformFromDomain::setDetectorMasks().

Here is the call graph for this function:

getDetector() [2/2]

const IDetector* ISimulation::getDetector ( ) const

inlineinherited

Definition at line 62 of file ISimulation.h.

{ return m_instrument.getDetector(); }

References Instrument::getDetector(), and ISimulation::m_instrument.

Here is the call graph for this function:

getDistributionHandler()

const DistributionHandler& ISimulation::getDistributionHandler ( ) const

inlineinherited

Definition at line 88 of file ISimulation.h.

{ return m_distribution_handler; }

References ISimulation::m_distribution_handler.

Referenced by TransformFromDomain::setGISASBeamItem().

getName()

const std::string& IParametricComponent::getName ( ) const

inlineinherited

Definition at line 70 of file IParametricComponent.h.

{ return m_name; }

References IParametricComponent::m_name.

Referenced by Beam::Beam(), ConvolutionDetectorResolution::ConvolutionDetectorResolution(), IDetector::IDetector(), Instrument::Instrument(), IParametricComponent::IParametricComponent(), SampleBuilderNode::SampleBuilderNode(), Layer::clone(), INode::copyNumber(), IParametricComponent::createParameterTree(), IFormFactor::createSlicedFormFactor(), SampleToPython::defineInterferenceFunctions(), INode::displayName(), Beam::operator=(), SampleBuilderNode::operator=(), GUIObjectBuilder::populateInstrumentModel(), PyImportAssistant::populateModels(), GUIDomainSampleVisitor::populateSampleModel(), IParametricComponent::registerParameter(), IFormFactor::sliceFormFactor(), and GUIDomainSampleVisitor::visit().

getOptions() [1/2]

SimulationOptions& ISimulation::getOptions ( )

inlineinherited

Definition at line 92 of file ISimulation.h.

{ return m_options; }

References ISimulation::m_options.

getOptions() [2/2]

const SimulationOptions& ISimulation::getOptions ( ) const

inlineinherited

Definition at line 91 of file ISimulation.h.

{ return m_options; }

References ISimulation::m_options.

Referenced by StandardSimulations::MiniGISASMonteCarlo(), StandardSimulations::MiniGISASSpecularPeak(), GUIObjectBuilder::populateDocumentModel(), and TransformToDomain::setSimulationOptions().

initialize()

void ISimulation::initialize ( )

privateinherited

Definition at line 151 of file ISimulation.cpp.

{
    registerChild(&m_instrument);
    registerChild(&m_sample_provider);
}

References ISimulation::m_instrument, ISimulation::m_sample_provider, and INode::registerChild().

Referenced by ISimulation::ISimulation().

Here is the call graph for this function:

initSimulationElementVector()

virtual void ISimulation::initSimulationElementVector ( )

protectedpure virtualinherited

Initializes the vector of ISimulation elements.

Implemented in SpecularSimulation, OffSpecularSimulation, GISASSimulation, and DepthProbeSimulation.

Referenced by ISimulation::runSingleSimulation(), and setRawResults().

initUnitConverter()

virtual void ISimulation2D::initUnitConverter ( )

inlineprotectedvirtual

Definition at line 73 of file ISimulation2D.h.

{}

Referenced by setDetector().

instrument() [1/2]

Instrument& ISimulation::instrument ( )

inlineinherited

Definition at line 56 of file ISimulation.h.

{ return m_instrument; }

References ISimulation::m_instrument.

instrument() [2/2]

const Instrument& ISimulation::instrument ( ) const

inlineinherited

Definition at line 55 of file ISimulation.h.

{ return m_instrument; }

References ISimulation::m_instrument.

Referenced by SpecularSimulation::SpecularSimulation(), ISimulation::getChildren(), SpecularSimulation::initialize(), SpecularSimulation::initSimulationElementVector(), GUIObjectBuilder::populateInstrumentModel(), GISASSimulation::prepareSimulation(), SpecularSimulation::prepareSimulation(), GISASSimulation::result(), DepthProbeSimulation::setBeamParameters(), OffSpecularSimulation::setBeamParameters(), GISASSimulation::setBeamParameters(), setDetector(), and SpecularSimulation::setScan().

intensityMapSize()

virtual size_t ISimulation::intensityMapSize ( ) const

pure virtualinherited

Returns the total number of the intensity values in the simulation result.

Implemented in SpecularSimulation, OffSpecularSimulation, GISASSimulation, and DepthProbeSimulation.

maskAll()

void ISimulation2D::maskAll

(

)

Put the mask for all detector channels (i.e. exclude whole detector from the analysis)

Definition at line 65 of file ISimulation2D.cpp.

{
    detector2D().maskAll();
}

References detector2D(), and IDetector2D::maskAll().

Referenced by StandardSimulations::GISASWithMasks().

Here is the call graph for this function:

moveDataFromCache()

void ISimulation2D::moveDataFromCache ( )

overrideprotectedvirtual

Implements ISimulation.

Definition at line 170 of file ISimulation2D.cpp.

{
    ASSERT(!m_cache.empty());
    if (!m_cache.empty()) {
        for (unsigned i = 0; i < m_sim_elements.size(); i++)
            m_sim_elements[i].setIntensity(m_cache[i]);
        m_cache.clear();
    }
}

References ASSERT, m_cache, and m_sim_elements.

normalize()

void ISimulation2D::normalize ( size_t  start_ind, size_t  n_elements  )

overrideprotectedvirtual

Normalize the detector counts to beam intensity, to solid angle, and to exposure angle.

Parameters

start_ind	Index of the first element to operate on
n_elements	Number of elements to process

Implements ISimulation.

Definition at line 136 of file ISimulation2D.cpp.

{
    const double beam_intensity = beam().intensity();
    for (size_t i = start_ind, stop_point = start_ind + n_elements; i < stop_point; ++i) {
        SimulationElement& element = m_sim_elements[i];
        double sin_alpha_i = std::abs(std::sin(element.getAlphaI()));
        if (sin_alpha_i == 0.0) {
            element.setIntensity(0);
            continue;
        }
        const double solid_angle = element.solidAngle();
        element.setIntensity(element.intensity() * beam_intensity * solid_angle / sin_alpha_i);
    }
}

References ISimulation::beam(), SimulationElement::getAlphaI(), SimulationElement::intensity(), Beam::intensity(), m_sim_elements, SimulationElement::setIntensity(), and SimulationElement::solidAngle().

Here is the call graph for this function:

numberOfSimulationElements()

size_t ISimulation2D::numberOfSimulationElements ( ) const

overrideprotectedvirtual

Gets the number of elements this simulation needs to calculate.

Implements ISimulation.

Reimplemented in OffSpecularSimulation.

Definition at line 80 of file ISimulation2D.cpp.

{
    if (!m_detector_context)
        throw std::runtime_error("Error in numberOfSimulationElements(): no detector context");
    return m_detector_context->numberOfSimulationElements();
}

References m_detector_context.

Referenced by OffSpecularSimulation::numberOfSimulationElements().

onChange()

virtual void IParametricComponent::onChange ( )

inlinevirtualinherited

Action to be taken in inherited class when a parameter has changed.

Reimplemented in IProfileRipple, Lattice3D, InterferenceFunction3DLattice, InterferenceFunction2DLattice, FormFactorSphereLogNormalRadius, FormFactorSphereGaussianRadius, FormFactorGaussSphere, ISawtoothRipple, ICosineRipple, IProfileRectangularRipple, FormFactorTruncatedSpheroid, FormFactorTruncatedSphere, FormFactorTruncatedCube, FormFactorTetrahedron, FormFactorPyramid, FormFactorPrism6, FormFactorPrism3, FormFactorLongBoxLorentz, FormFactorLongBoxGauss, FormFactorIcosahedron, FormFactorHollowSphere, FormFactorHemiEllipsoid, FormFactorFullSpheroid, FormFactorFullSphere, FormFactorEllipsoidalCylinder, FormFactorDodecahedron, FormFactorCylinder, FormFactorCuboctahedron, FormFactorCone6, FormFactorCone, FormFactorCantellatedCube, FormFactorBox, FormFactorAnisoPyramid, and Lattice2D.

Definition at line 59 of file IParametricComponent.h.

{}

Referenced by Lattice2D::onChange(), and IParametricComponent::registerParameter().

options()

const SimulationOptions& ISimulation::options ( ) const

inlineprotectedinherited

Definition at line 124 of file ISimulation.h.

{ return m_options; }

References ISimulation::m_options.

Referenced by DepthProbeSimulation::generateSingleThreadedComputation(), generateSingleThreadedComputation(), SpecularSimulation::generateSingleThreadedComputation(), and ISimulation::setOptions().

parameter()

RealParameter * IParametricComponent::parameter ( const std::string &  name ) const

inherited

Returns parameter with given 'name'.

Definition at line 86 of file IParametricComponent.cpp.

{
    return m_pool->parameter(name);
}

References IParametricComponent::m_pool, and RealSpace::Particles::name().

Referenced by DepthProbeSimulation::initialize(), SpecularSimulation::initialize(), Lattice3D::initialize(), IParticle::registerAbundance(), ParticleLayout::registerParticleDensity(), IParticle::registerPosition(), Layer::registerThickness(), Lattice2D::setRotationEnabled(), and DistributionLogNormal::setUnits().

Here is the call graph for this function:

parameterPool()

ParameterPool* IParametricComponent::parameterPool ( ) const

inlineinherited

Returns pointer to the parameter pool.

Definition at line 39 of file IParametricComponent.h.

{ return m_pool.get(); } // has non-const usages!

References IParametricComponent::m_pool.

Referenced by INode::INode(), IParametricComponent::IParametricComponent(), pyfmt2::argumentList(), SampleBuilderNode::borrow_builder_parameters(), SampleBuilderNode::reset(), and IDistribution1D::setUnits().

parametersToString()

std::string IParametricComponent::parametersToString ( ) const

inherited

Returns multiline string representing available parameters.

Definition at line 43 of file IParametricComponent.cpp.

{
    std::ostringstream result;
    std::unique_ptr<ParameterPool> P_pool(createParameterTree());
    result << *P_pool << "\n";
    return result.str();
}

References IParametricComponent::createParameterTree().

Here is the call graph for this function:

parent() [1/2]

INode * INode::parent ( )

inherited

Definition at line 89 of file INode.cpp.

{
    return const_cast<INode*>(m_parent);
}

References INode::m_parent.

parent() [2/2]

const INode * INode::parent ( ) const

inherited

Definition at line 84 of file INode.cpp.

{
    return m_parent;
}

References INode::m_parent.

Referenced by INode::copyNumber(), INode::createParameterTree(), ParticleDistribution::generateParticles(), NodeUtils::nodePath(), Lattice2D::onChange(), SampleProvider::setBuilder(), SampleProvider::setParent(), and SampleProvider::setSample().

prepareSimulation()

void ISimulation2D::prepareSimulation ( )

overridevirtual

Put into a clean state for running a simulation.

Reimplemented from ISimulation.

Reimplemented in OffSpecularSimulation.

Definition at line 54 of file ISimulation2D.cpp.

{
    ISimulation::prepareSimulation();
    m_detector_context = detector2D().createContext();
}

References IDetector2D::createContext(), detector2D(), m_detector_context, and ISimulation::prepareSimulation().

Referenced by GISASSimulation::prepareSimulation(), and OffSpecularSimulation::prepareSimulation().

Here is the call graph for this function:

progeny()

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

inherited

Returns a vector of all descendants.

Definition at line 68 of file INode.cpp.

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

References INode::getChildren().

Referenced by INode::createParameterTree(), and ParticleDistribution::generateParticles().

Here is the call graph for this function:

progress()

ProgressHandler& ISimulation::progress ( )

inlineprotectedinherited

Definition at line 125 of file ISimulation.h.

{ return m_progress; }

References ISimulation::m_progress.

Referenced by DepthProbeSimulation::generateSingleThreadedComputation(), generateSingleThreadedComputation(), and SpecularSimulation::generateSingleThreadedComputation().

rawResults()

std::vector< double > ISimulation2D::rawResults ( ) const

overrideprivatevirtual

Implements ISimulation.

Definition at line 180 of file ISimulation2D.cpp.

{
    std::vector<double> result;
    result.resize(m_sim_elements.size());
    for (unsigned i = 0; i < m_sim_elements.size(); ++i)
        result[i] = m_sim_elements[i].intensity();
    return result;
}

References m_sim_elements, and ISimulation::result().

Here is the call graph for this function:

registerChild()

void INode::registerChild ( INode *  node )

inherited

Definition at line 57 of file INode.cpp.

{
    ASSERT(node);
    node->setParent(this);
}

References ASSERT, and INode::setParent().

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

Here is the call graph for this function:

registerParameter()

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

inherited

Definition at line 51 of file IParametricComponent.cpp.

{
    return m_pool->addParameter(
        new RealParameter(name, data, getName(), [&]() -> void { onChange(); }));
}

References IParametricComponent::getName(), IParametricComponent::m_pool, RealSpace::Particles::name(), and IParametricComponent::onChange().

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

Here is the call graph for this function:

registerVector()

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

inherited

Definition at line 57 of file IParametricComponent.cpp.

{
    registerParameter(XComponentName(base_name), &((*p_vec)[0])).setUnit(units);
    registerParameter(YComponentName(base_name), &((*p_vec)[1])).setUnit(units);
    registerParameter(ZComponentName(base_name), &((*p_vec)[2])).setUnit(units);
}

References ModelView::Utils::base_name(), IParametricComponent::registerParameter(), RealParameter::setUnit(), IParametricComponent::XComponentName(), IParametricComponent::YComponentName(), and IParametricComponent::ZComponentName().

Referenced by Beam::Beam(), DetectionProperties::DetectionProperties(), InterferenceFunctionTwin::InterferenceFunctionTwin(), MultiLayer::MultiLayer(), Lattice3D::initialize(), and IParticle::registerPosition().

Here is the call graph for this function:

removeParameter()

void IParametricComponent::removeParameter ( const std::string &  name )

inherited

Definition at line 91 of file IParametricComponent.cpp.

{
    m_pool->removeParameter(name);
}

References IParametricComponent::m_pool, and RealSpace::Particles::name().

Referenced by IParticle::registerAbundance(), ParticleLayout::registerParticleDensity(), Layer::registerThickness(), IParametricComponent::removeVector(), and Lattice2D::setRotationEnabled().

Here is the call graph for this function:

removeVector()

void IParametricComponent::removeVector ( const std::string &  base_name )

inherited

Definition at line 96 of file IParametricComponent.cpp.

{
    removeParameter(XComponentName(base_name));
    removeParameter(YComponentName(base_name));
    removeParameter(ZComponentName(base_name));
}

References ModelView::Utils::base_name(), IParametricComponent::removeParameter(), IParametricComponent::XComponentName(), IParametricComponent::YComponentName(), and IParametricComponent::ZComponentName().

Referenced by IParticle::registerPosition().

Here is the call graph for this function:

result()

virtual SimulationResult ISimulation::result ( ) const

pure virtualinherited

Returns the results of the simulation in a format that supports unit conversion and export to numpy arrays.

Implemented in SpecularSimulation, OffSpecularSimulation, GISASSimulation, and DepthProbeSimulation.

Referenced by generateSimulationElements(), ISimulation::getChildren(), rawResults(), and JobItemUtils::setResults().

runMPISimulation()

void ISimulation::runMPISimulation ( )

inherited

Run a simulation in a MPI environment.

Definition at line 226 of file ISimulation.cpp.

{
    MPISimulation ompi;
    ompi.runSimulation(this);
}

References MPISimulation::runSimulation().

Here is the call graph for this function:

runSimulation()

void ISimulation::runSimulation ( )

inherited

Run a simulation, possibly averaged over parameter distributions.

Run simulation with possible averaging over parameter distributions.

Definition at line 193 of file ISimulation.cpp.

{
    prepareSimulation();
 
    const size_t total_size = numberOfSimulationElements();
    size_t param_combinations = m_distribution_handler.getTotalNumberOfSamples();
 
    m_progress.reset();
    m_progress.setExpectedNTicks(param_combinations * total_size);
 
    // restrict calculation to current batch
    const size_t n_batches = m_options.getNumberOfBatches();
    const size_t current_batch = m_options.getCurrentBatch();
 
    const size_t batch_start = getStartIndex(n_batches, current_batch, total_size);
    const size_t batch_size = getNumberOfElements(n_batches, current_batch, total_size);
    if (batch_size == 0)
        return;
 
    if(param_combinations == 1)
        runSingleSimulation(batch_start, batch_size, 1.);
    else{
        std::unique_ptr<ParameterPool> param_pool(createParameterTree());
        for (size_t index = 0; index < param_combinations; ++index) {
            double weight = m_distribution_handler.setParameterValues(param_pool.get(), index);
            runSingleSimulation(batch_start, batch_size, weight);
        }
        m_distribution_handler.setParameterToMeans(param_pool.get());
    }
    moveDataFromCache();
    transferResultsToIntensityMap();
}

References INode::createParameterTree(), SimulationOptions::getCurrentBatch(), SimulationOptions::getNumberOfBatches(), DistributionHandler::getTotalNumberOfSamples(), ISimulation::m_distribution_handler, ISimulation::m_options, ISimulation::m_progress, ISimulation::moveDataFromCache(), ISimulation::numberOfSimulationElements(), ISimulation::prepareSimulation(), ProgressHandler::reset(), ISimulation::runSingleSimulation(), ProgressHandler::setExpectedNTicks(), DistributionHandler::setParameterToMeans(), DistributionHandler::setParameterValues(), and ISimulation::transferResultsToIntensityMap().

Referenced by JobWorker::start().

Here is the call graph for this function:

runSingleSimulation()

void ISimulation::runSingleSimulation ( size_t  batch_start, size_t  batch_size, double  weight = 1.0  )

privateinherited

Runs a single simulation with fixed parameter values.

If desired, the simulation is run in several threads.

Definition at line 280 of file ISimulation.cpp.

{
    initSimulationElementVector();
 
    const size_t n_threads = m_options.getNumberOfThreads();
    ASSERT(n_threads > 0);
 
    std::vector<std::unique_ptr<IComputation>> computations;
 
    for (size_t i_thread = 0; i_thread < n_threads;
         ++i_thread) { // Distribute computations by threads
        const size_t thread_start = batch_start + getStartIndex(n_threads, i_thread, batch_size);
        const size_t thread_size = getNumberOfElements(n_threads, i_thread, batch_size);
        if (thread_size == 0)
            break;
        computations.push_back(generateSingleThreadedComputation(thread_start, thread_size));
    }
    runComputations(computations);
 
    normalize(batch_start, batch_size);
    addBackgroundIntensity(batch_start, batch_size);
    addDataToCache(weight);
}

References ISimulation::addBackgroundIntensity(), ISimulation::addDataToCache(), ASSERT, ISimulation::generateSingleThreadedComputation(), SimulationOptions::getNumberOfThreads(), ISimulation::initSimulationElementVector(), ISimulation::m_options, and ISimulation::normalize().

Referenced by ISimulation::runSimulation().

Here is the call graph for this function:

sample()

const MultiLayer * ISimulation::sample ( ) const

inherited

Definition at line 238 of file ISimulation.cpp.

{
    return m_sample_provider.sample();
}

References ISimulation::m_sample_provider, and SampleProvider::sample().

Referenced by ISimulation::ISimulation(), DepthProbeSimulation::generateSingleThreadedComputation(), generateSingleThreadedComputation(), SpecularSimulation::generateSingleThreadedComputation(), ISimulation::setSample(), and DepthProbeSimulation::validityCheck().

Here is the call graph for this function:

setBackground()

void ISimulation::setBackground ( const IBackground &  bg )

inherited

Definition at line 248 of file ISimulation.cpp.

{
    m_background.reset(bg.clone());
    registerChild(m_background.get());
}

References IBackground::clone(), ISimulation::m_background, and INode::registerChild().

Referenced by ISimulation::ISimulation(), and StandardSimulations::ConstantBackgroundGISAS().

Here is the call graph for this function:

setDetector()

void ISimulation2D::setDetector

(

const IDetector2D &

detector

)

Sets the detector (axes can be overwritten later)

Definition at line 94 of file ISimulation2D.cpp.

{
    instrument().setDetector(detector);
    initUnitConverter();
}

References ISimulation::detector(), initUnitConverter(), ISimulation::instrument(), and Instrument::setDetector().

Here is the call graph for this function:

setDetectorParameters()

void ISimulation2D::setDetectorParameters	(	size_t	n_phi,
		double	phi_min,
		double	phi_max,
		size_t	n_alpha,
		double	alpha_min,
		double	alpha_max
	)

Sets spherical detector parameters using angle ranges.

Parameters

n_phi	number of phi-axis bins
phi_min	low edge of first phi-bin
phi_max	upper edge of last phi-bin
n_alpha	number of alpha-axis bins
alpha_min	low edge of first alpha-bin
alpha_max	upper edge of last alpha-bin

Definition at line 87 of file ISimulation2D.cpp.

{
    detector2D().setDetectorParameters(n_x, x_min, x_max, n_y, y_min, y_max);
    updateIntensityMap();
}

References detector2D(), IDetector2D::setDetectorParameters(), and ISimulation::updateIntensityMap().

Referenced by StandardSimulations::MiniGISASFit().

Here is the call graph for this function:

setDetectorResolutionFunction()

void ISimulation::setDetectorResolutionFunction ( const IResolutionFunction2D &  resolution_function )

inherited

Definition at line 177 of file ISimulation.cpp.

{
    detector().setResolutionFunction(resolution_function);
}

References ISimulation::detector(), and IDetector::setResolutionFunction().

Referenced by StandardSimulations::MiniGISASDetectorResolution().

Here is the call graph for this function:

setInstrument()

void ISimulation::setInstrument ( const Instrument &  instrument_ )

inherited

Definition at line 158 of file ISimulation.cpp.

{
    m_instrument = instrument_;
    updateIntensityMap();
}

References ISimulation::m_instrument, and ISimulation::updateIntensityMap().

Here is the call graph for this function:

setName()

void IParametricComponent::setName ( const std::string &  name )

inlineinherited

Definition at line 69 of file IParametricComponent.h.

{ m_name = name; }

References IParametricComponent::m_name, and RealSpace::Particles::name().

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

Here is the call graph for this function:

setOptions()

void ISimulation::setOptions ( const SimulationOptions &  options )

inlineinherited

Definition at line 90 of file ISimulation.h.

{ m_options = options; }

References ISimulation::m_options, and ISimulation::options().

Here is the call graph for this function:

setParameterValue()

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

inherited

Definition at line 65 of file IParametricComponent.cpp.

{
    if (name.find('*') == std::string::npos && name.find('/') == std::string::npos) {
        m_pool->setParameterValue(name, value);
    } else {
        std::unique_ptr<ParameterPool> P_pool{createParameterTree()};
        if (name.find('*') != std::string::npos)
            P_pool->setMatchedParametersValue(name, value);
        else
            P_pool->setParameterValue(name, value);
    }
}

References IParametricComponent::createParameterTree(), IParametricComponent::m_pool, RealSpace::Particles::name(), and ParameterPool::setMatchedParametersValue().

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

Here is the call graph for this function:

setParent()

void INode::setParent ( const INode *  newParent )

virtualinherited

Reimplemented in SampleProvider.

Definition at line 79 of file INode.cpp.

{
    m_parent = newParent;
}

References INode::m_parent.

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

setRawResults()

void ISimulation2D::setRawResults ( const std::vector< double > &  raw_data )

overrideprivatevirtual

Implements ISimulation.

Definition at line 189 of file ISimulation2D.cpp.

{
    initSimulationElementVector();
    if (raw_data.size() != m_sim_elements.size())
        throw std::runtime_error("ISimulation2D::setRawResults: size of vector passed as "
                                 "argument doesn't match number of elements in this simulation");
    for (unsigned i = 0; i < raw_data.size(); i++)
        m_sim_elements[i].setIntensity(raw_data[i]);
    transferResultsToIntensityMap();
}

References ISimulation::initSimulationElementVector(), m_sim_elements, and ISimulation::transferResultsToIntensityMap().

Here is the call graph for this function:

setRegionOfInterest()

void ISimulation2D::setRegionOfInterest	(	double	xlow,
		double	ylow,
		double	xup,
		double	yup
	)

Sets rectangular region of interest with lower left and upper right corners defined.

Definition at line 70 of file ISimulation2D.cpp.

{
    detector2D().setRegionOfInterest(xlow, ylow, xup, yup);
}

References detector2D(), and IDetector2D::setRegionOfInterest().

Referenced by StandardSimulations::RectDetWithRoi(), and StandardSimulations::SphericalDetWithRoi().

Here is the call graph for this function:

setSample()

void ISimulation::setSample ( const MultiLayer &  sample )

inherited

The MultiLayer object will not be owned by the ISimulation object.

Definition at line 233 of file ISimulation.cpp.

{
    m_sample_provider.setSample(sample);
}

References ISimulation::m_sample_provider, ISimulation::sample(), and SampleProvider::setSample().

Referenced by ISimulation::ISimulation().

Here is the call graph for this function:

setSampleBuilder()

void ISimulation::setSampleBuilder ( const std::shared_ptr< ISampleBuilder > &  sample_builder )

inherited

Definition at line 243 of file ISimulation.cpp.

{
    m_sample_provider.setBuilder(sample_builder);
}

References ISimulation::m_sample_provider, and SampleProvider::setBuilder().

Here is the call graph for this function:

setTerminalProgressMonitor()

void ISimulation::setTerminalProgressMonitor ( )

inherited

Initializes a progress monitor that prints to stdout.

Definition at line 166 of file ISimulation.cpp.

{
    m_progress.subscribe([](size_t percentage_done) -> bool {
        if (percentage_done < 100)
            std::cout << std::setprecision(2) << "\r... " << percentage_done << "%" << std::flush;
        else // wipe out
            std::cout << "\r... 100%\n";
        return true;
    });
}

References ISimulation::m_progress, and ProgressHandler::subscribe().

Here is the call graph for this function:

setVectorValue()

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

inherited

Definition at line 78 of file IParametricComponent.cpp.

{
    setParameterValue(XComponentName(base_name), value.x());
    setParameterValue(YComponentName(base_name), value.y());
    setParameterValue(ZComponentName(base_name), value.z());
}

References ModelView::Utils::base_name(), IParametricComponent::setParameterValue(), BasicVector3D< T >::x(), IParametricComponent::XComponentName(), BasicVector3D< T >::y(), IParametricComponent::YComponentName(), BasicVector3D< T >::z(), and IParametricComponent::ZComponentName().

Here is the call graph for this function:

subscribe()

void ISimulation::subscribe ( ProgressHandler::Callback_t  inform )

inlineinherited

Definition at line 94 of file ISimulation.h.

{ m_progress.subscribe(inform); }

References ISimulation::m_progress, and ProgressHandler::subscribe().

Referenced by JobWorker::start().

Here is the call graph for this function:

transferResultsToIntensityMap()

virtual void ISimulation::transferResultsToIntensityMap ( )

inlineprotectedvirtualinherited

Creates the appropriate data structure (e.g.

2D intensity map) from the calculated SimulationElement objects

Reimplemented in OffSpecularSimulation.

Definition at line 114 of file ISimulation.h.

{}

Referenced by ISimulation::runSimulation(), setRawResults(), and SpecularSimulation::setRawResults().

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 52 of file INode.cpp.

{
    return NodeUtils::nodeToString(this);
}

References NodeUtils::nodeToString().

Here is the call graph for this function:

updateIntensityMap()

virtual void ISimulation::updateIntensityMap ( )

inlineprotectedvirtualinherited

Reimplemented in OffSpecularSimulation.

Definition at line 119 of file ISimulation.h.

{}

Referenced by setDetectorParameters(), and ISimulation::setInstrument().

validateParametrization()

virtual void ISimulation::validateParametrization ( const ParameterDistribution &  ) const

inlineprivatevirtualinherited

Checks the distribution validity for simulation.

Reimplemented in SpecularSimulation, OffSpecularSimulation, and DepthProbeSimulation.

Definition at line 139 of file ISimulation.h.

{}

Referenced by ISimulation::addParameterDistribution().

XComponentName()

std::string IParametricComponent::XComponentName ( const std::string &  base_name )

staticinherited

Definition at line 103 of file IParametricComponent.cpp.

{
    return base_name + "X";
}

References ModelView::Utils::base_name().

Referenced by Lattice3D::initialize(), IParticle::registerPosition(), IParametricComponent::registerVector(), IParametricComponent::removeVector(), IParametricComponent::setVectorValue(), and VectorParameterTranslator::translate().

Here is the call graph for this function:

YComponentName()

std::string IParametricComponent::YComponentName ( const std::string &  base_name )

staticinherited

Definition at line 108 of file IParametricComponent.cpp.

{
    return base_name + "Y";
}

References ModelView::Utils::base_name().

Referenced by IParametricComponent::registerVector(), IParametricComponent::removeVector(), IParametricComponent::setVectorValue(), and VectorParameterTranslator::translate().

Here is the call graph for this function:

ZComponentName()

std::string IParametricComponent::ZComponentName ( const std::string &  base_name )

staticinherited

Definition at line 113 of file IParametricComponent.cpp.

{
    return base_name + "Z";
}

References ModelView::Utils::base_name().

Referenced by IParametricComponent::registerVector(), IParametricComponent::removeVector(), IParametricComponent::setVectorValue(), and VectorParameterTranslator::translate().

Here is the call graph for this function:

Member Data Documentation

m_background

std::unique_ptr<IBackground> ISimulation::m_background

privateinherited

Definition at line 161 of file ISimulation.h.

Referenced by ISimulation::ISimulation(), ISimulation::background(), ISimulation::getChildren(), and ISimulation::setBackground().

m_cache

std::vector<double> ISimulation2D::m_cache

protected

Definition at line 99 of file ISimulation2D.h.

Referenced by addDataToCache(), GISASSimulation::initSimulationElementVector(), OffSpecularSimulation::initSimulationElementVector(), and moveDataFromCache().

m_detector_context

std::unique_ptr<DetectorContext> ISimulation2D::m_detector_context

private

Definition at line 104 of file ISimulation2D.h.

Referenced by generateSimulationElements(), numberOfSimulationElements(), and prepareSimulation().

m_distribution_handler

DistributionHandler ISimulation::m_distribution_handler

privateinherited

Definition at line 159 of file ISimulation.h.

Referenced by ISimulation::addParameterDistribution(), ISimulation::getDistributionHandler(), and ISimulation::runSimulation().

m_instrument

Instrument ISimulation::m_instrument

privateinherited

Definition at line 160 of file ISimulation.h.

Referenced by ISimulation::beam(), ISimulation::detector(), ISimulation::getDetector(), ISimulation::initialize(), ISimulation::instrument(), and ISimulation::setInstrument().

m_name

std::string IParametricComponent::m_name

privateinherited

Definition at line 73 of file IParametricComponent.h.

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

m_NP

const size_t INode::m_NP

protectedinherited

Definition at line 88 of file INode.h.

Referenced by INode::INode().

m_options

SimulationOptions ISimulation::m_options

privateinherited

Definition at line 156 of file ISimulation.h.

Referenced by ISimulation::getOptions(), ISimulation::options(), ISimulation::runSimulation(), ISimulation::runSingleSimulation(), and ISimulation::setOptions().

m_P

std::vector<double> INode::m_P

protectedinherited

Definition at line 89 of file INode.h.

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

m_parent

const INode* INode::m_parent {nullptr}

privateinherited

Definition at line 83 of file INode.h.

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

m_pool

std::unique_ptr<ParameterPool> IParametricComponent::m_pool

privateinherited

parameter pool (kind of pointer-to-implementation)

Definition at line 74 of file IParametricComponent.h.

Referenced by IParametricComponent::createParameterTree(), IParametricComponent::parameter(), IParametricComponent::parameterPool(), IParametricComponent::registerParameter(), IParametricComponent::removeParameter(), and IParametricComponent::setParameterValue().

m_progress

ProgressHandler ISimulation::m_progress

privateinherited

Definition at line 157 of file ISimulation.h.

Referenced by ISimulation::progress(), ISimulation::runSimulation(), ISimulation::setTerminalProgressMonitor(), and ISimulation::subscribe().

m_sample_provider

SampleProvider ISimulation::m_sample_provider

privateinherited

Definition at line 158 of file ISimulation.h.

Referenced by ISimulation::getChildren(), ISimulation::initialize(), ISimulation::prepareSimulation(), ISimulation::sample(), ISimulation::setSample(), and ISimulation::setSampleBuilder().

m_sim_elements

std::vector<SimulationElement> ISimulation2D::m_sim_elements

protected

Definition at line 98 of file ISimulation2D.h.

Referenced by addBackgroundIntensity(), addDataToCache(), generateSingleThreadedComputation(), GISASSimulation::initSimulationElementVector(), OffSpecularSimulation::initSimulationElementVector(), moveDataFromCache(), normalize(), rawResults(), GISASSimulation::result(), setRawResults(), OffSpecularSimulation::transferDetectorImage(), and OffSpecularSimulation::transferResultsToIntensityMap().

---

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

• /home/www/ba/Core/Simulation/ISimulation2D.h
• /home/www/ba/Core/Simulation/ISimulation2D.cpp