このドキュメントでは、Google メーターグラフと呼ばれるダイヤル型のグラフの作成方法について説明します。

目次

概要

Google メーターは、範囲内の単一の値を指すゲージです。範囲には、必要に応じて指定できるカラー グラデーションがあります。ポインタの上にカスタム テキストを指定することもできます。ダイヤル範囲は、データ形式の最小値から最大値までです。矢印が指すデータ値を chd パラメータに 1 つ指定します。

同じグラフ上に複数の矢印を指定して、矢印の本体とポイントのサイズをそれぞれ異なるスタイルに設定できます。すべての矢印に同じスタイルを適用する場合は、データポイントを同じシリーズの値として指定します。矢印ごとに異なるスタイルを適用する場合は、同じスタイルのすべての矢印を同じシリーズにグループ化します。

Google-O-Meter グラフは、次の構文で指定します。

構文

cht=gom

 

例

説明	例
chxl を使用して、ダイヤルの上と下にカスタムラベルを指定しています。	chxt=x,y chxl=0:|Groovy|1:|slow|faster|crazy
複数のデータポイントを持つ複数の矢印を指定できます。	chd=t:20,40,60 chdl=1|2|3
矢印にスタイルを適用するには、chls パラメータを使用します。chls の各説明は、対応するデータ系列のすべての矢印に適用されます。 chls には、Google メーター用の高度な構文があります。パイプ内の値の各セットは、対応するデータ系列を表しています。必要に応じて、矢印のサイズをポイント数（0 ～ 15）で示すパイプ区切り値のセットを追加できます（デフォルトは 15）。 このグラフの chls の値を調べてみましょう。chls=3|3,5,5|15|10 3 - 1 つの値で線の太さを指定します。これは、最初のシリーズのすべての矢印に適用されます。 3,5,5 - 2 つ目の系列には、太さ、点線の長さ、間隔の長さを記述します。 15 - 最初の一連の矢印の先端のサイズ。 10 - 2 つ目のシリーズの矢印の先端のサイズ。	chd=t:20,40|60 chls=3|3,5,5|15|10

 

系列の色 chco

必要に応じて、chco パラメータを使用してダイヤルの色を指定できます。指定しない場合は、デフォルトのグラデーションが使用されます。

構文

chco=<color_1>,...,<color_n>

<color>

2 つ以上の色を RRGGBB の 16 進形式で指定します。色は左から右のグラデーションで適用されます。最初の色が左、最後の色が右になります。

説明	例
このグラフは、白（FFFFFF）から黒（000000）への単純なグラデーションを示しています。	chco=FFFFFF,000000
このグラフでは、ダイヤルに複数の色が割り当てられています。	chco=FF0000,FF8040,FFFF00, 00FF00,00FFFF, 0000FF,800080

トップへ戻る

Google メーターのラベル chl

必要に応じて、矢印の上に表示するカスタムラベルを指定できます。

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

構文

chl=<label>

<ラベル>

ラベルのテキスト。

 

例

説明	例
ラベル付きの Google メーターの例を以下に示します。	chl=Nearly+There

トップへ戻る

標準の機能

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

トップへ戻る

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

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

構文

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

 

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

<チャートのタイトルchart_title>

グラフに表示するタイトル。このテキストが表示される場所は指定できませんが、フォントサイズと色は任意で指定できます。スペースは + 記号、改行の場合はパイプ文字（|）を使用します。

 

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

<color>

タイトルの色（RRGGBB の 16 進形式）。デフォルトの色は黒です。

<font_size>

タイトルのフォントサイズ（ポイント単位）。

<opt_alignment>

（省略可）: タイトルの配置。次のいずれかの文字列値（大文字と小文字を区別）を選択します。「l」（左）、「c」（中央）、「r」（右）デフォルトは "c" です。

 

例

説明	例
デフォルトの色とフォントサイズを使用したタイトル付きのグラフ。 プラス記号（+）を付けてスペースを指定します。 パイプ文字（|）を使用すると、強制的に改行されます。 ここでは chts を指定しません。	chtt=Site+visitors+by+month| January+to+July
青色の右揃えで 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_labeldata_series_label>

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

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

<opt_position>

（省略可）: グラフ上の凡例の位置を指定します。凡例とグラフ領域または画像の枠線との間に追加のパディングを指定するには、chma パラメータを使用します。 次のいずれかの値を選択します。

• b - グラフの下部にある凡例。凡例のエントリは 1 行に並んでいます。
• bv - グラフの下部に凡例があり、凡例のエントリは縦一列に並んでいます。
• t - グラフの上部にある凡例。凡例のエントリは 1 行に並んでいます。
• 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 chdl=First|Second|Third chco=ff0000,00ff00,0000ff
1 つ目のグラフは水平の凡例エントリ（chdlp=t、デフォルト レイアウトは水平）を示し、2 つ目のグラフは下部の垂直の凡例エントリ（chdlp=bv）を示しています。	chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=t chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=bv
この例は、フォントサイズを変更する方法を示しています。	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 を使用して値のスタイルを設定できます（通貨記号や小数点を表示するなど）。

