Base class for a physics engine. More...

#include <physics/physics.hh>

Inheritance diagram for gazebo::physics::PhysicsEngine:

Public Member Functions
	PhysicsEngine (WorldPtr _world)
	Default constructor. More...

virtual	~PhysicsEngine ()
	Destructor. More...

virtual CollisionPtr	CreateCollision (const std::string &_shapeType, LinkPtr _link)=0
	Create a collision. More...

CollisionPtr	CreateCollision (const std::string &_shapeType, const std::string &_linkName)
	Create a collision. More...

virtual JointPtr	CreateJoint (const std::string &_type, ModelPtr _parent=ModelPtr())=0
	Create a new joint. More...

virtual LinkPtr	CreateLink (ModelPtr _parent)=0
	Create a new body. More...

virtual ModelPtr	CreateModel (BasePtr _base)
	Create a new model. More...

virtual ShapePtr	CreateShape (const std::string &_shapeType, CollisionPtr _collision)=0
	Create a physics::Shape object. More...

virtual void	DebugPrint () const =0
	Debug print out of the physic engine state. More...

virtual void	Fini ()
	Finilize the physics engine. More...

virtual bool	GetAutoDisableFlag ()
	: Remove this function, and replace it with a more generic property map More...

ContactManager *	GetContactManager () const
	Get a pointer to the contact manger. More...

virtual double	GetContactMaxCorrectingVel ()
	: Remove this function, and replace it with a more generic property map. More...

virtual double	GetContactSurfaceLayer ()
	: Remove this function, and replace it with a more generic property map. More...

virtual math::Vector3	GetGravity () const
	Return the gavity vector. More...

virtual unsigned int	GetMaxContacts ()
	: Remove this function, and replace it with a more generic property map. More...

double	GetMaxStepSize () const
	Get max step size. More...

virtual boost::any	GetParam (const std::string &_key) const
	Get an parameter of the physics engine. More...

boost::recursive_mutex *	GetPhysicsUpdateMutex () const
	returns a pointer to the PhysicsEngine::physicsUpdateMutex. More...

double	GetRealTimeUpdateRate () const
	Get real time update rate. More...

virtual int	GetSORPGSIters () GAZEBO_DEPRECATED(3.0)
	: Remove this function, and replace it with a more generic property map More...

virtual int	GetSORPGSPreconIters () GAZEBO_DEPRECATED(3.0)
	: Remove this function, and replace it with a more generic property map More...

virtual double	GetSORPGSW () GAZEBO_DEPRECATED(3.0)
	: Remove this function, and replace it with a more generic property map. More...

double	GetTargetRealTimeFactor () const
	Get target real time factor. More...

virtual std::string	GetType () const =0
	Return the physics engine type (ode\|bullet\|dart\|simbody). More...

double	GetUpdatePeriod ()
	Get the simulation update period. More...

virtual double	GetWorldCFM ()
	: Remove this function, and replace it with a more generic property map More...

virtual double	GetWorldERP ()
	: Remove this function, and replace it with a more generic property map More...

virtual void	Init ()=0
	Initialize the physics engine. More...

virtual void	InitForThread ()=0
	Init the engine for threads. More...

virtual void	Load (sdf::ElementPtr _sdf)
	Load the physics engine. More...

virtual void	Reset ()
	Rest the physics engine. More...

virtual void	SetAutoDisableFlag (bool _autoDisable)
	: Remove this function, and replace it with a more generic property map More...

virtual void	SetContactMaxCorrectingVel (double _vel)
	: Remove this function, and replace it with a more generic property map More...

virtual void	SetContactSurfaceLayer (double _layerDepth)
	: Remove this function, and replace it with a more generic property map More...

virtual void	SetGravity (const gazebo::math::Vector3 &_gravity)=0
	Set the gavity vector. More...

virtual void	SetMaxContacts (unsigned int _maxContacts)
	: Remove this function, and replace it with a more generic property map More...

void	SetMaxStepSize (double _stepSize)
	Set max step size. More...

