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——"
