Graphiques composés

  

Fonctionnalités spécifiques aux graphiques Présentation Créer un graphique composé Types de graphiques Graphiques de repères de lignes Graphiques en chandeliers Graphiques en boîte Graphiques intégrés

Informations sur le repère Repères de ligne (chm=D) Repères de forme (chm) Candlestick Markers (Marqueurs de bougies) (chm=F)

 

Présentation

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

tandis que d'autres ressemblent à des types de graphiques entièrement nouveaux (par exemple, un graphique en boîtes) :

.

Créer un graphique composé

Tous les graphiques composés se composent d'un ou de plusieurs types de graphiques de base (lignes, nuages de points, barres ou radars) 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 tracer les barres ou les points sur 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 le graphique de base présente 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 dans le graphique de base (afin qu'il n'essaie pas de tracer plus de barres ou de lignes avec ces données). Voici comment procéder :

1. Ajoutez la série de données de vos repères à la fin de votre paramètre chd. Par exemple, si votre graphique à barres contenait des données chd=t:30,10,20, vous pouvez ajouter de nouvelles données pour un repère de ligne comme celui-ci: chd=t:30,10,20|60,40,50.
2. Masquez les données supplémentaires de vos 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 affichera cette nouvelle série de barres. Pour éviter cela, vous devez masquer cette série supplémentaire. Pour masquer une série, incluez un seul 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 de son dessin. Notez qu'il s'agit d'un nombre en base 1 et non en commençant par 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 d'une manière différente. 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 tracer des repères en forme de bougies, des repères de ligne ou d'autres repères. Pour savoir comment dessiner des repères, consultez les sections associées. Référencez la série de données masquée comme 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 ajouter des 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 la 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
Line	Ligne, Nuage de points, Barres, Radar
Chandelier	Ligne, Barre
Tous les autres	Ligne, Nuage de points, Barres, Radar

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

Type de graphique	Description	Exemple
Graphiques avec repères de lignes	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îtes	Les graphiques en boîtes sont utilisés pour afficher des données regroupées par quarts de plage.
Graphiques intégrés	Vous pouvez intégrer un graphique dans un autre graphique.
Autres repères	Vous pouvez masquer les données des repères dans tous les types de graphiques de base acceptés 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 de repères de lignes

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

Type de base + Type de repère	Description	Exemple
Barre + Ligne	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, et les autres pour la ligne. 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 série 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), ligne de cinq pixels de large et ordre Z 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 des moyennes. Notez que les graphiques à nuage de points masquent les données des repères d'une manière différente. Pour en savoir plus, consultez la section 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 + Ligne	Voici un autre graphique à barres empilées surmonté d'une ligne indépendante.	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 d'un repère de ligne. Nous avons spécifié toutes les valeurs 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, plus des séries supplémentaires pour tout autre élément de graphique. Les graphiques en chandeliers japonais ne peuvent afficher qu'un ensemble de repères en chandeliers, ou peuvent être une combinaison de repères et de graphiques à barres ou en courbes, comme indiqué ci-dessous:

Type de base + Type de repère	Description	Exemple
Ligne (cachée) + chandelier	Dans cet exemple, un graphique n'affiche que des bougies. chd=t0 : le 0 signifie que toutes les séries de données sont masquées pour le type de graphique de base (ici, un graphique en courbes), de sorte que seuls les chandeliers sont dessinés. La première et la dernière valeurs de chaque série sont -1 pour indiquer les valeurs manquantes et é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 des repères en chandeliers japonais (à l'origine, des "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 point de repère au lieu d'utiliser les valeurs de données -1). 20 est la largeur des lustres.	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 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 "masquées" restantes sont utilisées pour les repères en chandeliers japonais. Le paramètre chd=t1 spécifie que seule la première série est utilisée pour ce type de graphique (graphique en courbes). Nous avons omis le premier et le dernier repère en chandeliers japonais en utilisant 1:4 dans la valeur <which_points>, car les premier et dernier lustres sont recadrés en fonction des 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
Barre + Chandelier	Voici un exemple de graphique à barres avec des marqueurs en chandeliers japonais. Les premier et dernier marqueurs en chandeliers japonais sont affichés ici, car les barres ajoutent suffisamment d'espacement pour éviter qu'elles ne soient rognées par 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 diagrammes 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 valeurs aberrantes). Les graphiques en boîtes sont semblables aux graphiques en chandeliers japonais, mais avec des marqueurs ajoutés en bas et en haut du chandelier, ainsi qu'un repère au 50e centile.

