折れ線グラフ

   

このドキュメントでは、Chart API を使用して作成できるさまざまなタイプの折れ線グラフについて説明します。

目次

グラフ固有の機能

  1. グラフの種類（cht）
  2. データの粒度
  3. 系列の色（chco）

Standard の機能

  1. 複合グラフ
  2. グラフのタイトル（chtt、chts）
  3. グラフの凡例のテキストとスタイル（chdl、chdlp、chdls）
  4. グラフのマージン（chma）
  5. 軸のスタイルとラベル
    1. 軸の表示（chxt）
    2. 軸の範囲（chxr）
    3. カスタムの軸ラベル（chxl）
    4. 軸ラベルの位置（chxp）
    5. 軸ラベルのスタイル（chxs）
    6. 軸の目盛り（chxtc）
  6. 背景の塗りつぶし（chf）
    1. ソリッドフィル（chf）
    2. グラデーション塗りつぶし（chf）
    3. ストライプ塗りつぶし（chf）
  7. グリッド線（chg）
  8. 線のスタイル（chls）
  9. Dynamic Markers（chem）
  10. 線塗りつぶし（chm）
  11. シェイプ マーカー（chm）
  12. テキストおよびデータ値マーカー（chm）
  13. 範囲マーカー（chm=r|R）
  14. ローソク足マーカー（chm=F）
  15. 線マーカー（chm=D）
  16. データ関数（chfd）

グラフの種類（cht）

さまざまな折れ線グラフを作成できます。折れ線グラフを指定するには、次の構文を使用します。

構文

cht=<chart_type>

ここで、<chart_type> は次のいずれかの型です。

パラメータ 説明 例

lc

データポイントが x 軸に沿って均等に配置された折れ線グラフx。デフォルトでは軸線が表示されます。軸線に値を表示するには、chxt を指定する必要があります。

黄色の線グラフ
cht=lc
chd=t:40,60,60,45,47,75,70,72

ls

lc グラフと似ていますが、デフォルトでは軸線を表示しません。これらはスパークラインとも呼ばれます。

青のスパークライン グラフ
cht=ls
chd=t:27,25,60,31,25,39,25,
31,26,28,80,28,27,31,27,
29,26,35,70,25

lxy

各ポイントに y 値だけでなく、x 座標と y 座標の両方を指定できます。

lxy グラフのデータポイントを指定するには、2 の倍数で系列を指定する必要があります。各ペアの最初の系列はその線の x 座標で、2 番目の系列はその線の対応する y 座標です。次に例を示します。

chd=t:<line_1_x1>,<line_1_x2>,...|<line_1_y1>,<line_1_y2>,...|
      <line_2_x1>,<line_2_x2>,...|<line_2_y1>,<line_2_y2>,...

データポイントを x 軸のみに沿って均等に配置するには、その系列の x セットに未定義の値を 1 つ指定します。xxこの例では、赤い「ユニコーン」の線により、データポイントが X 軸に沿って均等に配置されます。未定義の値の詳細については、データ形式をご覧ください。

この例の「Ponies」行ではすべてのポイントの正確な x 値と y 値を指定し、「Unicorns」行では x 軸に沿って均等に値を配置します。

注: 複合 lxy グラフを作成する場合は、chd パラメータでデータを 2 の倍数で表示する必要があることを忘れないでください。たとえば、すべての線を非表示にするには chd=t0:、1 つの線を描画するには chd=t2:、2 つの線を描画するには chd=t4: と指定します。chd=t1: を指定すると線は描画されません。chd=t3: を指定すると、1 つの線のみが描画されます。

 データポイントが不均等に配置され、赤、緑、青の破線が描かれた折れ線グラフ
cht=lxy
chd=t:
  10,20,40,80,90,95,99|
  20,30,40,50,60,70,80|
  -1|
  5,10,22,35,85

トップへ戻る

データの粒度

折れ線グラフに必要なデータポイントの数が多くなりすぎないように注意してください。たとえば、過去 10 年間におけるチョコレート アイスクリームの人気度を示す場合、毎日の検索クエリを集計すると、3,600 を超える値が返されることになります。この粒度でグラフをプロットしても意味がありません。幅が 1, 024 ピクセルのグラフでは、1 つのデータポイントは約 4 分の 1 ピクセルになります。（また、URL で渡すにはデータが多すぎます）。次の例は、この点を示しています。

40 個のデータポイントがある幅 200 ピクセルのグラフ（データポイントあたり 5 ピクセル）:

黄色の折れ線グラフ: データポイントが X 軸に沿って広がるため、読みにくくなります。

80 個のデータポイント（データポイントあたり 2.5 ピクセルのみ）:

黄色の折れ線グラフ: データポイントが X 軸に沿って押しつぶれているため、読みにくい

150 個のデータポイント（データポイントあたり 1.3 ピクセルのみ）:

黄色の折れ線グラフ: データポイントが X 軸に沿って非常に狭くなっていて、非常に読みにくい

300 個のデータポイント（1 データポイントあたり 1 ピクセル未満）:

黄色の折れ線グラフ: データポイントが X 軸に沿って非常に狭くなっていて、非常に読みにくい

トップへ戻る

系列の色 chco

chco パラメータを使用して、特定のシリーズまたはすべてのシリーズの色を指定できます。

構文

chco=
<color_1>, ... <color_n>
<color [色]>
RRGGBB 形式の 16 進数。単一の値を指定して、すべてのシリーズに同じ色を適用します。シリーズごとに異なる色を指定するには、色の値をカンマで区切って追加します。系列数よりも色数が少ない場合、未指定の系列では、指定された色が順番に循環されます。

 

例

説明 例

シリーズごとに単一の色を指定すると、各シリーズに色が割り当てられます。この例では、3 つのデータ系列と 3 つの色が指定されています。

1 本の赤、1 本の青、1 本の緑色の線がある折れ線グラフ

chco=FF0000,00FF00,0000FF

この例にも 3 つのデータ系列がありますが、2 つの色のみが指定されています。3 つ目のシリーズの色が指定されていないため、3 つ目の線は 1 つ目の色（赤）を使用して描画されます。

2 本の赤い線と 1 本の青い線が表示された折れ線グラフ

chco=FF0000,0000FF

トップへ戻る

複合グラフ

折れ線グラフに線、ローソク足、シェイプ マーカーを追加して複合グラフを作成できます。詳しくは、複合グラフをご覧ください。

標準の機能

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

グラフのタイトル chtt、chts [すべてのグラフ]

グラフのタイトルのテキスト、色、フォントサイズを指定できます。

構文

chtt=<chart_title>
chts=<color>,<font_size>,<opt_alignment>

 

chtt - グラフのタイトルを指定します。

<chart_titlechart_title>
グラフに表示するタイトル。表示位置を指定することはできませんが、必要に応じてフォントサイズと色を指定できます。スペースを示すには + 記号を、改行はパイプ文字（|）で表します。

 

chts（省略可）- chtt パラメータの色とフォントサイズ。

<color>
タイトルの色（RRGGBB の 16 進数形式）。デフォルトの色は黒です。
<font_size>
タイトルのフォントサイズ（ポイント単位）。
<opt_alignment>
（省略可）タイトルの配置。「l」（左）、「c」（中央）、「r」（右）の文字列値（大文字と小文字を区別）から 1 つを選択します。デフォルトは「c」です。

 

例

説明 例

デフォルトの色とフォントサイズを使用したタイトル付きのグラフ。

プラス記号（+）を使用してスペースを指定します。

改行を強制するには、パイプ文字（|）を使用します。

chts はここでは指定されません。

 タイトル付きの縦棒グラフ
chtt=Site+visitors+by+month|
January+to+July

20 ポイントの青色の右揃えのタイトルグラフ。

 青、20 ピクセル、タイトル付きの縦棒グラフ
chtt=Site+visitors
chts=FF0000,20,r

トップへ戻る

グラフの凡例のテキストとスタイル chdl、chdlp、chdls（すべてのグラフ）

凡例はチャートのサイド セクションで、各系列に関する簡単な説明が表示されます。この凡例の各系列に関連付けるテキストを指定し、グラフ上でそのテキストを表示する場所を指定できます。

凡例の周囲にマージンを設定する方法については、chma もご覧ください。

文字列値に関する注意: ラベルの文字列には URL セーフ文字のみを使用できます。安全のために、文字セット 0-9a-zA-Z にない文字を含む文字列はすべて URL エンコードする必要があります。URL エンコーダについては、Google の可視化に関するドキュメントをご覧ください。

構文

chdl=<data_series_1_label>|...|<data_series_n_label>
chdlp=<opt_position>|<opt_label_order>
chdls=<color>,<size>

 

chdl - 凡例に表示する各系列のテキスト。

<data_series_label>
凡例のエントリのテキスト。各ラベルは、chd 配列内の対応するシリーズに適用されます。スペースには + 記号を使用します。このパラメータを指定しない場合、グラフに凡例は表示されません。ラベル内の改行を指定する方法はありません。凡例は通常、凡例のテキストが保持されるように拡大され、グラフ領域は凡例に合わせて縮小されます。

chdlp - [省略可] 凡例の位置と凡例のエントリの順序。<position> と <label_order> のいずれかまたは両方を指定できます。両方を指定する場合は、バー文字で区切ります。凡例で chdl 内の空の凡例エントリをスキップする場合は、任意の値に「s」を追加できます。例: chdlp=bv、chdlp=r、chdlp=bv|r、chdlp=bvs|r

<opt_position>
（省略可）: グラフ上の凡例の位置を指定します。凡例とグラフ領域または画像の境界の間に追加のパディングを指定するには、chma パラメータを使用します。次のいずれかの値を選択します。
  • b - 凡例。グラフの下部に表示されます。凡例のエントリは横一列に並べられます。
  • bv - 凡例はグラフの下部に配置し、凡例のエントリは縦一列に並べます。
  • t - 凡例をグラフの一番上に配置し、凡例のエントリを横一列に並べます。
  • tv - 凡例をグラフの一番上に配置し、凡例のエントリを縦一列に並べます。
  • r - [デフォルト] 凡例はグラフの右側に、凡例のエントリは縦一列に並べられます。
  • l - 凡例をグラフの左側に配置し、凡例のエントリを縦一列に並べます。
<opt_label_order>
（省略可）凡例に表示されるラベルの順序。次のいずれかの値を選択します。
  • l - [縦長の凡例のデフォルト] chdl で指定された順序でラベルを表示します。
  • r - chdl と逆の順序でラベルを表示します。これは、積み上げ棒グラフで棒が表示されるのと同じ順序で凡例を表示する場合に便利です。
  • a - [水平凡例のデフォルト] 自動順序付け: おおよそ、10 ピクセル ブロックで測定して、長さの短い順に並べ替えます。2 つの要素が同じ長さ（10 ピクセル ブロックに分割）の場合、リストにある要素が最初に表示されます。
  • 0,1,2... - カスタムラベルの順序。これは、chdl のゼロベースのラベル インデックスをカンマで区切ったリストです。

chdls - （省略可）: 凡例のテキストの色とフォントサイズを指定します。

