Boost Graph [Tutoriel]

**gbdivers** · 07/12/2011, 11h16

Premi�re version (incompl�te) pour une FAQ sur Boost Graph. J'ai remarqu� que beaucoup de d�butant (moi compris) h�sitaient � l'utiliser parce qu'elle semble complexe en premier abord.

EDIT : version finale dans l'article : http://gbelz.developpez.com/boost/graph/

**3DArchi** · 07/12/2011, 12h15

whouh

Pourquoi ne pas proposer un tutoriel ?

**r0d** · 07/12/2011, 12h48

Ooomaagaaad!!!!
Si tu avais �cris �a il y a deux ans, �a m'aurait �vit� des heures et des heures de codage de ma propre lib de graphe, qui au final est toute pourrite en plus. Je n'�tais pas parvenu � utiliser boost.graph et j'avais abandonn�

Un �norme

Je regarderai �a quand j'aurais quelques heures devant moi

Encore merci!

**gbdivers** · 07/12/2011, 12h50

Il y a d�j� un tutoriel sur Boost graph, �a ferait doublon. Et le but est surtout de donner des lignes de code directement exploitable (comprendre copi�-collable) avec juste les explications n�cessaires.

**Luc Hermitte** · 07/12/2011, 14h19

Je manque de recul aussi.
Toujours est-il que c'est plus pour du tuto que de la FAQ � mon go�t.

PS: (syntaxe vim pour substitute)
s/graph\(s\=\)\>/graphe\1/gc
s/g�n�ric/g�n�rique/
s/librairie/biblioth�que/

D�sol� de ne pas �tre plus constructif, je ne pratique pas cette biblioth�que.

**gbdivers** · 07/12/2011, 14h41

# Que signifie les param�tres pass�s � adjacent_list ?
adjacency_list est une classe templat�e acceptant plusieurs param�tres permettant de sp�cifier le comportement de cette classe. Ces param�tres permettent de choisir les types de conteneurs utilis�s en interne (OutEdgeList, VertexList et EdgeList), les propri�t�s associ�es aux �l�ments du graphe (VertexProperties, EdgeProperties, GraphProperties et Directed).

Voici la liste des param�tres et les valeurs par d�faut de adjacency_list :

Code :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
5
6
7
8
9
adjacency_list<
   OutEdgeList 		= vecS, 
   VertexList 		= vecS, 
   Directed		= directedS,
   VertexProperties 	= no_property,  
   EdgeProperties 	= no_property,
   GraphProperties 	= no_property, 
   EdgeList		= listS
>

1. Les types des conteneurs (OutEdgeList, VertexList et EdgeList) peuvent �tre choisir en utilisant les tags pr�cis�s dans la liste suivante :

Code :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
5
6
vecS		= std::vector
listS		= std::list
slistS		= std::slist
setS		= std::set
multisetS	= std::multiset
hash_setS	= std::hash_set

Le choix du type de conteneur aura une influence sur les performances des algorithmes utilis�s. La complexit� des fonctions de Boost Graph en fonction du type de conteneur est indiqu� dans la page suivante : Choosing the Edgelist and VertexList

2. Pour les propri�t�s associ�es aux �l�ments d'un graphe, on peut soit utiliser le mot cl� no_property pour ne pas associer d'information, soit utiliser une des m�thodes indiqu�es dans la FAQ
# Quelles sont les diff�rentes m�thodes permettant d'associer des informations � un �l�ment de Boost Graph ?

3. Pour terminer, le param�tre Directed permet de pr�ciser si le graphe est orient� ou non et si les arcs seront unidirectionnels ou bidirectionnels.

Code :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
undirectedS	= graphe non orienté
directedS	= graphe orienté avec des arcs unidirectionnels
bidirectionalS	= graphe orienté avec des arcs bidirectionnels

En fonction du type de graphe, certaines fonctions ne seront pas disponibles. Par exemple, avec un graphe orient� unidirectionnel, la fonction in_edges, permettant de r�cup�rer la liste des arcs entrant, n'est pas possible.

**gbdivers** · 07/12/2011, 14h56

Envoy� par Luc Hermitte

PS: (syntaxe vim pour substitute)
s/graph\(s\=\)\>/graphe\1/gc
s/g�n�ric/g�n�rique/
s/librairie/biblioth�que/

Fait

**gbdivers** · 07/12/2011, 14h59

En fait, � la base, ce n'�tait que quelques notes que j'avais pris lorsque j'avais regard� BGL. Je pensais pas que �a prendrait tant de place au final. Finalement, �a va probablement finir en article.

**bretus** · 07/12/2011, 23h55

Bonsoir,

Tr�s bonne initiative! En effet, un article, �a serait pas mal. Quelques remarques (� valider).

Renvoyer aussi vers ce tuto?

http://matthieu-brucher.developpez.c...mplementation/

remove/clear

Code :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
 
// suppression d'un sommet
remove_vertex(v1, g);

Peut-�tre souligner le fait qu'un sommet est suppos� "clean" avant de faire "remove" (sinon, on provoque une catastrophe)

=> pour ne pas se prendre le choux

Code :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
 
clear_vertex(v1,g);
remove_vertex(v1, g);

undirectedS/directedS/bidirectionalS

Code :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
 
undirectedS	   = graphe non orienté
directedS	   = graphe orienté avec des arcs unidirectionnels
bidirectionalS = graphe orienté avec des arcs bidirectionnels

Peut-�tre pr�ciser la notion de unidirectionnels/bidirectionnels. En gros :

