affine-function.hh

Go to the documentation of this file.

// Copyright (c) 2017, Joseph Mirabel
// Authors: Joseph Mirabel (joseph.mirabel@laas.fr)
//
 
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
//
// 1. Redistributions of source code must retain the above copyright
//    notice, this list of conditions and the following disclaimer.
//
// 2. 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 HPP_CONSTRAINTS_AFFINE_FUNCTION_HH
#define HPP_CONSTRAINTS_AFFINE_FUNCTION_HH
 
#include <hpp/constraints/config.hh>
#include <hpp/constraints/differentiable-function.hh>
#include <hpp/constraints/fwd.hh>
 
namespace hpp {
namespace constraints {
 
 
class HPP_CONSTRAINTS_DLLAPI Identity
    : public constraints::DifferentiableFunction {
 public:
  static IdentityPtr_t create(const LiegroupSpacePtr_t space,
                              const std::string& name) {
    IdentityPtr_t ptr(new Identity(space, name));
    return ptr;
  }
 
  Identity(const LiegroupSpacePtr_t space, const std::string& name)
      : DifferentiableFunction(space->nq(), space->nv(), space, name) {}
 
 protected:
  void impl_compute(LiegroupElementRef y, vectorIn_t arg) const {
    y.vector() = arg;
  }
 
  void impl_jacobian(matrixOut_t J, vectorIn_t) const { J.setIdentity(); }
 
  bool isEqual(const DifferentiableFunction& other) const {
    dynamic_cast<const Identity&>(other);
    if (!DifferentiableFunction::isEqual(other)) return false;
 
    return true;
  }
 
 private:
  Identity() {}
  HPP_SERIALIZABLE();
};  // class Identity
 
class HPP_CONSTRAINTS_DLLAPI AffineFunction : public DifferentiableFunction {
 public:
  static AffineFunctionPtr_t create(const matrixIn_t& J,
                                    const std::string name = "LinearFunction") {
    return AffineFunctionPtr_t(new AffineFunction(J, name));
  }
 
  static AffineFunctionPtr_t create(const matrixIn_t& J, const vectorIn_t& b,
                                    const std::string name = "LinearFunction") {
    return AffineFunctionPtr_t(new AffineFunction(J, b, name));
  }
 
 protected:
  AffineFunction(const matrixIn_t& J, const std::string name = "LinearFunction")
      : DifferentiableFunction(J.cols(), J.cols(), LiegroupSpace::Rn(J.rows()),
                               name),
        J_(J),
        b_(vector_t::Zero(J.rows())) {
    init();
  }
 
  AffineFunction(const matrixIn_t& J, const vectorIn_t& b,
                 const std::string name = "LinearFunction")
      : DifferentiableFunction(J.cols(), J.cols(), LiegroupSpace::Rn(J.rows()),
                               name),
        J_(J),
        b_(b) {
    init();
  }
 
  bool isEqual(const DifferentiableFunction& other) const {
    const AffineFunction& castother =
        dynamic_cast<const AffineFunction&>(other);
    if (!DifferentiableFunction::isEqual(other)) return false;
 
    if (J_ != castother.J_) return false;
    if (b_ != castother.b_) return false;
 
    return true;
  }
 
 private:
  void impl_compute(LiegroupElementRef y, vectorIn_t x) const {
    y.vector().noalias() = J_ * x + b_;
  }
 
  void impl_jacobian(matrixOut_t jacobian, vectorIn_t) const { jacobian = J_; }
 
  void init() {
    assert(J_.rows() == b_.rows());
    activeParameters_ = (J_.array() != 0).colwise().any();
    activeDerivativeParameters_ = activeParameters_;
  }
 
  const matrix_t J_;
  const vector_t b_;
 
  AffineFunction() {}
  HPP_SERIALIZABLE();
};  // class AffineFunction
 
struct HPP_CONSTRAINTS_DLLAPI ConstantFunction : public DifferentiableFunction {
 public:
  static ConstantFunctionPtr_t create(
      const vector_t& constant, const size_type& sizeIn,
      const size_type& sizeInDer, const std::string name = "ConstantFunction") {
    return ConstantFunctionPtr_t(
        new ConstantFunction(constant, sizeIn, sizeInDer, name));
  }
  static ConstantFunctionPtr_t create(
      const LiegroupElement& element, const size_type& sizeIn,
      const size_type& sizeInDer, const std::string name = "ConstantFunction") {
    return ConstantFunctionPtr_t(
        new ConstantFunction(element, sizeIn, sizeInDer, name));
  }
 
 protected:
  ConstantFunction(const vector_t& constant, const size_type& sizeIn,
                   const size_type& sizeInDer,
                   const std::string name = "ConstantFunction")
      : DifferentiableFunction(sizeIn, sizeInDer,
                               LiegroupSpace::Rn(constant.rows()), name),
        c_(constant, outputSpace()) {}
 
  ConstantFunction(const LiegroupElement& element, const size_type& sizeIn,
                   const size_type& sizeInDer,
                   const std::string name = "ConstantFunction")
      : DifferentiableFunction(sizeIn, sizeInDer, element.space(), name),
        c_(element) {}
 
  void impl_compute(LiegroupElementRef r, vectorIn_t) const { r = c_; }
 
  void impl_jacobian(matrixOut_t J, vectorIn_t) const { J.setZero(); }
 
  bool isEqual(const DifferentiableFunction& other) const {
    const ConstantFunction& castother =
        dynamic_cast<const ConstantFunction&>(other);
    if (!DifferentiableFunction::isEqual(other)) return false;
 
    if (c_.vector() == castother.c_.vector()) return false;
 
    return true;
  }
 
  const LiegroupElement c_;
 
 private:
  ConstantFunction() {}
  HPP_SERIALIZABLE();
};  // class ConstantFunction
 
}  // namespace constraints
}  // namespace hpp
 
#endif  // HPP_CONSTRAINTS_AFFINE_FUNCTION_HH