virtual bool	SetParam (const std::string &_key, const boost::any &_value)
	Set a parameter of the physics engine. More...

void	SetRealTimeUpdateRate (double _rate)
	Set real time update rate. More...

virtual void	SetSeed (uint32_t _seed)=0
	Set the random number seed for the physics engine. More...

virtual void	SetSORPGSIters (unsigned int _iters) GAZEBO_DEPRECATED(3.0)
	: Remove this function, and replace it with a more generic property map More...

virtual void	SetSORPGSPreconIters (unsigned int _iters) GAZEBO_DEPRECATED(3.0)
	: Remove this function, and replace it with a more generic property map More...

virtual void	SetSORPGSW (double _w) GAZEBO_DEPRECATED(3.0)
	: Remove this function, and replace it with a more generic property map More...

void	SetTargetRealTimeFactor (double _factor)
	Set target real time factor. More...

virtual void	SetWorldCFM (double _cfm)
	: Remove this function, and replace it with a more generic property map More...

virtual void	SetWorldERP (double _erp)
	: Remove this function, and replace it with a more generic property map More...

virtual void	UpdateCollision ()=0
	Update the physics engine collision. More...

virtual void	UpdatePhysics ()
	Update the physics engine. More...

Protected Member Functions
virtual void	OnPhysicsMsg (ConstPhysicsPtr &_msg)
	virtual callback for gztopic "~/physics". More...

virtual void	OnRequest (ConstRequestPtr &_msg)
	virtual callback for gztopic "~/request". More...

Protected Attributes
ContactManager *	contactManager
	Class that handles all contacts generated by the physics engine. More...

double	maxStepSize
	Real time update rate. More...

transport::NodePtr	node
	Node for communication. More...

transport::SubscriberPtr	physicsSub
	Subscribe to the physics topic. More...

boost::recursive_mutex *	physicsUpdateMutex
	Mutex to protect the update cycle. More...

double	realTimeUpdateRate
	Real time update rate. More...

transport::SubscriberPtr	requestSub
	Subscribe to the request topic. More...

transport::PublisherPtr	responsePub
	Response publisher. More...

sdf::ElementPtr	sdf
	Our SDF values. More...

double	targetRealTimeFactor
	Target real time factor. More...

WorldPtr	world
	Pointer to the world. More...

Detailed Description

Base class for a physics engine.

Constructor & Destructor Documentation

gazebo::physics::PhysicsEngine::PhysicsEngine ( WorldPtr _world)

explicit

Default constructor.

Parameters

[in] _world Pointer to the world.

virtual gazebo::physics::PhysicsEngine::~PhysicsEngine ( )

virtual

Destructor.

Member Function Documentation

virtual CollisionPtr gazebo::physics::PhysicsEngine::CreateCollision	(	const std::string &	_shapeType,
		LinkPtr	_link
	)

pure virtual

Create a collision.

Parameters

[in]	_shapeType	Type of collision to create.
[in]	_link	Parent link.

Implemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

CollisionPtr gazebo::physics::PhysicsEngine::CreateCollision	(	const std::string &	_shapeType,
		const std::string &	_linkName
	)

Create a collision.

Parameters

[in]	_shapeType	Type of collision to create.
[in]	_linkName	Name of the parent link.

virtual JointPtr gazebo::physics::PhysicsEngine::CreateJoint	(	const std::string &	_type,
		ModelPtr	_parent = `ModelPtr()`
	)

pure virtual

Create a new joint.

Parameters

[in]	_type	Type of joint to create.
[in]	_parent	Model parent.

Implemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

virtual LinkPtr gazebo::physics::PhysicsEngine::CreateLink ( ModelPtr _parent)

pure virtual

Create a new body.

Parameters

[in] _parent Parent model for the link.

Implemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

virtual ModelPtr gazebo::physics::PhysicsEngine::CreateModel ( BasePtr _base)

virtual

Create a new model.

Parameters

[in] _base Boost shared pointer to a new model.

Reimplemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

