円グラフ

   

このドキュメントでは、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

同心円グラフ。

データ系列を複数指定します。

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

cht=pc
chd=s:Helo,Wrld

すべてのタイプ データに負の数値がある場合、スライスは「空白」になります。 それぞれ 4 つのセグメントがある同心円グラフ 2 つ(セグメントの色は濃いオレンジから薄いオレンジまで補間されています)
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 つのデータ系列がありますが、黄色から赤までのすべてのスライスにわたって 1 つのグラデーションとして色を指定しています(BBBB00 ~ BB0000)。 それぞれ 4 つのセグメントがある同心円グラフ 2 つ(セグメントの色は濃いオレンジから薄いオレンジまで補間されています)
chco=BBBB00,BB0000

これは、系列の色と個々のスライスの色の両方を含む同心円グラフです。このグラフには同心円状のデータ系列が 2 つあります。 人が読める形式では、色は chco=green|red,blue|yellow です。カンマにより、次の 2 つのシリーズに分割されます。

  • 緑|赤 - 緑と赤のスライスが交互に表示されます。
  • 青|黄 - 青と黄色のスライスが交互に表示されます。
それぞれ 4 つのセグメントがある同心円グラフ 2 つ(セグメントの色は濃いオレンジから薄いオレンジまで補間されています)
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 π - 約 6.28)ラジアンです。

説明

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

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

chd=t:20,80


0.628 回転させた 2 つのセグメントを含む円グラフ

chd=t:80,20
chp=0.628

次に、円グラフの回転の例を示します。これらをグラフの図形マーカーと組み合わせて、面白い効果を生み出すことができます。 0.628 回転させた 2 つのセグメントを含む円グラフ

 

トップへ戻る

標準の機能

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

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

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

構文

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 ポイントのタイトルが付いたグラフ。

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

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

大きな円で囲まれた 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 を使用して値のスタイルを設定できます(通貨記号や小数点を表示するなど)。

カスタム値(「月、火、水」など)を使用する場合は、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


<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 つ目の棒の基部の中央に配置されます。以降も同様です。

左右に 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)が指定されています。

200、300、400 を X 軸とした棒グラフ 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 値がパイプで終わっていないことに注目してください。

左側に 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)に軸ラベルが配置されています。また、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 軸の値セット(x)が 2 つ含まれています。下の X 軸セットには空のラベルがあり、値の間隔を空けています。

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

左側に 0 と 100、右側に A、B、C、X 軸に「Jan、7 月、Jan、7 月、Jan」、下に 2005、2006、2007 と表示された棒グラフ
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 軸の右側に配置されます。

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_coloropt_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、下に 1 月、2 月、3 月、Y 軸に 0 ~ 4 が表示され、右側に最小、平均、最大を示す赤い目盛りが付いた折れ線グラフ。

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_indexstartendstep)を使用して設定します。 設定しなかった場合、デフォルトは 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、下に 1 月、2 月、3 月、Y 軸に 0 ~ 4 が表示され、右側に最小値、平均値、最大値を表す青い文字の長い赤い目盛りが付いた折れ線グラフ。

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 [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>
このストライプの幅(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 - 最初のストライプと同じですが、白色です。
下から上に、濃いグレー、薄いグレー、白、濃いグレーの縞模様で描かれた青い折れ線グラフ
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_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 を使用してください。

 

説明

単純な正弦波です。注意点:

  • chd=t:-1 - データが chfd パラメータで宣言されているため、グラフデータにはダミー変数を使用します。
  • chco=FF0000 - 最初の系列には赤を指定します。chd のデータは使用しませんが、その系列に対応する色がプロットされた関数に使用されます。
  • chfd=0,x,0,11,0.1,sin(x)*50%2B50 - 0 ~ 11 の値を持つ x という変数を 1 つ宣言し、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、ポイント 1 は 0、ポイント 1 は 0.1 というように、値が 11 のポイント 110 まで続きます。

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 つのディメンションの関数を定義するには、1 つの lxy グラフを使用して、2 つのダミーの系列を割り当て、それぞれに関数を割り当てます。

  • 0,x,0,10,0.1,sin(x)*50%2B50 - シリーズ 0(x 軸の値)には、x という名前の変数があり、値は 0 ~ 10、ステップ 0.1、関数 sin(x)*50 + 50 を持ちます。
  • 0,y,0,10,0.1,sin(y)*50%2B50 - 系列 0(y 軸の値)には、y という名前の変数があり、値は 0 ~ 10、ステップ 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 パラメータで創造性を表現できます。

これらの画像をクリックして開き、チャート プレイグラウンドでプレイしてみてください。夢中になるでしょう。



トップへ戻る