/* Portions copyright (c) 2009-2010 Stanford University and Simbios. * Contributors: Peter Eastman * * 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 #include #include #include "SimTKOpenMMUtilities.h" #include "ReferenceForce.h" #include "ReferenceCustomHbondIxn.h" using std::map; using std::pair; using std::set; using std::string; using std::stringstream; using std::vector; using namespace OpenMM; /**--------------------------------------------------------------------------------------- ReferenceCustomHbondIxn constructor --------------------------------------------------------------------------------------- */ ReferenceCustomHbondIxn::ReferenceCustomHbondIxn(const vector >& donorAtoms, const vector >& acceptorAtoms, const Lepton::ParsedExpression& energyExpression, const vector& donorParameterNames, const vector& acceptorParameterNames, const map >& distances, const map >& angles, const map >& dihedrals) : cutoff(false), periodic(false), donorAtoms(donorAtoms), acceptorAtoms(acceptorAtoms), energyExpression(energyExpression.createProgram()), donorParamNames(donorParameterNames), acceptorParamNames(acceptorParameterNames) { for (auto& term : distances) distanceTerms.push_back(ReferenceCustomHbondIxn::DistanceTermInfo(term.first, term.second, energyExpression.differentiate(term.first).optimize().createProgram())); for (auto& term : angles) angleTerms.push_back(ReferenceCustomHbondIxn::AngleTermInfo(term.first, term.second, energyExpression.differentiate(term.first).optimize().createProgram())); for (auto& term : dihedrals) dihedralTerms.push_back(ReferenceCustomHbondIxn::DihedralTermInfo(term.first, term.second, energyExpression.differentiate(term.first).optimize().createProgram())); } /**--------------------------------------------------------------------------------------- ReferenceCustomHbondIxn destructor --------------------------------------------------------------------------------------- */ ReferenceCustomHbondIxn::~ReferenceCustomHbondIxn() { } /**--------------------------------------------------------------------------------------- Set the force to use a cutoff. @param distance the cutoff distance --------------------------------------------------------------------------------------- */ void ReferenceCustomHbondIxn::setUseCutoff(double distance) { cutoff = true; cutoffDistance = distance; } /**--------------------------------------------------------------------------------------- Set the force to use periodic boundary conditions. This requires that a cutoff has also been set, and the smallest side of the periodic box is at least twice the cutoff distance. @param vectors the vectors defining the periodic box --------------------------------------------------------------------------------------- */ void ReferenceCustomHbondIxn::setPeriodic(Vec3* vectors) { assert(cutoff); assert(vectors[0][0] >= 2.0*cutoffDistance); assert(vectors[1][1] >= 2.0*cutoffDistance); assert(vectors[2][2] >= 2.0*cutoffDistance); periodic = true; periodicBoxVectors[0] = vectors[0]; periodicBoxVectors[1] = vectors[1]; periodicBoxVectors[2] = vectors[2]; } /**--------------------------------------------------------------------------------------- Calculate custom hbond interaction @param atomCoordinates atom coordinates @param donorParameters donor parameters values donorParameters[donorIndex][parameterIndex] @param acceptorParameters acceptor parameters values acceptorParameters[acceptorIndex][parameterIndex] @param exclusions exclusion indices exclusions[donorIndex] contains the list of excluded acceptors for that donor @param globalParameters the values of global parameters @param forces force array (forces added) @param totalEnergy total energy --------------------------------------------------------------------------------------- */ void ReferenceCustomHbondIxn::calculatePairIxn(vector& atomCoordinates, double** donorParameters, double** acceptorParameters, vector >& exclusions, const map& globalParameters, vector& forces, double* totalEnergy) const { map variables = globalParameters; // allocate and initialize exclusion array int numDonors = donorAtoms.size(); int numAcceptors = acceptorAtoms.size(); for (int donor = 0; donor < numDonors; donor++) { // Initialize per-donor parameters. for (int j = 0; j < (int) donorParamNames.size(); j++) variables[donorParamNames[j]] = donorParameters[donor][j]; // loop over atom pairs for (int acceptor = 0; acceptor < numAcceptors; acceptor++) { if (exclusions[donor].find(acceptor) == exclusions[donor].end()) { for (int j = 0; j < (int) acceptorParamNames.size(); j++) variables[acceptorParamNames[j]] = acceptorParameters[acceptor][j]; calculateOneIxn(donor, acceptor, atomCoordinates, variables, forces, totalEnergy); } } } } /**--------------------------------------------------------------------------------------- Calculate custom interaction between a donor and an acceptor @param donor the index of the donor @param acceptor the index of the acceptor @param atomCoordinates atom coordinates @param variables the values of variables that may appear in expressions @param forces force array (forces added) @param energyByAtom atom energy @param totalEnergy total energy --------------------------------------------------------------------------------------- */ void ReferenceCustomHbondIxn::calculateOneIxn(int donor, int acceptor, vector& atomCoordinates, map& variables, vector& forces, double* totalEnergy) const { int atoms[6]; atoms[0] = acceptorAtoms[acceptor][0]; atoms[1] = acceptorAtoms[acceptor][1]; atoms[2] = acceptorAtoms[acceptor][2]; atoms[3] = donorAtoms[donor][0]; atoms[4] = donorAtoms[donor][1]; atoms[5] = donorAtoms[donor][2]; // Compute the distance between the primary donor and acceptor atoms, and compare to the cutoff. if (cutoff) { double delta[ReferenceForce::LastDeltaRIndex]; computeDelta(atoms[0], atoms[3], delta, atomCoordinates); if (delta[ReferenceForce::RIndex] >= cutoffDistance) return; } // Compute all of the variables the energy can depend on. for (int i = 0; i < (int) distanceTerms.size(); i++) { const DistanceTermInfo& term = distanceTerms[i]; computeDelta(atoms[term.p1], atoms[term.p2], term.delta, atomCoordinates); variables[term.name] = term.delta[ReferenceForce::RIndex]; } for (int i = 0; i < (int) angleTerms.size(); i++) { const AngleTermInfo& term = angleTerms[i]; computeDelta(atoms[term.p1], atoms[term.p2], term.delta1, atomCoordinates); computeDelta(atoms[term.p3], atoms[term.p2], term.delta2, atomCoordinates); variables[term.name] = computeAngle(term.delta1, term.delta2); } for (int i = 0; i < (int) dihedralTerms.size(); i++) { const DihedralTermInfo& term = dihedralTerms[i]; computeDelta(atoms[term.p2], atoms[term.p1], term.delta1, atomCoordinates); computeDelta(atoms[term.p2], atoms[term.p3], term.delta2, atomCoordinates); computeDelta(atoms[term.p4], atoms[term.p3], term.delta3, atomCoordinates); double dotDihedral, signOfDihedral; double* crossProduct[] = {term.cross1, term.cross2}; variables[term.name] = getDihedralAngleBetweenThreeVectors(term.delta1, term.delta2, term.delta3, crossProduct, &dotDihedral, term.delta1, &signOfDihedral, 1); } // Apply forces based on distances. for (int i = 0; i < (int) distanceTerms.size(); i++) { const DistanceTermInfo& term = distanceTerms[i]; double dEdR = term.forceExpression.evaluate(variables)/(term.delta[ReferenceForce::RIndex]); for (int i = 0; i < 3; i++) { double force = -dEdR*term.delta[i]; forces[atoms[term.p1]][i] -= force; forces[atoms[term.p2]][i] += force; } } // Apply forces based on angles. for (int i = 0; i < (int) angleTerms.size(); i++) { const AngleTermInfo& term = angleTerms[i]; double dEdTheta = term.forceExpression.evaluate(variables); double thetaCross[ReferenceForce::LastDeltaRIndex]; SimTKOpenMMUtilities::crossProductVector3(term.delta1, term.delta2, thetaCross); double lengthThetaCross = sqrt(DOT3(thetaCross, thetaCross)); if (lengthThetaCross < 1.0e-06) lengthThetaCross = 1.0e-06; double termA = dEdTheta/(term.delta1[ReferenceForce::R2Index]*lengthThetaCross); double termC = -dEdTheta/(term.delta2[ReferenceForce::R2Index]*lengthThetaCross); double deltaCrossP[3][3]; SimTKOpenMMUtilities::crossProductVector3(term.delta1, thetaCross, deltaCrossP[0]); SimTKOpenMMUtilities::crossProductVector3(term.delta2, thetaCross, deltaCrossP[2]); for (int i = 0; i < 3; i++) { deltaCrossP[0][i] *= termA; deltaCrossP[2][i] *= termC; deltaCrossP[1][i] = -(deltaCrossP[0][i]+deltaCrossP[2][i]); } for (int i = 0; i < 3; i++) { forces[atoms[term.p1]][i] += deltaCrossP[0][i]; forces[atoms[term.p2]][i] += deltaCrossP[1][i]; forces[atoms[term.p3]][i] += deltaCrossP[2][i]; } } // Apply forces based on dihedrals. for (int i = 0; i < (int) dihedralTerms.size(); i++) { const DihedralTermInfo& term = dihedralTerms[i]; double dEdTheta = term.forceExpression.evaluate(variables); double internalF[4][3]; double forceFactors[4]; double normCross1 = DOT3(term.cross1, term.cross1); double normBC = term.delta2[ReferenceForce::RIndex]; forceFactors[0] = (-dEdTheta*normBC)/normCross1; double normCross2 = DOT3(term.cross2, term.cross2); forceFactors[3] = (dEdTheta*normBC)/normCross2; forceFactors[1] = DOT3(term.delta1, term.delta2); forceFactors[1] /= term.delta2[ReferenceForce::R2Index]; forceFactors[2] = DOT3(term.delta3, term.delta2); forceFactors[2] /= term.delta2[ReferenceForce::R2Index]; for (int i = 0; i < 3; i++) { internalF[0][i] = forceFactors[0]*term.cross1[i]; internalF[3][i] = forceFactors[3]*term.cross2[i]; double s = forceFactors[1]*internalF[0][i] - forceFactors[2]*internalF[3][i]; internalF[1][i] = internalF[0][i] - s; internalF[2][i] = internalF[3][i] + s; } for (int i = 0; i < 3; i++) { forces[atoms[term.p1]][i] += internalF[0][i]; forces[atoms[term.p2]][i] -= internalF[1][i]; forces[atoms[term.p3]][i] -= internalF[2][i]; forces[atoms[term.p4]][i] += internalF[3][i]; } } // Add the energy if (totalEnergy) *totalEnergy += energyExpression.evaluate(variables); } void ReferenceCustomHbondIxn::computeDelta(int atom1, int atom2, double* delta, vector& atomCoordinates) const { if (periodic) ReferenceForce::getDeltaRPeriodic(atomCoordinates[atom1], atomCoordinates[atom2], periodicBoxVectors, delta); else ReferenceForce::getDeltaR(atomCoordinates[atom1], atomCoordinates[atom2], delta); } double ReferenceCustomHbondIxn::computeAngle(double* vec1, double* vec2) { double dot = DOT3(vec1, vec2); double cosine = dot/sqrt((vec1[ReferenceForce::R2Index]*vec2[ReferenceForce::R2Index])); double angle; if (cosine >= 1) angle = 0; else if (cosine <= -1) angle = PI_M; else angle = acos(cosine); return angle; }