<color>
凡例のテキストの色（RRGGBB の 16 進数形式）。
<size>
凡例テキストのポイントサイズ。

 

例

説明 例

凡例の 2 つの例。凡例のテキストはデータ系列と同じ順序で指定します。

対応する凡例が表示された赤、青、緑の折れ線グラフ

chdl=NASDAQ|FTSE100|DOW
chco=FF0000,00FF00,0000FF

2 つの小さな円を大きな円で囲んだベン図


chdl=First|Second|Third
chco=ff0000,00ff00,0000ff

1 つ目のグラフは横方向の凡例エントリ（chdlp=t、デフォルト レイアウトは横方向）を示し、2 つ目のグラフは下部の縦方向の凡例エントリ（chdlp=bv）を示しています。

2 つの小さな円を大きな円で囲んだベン図
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=t

2 つの小さな円を大きな円で囲んだベン図
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=bv
この例では、フォントサイズを変更する方法を示します。

2 つの小さな円を大きな円で囲んだベン図
chdls=0000CC,14

トップへ戻る

グラフのマージン chma [すべてのグラフ]

グラフの余白のサイズをピクセル単位で指定できます。マージンは、指定されたグラフサイズ（chs）から内側に計算されます。マージンサイズを大きくしても、グラフの合計サイズは拡大せず、必要に応じてグラフ領域を縮小します。

デフォルトでは、グラフサイズが計算された後の余白が余白になります。このデフォルト値は、グラフの種類によって異なります。指定する余白は最小値です。グラフ領域に余白がある場合は、余白のサイズがそのまま適用されます。凡例やラベルに必要な余白よりも小さくすることはできません。次の図は、グラフの基本部分を示しています。

グラフのマージン、凡例領域、グラフ領域

グラフのマージンには、軸ラベルと凡例領域が含まれます。凡例の領域は、テキストがぴったり収まるように自動的にサイズ変更されます。ただし、chma を使用して幅を大きくした場合、余白が大きくなり、グラフ領域が小さくなります。小さすぎるサイズを指定して凡例を切り抜くことはできませんが、必要以上にスペースを占有することはできます。

ヒント: 棒グラフでは、棒のサイズが固定されている場合（デフォルト）、グラフ領域の幅を減らすことはできません。chbh を使用して、より小さい、またはサイズ変更可能なバーのサイズを指定する必要があります。

 

構文

chma=
  <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
<left_margin>、<right_margin>、<top_margin>、<bottom_margin>
グラフ領域の周囲の最小マージンサイズ（ピクセル単位）。軸ラベルがグラフの境界と重ならないように、この値を大きくしてパディングを追加します。
<opt_legend_width>、<opt_legend_height>
（省略可）凡例の周囲のマージンの幅（ピクセル単位）。 これを使用して、凡例がグラフ領域や画像の端に接触しないようにします。

 

例

説明 例

この例では、グラフの各辺の最小余白は 30 ピクセルです。グラフの凡例の幅が 30 ピクセルを超えているため、右側のマージンはグラフの凡例の幅に設定され、他のマージンとは異なります。

軸ラベルはプロット領域の外側にあるため、マージン空間内に描画されます。

背景がグレーで、両側にマージンがある折れ線グラフ。
chma=30,30,30,30

凡例の周囲にマージンを追加するには、<opt_legend_width> パラメータと <opt_legend_height> パラメータの値を設定します。

この例では、凡例の幅は約 60 ピクセルです。<opt_legend_width> を 80 ピクセルに設定した場合、余白は凡例の外の 20 ピクセルまで拡張されます。

背景がグレーで、両側にマージンがある折れ線グラフ。
chma=20,20,20,30|80,20

トップへ戻る

軸のスタイルとラベル [線、棒、Google メーター、レーダー、散布図]

グラフに表示する軸を指定し、カスタムラベル、位置、範囲、スタイルを設定できます。

デフォルトでは、すべてのグラフに軸線が表示されるわけではありません。chxt パラメータを使用して、グラフに表示する軸を正確に指定できます。デフォルトの軸の線には数値は表示されません。数値を表示するには、chxt パラメータで軸を指定する必要があります。

データ値を反映した数値を軸に表示することも、カスタム軸を指定することもできます。デフォルトでは、0 ～ 100 の範囲にスケーリングされた数値が表示されます。ただし、chxr を使用して範囲を変更し、任意の範囲を表示できます。また、chxs を使用して値のスタイルを設定できます（通貨記号や小数点以下の桁数など）。

カスタム値（「Mon, Tues, Wed」など）を使用する場合は、chxl パラメータを使用できます。これらのラベルを軸の特定の位置に配置するには、chxp パラメータを使用します。

最後に、chxs パラメータと chxtc パラメータを使用して、カスタム軸ラベルと数値軸ラベルの両方について、色、サイズ、配置などのプロパティを指定できます。

文字列値に関する注意: ラベルの文字列には URL セーフ文字のみを使用できます。安全のために、文字セット 0-9a-zA-Z にない文字を含む文字列はすべて URL エンコードする必要があります。URL エンコーダについては、Google の可視化に関するドキュメントをご覧ください。

このセクションでは、次のトピックについて説明します。

軸の表示 chxt

棒グラフ、折れ線グラフ、レーダー チャート、散布図には、デフォルトで 1 本または 2 本の軸線が表示されますが、これらの線に値は含まれません。軸線に値を表示する、または表示する軸を変更するには、chxt パラメータを使用する必要があります。デフォルトでは、chxr プロパティを使用して明示的にスケーリングしない限り、軸の値の範囲は 0 ～ 100 です。折れ線グラフのすべての軸線を非表示にするには、cht パラメータのグラフタイプの値の後に :nda を指定します（例: cht=lc:nda）。

デフォルトでは、上下の軸には値の目盛りが表示されず、左右の軸には目盛りが表示されます。この動作を変更するには、chxs パラメータを使用します。

構文

chxt=
  <axis_1>
    ,...,
  <axis_n>
<axis>
グラフに表示する軸。使用できる軸は次のとおりです。
  • x - 下の X 軸
  • t - 上部の X 軸 [Google-o-Meter ではサポートされていません]
  • y - 左 Y 軸
  • r - 右 Y 軸 [Google-o-Meter ではサポートされていません]

同じタイプの複数の軸を指定できます（例: cht=x,x,y）。これにより、グラフの下部に沿って 2 組の X 軸が積み重ねられます。これは、数値を示す軸に沿ってカスタムラベルを追加する場合に便利です（以下の例を参照）。軸は内側から外側に描画されるため、x,x とすると、最初の x は最も内側のコピーを参照し、次の x は次の外側コピーを参照するというように続きます。

 

例

説明 例

この例は、X 軸、Y 軸、上軸（t）、右軸（r）を持つ折れ線グラフを示しています。

ラベルが指定されていないため、グラフではすべての軸でデフォルトで 0 ～ 100 の範囲に設定されます。

デフォルトでは、上下の軸にはラベルの目盛りは表示されません。

左右に 0、20、40、60、80、100 のラベルと、上下に 0、25、50、75、100 のラベルがある折れ線グラフ
chxt=x,y,r,t
同じ値を複数回指定することで、各軸に複数のラベルセットを含めることができます。この例では、2 組の x と 2 組の Y 軸が示されています。ここに示すように、デフォルトの軸ラベルのみを使用する場合、これは特に有用ではありません。ただし、chxl パラメータを使用すると、各軸のコピーごとにカスタムラベルを指定できます。

<img <code="" dir="ltr" src="/static/chart/image/images/chart_41.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chs=200x1" />5"t=xy,x1"

<img <code="" dir="7 "x-H = 0,000,000,000,000

この例では、X 軸、Y 軸、上 T 軸、右の R 軸がある横棒グラフを示しています。

軸ラベルは省略されているため、Chart API では X 軸と T 軸に 0 ～ 100 の範囲が表示されます。

Y 軸と R 軸の範囲はバーの数で決まります。この例では、5 本の棒があるので、Chart API によって 0 ～ 4 の範囲が表示されます。最初のラベルは最初の棒の底部に中央揃えされ、2 番目のラベルは 2 番目の棒の底部に中央揃えされます。

左右に 0、20、40、60、80、100 のラベルと、上下に 0、25、50、75、100 のラベルがある折れ線グラフ
chxt=x,y,r,t
折れ線グラフのデフォルトの軸を非表示にするには、グラフの種類の後に :nda を指定します。 軸が非表示の折れ線グラフ
cht=lc:nda

トップへ戻る

軸の範囲 chxr

chxr パラメータを使用すると、各軸に表示される値の範囲を個別に指定できます。この操作によって変更されるのは、グラフ要素のスケールではなく 、軸ラベルのスケールのみです。軸番号が実際のデータ値を表すようにするには、<start_val> と <end_val> をそれぞれデータ形式の範囲の最小値と最大値に設定します。詳しくは、軸のスケーリングをご覧ください。

軸の範囲を指定する場合は、chxt パラメータを使用して軸を表示させる必要があります。

カスタム軸の値を指定するには、chxl パラメータを使用します。

構文

複数の軸ラベルの範囲は、パイプ文字（|）を使用して区切ります。

chxr=
  <axis_index>,<start_val>,<end_val>,<opt_step>
    |...|
  <axis_index>,<start_val>,<end_val>,<opt_step>
<軸番号>
ラベルを適用する軸。chxt で指定された軸配列に対するゼロベースのインデックスです。たとえば chxt=x,r,y では R 軸は 1 になります。
<start_val>
この軸の下限を定義する数値。
<end_val>
この軸の最大値を定義する数値。
<opt_step>
（省略可）: 軸の目盛りの歩数をカウントします。デフォルトのステップ値はありません。ステップは、間隔を空けた一連のラベルを表示するように計算されます。

 

例

説明 例

この例では、左右の Y 軸（y、r）と 1 つの X 軸（x）を示しています。

各軸には定義された範囲があります。ラベルや位置が指定されていないため、値は指定された範囲から取得され、その範囲内で均等に配置されます。折れ線グラフでは、値は X 軸に沿って均等に分散されます。

最初の値（1000）が最後の値（0）よりも大きいため、R 軸（インデックス 2）に対して軸の方向が逆になります。


chxt=x,y,r
chxr=
  0,0,500|
  1,0,200|
  2,1000,0

この例では、X 軸に値が指定されています。

軸ラベルは、軸に沿って均等に配置されます。<opt_step> パラメータには値 5（5）が指定されています。

X 軸に 200、300、400 を示す棒グラフ chxt=x
chxr=0,10,50,5

トップへ戻る

カスタムの軸ラベルchxl

chxl パラメータを使用して、任意の軸にカスタム文字列の軸ラベルを指定できます。ラベルはいくつでも指定できます。chxt パラメータを使用して軸を表示し、カスタムラベルを指定しない場合、標準の数値ラベルが適用されます。カスタムの数値範囲を指定するには、代わりに chxr パラメータを使用します。

ラベルの軸に沿った特定の位置を設定するには、chxp パラメータを使用します。

構文

ラベルを付ける軸ごとに 1 つのパラメータ セットを指定します。パイプ文字（|）を使用して、複数のラベルセットを区切ります。

