ObjCryst::PowderPatternComponent Class Reference

Generic class to compute components (eg the contribution of a given phase, or background) of a powder pattern. More...

Inheritance diagram for ObjCryst::PowderPatternComponent:

Inheritance graph
[legend]
Collaboration diagram for ObjCryst::PowderPatternComponent:

Collaboration graph
[legend]

List of all members.

Public Member Functions

 PowderPatternComponent (const PowderPatternComponent &)
virtual const string & GetClassName () const
 Name for this class ("RefinableObj", "Crystal",.
const PowderPatternGetParentPowderPattern () const
 Get the PowderPattern object which uses this component.
PowderPatternGetParentPowderPattern ()
 Get the PowderPattern object which uses this component.
virtual void SetParentPowderPattern (PowderPattern &)=0
 Set the PowderPattern object which uses this component.
virtual const CrystVector_REAL & GetPowderPatternCalc () const =0
 Get the calculated powder pattern for this component.
virtual pair< const
CrystVector_REAL *, const
RefinableObjClock * > 
GetPowderPatternIntegratedCalc () const =0
 Get the integrated values of the powder pattern.
bool IsScalable () const
 Is this component scalable ?
virtual const CrystVector_REAL & GetPowderPatternCalcVariance () const =0
 Get the variance associated to each point of the calculated powder pattern, for this component.
virtual pair< const
CrystVector_REAL *, const
RefinableObjClock * > 
GetPowderPatternIntegratedCalcVariance () const =0
 Get the variance associated to each point of the calculated powder pattern, for this component (integrated version).
virtual bool HasPowderPatternCalcVariance () const =0
 Does this component have a variance associated with each calculated point ? i.e., do we use maximum likelihood to take into account incomplete models ?
const RefinableObjClockGetClockPowderPatternCalc () const
 Last time the powder pattern was calculated.
const list< pair< const REAL,const
string > > & 
GetPatternLabelList () const
 Get a list of labels for the pattern (usually reflection indexes).

Protected Member Functions

const RefinableObjClockGetClockPowderPatternCalcVariance () const
 Last time the variance on the pattern was actually calculated.
virtual void CalcPowderPattern () const =0
 Calc the powder pattern.
virtual void CalcPowderPatternIntegrated () const =0
 Calc the integrated powder pattern.
virtual void GetBraggLimits (CrystVector_long *&min, CrystVector_long *&max) const =0
 Get the integration limits (first and last pixels) around each reflection, if this component has Bragg reflections.
const RefinableObjClockGetClockBraggLimits () const
 Get last time the Bragg Limits were changed.
virtual void SetMaxSinThetaOvLambda (const REAL max)=0
 Set the maximum value for sin(theta)/lambda.
virtual void Prepare ()=0

Protected Attributes

CrystVector_REAL mPowderPatternCalc
 The calculated component of a powder pattern.
CrystVector_REAL mPowderPatternIntegratedCalc
 The calculated powder pattern, integrated.
CrystVector_REAL mPowderPatternCalcVariance
 The variance associated to each point of the calculated powder pattern.
CrystVector_REAL mPowderPatternIntegratedCalcVariance
 The variance associated to each point of the calculated powder pattern, integrated.
bool mIsScalable
 Scalable ? (crystal phase = scalable, background= not scalable).
RefinableObjClock mClockPowderPatternCalc
 When was the powder pattern last computed ?
RefinableObjClock mClockPowderPatternIntegratedCalc
 When was the 'integrated' powder pattern last computed ?
RefinableObjClock mClockPowderPatternVarianceCalc
 When was the powder pattern variance last computed ?
RefinableObjClock mClockPowderPatternIntegratedVarianceCalc
 When was the 'integrated' powder pattern variance last computed ?
PowderPatternmpParentPowderPattern
 The PowderPattern object in which this component is included.
RefinableObjClock mClockBraggLimits
 Get last time the Bragg Limits were changed.
list< pair< const REAL,const
string > > 
mvLabel
 The labels associated to different points of the pattern.

Friends

class PowderPattern


Detailed Description

Generic class to compute components (eg the contribution of a given phase, or background) of a powder pattern.

This is an abstract base class.

Most functions are protected, only to be accessed, internally or from the friend class PowderPattern.

Definition at line 47 of file PowderPattern.h.


Member Function Documentation

const string & ObjCryst::PowderPatternComponent::GetClassName (  )  const [virtual]

Name for this class ("RefinableObj", "Crystal",.

..). This is only useful to distinguish different classes when picking up objects from the RefinableObj Global Registry

Reimplemented from ObjCryst::RefinableObj.

Reimplemented in ObjCryst::PowderPatternBackground, and ObjCryst::PowderPatternDiffraction.

Definition at line 92 of file PowderPattern.cpp.

const PowderPattern & ObjCryst::PowderPatternComponent::GetParentPowderPattern (  )  const

Get the PowderPattern object which uses this component.

This allows to know the observed powder pattern to evaluate the background.

Definition at line 98 of file PowderPattern.cpp.

PowderPattern & ObjCryst::PowderPatternComponent::GetParentPowderPattern (  ) 

Get the PowderPattern object which uses this component.

This allows to know the observed powder pattern to evaluate the background.

Definition at line 103 of file PowderPattern.cpp.

virtual void ObjCryst::PowderPatternComponent::SetParentPowderPattern ( PowderPattern  )  [pure virtual]

Set the PowderPattern object which uses this component.

This sets all necessary pattern parameters (2theta/tof range, wavelength, radiation type...) accordingly.

Implemented in ObjCryst::PowderPatternBackground, and ObjCryst::PowderPatternDiffraction.

virtual const CrystVector_REAL& ObjCryst::PowderPatternComponent::GetPowderPatternCalc (  )  const [pure virtual]

Get the calculated powder pattern for this component.

Note that the pattern is not scaled.

Implemented in ObjCryst::PowderPatternBackground, and ObjCryst::PowderPatternDiffraction.

virtual pair<const CrystVector_REAL*,const RefinableObjClock*> ObjCryst::PowderPatternComponent::GetPowderPatternIntegratedCalc (  )  const [pure virtual]

Get the integrated values of the powder pattern.

Note:
: the integration intervals are those given by the parent PowderPattern, so that all PowderPatternComponent's intervals are taken into account
This avoids explicitely calculating the full profile powder pattern.

Implemented in ObjCryst::PowderPatternBackground, and ObjCryst::PowderPatternDiffraction.

bool ObjCryst::PowderPatternComponent::IsScalable (  )  const

Is this component scalable ?

This is used by the PowderPattern class, which fits all pattern components using scale factors. Some components may not need to be scaled: background components, which are assumed to be absolute.

Definition at line 108 of file PowderPattern.cpp.

virtual const CrystVector_REAL& ObjCryst::PowderPatternComponent::GetPowderPatternCalcVariance (  )  const [pure virtual]

Get the variance associated to each point of the calculated powder pattern, for this component.

Warning:
: this is experimental, with the aim of using Maximum Likelihood to improve structure determination.

Implemented in ObjCryst::PowderPatternBackground, and ObjCryst::PowderPatternDiffraction.

virtual pair<const CrystVector_REAL*,const RefinableObjClock*> ObjCryst::PowderPatternComponent::GetPowderPatternIntegratedCalcVariance (  )  const [pure virtual]

Get the variance associated to each point of the calculated powder pattern, for this component (integrated version).

Warning:
: this is experimental, with the aim of using Maximum Likelihood to improve structure determination.

Implemented in ObjCryst::PowderPatternBackground, and ObjCryst::PowderPatternDiffraction.

const list< pair< const REAL, const string > > & ObjCryst::PowderPatternComponent::GetPatternLabelList (  )  const

Get a list of labels for the pattern (usually reflection indexes).

This returns the list generated during the last computation of the powder pattern.

Definition at line 119 of file PowderPattern.cpp.

virtual void ObjCryst::PowderPatternComponent::CalcPowderPattern (  )  const [protected, pure virtual]

Calc the powder pattern.

As always, recomputation is only done if necessary (ie if a parameter has changed since the last computation)

Implemented in ObjCryst::PowderPatternBackground, and ObjCryst::PowderPatternDiffraction.

virtual void ObjCryst::PowderPatternComponent::CalcPowderPatternIntegrated (  )  const [protected, pure virtual]

Calc the integrated powder pattern.

This should be optimized so that the full powder pattern is not explicitely computed.

Implemented in ObjCryst::PowderPatternBackground, and ObjCryst::PowderPatternDiffraction.

virtual void ObjCryst::PowderPatternComponent::GetBraggLimits ( CrystVector_long *&  min,
CrystVector_long *&  max 
) const [protected, pure virtual]

Get the integration limits (first and last pixels) around each reflection, if this component has Bragg reflections.

Used for integrated R(w) factors. The limits currently go from -2*FWHM to +2*FWHM. returns a pointer to the min and max pixels arrays (null pointers if no reflection for this phase).

Implemented in ObjCryst::PowderPatternBackground, and ObjCryst::PowderPatternDiffraction.

virtual void ObjCryst::PowderPatternComponent::SetMaxSinThetaOvLambda ( const REAL  max  )  [protected, pure virtual]

Set the maximum value for sin(theta)/lambda.

All data above still exist but are ignored for all calculations.

Implemented in ObjCryst::PowderPatternBackground, and ObjCryst::PowderPatternDiffraction.

virtual void ObjCryst::PowderPatternComponent::Prepare (  )  [protected, pure virtual]

For internal use only.

This will be called by the parent PowderPattern object, before calculating the first powder pattern. Or maybe it should be called automatically by the object itself...

Reimplemented from ObjCryst::RefinableObj.

Implemented in ObjCryst::PowderPatternBackground, and ObjCryst::PowderPatternDiffraction.


Member Data Documentation

CrystVector_REAL ObjCryst::PowderPatternComponent::mPowderPatternCalc [mutable, protected]

The calculated component of a powder pattern.

It is mutable since it is completely defined by other parameters (eg it is not an 'independent parameter')

Definition at line 141 of file PowderPattern.h.


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

Generated on Fri Apr 4 23:01:57 2008 for FOX/ObjCryst++ by  doxygen 1.5.5