uibot的easydata扩展库使用教程

easydata是一个ub命令库,它提供快速、灵活、易于使用的诸如一键读写excel、剔除空行、矩阵运算等数据挖掘功能。由于原生的ub命令在数据处理方面比较薄弱,原生的ub数组速度非常慢,使用easydata可以极大的降低你的代码量和提高代码运行速度。

命令文档

命令名称:

读取Excel工作表

功能:

读取指定工作薄、工作表中的数据,读取成 ub datatable 类型

参数说明:

文件路径:字符型,指定读取的工作薄所在路径
列头:数组型,指定读取后 datatable 的列名。默认为 "" ,不指定默认以读取数据的第一行作为列名
起始行:数值型,指定从第几行开始读取
尾部忽略行:数值型,指定工作表尾部忽略读取的行数,被忽略的行不会被读取,一般在表格尾部有无效数据时使用
工作表:数值型,指定读取工作薄中的第几张工作表
忽略空行:布尔型(true或false),指定是否忽略空行

代码示例

text.xlsx表格数据


image.png
dim data
//指定忽略空行读取
data = easydata.read_excel("text.xlsx", "", 1, 0, 1, true)
TracePrint data
//输出
  第一列 第二列 第三列 第四列
0 12 13 14 15
1 13 14 15 16
2 14 15 16 17
3 15 16 17 18
4 16 17 18 19
5 17 18 19 20
6 18 19 20 21
7 19 20 21 22
8 15 16 17 18
9 16 17 18 19
10 17 18 19 20
11 18 19 20 21
12 19 20 21 22
命令名称

写入Excel工作表

功能

根据给定路径,将 datatable 直接写入到excel工作薄

参数说明

数据表:datatable,指定需要写入的数据表
文件路径:字符型,指定写入的工作薄路径
写入方式:可选 'cover' 和 'append', 覆盖写入和追加写入
包含表头:布尔型,指定是否将datatable表头写入
工作表:数值型,指定写入第几张工作表

命令名称

数组加法

功能

数组与数值/小数相加或数组与数组相加

参数说明

基数组:数组型,指定 x+y 的 x
算数:数值、小数或数组型,指定 x+y 的 y

代码示例
dim x = [10,20,30,40]
dim y = [1,2,3,4]
dim data = easydata.array_sum(x, y)
TracePrint data
//输出
[ 11, 22, 33, 44 ]
dim x = [[10,20,30,40], [50,60,70,80]]
dim y = [[1,2,3,4], [5,6,7,8]]
dim data = easydata.array_sum(x, y)
TracePrint data
//输出
[
[ 11, 22, 33, 44 ],
[ 55, 66, 77, 88 ]
]
命令名称

数组减法

功能

数组与数值/小数相减或数组与数组相减,使用方法参考数组加法示例

命令名称

数组乘法

功能

数组与数值/小数相乘或数组与数组相乘,使用方法参考数组加法示例

命令名称

数组除法

功能

数组与数值/小数相除或数组与数组相除,使用方法参考数组加法示例

命令名称

读取数组最大值

功能

获取给定数组中的最大值

参数说明

数组:需要操作的数组

代码示例
dim x = [1,2,3,34,4]
dim data = easydata.max(x)
TracePrint data
//输出
34
命令名称

读取数组最小值

功能

获取给定数组中的最小值,使用方法参考 “获取数组最大值”

命令名称

数组求和

功能

计算一个数值型数组中所有元素之和

参数说明

数组:指定用于计算的源数组

命令名称

创建数组

功能

创建一个指定长度整数数组

参数说明

起始值:数值型,指定数组起始值
结尾值:数值型,指定数组结尾值,注意创建结果末尾值会比该参数小1
步长:大于 1 的整数

代码示例
dim data = easydata.range(1, 10, 1)
TracePrint data
//输出
[ 1, 2, 3, 4, 5, 6, 7, 8, 9 ]

dim data = easydata.range(1, 11, 2)
TracePrint data
//输出
[ 1, 3, 5, 7, 9 ]

For Each i In easydata.range(1, 5, 1)
    TracePrint '第' & i & '次循环'
Next
//输出
"第1次循环"
"第2次循环"
"第3次循环"
"第4次循环"
命令名称

创建矩阵

功能

以零初始化创建一个指定行列数的矩阵

参数说明

行数:数值型,指定行数
列数:数值型,制定列数

代码示例
//创建一个3行5列的矩阵
dim data = easydata.zeros(3,5)
traceprint data
//输出
[
[ 0.0, 0.0, 0.0, 0.0, 0.0 ],
[ 0.0, 0.0, 0.0, 0.0, 0.0 ],
[ 0.0, 0.0, 0.0, 0.0, 0.0 ]
]
命令名称

创建日期序列

功能

根据开始和结束日期生成一个连续的日期数组

参数说明

起始日期:字符型,指定起始日期
结尾日期:字符型,指定结束日期

代码示例
dim data
data = easydata.range_date("2012/01/20", "2012/01/24")
TracePrint data
//输出
[ "2012-01-20", "2012-01-21", "2012-01-22", "2012-01-23", "2012-01-24" ]

dim data
data = easydata.range_date("2012-02-25", "2012-03-01")
TracePrint data
//输出
[
"2012-02-25",
"2012-02-26",
"2012-02-27",
"2012-02-28",
"2012-02-29",
"2012-03-01"
]
命令名称

数据表转json

功能

将一个 datatable 转换成对应的json字符串

参数说明

数据表:需要操作的 datatable

代码示例
dim data, columns, objDatatable, results, Variable
//先构建数据表
data = [['a','b','c'], ['e','f','g']]
columns = ['one', 'two', 'three']
objDatatable = Datatable.BuildDataTable(data, columns)
//将数据表转换成json字符串
Variable = easydata.array_tojson(objDatatable)
TracePrint Variable

//输出
"{"one":{"0":"a","1":"e"},"two":{"0":"b","1":"f"},"three":{"0":"c","1":"g"}}"
命令名称

文本翻译

功能

把一串文本翻译成指定语言,返回翻译结果,支持语言说明:


image.png
参数说明

翻译内容:字符型,待翻译的原始文本
语言:字符型,原始文本的语言,不确定时可设置为 "auto"
翻译语言:字符型,指定翻译成哪种语言

代码示例
dim Variable
dim basetext = '我如果爱你——绝不像攀援的凌霄花,借你的高枝炫耀自己;我如果爱你——'

Variable = easydata.translation(basetext, "auto", "en")
TracePrint Variable

//输出
"If I love you, I will never show off by your high branches like the climbing skyflower; if I love you——"

你可能感兴趣的:(uibot的easydata扩展库使用教程)