This is the abstract base class to use for implementing new CV function, within it there is information as to how to go about implementing a new function.
More...
#include <Function.h>
Public Types | |
typedef std::vector< Action * > | Dependencies |
Public Member Functions | |
Function (const ActionOptions &) | |
virtual | ~Function () |
virtual void | activate () |
Set action to active. More... | |
void | addComponent (const std::string &name) |
Add a value with a name like label.name. More... | |
void | addDependency (Action *) |
Specify that this Action depends on another one. More... | |
void | addForcesOnArguments (const std::vector< double > &forces) |
Add forces to arguments (used in apply) More... | |
void | addValue () |
Add a value with the name label. More... | |
void | apply () override |
Apply an Action. More... | |
virtual void | beforeUpdate () |
Before Update. More... | |
double | bringBackInPbc (int i, double d1) const |
Takes one value and brings it back into the pbc of argument i. More... | |
virtual void | calculate ()=0 |
Calculate an Action. More... | |
void | calculateFromPDB (const PDB &) |
Calculate the action given a pdb file as input. More... | |
void | calculateNumericalDerivatives (ActionWithValue *a=NULL) override |
Calculate the numerical derivatives N.B. More... | |
virtual void | calculateNumericalDerivatives (ActionWithValue *a=NULL) |
Perform calculation using numerical derivatives N.B. More... | |
virtual void | checkFieldsAllowed () |
virtual bool | checkNeedsGradients () const |
Check if the action needs gradient. More... | |
bool | checkNumericalDerivatives () const override |
Check if numerical derivatives should be used. More... | |
void | checkRead () |
Check if Action was properly read. More... | |
bool | checkUpdate () const |
Check if action should be updated. More... | |
std::string | cite (const std::string &s) |
Cite a paper see PlumedMain::cite. More... | |
void | clearDependencies () |
Clear the dependence list for this Action. More... | |
virtual void | clearDerivatives () |
Clear the derivatives of values wrt parameters. More... | |
void | clearInputForces () |
Clear the forces on the values. More... | |
virtual void | clearOptions () |
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... | |
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... | |
virtual void | deactivate () |
Set action to inactive. More... | |
double | difference (int, double, double) const |
Takes the difference taking into account pbc for arg i. More... | |
virtual bool | doNotCalculateDerivatives () const |
Are we not calculating derivatives. More... | |
void | error (const std::string &msg) const |
Crash calculation and print documentation. More... | |
bool | exists (const std::string &name) const |
Check if a value with a particular name is present. More... | |
void | exit (int c=0) |
Exit with error code c. More... | |
int | fclose (FILE *fp) |
Closes a file opened with Action::fclose(). More... | |
void | fflush () |
Tell to the Action to flush open files. More... | |
FILE * | fopen (const char *path, const char *mode) |
Opens a file. More... | |
double | getArgument (const unsigned n) const |
Returns the value of an argument. More... | |
virtual const std::vector< Value * > & | getArguments () const |
Returns an array of pointers to the arguments. 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... | |
bool | getCPT () const |
Return true if we are doing at a checkpoint step. More... | |
const Dependencies & | getDependencies () const |
Return dependencies. More... | |
virtual std::string | getDocumentation () const |
bool | getExchangeStep () const |
Check if we are on an exchange step. More... | |
std::string | getKeyword (const std::string &key) |
Just read one of the keywords and return the whole thing as a string. More... | |
const std::string & | getLabel () const |
Returns the label. More... | |
const std::string & | getName () const |
Returns the name. More... | |
virtual unsigned | getNumberOfArguments () const |
Returns the number of arguments. More... | |
int | getNumberOfComponents () const |
Returns the number of values defined. More... | |
unsigned | getNumberOfDerivatives () override |
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... | |
Value * | getPntrToArgument (const unsigned n) |
Return a pointer to specific argument. More... | |
double | getProjection (unsigned i, unsigned j) const |
Get the scalar product between the gradients of two variables. More... | |
bool | getRestart () const |
Return true if we are doing a restart. 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... | |
void | interpretArgumentList (const std::vector< std::string > &c, std::vector< Value *> &arg) |
Convert a list of argument names into a list of pointers to the values. More... | |
bool | isActive () const |
Check if action is active. More... | |
bool | isOptionOn (const std::string &s) const |
Check if an option is on. More... | |
void | lockRequests () override |
virtual void | lockRequests () |
template<class T > | |
void | parse (const std::string &key, T &t) |
Parse one keyword as generic type. More... | |
void | parseArgumentList (const std::string &key, std::vector< Value *> &args) |
Parse a list of arguments. More... | |
bool | parseArgumentList (const std::string &key, int i, std::vector< Value *> &args) |
Parse a numbered list of arguments. More... | |
void | parseFlag (const std::string &key, bool &t) |
Parse one keyword as boolean flag. 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 > | |
bool | parseNumberedVector (const std::string &key, const int no, std::vector< T > &t) |
Parse a vector with a number. More... | |
template<class T > | |
void | parseVector (const std::string &key, std::vector< T > &t) |
Parse one keyword as std::vector. 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 | 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... | |
void | requestArguments (const std::vector< Value *> &arg) |
Setup the dependencies. More... | |
virtual void | runFinalJobs () |
RunFinalJobs This method is called once at the very end of the calculation. More... | |
void | setGradientsIfNeeded () |
Calculate the gradients and store them for all the values (need for projections) More... | |
void | setNotPeriodic () |
Set your default value to have no periodicity. More... | |
virtual void | setOption (const std::string &s) |
void | setPeriodic (const std::string &min, const std::string &max) |
Set the value to be periodic with a particular domain. More... | |
void | setValue (Value *, double) |
Set the value. More... | |
virtual void | turnOnDerivatives () |
Activate the calculation of derivatives. More... | |
void | unlockRequests () override |
virtual void | unlockRequests () |
virtual void | update () |
Update. More... | |
void | useNumericalDerivatives () |
This forces the class to use numerical derivatives. More... | |
void | warning (const std::string &msg) |
Issue a warning. More... | |
Static Public Member Functions | |
static void | componentsAreNotOptional (Keywords &keys) |
Puts a message into the manual that the components always output. 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 | registerKeywords (Keywords &) |
static void | useCustomisableComponents (Keywords &keys) |
The components in the action will depend on the user. More... | |
Public Attributes | |
Communicator & | comm |
std::set< FILE * > | files |
const Keywords & | keywords |
Log & | log |
Reference to the log stream. More... | |
Communicator & | multi_sim_comm |
PlumedMain & | plumed |
Reference to main plumed object. More... | |
Protected Member Functions | |
void | addComponentWithDerivatives (const std::string &name) |
void | addValueWithDerivatives () |
void | expandArgKeywordInPDB (PDB &pdb) |
This changes the arg keyword in the pdb file. 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... | |
Value * | getPntrToValue () |
Get a pointer to the default value. More... | |
void | setDerivative (int, double) |
void | setDerivative (Value *, int, double) |
void | setValue (const double &d) |
Set the default value (the one without name) More... | |
This is the abstract base class to use for implementing new CV function, within it there is information as to how to go about implementing a new function.
|
inherited |
|
explicit |
|
inlinevirtual |
|
virtualinherited |
Set action to active.
|
inherited |
Add a value with a name like label.name.
|
protected |
|
inherited |
Specify that this Action depends on another one.
|
inherited |
Add forces to arguments (used in apply)
|
inherited |
Add a value with the name label.
|
protected |
|
overridevirtual |
Apply an Action.
This method is called one time per step. The set of all Actions is applied in backward order.
Implements PLMD::Action.
|
inlinevirtualinherited |
Before Update.
This is a special method that is called just before the update() method. It can be used by actions that want to do something irrespectively of the fact that update() is active or not. In other words, this is always called, even when action is not active.
Reimplemented in PLMD::generic::UpdateIf.
|
inlineinherited |
Takes one value and brings it back into the pbc of argument i.
|
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::isdb::CS2Backbone, PLMD::bias::MetaD, PLMD::logmfd::LogMFD, PLMD::ves::VesLinearExpansion, PLMD::bias::PBMetaD, PLMD::isdb::Metainference, PLMD::isdb::EMMI, PLMD::eds::EDS, PLMD::function::FuncPathMSD, PLMD::isdb::RDC, PLMD::piv::PIV, PLMD::function::FuncSumHills, PLMD::generic::FitToTemplate, PLMD::mapping::PCAVars, PLMD::ves::Optimizer, PLMD::ves::BasisFunctions, PLMD::ves::TargetDistribution, PLMD::function::Custom, PLMD::multicolvar::MultiColvarBase, PLMD::bias::MaxEnt, PLMD::generic::Plumed, PLMD::generic::WrapAround, PLMD::isdb::Rescale, PLMD::generic::Include, PLMD::ves::VesDeltaF, PLMD::generic::DumpAtoms, PLMD::isdb::SAXS, PLMD::generic::Group, PLMD::colvar::Dimer, PLMD::maze::OptimizerBias, PLMD::vatom::Center, PLMD::bias::ExtendedLagrangian, PLMD::bias::External, PLMD::colvar::DRMSD, PLMD::colvar::ContactMap, PLMD::colvar::Distance, PLMD::generic::EffectiveEnergyDrift, PLMD::bias::MovingRestraint, PLMD::colvar::ERMSD, PLMD::generic::WholeMolecules, PLMD::function::Target, PLMD::generic::ResetCell, PLMD::generic::DumpMassCharge, PLMD::mapping::AdaptivePath, PLMD::isdb::JCoupling, PLMD::adjmat::Sprint, PLMD::colvar::Torsion, PLMD::colvar::EEFSolv, PLMD::generic::Read, PLMD::analysis::Average, PLMD::analysis::AnalysisBase, PLMD::isdb::Caliber, PLMD::multicolvar::CenterOfMultiColvar, PLMD::vatom::FixedAtom, PLMD::colvar::Gyration, PLMD::bias::ABMD, PLMD::colvar::Angle, PLMD::colvar::PathMSDBase, PLMD::isdb::FretEfficiency, PLMD::ves::OutputFesBias, PLMD::generic::UpdateIf, PLMD::maze::Optimizer, PLMD::multicolvar::DistanceFromContour, PLMD::isdb::PRE, PLMD::ves::OutputBasisFunctions, PLMD::function::Combine, PLMD::generic::Print, PLMD::colvar::Position, PLMD::ves::OutputTargetDistribution, PLMD::function::LocalEnsemble, PLMD::adjmat::OutputCluster, PLMD::bias::BiasValue, PLMD::isdb::NOE, PLMD::colvar::Puckering, PLMD::generic::RandomExchanges, PLMD::secondarystructure::SecondaryStructureRMSD, PLMD::multicolvar::DumpMultiColvar, PLMD::adjmat::ClusterDistribution, PLMD::function::Piecewise, PLMD::bias::LWalls, PLMD::isdb::Select, PLMD::maze::Loss, PLMD::bias::UWalls, PLMD::adjmat::ClusterDiameter, PLMD::analysis::Committor, PLMD::adjmat::ClusterSize, PLMD::colvar::Dipole, PLMD::bias::Restraint, PLMD::colvar::Constant, PLMD::generic::Flush, PLMD::isdb::Selector, PLMD::adjmat::ClusterProperties, PLMD::function::Ensemble, PLMD::colvar::Energy, PLMD::function::Stats, PLMD::multicolvar::BridgedMultiColvarFunction, PLMD::function::Sort, PLMD::generic::DumpDerivatives, PLMD::generic::DumpForces, PLMD::generic::EndPlumed, PLMD::generic::Debug, PLMD::colvar::Template, PLMD::generic::DumpProjections, PLMD::manyrestraints::ManyRestraintsBase, PLMD::vatom::Ghost, PLMD::colvar::Cell, PLMD::adjmat::DumpGraph, PLMD::colvar::ColvarFake, PLMD::colvar::Volume, PLMD::colvar::ExtraCV, PLMD::generic::Time, PLMD::gridtools::ActionWithGrid, PLMD::adjmat::ClusteringBase, PLMD::colvar::MultiRMSD, PLMD::colvar::PCARMSD, PLMD::colvar::RMSD, PLMD::ActionShortcut, PLMD::colvar::CoordinationBase, PLMD::bias::ReweightBase, PLMD::ActionAnyorder, PLMD::ActionSetup, PLMD::gridtools::GridPrintingBase, 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
|
overridevirtualinherited |
Calculate the numerical derivatives N.B.
only pass an ActionWithValue to this routine if you know exactly what you are doing. The default will be correct for the vast majority of cases
Reimplemented from PLMD::Action.
Reimplemented in PLMD::isdb::MetainferenceBase, PLMD::mapping::PCAVars, PLMD::vesselbase::ActionWithAveraging, and PLMD::mapping::Mapping.
|
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::isdb::MetainferenceBase, PLMD::mapping::PCAVars, PLMD::ActionAtomistic, PLMD::multicolvar::MultiColvarBase, PLMD::analysis::AnalysisBase, PLMD::vesselbase::ActionWithAveraging, PLMD::mapping::Mapping, PLMD::multicolvar::DumpMultiColvar, PLMD::ActionWithArguments, PLMD::multicolvar::BridgedMultiColvarFunction, and PLMD::vesselbase::ActionWithInputVessel.
|
inlinevirtualinherited |
Reimplemented in PLMD::piv::PIV, and PLMD::colvar::ContactMap.
|
inlinevirtualinherited |
Check if the action needs gradient.
Reimplemented in PLMD::bias::MetaD, PLMD::bias::PBMetaD, and PLMD::generic::DumpProjections.
|
inlineoverridevirtualinherited |
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.
|
virtualinherited |
Clear the derivatives of values wrt parameters.
Reimplemented in PLMD::multicolvar::BridgedMultiColvarFunction, and PLMD::manyrestraints::ManyRestraintsBase.
|
inherited |
Clear the forces on the values.
|
virtualinherited |
|
inherited |
Set your value component to have no periodicity.
|
inherited |
Set the value to be periodic with a particular domain.
|
staticinherited |
Puts a message into the manual that the components always output.
|
inherited |
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.
|
inherited |
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.
|
inlineinherited |
Takes the difference taking into account pbc for arg i.
|
inlinevirtualinherited |
Are we not calculating derivatives.
Reimplemented in PLMD::multicolvar::MultiColvarBase.
|
inherited |
Crash calculation and print documentation.
|
inherited |
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.
|
protectedinherited |
This changes the arg keyword in the pdb file.
|
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.
|
inlineinherited |
Returns the value of an argument.
|
inlinevirtualinherited |
Returns an array of pointers to the arguments.
|
inherited |
get a string that contains all the available components
|
inherited |
get a vector that contains the label for all the components
|
inherited |
Return true if we are doing at a checkpoint step.
|
inlineinherited |
Return dependencies.
|
virtualinherited |
|
inherited |
Check if we are on an exchange step.
|
inherited |
Just read one of the keywords and return the whole thing as a string.
|
inlineinherited |
Returns the label.
|
inlineinherited |
Returns the name.
|
inlinevirtualinherited |
Returns the number of arguments.
Reimplemented in PLMD::vesselbase::ActionWithAveraging.
|
inlineinherited |
Returns the number of values defined.
|
inlineoverridevirtual |
Implements PLMD::ActionWithValue.
|
inlineinherited |
Get the value of one of the components of the PLMD::Action.
|
inlineinherited |
Get the value with a specific name (N.B. if there is no such value this returns zero)
|
inlineinherited |
Return a pointer to specific argument.
|
protectedinherited |
Return a pointer to the component by index.
|
protectedinherited |
Return a pointer to the value by name.
|
protectedinherited |
Get a pointer to the default value.
|
inherited |
Get the scalar product between the gradients of two variables.
|
inlineinherited |
Return true if we are doing a restart.
|
inherited |
Return the present timestep.
|
inherited |
Return the present time.
|
inherited |
Return the timestep.
|
inherited |
Convert a list of argument names into a list of pointers to the values.
|
inlineinherited |
Check if action is active.
|
inlineinherited |
Check if an option is on.
|
inlineoverridevirtualinherited |
Reimplemented from PLMD::Action.
Reimplemented in PLMD::isdb::MetainferenceBase, PLMD::mapping::PCAVars, PLMD::mapping::Mapping, and PLMD::vesselbase::ActionWithAveraging.
|
inlinevirtualinherited |
|
staticinherited |
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 a list of arguments.
|
inherited |
Parse a numbered list of arguments.
|
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::isdb::EMMI, PLMD::function::FuncPathMSD, PLMD::generic::Plumed, PLMD::multicolvar::MultiColvarBase, PLMD::generic::DumpMassCharge, PLMD::generic::Read, PLMD::maze::Optimizer, PLMD::generic::UpdateIf, PLMD::generic::Print, PLMD::gridtools::ConvertToFES, PLMD::SetupMolInfo, PLMD::colvar::Energy, PLMD::colvar::ExtraCV, 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 |
|
inherited |
Setup the dependencies.
|
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::vesselbase::ActionWithAveraging, PLMD::analysis::AnalysisBase, PLMD::gridtools::ConvertToFES, PLMD::analysis::ReadDissimilarityMatrix, and PLMD::gridtools::GridPrintingBase.
|
inlineprotected |
|
inlineprotected |
|
inherited |
Calculate the gradients and store them for all the values (need for projections)
|
inherited |
Set your default value to have no periodicity.
|
virtualinherited |
|
inherited |
Set the value to be periodic with a particular domain.
|
inlineprotectedinherited |
Set the default value (the one without name)
|
inherited |
Set the value.
|
virtualinherited |
Activate the calculation of derivatives.
Reimplemented in PLMD::eds::EDS, PLMD::analysis::Histogram, PLMD::isdb::MetainferenceBase, PLMD::multicolvar::MultiColvarBase, PLMD::generic::Read, PLMD::mapping::Mapping, PLMD::secondarystructure::SecondaryStructureRMSD, PLMD::adjmat::ClusterDiameter, PLMD::adjmat::ClusterSize, PLMD::multicolvar::BridgedMultiColvarFunction, PLMD::adjmat::ClusterAnalysisBase, PLMD::gridtools::ActionWithGrid, PLMD::adjmat::ClusteringBase, and PLMD::gridtools::ActionWithIntegral.
|
inlineoverridevirtualinherited |
Reimplemented from PLMD::Action.
Reimplemented in PLMD::isdb::MetainferenceBase, PLMD::mapping::PCAVars, PLMD::mapping::Mapping, and PLMD::vesselbase::ActionWithAveraging.
|
inlinevirtualinherited |
|
inlinevirtualinherited |
Update.
This method is called one time per step. The set of all Actions is updated in forward order.
Reimplemented in PLMD::isdb::CS2Backbone, PLMD::bias::MetaD, PLMD::logmfd::LogMFD, PLMD::ves::VesLinearExpansion, PLMD::bias::PBMetaD, PLMD::isdb::Metainference, PLMD::eds::EDS, PLMD::isdb::RDC, PLMD::ves::Optimizer, PLMD::ves::TargetDistribution, PLMD::bias::MaxEnt, PLMD::generic::Plumed, PLMD::ves::VesDeltaF, PLMD::generic::DumpAtoms, PLMD::isdb::SAXS, PLMD::bias::ExtendedLagrangian, PLMD::multicolvar::VolumeTetrapore, PLMD::multicolvar::VolumeCavity, PLMD::generic::EffectiveEnergyDrift, PLMD::mapping::AdaptivePath, PLMD::generic::DumpMassCharge, PLMD::isdb::JCoupling, PLMD::generic::Read, PLMD::analysis::AnalysisBase, PLMD::generic::Print, PLMD::isdb::PRE, PLMD::ves::OutputFesBias, PLMD::vesselbase::ActionWithAveraging, PLMD::adjmat::OutputCluster, PLMD::isdb::NOE, PLMD::multicolvar::DumpMultiColvar, PLMD::generic::Flush, PLMD::generic::DumpDerivatives, PLMD::analysis::ReadDissimilarityMatrix, PLMD::generic::DumpForces, PLMD::generic::DumpProjections, PLMD::adjmat::DumpGraph, PLMD::analysis::ReadAnalysisFrames, and PLMD::gridtools::GridPrintingBase.
|
staticinherited |
The components in the action will depend on the user.
|
inlineinherited |
This forces the class to use numerical derivatives.
|
inherited |
Issue a warning.
|
inherited |
|
inherited |
|
inherited |
|
inherited |
Reference to the log stream.
|
inherited |
|
inherited |
Reference to main plumed object.
Hosted by GitHub | 1.8.14 |