directedS ne permet pas de r�cup�rer les arcs entrants dans un sommet (in_edges) d'o� l�existence de bidirectionalS. Tous deux sont des graphes orient�s au niveau conceptuel.

=> Par d�faut, on choisit entre undirectedS ou birectionalS en fonction de la nature du graphe (non orient� / orient�). directedS sera une optimisation possible pour consommer moins de m�moire.

Faire une note sur boost::tie

C'est assez paumant dans la documentation officielle quand on ne le connait pas.

Code :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
5
6
 
// Récupérer tous les sommets
std::pair<vertex_iterator_t, vertex_iterator_t> it = boost::vertices(g);
// Equivalent à ce qu'on rencontre dans la doc sous forme de 
vertex_iterator it, it_end;
boost::tie( it, it_end ) = boost::vertices(g);

Mise en garde

La structure doit �tre adapt�e aux algorithmes. Les algorithmes sont rarement impl�ment�s en fonction du conteneur (escroquerie template

).

Exemple :

- On peut concevoir la notion de graphe planaire sur un graphe orient� (en ignorant l'orientation). Le test de plan�it� ne sera pourtant correct que sur un undirectedS.

- Si in_edges n'est pas pr�sent dans la structure (directedS), boost::graph ne s'amuse pas � calculer sans. On n'a pas par exemple in_degree sur la base d'un scan/comptage de la liste des arcs.

Comme je le faisais remarquer, c'est un peu comme si std::find ne fonctionnait pas sur std::vector puisqu'il n'est pas index�.

bundle properties

Tu ne parles pas de la syntaxe commode :

Code :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
5
6
 
vertex_descriptor v = /* ... */
VertexProperties const& vertexProperties = g[v];
 
edge_descriptor e = /* ... */
EdgeProperties const& vertexProperties = g[e];

C'est le mal?

++

**gbdivers** · 08/12/2011, 00h12

Renvoyer aussi vers ce tuto?

�a sera fait dans la version finale de l'article

remove/clear

undirectedS/directedS/bidirectionalS

Faire une note sur boost::tie

Mise en garde

Si le format devient un article plut�t qu'une FAQ, je pourrais d�tailler un peu plus ces parties. En particulier donner quelques lignes de code pour chaque analyses les plus utilis�es sur les graphes. Et d�tailler les algorithmes fournit pas BGL.

bundle properties

Un oubli de ma part

HS : j'ai �galement plein de notes sur C++11, �a pourrait int�resser un article ?

**bretus** · 08/12/2011, 00h23

Pas facile d'organiser ce genre d'information. Je t'ai remis ce qui m'a le plus g�ner il y a 3/4 mois.

Bon courage

Envoy� par gbdivers

HS : j'ai �galement plein de notes sur C++11, �a pourrait int�resser un article ?

Dans 10 ans oui (Il y en a qui esp�re encore le support de Visual 6...) Mais ne divergeons pas

**Flob90** · 08/12/2011, 00h26

Envoy� par gbdivers

HS : j'ai �galement plein de notes sur C++11, �a pourrait int�resser un article ?

Oui, mais plut�t pour des entr�e de FaQ (je crois qu'il n'y a pas encore grand chose sur le C++11) AMA, ou des articles plus approfondis sur des points pr�cis du C++11 (faire un seul article sur tout donnerait quelque chose d'un peu "brouillon" et superficiel je pense).

**gbdivers** · 13/12/2011, 16h44

Voici une premi�re derni�re version

**bretus** · 15/12/2011, 18h15

Nickel, merci!

**gbdivers** · 15/12/2011, 20h31

Petite pr�cision, j'ai volontairement peu abord� la partie algo, si quelqu'un souhaite s'y coller, �a me va

Je posterai le tuto en relecture ortho pendant les vacances pour une annonce en d�but d'ann�e

**CedricMocquillon** · 16/12/2011, 15h49

Salut,

J'ai pas tout lu en d�tail mais fin de la page 5, les m�thodes source et target renvoient des vertex_descriptor et non pas des edge_descriptor:

Code :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
Graph::edge_descriptor v1 = boost::target(e1, g);
Graph::edge_descriptor v2 = boost::source(e5, g);
if (v1 == v2)
  std::cout << "Same vertex" << std::endl;

� remplacer par

Code :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
Graph::vertex_descriptor v1 = boost::target(e1, g);
Graph::vertex_descriptor v2 = boost::source(e5, g);
if (v1 == v2)
  std::cout << "Same vertex" << std::endl;

**3DArchi** · 16/12/2011, 20h25

**gbdivers** · 18/01/2012, 14h42

Envoy� par CedricMocquillon

Salut,

J'ai pas tout lu en d�tail mais fin de la page 5, les m�thodes source et target renvoient des vertex_descriptor et non pas des edge_descriptor:

Code :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
Graph::edge_descriptor v1 = boost::target(e1, g);
Graph::edge_descriptor v2 = boost::source(e5, g);
if (v1 == v2)
  std::cout << "Same vertex" << std::endl;

� remplacer par

Code :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
Graph::vertex_descriptor v1 = boost::target(e1, g);
Graph::vertex_descriptor v2 = boost::source(e5, g);
if (v1 == v2)
  std::cout << "Same vertex" << std::endl;

Fait.

Et propos� en relecture ortho

**gbdivers** · 26/02/2012, 00h30

Version finale : http://gbelz.developpez.com/boost/graph
A archiver et � annoncer sur le portail
Merci � tous

Boost Graph [Tutoriel]

Contribuez C++

Discussions similaires

Partager

Partager