| 1 | 
/* | 
| 2 | 
 * Copyright (C) 2000-2004  Object Oriented Parallel Simulation Engine (OOPSE) project | 
| 3 | 
 *  | 
| 4 | 
 * Contact: oopse@oopse.org | 
| 5 | 
 *  | 
| 6 | 
 * This program is free software; you can redistribute it and/or | 
| 7 | 
 * modify it under the terms of the GNU Lesser General Public License | 
| 8 | 
 * as published by the Free Software Foundation; either version 2.1 | 
| 9 | 
 * of the License, or (at your option) any later version. | 
| 10 | 
 * All we ask is that proper credit is given for our work, which includes | 
| 11 | 
 * - but is not limited to - adding the above copyright notice to the beginning | 
| 12 | 
 * of your source code files, and to any copyright notice that you may distribute | 
| 13 | 
 * with programs based on this work. | 
| 14 | 
 *  | 
| 15 | 
 * This program is distributed in the hope that it will be useful, | 
| 16 | 
 * but WITHOUT ANY WARRANTY; without even the implied warranty of | 
| 17 | 
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the | 
| 18 | 
 * GNU Lesser General Public License for more details. | 
| 19 | 
 *  | 
| 20 | 
 * You should have received a copy of the GNU Lesser General Public License | 
| 21 | 
 * along with this program; if not, write to the Free Software | 
| 22 | 
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA. | 
| 23 | 
 * | 
| 24 | 
 */ | 
| 25 | 
 | 
| 26 | 
/** | 
| 27 | 
 * @file SquareMatrix3.hpp | 
| 28 | 
 * @author Teng Lin | 
| 29 | 
 * @date 10/11/2004 | 
| 30 | 
 * @version 1.0 | 
| 31 | 
 */ | 
| 32 | 
#ifndef MATH_SQUAREMATRIX#_HPP | 
| 33 | 
#define  MATH_SQUAREMATRIX#_HPP | 
| 34 | 
 | 
| 35 | 
#include "SquareMatrix.hpp" | 
| 36 | 
namespace oopse { | 
| 37 | 
 | 
| 38 | 
    template<typename Real> | 
| 39 | 
    class SquareMatrix3 : public SquareMatrix<Real, 3> { | 
| 40 | 
        public: | 
| 41 | 
             | 
| 42 | 
            /** default constructor */ | 
| 43 | 
            SquareMatrix3() : SquareMatrix<Real, 3>() { | 
| 44 | 
            } | 
| 45 | 
 | 
| 46 | 
            /** copy  constructor */ | 
| 47 | 
            SquareMatrix3(const SquareMatrix<Real, 3>& m)  : SquareMatrix<Real, 3>(m) { | 
| 48 | 
            } | 
| 49 | 
 | 
| 50 | 
            /** copy assignment operator */ | 
| 51 | 
            SquareMatrix3<Real>& operator =(const SquareMatrix<Real, 3>& m) { | 
| 52 | 
                if (this == &m) | 
| 53 | 
                    return *this; | 
| 54 | 
                 SquareMatrix<Real, 3>::operator=(m); | 
| 55 | 
            } | 
| 56 | 
 | 
| 57 | 
            /** | 
| 58 | 
             * Sets this matrix to a rotation matrix by three euler angles | 
| 59 | 
             * @ param euler | 
| 60 | 
             */ | 
| 61 | 
            void setupRotMat(const Vector3d& euler); | 
| 62 | 
 | 
| 63 | 
            /** | 
| 64 | 
             * Sets this matrix to a rotation matrix by three euler angles | 
| 65 | 
             * @param phi | 
| 66 | 
             * @param theta | 
| 67 | 
             * @psi theta | 
| 68 | 
             */ | 
| 69 | 
            void setupRotMat(double phi, double theta, double psi); | 
| 70 | 
 | 
| 71 | 
 | 
| 72 | 
            /** | 
| 73 | 
             * Sets this matrix to a rotation matrix by quaternion | 
| 74 | 
             * @param quat | 
| 75 | 
            */ | 
| 76 | 
            void setupRotMat(const Vector4d& quat); | 
| 77 | 
 | 
| 78 | 
            /** | 
| 79 | 
             * Sets this matrix to a rotation matrix by quaternion | 
| 80 | 
             * @param q0 | 
| 81 | 
             * @param q1 | 
| 82 | 
             * @param q2 | 
| 83 | 
             * @parma q3 | 
| 84 | 
            */ | 
| 85 | 
            void setupRotMat(double q0, double q1, double q2, double q4); | 
| 86 | 
 | 
| 87 | 
            /** | 
| 88 | 
             * Returns the quaternion from this rotation matrix | 
| 89 | 
             * @return the quaternion from this rotation matrix | 
| 90 | 
             * @exception invalid rotation matrix | 
| 91 | 
            */             | 
| 92 | 
            Quaternion rotMatToQuat(); | 
| 93 | 
 | 
| 94 | 
            /** | 
| 95 | 
             * Returns the euler angles from this rotation matrix | 
| 96 | 
             * @return the quaternion from this rotation matrix | 
| 97 | 
             * @exception invalid rotation matrix | 
| 98 | 
            */             | 
| 99 | 
            Vector3d rotMatToEuler(); | 
| 100 | 
             | 
| 101 | 
            /** | 
| 102 | 
             * Sets the value of this matrix to  the inversion of itself.  | 
| 103 | 
             * @note since simple algorithm can be applied to inverse the 3 by 3 matrix, we hide the  | 
| 104 | 
             * implementation of inverse in SquareMatrix class | 
| 105 | 
             */ | 
| 106 | 
            void  inverse(); | 
| 107 | 
 | 
| 108 | 
            void diagonalize(); | 
| 109 | 
 | 
| 110 | 
    } | 
| 111 | 
 | 
| 112 | 
    }; | 
| 113 | 
 | 
| 114 | 
} | 
| 115 | 
#endif // MATH_SQUAREMATRIX#_HPP |