btDeformableLagrangianForce.h

Go to the documentation of this file.

/*
 Written by Xuchen Han <xuchenhan2015@u.northwestern.edu>
 
 Bullet Continuous Collision Detection and Physics Library
 Copyright (c) 2019 Google Inc. http://bulletphysics.org
 This software is provided 'as-is', without any express or implied warranty.
 In no event will the authors be held liable for any damages arising from the use of this software.
 Permission is granted to anyone to use this software for any purpose,
 including commercial applications, and to alter it and redistribute it freely,
 subject to the following restrictions:
 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
 3. This notice may not be removed or altered from any source distribution.
 */
 
#ifndef BT_DEFORMABLE_LAGRANGIAN_FORCE_H
#define BT_DEFORMABLE_LAGRANGIAN_FORCE_H
 
#include "btSoftBody.h"
#include <LinearMath/btHashMap.h>
#include <iostream>
 
enum btDeformableLagrangianForceType
{
        BT_GRAVITY_FORCE = 1,
        BT_MASSSPRING_FORCE = 2,
        BT_COROTATED_FORCE = 3,
        BT_NEOHOOKEAN_FORCE = 4,
        BT_LINEAR_ELASTICITY_FORCE = 5,
        BT_MOUSE_PICKING_FORCE = 6
};
 
static inline double randomDouble(double low, double high)
{
        return low + static_cast<double>(rand()) / RAND_MAX * (high - low);
}
 
class btDeformableLagrangianForce
{
public:
        typedef btAlignedObjectArray<btVector3> TVStack;
        btAlignedObjectArray<btSoftBody*> m_softBodies;
        const btAlignedObjectArray<btSoftBody::Node*>* m_nodes;
 
        btDeformableLagrangianForce()
        {
        }
 
        virtual ~btDeformableLagrangianForce() {}
 
        // add all forces
        virtual void addScaledForces(btScalar scale, TVStack& force) = 0;
 
        // add damping df
        virtual void addScaledDampingForceDifferential(btScalar scale, const TVStack& dv, TVStack& df) = 0;
 
        // build diagonal of A matrix
        virtual void buildDampingForceDifferentialDiagonal(btScalar scale, TVStack& diagA) = 0;
 
        // add elastic df
        virtual void addScaledElasticForceDifferential(btScalar scale, const TVStack& dx, TVStack& df) = 0;
 
        // add all forces that are explicit in explicit solve
        virtual void addScaledExplicitForce(btScalar scale, TVStack& force) = 0;
 
        // add all damping forces
        virtual void addScaledDampingForce(btScalar scale, TVStack& force) = 0;
 
        virtual void addScaledHessian(btScalar scale) {}
 
        virtual btDeformableLagrangianForceType getForceType() = 0;
 
        virtual void reinitialize(bool nodeUpdated)
        {
        }
 
        // get number of nodes that have the force
        virtual int getNumNodes()
        {
                int numNodes = 0;
                for (int i = 0; i < m_softBodies.size(); ++i)
                {
                        numNodes += m_softBodies[i]->m_nodes.size();
                }
                return numNodes;
        }
 
        // add a soft body to be affected by the particular lagrangian force
        virtual void addSoftBody(btSoftBody* psb)
        {
                m_softBodies.push_back(psb);
        }
 
        virtual void removeSoftBody(btSoftBody* psb)
        {
                m_softBodies.remove(psb);
        }
 
        virtual void setIndices(const btAlignedObjectArray<btSoftBody::Node*>* nodes)
        {
                m_nodes = nodes;
        }
 
        // Calculate the incremental deformable generated from the input dx
        virtual btMatrix3x3 Ds(int id0, int id1, int id2, int id3, const TVStack& dx)
        {
                btVector3 c1 = dx[id1] - dx[id0];
                btVector3 c2 = dx[id2] - dx[id0];
                btVector3 c3 = dx[id3] - dx[id0];
                return btMatrix3x3(c1, c2, c3).transpose();
        }
 
