GP

通过该插件可以对 DolphinDB 的 vector 和 table 中的数据进行画图,并保存文件到本地。

在插件市场安装插件

  1. 在 DolphinDB 客户端中使用 listRemotePlugins 命令查看插件仓库中的插件信息。

    login("admin", "123456")
    listRemotePlugins()
  2. 使用 installPlugin 命令完成插件安装。其中,由于amdQuote 插件版本较多,需要在指定插件名称的同时指定插件版本。例如:

    installPlugin("gp")
  3. 使用 loadPlugin 命令加载插件。

    loadPlugin("gp")

用户接口

gp::plot

语法

gp::plot(data, style, path, [props])

详情

使用 DolphinDB 中的数据进行画图,并以 eps 的文件格式保存到本地。

参数

  • data:画图数据。一个向量、由向量组成的 tuple 或一个表。若为表,则用其第一列和第二列分别表示 x 轴、y 轴数据。支持对 CHAR, SHORT, INT, LONG, FLOAT, DOUBLE, DATE, MINUTE, SECOND, DATETIME, DATEHOUR 类型的数据画图。

  • style:字符串,表示画图的样式。包含以下值:"line", "point", "linesoint", "impulses", "dots", "step", "errorbars", "histogram", "boxes", "boxerrorbars", "ellipses", "circles"。

  • path:字符串,表示保存图片的路径。

  • props:字典,表示画图特性。包含以下键值:

    • title:字符串标量或向量,表示每个数据组的标识。
    • xRange:数值型向量,表示图片的 X 轴范围。为数值类型的向量,包含两个元素。
    • yRange:图片的 Y 轴范围。为数值类型的向量,包含两个元素。
    • xLabel:字符串,表示 X 轴标签。
    • yLabel:字符串,表示 Y 轴标签。
    • size:图片比例,1为初始长度。为数值类型的向量,包含两个元素,表示长和宽的比列。
    • xTics:数值型标量,表示 X 轴的单位间隔。
    • yTics:数值型标量,表示 Y 轴的单位间隔。

    以下属性可以设置每个独立图像的特性。

    • lineColor:字符串标量或向量,表示线条颜色。包含以下值:"black", "red", "green", "blue", "cyan", "magenta", "yellow", "navy", "purple", "olive", "orange", "violet", "pink", "white", "gray"。
    • lineWidth:数值型标量或向量,表示线条宽度。
    • pointType:整型标量或向量,表示画点的形状。取值为0到13。
    • pointSize:数值型标量或向量,表示点的大小。
    • smooth:字符串标量或向量,表示数据平滑程度。可以为 "csplines" 或者是 "bezier"。

返回值

例子

data=(rand(20,20),rand(20,20),rand(20,20),rand(20,20),rand(20,20),rand(20,20),rand(20,20),rand(20,20),rand(20,20),rand(20,20),rand(20,20),rand(20,20),rand(20,20),rand(20,20),rand(20,20))
prop=dict(STRING,ANY)
prop[`lineColor]=["black", "red", "green", "blue", "cyan", "magenta", "yellow", "navy", "purple", "olive",  "orange", "violet", "pink", "white", "gray"]
prop["xTics"]=2
prop["yTics"]=5
prop["title"]="l"+string(1..15)
re=gp::plot(data,"line",WORK_DIR+"/test.eps",prop)
re=gp::plot(data,"line",WORK_DIR+"/test.png",prop)
re=gp::plot(data,"line",WORK_DIR+"/test.jpeg",prop)