chxl=
  <axis_index>:|<label_1>|...|<label_n>
    |...|
  <axis_index>:|<label_1>|...|<label_n>
<軸番号>
ラベルを適用する軸。これは、chxt パラメータ配列に対するインデックスです。たとえば、chxt=x,x,y,y の場合、インデックス 0 が最初の X 軸、1 が 2 番目の X 軸になります。
<ラベル 1>| ... |<ラベル_n>
この軸に沿って配置する 1 つ以上のラベル。値には文字列または数値を指定できます。文字列を引用符で囲む必要はありません。label_1 は軸の最下部に、label_n は最上部に表示されます。追加のラベルは等間隔に配置されます。スペースには + 記号を付けます。ラベル内の改行を指定する方法はありません。ラベルはパイプ文字で区切ります。注: chxl パラメータの最後のラベルの後にパイプを配置しないでください。

 

例

説明 例

このグラフは、2 つの軸にカスタムラベルを追加する方法を示しています。値が均等に配置され、最後の chxl 値がパイプで終わっていないことに注目してください。

 左側に 0 と 100、右側に A、B、C、X 軸に Jan、7 月、1 月、7 月、1 月、下に 2005、2006、2007 がある折れ線グラフ
chxt=x,y
chxl=
0:|Jan|Feb|March|April|May|
1:|Min|Mid|Max

この例では、左右の Y 軸（y と r）に軸ラベル（y と r）があります。また、X 軸（x）の 2 セットの値も含まれています。chxs を使用して、Y 軸に目盛りを追加することもできます。

左側に 0 と 100、右側に A、B、C、X 軸に Jan、7 月、1 月、7 月、1 月、下に 2005、2006、2007 がある折れ線グラフ
chxt=x,y,r,x
chxl=
0:|Jan|July|Jan|July|Jan|
1:|0|50|100|
2:|A|B|C|
3:|2005|2006|2007

この例では、左右の Y 軸（y と r）に軸ラベルがあり、X 軸の 2 セットの値（x）も含まれています。下の X 軸のセットには、値の間隔を空けるために空のラベルが使用されています。

この例では、左側の Y 軸の軸ラベルにデフォルト値を使用します。

左に 0 と 100、右に A、B、C、X 軸に Jan、7 月、1 月、7 月、1 月、下が 2005、2006、2007 年の棒グラフ
chxt=x,y,r,x
chxl=
0:|Jan|July|Jan|July|Jan|
2:|A|B|C|
3:|2005||2006||2007

汎用のラベルを追加して軸全体を説明する場合（たとえば、ある軸に「費用」と別の「生徒」というラベルを付ける場合は、chxt プロパティを使用してそれぞれの側に軸を追加し、chxl を使用してそれぞれの側に 1 つのカスタムラベルを追加し、chxp を使用して軸の中央での間隔を設定します。
chxt=x,x,y,y
chxl=1:|Martinis|3:|Score
chxp=1,50|3,50

トップへ戻る

軸ラベルの位置 chxp

表示する軸ラベルを指定できます。デフォルトのラベルを使用することも、chxl を使用して指定したカスタムラベルを使用することもできます。このパラメータで正確な位置を指定しない場合、ラベルは軸に沿って均等に、デフォルトのステップ値で配置されます。chxl を指定しない場合、目盛りのラベルはデフォルト値（通常はデータ値、または棒グラフの棒番号）になります。

構文

複数のポジショニング セットは、パイプ文字（|）を使用して区切ります。

chxp=
  <axis_1_index>,<label_1_position>,...,<label_n_position>
    |...|
  <axis_m_index>,<label_1_position>,...,<label_n_position>
<軸番号>
位置を指定する軸。これは、chxt パラメータ配列に対するインデックスです。たとえば、chxt=x,x,y,y の場合、インデックス 0 が最初の X 軸、1 が 2 番目の X 軸、というように続きます。
<label_1_position>,...,<label_n_position>
: 軸に沿ったラベルの位置。これは数値のカンマ区切りリストです。各値は chxl 配列内の対応するラベルの位置を設定します。最初のエントリが最初のラベルに適用されるというように続きます。位置は、その軸の範囲内の値です。chxr を使用してカスタム範囲を指定しない限り、これは常に 0 ～ 100 になります。その軸のラベルと同じ数の位置を指定する必要があります。

 

例

説明 例

この例では、グラフ上の指定された位置に R 軸のラベルが含まれています。ラベルのテキストは、chxl パラメータを使用して指定します。

位置が 0 のラベルは、Y 軸または R 軸の下部、または X 軸または T 軸の左側に配置されます。

位置が 100 のラベルは、Y 軸または R 軸の上部、または X 軸または T 軸の右側に配置されます。

Line chart with min, average, and max on the right, 20, 40, 60, 80, and 100 on the left, and 0, 25, 50, 75, and 100 along the x-axis
chxt=x,y,r
chxl=2:|min|average|max
chxp=2,10,35,75

この例では、デフォルトのラベル値を示していますが、指定した位置にのみ表示されます。

chxp=1,10,35,75 - Y 軸には 10、35、75 の 3 つのラベルのみを表示します。カスタムラベル テキストが指定されていないため、これらの軸の値が表示されます。chxp を使用する場合は、ラベルを均等に間隔を空ける必要はありません。ここで chxp が指定されていない場合、2 番目のグラフに示すように、y 軸のデフォルトのラベル値の距離は 20 単位ごとになります。

 Line chart with 10, 35, and 75 on the left, and 0, 25, 50, 75, and 100 along the x-axis
chxt=x,y
chxp=1,10,35,75
デフォルトの軸の位置を示す折れ線グラフ。
chxt=x,y
chxp が指定されていません

トップへ戻る

軸ラベルのスタイル chxs

軸ラベルには、カスタムラベルとデフォルトのラベル値の両方に、フォントサイズ、色、配置を指定できます。同じ軸上のラベルはすべて同じ形式になります。軸のコピーが複数ある場合は、それぞれを異なる形式にできます。通貨記号や末尾のゼロの表示など、ラベル文字列の形式を指定することもできます。

デフォルトでは、上下の軸には値の目盛りが表示されず、左右の軸には目盛りが表示されます。

構文

複数の軸の値は、パイプ文字（|）で区切る必要があります。

chxs=
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
   |...|
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
<軸インデックスaxis_index>
これが適用される軸。これは、chxt パラメータに対するゼロベースのインデックスです。
<opt_format_stringopt_format_string>
（省略可）これは省略可能な形式文字列です。使用する場合は、軸のインデックス番号の直後に指定します。カンマを間に入れません。リテラル文字 N で始まり、その後に次の値が続きます。 フォーマット文字列の構文は次のとおりです。
       N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
各要素の意味は次のとおりです。
  • <preceding_text> - 各値の前にあるリテラル テキスト。
  • *...* - リテラル アスタリスクで囲まれたオプションのブロック。ここで数値の書式設定の詳細を指定できます。次の値を使用できます（すべて省略可能）。
    • <number_type> - 数値の形式。次のいずれかを選択します。
      • f - [デフォルト] 浮動小数点形式。<decimal_places> 値でも精度を指定することを検討してください。
      • p - 割合の形式。% 記号が自動的に付加されます。注: この形式を使用する場合、0.0 ～ 1.0 のデータ値は 0 ～ 100% にマッピングされます（たとえば、0.43 は 43% と表示されます）。
      • e - 科学的記数の形式。
      • c<CUR> - 適切な通貨マーカーを使用して、指定された通貨で数値を書式設定します。<CUR> は、3 文字の通貨コードに置き換えます。例: ユーロの場合は cEUR。コードのリストは ISO のウェブサイトで確認できますが、すべての記号がサポートされているわけではありません。
    • <decimal_places> - 表示する小数点以下の桁数を指定する整数。値はこの長さに丸められます（切り捨てられない）。デフォルトは 2 です。
    • z - 末尾のゼロを表示します。デフォルトは no です。
    • s - グループ セパレータを表示します。デフォルトは no です。
    • x または y - 指定された x 座標または y 座標のデータを表示します。x データの意味はグラフの種類によって異なります。グラフを試して、その意味を判断します。デフォルトは「y」です。
  • <following_text> - 各値に続くリテラル テキスト。
<opt_label_color>
軸のテキスト（軸線ではない）に適用する色。RRGGBB の 16 進形式で指定します。軸の線の色は、opt_axis_color を使用して別途指定します。デフォルトはグレーです。
<opt_font_size>
（省略可）: フォントサイズをピクセル単位で指定します。このパラメータは省略可能です。
<opt_alignment>
（省略可）: ラベルの配置。上下の軸の場合は、その上下の目盛りにラベルを合わせる方法を示し、左右の軸の場合は、境界ボックス内で軸に接触する位置揃えを示します。次のいずれかの数値を指定します。
  • -1 - 上または下: ラベルは目盛りの右側に配置されます。左または右: ラベルは領域内で左揃えに配置されます。R 軸のラベルのデフォルト。
  • 0 - 上または下: ラベルは目盛りの中央に配置されます。左または右: ラベルは領域内で中央に配置されます。X 軸と T 軸のラベルのデフォルト。
  • 1 - 上または下: ラベルは目盛りの左側にあります。左または右: ラベルは領域内で右揃えになります。Y 軸のラベルのデフォルトです。
<opt_axis_or_tick>
[省略可。Google メーターでサポートされていません] この軸の目盛りや軸線を表示するかどうかを指定します。目盛りと軸線は最も内側の軸でのみ使用できます（たとえば、2 つの X 軸のうち外側の軸ではサポートされていません）。次のいずれかの値を使用します。
  • l（小文字の「L」） - 軸線のみを描画します。
  • t - 目盛りのみを描画します。目盛りは軸ラベルの横にある小さな線です。
  • lt - [デフォルト] すべてのラベルについて、軸線と目盛りの両方を描画します。
  • _ - （アンダースコア）軸線も目盛りも描画しません。軸線を非表示にする場合は、この値を使用します。
<tick_color>
[省略可。Google メーターでサポートされていません] 目盛りの色（RRGGBB の 16 進数形式）。デフォルトはグレーです。
<opt_axis_color>
（省略可）この軸線の色。RRGGBB の 16 進数形式で指定します。デフォルトはグレーです。

 

例

説明 例

2 番目の X 軸（1 月、2 月、3 月）のフォントサイズと色が指定されています。

左側に最小値、平均値、最大値、右側に 0、1、2、3、4、X 軸が 0 ～ 100、下に青字が 1 月、2 月、3 月の折れ線グラフ

chxt=x,y,r,x
chxr=2,0,4
chxl=3:|Jan|Feb|Mar|
     1:|min|average|max
chxp=1,10,35,75
chxs=3,0000DD,13,0,t

右側の Y 軸のフォントサイズ、色、配置が指定されています。目盛りは描画されますが、軸線は描画されません。

X 軸に 0 ～ 100、下に Jan、2 月、Mar、Y 軸に 0 ～ 4 の赤い目盛りと、右側に min、average、max を示す青色のテキストがある折れ線グラフ。

chxt=x,y,r,x
chxl=3:|Jan|Feb|Mar|
     2:|min|average|max
