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  {
49  class RealVectorControlUniformSampler : public ControlSampler
50  {
51  public:
53  RealVectorControlUniformSampler(const ControlSpace *space) : ControlSampler(space)
54  {
55  }
56 
57  void sample(Control *control) override;
58  };
59 
61  class RealVectorControlSpace : public ControlSpace
62  {
63  public:
65  class ControlType : public Control
66  {
67  public:
70  double operator[](unsigned int i) const
71  {
72  return values[i];
73  }
74 
77  double &operator[](unsigned int i)
78  {
79  return values[i];
80  }
81 
83  double *values;
84  };
85 
88  RealVectorControlSpace(const base::StateSpacePtr &stateSpace, unsigned int dim)
89  : ControlSpace(stateSpace), dimension_(dim), bounds_(dim), controlBytes_(dim * sizeof(double))
90  {
91  setName("RealVector" + getName());
93  }
94 
95  ~RealVectorControlSpace() override = default;
96 
98  void setBounds(const base::RealVectorBounds &bounds);
99 
101  const base::RealVectorBounds &getBounds() const
102  {
103  return bounds_;
104  }
105 
106  unsigned int getDimension() const override;
107 
108  void copyControl(Control *destination, const Control *source) const override;
109 
110  bool equalControls(const Control *control1, const Control *control2) const override;
111 
113 
114  Control *allocControl() const override;
115 
116  void freeControl(Control *control) const override;
117 
118  void nullControl(Control *control) const override;
119 
120  void printControl(const Control *control, std::ostream &out) const override;
121 
122  double *getValueAddressAtIndex(Control *control, unsigned int index) const override;
123 
124  void printSettings(std::ostream &out) const override;
125 
126  void setup() override;
127 
129  unsigned int getSerializationLength() const override;
130 
132  void serialize(void *serialization, const Control *ctrl) const override;
133 
135  void deserialize(Control *ctrl, const void *serialization) const override;
136 
137  protected:
139  unsigned int dimension_;
140 
143 
144  private:
145  std::size_t controlBytes_;
146  };
147  }
148 }
149 
150 #endif
unsigned int getSerializationLength() const override
Returns the serialization size for a single control in this space.
ControlSamplerPtr allocDefaultControlSampler() const override
Allocate the default control sampler.
void copyControl(Control *destination, const Control *source) const override
Copy a control to another.
Control * allocControl() const override
Allocate memory for a control.
void setBounds(const base::RealVectorBounds &bounds)
Set the bounds (min max values for each dimension) for the control.
bool equalControls(const Control *control1, const Control *control2) const override
Check if two controls are the same.
Definition of an abstract control.
Definition: Control.h:111
unsigned int dimension_
The dimension of the state space.
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...
const std::string & getName() const
Get the name of the control space.
void setName(const std::string &name)
Set the name of the control space.
double * getValueAddressAtIndex(Control *control, unsigned int index) const override
Many controls contain a number of double values. This function provides a means to get the memory add...
int type_
A type assigned for this control space.
Definition: ControlSpace.h:251
ompl::control::Control ControlType
Define the type of control allocated by this control space.
Definition: ControlSpace.h:131
void freeControl(Control *control) const override
Free the memory of a control.
A shared pointer wrapper for ompl::control::ControlSampler.
void printSettings(std::ostream &out) const override
Print the settings for this control space to a stream.
base::RealVectorBounds bounds_
The bounds on controls.
void serialize(void *serialization, const Control *ctrl) const override
Serializes the given control into the serialization buffer.
void deserialize(Control *ctrl, const void *serialization) const override
Deserializes a control from the serialization buffer.
@ CONTROL_SPACE_REAL_VECTOR
ompl::control::RealVectorControlSpace
void nullControl(Control *control) const override
Make the control have no effect if it were to be applied to a state for any amount of time.
void sample(Control *control) override
Sample a control. All other control sampling functions default to this one, unless a user-specified i...
unsigned int getDimension() const override
Get the dimension of this control space.
RealVectorControlUniformSampler(const ControlSpace *space)
Constructor.
void setup() override
Perform final setup steps. This function is automatically called by the SpaceInformation.
double * values
An array of length n, representing the value of the control.
double operator[](unsigned int i) const
Access element i of values. This does not check whether the index is within bounds.
void printControl(const Control *control, std::ostream &out) const override
Print a control to a stream.
const base::RealVectorBounds & getBounds() const
Get the bounds (min max values for each dimension) for the control.
Main namespace. Contains everything in this library.
The lower and upper bounds for an Rn space.