本文主要针对plotly的参数含义进行说明,随着plotly版本的迭代更新,部分参数的用法会有细微变化,具体参加官方文档
一、图表预览
二、图表类型
Angularaxis:极坐标图表
Area:区域图表
Bar:条形图
Box:盒形图,又称箱线图、盒子图、箱图
Candlestick与OHLC:金融行业常用的K线图和OHLC曲线图
ColorBar:彩条图
Contour:轮廓图,又称等高线图
Choropleth:等值线图
Line:线形图
Heatmap:热点图
Histogram:直方图
Histogram 2d:2D平面直方图
Histogram 2d Contour:二维轮廓直方图
Pie:饼图,又称扇形图
Scatter:坐标分布图,包括散点图和线形图
三、线形图和散点图
(一)、说明
线形图又称为曲线图,是最常用的图形类型。与传统的绘图软件不同,Plotly没有独立的线形图函数,而是把线形图与散点图全部用Scatter函数实现;
填充线形图是线形图的一种衍生,除了显示本身的线条值,每个数据点还显示该节点的最大值和最小值,并对中间的范围进行颜色填充。绘制过程分两步:一部分是对三条可见线条进行绘制;另一部分是对三条填充线条进行绘制;
面积图也是线形图的一种衍生,使用Scatter函数进行绘制,不同之处在于面积图对于 fill 属性的设置,相当于在线形图的基础上对曲线与坐标轴之间的区域进行填充;
与基本面积图的填充每条曲线不同,内部填充面积图,仅填充两条曲线交叉所形成的面积部分,同样通过设置 fill 属性来完成,只需在基本面积图的基础上,设置第一条曲线无填充效果,即 fill=None,再设置第二条曲线的填充效果为 fill= 'tonexty';
堆积面积图与层叠柱状图类似,都展示了数据累加的效果,不同之处在于对数据的设置:堆积面积图需要的是累加数据,而层叠柱状图只需要每部分的真实数据即可。因此,在绘制层叠柱状图时需要设置stack模式,而绘制堆积面积图则不需要设置。本质上,堆积面积图的堆积效果是在同一个图形中绘制多个面积图来实现;
Plotly没有独立的气泡图函数,实现方法与散点图的实现方法类似,修改散点图中的点的大小,就变成了气泡图;
特别说明: Plotly绘图函数,无论是哪种类型的图表,绝大部分参数的用法和含义基本一致,本文着重介绍一下线性图和散点图的常用参数,其它图表主要补充独有的参数或常用参数,相同的参数不再重复介绍;
(三)、data参数
connectgaps:布尔变量,用于连接缺失数据;
dx、dy:x、y坐标轴的步进值,默认值是1;
error_x、error_y:x、y出错信息;
fillcolor:填充指定区域的颜色;
fill:设置要填充纯色的区域,默认为none(不填充),其它设置项如下:
tozerox 和 tozeroy 分别表示填充曲线到x=0和y=0的区域;
tonextx 和 tonexty 分别表示填充曲线到x和y方向上的前一条曲线之间的区域,如果前面没有曲线,则效果同tozerox 和 tozeroy;
toself 表示将曲线的各端点连接成闭合的形状;
tonext 表示将2条曲线各端点均连接成闭合的形状,前提是一条曲线包围另一条曲线;
hoverinfo:当用户与图表交互时,鼠标指针显示的参数,包括:x、y
z (坐标轴数据)、text(文字信息)、name(图形名称)等参数的组合,可以使用 +、all、none 和 skip作为组合连接符,默认是all(全部消失);
hoveron:当用户与图表交互时,鼠标指针显示的模式,共有3种模式:points(点图)、fill(填充图)、points+fill(点图+填充图);
ids:在动画图表中,数据点和图形key键的列表参数;
legendgroup:图例参数,默认是空字符串;
line:线条参数,包括线条宽度、颜色、格式等,有如下设置项:
color:元组,元素为字符串颜色序列,设置对应图表节点的颜色;
width:数值,设置线条宽度;
dash:线条格式,包括:dash(虚短线)、dot(虚点)、dashdot(短线和点);
shape:进行数据点的插值设置,即根据已有的零散数据点,找到一条满足一定条件的曲线,使之经过全部的数据点。共有6种插值方式:'linear'、'spline'、'hv'、'vh'、'hvh'和'vhv。
marker:数据节点参数,包括大小、颜色、格式等,有如下设置项:
size:列表,元素为相应节点的尺寸大小;
sizeref:缩放的比例,如设置为2,则缩小为原来的1/2;
sizemode:缩放的标准,默认以diameter(直径)缩放,也可选择以area(面积)缩放;
mode:图形格式,包括lines(线形图)、markers(散点图)、text(文本)。使用 + 或 none 等符号进行模式组合;
name:名称参数;
opacity:透明度参数,取值范围0~1,表示相应节点的透明度;
rsrc、xsrc、ysrc、tsrc、idssrc、textsrc、textpositionsrc:字符串源数组列表,作为Plotly网格标识符,用于设置特殊图表所需的r参数、x参数、y参数、t参数、ids参数、text(文本)参数、textposition(文本位置)参数等;
r、t:仅用于极坐标图,r用于设置径向坐标(半径);t用于设置角坐标;
showlegend:布尔变量,默认True,设置显示图例名称。仅一条数据时,需要显式地声明才会显示图例;
showscale:布尔变量,设置是否显示颜色跟踪条,默认为False;
stream:数据流,用于实时显示数据图表;
textfont:文本字体参数,包括字体名称、颜色、大小等;
textposition:“文本”元素的位置参数,包括:top left(左上)、top center(中上)、top right(右上)、middle left(左中)、middle center(中心)、middle right(右中)、bottom left(左下)、bottom center(中下)、bottom right(右下)模式,默认是middle center(中心)模式;
text:文本数据,元素为相应节点的悬浮文字内容;
type:数据显示模式,包括:constant(常数)、percent(百分比)、sqrt(平方根)、array(数组)模式;
x0、y0:坐标轴起点坐标;
xcalendar、ycalendar:坐标时间参数的格式,默认是公历;
x,y:设置x、y轴的坐标数据;
(三)、layout参数
title:设置图表的标题&#