Présentation

Vous pouvez combiner plusieurs types de graphiques avec des repères de ligne ou de bougie pour mettre en évidence les tendances des données ou indiquer la variance. Lorsque vous ajoutez des repères en courbes ou en chandeliers japonais aux graphiques à barres, à nuage de points ou à d'autres types de graphiques, le graphique obtenu est appelé graphique composé. Certains graphiques complexes ressemblent à une combinaison de deux types de graphiques (par exemple, un graphique à barres avec une ligne de suivi) :

tandis que d'autres ressemblent à de tout nouveaux types de graphiques, par exemple un graphique en boîte:

.

Créer un graphique composé

Tous les graphiques composés sont constitués d'un ou de plusieurs types de graphiques de base (en courbes, à nuage de points, à barres ou en radar) combinés à un ou plusieurs ensembles de repères. Ces repères ont besoin de données pour les placer sur le graphique. Parfois, vous pouvez utiliser la même série de données que celle utilisée pour dessiner les barres ou les points de votre graphique, mais vous souhaitez généralement que les repères aient leurs propres ensembles de données indépendants. Si vous souhaitez que votre graphique comporte des séries de données différentes pour le graphique de base et pour les repères, vous devez masquer les données des repères du graphique de base (afin qu'il n'essaie pas de tracer d'autres barres ou lignes avec ces données). Voici comment procéder :

1. Ajoutez votre série de données de repère à la fin de votre paramètre chd. Par exemple, si votre graphique à barres contient des données chd=t:30,10,20, vous pouvez ajouter de nouvelles données pour un repère de ligne comme ceci: chd=t:30,10,20|60,40,50.
2. Masquez les données supplémentaires des repères dans le graphique de base. Si vous ajoutez simplement une série de données supplémentaire à un graphique à barres pour votre ligne de suivi, le graphique l'affichera sous la forme d'une nouvelle série de barres. Pour éviter cela, vous devez masquer cette série supplémentaire. Pour masquer une série, incluez un chiffre après le descripteur de format chd : par exemple, chd=t1:30,10,20|60,40,50. Ce chiffre indique à l'API Chart le nombre de séries de données à utiliser pour dessiner des éléments pour ce type de graphique de base, tel que défini par le paramètre cht (barres pour les graphiques à barres, points de données pour les graphiques en courbes, etc.). Toute série de données supplémentaire sera ignorée par ce type de graphique lors du dessin du graphique. Notez qu'il s'agit d'un nombre en 1, et non en 0. Ainsi, t1 signifie "utiliser uniquement la première série de données pour les barres", t2 signifie "utiliser uniquement les deux premières séries pour les barres", etc.
   1. Remarques:
      1. Graphiques à nuage de points : les graphiques à nuage de points masquent les données différemment. Consultez la documentation pour en savoir plus.
      2. graphiques en courbes lxy : spécifiez un nombre pair de séries à afficher (t0, t2, t4, etc.). En effet, chaque ligne d'un graphique lxy est décrite par deux séries de données: une pour les valeurs x et une pour les valeurs y.
3. Utilisez les séries de données masquées pour dessiner des repères en chandeliers japonais, des repères de ligne ou d'autres repères. Le traçage des repères est expliqué dans les sections associées. Référencez la série de données masquées en tant que source de vos repères. Vous pouvez inclure autant de séries de données masquées que vous le souhaitez et les utiliser pour d'autres repères dans le graphique.

Voici le graphique que nous venons de décrire:

cht=bvg
chd=t1:30,10,20|60,40,50
chm=D,0033FF,1,0,5,1

 

Types de graphiques

Voici une liste des types de repères et des types de graphiques avec lesquels ils peuvent être utilisés:

Type de repère	Types de graphiques de base compatibles
Ligne	Ligne, Nuage de points, Barre, Radar
Chandelier	Trait, Barre
Tous les autres	Ligne, Nuage de points, Barre, Radar

Voici quelques exemples de types de graphiques composés que vous pouvez créer:

Type de graphique	Description	Exemple
Graphiques avec repères en courbes	Les repères de ligne peuvent être utilisés pour afficher des tendances dans de nombreux autres types de graphiques.
Graphiques en chandeliers japonais	Les graphiques en chandeliers japonais sont souvent utilisés pour afficher des données financières.
Graphiques en boîte	Les graphiques en boîtes permettent d'afficher des données regroupées par quartiles.
Graphiques intégrés	Vous pouvez intégrer un graphique dans un autre.
Autres repères	Vous pouvez masquer les données des repères dans n'importe quel type de graphique de base acceptable et les utiliser avec tous les autres types de repères de votre choix.	chd=t1:   10,20,30,40,50,60,70,80   5,10,15,20,25,30,35,40,45,50 chm=o,000000,1,-1,5

Haut de page

 

Graphiques avec marqueurs de lignes

Vous pouvez ajouter des lignes aux graphiques en courbes, scatter, à barres ou radar pour mettre en évidence des tendances.

