moveit2
The MoveIt Motion Planning Framework for ROS 2.
multivariate_gaussian.hpp
Go to the documentation of this file.
1 /*********************************************************************
2  * Software License Agreement (BSD License)
3  *
4  * Copyright (c) 2009, Willow Garage, Inc.
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 
40 #pragma once
41 
42 #include <Eigen/Core>
43 #include <Eigen/Cholesky>
44 
45 #include <rsl/random.hpp>
46 #include <cstdlib>
47 
48 namespace stomp_moveit
49 {
50 namespace math
51 {
53 typedef std::shared_ptr<MultivariateGaussian> MultivariateGaussianPtr;
54 
59 {
60 public:
61  template <typename Derived1, typename Derived2>
62  MultivariateGaussian(const Eigen::MatrixBase<Derived1>& mean, const Eigen::MatrixBase<Derived2>& covariance);
63 
69  template <typename Derived>
70  void sample(Eigen::MatrixBase<Derived>& output, bool use_covariance = true);
71 
72 private:
73  Eigen::VectorXd mean_;
74  Eigen::MatrixXd covariance_;
75  Eigen::MatrixXd covariance_cholesky_;
77  int size_;
78  std::normal_distribution<double> normal_dist_;
79 };
80 
82 
83 template <typename Derived1, typename Derived2>
84 MultivariateGaussian::MultivariateGaussian(const Eigen::MatrixBase<Derived1>& mean,
85  const Eigen::MatrixBase<Derived2>& covariance)
86  : mean_(mean), covariance_(covariance), covariance_cholesky_(covariance_.llt().matrixL()), normal_dist_(0.0, 1.0)
87 {
88  size_ = mean.rows();
89 }
90 
91 template <typename Derived>
92 void MultivariateGaussian::sample(Eigen::MatrixBase<Derived>& output, bool use_covariance)
93 {
94  for (int i = 0; i < size_; ++i)
95  output(i) = normal_dist_(rsl::rng());
96 
97  if (use_covariance)
98  {
99  output = mean_ + covariance_cholesky_ * output;
100  }
101  else
102  {
103  output = mean_ + output;
104  }
105 }
106 } // namespace math
107 } // namespace stomp_moveit
Generates samples from a multivariate gaussian distribution.
void sample(Eigen::MatrixBase< Derived > &output, bool use_covariance=true)
generates random values using a normal distribution.
MultivariateGaussian(const Eigen::MatrixBase< Derived1 > &mean, const Eigen::MatrixBase< Derived2 > &covariance)
std::shared_ptr< MultivariateGaussian > MultivariateGaussianPtr