カスタム値（「月、火、水」など）を使用する場合は、chxl パラメータを使用できます。これらのラベルを軸に沿った特定の場所に配置するには、chxp パラメータを使用します。

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

文字列値に関する注意: ラベルの文字列には、URL セーフな文字のみを使用できます。安全のためには、文字セット 0-9a-zA-Z にない文字を含む文字列は URL エンコードする必要があります。URL エンコーダは、Google ビジュアリゼーションのドキュメントにあります。

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

• 可視軸（chxt） - 表示する軸。
• 軸の範囲（chxr） - 各軸の値の範囲。
• カスタム軸ラベル（chxl）- 軸に表示するカスタム値。
• 軸ラベルの位置（chxp） - 各軸に沿ったカスタムラベルの配置。
• 軸ラベルのスタイル（chxs） - 軸ラベルの色、サイズ、配置、書式。
• 軸の目盛りのスタイル（chxtc）- 特定の軸の目盛りの長さ。

---

軸の表示 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 の範囲になります。 デフォルトでは、上下の軸にラベルの目盛りは表示されません。	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 <img <code="" dir="ltr" src="/static/chart/image/images/chart_42.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chs=200x1
この例は、X 軸、Y 軸、上部の T 軸、右側の R 軸を持つ横棒グラフを示しています。 軸ラベルが省略されているため、Chart API は X 軸と T 軸に 0 ～ 100 の範囲を表示します。 Y 軸と R 軸の範囲は、バーの数によって決まります。この場合、棒は 5 本なので、Chart API は 0 ～ 4 の範囲を表示します。1 つ目のラベルは 1 つ目の棒の底部の中央に配置され、2 つ目のラベルは 2 つ目の棒の基部の中央に配置されます。以降も同様です。	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）が指定されています。	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 軸になります。

<label_1>| ... |<label_n>

この軸に沿って配置する 1 つ以上のラベル。値は文字列または数値になります。文字列を引用符で囲む必要はありません。label_1 は軸の最下位の位置に表示され、label_n は最上位に表示されます。追加のラベルはそれらの間に均等に配置されます。スペースは + 記号で示します。ラベル内の改行を指定する方法はありません。ラベルはパイプ文字で区切ります。注: chxl パラメータの最終ラベルの後にパイプを入れないでください。

 

例

説明	例
このグラフは、2 つの軸にカスタムラベルを追加する方法を示しています。値が等間隔で配置されていること、最後の chxl 値がパイプで終わっていないことに注目してください。	chxt=x,y chxl= 0:|Jan|Feb|March|April|May| 1:|Min|Mid|Max
この例では、左右の Y 軸（y と r）に軸ラベルが配置されています。また、X 軸（x）に 2 つの値セットが含まれています。chxs を使用して Y 軸に目盛りを追加することもできます。	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 軸の値セット（x）が 2 つ含まれています。下の X 軸セットには空のラベルがあり、値の間隔を空けています。 この例では、左側の Y 軸の軸ラベルにデフォルト値を使用します。	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 2:|A|B|C| 3:|2005||2006||2007
軸全体を記述する汎用ラベルを追加する場合（たとえば、ある軸に「cost」と別の「student」のラベルを付ける）、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 軸の右側に配置されます。	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 単位ごとになります。	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_coloropt_axis_color>

（省略可）: この軸線の色（RRGGBB の 16 進形式）。デフォルトはグレーです。

 

例

説明	例
2 番目の X 軸（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 軸では、フォントサイズ、色、配置が指定されています。 目盛りは描画されますが、軸線は描画されません。	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、start、end、step）を使用して設定します。 設定しなかった場合、デフォルトは 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 ピクセルの目盛りを軸の内側に指定します。負の数値は目盛りが軸の内側にあり、目盛りがグラフ内に収まるように切り抜かれることを意味します。	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

トップへ戻る

線のスタイル 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>

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

 

例

説明	例
ここでは、破線は 3,6,3 で指定され、太い実線は 5 で指定されています。	chls=3,6,3|5

トップへ戻る

背景の塗りつぶし 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% の透明度です）。表セルの背景がグラフ全体に表示されます。	chf=a,s,00000080

トップへ戻る

グラデーション塗りつぶし chf [Line, Bar, Google-o-meter, Radar, Scatter,Venn]

グラフ領域や背景に 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）、右側（1.0）の中央は青色（76A4FB）です。 グラフの背景はグレー（EFEFEF）で描画されます。	chf=   c,lg,0,   FFE7C6,0,（ピーチ）   76A4FB,1（青）
グラフ領域には、45 度（45）の角度で指定された対角線（左下から右上）の線形グラデーションがあります。 最初に指定した色はピーチ（FFE7C6）です。グラフの左下は純粋なピーチです。 2 番目に指定する色は青（6A4FB）です。グラフの右上は純粋な青色です。オフセットを 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 - 最初のストライプと同じですが、白色です。	chf=   c,ls,90,   999999,0.25,   CCCCCC,0.25,   FFFFFF,0.25

トップへ戻る