Public Member Functions
Construction
	UniformRandomSampler ()

	UniformRandomSampler (XMLNode &_node)

virtual	~UniformRandomSampler ()=default

MPBaseObject Overrides
virtual void	Print (std::ostream &_os) const override

Individual Configuration Sampling
virtual void	Sample (size_t _numNodes, size_t _maxAttempts, const Boundary *const _boundary, OutputIterator _valid, OutputIterator _invalid)

virtual void	Sample (size_t _numNodes, size_t _maxAttempts, const Boundary *const _boundary, OutputIterator _valid)

virtual void	Sample (size_t _numNodes, size_t _maxAttempts, const Boundary const _robotBoundary, const Boundary const _eeBoundary, OutputIterator _valid, OutputIterator _invalid)

virtual void	Sample (size_t _numNodes, size_t _maxAttempts, const Boundary const _robotBoundary, const Boundary const _eeBoundary, OutputIterator _valid)

virtual void	Filter (InputIterator _first, InputIterator _last, size_t _maxAttempts, const Boundary *const _boundary, OutputIterator _valid, OutputIterator _invalid)

void	Filter (InputIterator _first, InputIterator _last, size_t _maxAttempts, const Boundary *const _boundary, OutputIterator _valid)

Group Configuration Sampling
virtual void	Sample (size_t _numNodes, size_t _maxAttempts, const Boundary *const _boundary, GroupOutputIterator _valid, GroupOutputIterator _invalid)

virtual void	Sample (size_t _numNodes, size_t _maxAttempts, const Boundary *const _boundary, GroupOutputIterator _valid)

virtual void	Sample (size_t _numNodes, size_t _maxAttempts, const BoundaryMap &_boundary, GroupOutputIterator _valid, GroupOutputIterator _invalid)

virtual void	Sample (size_t _numNodes, size_t _maxAttempts, const BoundaryMap &_boundary, GroupOutputIterator _valid)

virtual void	Filter (GroupInputIterator _first, GroupInputIterator _last, size_t _maxAttempts, const Boundary *const _boundary, GroupOutputIterator _valid, GroupOutputIterator _invalid)

void	Filter (GroupInputIterator _first, GroupInputIterator _last, size_t _maxAttempts, const Boundary *const _boundary, GroupOutputIterator _valid)

Initialization
virtual void	Initialize ()

Name and Label Accessors
const std::string &	GetName () const
	Get the class name for this object.

const std::string &	GetLabel () const
	Get the unique label for this object.

std::string	GetNameAndLabel () const
	Get the unique string identifier for this object "m_name::m_label".

void	SetLabel (const std::string &)
	Set the unique label for this object.

MPLibrary Accessors
void	SetMPLibrary (MPLibrary *) noexcept
	Set the owning MPLibrary.

MPLibrary *	GetMPLibrary () const noexcept
	Get the owning MPLibrary.

bool	IsRunning () const noexcept
	Check the library's running flag.

DistanceMetricPointer	GetDistanceMetric (const std::string &) const noexcept
	Get a distance metric by label from the owning MPLibrary.

ValidityCheckerPointer	GetValidityChecker (const std::string &) const noexcept
	Get a validity checker by label from the owning MPLibrary.

NeighborhoodFinderPointer	GetNeighborhoodFinder (const std::string &) const noexcept
	Get a neighborhood finder by label from the owning MPLibrary.

SamplerPointer	GetSampler (const std::string &) const noexcept
	Get a sampler by label from the owning MPLibrary.

LocalPlannerPointer	GetLocalPlanner (const std::string &) const noexcept
	Get a local planner by label from the owning MPLibrary.

ExtenderPointer	GetExtender (const std::string &) const noexcept
	Get an extender by label from the owning MPLibrary.

PathModifierPointer	GetPathModifier (const std::string &) const noexcept
	Get a path modifier by label from the owning MPLibrary.

ConnectorPointer	GetConnector (const std::string &) const noexcept
	Get a connector by label from the owning MPLibrary.

