Detailed Description

template<template< typename > class ElementType, typename T, typename ElementIndexType>
class drake::multibody::MultibodyElement< ElementType, T, ElementIndexType >

A class representing an element (subcomponent) of a MultibodyPlant or (internally) a MultibodyTree.

Examples of multibody elements are bodies, joints, force elements, and actuators. After a Finalize() call, multibody elements get assigned an type-specific index that uniquely identifies them. A generic multibody tree element MultibodyThing is derived from this class as:

template <typename T>
class MultibodyThing :
    public MultibodyElement<MultibodyThing, T, MultibodyThingIndex> {
 ...
};

Template Parameters

ElementType	The type of the specific multibody element, for instance, a body or a mobilizer. It must be a template class that can be templatized by scalar type T.
T	The scalar type, which must be one of the default scalars.
ElementIndexType	The type-safe index used for this element type.

As an example of usage, consider the definition of a ForceElement class as a multibody element. This is accomplished with:

template <typename T>
class ForceElement :
    public MultibodyElement<ForceElement, T, ForceElementIndex>;

#include <drake/multibody/tree/multibody_tree_system.h>

Public Member Functions
virtual	~MultibodyElement ()

ElementIndexType	index () const
	Returns this element's unique index. More...

ModelInstanceIndex	model_instance () const
	Returns the ModelInstanceIndex of the model instance to which this element belongs. More...

template<typename MultibodyPlantDeferred = MultibodyPlant<T>>
const MultibodyPlantDeferred &	GetParentPlant () const
	Returns the MultibodyPlant that owns this MultibodyElement. More...

void	DeclareParameters (internal::MultibodyTreeSystem< T > *tree_system)
	Declares MultibodyTreeSystem Parameters at MultibodyTreeSystem::Finalize() time. More...

Does not allow copy, move, or assignment
	MultibodyElement (const MultibodyElement &)=delete

MultibodyElement &	operator= (const MultibodyElement &)=delete

	MultibodyElement (MultibodyElement &&)=delete

MultibodyElement &	operator= (MultibodyElement &&)=delete

Protected Member Functions
	MultibodyElement ()
	Default constructor made protected so that sub-classes can still declare their default constructors if they need to. More...

	MultibodyElement (ModelInstanceIndex model_instance)
	Constructor which allows specifying a model instance. More...

const internal::MultibodyTree< T > &	get_parent_tree () const
	Returns a constant reference to the parent MultibodyTree that owns this element. More...

const internal::MultibodyTreeSystem< T > &	GetParentTreeSystem () const
	Returns a constant reference to the parent MultibodyTreeSystem that owns the parent MultibodyTree that owns this element. More...

void	SetTopology (const internal::MultibodyTreeTopology &tree)
	Gives MultibodyElement-derived objects the opportunity to retrieve their topology after MultibodyTree::Finalize() is invoked. More...

virtual void	DoSetTopology (const internal::MultibodyTreeTopology &tree)=0
	Implementation of the NVI SetTopology(). More...

virtual void	DoDeclareParameters (internal::MultibodyTreeSystem< T > *)
	Implementation of the NVI DeclareParameters(). More...

systems::NumericParameterIndex	DeclareNumericParameter (internal::MultibodyTreeSystem< T > *tree_system, const systems::BasicVector< T > &model_vector)
	To be used by MultibodyElement-derived objects when declaring parameters in their implementation of DoDeclareParameters(). More...

systems::AbstractParameterIndex	DeclareAbstractParameter (internal::MultibodyTreeSystem< T > *tree_system, const AbstractValue &model_value)
	To be used by MultibodyElement-derived objects when declaring parameters in their implementation of DoDeclareParameters(). More...

Friends
class	internal::MultibodyTree< T >

class	MultibodyElementTester

Constructor & Destructor Documentation

◆ MultibodyElement() [1/4]

MultibodyElement ( const MultibodyElement< ElementType, T, ElementIndexType > & )

delete

◆ MultibodyElement() [2/4]

MultibodyElement ( MultibodyElement< ElementType, T, ElementIndexType > && )

delete

◆ ~MultibodyElement()

virtual ~MultibodyElement ( )

virtual

◆ MultibodyElement() [3/4]

MultibodyElement ( )

protected

Default constructor made protected so that sub-classes can still declare their default constructors if they need to.

◆ MultibodyElement() [4/4]

MultibodyElement ( ModelInstanceIndex model_instance )

explicitprotected

Constructor which allows specifying a model instance.

Member Function Documentation

◆ DeclareAbstractParameter()

systems::AbstractParameterIndex DeclareAbstractParameter	(	internal::MultibodyTreeSystem< T > *	tree_system,
		const AbstractValue &	model_value
	)