Type de piétement + type de feutre	Description	Exemple
Barre + Trait	Voici un graphique à barres avec une ligne de trace. Les deux premières séries de données sont utilisées pour les barres empilées, tandis que les autres séries sont utilisées pour la courbe. chd=s2 indique que le graphique ne doit utiliser que les deux premières séries pour les barres. La ligne utilise la troisième série pour ses données. chd=s2:1XQbnf4,EWoQMUB,9halxp9 : encodage simple, où les deux premières séries sont utilisées pour dessiner les barres et la dernière pour la ligne. chm=D,0033FF,2,0,5,1 : ligne de trace (D), bleue, données de l'index de série 2, tous les points (0), la ligne fait 5 pixels de large et l'ordre de plan est de 1.	chm=   D,0033FF,2,0,5,1 chd=s2:   1XQbnf4,   EWoQMUB,   9halxp9
Nuage de points + Ligne	Vous pouvez ajouter une ligne à un graphique à nuage de points pour afficher les moyennes. Notez que les graphiques à nuage de points masquent les données des repères différemment. Pour en savoir plus, consultez Graphiques à nuage de points.	chd=t:   12,16,16,24,26,28,41,51,66,68,13,45,81|   16,14,22,34,22,31,31,48,71,64,15,38,84 chm=   o,0000FF,0,-1,0|   o,FF0000,0,0:9:,5|   D,000000,1,10:,1,-1
Barre + Trait	Voici un autre graphique à barres empilées sur lequel une ligne indépendante est tracée.	cht=bvs chd=t2:   0,10,20,30,20,70,80|   0,20,10,5,20,30,10|   10,0,20,15,60,40,30 chm=D,76A4FB,2,0,3
Barre + Cercles	Identique au graphique précédent, mais avec des repères circulaires au lieu de repères de ligne. Nous avons spécifié une valeur de données de 0,5, ce qui ajoute les points intermédiaires calculés dans la ligne en pointillés.	cht=bvs chd=t2:   0,10,20,30,20,70,80|   0,20,10,5,20,30,10|   10,0,20,15,60,40,30 chm=o,76A4FB,2,-.5,10

Haut de page

 

Graphiques en chandeliers japonais

Les graphiques en chandeliers japonais nécessitent au moins quatre séries de données pour dessiner les chandeliers, ainsi que des séries supplémentaires pour tout autre élément du graphique. Les graphiques en chandeliers japonais ne peuvent afficher qu'un ensemble de repères en chandeliers japonais, ou peuvent combiner des repères en chandeliers japonais et des graphiques à barres ou en courbes, comme illustré ci-dessous:

Type de piétement + type de feutre	Description	Exemple
Ligne (masquée) + Chandelier	Cet exemple montre un graphique ne montrant que des repères en chandeliers japonais. chd=t0 : la valeur 0 signifie que toutes les séries de données sont masquées dans le type de graphique de base (ici, un graphique en courbes), de sorte que seuls les chandeliers sont représentés. La première et la dernière valeurs de chaque série sont -1 pour indiquer les valeurs manquantes afin d'éviter de dessiner le premier ou le dernier chandelier, qui chevaucherait l'axe ou la marge du graphique et serait tronqué. chm=F,0000FF,0,-1,20 : F indique les repères en chandeliers japonais (à l'origine "repères financiers"). 0000FF signifie que les repères sont bleus lorsque la valeur diminue. 0 indique que les données en chandeliers japonais commencent à la série 0 ; -1 indique les repères sur tous les points (nous aurions également pu spécifier 0:4 ici pour masquer le premier et le dernier lustre au lieu d'utiliser les valeurs de données -1). 20 correspond à la largeur des chandeliers.	cht=lc chd=t0:   -1,5,10,7,12,-1|   -1,25,45,47,24,-1|   -1,40,30,27,39,-1|   -1,55,63,59,80,-1 chm=F,0000FF,0,-1,20
Ligne + Chandelier	Voici un exemple de graphique en courbes avec des marqueurs en chandeliers japonais. Cinq séries de données sont fournies : la première est utilisée pour le type de graphique (ligne) et les séries de données "cachées" restantes sont utilisées pour les repères en chandeliers japonais. Le paramètre chd=t1 indique que seule la première série est utilisée pour ce type de graphique (graphique en courbes). Nous avons omis les premier et dernier marqueurs de bougie en utilisant 1:4 dans la valeur <which_points>, car le premier et le dernier chandelier sont recadrés selon les bordures de la zone de graphique. Le paramètre chm spécifie les repères en chandeliers japonais avec la syntaxe F,<declining_color>,<data_series_index>,<which_points>,<width>,<order>.	cht=lc chd=t1:   20,10,15,25,17,30|   0,5,10,7,12,6|   35,25,45,47,24,46|   15,40,30,27,39,54|   70,55,63,59,80,6 chm=   F,,1,1:4,20
Ligne + Chandelier	Autre exemple de graphique en chandeliers japonais, mais avec des couleurs de remplissage personnalisées.	chd=t1: t1:   90,80,70,50,40,30,20,10|   0,5,10,0,5,10,0|2,15,20,5,15,40,0|   5,35,20,2,35,20,0|   15,40,30,15,40,50,0 chm=   F,000000,1,1:-2,20
Bar + Chandelier	Voici un exemple de graphique à barres avec des marqueurs en chandeliers japonais. Les premier et dernier repères en chandeliers japonais sont affichés ici, car les barres ajoutent un espacement suffisant pour éviter qu'elles ne soient rognées selon les limites du graphique.	cht=bvg chd=t1:   20,10,15,25,17,30|   0,5,10,7,12,6|   35,25,45,47,24,46|   15,40,30,27,39,54|   70,55,63,59,80,6 chm=   F,,1,1:4,20

