# 円グラフ

> 円グラフのダッシュボードのコンポーネントの参照です。全体が実時間のポイントにどう分かれるかを見せるもので、エディターの項目をすべて説明します。

**円グラフ** は、全体がどう分かれるかを見せます。アドレスごとに 1 つの扇形で、今この瞬間に読んだ値を、円、ドーナツ、または半ドーナツとして描きます。[棒グラフ](component-bar-chart) と同じく分類を比べるグラフで、時間軸も、表示範囲も、刻みも、保持もありません。2 つは内容、ポイント、書式の節を分け合い、違うのは下の絵だけです。

読めていないポイントは、0 として描かれるのではなく比較から外され、グラフは絵の下でそう述べます。開いたばかりの画面は、まだ何も述べません。

## 内容とポイント {#content-and-points}

| 項目 | 何をするか | 値 | 既定 |
|---|---|---|---|
| グラフの表題 | プロット領域の中に描く任意の見出しです。これはグラフ自身の見出しであって、コンポーネントの隅の表題ではありません（そちらは共通の外観の節にあります）。 | テキスト | 空 |
| ポイント | 比べる分類です。扇形ごとに 1 枚のカードが、宣言した順に並びます。**ポイントを追加** が 1 つ足します。 | 一覧 | 空 |
| · アドレス | その扇形が読む、根の付いた Logic のアドレスです。欄は実時間のポイントの一覧から数値のポイントに絞って候補を出し、指定するとそのポイントの今の読み取り値を見せます。 | アドレス | 空 |
| · 名前 | ラベルと凡例がその扇形を何と呼ぶかです。 | テキスト | 空欄のときはアドレスに戻ります |
| · 色 | その扇形の色を `#RRGGBB` で指定します。 | 16 進数の色 | 空欄のときは組み合わせの順番を取ります |
| 並び | 扇形を描く順です。 | 宣言した順 · 小さい順 · 大きい順 | 宣言した順 |

## 書式 {#format}

| 項目 | 何をするか | 値 | 既定 |
|---|---|---|---|
| 単位 | 読み取り値のうしろに書く任意の工業単位です。 | テキスト | 空 |
| 小数桁 | 読み取り値に対する固定の小数の桁数です。 | 0 から 15 | 空欄はステーションの設定を使います |
| 表示の仕方 | それぞれの読み取り値をどう書き出すかです。ラベルでもツールチップでも同じです。 | 数値 · パーセント · 所要時間 | 数値 |
| 値の数え方 | 書式が所要時間のとき、値の 1 単位が何を意味するかです。 | 秒 · ミリ秒 · 分 | 秒 |

## 扇形 {#slices}

| 項目 | 何をするか | 値 | 既定 |
|---|---|---|---|
| 形 | 扇形を切り出す本体です。3 つとも同じ問いに答え、違うのは中央が何のためにあるかです。まるい円板はどの扇形にもいちばん広い面積を与え、輪は中央を空け、半分の輪は、カードを並べた行が残す、横に広く背の低います目に収まります。 | 円 · ドーナツ · 半ドーナツ | 円 |
| ラベル | それぞれの扇形の隣に何を書くかです。描かれるラベルには名前が必ず入ります。名前のない扇形の隣に浮かぶ数値は何も述べないからです。選ぶのは、それに何を添えるかです。何も選ばなければ、扇形の名乗りは凡例に任されます。小さいます目が求めるのは、それです。 | 名前だけ · 名前と読み取り値 · 名前と割合 · 名前、読み取り値、割合 · なし | 名前と割合 |
| ラベルの位置 | 書き文字がどこに座るかです。外は輪の直径と引き出し線を使います。ラベルは引き出し線の端からます目の縁までのあいだに書かれ、その幅より長いラベルは省略記号で終わり、ツールチップが全文を示します。名前は専用の 1 行に、読み取り値と割合はその下の行に書かれるので、幅に切られるのは名前であって割合ではありません。輪の隣にラベルを書けないほど狭います目では、ラベルを消し、代わりに凡例が扇形を 1 行に 1 つずつ並べます（凡例が「なし」のときはプロット領域の下に出ます）。行より長い名前は省略記号で終わり、その行のツールチップが全文を示します。一覧は最大 5 行を使い、輪にも高さの 3 分の 1 を残せないほど低います目では、それより少なくなります。扇形が行より多いときは、一覧はページごとに示され、最後の行に矢印とページ数（1/3 など）が出ます。ます目が十分に広くなれば、ラベルは戻ります。中はます目をラベルに使いませんが、ラベルを持てるだけの広い扇形が要ります。ラベルをそもそも描くときにだけたずねられます。 | 輪の外 · 扇形の中 | 輪の外 |
| 凡例 | 凡例をどこに置くかです。輪の隣にラベルがないとき（ラベルが「なし」のときや、扇形の中にあるとき）は、扇形の名前を示すのは凡例だけです。すべての名前を 1 行に書けないほど狭います目では、凡例は代わりに扇形を 1 行に 1 つずつ並べます。狭います目が外のラベルの代わりに描くのと同じ一覧です（「ラベルの位置」を参照）。ます目が十分に広くなれば、1 行に戻ります。 | プロット領域の上 · プロット領域の下 · なし | プロット領域の上 |

## 目盛りの帯 {#scale-bands}

**目盛り** の節は、共通の帯のエディターで値の範囲の区間を宣言します。円グラフでは、帯は色の組み合わせです。それぞれの扇形を、その読み取り値が落ちる場所によって染めるだけで、それ以上のことはしません。1 つの全体の扇形には、絵が *その中にいる* ひとつの区間がないので、言葉の欄も基準も出ません。最後の上限を超えた読み取り値は、扇形に付けた色をそのまま保ちます。

## ツール {#toolbox}

| ツール | 何をするか | 既定の組に入るか |
|---|---|---|
| PNG を保存 | 絵を PNG としてダウンロードします。 | はい |
| PNG をコピー | 絵を PNG としてクリップボードに置きます。 | はい |
| 全画面 | このグラフでウィンドウを埋めます。 | はい |