virtual ShapePtr gazebo::physics::PhysicsEngine::CreateShape	(	const std::string &	_shapeType,
		CollisionPtr	_collision
	)

pure virtual

Create a physics::Shape object.

Parameters

[in]	_shapeType	Type of shape to create.
[in]	_collision	Collision parent.

Implemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

virtual void gazebo::physics::PhysicsEngine::DebugPrint ( ) const

pure virtual

Debug print out of the physic engine state.

Implemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

virtual void gazebo::physics::PhysicsEngine::Fini ( )

virtual

Finilize the physics engine.

Reimplemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

virtual bool gazebo::physics::PhysicsEngine::GetAutoDisableFlag ( )

inlinevirtual

: Remove this function, and replace it with a more generic property map

access functions to set ODE parameters..

Returns: Auto disable flag.

ContactManager* gazebo::physics::PhysicsEngine::GetContactManager ( ) const

Get a pointer to the contact manger.

Returns: Pointer to the contact manager.

virtual double gazebo::physics::PhysicsEngine::GetContactMaxCorrectingVel ( )

inlinevirtual

: Remove this function, and replace it with a more generic property map.

access functions to set ODE parameters.

Returns: Max correcting velocity.

virtual double gazebo::physics::PhysicsEngine::GetContactSurfaceLayer ( )

inlinevirtual

: Remove this function, and replace it with a more generic property map.

access functions to set ODE parameters.

Returns: Contact suerface layer depth.

virtual math::Vector3 gazebo::physics::PhysicsEngine::GetGravity ( ) const

virtual

Return the gavity vector.

Returns: The gavity vector.

virtual unsigned int gazebo::physics::PhysicsEngine::GetMaxContacts ( )

inlinevirtual

: Remove this function, and replace it with a more generic property map.

access functions to set ODE parameters.

Returns: Maximum number of allows contacts.

double gazebo::physics::PhysicsEngine::GetMaxStepSize ( ) const

Get max step size.

Returns: Max step size.

virtual boost::any gazebo::physics::PhysicsEngine::GetParam ( const std::string & _key) const

virtual

Get an parameter of the physics engine.

Parameters

[in] _attr String key

See Also: SetParam

Returns: The value of the parameter

Reimplemented in gazebo::physics::SimbodyPhysics, and gazebo::physics::DARTPhysics.

boost::recursive_mutex* gazebo::physics::PhysicsEngine::GetPhysicsUpdateMutex ( ) const

inline

returns a pointer to the PhysicsEngine::physicsUpdateMutex.

Returns: Pointer to the physics mutex.

double gazebo::physics::PhysicsEngine::GetRealTimeUpdateRate ( ) const

Get real time update rate.

Returns: Update rate

virtual int gazebo::physics::PhysicsEngine::GetSORPGSIters ( )

inlinevirtual

: Remove this function, and replace it with a more generic property map

access functions to set ODE parameters.

Returns: SORPGS iterations.

virtual int gazebo::physics::PhysicsEngine::GetSORPGSPreconIters ( )

inlinevirtual

: Remove this function, and replace it with a more generic property map

access functions to set ODE parameters.

Returns: SORPGS precondition iterations.

virtual double gazebo::physics::PhysicsEngine::GetSORPGSW ( )

inlinevirtual

: Remove this function, and replace it with a more generic property map.

access functions to set ODE parameters

Returns: SORPGSW value.

double gazebo::physics::PhysicsEngine::GetTargetRealTimeFactor ( ) const

Get target real time factor.

Returns: Target real time factor

virtual std::string gazebo::physics::PhysicsEngine::GetType ( ) const

pure virtual

Return the physics engine type (ode|bullet|dart|simbody).

Returns: Type of the physics engine.

Implemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

double gazebo::physics::PhysicsEngine::GetUpdatePeriod ( )

Get the simulation update period.

Returns: Simulation update period.

virtual double gazebo::physics::PhysicsEngine::GetWorldCFM ( )

inlinevirtual

: Remove this function, and replace it with a more generic property map