Haut de page

 

Graphiques en boîte

Les graphiques en boîte, également appelés graphiques en boîte ou graphiques en boîte et moustaches, sont un type de graphique qui montre le regroupement d'une ou de plusieurs séries en quartiles (les quartiles sont des groupes qui couvrent 25% de la plage de valeurs, à l'exception possible des anomalies). Les graphiques en boîte sont semblables aux graphiques en chandeliers japonais, à la différence près qu'ils comportent des repères supplémentaires en bas et en haut, ainsi qu'un repère au 50e centile.

Un graphique en boîte est entièrement constitué de repères, comme illustré ici:

chm=   F,0000FF,0,1,10	chm=   H,0000FF,0,1,1:10|   H,0000FF,3,1,1:10|   H,0000FF,4,1,1:10	chm=   o,FF0000,5,,5|   o,FF0000,6,,5
Un jeu de repères en chandeliers japonais (chm=F), pour le corps des boîtes:	Un ensemble de repères de forme de ligne horizontale de longueur ajustable (chm=H) pour les lignes minimales, des 50e et 100e centiles:	Vous pouvez également utiliser des repères circulaires (chm=o) pour afficher les anomalies dans l'ensemble de données.	Assemblez-les toutes et vous obtenez un graphique en boîte !

Le type de graphique de base pour les graphiques en boîte est de type graphique à barres (bhs, bvs, bhg, bvg) ou de type graphique en courbes (lc, ls, lxy). Toutefois, si vous masquez le type de graphique de base en ajoutant un zéro dans le paramètre de format de données (par exemple: chd=t0: ou chd=s0:), le type de graphique que vous choisissez n'a pas d'importance.

Un graphique en boîte doit comporter au moins cinq séries de données: quatre pour les cadres et le nombre maximal et le nombre minimal de repères, une pour le repère à 50 %, ainsi que toute autre série de données pour les repères supplémentaires qui vous intéressent (comme les anomalies). Voici l'ordre de série recommandé. Notez que si la valeur de la série 1 est supérieure à la valeur correspondante dans la série 2, la boîte est remplie avec la couleur du repère chm=F. Si la valeur de la série 1 est inférieure à la valeur de la série 2, la boîte est vide. Pour en savoir plus, consultez la section Repères en chandeliers japonais.

Ordre de série d'une boîte non remplie:

0. Valeur minimale
1. Repère à 25 % (75% pour une boîte pleine)
2. Repère à 75 % (25% pour une boîte remplie)
3. Valeur maximale
4. Repère à 50 %
5. La série 6 et les suivantes s'appliquent à toutes les données de repère supplémentaires, telles que les valeurs aberrantes.

Vous pouvez placer la série de repères supplémentaire avant ou après les données du repère en chandeliers japonais, mais il est plus simple de toutes les placer en dernier.

Vous pouvez créer différents styles de graphiques en boîte en spécifiant différents repères et types de graphiques de base, ou en ordonnant les données différemment.

