このドキュメントでは、Chart API を使って円グラフを作成する方法について説明します。
目次
グラフ固有の機能 |
標準機能
|
概要
円グラフは、全体に比例する単純な情報を示すのに適しています。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 倍に指定する必要があります。 |
|
|
同心円グラフ。 データ系列を複数指定します。 |
|
すべてのタイプ | データに負の数値がある場合、スライスは「空白」になります。 | 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 つのデータ系列がありますが、黄色から赤までのすべてのスライスにわたって 1 つのグラデーションとして色を指定しています(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 π - 約 6.28)ラジアンです。
例
説明 | 例 |
---|---|
円グラフの向きを変更するには、 |
|
次に、円グラフの回転の例を示します。これらをグラフの図形マーカーと組み合わせて、面白い効果を生み出すことができます。 |
標準の機能
このページの残りの機能は、標準のグラフ機能です。
グラフのタイトル 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" です。
例
説明 | 例 |
---|---|
デフォルトの色とフォントサイズを使用したタイトル付きのグラフ。 プラス記号( パイプ文字( ここでは |
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_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
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
を使用して値のスタイルを設定できます(通貨記号や小数点を表示するなど)。
カスタム値(「月、火、水」など)を使用する場合は、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 <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 つ目の棒の基部の中央に配置されます。以降も同様です。 |
|
折れ線グラフのデフォルトの軸を非表示にするには、グラフの種類の後に :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 軸になります。 - <label_1>| ... |<label_n>
- この軸に沿って配置する 1 つ以上のラベル。値は文字列または数値になります。文字列を引用符で囲む必要はありません。label_1 は軸の最下位の位置に表示され、label_n は最上位に表示されます。追加のラベルはそれらの間に均等に配置されます。スペースは + 記号で示します。ラベル内の改行を指定する方法はありません。ラベルはパイプ文字で区切ります。注:
chxl
パラメータの最終ラベルの後にパイプを入れないでください。
例
説明 | 例 |
---|---|
このグラフは、2 つの軸にカスタムラベルを追加する方法を示しています。値が等間隔で配置されていること、最後の |
chxt=x,y |
この例では、左右の Y 軸( |
|
この例では、左右の Y 軸( この例では、左側の Y 軸の軸ラベルにデフォルト値を使用します。 |
|
軸全体を記述する汎用ラベルを追加する場合(たとえば、ある軸に「cost」と別の「student」のラベルを付ける)、 |
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_coloropt_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
[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 度( 色はピーチ( グラフの背景はグレー( |
|
グラフ領域には、45 度( 最初に指定した色はピーチ( 2 番目に指定する色は青( グラフの背景はグレー( |
|
グラフ領域には、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_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
データ系列のインデックス。 - start - 範囲の開始数値。
- 終了 - 範囲の終了数値。
- step - start から end までのステップの数値。 正数でも負数でもかまいませんが、0 にはできません。
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、ポイント 1 は 0、ポイント 1 は 0.1 というように、値が 11 のポイント 110 まで続きます。 |
chd=t: |
2 つのディメンションの関数を定義するには、1 つの
|
cht=lxy |
これらの画像をクリックして開き、チャート プレイグラウンドでプレイしてみてください。夢中になるでしょう。 |