protected

To be used by MultibodyElement-derived objects when declaring parameters in their implementation of DoDeclareParameters().

For an example, see Joint::DoDeclareParameters().

◆ DeclareNumericParameter()

systems::NumericParameterIndex DeclareNumericParameter	(	internal::MultibodyTreeSystem< T > *	tree_system,
		const systems::BasicVector< T > &	model_vector
	)

protected

To be used by MultibodyElement-derived objects when declaring parameters in their implementation of DoDeclareParameters().

For an example, see RigidBody::DoDeclareParameters().

◆ DeclareParameters()

void DeclareParameters ( internal::MultibodyTreeSystem< T > * tree_system )

Declares MultibodyTreeSystem Parameters at MultibodyTreeSystem::Finalize() time.

NVI to the virtual method DoDeclareParameters().

Parameters

[in] tree_system A mutable copy of the parent MultibodyTreeSystem.

Precondition: 'tree_system' must be the same as the parent tree system (what's returned from GetParentTreeSystem()).

◆ DoDeclareParameters()

virtual void DoDeclareParameters ( internal::MultibodyTreeSystem< T > * )

protectedvirtual

Implementation of the NVI DeclareParameters().

MultibodyElement-derived objects must override to declare their specific parameters. If an object is not a direct descendent of MultibodyElement, it must invoke its parent classes' DoDeclareParameters() before declaring its own parameters.

Reimplemented in Joint< T >, LinearBushingRollPitchYaw< T >, Body< T >, and RigidBody< T >.

◆ DoSetTopology()

virtual void DoSetTopology ( const internal::MultibodyTreeTopology & tree )

protectedpure virtual

Implementation of the NVI SetTopology().

For advanced use only for developers implementing new MultibodyTree components.

Implemented in Joint< T >.

◆ get_parent_tree()

const internal::MultibodyTree<T>& get_parent_tree ( ) const

protected

Returns a constant reference to the parent MultibodyTree that owns this element.

◆ GetParentPlant()

const MultibodyPlantDeferred& GetParentPlant ( ) const

Returns the MultibodyPlant that owns this MultibodyElement.

Note: You can only invoke this method if you have a definition of MultibodyPlant available. That is, you must include drake/multibody/plant/multibody_plant.h in the translation unit that invokes this method; multibody_element.h cannot do that for you.

Exceptions

std::exception if there is no MultibodyPlant owner.

◆ GetParentTreeSystem()

const internal::MultibodyTreeSystem<T>& GetParentTreeSystem ( ) const

protected

Returns a constant reference to the parent MultibodyTreeSystem that owns the parent MultibodyTree that owns this element.

◆ index()

ElementIndexType index ( ) const

Returns this element's unique index.

◆ model_instance()

ModelInstanceIndex model_instance ( ) const

Returns the ModelInstanceIndex of the model instance to which this element belongs.

◆ operator=() [1/2]

MultibodyElement& operator= ( const MultibodyElement< ElementType, T, ElementIndexType > & )

delete

◆ operator=() [2/2]

MultibodyElement& operator= ( MultibodyElement< ElementType, T, ElementIndexType > && )

delete

◆ SetTopology()

void SetTopology ( const internal::MultibodyTreeTopology & tree )

protected

Gives MultibodyElement-derived objects the opportunity to retrieve their topology after MultibodyTree::Finalize() is invoked.

NVI to pure virtual method DoSetTopology().

Friends And Related Function Documentation

◆ internal::MultibodyTree< T >

friend class internal::MultibodyTree< T >

friend

◆ MultibodyElementTester

friend class MultibodyElementTester

friend

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

drake/multibody/tree/multibody_element.h

Detailed Description

template<template< typename > class ElementType, typename T, typename ElementIndexType> class drake::multibody::MultibodyElement< ElementType, T, ElementIndexType >

Public Member Functions

Protected Member Functions

Friends

Constructor & Destructor Documentation

◆ MultibodyElement() [1/4]

◆ MultibodyElement() [2/4]

◆ ~MultibodyElement()

◆ MultibodyElement() [3/4]

◆ MultibodyElement() [4/4]

Member Function Documentation

◆ DeclareAbstractParameter()

◆ DeclareNumericParameter()

◆ DeclareParameters()

◆ DoDeclareParameters()

◆ DoSetTopology()

◆ get_parent_tree()

◆ GetParentPlant()

◆ GetParentTreeSystem()

◆ index()

◆ model_instance()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ SetTopology()

Friends And Related Function Documentation

◆ internal::MultibodyTree< T >

◆ MultibodyElementTester

template<template< typename > class ElementType, typename T, typename ElementIndexType>
class drake::multibody::MultibodyElement< ElementType, T, ElementIndexType >