Description	Exemple
Il s'agit d'un graphique en boîtes standard, mais différentes couleurs sont attribuées aux différents éléments du graphique afin de mettre en évidence le repère utilisé pour créer chaque élément du graphique. cht=bvs : le type de graphique de base est bvs, mais aucune barre de ce graphique de base n'est affichée. Nous aurions pu spécifier n'importe quel type de graphique composé ici. chd=t0: - Le t0 masque toutes les lignes de ce graphique en courbes. Toutes les données ne seront utilisées que pour les repères. Dans les données, les première et dernière valeurs sont définies sur -1 afin d'éviter que des repères ne chevauchent les bords gauche et droit du graphique. Toutes les valeurs de la deuxième série sont inférieures aux valeurs correspondantes de la troisième série. Par conséquent, toutes les cases sont vides. -1,5,10,7,12,-1 : valeur minimale : point inférieur des bâtons orange inférieurs ; également la hauteur des lignes vertes horizontales. -1,25,30,27,24,-1 : valeur de 25 % : bord horizontal inférieur de cadres orange. -1,40,45,47,39,-1 : valeur de 75 % : bord horizontal supérieur des boîtes orange. -1,55,63,59,80,-1 : valeur maximale : point supérieur des bâtons orange supérieurs ; également la hauteur des lignes horizontales bleues. -1,30,40,35,30,-1 : lignes "médianes" horizontales noires à l'intérieur des chandeliers. -1,-1,5,70,90,-1 : données aberrantes (cercles rouges) -1,-1,-1,80,5,-1 : données supplémentaires sur les anomalies (cercles rouges). Les données sur les anomalies sont divisées en deux ensembles, car il est impossible d'avoir deux repères, l'un au-dessus de l'autre, spécifiés dans la même série sans utiliser de décalages ni d'autres astuces complexes. chm= - Les données de repère, telles que décrites ci-dessous : F,FF9900,0,1:4,40 : repères en chandeliers japonais (F) utilisant quatre séries de données, à partir de la première série (0), aux points 1 à 4, taille 40. H,0CBF0B,0,1:4,1:20 : repères de ligne horizontales verts indiquant la valeur minimale. Ceux-ci sont issus de la première série. H,0000FF,3,1:4,1:20 : repères de ligne horizontales bleues indiquant la valeur maximale. Ceux-ci sont issus de la série 3. H,000000,4,1:4,1:40 : repères de ligne horizontale noirs indiquant la valeur de 50 %. Ceux-ci sont issus de la série 4. o,FF0000,5,-1,7 : cercles rouges attribués à la sixième série de données pour les anomalies. Les repères sont attribués à tous les éléments de cette série, qui utilise -1 pour les cadres sans valeur aberrante. o,FF0000,6,-1,7 : plus d'anomalies. Une autre série de données est nécessaire lorsque vous souhaitez empiler des anomalies autour d'une même boîte.	cht=bvs chd=t0:   -1,5,10,7,12,-1|   -1,25,30,27,24,-1|   -1,40,45,47,39,-1|   -1,55,63,59,80,-1|   -1,30,40,35,30,-1|   -1,-1,5,70,90,-1|   -1,-1,-1,80,5,-1 chm=   F,FF9900,0,1:4,40|   H,0CBF0B,0,1:4,1:20|   H,000000,4,1:4,1:40|   H,0000FF,3,1:4,1:20|   o,FF0000,5,-1,7|   o,FF0000,6,-1,7
Le type de graphique Lc affiche toujours les lignes des axes. Pour créer un graphique sans lignes d'axe, spécifiez le type de graphique ls.	cht=lc    cht=ls
Pour créer une case remplie, faites en sorte que le point de la deuxième série soit supérieur au point correspondant de la troisième série. La valeur la plus élevée est indiquée en rouge dans le code affiché à droite.	chd=t0:   -1,5,10,7,12,-1   -1,40,30,27,24,-1   -1,25,45,47,39,-1   -1,55,63,59,80,-1

Haut de page

 

Graphiques intégrés

Vous pouvez intégrer n'importe quel type de graphique dans un graphique à barres, en courbes, radar ou scatter à l'aide d'icônes dynamiques. Consultez la section Graphiques intégrés de la documentation sur les repères dynamiques (chem).

Haut de page

 

Fonctionnalités standards

Les autres fonctionnalités de cette page sont des fonctionnalités de graphique standards.

Repères de ligne chm=D [Barre, Chandelier, Ligne, Radar, Nuage de points]

Vous pouvez ajouter une ligne pour tracer des données dans votre graphique. Le plus souvent, elle est utilisée dans les graphiques composés.

