複合チャート

  

概要

マーカーやローソク足マーカーを使って複数の種類のグラフを組み合わせることで、データの傾向をハイライト表示したり、差異を表示したりできます。折れ線マーカーやローソク足マーカーを棒グラフや散布図、その他の種類のグラフに追加すると、結果として作成されるグラフは複合グラフと呼ばれます。一部の複合グラフは、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 パラメータ(棒グラフの棒、折れ線グラフのデータポイントなど)で定義された基本グラフのタイプの要素の描画に使用 するデータ系列の数を示します。グラフを描画する際、追加したデータ系列はグラフの種類によって無視されます。これは 0 から始まる数値ではなく、1 から始まる数値であることに注意してください。つまり、t1 は「最初のデータ系列のみを棒に使用する」ことを意味し、t2 は「最初の 2 つのデータ系列のみを棒に使用する」ことを意味します。
    1. 注:
      1. 散布図 - 散布図では、データを非表示にする方法が異なります。詳しくは、ドキュメントをご覧ください。
      2. lxy 折れ線グラフ - 表示する偶数の数を指定します(t0t2t4 など)。これは、lxy グラフの各行が 2 つのデータ系列(1 つは x 値、もう 1 つは y 値)で記述されるためです。
  3. 非表示のデータ系列を使用して、ローソク足マーカー線マーカー、その他のマーカーを描画します。マーカーの描画方法については、リンク先のセクションで説明しています。非表示のデータ系列をマーカーのソースとして参照します。非表示のデータ系列はいくつでも追加でき、追加のグラフ マーカーに使用できます。

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

線マーカー付きの棒グラフ
cht=bvg
chd=t1:30,10,20|60,40,50
chm=D,0033FF,1,0,5,1

 

グラフの種類

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

マーカー タイプ サポートするベースチャートのタイプ
折れ線散布図横棒グラフレーダー
ローソク足 折れ線グラフ棒グラフ
その他すべて 折れ線散布図横棒グラフレーダー

複合グラフには、次のような種類があります。

グラフの種類 説明
折れ線マーカー グラフ 線マーカーを使用して、他の多くの種類のグラフで傾向を示すことができます。 線マーカー付きの棒グラフ線マーカー付きの棒グラフ
ローソク足チャート ローソク足チャートは売上データを表示する際によく使用されます。 1 本のオレンジ色の線と 4 つの金融マーカーが配置された折れ線グラフ。
箱ひげ図

箱ひげ図は、四分位の範囲にグループ化されたデータを表示する場合に使用します。

1 本のオレンジ色の線と 4 つの金融マーカーが配置された折れ線グラフ。
埋め込みグラフ グラフを別のグラフに埋め込むことができます。 グラフを埋め込みました
その他のマーカー 許容される基本グラフタイプのマーカーデータを非表示にして、他の種類のマーカーで使用することができます。
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 つのデータ系列は積み上げ棒グラフに使用し、残りの 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> を使用してローソク足マーカーを指定します。

1 本のオレンジ色の線と 4 つの金融マーカーが配置された折れ線グラフ。
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

線 + ローソク足

ローソク足チャートのもう 1 つの例(塗りつぶし色をカスタマイズしている場合)。

線マーカー付きの棒グラフ
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
バー + ローソク足

ローソク足マーカーを使用した棒グラフの例を次に示します。

ここでは、最初と最後のローソク足マーカーを表示しています。これは、棒の間隔が十分にあるため、グラフの境界によって切り取られることがないからです。

1 本のオレンジ色の線と 4 つの金融マーカーが配置された折れ線グラフ。
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
ローソク足マーカー
ボックスの本体を表す 1 組のローソク足マーカーchm=F): 最小、50、100 パーセンタイルの線に対応する、長さが調整可能な水平線の形状マーカーchm=H)のセット: 必要に応じて円形マーカーchm=o)を使用すると、データセット内の外れ値を表示できます。 これらをひとつにまとめれば、箱ひげ図が出来上がります。

箱グラフの基本グラフタイプは、棒グラフのタイプbhsbvsbhgbvg)または折れ線グラフのタイプlclslxy)のいずれかです。ただし、データ形式パラメータにゼロを追加して基本グラフのタイプを非表示にしている場合(例: chd=t0:chd=s0:)、どちらのグラフタイプを選択しても構いません。

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

塗りつぶされていないボックスのシリーズ順序:

  1. 最小値
  2. 25% のマーカー(塗りつぶしボックスの場合は 75%)
  3. 75% のマーカー(塗りつぶされたボックスの場合は 25%)
  4. 最大値
  5. 50% のマーカー
  6. シリーズ 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 - 最初のデータ系列(0)を起点とする 4 つのデータ系列を使用する、ポイント 1 ~ 4、サイズ 40 のオレンジのローソク足マーカー(F)。
    • H,0CBF0B,0,1:4,1:20 - 最小値を示す緑色の水平線マーカー。これらは第 1 シリーズからの内容です。
    • 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 - その他の外れ値。同じボックスの周囲に外れ値を互いに積み重ねる場合は、別のデータ系列が必要です。

