Clustering.hpp

Go to the documentation of this file.

/*
 * STRUMPACK -- STRUctured Matrices PACKage, Copyright (c) 2014, The
 * Regents of the University of California, through Lawrence Berkeley
 * National Laboratory (subject to receipt of any required approvals
 * from the U.S. Dept. of Energy).  All rights reserved.
 *
 * If you have questions about your rights to use or distribute this
 * software, please contact Berkeley Lab's Technology Transfer
 * Department at TTD@lbl.gov.
 *
 * NOTICE. This software is owned by the U.S. Department of Energy. As
 * such, the U.S. Government has been granted for itself and others
 * acting on its behalf a paid-up, nonexclusive, irrevocable,
 * worldwide license in the Software to reproduce, prepare derivative
 * works, and perform publicly and display publicly.  Beginning five
 * (5) years after the date permission to assert copyright is obtained
 * from the U.S. Department of Energy, and subject to any subsequent
 * five (5) year renewals, the U.S. Government is granted for itself
 * and others acting on its behalf a paid-up, nonexclusive,
 * irrevocable, worldwide license in the Software to reproduce,
 * prepare derivative works, distribute copies to the public, perform
 * publicly and display publicly, and to permit others to do so.
 *
 * Developers: Pieter Ghysels, Francois-Henry Rouet, Xiaoye S. Li.
 *             (Lawrence Berkeley National Lab, Computational Research
 *             Division).
 *
 */
#ifndef STRUMPACK_CLUSTERING_HPP
#define STRUMPACK_CLUSTERING_HPP
 
#include <random>
#include <vector>
 
#include "structured/ClusterTree.hpp"
#include "dense/DenseMatrix.hpp"
 
namespace strumpack {
 
  enum class ClusteringAlgorithm {
    NATURAL,    
    TWO_MEANS,  
    KD_TREE,    
    PCA,        
    COBBLE      
  };
 
  inline std::string get_name(ClusteringAlgorithm c) {
    switch (c) {
    case ClusteringAlgorithm::NATURAL: return "natural";
    case ClusteringAlgorithm::TWO_MEANS: return "2means";
    case ClusteringAlgorithm::KD_TREE: return "kdtree";
    case ClusteringAlgorithm::PCA: return "PCA";
    case ClusteringAlgorithm::COBBLE: return "cobble";
    default: return "unknown";
    }
  }
 
  inline ClusteringAlgorithm
  get_clustering_algorithm(const std::string& c) {
    if (c == "natural")     return ClusteringAlgorithm::NATURAL;
    else if (c == "2means") return ClusteringAlgorithm::TWO_MEANS;
    else if (c == "kdtree") return ClusteringAlgorithm::KD_TREE;
    else if (c == "pca")    return ClusteringAlgorithm::PCA;
    else if (c == "cobble") return ClusteringAlgorithm::COBBLE;
    else {
      std::cerr << "WARNING: binary tree clustering not recognized,"
                << " setting to recursive 2 means (2means)."
                << std::endl;
      return ClusteringAlgorithm::TWO_MEANS;
    }
  }
 
 
  template<typename T> void
  pca_partition(DenseMatrix<T>& p, std::vector<std::size_t>& nc, int* perm);
  template<typename T> structured::ClusterTree
  recursive_pca(DenseMatrix<T>& p, std::size_t cluster_size, int* perm);
 
  template<typename T> void
  cobble_partition(DenseMatrix<T>& p, std::vector<std::size_t>& nc, int* perm);
  template<typename T> structured::ClusterTree
  recursive_cobble(DenseMatrix<T>& p, std::size_t cluster_size, int* perm);
 
  template<typename T> structured::ClusterTree
  recursive_2_means(DenseMatrix<T>& p, std::size_t cluster_size,
                    int* perm, std::mt19937& generator);
 
  template<typename T> void
  kd_partition(DenseMatrix<T>& p, std::vector<std::size_t>& nc,
               std::size_t cluster_size, int* perm);
  template<typename T> structured::ClusterTree
  recursive_kd(DenseMatrix<T>& p, std::size_t cluster_size, int* perm);
 
  template<typename scalar_t>
  structured::ClusterTree binary_tree_clustering
  (ClusteringAlgorithm algo, DenseMatrix<scalar_t>& p,
   std::vector<int>& perm, std::size_t cluster_size) {
    structured::ClusterTree tree;
    perm.resize(p.cols());
    std::iota(perm.begin(), perm.end(), 1);
    switch (algo) {
    case ClusteringAlgorithm::NATURAL: {
      tree.size = p.cols();
      tree.refine(cluster_size);
    } break;
    case ClusteringAlgorithm::TWO_MEANS: {
      std::mt19937 gen(1); // reproducible
      tree = recursive_2_means(p, cluster_size, perm.data(), gen);
    } break;
    case ClusteringAlgorithm::KD_TREE:
      tree = recursive_kd(p, cluster_size, perm.data()); break;
    case ClusteringAlgorithm::PCA:
      tree = recursive_pca(p, cluster_size, perm.data()); break;
    case ClusteringAlgorithm::COBBLE:
      tree = recursive_cobble(p, cluster_size, perm.data()); break;
    default:
      std::cerr << "ERROR: clustering type not recognized." << std::endl;
    }
    return tree;
  }
 
 
} // end namespace strumpack
 
#endif // STRUMPACK_CLUSTERING_HPP