Pour ajouter plusieurs lignes (ou les combiner avec d'autres repères chm), séparez les ensembles de paramètres chm à l'aide d'une barre verticale ( |). Ce paramètre ne permet pas de créer un repère de ligne en pointillés.

Syntaxe

chm=
  D,<color>,<series_index>,<which_points>,<width>,<opt_z_order>

D

Indique qu'il s'agit d'un repère de ligne.

<color>

Couleur de la ligne, au format hexadécimal RRGGBB.

<series_index>

Indice de la série de données utilisée pour tracer la ligne. L'index de la série de données est 0 pour la première série de données, 1 pour la deuxième, etc.

<which_points>

Points d'une série à utiliser pour tracer la ligne Utilisez l'une des valeurs suivantes :

• 0 : utilise tous les points de la série.
• start:end : utilisez une plage spécifique de points de la série, du début à la fin inclus (indice basé sur zéro). Vous pouvez également utiliser des valeurs à virgule flottante pour spécifier des points intermédiaires, ou laisser start ou end vide pour indiquer le premier ou le dernier point de données, respectivement. Les valeurs start et end peuvent être négatives, en tant qu'indice inverse à partir de la dernière valeur. Si les valeurs start et end sont toutes deux négatives, veillez à les écrire dans une valeur croissante (par exemple, -6:-1).

<size>

Épaisseur de la ligne en pixels.

<opt_z_order>

[Facultatif] Calque sur lequel tracer le repère, par rapport aux autres repères et à tous les autres éléments du graphique. Il s'agit d'un nombre à virgule flottante compris entre -1,0 et 1,0 inclus, où -1,0 correspond au bas et 1,0 au haut. Les éléments du graphique (lignes et barres) sont légèrement inférieurs à zéro. Si deux repères ont la même valeur, ils sont dessinés dans l'ordre indiqué par l'URL. La valeur par défaut est 0.0 (juste au-dessus des éléments du graphique).

 

Exemples

Description	Exemple
Voici un exemple de traçage d'une ligne de repère sur un graphique à barres. L'ordre de plan est défini sur 1, de sorte que la ligne est tracée au-dessus des barres. Cet exemple utilise les mêmes données pour les barres et la ligne de données.	chm=D,0033FF,0,0,5,1 chd=s:1XQbnf4
Il s'agit du même graphique à barres, mais avec une série de données supplémentaire uniquement pour la courbe. Il s’agit d’un exemple de graphique composé. Pour dessiner des graphiques composés, ajoutez des séries de données supplémentaires au paramètre chd et ajoutez une valeur à chd pour indiquer au graphique d'ignorer les séries de données supplémentaires. Pour en savoir plus, consultez la section Graphiques composés.	chm=D,0033FF,1,0,5,1 chd=s1:1XQbnf4,43ksfg6

Haut de page

Repères de formes chm [Barre, Ligne, Radar, Nuage de points]

Vous pouvez spécifier des repères graphiques pour tous les points de données d'un graphique ou pour des points de données individuels. Si deux repères ou plus occupent le même point, ils sont dessinés dans l'ordre dans lequel ils apparaissent dans le paramètre chm. Vous pouvez également créer des repères de texte sur des points de données. Pour en savoir plus, consultez la section Repères de points de données.

Vous pouvez combiner des repères de forme avec d'autres chm paramètres en utilisant une barre verticale ( | ) pour séparer les paramètres chm.

Syntaxe

Spécifiez un ensemble des paramètres suivants pour chaque série à marquer. Pour marquer plusieurs séries, créez des ensembles de paramètres supplémentaires, délimités par une barre verticale. Il n'est pas nécessaire de baliser toutes les séries. Si vous n'attribuez pas de repères à une série de données, elle n'en reçoit aucun.

Les repères de forme se comportent légèrement différemment dans les graphiques à nuage de points. Pour en savoir plus, consultez cette documentation.

chm=
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
    |...|
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>

@

[Facultatif] Si vous faites précéder le type de repère du caractère facultatif @, l'élément <opt_which_points> doit utiliser le format x:y.

<marker_type>

Type de repère à utiliser. Spécifiez l'un des types suivants :

• a – Flèche
• c - Croix
• C : rectangle. S'il s'agit d'un repère rectangulaire, vous devez disposer d'au moins deux séries de données, la série 0 indiquant le bord inférieur et la série 1 le bord supérieur. <size> spécifie la largeur du rectangle, en pixels.
• d – Diamant
• E – Repère de barre d'erreur ( ) Ce repère nécessite la création de deux séries de données, une valeur pour la partie inférieure et le point correspondant dans la deuxième série pour le haut. Elle expose également une syntaxe <size> étendue: line_thickness[:top_and_bottom_width] où top_and_bottom_width est facultatif. Voir les exemples ci-dessous.
• h : ligne horizontale à une hauteur spécifiée sur le graphique. (Le seul format valide pour le paramètre <opt_which_points> est opt_which_points.)
• H : ligne horizontale traversant le repère de données spécifié. Ce code est compatible avec une syntaxe <size> étendue qui vous permet de spécifier une longueur de ligne exacte : line_thickness[:length], où length est facultatif et utilise par défaut la largeur totale de la zone de graphique.
• o - Cercle
• s - Carré
• v : ligne verticale de l'axe des abscisses au point de données
• V : ligne verticale de longueur ajustable. Ce code est compatible avec une syntaxe de valeur <size> étendue qui vous permet de spécifier une longueur de ligne exacte : line_thickness[:length], où length est facultatif et est définie par défaut sur la hauteur complète de la zone de graphique. Le repère est centré sur le point de données.
• x : un X

<color>

Couleur des repères de cette série, au format hexadécimal RRGGBB.

<series_index>

: indice basé sur zéro de la série de données sur laquelle les repères doivent être dessinés. Ignoré pour les repères h et ceux qui spécifient une position par position x/y (commencent par le caractère @). Vous pouvez utiliser des séries de données masquées comme source pour les repères. Pour en savoir plus, consultez la section Graphiques composés. Les graphiques à barres verticales groupées acceptent une syntaxe étendue spéciale pour aligner les repères sur des barres spécifiques.

<opt_which_points>

[Facultatif] Les points sur lesquels dessiner les repères La valeur par défaut est "Tous les repères". Utilisez l'une des valeurs suivantes :

• n.d : emplacement du repère. La signification dépend du type de repère :
  • Tous les types sauf h : point de données sur lequel tracer le repère, où n.d est l'index basé sur zéro dans la série. Si vous spécifiez une valeur non entière, la fraction indique un point intermédiaire calculé. Par exemple, 3,5 signifie à mi-chemin entre le point 3 et le point 4.
  • h : un nombre compris entre 0 et 1,0, où 0,0 correspond au bas du graphique et 1,0 à la partie supérieure.
• -1 : tracez un repère sur tous les points de données. Vous pouvez également laisser ce paramètre vide pour dessiner sur tous les points de données.
• -n : tracez un repère tous les n-ièmes points de données. Valeur à virgule flottante. Si n est inférieur à 1, le graphique calcule des points intermédiaires supplémentaires pour vous. Par exemple, "-0.5" place deux fois plus de repères que de points de données.
• start:end:n : dessine un repère sur chaque n-ième point de données d'une plage, depuis les valeurs d'index début à fin incluses. Tous les paramètres sont facultatifs (ils peuvent être absents). Par conséquent, 3::1 serait transmis du quatrième élément au dernier (étape 1). Si vous omettez ce paramètre, la valeur par défaut serait first:last:1. Toutes les valeurs peuvent être des nombres à virgule flottante. Les valeurs start et end peuvent être négatives pour que le décompte se base sur la dernière valeur. Si les valeurs start et end sont toutes deux négatives, assurez-vous qu'elles sont répertoriées dans une valeur croissante (par exemple, -6:-1:1). Si la valeur de l'intervalle n est inférieure à 1, des points de données supplémentaires sont calculés en interpolant les valeurs de données données. Les valeurs par défaut sont first:last:1.
• x:y : tracez un repère à un point x/y spécifique sur le graphique. Ce point ne doit pas nécessairement se trouver sur une ligne. Pour utiliser cette option, ajoutez le caractère @ avant le type de repère. Spécifiez les coordonnées en tant que valeurs à virgule flottante, où 0:0 correspond à l'angle inférieur gauche du graphique et 1:1 à l'angle supérieur droit. Par exemple, pour ajouter un losange rouge de 15 pixels au centre d'un graphique, utilisez @d,FF0000,0,0.5:0.5,15.

<size>

: taille du repère, en pixels. La plupart acceptent une valeur numérique unique pour ce paramètre. Les repères V, H et S acceptent la syntaxe <size>[:width], où la deuxième partie facultative spécifie la longueur de la ligne ou du repère.

<opt_z_order>

[Facultatif] Calque sur lequel tracer le repère, par rapport aux autres repères et à tous les autres éléments du graphique. Il s'agit d'un nombre à virgule flottante compris entre -1,0 et 1,0 inclus, où -1,0 correspond au bas et 1,0 au haut. Les éléments du graphique (lignes et barres) sont légèrement inférieurs à zéro. Si deux repères ont la même valeur, ils sont dessinés dans l'ordre indiqué par l'URL. La valeur par défaut est 0.0 (juste au-dessus des éléments du graphique).

<opt_offset>

[Facultatif] Permet de spécifier des décalages horizontaux et verticaux par rapport à l'emplacement spécifié. Voici la syntaxe, qui utilise un délimiteur ":" : reserved:<horizontal_offset>:<vertical_offset>. Si spécifié, vous pouvez inclure une valeur vide dans la chaîne du paramètre chm pour <opt_z_order>. Exemples: o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20

• Réservé : laissez ce champ vide.
• <horizontal_offset> : nombre positif ou négatif spécifiant le décalage horizontal, en pixels. Facultatif ; laissez ce champ vide si ce champ n'est pas utilisé.
• <vertical_offset> : nombre positif ou négatif spécifiant le décalage vertical, en pixels. Facultatif ; laissez ce champ vide si ce champ n'est pas utilisé.

 

Exemples

Description	Exemple
Voici un exemple de plusieurs repères de forme et de ligne. a,990066,0,0.0,9.0 : flèche violette, première série, premier point, taille 9. c,FF0000,0,1.0,20.0 : croix rouge, première série, deuxième point, taille 9. d,80C65A,0,2,20.0 : losange vert, première série, troisième point, taille 9. H,000000,0,3,1:40 : ligne horizontale noire, première série, point de données 3, largeur d'un pixel et long de quarante pixels. o,FF9900,0,4.0,12.0 : cercle orange, première série, cinquième point, taille 12. s,3399CC,0,5.0,11.0 : carré bleu, première série, sixième point, taille 11. v,BBCCED,0,6.0,1.0 : ligne verticale jusqu'à un point, première série, septième point, largeur d'un pixel. V,3399CC,0,7.0,1.0 : ligne verticale de bas en haut du graphique, première série, huitième point, largeur d'un pixel. x,FFCC33,0,8.0,20.0 : "X" jaune, première série, neuvième point, taille 20. H,FFFF00,0,9,2 : ligne horizontale jaune correspondant à la largeur du graphique au point de données 9. h,FF0000,0,0.5,1 : ligne horizontale rouge à la hauteur désignée, première série, à la moitié du graphique, d'un pixel de large.	chm=   a,990066,0,0.0,9.0|   c,FF0000,0,1.0,20|   d,80C65A,0,2.0,20.0|   H,000000,0,3,1:40|   o,FF9900,0,4.0,12.0|   s,3399CC,0,5.0,11.0|   v,BBCCED,0,6,1.0|   V,3399CC,0,7,1.0|   x,FFCC33,0,8,20|   H,FFFF00,0,9,2|   h,FF0000,0,0.5,1
Voici un exemple utilisant des losanges pour une série de données et des cercles pour l'autre. Si deux repères ou plus occupent le même point, ils sont dessinés dans l'ordre dans lequel ils apparaissent dans le paramètre chm. Ici, le cercle est le premier repère spécifié avec chm. Il est donc dessiné en premier. Le losange est spécifié et dessiné en deuxième. Il est alors dessiné au-dessus du cercle.	chm=   o,FF9900,0,-1,15.0|   d,FF0000,1,-1,10.0
Voici un graphique en courbes avec un repère à chaque seconde point de données (-2 correspond à tous les autres points).	chd=t:   0,20,20,50,40,70,70,90,85,45,40,50 chm=   o,0066FF,0,-2,6
Voici un graphique en courbes avec deux fois plus de repères que de points de données (-0,5 signifie tous les mi-points).	chd=t:   0,20,20,50,40,70,70,90,85,45,40,50 chm=   o,0066FF,0,-.5,6
Cet exemple montre comment utiliser les repères h et v pour créer des lignes de grille avec des couleurs et des épaisseurs personnalisées. La valeur d'ordre de plan (la dernière valeur) est définie sur -1 afin que les lignes de la grille soient tracées sous la ligne de données.	chm=   h,76A4FB,0,0:1:.2,2,-1|   V,76A4FB,0,::2,0.5,-1
Ce graphique ajoute des lignes de remplissage verticales à un graphique en courbes: v : lignes verticales par rapport au graphique FF0000 (lignes rouges) 0 : indice de la série : :.5 : spécificateur de plage : du début à la fin, tous les 0,5 point. 2 : épaisseur de 2 pixels.	chm=   v,FF0000,0,::.5,2
Cet exemple ajoute une flèche et un repère de texte au graphique en utilisant des coordonnées exactes. Le premier D est la ligne de trace sous les barres. Le deuxième repère est la flèche et le troisième correspond au texte de la flèche.	chm=   D,003971,1,0,3|   @a,000000,0,.25:.75,7|   @tExpected,000000,0,.35:.85,10
Une ligne horizontale fixe à un point de données spécifique (H) peut être utile pour afficher des valeurs relatives ou mettre en valeur la hauteur d'une valeur de données sur un graphique.	chm=H,FF0000,0,18,1
Ce graphique illustre les repères qui peuvent spécifier l'épaisseur et la longueur de la ligne dans le paramètre <size>. E,000000,0,6,1:20 : barre d'erreur noire avec des lignes de 1 pixel de large, les barres supérieures et inférieures de 20 pixels de long. La partie inférieure est ancrée à la série 0, point 8, tandis que la partie supérieure est ancrée à la série 1, point 8. H,990066,1,2,5:50 : ligne violette de cinq pixels de large sur cinquante pixels, centrée sur le point de données 2. V,3399CC,0,8,3:50 : ligne bleue verticale de 3 pixels de large sur 50 pixels de long, centrée sur le point de données 8	title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,2,5:30%7C,2,5:50%7CV chm=   E,000000,0,6,1:20|   H,990066,1,2,5:50|   V,3399CC,0,8,3:50

Haut de page

Marqueurs en chandeliers japonais chm=F [Barre, ligne]

Les repères en chandeliers japonais indiquent la variance et un changement de direction dans une série de données. Elles sont souvent utilisées pour indiquer les valeurs des stocks au cours d'une journée. Le repère inclut des segments qui indiquent la valeur la plus élevée et la plus faible, ainsi que les valeurs d'ouverture et de clôture pour une période spécifique (généralement une journée). Pour en savoir plus sur les repères en chandeliers japonais, cliquez ici.

Un repère en chandeliers japonais est dessiné sous la forme d'un rectangle traversé par une ligne verticale. Quatre séries de données sont nécessaires pour dessiner un repère en chandeliers japonais. Voici ce que chaque série spécifie:

• Les séries 1 et 4 indiquent respectivement le bas et le haut de la ligne verticale. Elles représentent généralement les valeurs basse et élevée pour la journée.
• Les séries 2 et 3 indiquent les bordures verticales du rectangle. La série 2 est la valeur d'ouverture et la série 3 la valeur de clôture. La couleur du rectangle dépend de celle qui est la plus élevée: lorsque la valeur d'ouverture (série 2) est inférieure à la valeur de clôture (série 3), le prix a augmenté et le rectangle est rempli de vert fixe par défaut. Lorsque la valeur d'ouverture (série 2) est supérieure à la valeur de clôture (série 3), le prix a diminué et le rectangle est rempli de rouge continu par défaut. Vous ne pouvez spécifier une couleur de remplissage que pour le rectangle avec une valeur décroissante. Dans ce cas, le rectangle dont la valeur augmente est vide (vide). Notez que la série 2 peut correspondre à la partie supérieure ou inférieure du rectangle, selon que le prix a augmenté ou baissé.

Vous pouvez combiner des repères en chandeliers japonais avec d'autres paramètres chm en utilisant une barre verticale ( | ) pour séparer les paramètres chm.

Remarque:Si vous ne souhaitez pas que les lignes correspondant aux données utilisées pour dessiner les repères s'affichent dans le graphique, vous devez inclure un 0 après le type de format. Par exemple: chd=t0:10,20,30,40 dans une chaîne de données au format texte. Pour en savoir plus, consultez la section Graphiques composés.

Voici un exemple illustrant les lignes correspondant à chaque série:

Syntaxe

chm=
  F,<opt_declining_color>,<data_series_index>,<opt_which_points>,<width>,<opt_z_order>

F

Indique qu'il s'agit d'un repère en chandeliers japonais.

<opt_declining_color>

[Facultatif] Couleur de remplissage des rectangles lorsque la valeur diminue (lorsque valeur de la série 2 > valeur de la série 3 correspondante). Il s'agit d'un nombre hexadécimal au format RRGGBB. Lorsque les valeurs augmentent, le rectangle est vide. La valeur par défaut est le vert fixe pour une augmentation et le rouge uni pour la diminution (vous ne pouvez pas spécifier une couleur de remplissage personnalisée pour les valeurs croissantes).

<data_series_index>

Indice de la série de données à utiliser comme première série pour les repères en chandeliers japonais. Il s'agit d'un index basé sur zéro. Ainsi, si vous spécifiez 1 ici et que vous disposez de six séries, les deuxième, troisième, quatrième et cinquième seront utilisées pour dessiner les repères en chandeliers japonais.

<opt_what_points>

[Facultatif] Spécifie les points de données utilisés pour tracer des repères. La valeur par défaut est "Tous les repères". Utilisez l'un des formats suivants :

• n.d : trace un repère sur un seul point de la série, où n.d est l'index du point dans la série. Si vous spécifiez une valeur non entière, la fraction indique un point intermédiaire calculé. Par exemple, 3,5 signifie à mi-chemin entre le point 3 et le point 4.
• -1 : tracez un repère sur tous les points de données. Vous pouvez également laisser ce paramètre vide pour dessiner sur tous les repères.
• -n : tracez un repère tous les n-ièmes points de données.
• start:end:n : dessine un repère sur chaque n-ième point de données d'une plage, depuis les valeurs d'index début à fin incluses. Tous les paramètres sont facultatifs (ils peuvent être absents). Par conséquent, 3::1 serait transmis du quatrième élément au dernier (étape 1). Si vous omettez ce paramètre, la valeur par défaut serait first:last:1. Toutes les valeurs peuvent être des nombres à virgule flottante. Les valeurs start et end peuvent être négatives pour que le décompte se base sur la dernière valeur. Si les valeurs start et end sont toutes deux négatives, assurez-vous qu'elles sont répertoriées dans une valeur croissante (par exemple, -6:-1:1). Si la valeur de l'intervalle n est inférieure à 1, des points de données supplémentaires sont calculés en interpolant les valeurs de données données. Les valeurs par défaut sont first:last:1.

<largeur>

Largeur de tous les rectangles, en pixels.

<opt_z_order>

[Facultatif] Calque sur lequel tracer le repère, par rapport aux autres repères et à tous les autres éléments du graphique. Il s'agit d'un nombre à virgule flottante compris entre -1,0 et 1,0 inclus, où -1,0 correspond au bas et 1,0 au haut. Les éléments du graphique (lignes et barres) sont légèrement inférieurs à zéro. Si deux repères ont la même valeur, ils sont dessinés dans l'ordre indiqué par l'URL. La valeur par défaut est 0.0 (juste au-dessus des éléments du graphique).

 

Exemples

Description	Exemple
Voici un exemple de repères en chandeliers japonais sur un graphique en courbes avec quatre séries. La couleur de remplissage personnalisée 0000FF (bleu) est spécifiée. Cette couleur est utilisée pour remplir les rectangles lorsque le point de la série 3 est plus petit que le point équivalent de la série 2. Le premier et le dernier rectangle sont tronqués par le graphique. Pour éliminer ces valeurs, vous pouvez spécifier 1:4 pour le quatrième paramètre de chm. Notez le zéro dans la chaîne de données pour masquer les lignes de la série: chd=t0. Cela indique que toutes les données du graphique doivent être utilisées pour les repères. Le paramètre <which_point> est vide, ce qui dessine des chandeliers sur tous les points de données.	chd=t0:   0, 5,10, 7,12, 6|   35,25,45,47,24,46|   15,40,30,27,39,54|   70,55,63,59,80,60 chm=F,0000FF,0,,20
Voici un exemple du même graphique, utilisant les couleurs par défaut, et supprimant le premier et le dernier élément. Il s'agit d'un graphique composé, qui combine un graphique en courbes (type de graphique de base) et des marqueurs en chandeliers japonais. La valeur 1 dans cht=t:1 signifie que toutes les séries de données ultérieures à la première doivent être masquées pour le type de graphique de base (graphique en courbes). Le premier 1 dans chm=F,,1,1:4,20 signifie que les données en chandeliers japonais proviennent des séries 2, 3, 4 et 5 (le 1 est basé sur zéro). Pour en savoir plus sur la façon de dessiner un graphique composé comme celui-ci, consultez la section Graphiques composés.	cht=lc chm=   F,,1,1:4,20 chd=t1:   15,40,30,27,39,54|   ...

Haut de page