GoalLazySamples.h
1/*********************************************************************
2* Software License Agreement (BSD License)
3*
4* Copyright (c) 2010, Rice University
5* All rights reserved.
6*
7* Redistribution and use in source and binary forms, with or without
8* modification, are permitted provided that the following conditions
9* are met:
10*
11* * Redistributions of source code must retain the above copyright
12* notice, this list of conditions and the following disclaimer.
13* * Redistributions in binary form must reproduce the above
14* copyright notice, this list of conditions and the following
15* disclaimer in the documentation and/or other materials provided
16* with the distribution.
17* * Neither the name of the Rice University nor the names of its
18* contributors may be used to endorse or promote products derived
19* from this software without specific prior written permission.
20*
21* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
24* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
25* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
26* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
27* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
28* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
29* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
31* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
32* POSSIBILITY OF SUCH DAMAGE.
33*********************************************************************/
34
35/* Author: Ioan Sucan */
36
37#ifndef OMPL_BASE_GOALS_GOAL_LAZY_SAMPLES_
38#define OMPL_BASE_GOALS_GOAL_LAZY_SAMPLES_
39
40#include <functional>
41#include <limits>
42#include <mutex>
43#include <thread>
44#include "ompl/base/goals/GoalStates.h"
45
46namespace ompl
47{
48 namespace base
49 {
50 class GoalLazySamples;
51
55 using GoalSamplingFn = std::function<bool(const GoalLazySamples *, State *)>;
56
72 {
73 public:
77 using NewStateCallbackFn = std::function<void(const base::State *)>;
78
102 GoalLazySamples(const SpaceInformationPtr &si, GoalSamplingFn samplerFunc, bool autoStart = true,
103 double minDist = std::numeric_limits<double>::epsilon());
104
105 ~GoalLazySamples() override;
106
107 void sampleGoal(State *st) const override;
108
109 double distanceGoal(const State *st) const override;
110
111 void addState(const State *st) override;
112
114 void startSampling();
115
117 void stopSampling();
118
120 bool isSampling() const;
121
124 void setMinNewSampleDistance(double dist)
125 {
126 minDist_ = dist;
127 }
128
132 {
133 return minDist_;
134 }
135
137 unsigned int samplingAttemptsCount() const
138 {
139 return samplingAttempts_;
140 }
141
145 void setNewStateCallback(const NewStateCallbackFn &callback);
146
149 bool addStateIfDifferent(const State *st, double minDistance);
150
153 bool couldSample() const override;
154
155 bool hasStates() const override;
156 const State *getState(unsigned int index) const override;
157 std::size_t getStateCount() const override;
158
159 void clear() override;
160
161 unsigned int maxSampleCount() const override;
162
163 protected:
165 void goalSamplingThread();
166
168 mutable std::mutex lock_;
169
172
175
177 std::thread *samplingThread_;
178
180 unsigned int samplingAttempts_;
181
184 double minDist_;
185
188 };
189 }
190}
191
192#endif
Definition of a goal region that can be sampled, but the sampling process can be slow....
void addState(const State *st) override
Add a goal state.
GoalLazySamples(const SpaceInformationPtr &si, GoalSamplingFn samplerFunc, bool autoStart=true, double minDist=std::numeric_limits< double >::epsilon())
Create a goal region that can be sampled in a lazy fashion. A function (samplerFunc) that produces sa...
unsigned int samplingAttemptsCount() const
The number of times the sampling function was called and it returned true.
void clear() override
Clear all goal states.
double minDist_
Samples returned by the sampling thread are added to the list of states only if they are at least min...
void goalSamplingThread()
The function that samples goals by calling samplerFunc_ in a separate thread.
void sampleGoal(State *st) const override
Sample a state in the goal region.
void startSampling()
Start the goal sampling thread.
bool isSampling() const
Return true if the sampling thread is active.
double distanceGoal(const State *st) const override
Compute the distance to the goal (heuristic). This function is the one used in computing the distance...
void stopSampling()
Stop the goal sampling thread.
NewStateCallbackFn callback_
If defined, this function is called when a new state is added to the list of possible samples.
double getMinNewSampleDistance() const
Get the minimum distance that a new state returned by the sampling thread needs to be away from previ...
bool couldSample() const override
Return true if GoalStates::couldSample() is true or if the sampling thread is active,...
void setNewStateCallback(const NewStateCallbackFn &callback)
Set the callback function to be called when a new state is added to the list of possible samples....
std::size_t getStateCount() const override
Return the number of valid goal states.
bool addStateIfDifferent(const State *st, double minDistance)
Add a state st if it further away that minDistance from previously added states. Return true if the s...
bool terminateSamplingThread_
Flag used to notify the sampling thread to terminate sampling.
const State * getState(unsigned int index) const override
Return a pointer to the indexth state in the state list.
std::mutex lock_
Lock for updating the set of states.
GoalSamplingFn samplerFunc_
Function that produces samples.
unsigned int maxSampleCount() const override
Return the maximum number of samples that can be asked for before repeating.
void setMinNewSampleDistance(double dist)
Set the minimum distance that a new state returned by the sampling thread needs to be away from previ...
bool hasStates() const override
Check if there are any states in this goal region.
std::function< void(const base::State *)> NewStateCallbackFn
When new samples are generated and added to the list of possible samples, a callback can be called....
unsigned int samplingAttempts_
The number of times the sampling function was called and it returned true.
std::thread * samplingThread_
Additional thread for sampling goal states.
Definition of a set of goal states.
Definition: GoalStates.h:50
A shared pointer wrapper for ompl::base::SpaceInformation.
Definition of an abstract state.
Definition: State.h:50
std::function< bool(const GoalLazySamples *, State *)> GoalSamplingFn
Goal sampling function. Returns false when no further calls should be made to it. Fills its second ar...
Main namespace. Contains everything in this library.