![cht=p&chd=s:Uf9a&chs=75x50](https://developers-dot-devsite-v2-prod.appspot.com/static/chart/image/images/chart_263.png?authuser=3&hl=ja)
このドキュメントでは、Chart API を使って円グラフを作成する方法について説明します。
目次
グラフ固有の機能 |
Standard の機能
|
概要
円グラフは、部分と全体の単純な比例を示す情報を表示するのに適しています。1 つの系列円グラフを作成し、各系列が複数のスライスで構成されている場合や、複数の系列の同心円グラフを作成できます。
各系列は 1 つの円を表し、各データ値には 1 つのスライスを指定します。ネストされた円グラフ(後述)を使用する場合は、複数の系列を使用します。
スライスに関連付けられたテキストを表示するには、円グラフのラベルまたはグラフの凡例を使用する必要があります。円グラフのラベルは、グラフを囲むテキストで、線がスライスを指しています。凡例は、色ごとに関連付けられたテキストです。
ラベル | 凡例 | ラベルと凡例 |
---|---|---|
![]() chl=January|February|March|April |
![]() chdl=January|February|March|April |
![]() chl=January|February|March|April |
値は互いに相対的に表示されるため、値が 1、2、3 のグラフは、値が 100、200、300 のグラフと同じように表示されます。ただし、テキスト形式のデータを使用する場合、100 を超える値は 100 に切り詰められるため、100 を超えるスライスを適切に表示するには、カスタム スケーリングのテキスト形式を使用する必要があります(chds=0,<max-slice-size>
の最小値/最大値を指定して chds
パラメータを使用します)。
負の値は、適切なサイズの空のスライスとして表示されます。
グラフの種類
円グラフには主に、平面、同心、3D の 3 種類があります。円グラフを指定するには、次の構文を使用します。
構文
cht=<chart_type>
ここで、<chart_type>
は次のいずれかの型です。
パラメータ | 説明 | 例 |
---|---|---|
|
2 次元の円グラフ。 1 つのデータ系列のみを指定し、後続のデータ系列は無視されます。 デフォルトでは、円グラフのセグメントの色は濃いオレンジから薄い黄色に補間されます。系列の色の説明に沿って、他の色を指定します。 円グラフのラベルで説明されているように、 Google Chart API は、グラフサイズ( |
|
|
3 次元の円グラフ。 データと書式は、上記の 2 次元の円グラフと同じ方法で指定します。 3 次元の円グラフにラベルを含める場合は、ラベルが完全に表示されるように、通常は幅のサイズを高さの 2.5 倍にする必要があります。 |
|
|
同心円グラフ。 2 つ以上のデータ系列を指定します。 |
|
すべてのタイプ | データ内の負の数値は「空白」のスライスの原因になります。 | ![]() cht=pc |
系列の色 chco
chco
パラメータを使用して、すべての値、各値、または一部の値の色を指定できます。
構文
chco=<slice_1>|<slice_2>|<slice_n>,<series_color_1>,...,<series_color_n>
- <color>
- スライスの色(RRGGBB の 16 進数形式)。1 つの系列の色を指定すると、その系列内のすべてのスライスは、最も暗い(最初のデータメンバー)から最も明るい(最後のデータメンバー)までのグラデーションで色付けされます。個々のスライスの色を表すには、2 つ以上の色を | で区切って指定します。複数の系列(同心円のグラフなど)がある場合は、値をカンマで区切ることで系列の値を指定できます。指定されたスライス/系列の色が、表示されているスライス/系列よりも少ない場合、グラフは系列のスライスリストまたはグラフの系列リストの先頭から順繰りに表示します。複数系列グラフの系列ごとに個別の勾配を指定することはできません。
説明 | 例 |
---|---|
最も暗い(最初のスライス)から最も明るい(最後のスライス)までのグラデーションに、単一の色を指定します。 |
|
グラデーションを定義します。ここでは、黄色から赤色へのグラデーションを定義します。 | ![]()
|
スライスの色を個別に定義します。スライスごとに 1 つの色を指定します。 | ![]() chd=t:10,20,30 |
このグラフには 2 つのデータ系列がありますが、黄色から赤(BBBB00 ~ BB0000)のすべてのスライスにわたって、単一のグラデーションとして色が指定されています。 | ![]() chco=BBBB00,BB0000 |
次の同心円グラフは、系列の色と個々のスライスの色の両方を示しています。グラフには 2 つの同心のデータ系列があります。人が読める形式では、色は chco=green|red,blue|yellow です。カンマで 2 つの系列に分割します。
|
![]() chd=s:eYY,ORVM |
円グラフのラベルchl
chl
パラメータを使用して、個々の円グラフのスライスのラベルを指定できます。同じまたは異なる値の凡例を表示することもできます(スライスごとに 1 つの凡例エントリ)。
文字列値に関する注意事項: ラベルの文字列には URL セーフ文字のみを使用できます。安全のために、文字セット 0-9a-zA-Z
にない文字を含む文字列はすべて URL エンコードする必要があります。URL エンコーダについて詳しくは、こちらをご覧ください。
構文
chl= <label_value>| ... <label_value>
- <label_value>
- スライスに適用する文字列値。ラベルは、
chd
内のデータポイントに連続して適用されます。複数の系列(同心円グラフなど)がある場合は、chd
で指定された順序で、すべての系列内のすべてのポイントにラベルが適用されます。各ラベルの間にはパイプ区切り文字(|
)を使用します。間にスペースを入れずに連続する 2 つのパイプ文字(||
)を使用して、間に不足している値を指定します。すべてのスライスにラベルを付ける必要はありません。
例
説明 | 例 |
---|---|
3 次元の円グラフのラベル。 |
|
ラベルを適切に表示するには、通常、2 次元の円グラフでは高さの約 2 倍の幅が必要で、3 次元の円グラフでは高さの約 2.5 倍の幅が必要です。 最初の例では、グラフの幅が十分ではないため、ラベルは部分的にしか表示されていません。 2 番目の例では、グラフを完全に表示するのに 280 ピクセルの幅が必要であることを示しています。( |
|
円グラフの回転 chp
デフォルトでは、最初の系列は 3:00 を起点としてグラフの時計回りに継続して描画されますが、chp
パラメータを使用してカスタム回転を指定できます。
構文
chp=<radians>
- <radians>
- グラフを時計回りに回転させるラジアンの数を表す浮動小数点値。1 ターンは 2π(2 pi ~約 6.28)ラジアンです。
例
説明 | 例 |
---|---|
円グラフの向きを変更するには、 |
|
円グラフの回転のもう一つの例です。グラフの図形マーカーと組み合わせて、面白い効果を作成できます。 | ![]() |
標準の機能
このページの残りの機能は、標準のグラフ機能です。
グラフのタイトル 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」です。
例
説明 | 例 |
---|---|
デフォルトの色とフォントサイズを使用したタイトル付きのグラフ。 プラス記号( 改行を強制するには、パイプ文字(
|
![]() chtt=Site+visitors+by+month| |
20 ポイントの青色の右揃えのタイトルグラフ。 |
![]() chtt=Site+visitors |
グラフの凡例のテキストとスタイル 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
chdl=First|Second|Third |
1 つ目のグラフは横方向の凡例エントリ( |
|
この例では、フォントサイズを変更する方法を示します。 |
|
グラフのマージン chma
[すべてのグラフ]
グラフの余白のサイズをピクセル単位で指定できます。マージンは、指定されたグラフサイズ(chs
)から内側に計算されます。マージンサイズを大きくしても、グラフの合計サイズは拡大せず、必要に応じてグラフ領域を縮小します。
デフォルトでは、グラフサイズが計算された後の余白が余白になります。このデフォルト値は、グラフの種類によって異なります。指定する余白は最小値です。グラフ領域に余白がある場合は、余白のサイズがそのまま適用されます。凡例やラベルに必要な余白よりも小さくすることはできません。次の図は、グラフの基本部分を示しています。
![]() |
グラフのマージンには、軸ラベルと凡例領域が含まれます。凡例の領域は、テキストがぴったり収まるように自動的にサイズ変更されます。ただし、 ヒント: 棒グラフでは、棒のサイズが固定されている場合(デフォルト)、グラフ領域の幅を減らすことはできません。 |
構文
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 ピクセルを超えているため、右側のマージンはグラフの凡例の幅に設定され、他のマージンとは異なります。 軸ラベルはプロット領域の外側にあるため、マージン空間内に描画されます。 |
|
凡例の周囲にマージンを追加するには、 この例では、凡例の幅は約 60 ピクセルです。 |
|
軸のスタイルとラベル [線、棒、Google メーター、レーダー、散布図]
グラフに表示する軸を指定し、カスタムラベル、位置、範囲、スタイルを設定できます。
デフォルトでは、すべてのグラフに軸線が表示されるわけではありません。chxt
パラメータを使用して、グラフに表示する軸を正確に指定できます。デフォルトの軸の線には数値は表示されません。数値を表示するには、chxt
パラメータで軸を指定する必要があります。
データ値を反映した数値を軸に表示することも、カスタム軸を指定することもできます。デフォルトでは、0 ~ 100 の範囲にスケーリングされた数値が表示されます。ただし、chxr
を使用して範囲を変更し、任意の範囲を表示できます。また、chxs
を使用して値のスタイルを設定できます(通貨記号や小数点以下の桁数など)。
カスタム値(「Mon, Tues, Wed」など)を使用する場合は、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 の範囲に設定されます。 デフォルトでは、上下の軸にはラベルの目盛りは表示されません。 |
|
同じ値を複数回指定することで、各軸に複数のラベルセットを含めることができます。この例では、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 番目の棒の底部に中央揃えされます。 |
|
折れ線グラフのデフォルトの軸を非表示にするには、グラフの種類の後に :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 軸( 各軸には定義された範囲があります。ラベルや位置が指定されていないため、値は指定された範囲から取得され、その範囲内で均等に配置されます。折れ線グラフでは、値は X 軸に沿って均等に分散されます。 最初の値( |
|
この例では、X 軸に値が指定されています。 軸ラベルは、軸に沿って均等に配置されます。<opt_step> パラメータには値 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 つの軸にカスタムラベルを追加する方法を示しています。値が均等に配置され、最後の |
![]() chxt=x,y |
この例では、左右の Y 軸( |
|
この例では、左右の Y 軸( この例では、左側の Y 軸の軸ラベルにデフォルト値を使用します。 |
|
汎用のラベルを追加して軸全体を説明する場合(たとえば、ある軸に「費用」と別の「生徒」というラベルを付ける場合は、 |
![]() chxt=x,x,y,y |
軸ラベルの位置 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 軸のラベルが含まれています。ラベルのテキストは、 位置が 位置が |
|
この例では、デフォルトのラベル値を示していますが、指定した位置にのみ表示されます。
|
chxt=x,y
![]() 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 月)のフォントサイズと色が指定されています。 |
|
右側の Y 軸のフォントサイズ、色、配置が指定されています。目盛りは描画されますが、軸線は描画されません。 |
|
このグラフには 3 つのデータセットがあり、系列ごとに 1 つずつ、3 セットの軸ラベルが表示されています。ラベルの各セットは、カスタム書式設定文字列を使用して書式設定されます。
軸ラベルの範囲は、 |
![]() chd=s: |
軸の目盛りのスタイル 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 は、y 軸の 2 つの目盛りの長さ値(5 と 15)を指定します。グラフに描画される目盛りはその 2 つの値を交互に表示します。 |
![]() chxt=x,y |
背景塗りつぶし 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 桁は無視されますが、含めて含めてください。
例
説明 | 例 |
---|---|
この例では、グラフの背景が淡いグレー( |
|
この例では、グラフの背景を淡いグレー( |
|
この例では、グラフ全体に 50% の透明度を適用します(16 進数の 80 は 128、つまり約 50% の透明度です)。グラフの上にテーブルセルの背景が表示されます。 |
|
グラデーション塗りつぶし 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 度( 色は桃色( グラフの背景はグレー( |
|
グラフ領域には、45 度( 最初に指定された色は桃色( 青( グラフの背景はグレー( |
|
グラフ領域には、90 度( 最初に指定された色は青( 2 番目に指定されている色は桃色( グラフの背景はグレー( |
|
ストライプ塗りつぶし 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 つ必要です。グラフが塗りつぶされるまでストライプが交互に表示されます。
例
説明 | 例 |
---|---|
|
![]() chf= |
|
![]() chf= |
データ関数 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
を使用してください。
例
説明 | 例 |
---|---|
単純な正弦波。注意点:
|
![]() cht=lc |
この線は、chd パラメータのデータを使用しています。 |
![]() chd=t:5,10 |
関数行と非関数行が混在している。 色が系列の色パラメータ 関数の出力では、マーカーの配置に注目してください。データポイントは start、end、step から計算されます。つまり、範囲が 0 ~ 11 ステップ 0.1 の場合、ポイント 0 は 0、ポイント 1 は 0.1、というようにポイント 110 までは 11 となり、その値は 11 になります。 |
![]() chd=t: |
2 つの次元で関数を定義するには、
|
![]() cht=lxy |
これらの画像をクリックして開き、チャート プレイグラウンドで遊んでみましょう。きっと夢中になります。 |