chxp=2,10,35,95
chxs=2,0000DD,13,-1,t,FF0000

このグラフには 3 つのデータセットがあり、系列ごとに 1 つずつ、3 セットの軸ラベルが表示されています。ラベルの各セットは、カスタム書式設定文字列を使用して書式設定されます。

  • 0N*e,000000|
    • 0 は最初のデータ系列を意味します
    • N はフォーマット文字列を意味します。
    • * は、形式指定子の開始を意味します。
    • e は指数表記を意味します
    • * は形式指定子の終わりを意味します
    • 000000 は黒いテキストを意味します。
  • 1N*cUSD*Mil,FF0000|
    • 1 は 2 つ目のシリーズを意味します
    • N はフォーマット文字列を意味します。
    • * は、形式指定子の開始を意味します。
    • c は通貨マーカーを意味します
    • USD は、使用する通貨マーカーとして米ドルを指定します。
    • * は、形式指定子の終了を意味します。
    • Mil は文字列に続くリテラルです。
    • FF0000 は赤色のテキストを意味します。
  • 2N*sz2*,0000FF
    • 2 は 3 番目のシリーズを意味します
    • N はフォーマット文字列を意味します。
    • * は形式指定子の開始を意味します
    • s は、グループ化指定子を表示することを意味します（米国英語の言語 / 地域では、ゼロ 3 つごとのカンマ）。
    • z2 は、末尾に 2 個のゼロを表示することを意味します。
    • 0000FF は青色のテキストを意味します。

軸ラベルの範囲は、chxr パラメータ（axis_index、axis_index、axis_index、axis_index）を使用して設定します。設定しない場合、デフォルトで 0 ～ 100 になります。
chd=s:
  984sttvuvkQIBLKNCAIi,
  DEJPgq0uov17zwopQODS,
  AFLPTXaflptx159gsDrn
chxr=
  0,0,1000000,250000|
  1,0,60|
  2,0,5000
chxs=
  0N*e,000000|
  1N*cUSD*Mil,FF0000|
  2N*sz2*,0000FF

トップへ戻る

軸の目盛りのスタイル chxtc

特定の軸に対して長い目盛りを指定できます。通常、これはグラフの長さ全体に目盛りを延長するために使用されます。目盛りの色を変更するには、chxs パラメータを使用します。

複数の軸の値は、パイプ文字（|）を使用して区切ります。系列内の値はカンマで区切る必要があります。

構文

chxtc=
  <axis_index_1>,<tick_length_1>,...,<tick_length_n>
    |...|
  <axis_index_m>,<tick_length_1>,...,<tick_length_n>
<軸インデックスaxis_index>
これが適用される軸。これは、chxt パラメータに対するゼロベースのインデックスです。複数の軸の値は、バー区切り文字を使用して区切ります。
<tick_length_1>,...,<tick_length_n>
軸上の目盛りの長さ（ピクセル単位）。単一の値を指定すると、その値がすべての値に適用されます。複数の値が指定されている場合、軸の目盛りは、その軸の値のリストの中で順繰りに表示します。正の値はグラフ領域の外側に描画され、グラフの枠線で切り抜かれます。正の最大値は 25 です。負の値はグラフ領域内に描画され、グラフ領域の枠線で切り抜かれます。

 

例

説明 例

chxtc を使用して長い赤い目盛りを作成する例この目盛りの長さはグラフ領域の幅を超えていますが、グラフ内に収まるように切り抜かれます。

  • chxt=x,y,r,x - 左軸、右軸、下軸 2 本を表示します。
  • chxl=2:|min|average|max|3:|Jan|Feb|Mar - 「r」（右側）と外側の X 軸に割り当てられたラベルテキスト。
  • chxp=2,10,35,95 - 3 つのラベルの R 軸（index=2）に沿ったカスタムラベル位置。
  • chxs=2,0000dd,13,-1,t,FF0000 - R 軸の軸ラベルのスタイル。テキストの色、テキストサイズ、左揃え、赤い目盛り付き。
  • chxtc=1,10|2,-180 - Y 軸と R 軸の軸目盛りの長さ。 最初の値は、軸の外側の 10 ピクセル長の目盛りを指定します。2 つ目の値は、軸の内側にある 180 ピクセルの長さの目盛りを指定します。負の数値は、目盛りが軸の内側にあり、グラフ内に収まるように切り抜かれることを意味します。

X 軸に 0 ～ 100、下に Jan、2 月、3 月、Y 軸に 0 ～ 4 の長い赤い目盛りと、右側に min、average、max を示す青いテキストがある折れ線グラフ。

chxt=x,y,r,x
chxl=
  2:|min|average|max|
  3:|Jan|Feb|Mar
chxp=2,10,35,95
chxs=
  2,0000dd,13,-1,t,FF0000
chxtc=1,10|2,-180
このグラフは、目盛りの長さを交互に示しています。chxtc は、y 軸の 2 つの目盛りの長さ値（5 と 15）を指定します。グラフに描画される目盛りはその 2 つの値を交互に表示します。
chxt=x,y
chxtc=
  1,5,15

トップへ戻る

背景塗りつぶし chf [すべてのグラフ]

グラフのデータ領域やグラフの背景全体の塗りつぶしの色とスタイルを指定できます。塗りつぶしタイプには、単色塗りつぶし、ストライプ塗りつぶし、グラデーションがあります。 領域ごとに異なる塗りつぶしを指定できます（たとえば、グラフ領域全体やデータ領域のみなど）。グラフ領域の塗りつぶしは、背景の塗りつぶしを上書きします。すべての塗りつぶしは chf パラメータを使用して指定します。パイプ文字（|）で値を区切ることで、同じグラフ内にさまざまな塗りつぶしタイプ（単色、ストライプ、グラデーション）を混在させることができます。グラフ領域の塗りつぶしは、グラフの背景の塗りつぶしを上書きします。

ソリッド塗りつぶし chf [すべてのグラフ]

背景やグラフ領域の単色塗りつぶしを指定するか、グラフ全体に透明度値を割り当てることができます。パイプ文字（|）を使用して複数の塗りつぶしを指定できます（マップ: 背景のみ）。

構文

chf=<fill_type>,s,<color>|...
<fill_typefill_type>
グラフの塗りつぶし部分。次のいずれかの値を指定します。
  • bg - 背景塗りつぶし
  • c - グラフ領域の塗りつぶし。マップグラフではサポートされていません。
  • a - グラフ全体（背景を含む）を透明にします。<color> の最初の 6 桁は無視され、最後の 2 桁（透明度の値）のみがグラフ全体とすべての塗りつぶしに適用されます。
  • b<index> - 棒無地塗りつぶし（棒グラフのみ）。<index> をバーのシリーズ インデックスに置き換えて、単色で塗りつぶします。これは、棒グラフで chco を指定する場合と同様です。例については、棒グラフの系列の色をご覧ください。
s
塗りつぶし（塗りつぶし）を指定します。
<color>
塗りつぶしの色（RRGGBB の 16 進数形式）。透明性を確保するため、最初の 6 桁は無視されますが、含めて含めてください。

 

例

説明 例

この例では、グラフの背景が淡いグレー（EFEFEF）で塗りつぶされます。

黒い領域が塗りつぶされた赤い折れ線グラフ

chf=bg,s,EFEFEF

この例では、グラフの背景を淡いグレー（EFEFEF）で塗りつぶし、グラフ領域を黒（000000）で塗りつぶします。

グラフの領域が黒で背景が薄いグレーの赤い折れ線グラフ

chf=c,s,000000|
bg,s,EFEFEF
この例では、グラフ全体に 50% の透明度を適用します（16 進数の 80 は 128、つまり約 50% の透明度です）。グラフの上にテーブルセルの背景が表示されます。

透明度 50% の点が青い散布図。

chf=a,s,00000080

トップへ戻る

グラデーション塗りつぶし chf [線、棒、Google メーター、レーダー、散布図、ベン]

グラフ領域や背景に、1 つ以上のグラデーション塗りつぶしを適用できます。グラデーション塗りつぶしは、ある色から別の色にフェードします。（円グラフ、Google メーターグラフ: 背景のみ）。

グラデーションの塗りつぶしごとに角度を指定し、指定された位置に固定された 2 つ以上の色を指定します。アンカーから別のアンカーに移動すると、色が変化します。一方がもう一方にフェードインできるように、異なる <color_centerpoint> 値を持つ色が少なくとも 2 つ必要です。追加のグラデーションはそれぞれ <color>、<color_centerpoint> のペアで指定されます。

構文

chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1>
    ,...,
  <color_n>,<color_centerpoint_n>
<fill_typefill_type>
塗りつぶしするグラフ領域。次のいずれかです。
  • bg - 背景塗りつぶし
  • c - グラフ領域の塗りつぶし。
  • b<index> - 棒グラデーションの塗りつぶし（棒グラフのみ）。<index> は、グラデーションで塗りつぶすバーのシリーズ インデックスに置き換えます。例については、棒グラフの系列の色をご覧ください。
lg
グラデーション塗りつぶしを指定します。
<angle>
グラデーションの角度を 0（水平）～ 90（垂直）の範囲で指定する数値。
<color>
塗りつぶしの色（RRGGBB の 16 進数形式）。
<color_centerpoint>
色のアンカー ポイントを指定します。別のアンカーに近づくにつれて、この地点から色が徐々に消えていきます。値の範囲は 0.0（下端または左端）～ 1.0（上端または右端）で、<angle> で指定された角度で傾けられます。

 

例

説明 例

グラフ領域には水平の線形グラデーションがあり、角度 0 度（0）で指定されます。

色は桃色（FFE7C6）で、左側が中央（位置 0.0）、右側が青（76A4FB）です（位置 1.0）。

グラフの背景はグレー（EFEFEF）で描画されます。

薄いグレーの背景とグラフ領域が左から右に白から青の線形グラデーションで描かれたダークグレーの折れ線グラフ

chf=
  c,lg,0,
  FFE7C6,0,（ピーチ）
  76A4FB,1（青）

グラフ領域には、45 度（45）の角度で指定された対角線（左下から右上）の線形グラデーションがあります。

最初に指定された色は桃色（FFE7C6）です。グラフの左下は純粋な桃色です。

青（6A4FB）は 2 番目に指定されている色です。グラフの右上は純粋な青色です。オフセットを 0.75 に指定して、右上隅に向かってフェードアウトする青色のピークを指定している点に注目してください。

グラフの背景はグレー（EFEFEF）で描画されます。

暗いグレーの折れ線グラフ。背景が淡いグレーで、グラフ領域が左下から右上に向けて白から青の対角線の線形グラデーションになっています

chf=
  c,lg,45,
  FFE7C6,0, （ピーチ）
  76A4FB,0.75（青）

グラフ領域には、90 度（90）の角度で指定される垂直（上から下）の線形グラデーションがあります。

最初に指定された色は青（76A4FB）です。グラフの上部は純粋な青色です。

2 番目に指定されている色は桃色（FFE7C6）です。グラフの下部は純粋な桃色です。

グラフの背景はグレー（EFEFEF）で描画されます。

