円グラフ

   

このドキュメントでは、Chart API を使って円グラフを作成する方法について説明します。

目次

概要

円グラフは、部分と全体の単純な比例を示す情報を表示するのに適しています。1 つの系列円グラフを作成し、各系列が複数のスライスで構成されている場合や、複数の系列の同心円グラフを作成できます。

各系列は 1 つの円を表し、各データ値には 1 つのスライスを指定します。ネストされた円グラフ(後述)を使用する場合は、複数の系列を使用します。

スライスに関連付けられたテキストを表示するには、円グラフのラベルまたはグラフの凡例を使用する必要があります。円グラフのラベルは、グラフを囲むテキストで、線がスライスを指しています。凡例は、色ごとに関連付けられたテキストです。

ラベル 凡例 ラベルと凡例

chl=January|February|March|April

chdl=January|February|March|April

chl=January|February|March|April
chdl=30°|40°|50°|60°

値は互いに相対的に表示されるため、値が 1、2、3 のグラフは、値が 100、200、300 のグラフと同じように表示されます。ただし、テキスト形式のデータを使用する場合、100 を超える値は 100 に切り詰められるため、100 を超えるスライスを適切に表示するには、カスタム スケーリングのテキスト形式を使用する必要があります(chds=0,<max-slice-size> の最小値/最大値を指定して chds パラメータを使用します)。

負の値は、適切なサイズの空のスライスとして表示されます。

グラフの種類

円グラフには主に、平面、同心、3D の 3 種類があります。円グラフを指定するには、次の構文を使用します。

構文

cht=<chart_type>

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

パラメータ 説明

p

2 次元の円グラフ。

1 つのデータ系列のみを指定し、後続のデータ系列は無視されます。

デフォルトでは、円グラフのセグメントの色は濃いオレンジから薄い黄色に補間されます。系列の色の説明に沿って、他の色を指定します。

円グラフのラベルで説明されているように、chl を使用してラベルを指定します。

Google Chart API は、グラフサイズ(chs)パラメータで指定された幅と高さの最小値から円の半径を計算します。ラベルを含める場合は、ラベルが完全に表示されるように、通常は幅のサイズを高さの 2 倍に指定する必要があります。

4 つのセグメントがあり、セグメントの色が濃いオレンジ色から薄いオレンジ色に補間されている 2 次元の円グラフ

cht=p
chs=200x100

p3

3 次元の円グラフ。

データと書式は、上記の 2 次元の円グラフと同じ方法で指定します。

3 次元の円グラフにラベルを含める場合は、ラベルが完全に表示されるように、通常は幅のサイズを高さの 2.5 倍にする必要があります。

セグメントの色が濃いオレンジ色から薄いオレンジ色に補間されている 4 つのセグメントがある 3 次元の円グラフ

cht=p3
chs=250x100

pc

同心円グラフ。

2 つ以上のデータ系列を指定します。

セグメントの色が濃いオレンジ色から薄いオレンジ色に補間されている、2 つの同心円グラフにそれぞれ 4 つのセグメントがある

cht=pc
chd=s:Helo,Wrld

すべてのタイプ データ内の負の数値は「空白」のスライスの原因になります。 セグメントの色が濃いオレンジ色から薄いオレンジ色に補間されている、2 つの同心円グラフにそれぞれ 4 つのセグメントがある
cht=pc
chd=t:
10,-10,10,-10|
5,-5,5,-5,5,-5,5,-5,5,-5

 

系列の色 chco

chco パラメータを使用して、すべての値、各値、または一部の値の色を指定できます。

構文

chco=<slice_1>|<slice_2>|<slice_n>,<series_color_1>,...,<series_color_n>
<color>
スライスの色(RRGGBB の 16 進数形式)。1 つの系列の色を指定すると、その系列内のすべてのスライスは、最も暗い(最初のデータメンバー)から最も明るい(最後のデータメンバー)までのグラデーションで色付けされます。個々のスライスの色を表すには、2 つ以上の色を | で区切って指定します。複数の系列(同心円のグラフなど)がある場合は、値をカンマで区切ることで系列の値を指定できます。指定されたスライス/系列の色が、表示されているスライス/系列よりも少ない場合、グラフは系列のスライスリストまたはグラフの系列リストの先頭から順繰りに表示します。複数系列グラフの系列ごとに個別の勾配を指定することはできません。
説明

最も暗い(最初のスライス)から最も明るい(最後のスライス)までのグラデーションに、単一の色を指定します。

セグメントが濃い青色から薄い青色まで補間された 3 次元円グラフ

chco=0000FF

グラデーションを定義します。ここでは、黄色から赤色へのグラデーションを定義します。 黄色から赤色までの幅があります。
chd=t:10,20,30,40,50
chco=FFFF10,FF0000