2 つのデータセットがある縦棒グラフ: 1 つ目のデータセットは濃い青色、2 つ目のデータセットは薄い青色で積み重ねられています

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 を指定します。
グラフの種類 lc に枠線が表示されています
  cht=lc
グラフの種類 ls に枠線が表示されない
   cht=ls
塗りつぶしボックスを作成するには、2 つ目のシリーズの点を 3 つ目のシリーズの対応する点よりも大きくします。右側のコードでは大きい方の数値が赤色で示されています。 2 つのデータセットがある縦棒グラフ: 1 つ目のデータセットは濃い青色、2 つ目のデータセットは薄い青色で積み重ねられています
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 を空白のままにして最初または最後のデータポイントを示すこともできます。startend には、最後の値からの逆インデックスとして負の値を指定できます。startend の両方が負の値の場合は、値を昇順で記述します(例: -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 パラメータと組み合わせることができます。

構文

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

散布図では、シェイプ マーカーの動作が若干異なります。詳しくは、そちらのドキュメントをご覧ください。

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_who_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 になります。すべての値には浮動小数点数を使用できます。startend には負の値を指定して、最後の値から逆方向にカウントできます。startend の両方を負の値にする場合は、昇順で指定します(例: -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>
: マーカーのサイズ(ピクセル単位)。多くの場合、このパラメータには単一の数値を指定します。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 - 赤十字、最初の系列、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 - グラフの下から上の垂直線、最初の系列、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 ピクセル。
マーカー付きの折れ線グラフ
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 番目に指定されて描画されるため、円の上に描画されます。

折れ線グラフでは、一方の線は各データポイント上に 15 ピクセルの円、もう一方の線は 10 ピクセルのひし形で表示されます。両方の線の共通点にひし形が描画されます
chm=
  o,FF9900,0,-1,15.0|
  d,FF0000,1,-1,10.0

次の折れ線グラフでは、1 秒ごとに 1 つのデータポイントにマーカーが配置されています(-2 は 1 つおきを意味します)。

1 秒ごとのポイントにマーカーが配置された折れ線グラフ
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-2,6
次の折れ線グラフには、データポイントの 2 倍のマーカー数が含まれます(-0.5 は 0.5 ポイントごとを意味します)。 1 秒ごとのポイントにマーカーが配置された折れ線グラフ
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-.5,6
この例では、h マーカーと v マーカーを使用して、カスタムの色と太さでグリッド線を作成する方法を示しています。Z オーダーの値(最後の値)は -1 に設定され、グリッド線がデータラインの下に描画されます。
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 ピクセル。
1 秒ごとのポイントにマーカーが配置された折れ線グラフ
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 - 紫色、幅 5 ピクセル、長さ 50 ピクセル、データポイント 2 を中心とする水平線。
  • 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,2,5:50
chm=
  E,000000,0,6,1:20|
  H,990066,1,2,5:50|
  V,3399CC,0,8,3:50

トップへ戻る

ローソク足マーカー chm=F [棒グラフ]

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

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

  • シリーズ 1 と 4 は、それぞれ垂直線の最下部と上部を指定します。これらは通常、その日の最低値と最高値を表します。
  • シリーズ 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_who_points>
(省略可): マーカーの描画に使用するデータポイントを指定します。デフォルトはすべてのマーカーです。次のいずれかの形式を使用します。
  • n.d - シリーズ内の 1 つのポイントにマーカーを描画します。n.d はシリーズ内のポイントのインデックスです。整数以外の値を指定した場合、小数点以下は計算された中間点を示します。たとえば、3.5 はポイント 3 とポイント 4 の中間を意味します。
  • -1 - すべてのデータポイントにマーカーを描画します。このパラメータを空のままにして、すべてのマーカーに描画することもできます。
  • -n - n 番目のデータポイントごとにマーカーを描画します。
  • start:end:n - start から end までのインデックス値(両端を含む)内の、範囲内の n 番目のデータポイントごとにマーカーを描画します。すべてのパラメータは省略可能です(指定されていない可能性があるため、3::1 は 4 番目の要素から最後のステップ 1 まで)。このパラメータを完全に省略した場合、デフォルトの first:last:1 になります。すべての値には浮動小数点数を使用できます。startend には負の値を指定して、最後の値から逆方向にカウントできます。startend の両方が負の値の場合は、値を昇順で指定する必要があります(例: -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> パラメータは空白です。これにより、すべてのデータポイントにローソク足が描画されます。

4 本のオレンジ色の線と 4 つの金融マーカーが配置された折れ線グラフ

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 はゼロベースです)。このような複合グラフを描画する方法の詳細については、複合グラフをご覧ください。

1 本のオレンジ色の線と 4 つの金融マーカーが配置された折れ線グラフ。
cht=lc
chm=
  F,,1,1:4,20

chd=t1:
  15,40,30,27,39,54|
  ...

トップへ戻る