グラフ描画

戻る

グラフ描画(《レイアウト情報》,《値の配列》)のグラフ情報,値の配列についての説明。 基本的には値をそのままPlotly.jsのnewPlotに渡していると考えてよい (だからここに書ききれない設定で,使えるものもたくさんある)。

レイアウト情報

レイアウト情報は表のようなキーを持つ連想配列である。 値が「〜または連想配列」となっているものは,「〜」の値か,表にあるキーを持つ連想配列のどちらかを設定する。

キー値の型設定される情報
title文字列または連想配列グラフのタイトル
キー値の意味
text文字列グラフのタイトル
font文字列または連想配列フォント名
キー値の意味
family文字列フォント名
size1以上の数値文字サイズ
color文字列文字色
showlegend真偽凡例を表示するか
legend連想配列凡例詳細
キー値の型値の意味
bgcolor文字列背景色
bordercolor文字列枠色
borderwidth0以上の数値枠の太さ(px)
font文字列または連想配列フォント名(連想配列のキーはtitleのfontと同じ)
orientation"v"または"h"凡例の向き
width10以上の数値幅(px)
height10以上の数値高さ(px)
font文字列または連想配列全体的なフォント(連想配列のキーはtitleのfontと同じ)
paper_bgcolor文字列背景色
plot_bgcolor文字列プロットエリアの背景色
xaxis,yaxis連想配列x軸,y軸の情報。
キー値の型値の意味
title文字列または連想配列軸タイトル(連想配列のキーはtitleと同じ)
showgrid真偽グリッドを表示するか
showline真偽軸の線を表示するか
zeroline真偽ゼロの線を強調するか
range値の配列[最小値,最大値]

値の配列

「値の配列」は,以下のキーを持つ連想配列の配列である。

キー値の型設定される情報
type文字列グラフの種類
name文字列データ系列の名前
visible真偽または"legendonly"表示するかどうか
showlegend真偽凡例に表示するか
opacity0〜1の数値不透明度
ids値の配列個々の値のid
text文字列または文字列の配列個々の値に紐付けられた文字列

typeがscatterの場合,次のキーも持つ。

キー値の型設定される情報
x値の配列xの値,または横軸のラベル
y値の配列yの値
mode文字列表示モード。"lines","markers","lines+markers","lines+markers+text"のどれか。 デフォルトでは,点が20個以上なら"lines",19個以下なら"lines+markers"になる。
marker連想配列マーカーのプロパティ
キー値の型設定される情報
symbol文字列形状。"circle", "square", "diamond", "cross", "triangle-up", "triangle-down", "triangle-right", "triangle-left", "triangle-se", "triangle-sw", "triangle-ne", "triangle-nw", "pentagon", "hexagon", "hexagon2", "octagon", "star", "hexagram", "star-triangle-up", "star-triangle-down", "diamond-tall", "diamond-wide", …や,それらの後ろに"-open","-dot","-open-dot"を付けたもの。
size0以上の数値大きさ(px)
color文字列
opacity0〜1の数値不透明度
line連想配列輪郭線
キー値の型設定される情報
width0以上の数値太さ(px)
color文字列
opacity0〜1の数値不透明度
line連想配列線のプロパティ
キー値の型設定される情報
color文字列
width0以上の数値太さ(px)
shape文字列線の引き方。"linear", "spline", "hv", "vh", "hvh", "vhv"のどれか。
dash文字列線の形状。"solid", "dot", "dash", "longdash", "dashdot", "longdashdot"のどれか。

typeがbarの場合
layoutのbarmodeをstackに設定することで積み上げ棒グラフが作れる。

キー値の型設定される情報
x配列横軸のラベル
y数値の配列
marker連想配列棒のプロパティ
キー値の型設定される情報
color文字列
line連想配列輪郭線のプロパティ(scatterのmakerのlineと同じ)
opacity0〜1の数値不透明度

typeがpieの場合

キー値の型設定される情報
values数値の配列
labels値の配列値のラベル
text値の配列各値に紐付けられた文字列
marker連想配列扇形のプロパティ
キー値の型設定される情報
colors文字列の配列
line連想配列輪郭線(scatterのmarkerのlineと同じだが,それぞれ配列にもできる)
opacity0〜1の数値不透明度
pull0〜1の数値中心から外側に離す割合
direction文字列向き。"clockwise"か"counterclockwise"。
hole0〜1の数値穴の大きさ(ドーナツチャートを作るために)
rotation-360〜360の数値開始角度
sort真偽ソートするか
textinfo文字列円グラフ内に表示する情報。 "label", "text", "value", "percent"のどれかか,それらを"+"でつないだもの。 表示しないなら"none"

typeがboxの場合

キー値の型設定される情報
x数値の配列値(横型で表示する場合)
y数値の配列値(縦型で表示する場合)
orientation文字列向き。"v"か"h"
marker連想配列
キー値の型設定される情報
outliercolor文字列外れ値の色
symbol文字列マーカーの形状(scatterのmarkerのsymbolと同じ)
opacity0〜1の数値不透明度
size0以上の数値マーカーのサイズ(px)
color文字列マーカーの色
line連想配列箱ひげ図の線。colorとwidthがキー
boxmean真偽または"sd"平均を表示するか。"sd"では標準偏差も表示する。

typeがhistogramの場合

キー値の型設定される情報
x数値の配列値(横型で表示する場合)
y数値の配列値(縦型で表示する場合)
orientation文字列向き。"v"か"h"
marker連想配列ヒストグラムのプロパティ

Plotly.jsは高機能すぎて,とてもではないが書ききれない。