MetricPointer	GetMetric (const std::string &) const noexcept
	Get a metric by label from the owning MPLibrary.

MapEvaluatorPointer	GetMapEvaluator (const std::string &) const noexcept
	Get a map evaluator by label from the owning MPLibrary.

MPStrategyPointer	GetMPStrategy (const std::string &) const noexcept
	Get a strategy by label from the owning MPLibrary.

MPTraits::MPTools *	GetMPTools () const noexcept
	Get the MPTools container from the owning MPLibrary.

Problem Accessors
MPProblem *	GetMPProblem () const noexcept
	Get the library's current MPProblem.

Environment *	GetEnvironment () const noexcept
	Get the current environment.

MPTask *	GetTask () const noexcept
	Get the current task.

GroupTask *	GetGroupTask () const noexcept
	Get the current group task.

Solution Accessors
MPSolution *	GetMPSolution () const noexcept

RoadmapType *	GetRoadmap (Robot *const _r=nullptr) const noexcept
	Get the current free-space roadmap.

GroupRoadmapType *	GetGroupRoadmap (RobotGroup *const _g=nullptr) const noexcept
	Get the current free-space group roadmap.

RoadmapType *	GetBlockRoadmap (Robot *const _r=nullptr) const noexcept
	Get the current obstacle-space roadmap.

Path *	GetPath (Robot *const _r=nullptr) const noexcept
	Get the current best path.

GroupPath *	GetGroupPath (RobotGroup *const _g=nullptr) const noexcept
	Get the current best group path.

StatClass *	GetStatClass () const noexcept
	Get the current StatClass.

LocalObstacleMap *	GetLocalObstacleMap () const noexcept
	Get the local obstacle map.

GoalTracker *	GetGoalTracker () const noexcept
	Get the goal tracker.

Public Types
Motion Planning Types
typedef MPTraits::CfgType	CfgType

typedef MPTraits::GroupCfgType	GroupCfgType

Local Types
typedef std::vector< CfgType >::iterator	InputIterator

typedef std::back_insert_iterator< std::vector< CfgType > >	OutputIterator

typedef std::vector< GroupCfgType >::iterator	GroupInputIterator

typedef std::back_insert_iterator< std::vector< GroupCfgType > >	GroupOutputIterator

typedef std::map< Robot , const Boundary >	BoundaryMap
	A map from robots to sampling boundaries.

Local Types
typedef MPTraits::RoadmapType	RoadmapType

typedef MPTraits::GroupRoadmapType	GroupRoadmapType

typedef MPTraits::LocalObstacleMap	LocalObstacleMap

typedef MPTraits::Path	Path

typedef MPTraits::GroupPathType	GroupPath

typedef MPTraits::MPLibrary	MPLibrary

typedef MPTraits::MPSolution	MPSolution

typedef MPTraits::GoalTracker	GoalTracker

typedef MPLibrary::SamplerPointer	SamplerPointer

typedef MPLibrary::LocalPlannerPointer	LocalPlannerPointer

typedef MPLibrary::ExtenderPointer	ExtenderPointer

typedef MPLibrary::PathModifierPointer	PathModifierPointer

typedef MPLibrary::ConnectorPointer	ConnectorPointer

typedef MPLibrary::MetricPointer	MetricPointer

typedef MPLibrary::MapEvaluatorPointer	MapEvaluatorPointer

typedef MPLibrary::MPStrategyPointer	MPStrategyPointer

typedef MPLibrary::DistanceMetricPointer	DistanceMetricPointer

typedef MPLibrary::ValidityCheckerPointer	ValidityCheckerPointer

typedef MPLibrary::NeighborhoodFinderPointer	NeighborhoodFinderPointer

Protected Member Functions
void	SetName (const std::string &_s)

const std::string &	GetBaseFilename () const

Sampler Rule
virtual bool	Sampler (CfgType &_cfg, const Boundary *const _boundary, std::vector< CfgType > &_valid, std::vector< CfgType > &_invalid) override