Un graphique en boîtes est entièrement composé de repères, comme illustré ci-dessous:

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 ensemble de repères en chandeliers (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 de minimum, 50e et 100e centile:	Vous pouvez éventuellement ajouter des repères en forme de cercle (chm=o) pour afficher les anomalies dans l'ensemble de données.	Mettez-les tous ensemble et vous avez un graphique en boîtes !

Le type de graphique de base est l'un des types de graphiques à barres (bhs, bvs, bhg, bvg) ou 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îtes doit comporter au moins cinq séries de données: quatre pour les cases et les repères maximum et minimum, une pour le repère 50 %, plus toute série de données supplémentaire pour tout repère supplémentaire souhaité, comme les repères de valeurs aberrantes. Voici l'ordre recommandé pour la série. Notez que si la valeur de la série 1 est supérieure à la valeur correspondante de la série 2, la zone sera remplie avec la couleur du repère chm=F. Si la valeur de la série 1 est inférieure à celle de la série 2, la zone sera vide. Pour en savoir plus, consultez la page Repères de chandelier.

Ordre dans la série d'un encadré non rempli:

0. Valeur minimale
1. Repère de 25 % (75% pour une zone remplie)
2. Repère de 75 % (25% pour une zone remplie)
3. Valeur maximale
4. Repère à 50 %
5. Les séries 6 et ultérieures concernent toutes les données de repères supplémentaires, telles que les anomalies.

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

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

Description	Exemple
Il s'agit d'un graphique en boîtes standard, mais des couleurs différentes 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. 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 : t0 masque toutes les lignes de ce graphique en courbes. Toutes les données ne sont utilisées que pour les repères. Dans les données, la première et la dernière valeurs sont -1 pour é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, tous les cadres sont vides. -1,5,10,7,12,-1 : valeur minimale : point inférieur des sticks orange inférieurs ; également hauteur des lignes vertes horizontales. -1,25,30,27,24,-1 : valeur de 25 % : bord horizontal inférieur des cases orange. -1,40,45,47,39,-1 : valeur de 75 % : bord horizontal supérieur des cases orange. -1,55,63,59,80,-1 : valeur maximale : point supérieur des bâtons orange supérieurs ; hauteur des lignes bleues horizontales. -1,30,40,35,30,-1 : lignes "médianes" horizontales noires à l'intérieur des chandeliers. -1,-1,5,70,90,-1 : données relatives aux anomalies (cercles rouges) -1,-1,-1,80,5,-1 : davantage de données aberrantes (cercles rouges). Les données aberrantes sont divisées en deux ensembles, car vous ne pouvez pas 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 ou d'autres astuces compliquées. chm= - Données de repère, comme décrit ci-dessous : F,FF9900,0,1:4,40 : bougies orange (F) utilisant quatre séries de données à partir de la première série (0), sur les points 1 à 4, en taille 40. H,0CBF0B,0,1:4,1:20 : repères de ligne horizontaux verts affichant la valeur minimale. Ceux-ci sont issus de la première série. H,0000FF,3,1:4,1:20 : repères de ligne horizontaux bleus indiquant la valeur maximale. Ceux-ci proviennent de la série 3. H,000000,4,1:4,1:40 : repères de ligne horizontaux noirs affichant la valeur de 50 %. Elles proviennent de la série 4. o,FF0000,5,-1,7 : cercles rouges affecté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 boîtes sans valeur aberrante. o,FF0000,6,-1,7 : plus de valeurs aberrantes. Une autre série de données est nécessaire lorsque vous souhaitez empiler des anomalies les unes sur les autres autour d'un même cadre.	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 zone 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 tout 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 dans la documentation sur les repères dynamiques (chem).

Haut de page

 

Fonctionnalités standards

Les autres fonctionnalités figurant sur cette page sont des éléments de graphiques standards.

Repères de ligne chm=D [Barre, chandelier, ligne, radar, nuage de points]

Vous pouvez ajouter une ligne qui trace les données de votre graphique. Ce type de graphique est généralement utilisé 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 vous 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 RRVVBB.

<series_index>

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

<which_points>

Quels 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 : utilise une plage de points spécifique dans la série, comprise entre le début et la fin inclusif (index basé sur zéro). Vous pouvez également utiliser des valeurs à virgule flottante pour spécifier des points intermédiaires, ou laisser les valeurs start ou end vides pour indiquer respectivement le premier ou le dernier point de données. start et end peuvent être négatifs, en tant qu'indice inverse par rapport à la dernière valeur. Si les valeurs start et end sont négatives, veillez à les écrire avec une valeur croissante (par exemple, -6:-1).

<size>

Épaisseur de la ligne en pixels.

<opt_z_order>

[Facultatif] Calque sur lequel dessiner 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 à la valeur inférieure et 1,0 à la valeur supérieure. Les éléments du graphique (lignes et barres) sont juste inférieurs à zéro. Si deux repères ont la même valeur, ils sont tracé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 tracé d'une ligne de repère sur un graphique à barres. L'ordre de plan est défini sur 1. La ligne est donc 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 ligne. Voici un exemple de graphique composé. Les graphiques composés sont dessinés en ajoutant des séries de données supplémentaires au paramètre chd, plus une valeur dans chd indiquant au graphique d'"ignorer" la série de données supplémentaire. Pour en savoir plus, consultez la page Graphiques composés.	chm=D,0033FF,1,0,5,1 chd=s1:1XQbnf4,43ksfg6

Haut de page

Repères de forme 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 certains seulement. 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. Cette procédure est expliquée dans la section Repères de points de données.

Vous pouvez combiner des repères de forme avec n'importe quel autre paramètre chm 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. Vous n'avez pas besoin de baliser toutes les séries. Si vous n'attribuez pas de repères à une série de données, celle-ci n'en recevra aucun.

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

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 du repère par le caractère @ facultatif, <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 – Croisé
• C : rectangle. S'il s'agit d'un repère rectangulaire, vous devez avoir au moins deux séries de données, la série 0 correspondant au bord inférieur et la série 1 au 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 le bas et le point correspondant dans la deuxième série pour le haut. Il 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 traversant le graphique. (Le seul format valide pour le paramètre <opt_which_points> est n.d.)
• H : ligne horizontale passant par le repère de données spécifié. Ce paramètre accepte une syntaxe <size> étendue qui vous permet de spécifier une longueur de ligne exacte: line_thickness[:length] où :length est facultatif. La valeur par défaut correspond à la largeur totale de la zone du graphique.
• o – Cercle
• s – Carré
• v : ligne verticale entre l'axe des abscisses et le point de données
• V : ligne verticale de longueur ajustable. Ce paramètre accepte une syntaxe de valeur <size> étendue qui vous permet de spécifier une longueur de ligne exacte: line_thickness[:length], où :length est facultatif. Il correspond par défaut à la hauteur complète de la zone du graphique. Le repère est centré sur le point de données.
• x : An X

<color>

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

<series_index>

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

<opt_which_points>

[Facultatif] Les points sur lesquels placer des 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 placer le repère, où n.d est l'indice de base zéro de la série. Si vous spécifiez une valeur non entière, la fraction indique un point intermédiaire calculé. Par exemple, 3,5 correspond à la moitié entre le point 3 et le point 4.
  • h : nombre compris entre 0,0 et 1,0, où 0 correspond à la partie inférieure 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 utiliser tous les points de données.
• -n : tracez un repère sur tous les n points de données. Valeur à virgule flottante. Si n est inférieur à 1, le graphique calcule des points intermédiaires supplémentaires. Par exemple, -0.5 place deux fois plus de repères que de points de données.
• start:end:n : trace un repère sur tous les nièmes points de données d'une plage, des valeurs d'index de début à la fin (incluses). Tous les paramètres sont facultatifs (peuvent être absents). 3::1 irait donc du quatrième élément au dernier, étape 1. Si vous omettez complètement 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 effectuer un décompte à partir de la dernière valeur. Si les valeurs start et end sont négatives, assurez-vous qu'elles sont indiquées avec une valeur croissante (par exemple, -6:-1:1). Si la valeur de pas n est inférieure à 1, les points de données supplémentaires sont calculés en interpolant les valeurs de données fournies. Les valeurs par défaut sont first:last:1
• x:y : tracez un repère à un point x/y spécifique du graphique. Il 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 est l'angle inférieur gauche du graphique et 1:1 est 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 utilisent une seule valeur numérique pour ce paramètre. Les repères V, H et S sont compatibles avec 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 dessiner 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 à la valeur inférieure et 1,0 à la valeur supérieure. Les éléments du graphique (lignes et barres) sont juste inférieurs à zéro. Si deux repères ont la même valeur, ils sont tracé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 horizontal et vertical à partir de l'emplacement spécifié. Voici la syntaxe, qui utilise un délimiteur : reserved:<horizontal_offset>:<vertical_offset>. Si elle est spécifiée, vous pouvez inclure une valeur ,, vide dans la chaîne de 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 s'il n'est pas utilisé.
• <vertical_offset> : nombre positif ou négatif spécifiant le décalage vertical, en pixels. Facultatif. Laissez ce champ vide s'il 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, longueur 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 à une hauteur désignée, première série, à mi-hauteur 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 second. Il est donc 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 tous les deux points de données (-2 correspond à tous les deux 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 contenant deux fois plus de repères que de points de données (-0,5 correspond à chaque demi-point).	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 une épaisseur personnalisées. La valeur de l'ordre z (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 du 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 à l'aide de coordonnées exactes. Le premier repère D est la ligne de trace sous les barres. Le deuxième repère est la flèche et le troisième, le texte fléché.	chm=   D,003971,1,0,3|   @a,000000,0,.25:.75,7|   @tExpected,000000,0,.35:.85,10
Une ligne horizontale fixée à 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 montre les repères permettant de spécifier l'épaisseur et la longueur du trait dans le paramètre <size>. E,000000,0,6,1:20 : barre d'erreur noire avec des lignes de 1 pixel de large, et des barres supérieure et inférieure d'une longueur de 20 pixels. La partie inférieure est ancrée à la série 0 point 8, tandis que la partie supérieure est ancrée aux séries 1 et point 8. H,990066,1,2,5:50 : violet, ligne horizontale de cinq pixels de largeur, cinquante pixels de long centré sur le point de données 2. V,3399CC,0,8,3:50 : ligne verticale bleue de 3 pixels de large, cinquante 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,05,07C chm=   E,000000,0,6,1:20|   H,990066,1,2,5:50|   V,3399CC,0,8,3:50

Haut de page

Marqueurs de bougies chm=F [Barre, Ligne]

Les repères en chandeliers japonais indiquent la variance et le changement de direction d'une série de données. Elles sont souvent utilisées pour afficher la valeur 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 basse, ainsi que les valeurs d'ouverture et de fermeture pour une période spécifique (généralement un jour). Pour en savoir plus sur les repères en chandeliers japonais, cliquez ici.

Un chandelier 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 minimale et maximale du jour.
• 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 la valeur 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 par défaut en vert uni. 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 uni par défaut. Vous ne pouvez spécifier une couleur de remplissage que pour le rectangle à valeur décroissante. Lorsque vous spécifiez ce paramètre, le rectangle dont la valeur augmente n'est pas rempli (vide). Notez que la série 2 peut être en haut ou en bas du rectangle, selon que le prix a augmenté ou baissé.

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

Remarque:Si vous ne souhaitez pas que les lignes des données utilisées pour tracer les repères apparaissent 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 page Graphiques composés.

Voici un exemple, illustrant les lignes de 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 chandelier.

<opt_declining_color>

[Facultatif] Couleur de remplissage des rectangles lorsque la valeur diminue (lorsque la valeur de la série 2 est > la valeur correspondante de la série 3). Il s'agit d'un nombre hexadécimal au format RRVVBB. Lorsque les valeurs augmentent, le rectangle est vide. La valeur par défaut est le vert fixe pour l'augmentation, le rouge uni pour la diminution (vous ne pouvez pas spécifier de 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 vos repères de chandeliers japonais. Il s'agit d'un indice de base zéro. Ainsi, si vous indiquez 1 ici et que vous avez six séries, les deuxième, troisième, quatrième et cinquième seront utilisées pour dessiner des repères en chandeliers japonais.

<opt_which_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'indice du point de la série. Si vous spécifiez une valeur non entière, la fraction indique un point intermédiaire calculé. Par exemple, 3,5 correspond à la moitié 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 sur tous les n points de données.
• start:end:n - Tracez un repère sur chaque nième point de données dans une plage de valeurs comprises, entre start et end (incluse). Tous les paramètres sont facultatifs (peuvent être absents). 3::1 irait donc du quatrième élément au dernier, étape 1. Si vous omettez complètement 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 effectuer un décompte à partir de la dernière valeur. Si les valeurs start et end sont négatives, assurez-vous qu'elles sont indiquées avec une valeur croissante (par exemple, -6:-1:1). Si la valeur de pas n est inférieure à 1, les points de données supplémentaires sont calculés en interpolant les valeurs de données fournies. Les valeurs par défaut sont first:last:1.

<largeur>

Largeur de tous les rectangles, en pixels.

<opt_z_order>

[Facultatif] Calque sur lequel dessiner 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 à la valeur inférieure et 1,0 à la valeur supérieure. Les éléments du graphique (lignes et barres) sont juste inférieurs à zéro. Si deux repères ont la même valeur, ils sont tracé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 à quatre séries. La couleur de remplissage personnalisée 0000FF (bleu) est spécifiée. Elle 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 permet d'afficher des lustres 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é: il s'agit d'une combinaison d'un graphique en courbes (type de graphique de base) et de repères en chandeliers japonais. La valeur 1 dans cht=t:1 signifie que toutes les séries de données après 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 savoir comment 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