local_expansion.h

Go to the documentation of this file.

/* MLPACK 0.2
 *
 * Copyright (c) 2008, 2009 Alexander Gray,
 *                          Garry Boyer,
 *                          Ryan Riegel,
 *                          Nikolaos Vasiloglou,
 *                          Dongryeol Lee,
 *                          Chip Mappus, 
 *                          Nishant Mehta,
 *                          Hua Ouyang,
 *                          Parikshit Ram,
 *                          Long Tran,
 *                          Wee Chin Wong
 *
 * Copyright (c) 2008, 2009 Georgia Institute of Technology
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License as
 * published by the Free Software Foundation; either version 2 of the
 * License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 * 02110-1301, USA.
 */
#ifndef LOCAL_EXPANSION
#define LOCAL_EXPANSION

#include <climits>
//#include <values.h>

#include "fastlib/fastlib.h"
#include "kernel_aux.h"
#include "series_expansion_aux.h"

template<typename TKernelAux> 
class FarFieldExpansion;

template<typename TKernelAux>
class LocalExpansion {

 private:

  Vector center_;
  
  Vector coeffs_;
  
  int order_;
  
  const TKernelAux *ka_;

  const typename TKernelAux::TKernel *kernel_;

  const typename TKernelAux::TSeriesExpansionAux *sea_;

  OT_DEF(LocalExpansion) {
    OT_MY_OBJECT(center_);
    OT_MY_OBJECT(coeffs_);
    OT_MY_OBJECT(order_);
  }

 public:
  
  // getters and setters
  
  double bandwidth_sq() const { return kernel_->bandwidth_sq(); }
  
  Vector* get_center() { return &center_; }

  const Vector* get_center() const { return &center_; }

  const Vector& get_coeffs() const { return coeffs_; }
  
  int get_order() const { return order_; }

  int get_max_order() const { return sea_->get_max_order(); }

  void set_order(int new_order) { order_ = new_order; }

  // interesting functions...
  
  void AccumulateCoeffs(const Matrix& data, const Vector& weights,
                        int begin, int end, int order);

  void RefineCoeffs(const Matrix& data, const Vector& weights,
                    int begin, int end, int order) { }
  
  double EvaluateField(const Matrix& data, int row_num) const;
  double EvaluateField(const double *x_q) const;
  
  void Init(const Vector& center, const TKernelAux &ka);
  void Init(const TKernelAux &ka);

  template<typename TBound>
  int OrderForEvaluating(const TBound &far_field_region,
                         const TBound &local_field_region,
                         double min_dist_sqd_regions,
                         double max_dist_sqd_regions,
                         double max_error, double *actual_error) const;

  void PrintDebug(const char *name="", FILE *stream=stderr) const;

  void TranslateFromFarField(const FarFieldExpansion<TKernelAux> &se);
  
  void TranslateToLocal(LocalExpansion &se);

};

#define INSIDE_LOCAL_EXPANSION_H
#include "local_expansion_impl.h"
#undef INSIDE_LOCAL_EXPANSION_H

#endif