薄いグレーの背景とグラフ領域が下から上に白から青の垂直線形グラデーションで描かれたダークグレーの折れ線グラフ

chf=
  c,lg,90,
  FFE7C6,0, （ピーチ）
  76A4FB,0.5（青）

トップへ戻る

 

ストライプ塗りつぶし chf [折れ線、棒、Google メーター、レーダー、散布図、ベン]

グラフ領域またはグラフ全体に、ストライプの背景塗りつぶしを指定できます。（円グラフ、Google メーターグラフ: 背景のみ）。

構文

chf=
  <fill_type>,ls,<angle>,<color_1>,<width_1>
    ,...,
  <color_n>,<width_n>
<fill_typefill_type>
塗りつぶしするグラフ領域。次のいずれかです。
  • bg - 背景塗りつぶし
  • c - グラフ領域の塗りつぶし
  • b<index> - 棒ストライプ塗りつぶし（棒グラフのみ）。<index> は、ストライプで塗りつぶすバーのシリーズ インデックスに置き換えます。例については、棒グラフの系列の色をご覧ください。
ls
線形ストライプ塗りつぶしを指定します。
<angle>
すべてのストライプの角度（Y 軸を基準とする相対角度）。縦方向のストライプには 0、横方向のストライプには 90 を使用します。
<color>
このストライプの色。RRGGBB の 16 進形式で指定します。ストライプごとに <color> と <width> を繰り返します。ストライプが少なくとも 2 つ必要です。グラフが塗りつぶされるまでストライプが交互に表示されます。
<width>
このストライプの幅（0～1）。1 はグラフ全体の幅です。ストライプは、グラフが塗りつぶされるまで繰り返されます。ストライプごとに <color> と <width> を繰り返します。ストライプが少なくとも 2 つ必要です。グラフが塗りつぶされるまでストライプが交互に表示されます。

 

例

説明 例
  • bg,ls,0 - 背景のストライプ塗りつぶしは、y 軸に対して 0 度の角度（y 軸と平行）にストライプを配置します。ストライプはグラフの背景とプロット領域全体を埋めます。
  • CCCCCC,0.15 - 最初のストライプはダークグレーで、幅はチャートの 15% です。
  • FFFFFF,0.1 - 2 つ目のストライプは白で、幅はチャートの 10% です。
 左から右にグレーと白のストライプが交互に描かれた青い折れ線グラフ
chf=
  bg,ls,0,
  CCCCCC,0.15,
  FFFFFF,0.1
  • c,ls,90 - y 軸から 90 度の角度に水平ストライプを配置したグラフ領域。ストライプはプロット領域全体に表示されますが、グラフの背景は省略されます。
  • 999999,0.25 - 最初のストライプはダークグレーで、幅はチャートの 25% です。
  • CCCCCC,0.25 - 1 つ目のストライプと同じですが、薄い灰色です。
  • FFFFFF,0.25 - 1 つ目のストライプと同じですが、白です。
 下から上に濃いグレー、淡いグレー、白、濃いグレーのストライプが描かれた青い折れ線グラフ
chf=
  c,ls,90,
  999999,0.25,
  CCCCCC,0.25,
  FFFFFF,0.25

トップへ戻る

グリッド線 chg [線、棒、レーダー、散布図]

chg パラメータを使用して、グラフに実線または点線のグリッド線を指定できます。

このパラメータでは、線の太さや色を指定することはできません。グラフ全体に線を引くその他の方法については、シェイプ マーカー（chm で h、H、V、V をタイプする）や、範囲マーカー（chm）、軸の目盛り（chxtc）をご覧ください。

構文

chg=
  <x_axis_step_size>,<y_axis_step_size>,<opt_dash_length>,<opt_space_length>,<opt_x_offset>,<opt_y_offset>
<x_axis_step_size>、<x_axis_step_size>
グラフに表示する X または Y のグリッド線の数を計算するために使用します。100 / step_size = グラフ上のグリッド線の数したがって、20,25 は垂直グリッド線 5 本と水平グリッド線 4 本を意味します。
<opt_dash_length>、<opt_space_length>
（省略可）: 破線のグリッド線を定義するために使用します。最初のパラメータは、各線の破線の長さ（ピクセル単位）です。2 つ目のパラメータは、ダッシュの間隔（ピクセル単位）です。実線の場合、<opt_space_length> に 0 を指定します。デフォルト値は 4、1 です。
<opt_x_offset>,<opt_y_offset>
（省略可）x グリッド線と y グリッド線をオフセットする、グラフのスケールに応じた単位数。正または負の値を指定できます。この値を指定する場合は、先行する値もすべて指定する必要があります。デフォルト値は 0,0 です。

 

例

説明 例

これらの例では、<x_axis_step_size> パラメータと <y_axis_step_size> パラメータのみを使用しています。デフォルトでは、Chart API により破線のグリッド線が表示されます。

 薄いグレーの垂直の 5 本のグリッド線と 2 本の水平のグリッド線からなる折れ線グラフ
chg=20,50
薄いグレーの垂直の 5 本のグリッド線と 2 本の水平のグリッド線からなる折れ線グラフ
chg=20,50

この例では、大きなスペースを使用して、より明るいグリッド線（1,5）を表示しています。

 薄いグレーの薄いグレーの破線の 5 本の垂直線と 2 本の水平線のグリッド線を含む折れ線グラフ
chg=20,50,1,5

実線のグリッド線を表示するには、<opt_space_length> パラメータにゼロ（0）を指定します。

また、このグラフでは X 軸のオフセットを 10 に指定しています。

 薄いグレーの実線のグリッド線が 5 本、水平が 2 本ある折れ線グラフ
chg=20,50,1,0,10

このグラフは、X 軸のオフセットが 10、Y 軸のオフセットが 20 を示しています。

 薄いグレーの実線のグリッド線が 5 本、水平が 2 本ある折れ線グラフ
chg=20,50,3,3,10,20

トップへ戻る

線のスタイル chls [線、レーダー]

chls パラメータでは、線の太さと実線/破線のスタイルを指定できます。このパラメータは、折れ線グラフまたはレーダー チャートの線のスタイルの設定にのみ使用できます。複合グラフの基本タイプが折れ線グラフでない限り、複合グラフ線の線のスタイルの設定には使用できません。

構文

複数の線のスタイルはパイプ文字（|）で区切ります。最初のスタイルは最初の線に適用され、2 番目のスタイルは次の線に適用されます（以下同様）。スタイルが線より少ない場合、未指定のすべての線にデフォルトのスタイルが適用されます。

chls=
  <line_1_thickness>,<opt_dash_length>,<opt_space_length>
    |...|
  <line_n_thickness>,<opt_dash_length>,<opt_space_length>
<line_1_thickness>
線の太さ（ピクセル単位）。
<opt_dash_length>、<opt_space_length>
（省略可）: 破線のグリッド線を定義するために使用します。最初のパラメータは、各線の破線の長さ（ピクセル単位）です。2 つ目のパラメータは、ダッシュの間隔（ピクセル単位）です。実線の場合は、どちらの値も指定しません。<opt_dash_length> のみを指定すると、<opt_space_length> は <opt_dash_length> に設定されます。デフォルトは 1,0（実線）です。

 

例

説明 例

破線は 3,6,3 で指定し、太い実線は 5 で指定しています。

 1 本の実線と 1 本の破線で示された折れ線グラフ
chls=3,6,3|5

トップへ戻る

ダイナミック アイコン マーカー chem [棒、線、レーダー、散布図]

グラフを作成し、1 つ以上の動的アイコンを chem 値として指定します。chem の構文は次のとおりです。セミコロンで区切られた紫色の項目はすべて省略可能で、URL 内でその項目を完全に省略できます。複数のマーカーを指定する場合は、「|」文字で区切って複数の構文文字列を指定します。動的アイコンの詳細については、動的アイコンのページをご覧ください。

また、グラフを動的なアイコンとして別のグラフに埋め込むこともできます。以下の埋め込みグラフのサブセクションをご覧ください。

chem=
  y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
   |...|
  y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
s=<アイコンの文字列定数icon_string_constant>
動的アイコンのページにある動的アイコンの文字列マーカー定数。この定数は、独立型アイコンの chst パラメータとほぼ同じです。ただし、独立型アイコン文字列が「d_」で始まる場合は、同等の動的アイコン マーカーを取得するためにこの接頭辞を削除する必要があります。例: 独立型アイコン: d_bubble_icon_text_small、同等の動的アイコン マーカー: bubble_icon_text_small
d=<マーカーデータの文字列marker_data_string>
このマーカー タイプに必要なデータ。この文字列は、同等の独立アイコンの chld パラメータで使用されるものと同じ文字列を保持します。ただし、 すべての区切り文字はカンマに置き換える必要があります（複数行のテキストにはパイプ マーカーの代わりにカンマを使用することに注意してください）。データ文字列内では、パイプ（|）、アットマーク（@）、イコール（=）、カンマ（,）、セミコロン（;）（例: hello@,+world、5@@10+cents+each）。
ds=<which_series>
（省略可）: このマーカーが属するデータ系列のゼロベースのインデックス。デフォルト値は 0 です。
dp=<which_points>
（省略可）: マーカーの描画に使用するデータポイントを指定します。デフォルト値は 0（シリーズの最初の点）です。次のいずれかの形式で指定してください。
  • n.d - マーカーを描画するデータポイント。n.d は系列内のゼロベースのインデックスです。整数以外の値を指定した場合、小数は計算された中間点を示します。たとえば、3.5 はポイント 3 とポイント 4 の中間を意味します。
  • range,<start>,<end>,<step> - start から end までの範囲（両端を含む）のすべての step データポイントにマーカーを描画します。start と end はインデックス値で、中間値を示す浮動小数点数にすることもできます。値はすべて省略可能で、デフォルトは start=0、end=last item、step=1 です。値をスキップする場合も中間のカンマを含める必要がありますが、末尾の空のカンマを含める必要はありません。例: dp=range,0,4 は、要素 0 ～ 4 にマーカーを描画します。dp=range,5,10,2 は、要素 5、7、9 にマーカーを描画します。dp=range,2 は、3 番目の点以降にポイントを描画します。dp=range,3,,1.5 は、4 番目のアイテムから最後のアイテムまで 1.5 データポイントごとにマーカーを描画します。
  • all - すべての要素にマーカーを描画します。これは range,0,end_index と同じです。例: dp=all
  • every,n - n 番目のマーカーごとにマーカーを描画します。例: dp=every,2 は、アイテム 0、2、4 にマーカーを描画します。
