Découverte de la bibliothèque Php JpGraph
Découverte de la librairie Php JpGraph
Date de publication : 22/09/2007 , Date de mise à jour : 24/10/2007
II. Présentation des principaux graphiques
II-A. Présentation des données utilisées
II-B. Graphique secteur
II-C. Graphique secteur 3D
II-D. Graphique histogrammes
II-E. Graphique courbe
II-F. Graphique histogrammes groupés
II-G. Graphique histogrammes horizontaux
II-H. Graphique histogrammes et courbe
II-I. Graphique histogrammes accumulés
II-J. Graphique radar
II. Présentation des principaux graphiques
Pour les exemples nous utiliserons les données fictives d'une entreprise intitulée « maPetiteEntreprise.com ». Imaginons que l'activité de cette entreprise est la vente de matériel, de logiciel ainsi que de services.
Voici un aperçu des différents graphiques de ce chapitre (histoire de vous mettre l'eau à la bouche...) :
Aperçu | Type de graphique | Description |
---|---|---|
Secteur | Nombre d'unités vendues sur les différents exercices (2004, 2005 ...) | |
Secteur 3D | Nombre d'unités vendues sur les différents exercices (2004, 2005 ...) | |
Histogrammes | Nombre d'unités vendues sur les différents exercices (2004, 2005 ...) | |
Courbe | Chiffre d'affaires de l'année 2006 par mois | |
Histogrammes groupés | Chiffre d'affaires par mois et par années sur les différents exercices (2004, 2005 ...) | |
Histogrammes et courbe | Chiffre d'affaires et unités vendues pour l'année 2006 | |
Histogrammes accumulés | Chiffre d'affaires 2006 avec répartition du type de vente | |
Radar | Chiffre d'affaires de l'année 2006 |
II-A. Présentation des données utilisées
Les données sont stockées dans une base Mysql (la base tutoJpGraph) et dans une table « ventes » qui représente l'ensemble des prestations effectuées par la société entre 2004 et 2006. Pour plus de clarté et de simplicité dans les exemples j'ai fait le choix de regrouper ces données dans une table unique.
La structure de la table ventes est la suivante :
Structure de la table des ventes |
|
Vous pouvez télécharger le fichier Sql de la base utilisée pour cet article. L'import des données pourra être réalisé à l'aide de l'outil de votre choix (phpMyAdmin, mysql query browser ou autre...).
Le script comprend la création de la base de données 'tuto_jp_graph', la création de la table 'ventes' ainsi que l'insertion d'une centaine d'enregistrements.
Dans les exemples, ces mêmes paramètres sont repris (nom de la base et nom de la table).
II-B. Graphique secteur
Nous allons voir comment réaliser un graphique secteur (appelé également graphique camembert).
Les données représentées graphiquement sont le nombre d'unités vendues sur les différents exercices (2004, 2005 et 2006).
Les données représentées graphiquement sont le nombre d'unités vendues sur les différents exercices (2004, 2005 et 2006).
Pour ce premier exemple, le graphique sera construit étape par étape. Le processus en sera volontairement plus détaillé que dans les exemples suivants.
Ce dont nous avons besoin pour produire les données :
- Il faut d'abord récupérer les données, ce que nous allons faire à l'aide d'une requête Sql.
- Les données à récupérer sont : Le nombre de ventes par année Les années correspondantes
- Sachant que Jpgraph attend un tableau de données, nous allons intégrer ces valeurs dans deux tableaux qui vont respectivement représenter le nombre de ventes et les années concernées (2004, 2005, 2006).
- Extraire de la table des ventes les différentes années nous permettra d'ajouter une légende à chaque section du graphique.
Passons ensuite à la mise en oeuvre du graphique avec notre librairie. L'élaboration d'un graphique est assez simple.
Ce dont nous avons besoin pour la création du graphique:
- Créer un objet qui représente le type de graphique que nous souhaitons obtenir (ici un PieGraph).
- Renseigner différentes propriétés du graphique comme les données nécessaires à sa représentation, les légendes, la position du graphique dans son conteneur et bien d'autres paramètres dont nous aurons un aperçu au cours de cet article.
- Enfin provoquer l'envoi de l'image vers le navigateur.
Voyons le code source pour notre graphique :
Volume des ventes 2004, 2005, 2006 : graphique secteur |
|
L'image générée :
Graphique secteur : nombre d'unités vendues sur les différents exercices (2004, 2005 ...)
Quelques mots concernant la production du graphique :
Comme nous l'avons vu au tout début du script Php, il est nécessaire d'inclure le coeur de la librairie Jpgraph ainsi que la librairie nécessaire à la production du graphique voulu. Dans le cas présent, il s'agit d'un graphique secteur (camembert), nous avons donc inclu le fichier jpgraph_pie.php.
Afin de créer notre graphique nous avons utilisé le constructeur de la classe PieGraph (elle même une extension de la classe Graph). Les arguments que nous avons passés sont la largeur et la hauteur.
|
La variable $graph est à comprendre au sens de « conteneur s» pour un graphique de type piegraph.
Après avoir effectué quelques paramétrages, nous passons à la création du secteur proprement dit:
|
L'argument pris est le tableau que nous avons alimenté avec les données issues de notre table des ventes.
Là encore, nous allons effectuer quelques paramétrages, comme la légende, la position du graphique.
|
Il est également possible de spécifier la façon dont les valeurs de chaque part sont restituées, soit de façon absolue (comme c'est le cas dans notre exemple) soit de façon proportionnelle avec un pourcentage pour chaque part.
Nous avons choisi la représentation absolue. Pour cela, on utilise la méthode SetValueType() et on passe en argument la constante correspondante.
|
La méthode SetFormat('format') permet de formater les valeurs en les représentant sous divers formats comme entier ou flottant, mais aussi d'accompagner les valeurs d'une chaîne (ce que nous verrons un peu plus tard).
|
Nous ajoutons notre graphique secteur au conteneur.
|
Pour finir, la méthode Stroke() provoque l'affichage du graphique.
|
Cette méthode provoque un envoi de l'image (avec header Php) directement au navigateur. Pas question, donc, de faire autre chose que de produire l'image dans votre script. Nous verrons néanmoins qu'il est tout à fait possible de créer une image sur disque dur si cette méthode ne vous convient pas. Le format par défaut pour l'image produite par défaut est Png
|
II-C. Graphique secteur 3D
Dans cet exemple, l'objectif est de créer le même type de graphique et d'en personnaliser l'affichage. Pour mémoire il s'agit du nombre d'unités vendues sur les différents exercices (2004, 2005 ...).
Nous allons donc reprendre les données utilisées précédemment (je ne m'attarderai pas sur la partie Php dans laquelle on effectue la récupération des données).
Le code Php :
Volume des ventes 2004, 2005, 2006 : secteur 3D |
|
Voici l'image produite:
Graphique secteur : nombre d'unités vendues sur les différents exercices (2004, 2005 ...)
Quelques modifications du script initial nous ont permis de personnaliser notre graphique. Revoyons les différentes instructions utilisées pour cela :
Fichiers nécéssaires à la réalisation du graphique :
A l'aide de la méthode SetShadow(), nous avons ajouté une ombre au conteneur
|
Ensuite nous avons spécifié la police, le style et la taille avec la méthode SetFont() :
|
Pour la création de l'objet représentant notre graphique en 3D, nous avons fait appel à un constructeur différent, rendu possible grâce à l'inclusion du fichier jpgraph_pie3d.php.
|
L'effet de séparation d'une des parties du graphique a pu être réalisé à l'aide de la méthode ExplodeSlice(), qui prend en argument l'index de la partie que l'on souhaite valoriser.
|
La personnalisation des couleurs se fait avec la méthode SetSliceColors(), qui prend comme argument un tableau indexé de chaînes de caractères (les différentes couleurs).
|
Les couleurs peuvent également être définies en RGB, notation utilisée en Html exemple: #FF0000 pour du rouge
|
Il est également possible de paramétrer la position du graphique , grâce à la méthode SetCenter(). Une valeur de 0.5 correspond à un centrage par rapport au conteneur. Plus la valeur est élevée, plus le graphique est situé à droite (et inversement). Dans l'exemple, le graphique est légèrement décentré à gauche pour laisser de la place à la légende.
|
Jpgraph permet enfin de personnaliser les valeurs présentées, puisque nous avons pu spécifier le texte de sortie ainsi que la police et la couleur.
|
II-D. Graphique histogrammes
Après avoir étudié le graphique secteur (ou camembert), voyons maintenant le graphique de type histogramme. Cette sorte de graphique est nommée 'Bar' dans la librairie Jpgraph.
Pour créer un graphique de ce type, il faut, en plus de l'inclusion de la librairie de base de Jpgraph (fichier jpgraph.php), procéder à l'inclusion du fichier jpgraph_bar.php
Reprenons le cas précédent : nombre d'unités vendues sur les différents exercices (2004, 2005 ...).
Le graphique en histogramme présente les chiffres sous forme de barres verticales (ou horizontales). Dans notre exemple, chaque histogramme représente le nombre de ventes effectuées pour une année.
Pour ce qui est de la production de données, pas besoin de modifier le code : ce qui était valable pour le graphique secteur l'est pour l'histogramme.
Pour ce qui est de la production de données, pas besoin de modifier le code : ce qui était valable pour le graphique secteur l'est pour l'histogramme.
Le code Php :
|
Inclusion des fichiers nécessaires à la réalisation d'un graphique histogramme :
Le résultat :
Nombre d'unités vendues sur les différents exercices (2004, 2005 ...)
Après avoir créé notre conteneur comme dans les autres exemples, nous devons fixer la représentation souhaitée pour l'échelle avec la méthode SetScale(), logarithmique (log) ou bien linéaire. Pour l'heure, nous choisirons la représentation linéaire (la représentation logarithmique sera abordée à la fin du chapitre).
|
La construction du graphique proprement dit passe par la création d'un objet de type BarPlot. Le constructeur prend comme argument un tableau de valeurs entières.
|
La méthode SetShadow() permet l'ajout d'une ombre à chaque histogramme :
|
Voici comment affiche la valeur de chaque histogramme :
|
L'ajout au conteneur du graphique avec la méthode Add()
|
Il est également possible de spécifier des légendes pour les deux axes : 'x' pour l'axe horizontal et 'y' pour l'axe vertical.
|
Enfin, la méthode SetTickLabels() permet de personnaliser les valeurs de légende d'un axe (dans notre exemple, les différentes années). Un tableau indexé des valeurs correspondantes est nécessaire en argument.
|
II-E. Graphique courbe
Passons maintenant aux choses sérieuses, en abordant un type de graphique que l'on rencontre très fréquemment : le graphique courbe. Ce type de graphique, constitué de points reliés entre eux est particulièrement approprié pour représenter une progression.
Nous allons, représenter le chiffre d'affaires de l'année 2006 (toutes catégories confondues).
La production des données s'avère un petit peu plus difficile à réaliser cette fois puisque nous souhaitons:
- Récupérer les ventes de l'année 2006
- Comptabiliser le chiffre d'affaires généré par mois
Il nous faudra aussi créer la requête Sql appropriée.
Une fois la production de données effectuée, le reste ne présente pas de difficulté particulière.
Le code Php:
|
Le graphique produit :
le chiffre d'affaires de l'année 2006
Revenons à la production de données.
Il a fallu concevoir une requête susceptible de récupérer les ventes d'une année donnée (ici 2006), et de les regrouper par mois.
La requête est la suivante:
|
Voici un aperçu de l'ensemble de données généré :
Données produites
Il a également été nécessaire de trouver une astuce permettant de prévoir les cas où aucune vente n'a lieu pour un mois donné.
Pour ce faire, j'ai initialisé un tableau indexé de 12 valeurs (indice 0 à indice 11) par la valeur zéro. Lors de la récupération des données (chiffre d'affaires et nombre de ventes) sont affectées au mois qui convient.
|
Le reste concerne la mise en oeuvre du graphique et sa personnalisation.
La création d'une courbe se fait à l'aide du constructeur LinePlot($donnees), qui prend en argument un ensemble de données (un tableau indexé), ici notre chiffre d'affaires par mois pour l'année 2006
|
Une image a été ajoutée en fond avec la méthode SetBackgroundImage():
|
Le positionnement de l'image est déterminé par la constante passée en second argument. Les différentes valeurs possibles sont :
CONSTANTE | SIGNIFICATION |
---|---|
BGIMG_FILLPLOT | L'image est placée dans la zone du tracé et non dans le conteneur. Elle est redimensionnée au besoin |
BGIMG_FILLFRAME | L'image est placée sur l'ensemble de l'image et est redimensionnée au besoin |
BGIMG_COPY | L'image est placée telle quelle, sans être centrée ni redimensionnée |
BGIMG_CENTER | L'image est centrée sur le graphique mais n'est pas redimensionnée |
Paramétrer l'anti-aliasing avec une couleur dominante permet d'éviter la pixellisation (effet escalier) de la courbe tracée (il faut penser à spécifier une couleur proche de la couleur de fond) :
|
Nous avons également fait apparaître un quadrillage en fond du graphique (sur les deux axes) bleu pour l'axe des abscisses et rouge pour l'axe des ordonnées:
|
Comme vous pouvez le constater, nous avons changé l'apparence des points pour obtenir des ronds remplis de vert:
|
Enfin, pour chaque mois, nous avons affiché une représentation textuelle (un tableau de 12 valeurs crées en début de script) pour l'axe des abscisses.
|
II-F. Graphique histogrammes groupés
Dans le même esprit que le graphique courbe, revenons aux histogrammes pour étudier une forme particulière : les histogrammes groupés.
Comme son nom l'évoque, ce type de graphique permet la représentation de plusieurs histogrammes groupés dans le même conteneur. Cela peut s'avérer très utile lorsque l'on souhaite comparer différentes valeurs.
Nous allons de nouveau représenter le chiffre d'affaires pour l'ensemble des années concernées dans notre base de données, et non plus pour une année donnée.
Les données ne sont pas très difficiles à produire. En effet, une partie du travail a déjà été effectuée dans l'exemple précédent (nous reprendrons une partie de ce travail en ajoutant une étape pour récupérer les années).
Récapitulons ce dont nous avons besoin:
- Récupérer les années disponibles
- Pour chaque année, récupérer les valeurs de chaque mois
- Pour chaque mois, comptabiliser le chiffre d'affaires
Voici le code :
|
Le graphique généré :
Chiffre d'affaires par année
La principale difficulté de la création de ce graphique réside dans la construction du groupement d'histogramme. En particulier, pour bien découpler production de données et création du graphique, il a fallu créer une structure (ici un tableau associatif) susceptible de contenir les données produites.
Il faut également que notre structure soit adaptée à la restitution des données effectuée au moment de la mise en oeuvre du graphique.
La forme choisie est un tableau associatif qui possède pour clé chaque année récupérée dans la base. A chaque année correspond un tableau indexé de 12 valeurs (pour chacun des mois de l'année). Ces valeurs représentent le chiffre d'affaires du mois concerné.
Voici un aperçu du tableau (obtenu avec la fonction print_r($tableau)) :
|
Revenons à la création des histogrammes groupés:
|
Pour chaque année (itération dans le foreach) est créé un objet BarPlot. Un paramètre est passé lors de la construction de l'objet. Ce paramètre est le tableau de valeurs correspondant à l'année courante.
|
Chaque 'BarPlot' est paramétré : couleur de fond, légende et ombre
|
Le BarPlot est ajouté à un conteneur que nous utiliserons juste après.
|
Enfin, la construction des histogrammes groupés avec l'objet GroupBarPlot qui prend en argument le tableau qui contient tous nos BarPlot.
|
La création d'un graphique histogrammes groupés s'avère un peu plus difficile mais ne présente pas d'obstacle majeurs.
II-G. Graphique histogrammes horizontaux
Abordons maintenant le graphique histogrammes horizontaux.
Sa mise en oeuvre est rigoureusement identique à ce que l'on a vu avec l'histogramme vertical.
Cette fois, nous allons représenter graphique la répartition des ventes par chiffre d'affaires entre les différents types de produits depuis la première vente
Rappelons que nous avons trois types de produits possibles dans notre table : les logiciels, le matériel et le service.
Pour chaque entrée de la table ventes, le type de vente est spécifié. Nous allons nous appuyer sur ce champ pour grouper les résultats en faisant, pour chaque type de vente, la somme du chiffre d'affaires.
Nous souhaitons également faire apparaître les dates de la première et de la dernière vente concernées. Pour cela nous ferons une autre requête.
Voyons le script :
|
Voici le graphique généré :
Chiffre d'affaires par catégorie
Pour la production de données (c'est-à-dire le chiffre d'affaires par type de produit), nous avons exécuté la requête suivante:
|
Cette requête produit l'ensemble de données suivant:
Ensemble de données
Ces valeurs ont été placées dans un tableau intermédiaire afin de fournir les données nécessaires à la création du graphique. Les types de produits seront utilisés pour afficher la légende de l'axe des abscisses et les données serviront pour les différents histogrammes.
|
Concernant le paramétrage du graphique proprement dit, nous avons mis le graphique à l'horizontale grâce à l'instruction suivante Set90AndMargin(...):
|
Il a été possible d'ajouter un sous-titre pour indiquer les dates de première et de dernière vente (subtitle->Set(...)) :
|
Nous avons également modifié l'échelle avec la méthode SetGrace(...) pour que les histogrammes laissent de la place à chaque valeur correspondante.
|
Vous pouvez remarquer que les valeurs illustrant les graduations en haut du graphique sont placées à 45 degrés en utilisant la méthode SetLabelAngle(45):
|
II-H. Graphique histogrammes et courbe
Voyons maintenant la possibilité qu'offre Jpgraph d'afficher deux graphiques dans le même conteneur, en l'occurrence un graphique de type histogramme et un graphique de type courbe.
Pour cet exemple nous allons représenter pour l'année 2006:
- Le chiffre d'affaires par mois (histogrammes)
- Le nombre de ventes par mois (courbe)
La difficulté principale que nous allons rencontrer est la cohabitation de deux graphiques qui n'ont pas la même échelle.
Comme nous l'avons vu dans un des exemples précédents, il est possible de récupérer dans une requête les deux types de données nécessaires à la production du graphique (chiffre d'affaires et nombre de ventes).
Le script :
|
Le résultat :
Année 2006, chiffre d'affaires et nombre de ventes par mois
Pour produire les données nécessaires, nous avons repris une requête utilisée plus haut dans le tutoriel :
|
Nous obtenons les données suivantes :
Ensemble de données
On trouve dans cet ensemble de données tout ce dont on a besoin : le mois, le volume et le chiffre d'affaires des ventes.
Pour la mise en oeuvre du graphique, vous pouvez constater que nous avons désactivé l'affichage du cadre avec la méthode SetFrame(false):
|
Enlever le cadre nous permet aussi d'ajouter un onglet au graphique et de le personnaliser:
|
Le graphique histogramme a été créé et ajouté au conteneur comme dans les exemples précédents.
En revanche, l'ajout au graphique de la courbe est quelque peu différent de ce que l'on a eu l'occasion de voir.
On utilise la méthode addY($donnes) :
|
L'utilisation de cette méthode permet la création d'une autre axe des ordonnées (y) et d'ajouter un autre graphique dans le même conteneur.
Il est possible d'avoir à spécifier une autre échelle pour les graphiques ajoutés. Cela dépend de l'aspect final. Ici c'est ce que nous avons fait pour des raisons esthétique, le graphique courbe recouvrant l'autre graphique.
Dans notre cas de figure, on peut changer l'échelle avec la méthode SetYScale() :
|
Cette méthode prend 4 arguments :
Numéro d'argument | Signification |
---|---|
Arg 1 | Indice de l'axe |
Arg 2 | Type de l'axe (linéaire ou logarithmique) |
Arg 3 | Valeur min |
Arg 4 | Valeur max |
Pour un affichage harmonieux dans le contexte, le nombre de ventes maximum pour un mois a été multiplié par deux. Cela a eu l'effet recherché: aplatir le graphique.
Pour finir, l'axe nouvellement créé peut, lui aussi, être personnalisé (couleur et titre) :
|
II-I. Graphique histogrammes accumulés
Une autre caractéristique du graphique type histogramme est la possibilité de représenter un histogramme contenant n parties : les histogrammes accumulés.
Autre caractéristique du graphique type histogramme: la possibilité de représenter un histogramme contenant n parties: les histogrammes accumulés.
Pour illustrer cet exemple, nous allons reprendre la représentation du chiffre d'affaires 2006 par mois. Mais cette fois-ci, nous ajouterons une information supplémentaire, à savoir le chiffre d'affaires généré pour chaque type de produit.
Par conséquent, nous aurons pour chaque mois un histogramme qui représente le chiffre d'affaire pour tous les types de produits. L'histogramme sera décomposé en parts qui représenteront le chiffre d'affaires généré pour chaque produit.
En voici un exemple pour le mois de janvier 2006 avec en vert le C.A. matériel, en rouge le C.A. logiciel et en bleu le C.A. services :
La production de données est un peu particulière puisqu'il va nous falloir obtenir 3 ensembles de valeurs, le C.A. pour le matériel, pour le logiciel et pour le service de chaque mois.
Ensuite, comme nous allons le voir dans la mise en oeuvre du graphique, il suffira de créer un ensemble d'histogrammes pour chaque type de produit, de produire un ensemble d'histogrammes accumulés à partir des histogrammes précédemment créés.
Voici le script:
|
Le graphique généré :
Revenons à la production des données nécessaires à la création du graphique.
Dans notre exemple, il a été fait le choix de faire une seule requête pour extraire toutes les informations nécessaires. Nous aurions tout aussi bien pu effectuer une requête par type de produit (matériel, logiciel et service).
La requête produite retourne pour chaque mois (de l'année 2006) le chiffre d'affaires des différents types de produits. Cela donne l'ensemble de données suivant (aperçu des les 4 premiers mois):
La seconde étape est de séparer les données pour créer un tableau par type de produit:
|
La couleur du fond a été personnalisée en utilisant la méthode SetMarginColor() :
|
Chaque histogramme (matériel, logiciel et service), a été produit en créant un objet BarPlot en prenant comme argument les ensembles de données correspondants :
|
Après avoir généré les histogrammes par type de produits, nous les avons regroupés en créant une instance de l'objet AccBarPlot lui-même prenant en argument un tableau des histogrammes tout justes produits.
|
La position par défaut de la légende ne convenait pas (elle recouvrait un des histogrammes). La méthode Pos() a permis de déplacer la légende à gauche.
|
II-J. Graphique radar
Voyons un autre type de graphique : le graphique de type radar. Les valeurs passées à ce graphique sont représentées par des points placés circulairement autour d'un point central. A chaque valeur correspond un axe.
Reprenons le dernier cas vu, à savoir la répartition du chiffre d'affaire 2006 par type de vente. Nous ne nous attacherons qu'à la vente de matériel.
La production de données ne pose pas de problème, car le code source est quasiment le même que celui que l'on a vu plus haut.
La mise en oeuvre du graphique ne présente pas non plus de difficulté particulière.
Le code :
|
L'image produite:
Graphique radar : Chiffres d'affaires des ventes 2006
Comme je le disais, pas grand chose de nouveau pour la mise en oeuvre, la plupart des instructions nécessaires à la création du graphique ayant été déjà vues dans les exemples précédents.
En revanche, le graphique produit ne me convient pas. Les points sont placés conformément aux données que j'ai passées, mais j'aurais souhaité un affichage plus 'lissé' de mes données.
Jpgraph permet la représentation logarithmique d'un graphique, ce qui va nous être très utile.
Pour cela, nous utiliserons la méthode SetScale('log') (changement du type de l'échelle) de l'objet créé lors de la construction du graphique :
|
Petite précision : l'échelle par défaut est 'lin' comme linear, c'est à dire linéaire (ce qui était le cas dans le graphique initialement créé).
Voici le résultat :
Graphique radar : Chiffre d'affaires des ventes 2006 (représentation logarithmique)
En changeant l'échelle nous avons pu modifier l'apparence du graphique sans pour autant modifier les différentes valeurs.