概要

いくつかのタイプのグラフを折れ線マーカーまたはローソク足マーカーと組み合わせることで、データの傾向をハイライトしたり、変化を示したりできます。折れ線マーカーやローソク足マーカーを棒グラフや散布図などのグラフに追加すると、そのグラフは複合グラフと呼ばれます。複合グラフの中には、2 つのタイプのグラフを組み合わせたように見えるものもあります。たとえば、追跡線のある棒グラフです。

ほかは、まったく新しいタイプのグラフ（箱ひげ図など）のように見えるものもあります。

.

複合グラフを作成する

すべての複合グラフは、1 つ以上の基本グラフタイプ（折れ線グラフ、散布図、棒グラフ、レーダーグラフ）と 1 つ以上のマーカーのセットで構成されます。これらのマーカーをグラフ上に配置するには、データが必要です。グラフ上に棒やポイントを描画する場合と同じデータ系列を使用できる場合もありますが、通常はマーカーに独自のデータセットを用意します。基本グラフとマーカーで異なるデータ系列をグラフにするには、基本グラフでマーカーデータを非表示にする必要があります（これにより、そのデータで棒や折れ線が描画されにくくなります）。手順は次のとおりです。

1. マーカーのデータ系列を chd パラメータの末尾に追加します。 たとえば、棒グラフのデータに chd=t:30,10,20 が含まれる場合、折れ線マーカー用の新しいデータは次のように追加できます（chd=t:30,10,20|60,40,50）。
2. 基本グラフで追加のマーカーデータを非表示にします。追跡線の棒グラフにデータ系列を追加しただけでは、新しい棒系列として表示されます。これを回避するには、この追加のシリーズを非表示にする必要があります。系列を非表示にするには、chd 形式記述子の後に 1 桁の数字を追加します（例: chd=t1:30,10,20|60,40,50）。この数字は、cht パラメータで定義された基本グラフタイプの要素を描画するために使用するデータ系列の数（棒グラフの棒、折れ線グラフのデータポイントなど）を Chart API に指示します。 それ以外のデータ系列は、グラフを描画するときにそのグラフの種類によって無視されます。これは 0 ベースではなく 1 から始まる数値であることに注意してください。たとえば、t1 は「最初のデータ系列のみを棒に使用する」ことを意味し、t2 は「最初の 2 つの系列のみを棒に使用する」ことを意味します。
   1. 注:
      1. 散布図 - 散布図は、異なる方法でデータを非表示にします。詳しくは、ドキュメントをご覧ください。
      2. lxy 折れ線グラフ - 表示する偶数個の系列（t0、t2、t4 など）を指定します。これは、lxy グラフの各線が 2 つのデータ系列（x の値用と y の値用）で記述されるためです。
3. 非表示のデータ系列を使って、ローソク足マーカー、線マーカーなどのマーカーを描画します。マーカーの描画方法については、リンク先のセクションで説明します。非表示のデータ系列をマーカーのソースとして参照します。追加の非表示データ系列はいくつでも追加でき、追加のグラフ マーカーとして使用できます。

先ほど説明したグラフは次のとおりです。

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

 

グラフの種類

マーカーの種類と、使用できるグラフの種類は次のとおりです。

マーカーの種類	サポートされている基本グラフの種類
線	折れ線、散布図、棒、レーダー
ローソク足	Line、Bar
その他すべて	折れ線、散布図、棒、レーダー

作成できる複合グラフの種類の例をいくつか紹介します。

グラフの種類	説明	例
線マーカー グラフ	線マーカーは、他の多くの種類のグラフで傾向を示すために使用できます。
ローソク足チャート	ローソク足チャートは財務データの表示によく使用されます。
箱ひげ図	箱ひげ図は、範囲四分位にグループ化されたデータを表示するために使用します。
埋め込みグラフ	グラフを別のグラフに埋め込むことができます。
その他のマーカー	使用可能な基本グラフの種類で、マーカーデータを非表示にして、他の任意の種類のマーカーと併用できます。	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

トップへ戻る

 

線マーカー グラフ

折れ線、scatter、棒グラフ、レーダーグラフに線を追加して、傾向を目立たせることができます。