py=<z_order>
（省略可）マーカーを描画するレイヤ（他のマーカーおよび他のすべてのグラフ要素との比較）。これは -1.0 から 1.0 までの浮動小数点数です。-1.0 は底、1.0 は上です。グラフ要素（線と棒）はゼロのすぐ下に表示されます。2 つのマーカーが同じ値を持つ場合、URL で指定された順序で描画されます。デフォルト値は 0.0（グラフ要素のすぐ上）です。
po=<x,y>
（省略可）マーカーを描画するグラフ上の絶対位置。x と y は 2 つの浮動小数点数で、0.0,0.0 は左下隅、1.0,1.0 は右上隅です。
of=<x_offset,y_offset>
（省略可）アイコンを通常の位置からオフセットするピクセル数。x_offset と y_offset は、正または負の整数です。埋め込みダイナミック アイコンではこの値を指定することが重要です。マーカーはポイントの垂直方向および水平方向の中央に配置されます。つまり、ポイントはデータマーカーと位置が合わない可能性があります。直立したピンの適切なオフセットは of=0,22 です。傾斜したピンの適切なオフセットは、傾斜の方向に応じて of=-12,20 または of=12,20 ですが、テストが必要になる場合があります。デフォルト値は 0,0 です。

 

例

説明 例
同じダイナミック アイコンを独立した画像として作成し、折れ線グラフでマーカーとして使用する例を次に示します。

グラフ 1: https://chart.googleapis.com/chart?chs=300x140&cht=lc&chco=FF9900,224499&
chd=t:75,74,66,30,10,5,3,1&chls=1|1&
chem=y;s=bubble_icon_text_small;d=ski,bb,Wheeee!,FFFFFF;dp=2;ds=0&chm=v,ccccFF,0,::.2,2

グラフ 2: https://chart.googleapis.com/chart?chst=d_bubble_icon_text_small&chld=ski|bb|Wheeee!|FFFFFF|000000

動的アイコン マーカーを使用した折れ線グラフ
chem=
  y;s=bubble_icon_text_small;d=ski,bb,Wheeee!,FFFFFF;dp=2;ds=0

単独の画像と同じ動的アイコン マーカーです。


chst=
  d_bubble_icon_text_small
chld=
  ski|bb|Wheeee!|FFFFFF|000000

動的アイコン マーカーは、ポイントを水平方向と垂直方向に中央揃えで配置します。そのため、テールがある動的アイコンを使用する場合、テールはグラフ ポイント上ではなく、マーカーの中心に配置されます。 最初のグラフでは、データポイント 3 をマークの中心にして、テールが線上のマークの少し右側に配置されています。

2 つ目のグラフでは、of 値を使用して、マーカーのテールを目的のデータポイントの上に移動しています。傾斜したピンの適切なオフセットは -12,20 です。
chem=y;
  s=map_xpin_letter;
  d=pin_sleft,A,FF0000;
  dp=3;
  ds=1

chem=y;
  s=map_xpin_letter;
  d=pin_sleft,A,FF0000;
  dp=3;
  ds=1;
  of=-12,0

複数の動的アイコンを含めるには、| 文字で区切って構文文字列を繰り返します。

この例では、範囲と 2 つの個別のマーカーを示しています。

垂直方向のピンのオフセットは 0,22 で、傾斜したピンのオフセットは 12,20 です。これにより、ピンのポイントと対象の系列が揃います。
chem=
  y;s=map_xpin_letter;d=pin_sright,A,FF0000;dp=4;ds=0;py=1;of=12,20|
  y;s=map_pin_icon;d=baby,FF5555;ds=1;dp=6;of=0,22|
  y;s=map_pin_icon;d=camping,DEF763;ds=2;dp=range,2,5
これは複数行のテキスト マーカーを示しています。マーカーはテキストを追加した後にオフセットする必要があります。これは、バブルがテキストに合わせてサイズ変更され、グラフの中心が再表示されるためです。テキスト内の改行は、d データ文字列ではカンマによってどのように示されるかに注意してください。
chem=y;
  s=bubble_texts_big;
  d=bbbr,FFC6A5,000000,Outlier,Forgot+to+feed;
  ds=0;
  dp=13;
  of=-120,2

埋め込みグラフ

動的アイコンの構文を使用すると、グラフを別のグラフの中に埋め込むことができます。

埋め込みグラフのマーカーには、バブル内の埋め込みグラフと、バブルなしの埋め込みグラフの 2 つのスタイルがあります。以下に例を示します。

バブルなしのグラフ
グラフとバブル
バブルなしのグラフ

バブル以外のグラフと埋め込みグラフの両方について、s=<icon_string_constant>;d=<marker_data_string> パラメータの詳細を以下に示します（上記のパラメータはここでは説明しません）。

構文

Non-bubble:
  chem=y;s=ec;d=<alignment_string>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset>

Bubble:
  chem=y;s=ecb;d=<frame_type>,<padding>,<frame_color>,<fill_color>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset>
alignment_string
[バブル以外の場合] バブルなしの埋め込みグラフのどの部分がデータポイントに固定されるか。次の図の 2 文字の文字列定数のいずれかを選択します。アライメント文字列
chart_data
埋め込みグラフのデータ。埋め込むグラフの URL の https://chart.googleapis.com/chart? より後のすべての部分です。以下のツールを使用するか、ツールの下のルールに従ってください。
frame_type
[バブルのみ] ダイナミック アイコンのフレーム スタイル定数のいずれか。
パディング
[バブルのみ] バブル内のパディング（ピクセル単位）。
frame_color
[バブルのみ] フレームの色。6 桁の HTML カラー文字列で、# 記号は付けません。例: FF00FF
fill_color
[バブルのみ] バブルの塗りつぶしの色。# 記号なしの 6 桁の HTML カラー文字列で指定します。例: FF00FF

埋め込みグラフデータ

次の変換ツールを使用して、グラフの文字列を生成するか、ツールの後に指定したルールに従って、グラフの文字列を手動で生成します。

手動変換のルール

1. まず、パラメータと値のペアの次の文字をすべて次の値に置き換えます。

次のように置き換えます。 こちらの
%7C または %7c
|
@
@@
%
%25
,
@,
|
@|
;
@;
&
%26
=
%3D

2. 次に、parameter1=value1&parameter2=value2... ペアのすべての & 値と = 値をカンマに置き換えます。

トップへ戻る

線塗りつぶし chm [線、レーダー]

データ線の下の領域を単色で塗りつぶすことができます。

パイプ文字（|）を使って chm パラメータを区切ることで、線塗りつぶしを他の chm パラメータと組み合わせることができます。

構文

chm=
  <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0>
    |...|
  <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0>
<b_or_B>
グラフの一番下まで塗りつぶすか、下の線だけまで塗りつぶすかを指定します。
  • B - <start_line_index> からグラフの下部まで塗りつぶします。<end_line_index> は、グラフのセグメントを塗りつぶすための特別な構文をサポートしています。塗りつぶししたい線が 1 本のグラフの場合、この方法が最も簡単です。
  • b - 複数折れ線グラフで 2 本の線の間に塗りつぶします。開始線と終了線は <start_line_index> と <end_line_index> で示されます。
<color>
塗りつぶしの色を表す RRGGBB 形式の 16 進数。
<start_line_indexstart_line_index>
塗りつぶしを開始する線のインデックス。chd で指定された最初のデータ系列にはゼロ（0）のインデックス、2 番目のデータ系列には 1 というインデックスが付きます。
<end_line_indexend_line_index>
  • 塗りつぶしタイプ「b」 - 塗りつぶしを終了する線。この行は、現在の行より下である必要があります。
  • 入力タイプ 「B」 - 次のいずれかを選択します。
    • 任意の値 - このパラメータ内の数値は無視され、指定した線からグラフの底辺まで塗りつぶされます。
    • start:end - グラフの下の垂直スライスを塗りつぶすには、start:end を指定します。これは、塗りつぶしの開始位置と終了位置を示すデータポイント インデックスです。どちらの値もオプションで、デフォルトは first_point:last_point です。（下記の例をご覧ください）。
<0>
予約済み - ゼロにする必要があります。

 

例

説明 例

シリーズが 1 つの場合は、chm=B を使用するのが最も簡単です。これにより、線の下の領域全体が塗りつぶされます。

レーダー チャートで使用できる塗りつぶしエリアのタイプは、これだけです。chm=b はレーダー チャートでは動作しません。


chm=B,76A4FB,0,0,0

2 つの線と 2 つの塗りつぶしがあるグラフを以下に示します。最下線より下の領域と一番上の線より上の領域を塗りつぶすには、特別な手法が必要です。これについては、次に説明します。


chd=s:
cefhjkqwrlgYcfgc,
QSSVXXdkfZUMRTUQ,
HJJMOOUbVPKDHKLH,

chm=
b,224499,0,1,0|（青）
b,FF0000,1,2,0|（赤）

複数系列グラフでグラフの上部から最初の線までを塗りつぶすには、そのデータ形式の最大データ値の 2 つのコピーを含む系列を含めます。たとえば、拡張エンコードの場合は「....」、基本的なテキスト形式の場合は「100,100」などです。この系列から一番上の線まで塗りつぶします。

最後の線からグラフの下部までを塗りつぶすには、そのデータ形式の最小データ値の 2 つのコピーを含む系列を含めます。たとえば、拡張エンコードの場合は AAAA、基本テキスト形式の場合は 0,0 などです。

線自体は、chco を使用して黒で描画されます。

 グラフ上の 3 本の線。グラフは下から 1 本目の線まで緑色、1 本目から 2 本目の線まで赤色、2 本目の線から 3 本目の線まで濃い青色、3 本目の線から上まで薄い青色で表示されている
chd=e:
  ....,（最大値）
  cefhjkqwrlgYcfgc,
  QSSVXXdkfZUMRTUQ,
  HJJMOOUbVPKDHKLH,
  AAAA（ゼロ値）
chm=
  b,76A4FB,0,1,0|（水色）
  b,224499,1,2,0|（青）
  b,FF0000,2,3,0|（赤）
  b,80C65A,3,4,0（緑）
chco=000000

これは、垂直方向の塗りつぶしスライスを使用した折れ線グラフです。そのためには、<end_line_index> に線塗りつぶしタイプ「B」の start:end ペアを指定します。

  • B,76A4FB,0,0:3,0 - 線 0 の下線を青く垂直に塗りつぶし、データポイント 0 ～ 3 を範囲とします。
  • B,990000,0,7:10,0 - 線 0 の下を赤色の垂直塗りつぶしで、データポイント 7 ～ 10 で囲まれます。
  • B,DEDC06,0,12:,0 - 線 0 の下、データポイント 12 から系列の終わりまで、黄色の垂直塗りつぶしを行います。
chm=
  B,76A4FB,0,0:3,0|
  B,990000,0,7:10,0|
  B,DEDC06,0,12:,0

レーダー チャートで折れ線の塗りつぶしを使用する例を次に示します。

 レーダー チャート
chm=
  B,FF000080,0,1.0,5.0|
  B,FF990080,1,1.0,5.0

トップへ戻る

シェイプ マーカー 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 番目に描画されるため、円の上に描画されます。

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

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

 2 点ごとにマーカーを表示した折れ線グラフ
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-2,6
次の折れ線グラフでは、マーカーの数がデータポイントの 2 倍になっています（-0.5 は半点ごとを意味します）。 2 点ごとにマーカーを表示した折れ線グラフ
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-.5,6
この例では、h マーカーと v マーカーを使用して、カスタムの色と太さのグリッド線を作成する方法を示します。Z オーダーの値（最後の値）を -1 に設定して、グリッド線がデータ線の下に描画されるようにします。
2 点ごとにマーカーを表示した折れ線グラフ
chm=
  h,76A4FB,0,0:1:.2,2,-1|
  V,76A4FB,0,::2,0.5,-1

