Used to create a PLMD::Action that has some scalar or vectorial output that may or may not have some derivatives. More...
#include <ActionWithValue.h>
Public Types | |
typedef std::vector< Action * > | Dependencies |
typedef std::set< FILE * >::iterator | files_iterator |
Public Member Functions | |
void | addValue () |
Add a value with the name label. More... | |
void | addValueWithDerivatives () |
Add a value with the name label that has derivatives. More... | |
void | setNotPeriodic () |
Set your default value to have no periodicity. More... | |
void | setPeriodic (const std::string &min, const std::string &max) |
Set the value to be periodic with a particular domain. More... | |
void | addComponent (const std::string &name) |
Add a value with a name like label.name. More... | |
void | addComponentWithDerivatives (const std::string &name) |
Add a value with a name like label.name that has derivatives. More... | |
void | componentIsNotPeriodic (const std::string &name) |
Set your value component to have no periodicity. More... | |
void | componentIsPeriodic (const std::string &name, const std::string &min, const std::string &max) |
Set the value to be periodic with a particular domain. More... | |
ActionWithValue (const ActionOptions &ao) | |
~ActionWithValue () | |
bool | doNotCalculateDerivatives () const |
Are we not calculating derivatives. More... | |
double | getOutputQuantity (const unsigned j) const |
Get the value of one of the components of the PLMD::Action. More... | |
double | getOutputQuantity (const std::string &name) const |
Get the value with a specific name (N.B. if there is no such value this returns zero) More... | |
bool | exists (const std::string &name) const |
Check if a value with a particular name is present. More... | |
Value * | copyOutput (const std::string &name) const |
Return a pointer to the value with name (this is used to retrieve values in other PLMD::Actions) You should NEVER use this routine to refer to the components of your PLMD::Action. More... | |
Value * | copyOutput (const unsigned &n) const |
Return a pointer to the value with this number (this is used to retrieve values in other PLMD::Actions) You should NEVER use this routine to refer to the components of your PLMD::Action. More... | |
std::string | getComponentsList () const |
get a string that contains all the available components More... | |
std::vector< std::string > | getComponentsVector () const |
get a vector that contains the label for all the components More... | |
int | getNumberOfComponents () const |
Returns the number of values defined. More... | |
void | clearInputForces () |
Clear the forces on the values. More... | |
virtual void | clearDerivatives () |
Clear the derivatives of values wrt parameters. More... | |
void | setGradientsIfNeeded () |
Calculate the gradients and store them for all the values (need for projections) More... | |
void | setValue (Value *, double) |
Set the value. More... | |
bool | checkNumericalDerivatives () const |
Check if numerical derivatives should be used. More... | |
void | useNumericalDerivatives () |
This forces the class to use numerical derivatives. More... | |
virtual void | checkFieldsAllowed () |
virtual unsigned | getNumberOfDerivatives ()=0 |
virtual void | turnOnDerivatives () |
Activate the calculation of derivatives. More... | |
bool | checkUpdate () const |
Check if action should be updated. More... | |
void | addDependency (Action *) |
Specify that this Action depends on another one. More... | |
void | clearDependencies () |
Clear the dependence list for this Action. More... | |
long int | getStep () const |
Return the present timestep. More... | |
double | getTime () const |
Return the present time. More... | |
double | getTimeStep () const |
Return the timestep. More... | |
bool | getRestart () const |
Return true if we are doing a restart. More... | |
template<class T > | |
void | parse (const std::string &key, T &t) |
Parse one keyword as generic type. More... | |
template<class T > | |
bool | parseNumbered (const std::string &key, const int no, T &t) |
Parse one numbered keyword as generic type. More... | |
template<class T > | |
void | parseVector (const std::string &key, std::vector< T > &t) |
Parse one keyword as std::vector. More... | |
template<class T > | |
bool | parseNumberedVector (const std::string &key, const int no, std::vector< T > &t) |
Parse a vector with a number. More... | |
void | parseFlag (const std::string &key, bool &t) |
Parse one keyword as boolean flag. More... | |
void | error (const std::string &msg) const |
Crash calculation and print documentation. More... | |
void | warning (const std::string &msg) |
Issue a warning. More... | |
void | exit (int c=0) |
Exit with error code c. More... | |
void | checkRead () |
Check if Action was properly read. More... | |
virtual void | prepare () |
Prepare an Action for calculation This can be used by Action if they need some special preparation before calculation. More... | |
virtual void | lockRequests () |
virtual void | unlockRequests () |
virtual void | calculate ()=0 |
Calculate an Action. More... | |
virtual void | apply ()=0 |
Apply an Action. More... | |
virtual void | update () |
Update. More... | |
virtual void | runFinalJobs () |
RunFinalJobs This method is called once at the very end of the calculation. More... | |
void | fflush () |
Tell to the Action to flush open files. More... | |
virtual std::string | getDocumentation () const |
const std::string & | getLabel () const |
Returns the label. More... | |
const std::string & | getName () const |
Returns the name. More... | |
virtual void | activate () |
Set action to active. More... | |
virtual void | setOption (const std::string &s) |
virtual void | clearOptions () |
virtual void | deactivate () |
Set action to inactive. More... | |
bool | isActive () const |
Check if action is active. More... | |
bool | isOptionOn (const std::string &s) const |
Check if an option is on. More... | |
const Dependencies & | getDependencies () const |
Return dependencies. More... | |
virtual bool | checkNeedsGradients () const |
Check if the action needs gradient. More... | |
virtual void | calculateNumericalDerivatives (ActionWithValue *a=NULL) |
Perform calculation using numerical derivatives N.B. More... | |
FILE * | fopen (const char *path, const char *mode) |
Opens a file. More... | |
int | fclose (FILE *fp) |
Closes a file opened with Action::fclose(). More... | |
void | calculateFromPDB (const PDB &) |
Calculate the action given a pdb file as input. More... | |
virtual void | readAtomsFromPDB (const PDB &) |
This is overwritten in ActionAtomistic so that we can read the atoms from the pdb input file rather than taking them from the MD code. More... | |
bool | getExchangeStep () const |
Check if we are on an exchange step. More... | |
std::string | cite (const std::string &s) |
Cite a paper see PlumedMain::cite. More... | |
Static Public Member Functions | |
static void | registerKeywords (Keywords &keys) |
Register all the relevant keywords for the action. More... | |
static void | noAnalyticalDerivatives (Keywords &keys) |
Insist that numerical derivatives should always be used for an action and make this fact appear in the manual. More... | |
static void | componentsAreNotOptional (Keywords &keys) |
Puts a message into the manual that the components always output. More... | |
static void | useCustomisableComponents (Keywords &keys) |
The components in the action will depend on the user. More... | |
Public Attributes | |
PlumedMain & | plumed |
Reference to main plumed object. More... | |
Log & | log |
Reference to the log stream. More... | |
std::set< FILE * > | files |
Communicator & | comm |
Communicator & | multi_sim_comm |
const Keywords & | keywords |
Protected Member Functions | |
Value * | getPntrToValue () |
Get a pointer to the default value. More... | |
void | setValue (const double &d) |
Set the default value (the one without name) More... | |
Value * | getPntrToComponent (int i) |
Return a pointer to the component by index. More... | |
Value * | getPntrToComponent (const std::string &name) |
Return a pointer to the value by name. More... | |
Private Member Functions | |
int | getComponent (const std::string &name) const |
Return the index for the component named name. More... | |
Private Attributes | |
std::vector< Value * > | values |
An array containing the values for this action. More... | |
bool | noderiv |
Are we skipping the calculation of the derivatives. More... | |
bool | numericalDerivatives |
Are we using numerical derivatives to differentiate. More... | |
Used to create a PLMD::Action that has some scalar or vectorial output that may or may not have some derivatives.
This is used for PLMD::Bias, PLMD::Colvar and PLMD::Function
The vast majority of the PLMD::Action objects that are implemented in plumed calculate some quantity or a set of quantities. This could be the value of a CV, the value of a function or the potential due to a bias. PLMD::ActionWithValue provides the functionality for storing these quantities and (in tandem with PLMD::ActionWithArguments) the functionality for passing quantities between PLMD::Actions. When you are deciding what quantities your new PLMD::Action will need to store using PLMD::ActionWithValue you must ask yourself the following two questions:
If the answer to the first of these questions is yes then you must setup your values you using either PLMD::ActionWithValue::addValueWithDerivatives() or PLMD::ActionWithValue::addComponentWithDerivatives. If the answer is no you can set up values using PLMD::ActionWithValue::addValue() or PLMD::ActionWithValue::addComponent(). The precise routine you use to setup your values will depend on your answer to the second question. As you are probably aware if the output of your PLMD::Action is a single quantity you can reference that quantity in the input file using the label of the PLMD::Action it was calculated in. If your action outputs only one quantity we call that quantity the value of the Action. To set the value and get pointers to it you should use the set of routines that have the word value in the name . If, by contrast, your PLMD::Action calculates multiple quantities then these quantities are referenced in input using the label.component syntax. We refer to these multiple quantities the components of the PLMD::Action. Perhaps unsurprisingly, when you manipulate the components of an PLMD::Action you should use the routines with the word component in the name.
|
inherited |
|
inherited |
|
explicit |
PLMD::ActionWithValue::~ActionWithValue | ( | ) |
|
virtualinherited |
Set action to active.
void PLMD::ActionWithValue::addComponent | ( | const std::string & | name | ) |
Add a value with a name like label.name.
void PLMD::ActionWithValue::addComponentWithDerivatives | ( | const std::string & | name | ) |
Add a value with a name like label.name that has derivatives.
|
inherited |
Specify that this Action depends on another one.
void PLMD::ActionWithValue::addValue | ( | ) |
Add a value with the name label.
void PLMD::ActionWithValue::addValueWithDerivatives | ( | ) |
Add a value with the name label that has derivatives.
|
pure virtualinherited |
Apply an Action.
This method is called one time per step. The set of all Actions is applied in backward order.
Implemented in PLMD::mapping::PCAVars, PLMD::generic::WrapAround, PLMD::analysis::Analysis, PLMD::generic::Group, PLMD::generic::DumpAtoms, PLMD::generic::EffectiveEnergyDrift, PLMD::multicolvar::MultiColvarBase, PLMD::generic::WholeMolecules, PLMD::generic::DumpMassCharge, PLMD::generic::FitToTemplate, PLMD::multicolvar::Sprint, PLMD::mapping::Mapping, PLMD::IMD, PLMD::secondarystructure::SecondaryStructureRMSD, PLMD::generic::RandomExchanges, PLMD::generic::Read, PLMD::multicolvar::DumpMultiColvar, PLMD::multicolvar::MultiColvarDensity, PLMD::generic::Print, PLMD::multicolvar::BridgedMultiColvarFunction, PLMD::generic::Include, PLMD::analysis::Committor, PLMD::generic::Flush, PLMD::generic::DumpDerivatives, PLMD::generic::DumpForces, PLMD::manyrestraints::ManyRestraintsBase, PLMD::generic::Debug, PLMD::Colvar, PLMD::generic::Time, PLMD::bias::Bias, PLMD::generic::DumpProjections, PLMD::function::Function, PLMD::ActionWithVirtualAtom, and PLMD::ActionSetup.
|
pure virtualinherited |
Calculate an Action.
This method is called one or more times per step. The set of all Actions is calculated in forward order.
Implemented in PLMD::bias::MetaD, PLMD::bias::PBMetaD, PLMD::function::FuncSumHills, PLMD::mapping::PCAVars, PLMD::function::Matheval, PLMD::generic::WrapAround, PLMD::function::FuncPathMSD, PLMD::analysis::Analysis, PLMD::RDC, PLMD::bias::ExtendedLagrangian, PLMD::generic::Group, PLMD::colvar::Distance, PLMD::generic::DumpAtoms, PLMD::bias::MovingRestraint, PLMD::generic::EffectiveEnergyDrift, PLMD::generic::WholeMolecules, PLMD::bias::External, PLMD::generic::DumpMassCharge, PLMD::generic::FitToTemplate, PLMD::colvar::Gyration, PLMD::bias::ABMD, PLMD::colvar::Angle, PLMD::colvar::ContactMap, PLMD::colvar::DRMSD, PLMD::function::Combine, PLMD::bias::BiasValue, PLMD::colvar::NOE, PLMD::IMD, PLMD::vatom::Center, PLMD::secondarystructure::SecondaryStructureRMSD, PLMD::generic::Read, PLMD::generic::RandomExchanges, PLMD::multicolvar::MultiColvarFunction, PLMD::function::Piecewise, PLMD::colvar::PathMSDBase, PLMD::colvar::Position, PLMD::multicolvar::DumpMultiColvar, PLMD::colvar::Torsion, PLMD::multicolvar::MultiColvarDensity, PLMD::bias::LWalls, PLMD::bias::UWalls, PLMD::vatom::COM, PLMD::generic::Include, PLMD::generic::Print, PLMD::bias::Restraint, PLMD::analysis::Committor, PLMD::generic::Flush, PLMD::colvar::Energy, PLMD::multicolvar::MultiColvar, PLMD::function::Sort, PLMD::multicolvar::BridgedMultiColvarFunction, PLMD::generic::DumpDerivatives, PLMD::colvar::Constant, PLMD::generic::DumpForces, PLMD::function::Ensemble, PLMD::generic::Debug, PLMD::colvar::Dipole, PLMD::colvar::Puckering, PLMD::manyrestraints::ManyRestraintsBase, PLMD::vatom::Ghost, PLMD::colvar::Cell, PLMD::colvar::ColvarFake, PLMD::colvar::Volume, PLMD::function::Target, PLMD::colvar::Template, PLMD::generic::Time, PLMD::generic::DumpProjections, PLMD::colvar::MultiRMSD, PLMD::colvar::RMSD, PLMD::colvar::PCARMSD, PLMD::colvar::CoordinationBase, PLMD::ActionSetup, and PLMD::mapping::PathBase.
|
inherited |
Calculate the action given a pdb file as input.
This is used to initialize things like distance from a point in CV map space given a pdb as an input file
|
virtualinherited |
Perform calculation using numerical derivatives N.B.
only pass an ActionWithValue to this routine if you know exactly what you are doing.
Reimplemented in PLMD::mapping::PCAVars, PLMD::ActionAtomistic, PLMD::analysis::Analysis, PLMD::multicolvar::MultiColvarFunction, PLMD::ActionWithArguments, PLMD::multicolvar::MultiColvarDensity, PLMD::multicolvar::BridgedMultiColvarFunction, PLMD::mapping::Mapping, and PLMD::vesselbase::ActionWithInputVessel.
|
inlinevirtual |
Reimplemented in PLMD::colvar::ContactMap.
|
inlinevirtualinherited |
Check if the action needs gradient.
Reimplemented in PLMD::bias::MetaD, and PLMD::generic::DumpProjections.
|
inlinevirtual |
Check if numerical derivatives should be used.
Reimplemented from PLMD::Action.
|
inherited |
Check if Action was properly read.
This checks if Action::line is empty. It must be called after a final Action has been initialized
|
inherited |
Check if action should be updated.
|
inherited |
Cite a paper see PlumedMain::cite.
|
inherited |
Clear the dependence list for this Action.
|
virtual |
Clear the derivatives of values wrt parameters.
Reimplemented in PLMD::multicolvar::BridgedMultiColvarFunction, and PLMD::manyrestraints::ManyRestraintsBase.
void PLMD::ActionWithValue::clearInputForces | ( | ) |
Clear the forces on the values.
|
virtualinherited |
void PLMD::ActionWithValue::componentIsNotPeriodic | ( | const std::string & | name | ) |
Set your value component to have no periodicity.
void PLMD::ActionWithValue::componentIsPeriodic | ( | const std::string & | name, |
const std::string & | min, | ||
const std::string & | max | ||
) |
Set the value to be periodic with a particular domain.
|
static |
Puts a message into the manual that the components always output.
Value * PLMD::ActionWithValue::copyOutput | ( | const std::string & | name | ) | const |
Return a pointer to the value with name (this is used to retrieve values in other PLMD::Actions) You should NEVER use this routine to refer to the components of your PLMD::Action.
Use getPntrToComponent instead.
Value * PLMD::ActionWithValue::copyOutput | ( | const unsigned & | n | ) | const |
Return a pointer to the value with this number (this is used to retrieve values in other PLMD::Actions) You should NEVER use this routine to refer to the components of your PLMD::Action.
Use getPntrToComponent instead.
|
inlinevirtualinherited |
Set action to inactive.
|
inline |
Are we not calculating derivatives.
|
inherited |
Crash calculation and print documentation.
bool PLMD::ActionWithValue::exists | ( | const std::string & | name | ) | const |
Check if a value with a particular name is present.
This is only used in PLMD::ActionWithArguments. You should not use it when manipulating components.
|
inherited |
Exit with error code c.
|
inherited |
Closes a file opened with Action::fclose().
|
inherited |
Tell to the Action to flush open files.
|
inherited |
Opens a file.
This is similar to plain fopen, but with some extra functionality.
|
private |
Return the index for the component named name.
std::string PLMD::ActionWithValue::getComponentsList | ( | ) | const |
get a string that contains all the available components
std::vector< std::string > PLMD::ActionWithValue::getComponentsVector | ( | ) | const |
get a vector that contains the label for all the components
|
inlineinherited |
Return dependencies.
|
virtualinherited |
|
inherited |
Check if we are on an exchange step.
|
inlineinherited |
Returns the label.
|
inlineinherited |
Returns the name.
|
inline |
Returns the number of values defined.
|
pure virtual |
Implemented in PLMD::mapping::PCAVars, PLMD::multicolvar::MultiColvarBase, PLMD::generic::Read, PLMD::mapping::Mapping, PLMD::secondarystructure::SecondaryStructureRMSD, PLMD::Colvar, PLMD::colvar::Energy, PLMD::multicolvar::BridgedMultiColvarFunction, PLMD::generic::Time, PLMD::bias::Bias, PLMD::function::Function, and PLMD::manyrestraints::ManyRestraintsBase.
|
inline |
Get the value of one of the components of the PLMD::Action.
|
inline |
Get the value with a specific name (N.B. if there is no such value this returns zero)
|
protected |
Return a pointer to the component by index.
|
protected |
Return a pointer to the value by name.
|
protected |
Get a pointer to the default value.
|
inlineinherited |
Return true if we are doing a restart.
|
inherited |
Return the present timestep.
|
inherited |
Return the present time.
|
inherited |
Return the timestep.
|
inlineinherited |
Check if action is active.
|
inlineinherited |
Check if an option is on.
|
inlinevirtualinherited |
Reimplemented in PLMD::mapping::PCAVars, PLMD::ActionAtomistic, PLMD::analysis::Analysis, PLMD::ActionWithArguments, and PLMD::mapping::Mapping.
|
static |
Insist that numerical derivatives should always be used for an action and make this fact appear in the manual.
|
inherited |
Parse one keyword as generic type.
|
inherited |
Parse one keyword as boolean flag.
|
inherited |
Parse one numbered keyword as generic type.
|
inherited |
Parse a vector with a number.
|
inherited |
Parse one keyword as std::vector.
|
virtualinherited |
Prepare an Action for calculation This can be used by Action if they need some special preparation before calculation.
Typical case is for collective variables which would like to change their list of requested atoms. By default (if not overridden) does nothing.
Reimplemented in PLMD::function::FuncPathMSD, PLMD::analysis::Analysis, PLMD::mapping::Mapping, PLMD::secondarystructure::SecondaryStructureRMSD, PLMD::generic::Read, PLMD::generic::Print, PLMD::colvar::Energy, and PLMD::colvar::CoordinationBase.
|
inlinevirtualinherited |
This is overwritten in ActionAtomistic so that we can read the atoms from the pdb input file rather than taking them from the MD code.
Reimplemented in PLMD::ActionAtomistic.
|
static |
Register all the relevant keywords for the action.
|
inlinevirtualinherited |
RunFinalJobs This method is called once at the very end of the calculation.
The set of all Actions in run for the final time in forward order.
Reimplemented in PLMD::analysis::Analysis.
void PLMD::ActionWithValue::setGradientsIfNeeded | ( | ) |
Calculate the gradients and store them for all the values (need for projections)
void PLMD::ActionWithValue::setNotPeriodic | ( | ) |
Set your default value to have no periodicity.
|
virtualinherited |
void PLMD::ActionWithValue::setPeriodic | ( | const std::string & | min, |
const std::string & | max | ||
) |
Set the value to be periodic with a particular domain.
|
inlineprotected |
Set the default value (the one without name)
void PLMD::ActionWithValue::setValue | ( | Value * | , |
double | |||
) |
Set the value.
|
virtual |
Activate the calculation of derivatives.
Reimplemented in PLMD::bias::ExtendedLagrangian, PLMD::multicolvar::MultiColvarBase, PLMD::generic::Read, PLMD::secondarystructure::SecondaryStructureRMSD, PLMD::mapping::Mapping, PLMD::crystallization::DFSClustering, PLMD::crystallization::DFSClusterDiameter, and PLMD::bias::Bias.
|
inlinevirtualinherited |
Reimplemented in PLMD::mapping::PCAVars, PLMD::ActionAtomistic, PLMD::analysis::Analysis, PLMD::ActionWithArguments, and PLMD::mapping::Mapping.
|
inlinevirtualinherited |
Update.
This method is called one time per step. The set of all Actions is updated in forward order.
Reimplemented in PLMD::bias::MetaD, PLMD::bias::PBMetaD, PLMD::analysis::Analysis, PLMD::bias::ExtendedLagrangian, PLMD::multicolvar::VolumeCavity, PLMD::generic::DumpAtoms, PLMD::generic::EffectiveEnergyDrift, PLMD::generic::DumpMassCharge, PLMD::generic::Read, PLMD::multicolvar::DumpMultiColvar, PLMD::multicolvar::MultiColvarDensity, PLMD::generic::Print, PLMD::generic::Flush, PLMD::generic::DumpDerivatives, PLMD::generic::DumpForces, PLMD::multicolvar::VolumeTetrapore, and PLMD::generic::DumpProjections.
|
static |
The components in the action will depend on the user.
|
inline |
This forces the class to use numerical derivatives.
|
inherited |
Issue a warning.
|
inherited |
|
inherited |
|
inherited |
|
inherited |
Reference to the log stream.
|
inherited |
|
private |
Are we skipping the calculation of the derivatives.
|
private |
Are we using numerical derivatives to differentiate.
|
inherited |
Reference to main plumed object.
|
private |
An array containing the values for this action.
Hosted by GitHub | 1.8.10 |