PrecomputedStateSampler.cpp
1 /*********************************************************************
2 * Software License Agreement (BSD License)
3 *
4 * Copyright (c) 2012, Willow Garage
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 Willow Garage 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 #include "ompl/base/PrecomputedStateSampler.h"
38 #include "ompl/base/StateSpace.h"
39 #include "ompl/util/Exception.h"
40 
42  const std::vector<const State *> &states)
43  : StateSampler(space), states_(states)
44 {
45  if (states_.empty())
46  throw Exception("Empty set of states to sample from was specified");
47  minStateIndex_ = 0;
48  maxStateIndex_ = states_.size() - 1;
49 }
50 
52  const std::vector<const State *> &states,
53  std::size_t minStateIndex, std::size_t maxStateIndex)
54  : StateSampler(space), states_(states), minStateIndex_(minStateIndex), maxStateIndex_(maxStateIndex)
55 {
56  if (states_.empty())
57  throw Exception("Empty set of states to sample from was specified");
58  if (minStateIndex > maxStateIndex)
59  throw Exception("Minimum state index cannot be larger than maximum state index");
60  if (maxStateIndex >= states_.size())
61  throw Exception("Index range out of bounds");
62 }
63 
65 {
66  space_->copyState(state, states_[rng_.uniformInt(minStateIndex_, maxStateIndex_)]);
67 }
68 
69 void ompl::base::PrecomputedStateSampler::sampleUniformNear(State *state, const State *near, const double distance)
70 {
71  int index = rng_.uniformInt(minStateIndex_, maxStateIndex_);
72  double dist = space_->distance(near, states_[index]);
73  if (dist > distance)
74  space_->interpolate(near, states_[index], distance / dist, state);
75  else
76  space_->copyState(state, states_[index]);
77 }
78 
79 void ompl::base::PrecomputedStateSampler::sampleGaussian(State *state, const State *mean, const double stdDev)
80 {
81  sampleUniformNear(state, mean, rng_.gaussian(0.0, stdDev));
82 }
void sampleUniformNear(State *state, const State *near, double distance) override
Sample a state near another, within a neighborhood controlled by a distance parameter.
std::size_t maxStateIndex_
The maximum index to stop sampling at.
Representation of a space in which planning can be performed. Topology specific sampling,...
Definition: StateSpace.h:134
Definition of an abstract state.
Definition: State.h:113
void sampleUniform(State *state) override
Sample a state.
std::size_t minStateIndex_
The minimum index to start sampling at.
const std::vector< const State * > & states_
The states to sample from.
void sampleGaussian(State *state, const State *mean, double stdDev) override
Sample a state using a Gaussian distribution with given mean and standard deviation (stdDev).
PrecomputedStateSampler(const StateSpace *space, const std::vector< const State * > &states)
Constructor. Takes the state space to be sampled (space) and the set of states to draw samples from (...
Abstract definition of a state space sampler.
Definition: StateSampler.h:128
The exception type for ompl.
Definition: Exception.h:78