virtual bool	Sampler (GroupCfgType &_cfg, const Boundary *const _boundary, std::vector< GroupCfgType > &_valid, std::vector< GroupCfgType > &_invalid) override

virtual bool	Sampler (GroupCfgType &_cfg, const BoundaryMap &_boundaryMap, std::vector< GroupCfgType > &_valid, std::vector< GroupCfgType > &_invalid) override

Sampler Rule
The default implementations of these throw exceptions so that derived classes can avoid implementing unsupported functions (as opposed to making these pure virtual).
virtual bool	Sampler (CfgType &_cfg, const Boundary const _robotBoundary, const Boundary const _eeBoundary, std::vector< CfgType > &_valid, std::vector< CfgType > &_invalid)

Protected Attributes
bool	m_debug
	Print debug info?

Detailed Description

template<class MPTraits>
class UniformRandomSampler< MPTraits >

This sampler only validity-checks the input sample. It is only a 'uniform random' sampler if given a uniform random distribution of input samples.

Member Function Documentation

◆ Print()

template<typename MPTraits >

void UniformRandomSampler< MPTraits >::Print ( std::ostream & _os ) const

overridevirtual

Print internal state of this object.

Parameters

_os	The std::ostream to print to.

Reimplemented from MPBaseObject< MPTraits >.

◆ Sampler() [1/4]

template<typename MPTraits >

bool UniformRandomSampler< MPTraits >::Sampler	(	CfgType &	_cfg,
		const Boundary *const	_boundary,
		std::vector< CfgType > &	_valid,
		std::vector< CfgType > &	_invalid
	)

overrideprotectedvirtual

Takes a single input configuration and applies the sampler rule to generate one or more output configurations.

Parameters

_cfg	The input configuration.
_boundary	The sampling boundary.
_valid	The resulting output configurations.
_invalid	The (optional) return for failed attempts.

Returns: True if a valid configuration was generated, false otherwise.

Reimplemented from SamplerMethod< MPTraits >.

◆ Sampler() [2/4]

template<typename MPTraits >

bool UniformRandomSampler< MPTraits >::Sampler	(	GroupCfgType &	_cfg,
		const Boundary *const	_boundary,
		std::vector< GroupCfgType > &	_valid,
		std::vector< GroupCfgType > &	_invalid
	)

overrideprotectedvirtual

Takes a single input configuration and applies the sampler rule to generate one or more output configurations.

Parameters

_cfg	The input group configuration.
_boundary	The sampling boundary.
_valid	The resulting output configurations.
_invalid	The (optional) return for failed attempts.

Returns: True if a valid configuration was generated, false otherwise.

Reimplemented from SamplerMethod< MPTraits >.

◆ Sampler() [3/4]

template<typename MPTraits >

bool UniformRandomSampler< MPTraits >::Sampler	(	GroupCfgType &	_cfg,
		const BoundaryMap &	_boundaryMap,
		std::vector< GroupCfgType > &	_valid,
		std::vector< GroupCfgType > &	_invalid
	)

overrideprotectedvirtual

This version specifies a (possibly different) boundary for each robot. Robots which are not in the boundary map will use the environment boundary. This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Reimplemented from SamplerMethod< MPTraits >.

◆ Sample() [1/8]

template<typename MPTraits >

void SamplerMethod< MPTraits >::Sample	(	size_t	_numNodes,
		size_t	_maxAttempts,
		const Boundary *const	_boundary,
		OutputIterator	_valid,
		OutputIterator	_invalid
	)

virtualinherited

Try to sample a set number of new configurations from a given boundary.

Parameters

_numNodes	The number of samples desired.
_maxAttempts	The maximum number of attempts for each sample.
_boundary	The boundary to sample from.
_valid	An iterator to storage for the new configurations.
_invalid	An (optional) iterator to storage for failed attempts.

◆ Sample() [2/8]

template<typename MPTraits >

void SamplerMethod< MPTraits >::Sample	(	size_t	_numNodes,
		size_t	_maxAttempts,
		const Boundary *const	_boundary,
		OutputIterator	_valid
	)

