/* -------------------------------------------------------------------------- * * OpenMM * * -------------------------------------------------------------------------- * * This is part of the OpenMM molecular simulation toolkit originating from * * Simbios, the NIH National Center for Physics-Based Simulation of * * Biological Structures at Stanford, funded under the NIH Roadmap for * * Medical Research, grant U54 GM072970. See https://simtk.org. * * * * Portions copyright (c) 2008-2010 Stanford University and the Authors. * * Authors: Peter Eastman * * Contributors: * * * * Permission is hereby granted, free of charge, to any person obtaining a * * copy of this software and associated documentation files (the "Software"), * * to deal in the Software without restriction, including without limitation * * the rights to use, copy, modify, merge, publish, distribute, sublicense, * * and/or sell copies of the Software, and to permit persons to whom the * * Software is furnished to do so, subject to the following conditions: * * * * The above copyright notice and this permission notice shall be included in * * all copies or substantial portions of the Software. * * * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * * THE AUTHORS, CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE * * USE OR OTHER DEALINGS IN THE SOFTWARE. * * -------------------------------------------------------------------------- */ #include "openmm/OpenMMException.h" #include "openmm/internal/ContextImpl.h" #include "openmm/internal/CustomHbondForceImpl.h" #include "openmm/kernels.h" #include "lepton/Operation.h" #include "lepton/Parser.h" #include using namespace OpenMM; using Lepton::CustomFunction; using Lepton::ExpressionTreeNode; using Lepton::Operation; using Lepton::ParsedExpression; using std::map; using std::pair; using std::vector; using std::set; using std::string; using std::stringstream; /** * This class serves as a placeholder for angles and dihedrals in expressions. */ class CustomHbondForceImpl::FunctionPlaceholder : public CustomFunction { public: int numArguments; FunctionPlaceholder(int numArguments) : numArguments(numArguments) { } int getNumArguments() const { return numArguments; } double evaluate(const double* arguments) const { return 0.0; } double evaluateDerivative(const double* arguments, const int* derivOrder) const { return 0.0; } CustomFunction* clone() const { return new FunctionPlaceholder(numArguments); } }; CustomHbondForceImpl::CustomHbondForceImpl(CustomHbondForce& owner) : owner(owner) { } CustomHbondForceImpl::~CustomHbondForceImpl() { } void CustomHbondForceImpl::initialize(ContextImpl& context) { kernel = context.getPlatform().createKernel(CalcCustomHbondForceKernel::Name(), context); // Check for errors in the specification of parameters and exclusions. System& system = context.getSystem(); vector > exclusions(owner.getNumDonors()); vector parameters; int numDonorParameters = owner.getNumPerDonorParameters(); for (int i = 0; i < owner.getNumDonors(); i++) { int d1, d2, d3; owner.getDonorParameters(i, d1, d2, d3, parameters); if (d1 < 0 || d1 >= system.getNumParticles()) { stringstream msg; msg << "CustomHbondForce: Illegal particle index for a donor: "; msg << d1; throw OpenMMException(msg.str()); } if (d2 < -1 || d2 >= system.getNumParticles()) { stringstream msg; msg << "CustomHbondForce: Illegal particle index for a donor: "; msg << d2; throw OpenMMException(msg.str()); } if (d3 < -1 || d3 >= system.getNumParticles()) { stringstream msg; msg << "CustomHbondForce: Illegal particle index for a donor: "; msg << d3; throw OpenMMException(msg.str()); } if (parameters.size() != numDonorParameters) { stringstream msg; msg << "CustomHbondForce: Wrong number of parameters for donor "; msg << i; throw OpenMMException(msg.str()); } } int numAcceptorParameters = owner.getNumPerAcceptorParameters(); for (int i = 0; i < owner.getNumAcceptors(); i++) { int a1, a2, a3; owner.getAcceptorParameters(i, a1, a2, a3, parameters); if (a1 < 0 || a1 >= system.getNumParticles()) { stringstream msg; msg << "CustomHbondForce: Illegal particle index for an acceptor: "; msg << a1; throw OpenMMException(msg.str()); } if (a2 < -1 || a2 >= system.getNumParticles()) { stringstream msg; msg << "CustomHbondForce: Illegal particle index for an acceptor: "; msg << a2; throw OpenMMException(msg.str()); } if (a3 < -1 || a3 >= system.getNumParticles()) { stringstream msg; msg << "CustomHbondForce: Illegal particle index for an acceptor: "; msg << a3; throw OpenMMException(msg.str()); } if (parameters.size() != numAcceptorParameters) { stringstream msg; msg << "CustomHbondForce: Wrong number of parameters for acceptor "; msg << i; throw OpenMMException(msg.str()); } } for (int i = 0; i < owner.getNumExclusions(); i++) { int donor, acceptor; owner.getExclusionParticles(i, donor, acceptor); if (donor < 0 || donor >= owner.getNumDonors()) { stringstream msg; msg << "CustomHbondForce: Illegal donor index for an exclusion: "; msg << donor; throw OpenMMException(msg.str()); } if (acceptor < 0 || acceptor >= owner.getNumAcceptors()) { stringstream msg; msg << "CustomHbondForce: Illegal acceptor index for an exclusion: "; msg << acceptor; throw OpenMMException(msg.str()); } if (exclusions[donor].count(acceptor) > 0) { stringstream msg; msg << "CustomHbondForce: Multiple exclusions are specified for donor "; msg << donor; msg << " and acceptor "; msg << acceptor; throw OpenMMException(msg.str()); } exclusions[donor].insert(acceptor); } if (owner.getNonbondedMethod() == CustomHbondForce::CutoffPeriodic) { Vec3 boxVectors[3]; system.getDefaultPeriodicBoxVectors(boxVectors[0], boxVectors[1], boxVectors[2]); double cutoff = owner.getCutoffDistance(); if (cutoff > 0.5*boxVectors[0][0] || cutoff > 0.5*boxVectors[1][1] || cutoff > 0.5*boxVectors[2][2]) throw OpenMMException("CustomHbondForce: The cutoff distance cannot be greater than half the periodic box size."); } dynamic_cast(kernel.getImpl()).initialize(context.getSystem(), owner); } double CustomHbondForceImpl::calcForcesAndEnergy(ContextImpl& context, bool includeForces, bool includeEnergy, int groups) { if ((groups&(1<(kernel.getImpl()).execute(context, includeForces, includeEnergy); } vector CustomHbondForceImpl::getKernelNames() { vector names; names.push_back(CalcCustomHbondForceKernel::Name()); return names; } map CustomHbondForceImpl::getDefaultParameters() { map parameters; for (int i = 0; i < owner.getNumGlobalParameters(); i++) parameters[owner.getGlobalParameterName(i)] = owner.getGlobalParameterDefaultValue(i); return parameters; } ParsedExpression CustomHbondForceImpl::prepareExpression(const CustomHbondForce& force, const map& customFunctions, map >& distances, map >& angles, map >& dihedrals) { CustomHbondForceImpl::FunctionPlaceholder custom(1); CustomHbondForceImpl::FunctionPlaceholder distance(2); CustomHbondForceImpl::FunctionPlaceholder angle(3); CustomHbondForceImpl::FunctionPlaceholder dihedral(4); map functions = customFunctions; functions["distance"] = &distance; functions["angle"] = ∠ functions["dihedral"] = &dihedral; ParsedExpression expression = Lepton::Parser::parse(force.getEnergyFunction(), functions); map atoms; atoms["a1"] = 0; atoms["a2"] = 1; atoms["a3"] = 2; atoms["d1"] = 3; atoms["d2"] = 4; atoms["d3"] = 5; return ParsedExpression(replaceFunctions(expression.getRootNode(), atoms, distances, angles, dihedrals)).optimize(); } ExpressionTreeNode CustomHbondForceImpl::replaceFunctions(const ExpressionTreeNode& node, map atoms, map >& distances, map >& angles, map >& dihedrals) { const Operation& op = node.getOperation(); if (op.getId() != Operation::CUSTOM || op.getNumArguments() < 2) { // This is not an angle or dihedral, so process its children. vector children; for (int i = 0; i < (int) node.getChildren().size(); i++) children.push_back(replaceFunctions(node.getChildren()[i], atoms, distances, angles, dihedrals)); return ExpressionTreeNode(op.clone(), children); } const Operation::Custom& custom = static_cast(op); // Identify the atoms this term is based on. int numArgs = custom.getNumArguments(); vector indices(numArgs); for (int i = 0; i < numArgs; i++) { map::const_iterator iter = atoms.find(node.getChildren()[i].getOperation().getName()); if (iter == atoms.end()) throw OpenMMException("CustomHBondForce: Unknown particle '"+node.getChildren()[i].getOperation().getName()+"'"); indices[i] = iter->second; } // Select a name for the variable and add it to the appropriate map. stringstream variable; if (numArgs == 2) variable << "distance"; else if (numArgs == 3) variable << "angle"; else variable << "dihedral"; for (int i = 0; i < numArgs; i++) variable << indices[i]; string name = variable.str(); if (numArgs == 2) distances[name] = indices; else if (numArgs == 3) angles[name] = indices; else dihedrals[name] = indices; // Return a new node that represents it as a simple variable. return ExpressionTreeNode(new Operation::Variable(name)); }