次のグラフは、折れ線グラフに垂直方向の塗りつぶし線を追加します。

  • v - グラフの垂直線
  • FF0000 - 赤い線
  • 0 - シリーズ インデックス
  • : :.5 - 範囲指定子: 開始から終了まで、0.5 ポイントごと。
  • 2 - 太さ 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 [棒、折れ線、レーダー、散布図]

グラフ上の特定のポイントに、カスタム テキスト、またはその時点でのデータの書式設定バージョンを使用してラベルを付けることができます。

パイプ文字（|）を使って chm マーカーを組み合わせると、chm パラメータ セットを区切ることができます。

文字列値に関する注意: ラベルの文字列には URL セーフ文字のみを使用できます。安全のために、文字セット 0-9a-zA-Z にない文字を含む文字列はすべて URL エンコードする必要があります。URL エンコーダについては、Google の可視化に関するドキュメントをご覧ください。

構文

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

chm=
  <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
    |...|
  <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
<marker_type>
使用するマーカーのタイプ。以下のタイプから選択できます。
  • f<text> - テキストを含むフラグ。文字「f」に続けてカスタムの URL エンコード テキストを指定します。テキスト マーカーのカンマをエスケープするには、カンマの前に \ 記号を付けます。例: fHello\,+World!
  • t<text> - 単純なテキスト マーカー。文字「t」に続けてカスタム URL エンコード テキストを指定します。テキスト マーカーのカンマをエスケープするには、カンマの前に \ 記号を付けます。例: tHello\,+World!
  • A<text> - アノテーション マーカー。これは旗のマーカーに似ていますが、マーカーが重ならないように位置を調整します。<opt_which_points> は opt_which_points のみが有効で、系列内の点のインデックスを指定します。
  • N<formatting_string> - この時点でのデータの値。オプションで書式設定が可能です。chds パラメータを使用しない場合（カスタム スケーリング）は、エンコードされた正確な値が提供されます。任意のフォーマット タイプでそのパラメータを使用すると、値は指定した範囲にスケーリングされます。数値マーカー付きの chds の例を以下に示します。このマーカータイプを積み上げ棒グラフで使用する場合、<series_index> に -1 を指定すると、この積み上げ棒グラフのすべての値の合計を示すマーカーが表示されます。書式設定文字列の構文は次のとおりです。
           <preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>.
    これらの要素はすべて省略可能です。各要素の意味は次のとおりです。
    • <preceding_text> - 各値の前にあるテキスト。
    • *...* - リテラル アスタリスクで囲まれたオプションのブロック。ここで数値の書式設定の詳細を指定できます。次の値を使用できます（すべて省略可能）。
      • <number_type> - 数値の形式。次のいずれかを選択します。
        • f - [デフォルト] 浮動小数点形式。<decimal_places> 値でも精度を指定することを検討してください。
        • p - 割合の形式。% 記号が自動的に付加されます。注: この形式を使用する場合、0.0 ～ 1.0 のデータ値は 0 ～ 100% にマッピングされます（たとえば、0.43 は 43% と表示されます）。
        • e - 科学的記数の形式。
        • c<CUR> - 適切な通貨マーカーを使用して、指定された通貨で数値を書式設定します。<CUR> は、3 文字の通貨コードに置き換えます。例: ユーロの場合は cEUR。コードのリストは ISO のウェブサイトで確認できますが、すべての記号がサポートされているわけではありません。
      • <decimal_places> - 表示する小数点以下の桁数を指定する整数。値はこの長さに丸められます（切り捨てられない）。デフォルトは 2 です。
      • z - 末尾のゼロを表示します。デフォルトは no です。
      • s - グループ セパレータを表示します。デフォルトは no です。
      • x または y - 指定された x 座標または y 座標のデータを表示します。x データの意味はグラフの種類によって異なります。グラフを試して、その意味を判断します。デフォルトは「y」です。
    • <following_text> - 各値に続くテキスト。
<color>
: このセットのマーカーの色（RRGGBB の 16 進数形式）。
<series_indexseries_index>
: マーカーを描画するデータ シリーズのインデックス（ゼロベース）です。これが積み上げ棒グラフで、マーカーの種類が N（データポイント値）の場合、-1 を指定すると、棒の積み重ねごとに合計値のマーカーを作成できます。以下の例をご覧ください。
<opt_which_points>
（省略可）: マーカーを描画するポイント。デフォルトはすべてのマーカーです。次のいずれかの値を使用します。
  • n.d - マーカーを描画するデータポイント。n.d は系列内のゼロベースのインデックスです。整数以外の値を指定した場合、小数は計算された中間点を示します。たとえば、3.5 はポイント 3 とポイント 4 の中間を意味します。
  • -1 - すべてのデータポイントにマーカーを描画します。このパラメータを空のままにして、すべてのデータポイントの上に描画することもできます。
  • -n - n 番目のデータポイントごとにマーカーを描画します。
  • start:end:n - start から end までのインデックス値（両端を含む）内の n 番目のデータポイントごとにマーカーを描画します。すべてのパラメータは省略可能です（存在しない場合もあります）。3::1 は、ステップ 1 の 4 番目の要素から最後までの要素です。このパラメータを完全に省略すると、デフォルトの first:last:1 になります。すべての値に浮動小数点数を指定できます。start と end は負の値にし、最後の値から後方にカウントします。start と end の両方が負の値の場合は、大きい方の値で列挙します（例: -6:-1:1）。n ステップの値が 1 未満の場合、与えられたデータ値を補間して追加のデータポイントを計算します。デフォルト値は first:last:1 です
  • x:y - [N 型のマーカーには対応していません] グラフ上の特定の x/y ポイントにマーカーを描画します。この点は直線上にある必要はありません。このオプションを使用するには、マーカータイプの前にアットマーク（@）を追加します。座標を浮動小数点値として指定します。0:0 はグラフの左下隅、0.5:0.5 はグラフの中心、1:1 はグラフの右上隅です。たとえば、15 ピクセルの赤いひし形をグラフの中央に追加するには、@d,FF0000,0,0.5:0.5,15 を使用します。
<size>
: マーカーのサイズ（ピクセル単位）。3 つ目のデータ系列（ポイントサイズの指定に使用）を含む散布図の場合、この値はデータ範囲によってスケーリングされます。たとえば、データ範囲が 0 ～ 100、<size> が 30 の場合、データ値 100 は幅 30 ピクセル、データ値 50 は幅 15 ピクセルになります。
<opt_z_order>
（省略可）: マーカーを描画するレイヤ（他のマーカーおよび他のすべてのグラフ要素との比較）。これは -1.0 から 1.0 までの浮動小数点数です。-1.0 は底、1.0 は上です。グラフ要素（折れ線と棒）は 0 よりも小さいほどです。2 つのマーカーが同じ値を持つ場合、URL で指定された順序で描画されます。デフォルト値は 0.0（グラフ要素のすぐ上）です。
<opt_placement>
（省略可）データポイントを基準として、このマーカーを配置する場所を示す追加のプレースメントの詳細。水平または垂直の相対位置とオフセットを指定できます。プレースメント構文は、次に示すように、「:」区切り文字を使用した文字列です。すべての要素は省略可能です（<horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>）。指定すると、<opt_z_order> の chm パラメータ文字列に空の値を含めることができます（例: N,000000,0,1,10,,b、N,000000,0,1,10,,lv、N,000000,0,1,10,,r::10）。
horizontal_and_vertical_justification
マーカーのアンカー ポイント。これは両端揃えとは逆に動作するため、左アンカーの場合、実際にはマーカーがデータポイントの右に配置されます。次のリストから、水平方向や垂直方向の位置揃えを選択できます。
  • 横配置: 「l」、「h」、「r」 - 横方向の左揃え、中央揃え、右固定。デフォルトは「l」です。
  • 縦方向の配置: 「b」、「v」、「t」 - 縦方向の下部、中央、上部に固定。デフォルトは「b」です。
  • 棒に連動したプレースメント [棒グラフのみ]: s、c、e - 棒の底部、中央、上部。積み上げグラフの場合、棒全体ではなく、各系列の棒のセクションからの相対値です。指定された系列インデックスが -1（スタック合計）の場合は、棒全体に対する比率になります。縦方向の配置値（「be」や「vs」など）と組み合わせて使用できます。デフォルト値は「e」です。
horizontal_offset
このマーカーの水平オフセット（ピクセル単位）。デフォルトは 0 です。
vertical_offset
このマーカーの垂直オフセット（ピクセル単位）。棒グラフ以外のデフォルトは 15、棒グラフのデフォルト: 2。

説明 例

こちらは、棒グラフでの値のラベルの例です。

最初のグラフ（N*p0*）では、データ値マーカーが指定されています。値は、すべての値に対して 11 ポイントのテキストで、値は小数点以下 0 桁に丸められたパーセンテージで表示されます。データ値はすべて 0.0 ～ 1.0 であり、パーセント形式では小数点以下 2 桁上に移動します。

2 番目のグラフ（N*cEUR1*）では、すべての値にユーロ値としてフォーマットされた同じ値（小数点 1 桁を黒で、11 ポイントのテキスト）が表示されています。

各棒の上に割合のラベルが表示された棒グラフ
chm=
  N*p0*,000000,0,-1,11
chd=t:
  0.4356,0.3562,0.4834,0.575,0.673,0.6091

各棒の上にユーロのラベルが付いた棒グラフ


chm=
  N*cEUR1*,000000,0,-1,11

chds パラメータを使用して、表示される数値をスケーリングできます。chds は、シンプル エンコードと拡張エンコードを含む、すべてのデータ形式に使用できます。これは、棒のサイズや軸ラベルには影響せず、データ マーカーの値にのみ影響します。

この例は、シンプル エンコードされた値が 46、39、29、30、43、41 のグラフを示しています。単純なエンコード範囲は 0 ～ 61 です。chds パラメータは 0 ～ 1 のカスタム マーカー スケールを定義するため、マーカー値はこの範囲にスケーリングされますが、バーの高さには影響しません（これがテキスト形式のデータの場合、バーもスケーリングされます）。
chd=s:underp
chm=N,000000,0,-1,11
chds=0,1

最小値にテキストラベル、最大値にフラグラベルがあるグラフの例を次に示します。

10 pt の青いテキストラベルと 15 pt の赤いテキストが指定された折れ線グラフが、緑色の破線のデータポイントに描画されます。
chm=
  tMin,0000FF,0,1,10|
  fMax,FF0000,0,3,15
この例は、個々の系列の値と系列の合計値を含む積み上げグラフです。積み上げ系列の値を表示するには、「c」配置オプションを使用する必要があります。そうしないと、上部のバーの値が各バーの上部にある合計値と重なってしまいます。
chm=
  N,FF0000,-1,,12|
  N,000000,0,,12,,c|
  N,000000,1,,12,,c|
  N,ffffff,2,,12,,c