Get World CFM.

Returns: World CFM.

virtual double gazebo::physics::PhysicsEngine::GetWorldERP ( )

inlinevirtual

: Remove this function, and replace it with a more generic property map

Get World ERP.

Returns: World ERP.

virtual void gazebo::physics::PhysicsEngine::Init ( )

pure virtual

Initialize the physics engine.

Implemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

virtual void gazebo::physics::PhysicsEngine::InitForThread ( )

pure virtual

Init the engine for threads.

Implemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

virtual void gazebo::physics::PhysicsEngine::Load ( sdf::ElementPtr _sdf)

virtual

Load the physics engine.

Parameters

[in] _sdf Pointer to the SDF parameters.

Reimplemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

virtual void gazebo::physics::PhysicsEngine::OnPhysicsMsg ( ConstPhysicsPtr & _msg)

protectedvirtual

virtual callback for gztopic "~/physics".

Parameters

[in] _msg Physics message.

Reimplemented in gazebo::physics::SimbodyPhysics, and gazebo::physics::DARTPhysics.

virtual void gazebo::physics::PhysicsEngine::OnRequest ( ConstRequestPtr & _msg)

protectedvirtual

virtual callback for gztopic "~/request".

Parameters

[in] _msg Request message.

Reimplemented in gazebo::physics::SimbodyPhysics, and gazebo::physics::DARTPhysics.

virtual void gazebo::physics::PhysicsEngine::Reset ( )

inlinevirtual

Rest the physics engine.

Reimplemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

virtual void gazebo::physics::PhysicsEngine::SetAutoDisableFlag ( bool _autoDisable)

virtual

: Remove this function, and replace it with a more generic property map

Access functions to set ODE parameters.

Parameters

[in] _autoDisable True to enable auto disabling of bodies.

virtual void gazebo::physics::PhysicsEngine::SetContactMaxCorrectingVel ( double _vel)

virtual

: Remove this function, and replace it with a more generic property map

Access functions to set ODE parameters.

Parameters

[in] _vel Max correcting velocity.

virtual void gazebo::physics::PhysicsEngine::SetContactSurfaceLayer ( double _layerDepth)

virtual

: Remove this function, and replace it with a more generic property map

Access functions to set ODE parameters.

Parameters

[in] _layerDepth Surface layer depth

virtual void gazebo::physics::PhysicsEngine::SetGravity ( const gazebo::math::Vector3 & _gravity)

pure virtual

Set the gavity vector.

Parameters

[in] _gravity New gravity vector.

Implemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

virtual void gazebo::physics::PhysicsEngine::SetMaxContacts ( unsigned int _maxContacts)

virtual

: Remove this function, and replace it with a more generic property map

access functions to set ODE parameters

Parameters

[in] _maxContacts Maximum number of contacts.

void gazebo::physics::PhysicsEngine::SetMaxStepSize ( double _stepSize)

Set max step size.

Parameters

[in] _stepSize Max step size.

virtual bool gazebo::physics::PhysicsEngine::SetParam	(	const std::string &	_key,
		const boost::any &	_value
	)

virtual

Set a parameter of the physics engine.

See SetParam documentation for descriptions of duplicate parameters.

Parameters

[in]	_key	String key Below is a list of _key parameter definitions: "solver_type" (string) - returns solver used by engine, e.g. "sequential_impulse' for Bullet, "quick" for ODE "Featherstone and Lemkes" for DART and "Spatial Algebra and Elastic Foundation" for Simbody. -# "type" (string) - deprecated, use keyword "solver_type". -# "cfm" (double) - global CFM -# "erp" (double) - global ERP -# "precon_iters" (bool) - precondition iterations (experimental). "iters" (int) - number of LCP PGS iterations. If sor_lcp_tolerance is negative, full iteration count is executed. Otherwise, PGS may stop iteration early if sor_lcp_tolerance is satisfied by the total RMS residual. "sor" (double) - relaxation parameter for Projected Gauss-Seidel (PGS) updates. "contact_max_correcting_vel" (double) - truncates correction impulses from ERP by this value. "contact_surface_layer" (double) - ERP is 0 for interpenetration depths below this value. "max_contacts" (int) - max number of contact constraints between any pair of collision bodies. "min_step_size" (double) - minimum internal step size. (defined but not used in ode). "max_step_size" (double) - maximum physics step size when physics update step must return.
[in]	_value	The value to set to