virtualinherited

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

◆ Sample() [3/8]

template<typename MPTraits >

void SamplerMethod< MPTraits >::Sample	(	size_t	_numNodes,
		size_t	_maxAttempts,
		const Boundary *const	_robotBoundary,
		const Boundary *const	_eeBoundary,
		OutputIterator	_valid,
		OutputIterator	_invalid
	)

virtualinherited

Try to sample a set number of new configurations from a given boundary (for the entire robot), and additionally satisfying a constraint boundary for the end-effector (robot is presumed to have only one EE).

Parameters

_robotBoundary	The boundary for the entire robot.
_eeBoundary	The boundary for the end-effector.

◆ Sample() [4/8]

template<typename MPTraits >

void SamplerMethod< MPTraits >::Sample	(	size_t	_numNodes,
		size_t	_maxAttempts,
		const Boundary *const	_robotBoundary,
		const Boundary *const	_eeBoundary,
		OutputIterator	_valid
	)

virtualinherited

This version does not return invalid samples. This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

◆ Sample() [5/8]

template<typename MPTraits >

void SamplerMethod< MPTraits >::Sample	(	size_t	_numNodes,
		size_t	_maxAttempts,
		const Boundary *const	_boundary,
		GroupOutputIterator	_valid,
		GroupOutputIterator	_invalid
	)

virtualinherited

Try to sample a set number of new configurations from a single boundary.

Parameters

_numNodes	The number of samples desired.
_maxAttempts	The maximum number of attempts for each sample.
_boundary	The boundary to sample from.
_valid	An iterator to storage for the new configurations.
_invalid	An (optional) iterator to storage for failed attempts.

◆ Sample() [6/8]

template<typename MPTraits >

void SamplerMethod< MPTraits >::Sample	(	size_t	_numNodes,
		size_t	_maxAttempts,
		const Boundary *const	_boundary,
		GroupOutputIterator	_valid
	)

virtualinherited

This version does not return invalid samples. This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

◆ Sample() [7/8]

template<typename MPTraits >

void SamplerMethod< MPTraits >::Sample	(	size_t	_numNodes,
		size_t	_maxAttempts,
		const BoundaryMap &	_boundary,
		GroupOutputIterator	_valid,
		GroupOutputIterator	_invalid
	)

virtualinherited

Try to sample a set number of new configurations from a boundary for each robot.

Parameters

_numNodes	The number of samples desired.
_maxAttempts	The maximum number of attempts for each sample.
_boundaryMap	A map from robot to sampling boundary. Any robots which are not found in the map will use the environment boundary.
_valid	An iterator to storage for the new configurations.
_invalid	An (optional) iterator to storage for failed attempts.

◆ Sample() [8/8]

template<typename MPTraits >

void SamplerMethod< MPTraits >::Sample	(	size_t	_numNodes,
		size_t	_maxAttempts,
		const BoundaryMap &	_boundary,
		GroupOutputIterator	_valid
	)

virtualinherited

This version does not return invalid samples. This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

◆ Filter() [1/4]

template<typename MPTraits >

void SamplerMethod< MPTraits >::Filter	(	InputIterator	_first,
		InputIterator	_last,
		size_t	_maxAttempts,
		const Boundary *const	_boundary,
		OutputIterator	_valid,
		OutputIterator	_invalid
	)

virtualinherited

Apply the sampler rule to a set of existing configurations. The output will generally be a filtered or perturbed version of the input set.

Parameters

_first	An iterator to the beginning of a list of input configurations.
_last	An iterator to the end of a list of input configurations.
_maxAttempts	The maximum number of attempts to successfully apply the sampler rule to each input.
_boundary	The sampling boundary to use.
_valid	An iterator to storage for the output configurations.
_invalid	An (optional) iterator to storage for failed attempts.

◆ Filter() [2/4]

template<typename MPTraits >

void SamplerMethod< MPTraits >::Filter	(	InputIterator	_first,
		InputIterator	_last,
		size_t	_maxAttempts,
		const Boundary *const	_boundary,
		OutputIterator	_valid
	)