縦方向と横方向の配置の仕組みを示すその他のデモこの例では、棒グラフのアンカー値（縦方向の配置に s、c、e を使用）のさまざまな組み合わせを示しています。右側のアンカーを動かすとマーカーが左に動き、上部のアンカーでマーカーが下に移動します。その逆も同様です。赤い点は、各バーのベース、中央、上部を示しています。 数値はデータの値で、棒ごとに異なるアンカー値で固定されています。
chm=
  N,000000,0,0,10,,rs
  N,000000,0,1,10,,ls
  N,000000,0,2,10,,c
  N,000000,0,3,10,,e
  N,000000,0,4,10,,e::15
  N,000000,0,5,10,,e::-12
アノテーション マーカーでは、ラベルの位置が重ならないように自動的に調整されます。最初の chm 値は線の塗りつぶし用で、次の値はすべてアノテーション マーカーです。
chm=B,C5D4B5BB,0,0,0
  AA,666666,0,3,15
  AB,666666,0,5,15
  AC,666666,0,24,15
  AD,666666,0,25,15
  AE,666666,0,26,15
  AF,666666,0,51,15
  AG,666666,0,60,15
  AH,666666,0,73,15
  AI,666666,0,80,15
  AJ,666666,0,99,15
スイスの都市の標高を示す別のアノテーション マーカーの例。

トップへ戻る

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

水平または垂直方向の背景の帯に色を付けて、グラフの特定の領域を目立たせることができます。

パイプ文字（|）を使って chm マーカーを組み合わせると、chm パラメータ セットを区切ることができます。

構文

描画する帯域ごとに、次のパラメータ セットのいずれかを指定します。複数の帯域を描画するには、追加のパラメータ セットをパイプ文字で区切って作成します。範囲は指定された順序で描画されるため、最後に描画された範囲は前の範囲の上に描画されます。

chm=
  <direction>,<color>,0,<start_point>,<end_point>
    |...|
  <direction>,<color>,0,<start_point>,<end_point>
<direction>
水平または垂直のシェーディングを指定します。水平範囲には r、垂直範囲には R を使用します。
<color>
範囲の色。RRGGBB 形式の 16 進数で指定します。
0
予約済み - ゼロにする必要があります。
<start_point>
範囲の開始位置。
  • 水平範囲マーカーの場合、これは Y 軸上の位置です。0.00 はグラフの最下部、1.00 はグラフの上部です。
  • 垂直範囲マーカーの場合、これは X 軸上の位置です。0.00 はグラフの左側、1.00 はグラフの右側です。
<end_point>
範囲の終了位置。
  • 水平範囲マーカーの場合、これは Y 軸上の位置です。0.00 はグラフの最下部、1.00 はグラフの上部です。
  • 垂直範囲マーカーの場合、これは X 軸上の位置です。0.00 はグラフの左側、1.00 はグラフの右側です。

 

例

説明 例

範囲マーカーには、細い線または色の帯を使用できます。

  • r,E5ECF9,0,0.75,0.25 - 範囲マーカー、薄い青色、（予約済み）、グラフの高さの 0.5。
  • r,000000,0,0.1,0.11 - 黒の範囲マーカー（予約済み）。Y 軸の 0.1 から始まり、0.11 のところで終わります（細い黒い線）。
 Y 軸の 25% から 75% まで伸びている薄い青色の横帯と、Y 軸の 10% の細い水平線がある折れ線グラフ
chm=
  r,E5ECF9,0,0.75,0.25|
  r,000000,0,0.1,0.11

この例は、垂直範囲マーカーを示しています。1 つ目のマーカーは赤い線（FF0000）、2 つ目のマーカーは薄い青色のバンド（A0BAE9）です。

 X 軸に沿って 25 ～ 75% の領域で薄い青色の縦帯と、X 軸に沿って 10% の細い縦線が描かれた折れ線グラフ
chm=
  R,FF0000,0,0.1,0.11|
  R,A0BAE9,0,0.75,0.25

マーカーは指定された順序で描画されます。この例では、縦型の赤いマーカーが、薄い青色の横方向マーカーの前に描画されていることがわかります。

 青色の縦帯と薄青色の横帯が、x 軸と y 軸に沿ってそれぞれ 25%～ 75% の範囲で伸びている折れ線グラフ。X 軸と Y 軸に沿ってそれぞれ 10% の位置に、赤い細い縦線と黒色の細い横線
chm=
  R,FF0000,0,0.1,0.11|
  R,A0BAE9,0,0.75,0.25|
  r,E5ECF9,0,0.75,0.25|
  r,000000,0,0.1,0.11

範囲マーカーを使用してグラフ上の基準線、中点線、上部に薄い水平線を描画する折れ線グラフの例を次に示します。

 黄色の線が 1 本と等間隔の 3 本の水平線があるスパークライン
chm=
  r,000000,0,0.499,0.501|
  r,000000,0,0.998,1.0|
  r,000000,0,0.0,0.002

トップへ戻る

ローソク足マーカー 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> パラメータは空白で、すべてのデータポイントにローソク足が描画されます。

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|
  ...

トップへ戻る

線マーカー 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

トップへ戻る

データ関数 chfd [すべての chd グラフ]

muParser 関数の構文を使用して、グラフデータに対して実行するカスタム関数を指定できます。関数で使用されるデータは、次の 2 つのソースのいずれかから取得されます。

  • chd のデータ系列 - データは chd で指定された系列から取得されます。
  • chfd パラメータ自体で宣言された値の範囲 - 任意のデータ範囲の開始、停止、ステップの値を宣言します。

いずれの場合も、chd の既存のシリーズに出力を割り当てる必要があることに注意してください。このシリーズは、関数の出力によって上書きされます。グラフは、すべての関数が処理された後にのみレンダリングされます。そのため、出力に複数の関数を同じデータ系列に割り当てると、関数は指定された順序で実行されますが、グラフには最終的な関数の出力のみがプロットされます。関数を連鎖させることで、前の関数で出力された一連のデータを 1 つの関数で入力として受け取ることができます。

色または chm マーカーを関数行に割り当てるには、色またはマーカーを関数のシリーズ インデックスに割り当てます。マーカーは、関数でデータを操作した後、そのデータに応じて配置されます。

構文

chfd=
  <output_series_index>,<function_data>,<function_string>
    |...|
  <output_series_index>,<function_data>,<function_string>
<output_series_indexoutput_series_index>
関数の出力が書き込まれる chd 内のデータ系列のゼロベースのインデックス。既存のデータは、関数の出力によって完全に上書きされます。シリーズが関数の入力として使用されない場合は、そのシリーズに単一のダミー値を割り当てることをおすすめします。
<function_data>
プロットする変数とデータ。データは、定義した範囲または chd データ系列のいずれかから取得されます。関数ごとに複数の変数を指定できます。複数の変数を指定する場合は、区切り文字として ;（セミコロン）を使用します。1 つの関数に複数の変数を定義し、これらの変数のポイント数が異なる場合、関数は最初のエンドポイントに到達すると停止します。たとえば、関数が x=1 ～ 5 ステップ 1 と y=1 ～ 10 ステップ 1 の両方を定義している場合、関数は 5 番目の点に達すると終了します。
    <variable_name>,<input_series_index>
         または
    <variable_name>,<start>,<end>,<step>
  • variable_name - 変数の任意の文字列名。これは、function_string で定義されている関数で使用します。
  • input_series_index - 入力データとして使用する chd データシリーズのインデックス。
  • 開始 - 範囲の開始値（数値）。
  • 終了 - 範囲の終了数値です。
  • step - start から end までのステップの数値。正または負の値を指定できますが、ゼロにはできません。
例: x,0,100,1 は、値が 0、1、2、... 100 の x という名前の変数を宣言します。x,0,100,1;r,0,3.1,.1 は、同じ x 変数に加えて、値が 0、0.1、0.2、...、3.0、3.1 の r という名前の変数を宣言します。x,0 は、最初の chd シリーズのデータを使用する x という名前の変数を宣言します。これらの変数は function_string で使用されます。function_string で指定しない限り、グラフにプロットされません。 ステップが小さいほど、グラフは滑らかになります。
<関数文字列function_string>
muParser 構文で記述された関数。この関数は、variable_data で指定された変数とデータに適用されます。参照できるのは、このローカル関数セットで宣言された変数のみです。別のパイプ文字セットの chfd パラメータで参照することはできません。muParser 関数の概要（最小、最大合計、平均）はサポートされていません。重要: 関数では、+ ではなく %2B を使用してください。

 

例

説明 例

単純な正弦波。注意点:

  • chd=t:-1 - データは chfd パラメータで宣言されているため、グラフデータにはダミー変数を使用します。
  • chco=FF0000 - 最初のシリーズに赤を指定します。chd のデータを使用しなくても、この系列に対応する色がプロットされた関数に使用されます。
  • chfd=0,x,0,11,0.1,sin(x)*50%2B50 - x という 1 つの変数を宣言します。値は 0 ～ 11 で、0.1 ずつインクリメントされます。最初のシリーズに割り当てられます。つまり、最初のシリーズの色（FF0000）が設定されます。x に適用される関数は、sin(x) * 50 + 50 です。この関数内で + をエンコードする必要がある点に注意してください。

 

 chfd で指定された正弦波
cht=lc
chd=t:-1
chco=FF0000
chfd=
  0,x,0,11,0.1,sin(x)*50%2B50
chxt=x,y
この線は、chd パラメータのデータを使用しています。
chd=t:5,10
chfd=0,x,0,x*4

関数行と非関数行が混在している。

色が系列の色パラメータ chco によってどのように指定されているかに注目してください。

関数の出力では、マーカーの配置に注目してください。データポイントは start、end、step から計算されます。つまり、範囲が 0 ～ 11 ステップ 0.1 の場合、ポイント 0 は 0、ポイント 1 は 0.1、というようにポイント 110 までは 11 となり、その値は 11 になります。

 1 つは chfd を使用し、もう 1 つはデータに chd を使用するシリーズ。
chd=t:
  -1
  15,45
chco=
  FF0000,000000
chfd=
  0,x,0,11,0.1,sin(x)*50%2B50
chm=
  c,00A5C6,0,110,10
  a,00A5C6,0,60,10

2 つの次元で関数を定義するには、lxy グラフを使用し、2 つのダミー系列を割り当て、それぞれに関数を割り当てます。

  • 0,x,0,10,0.1,sin(x)*50%2B50 - 系列 0（x 軸の値）には、0 ～ 10 の値を持つ x という名前の変数、ステップ 0.1、関数 sin(x)*50 + 50 があります。
  • 0,y,0,10,0.1,sin(y)*50%2B50 - 系列 0（y 軸の値）には、0 ～ 10 の値を持つ y という名前の変数、ステップ 0.1、関数 sin(x)*50 + 50 があります。
 円
cht=lxy
chd=t:-1|-1
chfd=
  0,x,0,10,0.1,sin(x)*50%2B50|
  1,y,0,10,0.1,cos(y)*50%2B50

chfd パラメータを使うと、創造性を存分に発揮できます。

これらの画像をクリックして開き、チャート プレイグラウンドで遊んでみましょう。きっと夢中になります。

トップへ戻る