ベースタイプ + マーカータイプ	説明	例
棒と線	こちらはトレース線のある棒グラフです。最初の 2 つのデータ系列が積み上げ棒グラフに使用され、残りのデータ系列が線に使用されます。chd=s2 は、棒グラフの最初の 2 つの系列のみを使用することを示します。この線のデータには 3 つ目の系列が使用されます。 chd=s2:1XQbnf4,EWoQMUB,9halxp9 - 単純なエンコード。最初の 2 つのシリーズが棒の描画に使用され、最後のシリーズが線に使用されます。 chm=D,0033FF,2,0,5,1 - トレースライン（D）、青、シリーズ インデックス 2 からのデータ、すべてのポイント（0）です。ラインの幅は 5 ピクセル、Z オーダーは 1 です。	chm=   D,0033FF,2,0,5,1 chd=s2:   1XQbnf4,   EWoQMUB,   9halxp9
散布図 + 折れ線	散布図に線を追加すると、平均値を表示できます。散布図では、マーカーデータが非表示の点が異なります。詳しくは、散布図をご覧ください。	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
棒と線	別の積み上げ棒グラフの上に独立した線が引かれています。	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
バー + 円	前のグラフと同じですが、線マーカーの代わりに円マーカーを使用します。ここでは 0.5 のデータ値を指定して、点線上に計算された中点を追加しています。	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

トップへ戻る

 

ローソク足チャート

ローソク足チャートでは、ローソク足を描画するための少なくとも 4 つのデータ系列と、その他のグラフ要素用の追加の系列が必要です。ローソク足チャートでは、一組のローソク足マーカーのみを表示するか、以下のようにローソク足マーカーと棒グラフまたは折れ線グラフを組み合わせて表示できます。

ベースタイプ + マーカータイプ	説明	例
線（非表示）+ ローソク足	この例は、ローソク足マーカーのみを表示するグラフを示しています。 chd=t0 - 0 は、すべてのデータ系列が基本グラフタイプ（ここでは折れ線グラフ）で非表示になり、ローソク足だけが描画されることを意味します。各系列の最初と最後の値は -1 です。これは、最初または最後のローソク足が描画されないようにするために欠損値を示します。ローソク足は軸またはグラフのマージンと重なって切り捨てられます。 chm=F,0000FF,0,-1,20 - F はローソク足のマーカー（元々は「金融マーカー」）を示します。0000FF は、値が減少している際にマーカーが青色になることを意味します。0 は、ローソク足のデータが系列 0 から始まることを示し、-1 はすべてのポイント上のマーカーを示します（ここで、-1 のデータ値を使用する代わりに最初と最後のローソク足を非表示にするように 0:4 を指定できます）。20 はローソク足の幅です。	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
線 + ローソク足	ローソク足マーカーのある折れ線グラフの例を次に示します。 5 つのデータ系列が用意されています。1 つ目はグラフの種類（折れ線）用で、残りの「非表示」のデータ系列はローソク足マーカー用です。chd=t1 パラメータは、そのグラフの種類（折れ線グラフ）で最初の系列のみが使用されることを指定します。 最初と最後のローソク足はグラフ領域の枠線で切り取られるため、<which_points> 値の 1:4 を使用して最初と最後のローソク足のマーカーは省略しています。 chm パラメータは、構文 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
線 + ローソク足	ローソク足チャートのもう一つの例。塗りつぶしの色はカスタムです。	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
バー + ローソク足	これは、ローソク足マーカー付きの棒グラフの例です。 ここでは最初と最後のローソク足のマーカーを表示しています。これは、棒がグラフの境界で切り取られないよう、棒に十分なスペースがあるからです。	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

トップへ戻る

 

箱ひげ図

箱ひげ図は、1 つ以上の系列を四分位にグループ化するグラフの一種です（四分位は、外れ値を除き、値の範囲の 25% にまたがるグループです）。箱ひげ図とも呼ばれます。箱ひげ図はローソク足チャートに似ていますが、ローソク足の下部と上部にマーカーと 50 パーセンタイル マーカーが追加されています。

