RealVectorControlSpace.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_CONTROL_SPACES_REAL_VECTOR_CONTROL_SPACE_
38 #define OMPL_CONTROL_SPACES_REAL_VECTOR_CONTROL_SPACE_
39 
40 #include "ompl/control/ControlSpace.h"
41 #include "ompl/base/spaces/RealVectorBounds.h"
42 #include <vector>
43 
44 namespace ompl
45 {
46  namespace control
47  {
48 
51  {
52  public:
53 
56  {
57  }
58 
59  virtual void sample(Control *control);
60  };
61 
64  {
65  public:
66 
68  class ControlType : public Control
69  {
70  public:
71 
74  double operator[](unsigned int i) const
75  {
76  return values[i];
77  }
78 
81  double& operator[](unsigned int i)
82  {
83  return values[i];
84  }
85 
87  double *values;
88  };
89 
91  RealVectorControlSpace(const base::StateSpacePtr &stateSpace, unsigned int dim) :
92  ControlSpace(stateSpace), dimension_(dim), bounds_(dim), controlBytes_(dim * sizeof(double))
93  {
94  setName("RealVector" + getName());
96  }
97 
98  virtual ~RealVectorControlSpace()
99  {
100  }
101 
103  void setBounds(const base::RealVectorBounds &bounds);
104 
107  {
108  return bounds_;
109  }
110 
111  virtual unsigned int getDimension() const;
112 
113  virtual void copyControl(Control *destination, const Control *source) const;
114 
115  virtual bool equalControls(const Control *control1, const Control *control2) const;
116 
117  virtual ControlSamplerPtr allocDefaultControlSampler() const;
118 
119  virtual Control* allocControl() const;
120 
121  virtual void freeControl(Control *control) const;
122 
123  virtual void nullControl(Control *control) const;
124 
125  virtual void printControl(const Control *control, std::ostream &out) const;
126 
127  virtual double* getValueAddressAtIndex(Control *control, const unsigned int index) const;
128 
129  virtual void printSettings(std::ostream &out) const;
130 
131  virtual void setup();
132 
134  virtual unsigned int getSerializationLength() const;
135 
137  virtual void serialize(void *serialization, const Control *ctrl) const;
138 
140  virtual void deserialize(Control *ctrl, const void *serialization) const;
141 
142  protected:
143 
145  unsigned int dimension_;
146 
149 
150  private:
151  std::size_t controlBytes_;
152  };
153  }
154 }
155 
156 #endif
Abstract definition of a control sampler. Motion planners that need to sample controls will call func...
ompl::control::RealVectorControlSpace
RealVectorControlSpace(const base::StateSpacePtr &stateSpace, unsigned int dim)
Constructor takes the state space the controls correspond to and the dimension of the space of contro...
Definition of an abstract control.
Definition: Control.h:48
A boost shared pointer wrapper for ompl::base::StateSpace.
A boost shared pointer wrapper for ompl::control::ControlSampler.
const base::RealVectorBounds & getBounds() const
Get the bounds (min max values for each dimension) for the control.
Main namespace. Contains everything in this library.
Definition: Cost.h:42
unsigned int dimension_
The dimension of the state space.
A control space representing Rn.
A control space representing the space of applicable controls.
Definition: ControlSpace.h:66
RealVectorControlUniformSampler(const ControlSpace *space)
Constructor.
Uniform sampler for the Rn state space.
double & operator[](unsigned int i)
Access element i of values. This does not check whether the index is within bounds.
The lower and upper bounds for an Rn space.
double operator[](unsigned int i) const
Access element i of values. This does not check whether the index is within bounds.
virtual void sample(Control *control)
Sample a control. All other control sampling functions default to this one, unless a user-specified i...
base::RealVectorBounds bounds_
The bounds on controls.
double * values
An array of length n, representing the value of the control.