mult_farfield_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 MULT_FARFIELD_EXPANSION
#define MULT_FARFIELD_EXPANSION

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

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

template<typename TKernelAux> 
class MultLocalExpansion;

template<typename TKernelAux>
class MultFarFieldExpansion {
  
 private:

  Vector center_;
  
  Vector coeffs_;

  int order_;
  
  const TKernelAux *ka_;

  const typename TKernelAux::TKernel *kernel_;

  const typename TKernelAux::TSeriesExpansionAux *sea_;

  OT_DEF(MultFarFieldExpansion) {
    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(); }

  double get_weight_sum() const { return coeffs_[0]; }

  void set_order(int new_order) { order_ = new_order; }
  
  void set_center(const Vector &center) {
    
    for(index_t i = 0; i < center.length(); i++) {
      center_[i] = center[i];
    }
  }

  // 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, int order) const;
  double EvaluateField(const double *x_q, int order) const;

  double MixField(const Matrix &data, int node1_begin, int node1_end, 
                  int node2_begin, int node2_end,
                  const MultFarFieldExpansion &fe2,
                  const MultFarFieldExpansion &fe3,
                  int order2, int order3) const;

  double ConvolveField(const MultFarFieldExpansion &fe, int order) const;

  double ConvolveField(const MultFarFieldExpansion &fe2,
                       const MultFarFieldExpansion &fe3,
                       int order1, int order2, int order3) 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;

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

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

  void TranslateFromFarField(const MultFarFieldExpansion &se);
  
  void TranslateToLocal(MultLocalExpansion<TKernelAux> &se, 
                        int truncation_order);

};

#define INSIDE_MULT_FARFIELD_EXPANSION_H
#include "mult_farfield_expansion_impl.h"
#undef INSIDE_MULT_FARFIELD_EXPANSION_H

#endif