Returns: true if SetParam is successful, false if operation fails.

Reimplemented in gazebo::physics::SimbodyPhysics, and gazebo::physics::DARTPhysics.

void gazebo::physics::PhysicsEngine::SetRealTimeUpdateRate ( double _rate)

Set real time update rate.

Parameters

[in] _rate Update rate

virtual void gazebo::physics::PhysicsEngine::SetSeed ( uint32_t _seed)

pure virtual

Set the random number seed for the physics engine.

Parameters

[in] _seed The random number seed.

Implemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

virtual void gazebo::physics::PhysicsEngine::SetSORPGSIters ( unsigned int _iters)

virtual

: Remove this function, and replace it with a more generic property map

Access functions to set ODE parameters.

Parameters

[in] _iter Number of iterations.

virtual void gazebo::physics::PhysicsEngine::SetSORPGSPreconIters ( unsigned int _iters)

virtual

: Remove this function, and replace it with a more generic property map

Access functions to set ODE parameters.

Parameters

[in] _iter Number of iterations.

virtual void gazebo::physics::PhysicsEngine::SetSORPGSW ( double _w)

virtual

: Remove this function, and replace it with a more generic property map

Access functions to set ODE parameters.

Parameters

[in] _w SORPGSW value.

void gazebo::physics::PhysicsEngine::SetTargetRealTimeFactor ( double _factor)

Set target real time factor.

Parameters

[in] _factor Target real time factor

virtual void gazebo::physics::PhysicsEngine::SetWorldCFM ( double _cfm)

virtual

: Remove this function, and replace it with a more generic property map

Access functions to set ODE parameters.

Parameters

[in] _cfm Constraint force mixing.

virtual void gazebo::physics::PhysicsEngine::SetWorldERP ( double _erp)

virtual

: Remove this function, and replace it with a more generic property map

Access functions to set ODE parameters.

Parameters

[in] _erp Error reduction parameter.

virtual void gazebo::physics::PhysicsEngine::UpdateCollision ( )

pure virtual

Update the physics engine collision.

Implemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

virtual void gazebo::physics::PhysicsEngine::UpdatePhysics ( )

inlinevirtual

Update the physics engine.

Reimplemented in gazebo::physics::DARTPhysics, and gazebo::physics::SimbodyPhysics.

Member Data Documentation

ContactManager* gazebo::physics::PhysicsEngine::contactManager

protected

Class that handles all contacts generated by the physics engine.

double gazebo::physics::PhysicsEngine::maxStepSize

protected

Real time update rate.

transport::NodePtr gazebo::physics::PhysicsEngine::node

protected

Node for communication.

transport::SubscriberPtr gazebo::physics::PhysicsEngine::physicsSub

protected

Subscribe to the physics topic.

boost::recursive_mutex* gazebo::physics::PhysicsEngine::physicsUpdateMutex

protected

Mutex to protect the update cycle.

double gazebo::physics::PhysicsEngine::realTimeUpdateRate

protected

Real time update rate.

transport::SubscriberPtr gazebo::physics::PhysicsEngine::requestSub

protected

Subscribe to the request topic.

transport::PublisherPtr gazebo::physics::PhysicsEngine::responsePub

protected

Response publisher.

sdf::ElementPtr gazebo::physics::PhysicsEngine::sdf

protected

Our SDF values.

double gazebo::physics::PhysicsEngine::targetRealTimeFactor

protected

Target real time factor.

WorldPtr gazebo::physics::PhysicsEngine::world

protected

Pointer to the world.

The documentation for this class was generated from the following file:

PhysicsEngine.hh

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation