PE_Groups

PE_Groups#

#include <PE_Groups.h>

: Cette classe regroupe des fonctions permettant la creation, la

How to cite this class in this doc#

RST

:ref:`PE\_Groups <class-pe-groups>`

Markdown

[PE\_Groups](#class-pe-groups)

Detailed description#

destruction et le changement du groupe de processeurs actif. La creation du groupe principal doit etre dans le MAIN.cpp et il faut initialiser PE_Groups en lui donnant le groupe principal. Les autres groupes crees seront du meme type.

List of Private Static Methods#

check_current_group

Complete Member Function Documentation#

create_group

void PE_Groups::create_group(const ArrOfInt &liste_pe, TRUST_Deriv< Comm_Group > &group, int force_Comm_Group_NoParallel=0)

Creation d’un nouveau groupe de processeurs (utilisation possible n’importe ou dans le code)

Il faut l’appeler simultanement sur tous les processeurs du groupe current_group() avec le meme tableau liste_pe. liste_pe est la liste des rangs dans le groupe courant des processeurs que l’on veut inclure dans le groupe. Le premier de la liste sera le maitre du groupe. La liste ne doit pas comporter de doublon et doit contenir au moins un processeur. La methode type et initialize l’objet group. Il faut ensuite appeler enter_group() et exit_group() (autant de fois qu’on veut)

current_group

const Comm_Group & PE_Groups::current_group()

renvoie une reference au groupe de processeurs actif courant

enter_group

int PE_Groups::enter_group(const Comm_Group &group)

Si le processeur local appartient au groupe, le groupe courant pour ce processeur devient “group” et on renvoie 1, sinon on renvoie 0.

Une reference au groupe actuel est sauvegardee et sera restauree quand on appellera exit_group() . Cette methode doit etre appelee simultanement sur tous les processeurs du groupe “group”. Attention: a chaque enter_group() doit correspondre un exit_group() . Cependant, il n’est pas interdit d’entrer plusieurs fois de suite dans le meme groupe, ni d’entrer dans un groupe plus grand que le groupe actuel. Exemple : group1 et group2 forment une partition du groupe_TRUST() int sync_point(int x) { PE_Groups::enter_group(groupe_TRUST()); int i = mp_sum(x); PE_Groups::exit_group() ; return i; } if (PE_Groups::enter_group(group1)) { s1 = mp_sum(x); // Somme sur le groupe 2 // Point de synchro avec l’autre groupe: s_all = sync_point(x); } else if (PE_Groups::enter_group(group2)) { s2 = mp_sum(x); // Point de synchro avec l’autre groupe: s_all = sync_point(x); } else { Cerr <<”Error: processor “ <<me() <<” is not within a subgroup.”; exit(); } PE_Groups::exit_group() ; // Sort du sous - groupe

exit_group

void PE_Groups::exit_group()

Retourne dans le groupe ou l’on etait avant le dernier enter_group() reussi (dont le resultat a ete 1).

Cette methode doit etre appelee simultanement sur tous les processeurs du current_group() actif juste avant exit_group() ).

finalize

void PE_Groups::finalize()

Methode a appeler en fin d’execution, une fois qu’on est revenu dans le groupe_TRUST() et juste avant de detruire de Comm_Group .

principal.

get_nb_groups

const int & PE_Groups::get_nb_groups()

get_node_group

const Comm_Group & PE_Groups::get_node_group()

Renvoie une reference au groupe sur les noeuds.

get_node_master

const Comm_Group & PE_Groups::get_node_master()

Renvoie le groupe contenant le maitre de mon noeud.

groupe_TRUST

const Comm_Group & PE_Groups::groupe_TRUST()

Renvoie une reference au groupe de tous les processeurs TRUST.

init_group

void PE_Groups::init_group(const ArrOfInt &liste_pe, TRUST_Deriv< Comm_Group > &group)

Initialisation d’un nouveau groupe de processeurs deja instantie (utilisation possible n’importe ou dans le code)

Il faut l’appeler simultanement sur tous les processeurs du groupe current_group() avec le meme tableau liste_pe. liste_pe est la liste des rangs dans le groupe courant des processeurs que l’on veut inclure dans le groupe. Le premier de la liste sera le maitre du groupe. La liste ne doit pas comporter de doublon et doit contenir au moins un processeur. La methode type et initialize l’objet group. Il faut ensuite appeler enter_group() et exit_group() (autant de fois qu’on veut)

initialize

void PE_Groups::initialize(const Comm_Group &groupe_trio_u)

Methode a appeler au debut de l’execution (MAIN.

cpp) Elle initialise current_group() avec groupe_trio_u

initialize_node

void PE_Groups::initialize_node(const Comm_Group &ngrp)

Methode a appeler apres l’initialisation de trio_u_world et l’initialisation des compteurs statistiques de TRUST.

initialize_node_master

void PE_Groups::initialize_node_master(const Comm_Group &ngrp)

Methode a appeler apres l’initialisation de trio_u_world et de node_group et l’initialisation des compteurs statistiques de TRUST.

rank_translate

int PE_Groups::rank_translate(int rank, const Comm_Group &group, const Comm_Group &dest_group=current_group())

Calcule le rank dans le groupe courant du processeur de rang “rank” dans le “group”.

Il faut que 0 < = rank <group.nproc() Si le processeur en question n’appartient pas au groupe courant, renvoie-1.

check_current_group

int PE_Groups::check_current_group()

Attributes Documentation#

current_group_ (private)

const Comm_Group * PE_Groups::current_group_ = 0