次に示すように、箱ひげ図は完全にマーカーで構成されています。

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
箱の本体に使うローソク足マーカー（chm=F）のセット:	最小、50 パーセンタイル、100 パーセンタイルの線用に、長さを調整できる水平線形状のマーカー（chm=H）のセット:	必要に応じて、データセット内の外れ値を示す円形状のマーカー（chm=o）を使用します。	これらをすべて 1 つにまとめると、箱ひげ図が完成します。

箱ひげ図の基本グラフの種類は、棒グラフの種類（bhs、bvs、bhg、bvg）または折れ線グラフの種類（lc、ls、lxy）のいずれかです。ただし、データ形式のパラメータにゼロを追加して基本グラフの種類を非表示にする場合は（例: chd=t0:、chd=s0:）、どのグラフの種類を選択しても構いません。

箱ひげ図には少なくとも 5 つのデータ系列が必要です。つまり、箱、最大マーカー、最小マーカー用に 4 つ、50% マーカー用に 1 つ、さらに必要に応じてその他のマーカー（外れ値マーカーなど）に使用する追加のデータ系列です。推奨されるシリーズの順序は次のとおりです。シリーズ 1 の値がシリーズ 2 の対応する値より大きい場合、ボックスは chm=F マーカーの色で塗りつぶされます。シリーズ 1 の値がシリーズ 2 の値よりも小さい場合、ボックスは塗りつぶされません。詳しくは、ローソク足マーカーをご覧ください。

箱が未記入の場合のシリーズの順番:

0. 最小値
1. 25% のマーカー（塗りつぶされた箱の場合は 75%）
2. 75% のマーカー（塗りつぶしの箱の場合は 25%）
3. 最大値
4. 50% のマーカー
5. シリーズ 6 以降は、外れ値などの追加のマーカー データ用です。

ローソク足マーカー データの前または後に追加のマーカー シリーズを配置することもできますが、最後にすべて配置する方が簡単です。

マーカーや基本グラフの種類を指定したり、データの順序を変えたりすることで、さまざまなスタイルの箱ひげ図を作成できます。

説明	例
標準の箱ひげ図ですが、各グラフ要素の作成にどのマーカーが使用されているかがわかるように、グラフ要素ごとに異なる色が割り当てられています。 cht=bvs - 基本グラフの種類は bvs ですが、この基本グラフの棒は実際には表示されていません。ここでは任意の複合グラフタイプを指定できます chd=t0: - t0 を指定すると、この折れ線グラフのすべての線が非表示になります。データはすべてマーカーにのみ使用されます。データでは、マーカーがグラフの左右端に重ならないように、最初と最後の値が -1 になります。2 番目の系列の値は 3 番目の系列の対応する値よりも小さいため、すべてのボックスは空になります。 -1,5,10,7,12,-1 - 最小値: 下のオレンジ色のスティックの最下点。緑色の水平線の高さ。 -1,25,30,27,24,-1 - 25% 値: オレンジ色のボックスの下水平端。 -1,40,45,47,39,-1 - 75% 値: オレンジ色のボックスの上端。 -1,55,63,59,80,-1 - 最大値: 上のオレンジ色の棒の上部点。青い水平線の高さ。 -1,30,40,35,30,-1 - ローソク足の内側にある黒い水平の「中央値」線。 -1,-1,5,70,90,-1 - 外れ値データ（赤い円） -1,-1,-1,80,5,-1 - その他の外れ値データ（赤い円）。オフセットなどの複雑な方法を使用せずに、同じ系列で 2 つのマーカーを上下に指定することはできないため、外れ値データは 2 つのセットに分割されます。 chm= - 以下のマーカーデータ。 F,FF9900,0,1:4,40 - オレンジ色のローソク足マーカー（F）。最初の系列（0）から始まる 4 つのデータ系列、ポイント 1 ～ 4、サイズ 40 を使用します。 H,0CBF0B,0,1:4,1:20 - 最小値を示す緑色の水平線マーカー。これらは最初のシリーズからのものです。 H,0000FF,3,1:4,1:20 - 最大値を示す青色の水平線マーカー。これらはシリーズ 3 のものです。 H,000000,4,1:4,1:40 - 50% 値を示す黒い水平線マーカー。これらはシリーズ 4 のものです。 o,FF0000,5,-1,7 - 外れ値の場合、6 番目のデータ系列に割り当てられた赤い円。マーカーは、このシリーズのすべての要素に割り当てられます。外れ値のないボックスには -1 が使用されます。 o,FF0000,6,-1,7 - その他の外れ値。同じボックスの周囲に外れ値を重ねる場合は、別のデータ系列が必要です。	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
lc グラフの種類では、常に軸線が表示されます。軸線のないグラフを作成するには、グラフの種類に ls を指定します。	cht=lc    cht=ls
塗りつぶしボックスを作成するには、2 つ目の系列の点を 3 つ目の系列の対応する点よりも大きくします。右側のコードで示されている値が大きいほど赤色で示されています。	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

トップへ戻る

 

埋め込みグラフ

動的アイコンを使用して、棒グラフ、折れ線、レーダー、scatterグラフ内に任意の種類のグラフを埋め込むことができます。詳しくは、動的アイコン（chem）マーカーのドキュメントの埋め込みグラフのセクションをご覧ください。

トップへ戻る

 

標準の機能

このページの残りの機能は、標準のグラフ機能です。

線マーカー chm=D [棒、ローソク足、折れ線、レーダー、散布図]

グラフ内のデータをトレースする線を追加できます。通常は複合グラフで使用されます。

複数の行を追加する（または他の chm マーカーと組み合わせる）には、パイプ（|）区切り文字を使用して chm パラメータ セットを区切ります。このパラメータを使用して破線のマーカーを作成することはできません。

構文

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

D

線マーカーであることを示します。

<color>

線の色。RRGGBB の 16 進形式で指定します。

<series_indexseries_index>

線の描画に使用されるデータ系列のインデックス。データ系列インデックスは、最初のデータ系列は 0、2 番目のデータ系列は 1 となります（以下同様）。

<which_points>

系列のどの点を使用して線を描画するか。次のいずれかの値を使用します。

• 0 - 一連の点をすべて使用します。
• start:end - 開始から終了までの一連のポイント（ゼロベースのインデックス）を使用します。浮動小数点値を使用して中間点を指定することもできます。また、start または end を空白のままにして、それぞれ最初または最後のデータポイントを示すこともできます。start と end は負の値にでき、最後の値からの逆インデックスになります。start と end の両方が負の数である場合は、大きい方の値で書き込んでください（-6:-1 など）。

<size>

線の幅（ピクセル単位）。

<opt_z_order>

（省略可）: マーカーを描画するレイヤ（他のマーカーおよび他のすべてのグラフ要素との比較）。これは -1.0 から 1.0 までの浮動小数点数です。-1.0 は底、1.0 は上です。グラフ要素（折れ線と棒）は 0 よりも小さいほどです。2 つのマーカーが同じ値を持つ場合、URL で指定された順序で描画されます。デフォルト値は 0.0（グラフ要素のすぐ上）です。

 

例

説明	例
これは、棒グラフ上にマーカー線を描画する例です。Z オーダーは 1 に設定されているため、線は棒の上に描画されます。 この例では、棒とデータ線の両方に同じデータを使用します。	chm=D,0033FF,0,0,5,1 chd=s:1XQbnf4
これは同じ棒グラフですが、折れ線のデータ系列が追加されています。これは複合グラフの例です。複合グラフを描画するには、chd パラメータにデータ系列を追加し、さらに chd に値を追加して、追加のデータ系列を「無視」するよう指定します。 詳しくは、複合グラフをご覧ください。	chm=D,0033FF,1,0,5,1 chd=s1:1XQbnf4,43ksfg6

トップへ戻る

シェイプ マーカー chm [棒、線、レーダー、散布図]

グラフ上のすべてまたは個々のデータポイントに、グラフィカル マーカーを指定できます。同じ点を占有する複数のマーカーがある場合、マーカーは chm パラメータに指定される順序で描画されます。データポイントにテキスト マーカーを作成することもできます。これについては、データポイント マーカーをご覧ください。

パイプ文字（|）を使用して、シェイプ マーカーを他の chm パラメータと組み合わせることで、chm パラメータを区切ることができます。

構文

マークするシリーズごとに、次のパラメータ セットのいずれかを指定します。複数のシリーズをマークするには、追加のパラメータ セットをパイプ文字で区切って作成します。すべてのシリーズをマークアップする必要はありません。データ系列にマーカーを割り当てなければ、マーカーは作成されません。

散布図では、シェイプ マーカーの動作が若干異なります。詳細については、該当するドキュメントをご覧ください。

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>

@

（省略可）: マーカータイプの前にオプションの @ 記号を付ける場合、<opt_that_points> には x:y 形式を使用します。

<marker_type>

使用するマーカーのタイプ。次のいずれかのタイプを指定します。

• a - 矢印
• c - クロス
• C - 長方形。長方形マーカーの場合は、少なくとも 2 つのデータ系列が必要です。系列 0 は下端、シリーズ 1 は上端を指定します。<size> は長方形の幅をピクセル単位で指定します。
• d - ひし形
• E - エラーバー マーカー（） このマーカーを作成するには、2 つのデータ系列が必要です。1 つ目のデータは下部に、2 つ目の系列は上部に対応する点です。また、拡張された <size> 構文、line_thickness[:top_and_bottom_width] も公開されています。top_and_bottom_width は省略可能です。以下の例をご覧ください。
• h - 指定した高さにおけるグラフ上の水平線。（<opt_which_points> パラメータで有効な形式は opt_which_points のみです）。
• H - 指定されたデータ マーカーを通る水平線。これにより、拡張された <size> 構文を使用して正確な線の長さを指定できます: line_thickness[:length] ここで :length は省略可能で、デフォルトはグラフ領域全体の幅です。
• o - 円
• s - 正方形
• v - X 軸からデータポイントまでの垂直線
• V - 長さを調整できる垂直線。これにより、拡張された <size> 値の構文を使用して、正確な線の長さを指定できます: line_thickness[:length] ここで、:length は省略可能で、デフォルトはグラフ領域全体の高さです。 マーカーは、データポイントの中央に配置されます。
• x - X

<color>

: このシリーズのマーカーの色（RRGGBB の 16 進数形式）。

<series_indexseries_index>

: マーカーを描画するデータ シリーズのインデックス（ゼロベース）です。h マーカーや、x/y 位置（「@」で始まる）で位置を指定するマーカーでは無視されます。非表示のデータ系列をマーカーのソースとして使用できます。詳しくは、複合グラフをご覧ください。グループ化された縦棒グラフでは、マーカーを特定の棒に揃えるための特別な拡張構文がサポートされています。

<opt_which_points>

（省略可）: マーカーを描画するポイント。デフォルトはすべてのマーカーです。次のいずれかの値を使用します。

• n.d - マーカーを描画する場所。意味は、マーカーのタイプによって異なります。
  • h を除くすべての型 - マーカーを描画するデータポイント。n.d は系列内のゼロベースのインデックスです。整数以外の値を指定した場合、小数は計算された中間点を示します。たとえば、3.5 はポイント 3 とポイント 4 の中間を意味します。
  • h - 0.0 ～ 1.0 の数値。0.0 はグラフの最下部、1.0 はグラフの上部です。
• -1 - すべてのデータポイントにマーカーを描画します。このパラメータを空のままにして、すべてのデータポイントの上に描画することもできます。
• -n - n 番目のデータポイントごとにマーカーを描画します。浮動小数点値。n が 1 未満の場合、グラフによって追加の中点が計算されます。たとえば、-0.5 では、データポイントの 2 倍のマーカーを配置します。
• start:end:n - start から end までのインデックス値（両端を含む）内の n 番目のデータポイントごとにマーカーを描画します。パラメータはすべて省略可能（存在しない場合もあります）であるため、3::1 は 4 番目の要素から最後のステップ 1 までとなります。このパラメータを完全に省略すると、デフォルトの first:last:1 になります。すべての値に浮動小数点数を指定できます。start と end は負の値にし、最後の値から後方にカウントします。start と end の両方が負の値の場合は、大きい方の値で列挙します（例: -6:-1:1）。n ステップの値が 1 未満の場合、与えられたデータ値を補間して追加のデータポイントを計算します。デフォルト値は first:last:1 です
• x:y - グラフ上の特定の x/y 点にマーカーを描画します。この点は直線上にある必要はありません。このオプションを使用するには、マーカータイプの前に @ 文字を追加します。座標を浮動小数点値として指定します。0:0 はグラフの左下隅、1:1 はグラフの右上隅です。たとえば、15 ピクセルの赤いひし形をグラフの中央に追加するには、@d,FF0000,0,0.5:0.5,15 を使用します。

<size>

: マーカーのサイズ（ピクセル単位）。ほとんどの場合、このパラメータは 1 つの数値を取ります。V、H、S マーカーは構文 <size>[:width] をサポートしています。2 番目の部分では、線またはマーカーの長さを指定します（省略可）。

<opt_z_order>

（省略可）: マーカーを描画するレイヤ（他のマーカーおよび他のすべてのグラフ要素との比較）。これは -1.0 から 1.0 までの浮動小数点数です。-1.0 は底、1.0 は上です。グラフ要素（折れ線と棒）は 0 よりも小さいほどです。2 つのマーカーが同じ値を持つ場合、URL で指定された順序で描画されます。デフォルト値は 0.0（グラフ要素のすぐ上）です。

<opt_offset>

（省略可）指定した場所からの水平方向と垂直方向のオフセットを指定できます。構文は次のとおりです。区切り文字は「reserved:<horizontal_offset>:<vertical_offset>」を使用しています。指定すると、<opt_z_order> の chm パラメータ文字列に空の値を含めることができます。例: o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20

• reserved - 空白のままにします。
• <horizontal_offset> - 水平オフセットをピクセル単位で指定する正または負の数値。省略可。使用しない場合は空白のままにします。
• <vertical_offset> - 垂直オフセットを指定する正または負の数値（ピクセル単位）。省略可。使用しない場合は空白のままにします。

 

例

説明	例
シェイプとラインのマーカーの例をいくつか示します。 a,990066,0,0.0,9.0 - 紫色の矢印、最初のシリーズ、最初のポイント、サイズ 9。 c,FF0000,0,1.0,20.0 - 赤いバツ印、1 つ目のシリーズ、2 つ目のポイント、サイズ 9。 d,80C65A,0,2,20.0 - 緑色のひし形、1 つ目のシリーズ、3 つ目の点、サイズ 9。 H,000000,0,3,1:40 - 黒い水平線、最初の系列、データポイント 3、幅 1 ピクセル、長さ 40 ピクセル。 o,FF9900,0,4.0,12.0 - オレンジ色の円、最初のシリーズ、5 番目のポイント、サイズ 12。 s,3399CC,0,5.0,11.0 - 青い正方形、1 つ目のシリーズ、6 つ目のポイント、サイズ 11。 v,BBCCED,0,6.0,1.0 - ポイントまでの垂直線、最初のシリーズ、7 番目のポイント、幅 1 ピクセル。 V,3399CC,0,7.0,1.0 - グラフの下から上の垂直線、1 つ目の系列、8 つ目のポイント、幅 1 ピクセル。 x,FFCC33,0,8.0,20.0 - 黄色の「X」、最初のシリーズ、9 番目のポイント、サイズ 20。 H,FFFF00,0,9,2 - データポイント 9 のグラフの幅を表す黄色の水平線。 h,FF0000,0,0.5,1 - 指定した高さの赤い水平線、1 つ目の系列、チャートの中間、幅 1 ピクセル。	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
1 つのデータ系列でひし形を使用し、もう 1 つのデータ系列で円を使用する例を次に示します。 同じ点を占有する複数のマーカーがある場合、マーカーは chm パラメータに指定される順序で描画されます。ここでは、chm で指定された最初のマーカーが円であるため、最初に描画されます。ひし形は指定されて 2 番目に描画されるため、円の上に描画されます。	chm=   o,FF9900,0,-1,15.0|   d,FF0000,1,-1,10.0
次の折れ線グラフでは、データポイントごとにマーカーが配置されています（-2 は 1 日おきを意味します）。	chd=t:   0,20,20,50,40,70,70,90,85,45,40,50 chm=   o,0066FF,0,-2,6
次の折れ線グラフでは、マーカーの数がデータポイントの 2 倍になっています（-0.5 は半点ごとを意味します）。	chd=t:   0,20,20,50,40,70,70,90,85,45,40,50 chm=   o,0066FF,0,-.5,6
この例では、h マーカーと v マーカーを使用して、カスタムの色と太さのグリッド線を作成する方法を示します。Z オーダーの値（最後の値）を -1 に設定して、グリッド線がデータ線の下に描画されるようにします。	chm=   h,76A4FB,0,0:1:.2,2,-1|   V,76A4FB,0,::2,0.5,-1
次のグラフは、折れ線グラフに垂直方向の塗りつぶし線を追加します。 v - グラフの垂直線 FF0000 - 赤い線 0 - シリーズ インデックス : :.5 - 範囲指定子: 開始から終了まで、0.5 ポイントごと。 2 - 太さ 2 ピクセル。	chm=   v,FF0000,0,::.5,2
この例では、正確な座標を使用して矢印とテキスト マーカーをグラフに追加します。最初の D マーカーは棒の下にあるトレース線です。2 つ目のマーカーは矢印、3 つ目のマーカーは矢印のテキストです。	chm=   D,003971,1,0,3|   @a,000000,0,.25:.75,7|   @tExpected,000000,0,.35:.85,10
特定のデータポイント（H）に固定された水平線は、相対値を表示したり、グラフ上でデータ値の高さを強調したりする場合に役立ちます。	chm=H,FF0000,0,18,1
このグラフは、<size> パラメータで線の太さと長さを指定できるマーカーを示しています。 E,000000,0,6,1:20 - 黒色のエラーバー。線の幅は 1 ピクセル、上下のバーの長さは 20 ピクセルです。下部は系列 0 のポイント 8 に固定され、上部は系列 1 のポイント 8 に固定されています。 H,990066,1,2,5:50 - データポイント 2 を中心とする紫色の横線。幅 5 ピクセル、長さ 50 ピクセル。 V,3399CC,0,8,3:50- 青色の垂直線。幅 3 ピクセル、長さ 50 ピクセル、データポイント 8 を中心としています。	title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,92,5,3,5,990066,09008033 chm=   E,000000,0,6,1:20|   H,990066,1,2,5:50|   V,3399CC,0,8,3:50

トップへ戻る

ローソク足マーカー chm=F [棒、線]

ローソク足マーカーは、データ系列の分散と方向の変化を示します。多くの場合、1 日の株価を表示するために使用されます。マーカーには、高値と低値、特定の期間（通常は 1 日）の開始値と終了値を示すセグメントが含まれます。ローソク足マーカーについて詳しくは、こちらをご覧ください。

ローソク足マーカーは、垂直線で二等分された長方形として描画されます。ローソク足マーカーを描画するには、4 つのデータ系列が必要です。各系列で指定する内容は次のとおりです。

• Series 1 と 4 は、それぞれ縦線の下部と上部を指定します。これらは通常、その日の最低値と最高値を表します。
• Series 2 と 3 は、長方形の垂直境界を指定します。系列 2 は始値、系列 3 は終値を表します。長方形の色はどちらが高いかによって異なります。始値（シリーズ 2）が終値（シリーズ 3）より低い場合、価格は上昇し、長方形はデフォルトで緑色で塗りつぶされます。始値（シリーズ 2）が終値値（シリーズ 3）より高い場合、価格は下がり、長方形はデフォルトで赤色で塗りつぶされます。長方形の塗りつぶしの色は、値が小さいほど指定できます。この値を指定すると、値が増加する長方形は塗りつぶされません（空になります）。シリーズ 2 は、価格の上昇または下落に応じて、長方形の上部または下部のいずれかになります。

ローソク足マーカーと他の chm パラメータを組み合わせるには、パイプ文字（|）を使用して chm パラメータを区切ります。

注: マーカーの描画に使用したデータの線をグラフに表示したくない場合は、表示形式の後に 0 を含める必要があります。たとえば、テキスト形式のデータ文字列内の chd=t0:10,20,30,40。詳しくは、複合グラフをご覧ください。

