Inheritance diagram for ObjCryst::RefinablePar:
Public Methods | |
void | XMLOutput (ostream &os, const string &name, int indent=0) const |
XMLOutput to stream in well-formed XML. | |
void | XMLOutput (ostream &os, int indent=0) const |
XMLOutput to stream in well-formed XML. | |
void | XMLInput (istream &is, const XMLCrystTag &tag) |
XMLInput From stream. | |
Destructor & Constructors | |
RefinablePar () | |
Default Constructor. | |
RefinablePar (const string &name, REAL *refPar, const REAL min, const REAL max, const RefParType *type, RefParDerivStepModel derivMode=REFPAR_DERIV_STEP_RELATIVE, const bool hasLimits=true, const bool isFixed=false, const bool isUsed=true, const bool isPeriodic=false, const REAL humanScale=1., REAL period=1.) | |
Constructor. | |
void | Init (const string &name, REAL *refPar, const REAL min, const REAL max, const RefParType *type, RefParDerivStepModel derivMode=REFPAR_DERIV_STEP_RELATIVE, const bool hasLimits=true, const bool isFixed=false, const bool isUsed=true, const bool isPeriodic=false, const REAL humanScale=1., REAL period=1.) |
Constructor. | |
void | CopyAttributes (const RefinablePar &) |
Copy all attributes (limits, flags, etc...) from another RefinablePar object. | |
Access & change the current value of the parameter | |
REAL | GetValue () const |
of the parameter. | |
void | SetValue (const REAL value) |
of the parameter. | |
const REAL & | GetHumanValue () const |
Current value of parameter, scaled if necessary (for angles) to a human-understandable value. | |
void | SetHumanValue (const REAL &) |
Current value of parameter, scaled if necessary (for angles) to a human-understandable value. | |
void | Mutate (const REAL mutateValue) |
Add the given amount to the parameter current value. | |
void | MutateTo (const REAL newValue) |
Change the current value to the given one. | |
General info | |
string | GetName () const |
Get the parameter's name. | |
void | SetName (const string &) |
Set the name of the parameter. It should be unique in the RefinableObj. | |
bool | IsUsed () const |
Is the parameter used (if not, it is simply irrelevant in the model) ? | |
void | SetIsUsed (const bool) |
Is the parameter used (if not, it is simply irrelevant in the model) ? | |
REAL | GetHumanScale () const |
Human scale for this parameter : for angles, this is equal to 180/pi. | |
void | SetHumanScale (const REAL) |
Human scale for this parameter : for angles, this is equal to 180/pi. | |
Min, max values | |
REAL | GetMin () const |
Minimum value allowed (if limited or periodic). | |
void | SetMin (const REAL) |
Set the Minimum value allowed (if limited). | |
REAL | GetHumanMin () const |
Get the minimum value allowed (if limited). | |
void | SetHumanMin (const REAL) |
Set the minimum value allowed (if limited). | |
REAL | GetMax () const |
Get the maximum value allowed (if limited). | |
void | SetMax (const REAL) |
Get the maximum value allowed (if limited). | |
REAL | GetHumanMax () const |
Get the maximum value allowed (if limited). | |
void | SetHumanMax (const REAL) |
Get the maximum value allowed (if limited). | |
REAL | GetPeriod () const |
Get the period (if periodic). | |
void | SetPeriod (const REAL) |
Set the period value (if periodic). | |
Steps during refinement | |
REAL | GetDerivStep () const |
Fixed step to use to compute numerical derivative. | |
void | SetDerivStep (const REAL) |
Fixed step to use to compute numerical derivative. | |
REAL | GetGlobalOptimStep () const |
Maximum step to use during Global Optimization algorithms. | |
void | SetGlobalOptimStep (const REAL) |
Maximum step to use during Global Optimization algorithms. | |
Parameter's Clock | |
void | AssignClock (RefinableObjClock &clock) |
Change Limits | |
void | SetLimitsAbsolute (const REAL min, const REAL max) |
Change the limits for this object, giving absolute new limits. | |
void | SetLimitsRelative (const REAL min, const REAL max) |
Change the limits for this object, giving relative new limits (eg giving -.1 and +.1 will set new limits at the current value + min and current value + max) Thus min should logically be <0 and max >0. | |
void | SetLimitsProportional (const REAL min, const REAL max) |
Change the limits for this object, proportionnaly to the current value. | |
Private Methods | |
void | Click () |
Click the Clock ! to telle the RefinableObj it has been modified. | |
Private Attributes | |
string | mName |
name of the refinable parameter | |
REAL * | mpValue |
Pointer to the refinable value. | |
REAL | mMin |
Hard lower and upper limits. | |
REAL | mMax |
Hard lower and upper limits. | |
bool | mHasLimits |
Does the refinable parameter need limits (min and max) ? | |
bool | mIsFixed |
is the parameter currently fixed ? | |
bool | mIsUsed |
Is the parameter currently used ? | |
bool | mIsPeriodic |
Is the parameter periodic ? If this is the case, then when using the RefinablePar::Mutate() function, if the parameter goes beyond its limits, it will be shifted by the value of its period. | |
REAL | mPeriod |
Period value (if relevant). | |
REAL | mGlobalOptimStep |
Step to use for global method search (simulated annealing,...). | |
REAL | mDerivStep |
Step to use for numerical derivative calculation. | |
RefParDerivStepModel | mRefParDerivStepModel |
Model followed for derivation. | |
REAL | mSigma |
Calculated sigma on value. | |
REAL | mHumanScale |
Scale to be used to display 'human' value. | |
bool | mHasAssignedClock |
Is there a clock associated with this parameter ? If yes, then it must Click() it each time it is modified. |
These must be continuous.
: for complex objects with lots of parameters, give the possibility to define vectors of parameters, all with the same properties, to reduce memory usage.
|
Constructor.
|
|
For internal use only. Assign a clock to this parameter. Any time this parameter is modified, the clock will be ticked ! |
|
Copy all attributes (limits, flags, etc...) from another RefinablePar object. This is useful in RefinableObj copy constructors. Everything is copied but the pointer to the value refined, and the pointer to the clock. |
|
of the parameter. Use the The Mutate() and MutateTo() function to change this value. |
|
Constructor.
|
|
Add the given amount to the parameter current value. If limit is hit, set to limit. If the limit is hit and the parameter is periodic, shift by period to bring back to allowed values.
|
|
Change the current value to the given one. If the limit is hit, then set to the limit (unless the pameter is periodic, then shift by the period amount back to allowed values).
|
|
Change the limits for this object, proportionnaly to the current value. min should be < 1. and max > 1. |
|
of the parameter. Use the The Mutate() and MutateTo() function to change this value. |
|
XMLOutput to stream in well-formed XML. this will save the fixed & limited flags, as well as limits. In this function the name used is that of the RefPar. |
|
XMLOutput to stream in well-formed XML. this will save the fixed & limited flags, as well as limits
|
|
Scale to be used to display 'human' value. This is for angular parameters: the computer stores values in radians, whil the user only understands degrees. So a scale factor of 180/pi is necessary. |