This file is indexed.

/usr/include/kido/optimizer/nlopt/NloptSolver.hpp is in libkido-optimizer-nlopt-dev 0.1.0+dfsg-2+b2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
/*
 * Copyright (c) 2014-2015, Georgia Tech Research Corporation
 * All rights reserved.
 *
 * Author(s): Jeongseok Lee <jslee02@gmail.com>
 *
 * Georgia Tech Graphics Lab and Humanoid Robotics Lab
 *
 * Directed by Prof. C. Karen Liu and Prof. Mike Stilman
 * <karenliu@cc.gatech.edu> <mstilman@cc.gatech.edu>
 *
 * This file is provided under the following "BSD-style" License:
 *   Redistribution and use in source and binary forms, with or
 *   without modification, are permitted provided that the following
 *   conditions are met:
 *   * Redistributions of source code must retain the above copyright
 *     notice, this list of conditions and the following disclaimer.
 *   * Redistributions in binary form must reproduce the above
 *     copyright notice, this list of conditions and the following
 *     disclaimer in the documentation and/or other materials provided
 *     with the distribution.
 *   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
 *   CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
 *   INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
 *   MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 *   DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
 *   CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 *   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 *   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
 *   USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
 *   AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 *   LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
 *   ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 *   POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef KIDO_OPTIMIZER_NLOPT_NLOPTSOLVER_HPP_
#define KIDO_OPTIMIZER_NLOPT_NLOPTSOLVER_HPP_

#include <nlopt.hpp>

#include "kido/common/Deprecated.hpp"
#include "kido/optimizer/Solver.hpp"

namespace kido {
namespace optimizer {

class Problem;

/// \brief class NloptSolver
class NloptSolver : public Solver
{
public:

  /// Default Constructor
  NloptSolver(const Solver::Properties& _properties = Solver::Properties(),
              nlopt::algorithm _alg = nlopt::LN_COBYLA);

  /// Alternative Constructor
  NloptSolver(std::shared_ptr<Problem> _problem,
              nlopt::algorithm _alg = nlopt::LN_COBYLA);

  /// Destructor
  virtual ~NloptSolver();

  // Documentation inherited
  bool solve() override;

  // Documentation inherited
  Eigen::VectorXd getLastConfiguration() const;

  // Documentation inherited
  std::string getType() const override;

  // Documentation inherited
  std::shared_ptr<Solver> clone() const override;

  /// Copy the Properties of another NloptSolver
  void copy(const NloptSolver& _other);

  /// Copy the Properties of another NloptSolver
  NloptSolver& operator=(const NloptSolver& _other);

  /// Set the algorithm that is to be used by the nlopt solver
  void setAlgorithm(nlopt::algorithm _alg);

  /// Get the algorithm that is to be used by the nlopt solver
  nlopt::algorithm getAlgorithm() const;

  /// Set number of maximum evaluations
  ///
  /// Deprecated: Please use setNumMaxIterations() instead
  DEPRECATED(5.0)
  virtual void setNumMaxEvaluations(size_t _numVal);

  /// Get number of maximum evaluations
  ///
  /// Deprecated: Please use getNumMaxIterations() instead
  DEPRECATED(5.0)
  virtual size_t getNumEvaluationMax() const;

private:
  /// \brief Wrapping function for nlopt callback function, nlopt_func
  static double _nlopt_func(unsigned _n,
                            const double* _x,
                            double* _gradient,  // nullptr if not needed
                            void* _func_data);

  /// \brief Wrapping function for nlopt callback function, nlopt_mfunc
  static void _nlopt_mfunc(unsigned _m,
                           double* _result,
                           unsigned _n,
                           const double* _x,
                           double* _gradient,  // nullptr if not needed
                           void* _func_data);

  /// \brief NLOPT data structure
  std::unique_ptr<nlopt::opt> mOpt;

  /// Algorithm to be used by the nlopt::opt
  nlopt::algorithm mAlg;

  /// \brief Optimization parameters
  std::vector<double> mX;

  /// \brief Optimum value of the objective function
  double mMinF;
};

}  // namespace optimizer
}  // namespace kido

#endif  // KIDO_OPTIMIZER_NLOPT_NLOPTSOLVER_HPP_