スライスの色を個別に定義します。スライスごとに 1 つの色を指定します。 色ごとに 1 つのスライス。
chd=t:10,20,30
chco=FF0000|00FF00|0000FF
このグラフには 2 つのデータ系列がありますが、黄色から赤(BBBB00 ~ BB0000)のすべてのスライスにわたって、単一のグラデーションとして色が指定されています。 セグメントの色が濃いオレンジ色から薄いオレンジ色に補間されている、2 つの同心円グラフにそれぞれ 4 つのセグメントがある
chco=BBBB00,BB0000

次の同心円グラフは、系列の色と個々のスライスの色の両方を示しています。グラフには 2 つの同心のデータ系列があります。人が読める形式では、色は chco=green|red,blue|yellow です。カンマで 2 つの系列に分割します。

  • 緑|赤 - 緑と赤のスライスが交互に現れます。
  • 青|黄 - 青と黄色のスライスが交互に現れます。
セグメントの色が濃いオレンジ色から薄いオレンジ色に補間されている、2 つの同心円グラフにそれぞれ 4 つのセグメントがある
chd=s:eYY,ORVM
chco=008800|880000,000088|888800

トップへ戻る

円グラフのラベルchl

chl パラメータを使用して、個々の円グラフのスライスのラベルを指定できます。同じまたは異なる値の凡例を表示することもできます(スライスごとに 1 つの凡例エントリ)。

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

構文

chl=
  <label_value>|
    ...
  <label_value>
<label_value>
スライスに適用する文字列値。ラベルは、chd 内のデータポイントに連続して適用されます。複数の系列(同心円グラフなど)がある場合は、chd で指定された順序で、すべての系列内のすべてのポイントにラベルが適用されます。各ラベルの間にはパイプ区切り文字(|)を使用します。間にスペースを入れずに連続する 2 つのパイプ文字(|| )を使用して、間に不足している値を指定します。すべてのスライスにラベルを付ける必要はありません。

 

説明

3 次元の円グラフのラベル。

セグメントごとに 5 月、6 月、7 月、8 月、9 月、10 月のラベルが付いた 3 次元の円グラフ

chl=May|Jun|Jul|Aug|Sep|Oct
chs=220x100

chs でグラフのサイズを指定する際は、ラベルに必要なスペースのサイズを考慮してください。

ラベルを適切に表示するには、通常、2 次元の円グラフでは高さの約 2 倍の幅が必要で、3 次元の円グラフでは高さの約 2.5 倍の幅が必要です。

最初の例では、グラフの幅が十分ではないため、ラベルは部分的にしか表示されていません。

2 番目の例では、グラフを完全に表示するのに 280 ピクセルの幅が必要であることを示しています。(<img> 要素に明示的に追加した枠線)。

セグメントごとに 5 月、6 月、7 月、8 月、9 月、10 月のラベルが付いた 3 次元の円グラフ

chl=May|June|July|August|
September|October
chs=220x100


セグメントごとに 5 月、6 月、7 月、8 月、9 月、10 月のラベルが付いた 3 次元の円グラフchl=May|June|July|August|
September|October
chs=280x100

トップへ戻る

円グラフの回転 chp

デフォルトでは、最初の系列は 3:00 を起点としてグラフの時計回りに継続して描画されますが、chp パラメータを使用してカスタム回転を指定できます。

構文

chp=<radians>
  
<radians>
グラフを時計回りに回転させるラジアンの数を表す浮動小数点値。1 ターンは 2π(2 pi ~約 6.28)ラジアンです。

説明

円グラフの向きを変更するには、chp=<angle_in_radians> を使用します。

2 つのセグメントがある円グラフ

chd=t:20,80


2 つのセグメントを 0.628 ずつ回転した円グラフ

chd=t:80,20
chp=0.628

円グラフの回転のもう一つの例です。グラフの図形マーカーと組み合わせて、面白い効果を作成できます。 2 つのセグメントを 0.628 ずつ回転した円グラフ

 

トップへ戻る

標準の機能

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

グラフのタイトル chttchts [すべてのグラフ]

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

構文

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

トップへ戻る

グラフの凡例のテキストとスタイル chdlchdlpchdls(すべてのグラフ

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

凡例の周囲にマージンを設定する方法については、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=bvchdlp=rchdlp=bv|rchdlp=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 軸(yr)と 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 軸(yr)に軸ラベル(yr)があります。また、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 軸(yr)に軸ラベルがあり、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_indexaxis_indexaxis_indexaxis_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>
このストライプの幅(01)。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

トップへ戻る

データ関数 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 によってどのように指定されているかに注目してください。

関数の出力では、マーカーの配置に注目してください。データポイントは startendstep から計算されます。つまり、範囲が 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 パラメータを使うと、創造性を存分に発揮できます。

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



トップへ戻る