次の例では、各系列の行を示しています。

構文

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

F

ローソク足マーカーであることを示します。

<opt_declining_color>

（省略可）: 値が減少している場合（系列 2 の値 > 対応する系列 3 の値の場合）長方形の塗りつぶしの色。これは RRGGBB 形式の 16 進数です。値が増えると、長方形は空になります。デフォルトは、増加する場合は緑で点灯し、減少する場合は赤で点灯します（値を増やす場合はカスタムの塗りつぶしの色を指定できません）。

<data_series_index>

ローソク足マーカーの最初のシリーズとして使用するデータシリーズのインデックス。これはゼロベースのインデックスです。そのため、ここで 1 を指定し、6 つのシリーズがある場合、2 番目、3 番目、4 番目、5 番目のシリーズがローソク足マーカーの描画に使用されます。

<opt_選択するポイント>

（省略可）: マーカーの描画に使用するデータポイントを指定します。デフォルトはすべてのマーカーです。次のいずれかの形式で指定してください。

• n.d - 系列内の 1 つの点にマーカーを描画します。ここで、n.dn.d は系列内の点のインデックスです。整数以外の値を指定した場合、小数は計算された中間点を示します。たとえば、3.5 はポイント 3 とポイント 4 の中間を意味します。
• -1 - すべてのデータポイントにマーカーを描画します。このパラメータを空のままにして、すべてのマーカーの上に描画することもできます。
• -n - n 番目のデータポイントごとにマーカーを描画します。
• start:end:n - start から end までのインデックス値（両端を含む）内の n 番目のデータポイントごとにマーカーを描画します。パラメータはすべて省略可能（存在しない場合もあります）であるため、3::1 は 4 番目の要素から最後のステップ 1 までとなります。このパラメータを完全に省略すると、デフォルトの first:last:1 になります。すべての値に浮動小数点数を指定できます。start と end は負の値にし、最後の値から後方にカウントします。start と end の両方が負の値の場合は、大きい方の値で列挙します（例: -6:-1:1）。n ステップの値が 1 未満の場合、与えられたデータ値を補間して追加のデータポイントを計算します。デフォルト値は first:last:1 です

<幅>

すべての長方形の幅（ピクセル単位）。

<opt_z_order>

（省略可）: マーカーを描画するレイヤ（他のマーカーおよび他のすべてのグラフ要素との比較）。これは -1.0 から 1.0 までの浮動小数点数です。-1.0 は底、1.0 は上です。グラフ要素（折れ線と棒）は 0 よりも小さいほどです。2 つのマーカーが同じ値を持つ場合、URL で指定された順序で描画されます。デフォルト値は 0.0（グラフ要素のすぐ上）です。

 

例

説明	例
4 つの系列を持つ折れ線グラフに表示されたローソク足マーカーの例です。カスタムの塗りつぶし色 0000FF（青）が指定されており、この色は、系列 3 の点が系列 2 の対応する点よりも小さい場合、長方形の塗りつぶしに使用されます。 最初と最後の長方形はグラフによってトリミングされます。これらの値を除外するには、chm の 4 番目のパラメータに 1:4 を指定します。 系列の線（chd=t0）を非表示にするため、データ文字列内のゼロをメモします。これは、すべてのグラフデータをマーカーに使用することを示します。 <which_point> パラメータは空白で、すべてのデータポイントにローソク足が描画されます。	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
同じグラフの例を以下に示します。ここでは、デフォルトの色を使用し、最初と最後のアイテムを削除しています。 これは複合グラフで、折れ線グラフ（基本グラフの種類）とローソク足マーカーを組み合わせたものです。cht=t:1 の値が 1 の場合、最初のデータ系列以降のすべてのデータ系列が基本のグラフタイプ（折れ線グラフ）で非表示になります。chm=F,,1,1:4,20 の最初の 1 は、ローソク足データが系列 2、3、4、5 から取得されることを意味します（1 はゼロベースです）。このような複合グラフを描画する方法の詳細については、複合グラフをご覧ください。	cht=lc chm=   F,,1,1:4,20 chd=t1:   15,40,30,27,39,54|   ...

トップへ戻る