/* Portions copyright (c) 2009-2014 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 "ReferenceCustomManyParticleIxn.h" #include "ReferenceTabulatedFunction.h" #include "openmm/internal/CustomManyParticleForceImpl.h" #include "lepton/CustomFunction.h" using namespace OpenMM; using namespace std; ReferenceCustomManyParticleIxn::ReferenceCustomManyParticleIxn(const CustomManyParticleForce& force) : useCutoff(false), usePeriodic(false) { numParticlesPerSet = force.getNumParticlesPerSet(); numPerParticleParameters = force.getNumPerParticleParameters(); centralParticleMode = (force.getPermutationMode() == CustomManyParticleForce::UniqueCentralParticle); // Create custom functions for the tabulated functions. map functions; for (int i = 0; i < (int) force.getNumTabulatedFunctions(); i++) functions[force.getTabulatedFunctionName(i)] = createReferenceTabulatedFunction(force.getTabulatedFunction(i)); // Parse the expression and create the object used to calculate the interaction. map > distances; map > angles; map > dihedrals; Lepton::ParsedExpression energyExpr = CustomManyParticleForceImpl::prepareExpression(force, functions, distances, angles, dihedrals); energyExpression = energyExpr.createProgram(); vector particleParameterNames; if (force.getNonbondedMethod() != CustomManyParticleForce::NoCutoff) setUseCutoff(force.getCutoffDistance()); // Delete the custom functions. for (map::iterator iter = functions.begin(); iter != functions.end(); iter++) delete iter->second; // Differentiate the energy to get expressions for the force. particleParamNames.resize(numParticlesPerSet); for (int i = 0; i < numParticlesPerSet; i++) { stringstream xname, yname, zname; xname << 'x' << (i+1); yname << 'y' << (i+1); zname << 'z' << (i+1); particleTerms.push_back(ReferenceCustomManyParticleIxn::ParticleTermInfo(xname.str(), i, 0, energyExpr.differentiate(xname.str()).optimize().createProgram())); particleTerms.push_back(ReferenceCustomManyParticleIxn::ParticleTermInfo(yname.str(), i, 1, energyExpr.differentiate(yname.str()).optimize().createProgram())); particleTerms.push_back(ReferenceCustomManyParticleIxn::ParticleTermInfo(zname.str(), i, 2, energyExpr.differentiate(zname.str()).optimize().createProgram())); for (int j = 0; j < numPerParticleParameters; j++) { stringstream paramname; paramname << force.getPerParticleParameterName(j) << (i+1); particleParamNames[i].push_back(paramname.str()); } } for (map >::const_iterator iter = distances.begin(); iter != distances.end(); ++iter) distanceTerms.push_back(ReferenceCustomManyParticleIxn::DistanceTermInfo(iter->first, iter->second, energyExpr.differentiate(iter->first).optimize().createProgram())); for (map >::const_iterator iter = angles.begin(); iter != angles.end(); ++iter) angleTerms.push_back(ReferenceCustomManyParticleIxn::AngleTermInfo(iter->first, iter->second, energyExpr.differentiate(iter->first).optimize().createProgram())); for (map >::const_iterator iter = dihedrals.begin(); iter != dihedrals.end(); ++iter) dihedralTerms.push_back(ReferenceCustomManyParticleIxn::DihedralTermInfo(iter->first, iter->second, energyExpr.differentiate(iter->first).optimize().createProgram())); // Record exclusions. exclusions.resize(force.getNumParticles()); for (int i = 0; i < (int) force.getNumExclusions(); i++) { int p1, p2; force.getExclusionParticles(i, p1, p2); exclusions[p1].insert(p2); exclusions[p2].insert(p1); } // Record information about type filters. CustomManyParticleForceImpl::buildFilterArrays(force, numTypes, particleTypes, orderIndex, particleOrder); } ReferenceCustomManyParticleIxn::~ReferenceCustomManyParticleIxn() { } void ReferenceCustomManyParticleIxn::calculateIxn(vector& atomCoordinates, RealOpenMM** particleParameters, const map& globalParameters, vector& forces, RealOpenMM* totalEnergy) const { map variables = globalParameters; vector particles(numParticlesPerSet); loopOverInteractions(particles, 0, atomCoordinates, particleParameters, variables, forces, totalEnergy); } void ReferenceCustomManyParticleIxn::setUseCutoff(RealOpenMM distance) { useCutoff = true; cutoffDistance = distance; } void ReferenceCustomManyParticleIxn::setPeriodic(RealVec* vectors) { assert(useCutoff); assert(vectors[0][0] >= 2.0*cutoffDistance); assert(vectors[1][1] >= 2.0*cutoffDistance); assert(vectors[2][2] >= 2.0*cutoffDistance); usePeriodic = true; periodicBoxVectors[0] = vectors[0]; periodicBoxVectors[1] = vectors[1]; periodicBoxVectors[2] = vectors[2]; } void ReferenceCustomManyParticleIxn::loopOverInteractions(vector& particles, int loopIndex, vector& atomCoordinates, RealOpenMM** particleParameters, map& variables, vector& forces, RealOpenMM* totalEnergy) const { int numParticles = atomCoordinates.size(); int firstPartialLoop = (centralParticleMode ? 2 : 1); int start = (loopIndex < firstPartialLoop ? 0 : particles[loopIndex-1]+1); for (int i = start; i < numParticles; i++) { if (loopIndex > 0 && i == particles[0]) continue; particles[loopIndex] = i; if (loopIndex == numParticlesPerSet-1) calculateOneIxn(particles, atomCoordinates, particleParameters, variables, forces, totalEnergy); else loopOverInteractions(particles, loopIndex+1, atomCoordinates, particleParameters, variables, forces, totalEnergy); } } void ReferenceCustomManyParticleIxn::calculateOneIxn(const vector& particles, vector& atomCoordinates, RealOpenMM** particleParameters, map& variables, vector& forces, RealOpenMM* totalEnergy) const { // Select the ordering to use for the particles. vector permutedParticles(numParticlesPerSet); if (particleOrder.size() == 1) { // There are no filters, so we don't need to worry about ordering. permutedParticles = particles; } else { int index = 0; for (int i = numParticlesPerSet-1; i >= 0; i--) index = particleTypes[particles[i]]+numTypes*index; int order = orderIndex[index]; if (order == -1) return; for (int i = 0; i < numParticlesPerSet; i++) permutedParticles[i] = particles[particleOrder[order][i]]; } // Decide whether to include this interaction. for (int i = 0; i < numParticlesPerSet; i++) { int p1 = permutedParticles[i]; for (int j = i+1; j < numParticlesPerSet; j++) { int p2 = permutedParticles[j]; if (exclusions[p1].find(p2) != exclusions[p1].end()) return; if (useCutoff && (i == 0 || !centralParticleMode)) { RealOpenMM delta[ReferenceForce::LastDeltaRIndex]; computeDelta(p1, p2, delta, atomCoordinates); if (delta[ReferenceForce::RIndex] >= cutoffDistance) return; } } } // Record per-particle parameters. for (int i = 0; i < numParticlesPerSet; i++) for (int j = 0; j < numPerParticleParameters; j++) variables[particleParamNames[i][j]] = particleParameters[permutedParticles[i]][j]; // Compute all of the variables the energy can depend on. for (int i = 0; i < (int) particleTerms.size(); i++) { const ParticleTermInfo& term = particleTerms[i]; variables[term.name] = atomCoordinates[permutedParticles[term.atom]][term.component]; } for (int i = 0; i < (int) distanceTerms.size(); i++) { const DistanceTermInfo& term = distanceTerms[i]; computeDelta(permutedParticles[term.p1], permutedParticles[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(permutedParticles[term.p1], permutedParticles[term.p2], term.delta1, atomCoordinates); computeDelta(permutedParticles[term.p3], permutedParticles[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(permutedParticles[term.p2], permutedParticles[term.p1], term.delta1, atomCoordinates); computeDelta(permutedParticles[term.p2], permutedParticles[term.p3], term.delta2, atomCoordinates); computeDelta(permutedParticles[term.p4], permutedParticles[term.p3], term.delta3, atomCoordinates); RealOpenMM dotDihedral, signOfDihedral; RealOpenMM* crossProduct[] = {term.cross1, term.cross2}; variables[term.name] = ReferenceBondIxn::getDihedralAngleBetweenThreeVectors(term.delta1, term.delta2, term.delta3, crossProduct, &dotDihedral, term.delta1, &signOfDihedral, 1); } // Apply forces based on individual particle coordinates. for (int i = 0; i < (int) particleTerms.size(); i++) { const ParticleTermInfo& term = particleTerms[i]; forces[permutedParticles[term.atom]][term.component] -= term.forceExpression.evaluate(variables); } // Apply forces based on distances. for (int i = 0; i < (int) distanceTerms.size(); i++) { const DistanceTermInfo& term = distanceTerms[i]; RealOpenMM dEdR = (RealOpenMM) (term.forceExpression.evaluate(variables)/(term.delta[ReferenceForce::RIndex])); for (int i = 0; i < 3; i++) { RealOpenMM force = -dEdR*term.delta[i]; forces[permutedParticles[term.p1]][i] -= force; forces[permutedParticles[term.p2]][i] += force; } } // Apply forces based on angles. for (int i = 0; i < (int) angleTerms.size(); i++) { const AngleTermInfo& term = angleTerms[i]; RealOpenMM dEdTheta = (RealOpenMM) term.forceExpression.evaluate(variables); RealOpenMM thetaCross[ReferenceForce::LastDeltaRIndex]; SimTKOpenMMUtilities::crossProductVector3(term.delta1, term.delta2, thetaCross); RealOpenMM lengthThetaCross = SQRT(DOT3(thetaCross, thetaCross)); if (lengthThetaCross < 1.0e-06) lengthThetaCross = (RealOpenMM) 1.0e-06; RealOpenMM termA = dEdTheta/(term.delta1[ReferenceForce::R2Index]*lengthThetaCross); RealOpenMM termC = -dEdTheta/(term.delta2[ReferenceForce::R2Index]*lengthThetaCross); RealOpenMM 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[permutedParticles[term.p1]][i] += deltaCrossP[0][i]; forces[permutedParticles[term.p2]][i] += deltaCrossP[1][i]; forces[permutedParticles[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]; RealOpenMM dEdTheta = (RealOpenMM) term.forceExpression.evaluate(variables); RealOpenMM internalF[4][3]; RealOpenMM forceFactors[4]; RealOpenMM normCross1 = DOT3(term.cross1, term.cross1); RealOpenMM normBC = term.delta2[ReferenceForce::RIndex]; forceFactors[0] = (-dEdTheta*normBC)/normCross1; RealOpenMM 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]; RealOpenMM 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[permutedParticles[term.p1]][i] += internalF[0][i]; forces[permutedParticles[term.p2]][i] -= internalF[1][i]; forces[permutedParticles[term.p3]][i] -= internalF[2][i]; forces[permutedParticles[term.p4]][i] += internalF[3][i]; } } // Add the energy if (totalEnergy) *totalEnergy += (RealOpenMM) energyExpression.evaluate(variables); } void ReferenceCustomManyParticleIxn::computeDelta(int atom1, int atom2, RealOpenMM* delta, vector& atomCoordinates) const { if (usePeriodic) ReferenceForce::getDeltaRPeriodic(atomCoordinates[atom1], atomCoordinates[atom2], periodicBoxVectors, delta); else ReferenceForce::getDeltaR(atomCoordinates[atom1], atomCoordinates[atom2], delta); } RealOpenMM ReferenceCustomManyParticleIxn::computeAngle(RealOpenMM* vec1, RealOpenMM* vec2) { RealOpenMM dot = DOT3(vec1, vec2); RealOpenMM cosine = dot/SQRT((vec1[ReferenceForce::R2Index]*vec2[ReferenceForce::R2Index])); RealOpenMM angle; if (cosine >= 1) angle = 0; else if (cosine <= -1) angle = PI_M; else angle = ACOS(cosine); return angle; }