topology.h

Go to the documentation of this file.

/*Copyright (c) 2011, Edgar Solomonik, all rights reserved.*/

#ifndef __INT_TOPOLOGY_H__
#define __INT_TOPOLOGY_H__

#include "../interface/common.h"

namespace CTF_int {
  class mapping;
  enum TOPOLOGY { TOPOLOGY_GENERIC, TOPOLOGY_BGP, TOPOLOGY_BGQ,
                  TOPOLOGY_8D, NO_TOPOLOGY };

  /* \brief mesh/torus topology configuration */
  class topology {
    public:
      int        order;
      int *      lens;
      int *      lda;
      bool       is_activated;
      CommData * dim_comm;
      CommData   glb_comm;

      //topology();
      ~topology();

      topology(topology const & other);

      topology(int         order_,
               int const * lens_,
               CommData    cdt,
               bool        activate=false);
     
      /* \brief create (split off) MPI communicators, re-entrant */ 
      void activate();

      /* \breif free MPI communicators, re-entrant */
      void deactivate();
  };

  topology * get_phys_topo(CommData glb_comm,
                           TOPOLOGY mach);

  std::vector< topology* > get_generic_topovec(CommData   cdt);

  std::vector< topology* > peel_perm_torus(topology * phys_topology,
                                           CommData   cdt);
  std::vector< topology* > peel_torus(topology const * topo,
                                      CommData         glb_comm);

  int find_topology(topology const *           topo,
                    std::vector< topology* > & topovec);

 
   int get_best_topo(int64_t  nvirt,
                     int      topo,
                     CommData global_comm,
                     int64_t  bcomm_vol=0,
                     int64_t  bmemuse=0);
   

  void extract_free_comms(topology const *  topo,
                          int               order_A,
                          mapping const *   edge_map_A,
                          int               order_B,
                          mapping const *   edge_map_B,
                          int &             num_sub_phys_dims,
                          CommData *  *     psub_phys_comm,
                          int **            pcomm_idx);


  int can_morph(topology const * topo_keep,
                topology const * topo_change);

  void morph_topo(topology const * new_topo,
                  topology const * old_topo,
                  int              order,
                  mapping *        edge_map);
}

#endif