        // Calculate the incremental deformable generated from the current velocity
        virtual btMatrix3x3 DsFromVelocity(const btSoftBody::Node* n0, const btSoftBody::Node* n1, const btSoftBody::Node* n2, const btSoftBody::Node* n3)
        {
                btVector3 c1 = n1->m_v - n0->m_v;
                btVector3 c2 = n2->m_v - n0->m_v;
                btVector3 c3 = n3->m_v - n0->m_v;
                return btMatrix3x3(c1, c2, c3).transpose();
        }
 
        // test for addScaledElasticForce function
        virtual void testDerivative()
        {
                for (int i = 0; i < m_softBodies.size(); ++i)
                {
                        btSoftBody* psb = m_softBodies[i];
                        for (int j = 0; j < psb->m_nodes.size(); ++j)
                        {
                                psb->m_nodes[j].m_q += btVector3(randomDouble(-.1, .1), randomDouble(-.1, .1), randomDouble(-.1, .1));
                        }
                        psb->updateDeformation();
                }
 
                TVStack dx;
                dx.resize(getNumNodes());
                TVStack dphi_dx;
                dphi_dx.resize(dx.size());
                for (int i = 0; i < dphi_dx.size(); ++i)
                {
                        dphi_dx[i].setZero();
                }
                addScaledForces(-1, dphi_dx);
 
                // write down the current position
                TVStack x;
                x.resize(dx.size());
                int counter = 0;
                for (int i = 0; i < m_softBodies.size(); ++i)
                {
                        btSoftBody* psb = m_softBodies[i];
                        for (int j = 0; j < psb->m_nodes.size(); ++j)
                        {
                                x[counter] = psb->m_nodes[j].m_q;
                                counter++;
                        }
                }
                counter = 0;
 
                // populate dx with random vectors
                for (int i = 0; i < dx.size(); ++i)
                {
                        dx[i].setX(randomDouble(-1, 1));
                        dx[i].setY(randomDouble(-1, 1));
                        dx[i].setZ(randomDouble(-1, 1));
                }
 
                btAlignedObjectArray<double> errors;
                for (int it = 0; it < 10; ++it)
                {
                        for (int i = 0; i < dx.size(); ++i)
                        {
                                dx[i] *= 0.5;
                        }
 
                        // get dphi/dx * dx
                        double dphi = 0;
                        for (int i = 0; i < dx.size(); ++i)
                        {
                                dphi += dphi_dx[i].dot(dx[i]);
                        }
 
                        for (int i = 0; i < m_softBodies.size(); ++i)
                        {
                                btSoftBody* psb = m_softBodies[i];
                                for (int j = 0; j < psb->m_nodes.size(); ++j)
                                {
                                        psb->m_nodes[j].m_q = x[counter] + dx[counter];
                                        counter++;
                                }
                                psb->updateDeformation();
                        }
                        counter = 0;
                        double f1 = totalElasticEnergy(0);
 
                        for (int i = 0; i < m_softBodies.size(); ++i)
                        {
                                btSoftBody* psb = m_softBodies[i];
                                for (int j = 0; j < psb->m_nodes.size(); ++j)
                                {
                                        psb->m_nodes[j].m_q = x[counter] - dx[counter];
                                        counter++;
                                }
                                psb->updateDeformation();
                        }
                        counter = 0;
 
                        double f2 = totalElasticEnergy(0);
 
                        //restore m_q
                        for (int i = 0; i < m_softBodies.size(); ++i)
                        {
                                btSoftBody* psb = m_softBodies[i];
                                for (int j = 0; j < psb->m_nodes.size(); ++j)
                                {
                                        psb->m_nodes[j].m_q = x[counter];
                                        counter++;
                                }
                                psb->updateDeformation();
                        }
                        counter = 0;
                        double error = f1 - f2 - 2 * dphi;
                        errors.push_back(error);
                        std::cout << "Iteration = " << it << ", f1 = " << f1 << ", f2 = " << f2 << ", error = " << error << std::endl;
                }
                for (int i = 1; i < errors.size(); ++i)
                {
                        std::cout << "Iteration = " << i << ", ratio = " << errors[i - 1] / errors[i] << std::endl;
                }
        }
 
