rtcSMat3.h

Go to the documentation of this file.

/*
 * Copyright (C) 2008
 * Robert Bosch LLC
 * Research and Technology Center North America
 * Palo Alto, California
 *
 * All rights reserved.
 *
 *------------------------------------------------------------------------------
 * project ....: Autonomous Technologies
 * file .......: rtcSMat3.h
 * authors ....: Benjamin Pitzer
 * organization: Robert Bosch LLC
 * creation ...: 08/16/2006
 * modified ...: $Date: 2009-01-21 18:19:16 -0800 (Wed, 21 Jan 2009) $
 * changed by .: $Author: benjaminpitzer $
 * revision ...: $Revision: 14 $
 */
#ifndef RTC_SMAT3_H
#define RTC_SMAT3_H

//== INCLUDES ==================================================================
#include "rtc/rtcMath.h"
#include "rtc/rtcVec3.h"
#include "rtc/rtcSMat.h"

//== NAMESPACES ================================================================
namespace rtc {

// Forward declarations
template <class T, int M> class SMat; // MxM Square Matrix
template <class T> class Vec3; // 3d Vector
template <class T> class SMat3; // 3x3 Matrix

template <class T>
class SMat3: public SMat<T,3> {
public:
  // Data
  using SMat<T,3>::x;
  using SMat<T,3>::set;

  // Constructors
  SMat3();
  SMat3(const T* d);
  SMat3(const T diagVal);
  SMat3(const Vec3<T>& diagVec);
  SMat3(const Mat<T,3,3>& m);
  SMat3(const T x11, const T x12, const T x13,
        const T x21, const T x22, const T x23,
        const T x31, const T x32, const T x33);
  SMat3(const Vec3<T>& q0, const Vec3<T>& q1, const Vec3<T>& q2);

  // Casting Operation
  template <class U> SMat3(const Mat<U,3,3>& m);

  // Named Constructors
  static SMat3<T> fromRows(const Vec3<T>& v0, const Vec3<T>& v1, const Vec3<T>& v2);
  static SMat3<T> fromCols(const Vec3<T>& v0, const Vec3<T>& v1, const Vec3<T>& v2);

  // Mutators
  void set(const T x11, const T x12, const T x13,
           const T x21, const T x22, const T x23,
           const T x31, const T x32, const T x33);
  void setRows(const Vec3<T>& v0, const Vec3<T>& v1, const Vec3<T>& v2);
  void setCols(const Vec3<T>& v0, const Vec3<T>& v1, const Vec3<T>& v2);

  // Determinant, inverse, etc.
  T det() const;
  SMat3<T> inverted() const;
  int invert();
};

// Declare a few common typdefs
typedef SMat3<bool> SMat3b;
typedef SMat3<char> SMat3c;
typedef SMat3<unsigned char> SMat3uc;
typedef SMat3<int> SMat3i;
typedef SMat3<float> SMat3f;
typedef SMat3<double> SMat3d;

//==============================================================================
// SMat3<T>
//==============================================================================

// Constructors

template <class T>
inline SMat3<T>::SMat3() {}

template <class T>
inline SMat3<T>::SMat3(const T* d) : SMat<T,3>(d) {}

template <class T>
inline SMat3<T>::SMat3(const T diagVal) : SMat<T,3>(diagVal)  {}

template <class T>
inline SMat3<T>::SMat3(const Vec3<T>& diagVec) : SMat<T,3>(diagVec) { }

template <class T>
inline SMat3<T>::SMat3(const Mat<T,3,3>& m) : SMat<T,3>(m) {}

template <class T>
inline SMat3<T>::SMat3(const T x11, const T x12, const T x13,
                       const T x21, const T x22, const T x23,
                       const T x31, const T x32, const T x33) {
  set(x11, x12, x13, x21, x22, x23, x31, x32, x33);
}

template <class T>
inline SMat3<T>::SMat3(const Vec3<T>& v0, const Vec3<T>& v1,
     const Vec3<T>& v2) {
  setCols(v0,v1,v2);
}

// Casting Operation

template <class T> template <class U>
inline SMat3<T>::SMat3(const Mat<U,3,3>& m) : SMat<T,3>(m) {}

// Named Constructors

template <class T>
inline SMat3<T> SMat3<T>::fromRows(const Vec3<T>& v0, const Vec3<T>& v1,
           const Vec3<T>& v2) {
  SMat3<T> m;
  m.setRows(v0,v1,v2);
  return m;
}

template <class T>
inline SMat3<T> SMat3<T>::fromCols(const Vec3<T>& v0, const Vec3<T>& v1,
           const Vec3<T>& v2) {
  SMat3<T> m;
  m.setCols(v0,v1,v2);
  return m;
}

// Mutators

template <class T>
inline void SMat3<T>::set(const T x11, const T x12, const T x13,
                          const T x21, const T x22, const T x23,
                          const T x31, const T x32, const T x33) {
  x[0] = x11; x[1] = x12; x[2] = x13;
  x[3] = x21; x[4] = x22; x[5] = x23;
  x[6] = x31; x[7] = x32; x[8] = x33;
}

template <class T>
inline void SMat3<T>::setRows(const Vec3<T>& v0, const Vec3<T>& v1,
      const Vec3<T>& v2) {
  setRow(0,v0); setRow(1,v1); setRow(2,v2);
}

template <class T>
inline void SMat3<T>::setCols(const Vec3<T>& v0, const Vec3<T>& v1,
      const Vec3<T>& v2) {
  setCol(0,v0); setCol(1,v1); setCol(2,v2);
}

// Determinant and Inverse

template <class T>
inline  T SMat3<T>::det() const {
  return (x[0]*(x[4]*x[8] - x[7]*x[5]) -
          x[1]*(x[3]*x[8] - x[6]*x[5]) +
          x[2]*(x[3]*x[7] - x[6]*x[4]));
}

template <class T>
inline SMat3<T> SMat3<T>::inverted() const {
  T d = det();
  if (d == 0.0) {
    throw Exception( "SMat3::inverted(): error, can't take inverse of singular matrix.");
  }
  T di = T(1)/d;
  return SMat3<T>((x[4]*x[8] - x[5]*x[7])*di, (x[2]*x[7] - x[1]*x[8])*di,
                  (x[1]*x[5] - x[2]*x[4])*di, (x[5]*x[6] - x[3]*x[8])*di,
                  (x[0]*x[8] - x[2]*x[6])*di, (x[2]*x[3] - x[0]*x[5])*di,
                  (x[3]*x[7] - x[4]*x[6])*di, (x[1]*x[6] - x[0]*x[7])*di,
                  (x[0]*x[4] - x[1]*x[3])*di);
}

template <class T>
inline int SMat3<T>::invert() {
  T d = det();
  if (d == 0.0) {
    throw Exception( "SMat3::inverted(): error, can't take inverse of singular matrix.");
  }
  T di = T(1)/d;
  set((x[4]*x[8] - x[5]*x[7])*di, (x[2]*x[7] - x[1]*x[8])*di,
      (x[1]*x[5] - x[2]*x[4])*di, (x[5]*x[6] - x[3]*x[8])*di,
      (x[0]*x[8] - x[2]*x[6])*di, (x[2]*x[3] - x[0]*x[5])*di,
      (x[3]*x[7] - x[4]*x[6])*di, (x[1]*x[6] - x[0]*x[7])*di,
      (x[0]*x[4] - x[1]*x[3])*di);
  return 0;
}

//==============================================================================
} // namespace rtc
//==============================================================================
#endif // RTC_SMAT3_H defined
//==============================================================================