sliderwheelie.h

Go to the documentation of this file.

/***************************************************************************
 *   Copyright (C) 2005 by Robot Group Leipzig                             *
 *    martius@informatik.uni-leipzig.de                                    *
 *    fhesse@informatik.uni-leipzig.de                                     *
 *    der@informatik.uni-leipzig.de                                        *
 *    frankguettler@gmx.de                                                 *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 *                                                                         *
 *   $Log: sliderwheelie.h,v $
 *   Revision 1.10  2008/09/16 14:53:24  martius
 *   provide a virtual center of the robot as main primitive
 *
 *   Revision 1.9  2007/11/07 13:21:16  martius
 *   doInternal stuff changed signature
 *
 *   Revision 1.8  2007/01/26 12:05:04  martius
 *   servos combinied into OneAxisServo
 *
 *   Revision 1.7  2006/12/21 11:43:05  martius
 *   commenting style for doxygen //< -> ///<
 *   new sensors for spherical robots
 *
 *   Revision 1.6  2006/09/21 22:09:58  martius
 *   collision for mesh
 *
 *   Revision 1.5  2006/09/21 16:17:18  der
 *   *** empty log message ***
 *
 *   Revision 1.4  2006/09/21 08:15:15  martius
 *   with sliders inside a segment
 *
 *   Revision 1.3  2006/07/20 17:19:44  martius
 *   removed using namespace std from matrix.h
 *
 *   Revision 1.2  2006/07/14 12:23:42  martius
 *   selforg becomes HEAD
 *
 *   Revision 1.1.2.3  2006/06/25 21:57:20  martius
 *   abstractrobot is configureable
 *   name and revision
 *
 *   Revision 1.1.2.2  2006/06/20 07:18:29  robot3
 *   -added cvs log
 *   -changed some behaviour of wheelie
 *
 *                                                                         *
 ***************************************************************************/
#ifndef __SLIDERWHEELIE_H
#define __SLIDERWHEELIE_H

#include<vector>
#include<assert.h>

#include "oderobot.h"
#include"primitive.h"
#include "joint.h"
#include "angularmotor.h"

#include "oneaxisservo.h"


namespace lpzrobots {

  typedef struct {
  public:
    int    segmNumber;  ///<  number of snake elements
    double segmLength;  ///< length of one snake element
    double segmDia;     ///<  diameter of a snake element
    double segmMass;    ///<  mass of one snake element
    double motorPower;  ///<  power of the motors / servos
    double powerRatio;   ///< ratio of motorpower for hinge vs. slider
    double sensorFactor;    ///<  scale for sensors
    double frictionGround;  ///< friction with ground
    double frictionJoint;   ///< friction within joint
    double jointLimitIn;      ///< maximal angle for the joints to the inside (M_PI/2 = 90 degree)
    double jointLimitOut;      ///< maximal angle for the joints to the outside
    double sliderLength;  ///< length of the slider in segmLength
  } SliderWheelieConf;
  

  /**
   * This is a class, which models an annular robot. 
   * It consists of a number of equal elements, each linked 
   * by a joint powered by 1 servo
   **/
  class SliderWheelie : public OdeRobot
  {
  private:
    bool created;
      
    std::vector <Primitive*> objects;
    std::vector <Joint*> joints;
    std::vector <AngularMotor*> frictionmotors;
    SliderWheelieConf conf;

    std::vector <HingeServo*> hingeServos;
    std::vector <SliderServo*> sliderServos;

    Primitive* center; // virtual center object (position updated on setMotors)
  public:
    SliderWheelie(const OdeHandle& odeHandle, const OsgHandle& osgHandle,
                  const SliderWheelieConf& conf, const std::string& name, 
                  const std::string& revision = "");
    
    virtual ~SliderWheelie();
        
    static SliderWheelieConf getDefaultConf(){
      SliderWheelieConf conf;
      conf.segmNumber = 8;    //  number of snake elements
      conf.segmLength = 0.4;   // length of one snake element
      conf.segmDia    = 0.2;   //  diameter of a snake element
      conf.segmMass   = 0.4;   //  mass of one snake element
      conf.motorPower = 0.2;    //  power of the servos
      conf.powerRatio = 2;    //  power of the servos
      conf.sensorFactor = 1;    //  scale for sensors
      conf.frictionGround = 0.8; // friction with ground
      conf.frictionJoint = 0.0; // friction within joint
      conf.jointLimitIn    =  M_PI/2;
      conf.jointLimitOut   =  -1; // automatically set to 2*M_PI/segm_num
      conf.sliderLength  =  1; 
      return conf;
    }

    virtual void place(const osg::Matrix& pose);
    
    virtual void update();

    void doInternalStuff(GlobalData& global);

    bool collisionCallback(void *data, dGeomID o1, dGeomID o2);

    virtual void setMotors ( const motor* motors, int motornumber );

    virtual int getSensors ( sensor* sensors, int sensornumber );
        
    virtual int getSensorNumber() { assert(created); return hingeServos.size()+sliderServos.size(); }

    virtual int getMotorNumber(){ assert(created); return hingeServos.size()+sliderServos.size(); }

    virtual Primitive* getMainPrimitive() const {
      if(center) return center;
      else if(!objects.empty()){
        return (objects[0]);
      }else return 0;
    }
    
    virtual paramlist getParamList() const;
    
    virtual paramval getParam(const paramkey& key) const;
    
    virtual bool setParam(const paramkey& key, paramval val);

  private:
    static void mycallback(void *data, dGeomID o1, dGeomID o2);

    virtual void create(const osg::Matrix& pose);
    virtual void destroy();
  };

}

#endif

---