        // test for addScaledElasticForce function
        virtual void testHessian()
        {
                for (int i = 0; i < m_softBodies.size(); ++i)
                {
                        btSoftBody* psb = m_softBodies[i];
                        for (int j = 0; j < psb->m_nodes.size(); ++j)
                        {
                                psb->m_nodes[j].m_q += btVector3(randomDouble(-.1, .1), randomDouble(-.1, .1), randomDouble(-.1, .1));
                        }
                        psb->updateDeformation();
                }
 
                TVStack dx;
                dx.resize(getNumNodes());
                TVStack df;
                df.resize(dx.size());
                TVStack f1;
                f1.resize(dx.size());
                TVStack f2;
                f2.resize(dx.size());
 
                // write down the current position
                TVStack x;
                x.resize(dx.size());
                int counter = 0;
                for (int i = 0; i < m_softBodies.size(); ++i)
                {
                        btSoftBody* psb = m_softBodies[i];
                        for (int j = 0; j < psb->m_nodes.size(); ++j)
                        {
                                x[counter] = psb->m_nodes[j].m_q;
                                counter++;
                        }
                }
                counter = 0;
 
                // populate dx with random vectors
                for (int i = 0; i < dx.size(); ++i)
                {
                        dx[i].setX(randomDouble(-1, 1));
                        dx[i].setY(randomDouble(-1, 1));
                        dx[i].setZ(randomDouble(-1, 1));
                }
 
                btAlignedObjectArray<double> errors;
                for (int it = 0; it < 10; ++it)
                {
                        for (int i = 0; i < dx.size(); ++i)
                        {
                                dx[i] *= 0.5;
                        }
 
                        // get df
                        for (int i = 0; i < df.size(); ++i)
                        {
                                df[i].setZero();
                                f1[i].setZero();
                                f2[i].setZero();
                        }
 
                        //set df
                        addScaledElasticForceDifferential(-1, dx, df);
 
                        for (int i = 0; i < m_softBodies.size(); ++i)
                        {
                                btSoftBody* psb = m_softBodies[i];
                                for (int j = 0; j < psb->m_nodes.size(); ++j)
                                {
                                        psb->m_nodes[j].m_q = x[counter] + dx[counter];
                                        counter++;
                                }
                                psb->updateDeformation();
                        }
                        counter = 0;
 
                        //set f1
                        addScaledForces(-1, f1);
 
                        for (int i = 0; i < m_softBodies.size(); ++i)
                        {
                                btSoftBody* psb = m_softBodies[i];
                                for (int j = 0; j < psb->m_nodes.size(); ++j)
                                {
                                        psb->m_nodes[j].m_q = x[counter] - dx[counter];
                                        counter++;
                                }
                                psb->updateDeformation();
                        }
                        counter = 0;
 
                        //set f2
                        addScaledForces(-1, f2);
 
                        //restore m_q
                        for (int i = 0; i < m_softBodies.size(); ++i)
                        {
                                btSoftBody* psb = m_softBodies[i];
                                for (int j = 0; j < psb->m_nodes.size(); ++j)
                                {
                                        psb->m_nodes[j].m_q = x[counter];
                                        counter++;
                                }
                                psb->updateDeformation();
                        }
                        counter = 0;
                        double error = 0;
                        for (int i = 0; i < df.size(); ++i)
                        {
                                btVector3 error_vector = f1[i] - f2[i] - 2 * df[i];
                                error += error_vector.length2();
                        }
                        error = btSqrt(error);
                        errors.push_back(error);
                        std::cout << "Iteration = " << it << ", error = " << error << std::endl;
                }
                for (int i = 1; i < errors.size(); ++i)
                {
                        std::cout << "Iteration = " << i << ", ratio = " << errors[i - 1] / errors[i] << std::endl;
                }
        }
 
        //
        virtual double totalElasticEnergy(btScalar dt)
        {
                return 0;
        }
 
        //
        virtual double totalDampingEnergy(btScalar dt)
        {
                return 0;
        }
 
        // total Energy takes dt as input because certain energies depend on dt
        virtual double totalEnergy(btScalar dt)
        {
                return totalElasticEnergy(dt) + totalDampingEnergy(dt);
        }
};
#endif /* BT_DEFORMABLE_LAGRANGIAN_FORCE */