00001 /********************************************************************* 00002 * 00003 * Software License Agreement (BSD License) 00004 * 00005 * Copyright (c) 2011, Willow Garage, Inc. 00006 * All rights reserved. 00007 * 00008 * Redistribution and use in source and binary forms, with or without 00009 * modification, are permitted provided that the following conditions 00010 * are met: 00011 * 00012 * * Redistributions of source code must retain the above copyright 00013 * notice, this list of conditions and the following disclaimer. 00014 * * Redistributions in binary form must reproduce the above 00015 * copyright notice, this list of conditions and the following 00016 * disclaimer in the documentation and/or other materials provided 00017 * with the distribution. 00018 * * Neither the name of Willow Garage, Inc. nor the names of its 00019 * contributors may be used to endorse or promote products derived 00020 * from this software without specific prior written permission. 00021 * 00022 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 00023 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 00024 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 00025 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 00026 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 00027 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 00028 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 00029 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 00030 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 00031 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 00032 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 00033 * POSSIBILITY OF SUCH DAMAGE. 00034 * 00035 * Author: Sebastian Klose 00036 *********************************************************************/ 00037 00038 #ifndef IMU_FILTER_QUATERNION_HELPER_H 00039 #define IMU_FILTER_QUATERNION_HELPER_H 00040 00041 #include <Eigen/Geometry> 00042 00043 #include <imu_filter/utils.h> 00044 00045 namespace imu_filter 00046 { 00047 //* Helper functions for quaternions 00048 namespace quaternion_helper 00049 { 00053 static inline void fromPerturbation( Eigen::Quaterniond & q, const Eigen::Vector3d & omega ) 00054 { 00055 q.w() = 1.0; 00056 q.x() = 0.5 * omega.x(); 00057 q.y() = 0.5 * omega.y(); 00058 q.z() = 0.5 * omega.z(); 00059 } 00060 00064 static inline void recalcWForNormalizedQ( Eigen::Quaterniond & q ) 00065 { 00066 double sqr = utils::square( q.x() ) + utils::square( q.y() ) + utils::square( q.z() ); 00067 00068 if( sqr > 0.9999 ){ 00069 q.coeffs() = -q.coeffs(); 00070 sqr += 0.01; 00071 q.coeffs() /= sqr; 00072 sqr = utils::square( q.x() ) + utils::square( q.y() ) + utils::square( q.z() ); 00073 } 00074 q.w() = sqrt( 1.0 - sqr ); 00075 } 00076 } 00077 } 00078 00079 #endif