inherited

This version does not return invalid samples. This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

◆ Filter() [3/4]

template<typename MPTraits >

void SamplerMethod< MPTraits >::Filter	(	GroupInputIterator	_first,
		GroupInputIterator	_last,
		size_t	_maxAttempts,
		const Boundary *const	_boundary,
		GroupOutputIterator	_valid,
		GroupOutputIterator	_invalid
	)

virtualinherited

Apply the sampler rule to a set of existing configurations. The output will generally be a filtered or perturbed version of the input set.

Parameters

_first	An iterator to the beginning of a list of input configurations.
_last	An iterator to the end of a list of input configurations.
_maxAttempts	The maximum number of attempts to successfully apply the sampler rule to each input.
_boundary	The sampling boundary to use.
_valid	An iterator to storage for the output configurations.
_invalid	An (optional) iterator to storage for failed attempts.

◆ Filter() [4/4]

template<typename MPTraits >

void SamplerMethod< MPTraits >::Filter	(	GroupInputIterator	_first,
		GroupInputIterator	_last,
		size_t	_maxAttempts,
		const Boundary *const	_boundary,
		GroupOutputIterator	_valid
	)

inherited

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

◆ Sampler() [4/4]

template<typename MPTraits >

bool SamplerMethod< MPTraits >::Sampler	(	CfgType &	_cfg,
		const Boundary *const	_robotBoundary,
		const Boundary *const	_eeBoundary,
		std::vector< CfgType > &	_valid,
		std::vector< CfgType > &	_invalid
	)

protectedvirtualinherited

This version also specifies a boundary for the end-effector. This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

◆ Initialize()

template<typename MPTraits >

virtual void MPBaseObject< MPTraits >::Initialize ( )

virtualinherited

Initialize this object for the current MPProblem. This should reset any internal state of the algorithms so that they are ready for execution. It is also the place to initialize any state that depends on the current problem.

Warning: This member will be called for every compiled algorithm in the planning library - even those that will not be used. If an algorithm needs to do expenisve setup, then this method should only set a flag that tells it to do so on first use. The only exceptions are the MPStrategies, which will only have their initialize called on first use.

Reimplemented in ConnectorMethod< MPTraits >, CBSQuery< MPTraits >, ComposeEvaluator< MPTraits >, LazyQuery< MPTraits >, QueryMethod< MPTraits >, SIPPMethod< MPTraits >, TimeEvaluator< MPTraits >, TimeMetric< MPTraits >, AdaptiveRRT< MPTraits >, BasicPRM< MPTraits >, BasicRRTStrategy< MPTraits >, TogglePRMStrategy< MPTraits >, ValidationStrategy< MPTraits >, LKHSearch< MPTraits >, ClearanceUtility< MPTraits >, ReachabilityUtil< MPTraits >, SafeIntervalTool< MPTraits >, and TopologicalMap< MPTraits >.

◆ SetName()

template<typename MPTraits >

void MPBaseObject< MPTraits >::SetName ( const std::string & _s )

protectedinherited

Parameters

_s	Class name

◆ GetBaseFilename()

template<typename MPTraits >

const std::string & MPBaseObject< MPTraits >::GetBaseFilename ( ) const

protectedinherited

Returns: base file name from MPProblem

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

UniformRandomSampler.h

Public Member Functions

Public Types

Protected Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ Print()

◆ Sampler() [1/4]

◆ Sampler() [2/4]

◆ Sampler() [3/4]

◆ Sample() [1/8]

◆ Sample() [2/8]

◆ Sample() [3/8]

◆ Sample() [4/8]

◆ Sample() [5/8]

◆ Sample() [6/8]

◆ Sample() [7/8]

◆ Sample() [8/8]

◆ Filter() [1/4]

◆ Filter() [2/4]

◆ Filter() [3/4]

◆ Filter() [4/4]

◆ Sampler() [4/4]

◆ Initialize()

◆ SetName()

◆ GetBaseFilename()