支持的函数
2.8 支持的函数
Section titled “2.8 支持的函数”在 DFF 的 TensorEval 节点中,先根据计算对象选择模式,再查对应函数:
- 数值计算:不勾选“是否Polars”,使用矩阵、向量和 RustScript 函数。
- 表格计算:勾选“是否Polars”,使用 DataFrame 整表函数和列表达式。
- 配电网分析:使用 DataFrame 脚本中的
import_*、project_*、ds_*函数。
同名函数在不同模式下可能有不同的参数和返回值。调用格式中的 ... 表示可继续提供同类参数,[,参数] 表示可选;索引向量等实际需要的方括号仍须保留。节点上传、输入连接、结果显示和多结果设置见 TensorEval 与 DataFrame,MATLAB 写法对照见从matlab迁移。
数值表达式与 RustScript 函数
Section titled “数值表达式与 RustScript 函数”本节用于 TensorEval 的数值表达式和完整 RustScript 程序。表格表达式有自己的函数集合,不能混用。函数名按表中大小写书写,索引和维度编号从 0 开始;字符串使用反引号,例如 `message`。
基础数值函数处理标量、向量和矩阵;各函数允许的输入形状见下表。线性代数、方程求解、优化与结构体函数需要安装对应计算功能包。日志、文件读取和符号求解函数用于完整脚本;完整脚本应有 return 返回数值结果。
基本计算、三角与复数
Section titled “基本计算、三角与复数”| 调用 | 含义 |
|---|---|
abs(x) | 逐元素绝对值;复数取模。 |
sqrt(x)、exp(x)、ln(x)、log10(x) | 逐元素平方根、自然指数、自然对数、常用对数。 |
floor(x)、ceil(x)、round(x)、signum(x) | 逐元素向下取整、向上取整、四舍五入、取符号;复数取整只处理实部,复数符号为 z/abs(z)。 |
power(x,p) | 逐元素乘方,指数 p 为标量,也可写 x .^ p。 |
sin(x)、cos(x)、tan(x) | 逐元素三角函数,输入为弧度。 |
asin(x)、acos(x)、atan(x) | 逐元素反三角函数,结果为弧度。 |
sinh(x)、cosh(x)、tanh(x)、asinh(x)、acosh(x)、atanh(x) | 双曲函数与反双曲函数。 |
atan2(y,x) | 两个标量确定四象限角,结果为弧度;复数参数只使用实部。 |
deg2rad(x)、rad2deg(x) | 逐元素角度转弧度、弧度转角度。 |
c(real,imag) | 两个标量构造复数,例如 c(3,4)。 |
c1(r,theta)、c2(r,theta) | 用模与相角构造复数;c1 的相角为弧度,c2 为角度。仅接收标量。 |
real(x)、imag(x)、conj(x)、angle(x) | 逐元素取实部、虚部、共轭、相角;相角为弧度。 |
rad(z) | 取复数标量的相角,例如 rad(c(3,4));数组和实数使用 angle(x)。 |
transpose(A)、ctranspose(A) | 普通转置、共轭转置;一维向量转为列向量。A' 也是普通转置。 |
rand()、rand2(lower,upper) | 生成 [0,1) 或 [lower,upper) 内的随机标量;后者要求 lower<upper。 |
rad 不是角度转弧度函数。实数负值不会因调用 sqrt、ln 等自动变成复数,需先明确构造复数输入。常量可用 pi/PI、e、eps、NAN、INF、NEG_INF;未被同名变量覆盖时,i、j 表示虚数单位。
创建、拼接与形状
Section titled “创建、拼接与形状”| 调用 | 含义 |
|---|---|
zeros(n)、ones(n) | 长度为 n 的一维全零、全一向量。 |
zeros(m,n,...)、ones(m,n,...) | 按各轴长度创建数组;也可写 zeros([m,n,...])、ones([m,n,...])。 |
eye(n) | n×n 单位矩阵,n 为正整数。 |
range(start,end)、range(start,end,step) | 不包含 end 的数列,默认步长 1;下降数列给负步长,步长不能为零。 |
horzcat(A,B,...)、vertcat(A,B,...) | 水平、垂直拼接,其他方向尺寸须一致。 |
blockcat(r,c,A11,A12,...,A21,...) | 按行排列各块,拼成 r 个块行、c 个块列;块数须等于 r*c。 |
ndim(A)、length(A) | 维数、最长轴长度;length 不是元素总数。 |
size(A)、size(A,axis) | 返回各轴长度或指定轴长度,axis 从 0 开始。 |
zeros(3) 是三个元素的一维向量;三阶方阵写 zeros(3,3)。range(0,5) 得到 [0,1,2,3,4],不支持单参数 range(n)。size 用于数组,size(标量) 不接受,size([]) 返回 0。
读取与更新数组
Section titled “读取与更新数组”| 调用 | 含义 |
|---|---|
get(v,i)、get(A,i,j)、get(A,[i,j,...]) | 按各维坐标读取一个元素;矩阵不能只给一个标量索引。 |
get_multi(A,[k1,k2,...]) | 按行主序扁平位置读取多项,返回一维向量;也支持多个位置参数 get_multi(A,k1,k2,...),推荐统一用索引向量。 |
select(A,rows)、select(A,rows,cols) | 读取二维子矩阵。行列可为单个索引或索引向量,[] 表示该方向全部,省略列参数表示全部列。 |
slice(A,spec0,spec1,...) | 按每个维度的切片描述读取数组。 |
A=select_assign(A,value,rows,cols) | 返回替换指定行列后的二维矩阵,支持稠密与稀疏矩阵;值可为标量或元素数匹配的数组。 |
A=set(A,[k1,k2,...],values) | 按扁平位置覆盖并返回新值;单个位置也写 [k]。 |
A=set2(A,[k1,k2,...],values) | 按扁平位置累加并返回新值;重复位置会重复累加。 |
A=assign(A,value,spec0,spec1,...) | 对稠密数组按切片赋值并返回新值,参数顺序为原数组、替换值、各维切片。 |
所有更新函数都要接收返回值。以下 i、j 已是从0开始的脚本下标,单点更新可以写为:
A=select_assign(A,v,[i],[j]);也可用行主序位置更新,size(A,1) 是列数:
A=set(A,[i*size(A,1)+j],v);稠密二维数组的单点更新也可写 A=assign(A,v,i,j);稀疏矩阵更新使用 select_assign 或 set。
稠密 slice/assign 的每个 spec 可写为:单个索引 i、从起点到末尾 [start]、半开范围 [start,end]、带步长范围 [start,end,step]。单个索引会消去该轴;稠密切片中的 [] 表示增加轴,不能当作全部元素。二维全范围可写 slice(A,[0],[0])。稀疏 slice 的 [] 才表示全部,且不支持负索引和负步长。
汇总、判断与查找
Section titled “汇总、判断与查找”| 调用 | 含义 |
|---|---|
sum_all(x) | 所有元素求和。 |
sum(x)、sum(x,axis) | 默认或按指定轴求和;稠密数组还支持递增轴列表,如 sum(x,[0,1])。 |
max(a,b,...)、min(a,b,...) | 多个实数标量取最大、最小值。 |
max(A)、min(A) | 数组中取一个极值元素;复数按实部比较。稠密数组可附各维切片描述。 |
max_im(A)、min_im(A) | 按虚部选择元素,返回原复数。 |
max_abs(A) | 按模选择最大元素,返回原复数。 |
any(A)、any(A,axis) | 检查是否有非零项,返回 0/1 或归约数组。 |
find(A) | 对稠密数组返回显著非零项的行主序扁平位置;约小于 10*eps 的项会被忽略。 |
find_nearest(A,target) | 返回距目标标量最近的值;复数按复平面距离比较,并列时取首个。 |
find_nearest_pos(A,target) | 返回最近值的零基各维坐标:一维为 [i],二维为 [row,col]。 |
is_empty(A)、is_inf(A) | 数值容器是否为空、逐元素是否为无穷;返回 0/1。 |
稠密 sum、any 默认对矩阵的第 0 轴归约;一维向量和列向量默认得到标量。max(A)、min(A) 返回整个数组中的一个元素,不是逐列结果。最近值查找前应确认数组非空。
| 调用 | 含义 |
|---|---|
sparse(rows,cols,values,m,n) | 按零基行列坐标创建 m×n 稀疏矩阵。 |
issparse(A) | 是否为稀疏矩阵,返回 0/1。 |
full(S) | 把稀疏矩阵展开为稠密矩阵。 |
diag(v)、diag(A) | 稠密向量构造对角矩阵,稠密矩阵提取主对角线。 |
sparse 必须接收五个参数。行列坐标数组等长;值可为标量广播或等长数组。重复坐标的值相加,零值不存储。没有 sparse(A) 的稠密转稀疏调用。
稀疏矩阵的部分函数有独立约定:get(S,i,j) 只读取实际存储项,读取隐含零使用 get_multi(S,[i*size(S,1)+j]);find(S) 返回筛选后的同形稀疏矩阵;diag(S) 返回只保留对角项的同形稀疏矩阵。max/min、按虚部或模取极值、最近值查找只比较存储项。sum(S) 是全部元素之和,sum(S,0) 是列和,sum(S,1) 是行和;any(S,0) 按行检查,any(S,1) 按列检查。
线性代数:需要计算功能包
Section titled “线性代数:需要计算功能包”| 调用 | 含义 |
|---|---|
trace(A)、det(A) | 方阵的迹、行列式;trace 支持稀疏方阵,稀疏行列式先用 full。 |
norm_l1(x)、norm_l2(x)、norm_max(x) | 各元素绝对值之和、平方和开方、最大绝对值;矩阵按全部元素计算。 |
svd(A)、rank(A) | 稠密数组的奇异值、默认容差下的秩;svd 只返回奇异值。 |
eig(A) | 稠密方阵的特征分解,结果首列为特征值,其余列为特征向量。 |
linsolve(A,b) | 求解 A*x=b,直接返回解;支持稠密、稀疏与实数、复数。 |
linsolve_t(A,b)、linsolve_h(A,b) | 分别求解转置、共轭转置系数矩阵的线性方程。 |
linsolve 系列还可接收两张等长的后端参数向量,例如 linsolve(A,b,parameter_indices,parameter_values);普通模型使用前两个参数即可。矩阵左除可写 A\b,求逆写 A^-1,同样要求相应计算功能。
方程与优化:需要求解功能包和完整脚本
Section titled “方程与优化:需要求解功能包和完整脚本”| 调用 | 含义 |
|---|---|
sp_linsolve(left,b,initial,names) | 符号式线性方程求解;left 是左端,b 是右端;b=[]、initial=[] 补零;返回一个 [x...,status] 向量。 |
fsolve(residuals,names)、fsolve(residuals,initial,names) | 符号式非线性残差方程求解,残差默认等于零;返回一个 [x...,status] 向量。 |
intlinprog(objective,constraints,types,names) | 符号式混合整数线性规划;也可在 types 前加入 lower,upper;返回一个 [x...,objective,status] 向量。 |
fmincon(objective,g,g_lower,g_upper,x_lower,x_upper,names) | 符号式非线性优化;可在末尾增加初值、或参数键列表与参数值列表、或同时增加两者;返回一个 [x...,objective,status] 向量。 |
[x,fval,exitflag,output,lambda]=fmincon(fun,x0,A,b,Aeq,beq,lb,ub,nonlcon,options) | 回调式非线性最小化;末尾参数可省略,中间空位置用 []。返回五个独立对象。 |
optimoptions(`fmincon`,`OptionName`,value,...) | 创建回调式 fmincon 选项,例如 optimoptions(`fmincon`,`MaxIterations`,100)。 |
符号未知量保留为表达式,例如 [`x`,`y`],不要提前代入常数。intlinprog 的类型码为 1=0/1、2=整数、3=连续实数;目标可用 min(expr)、max(expr),约束可用 <=、>=、==。符号模型的列表长度应与变量或约束数量对应。
回调式 fmincon 要求 fun(x) 返回 (f,gradient);有非线性约束时,nonlcon(x) 返回 (c,ceq,GC,GCeq)。梯度不能省略。output、lambda 是结构体,取出需要的数值字段后再返回报表。optimoptions 只用于此回调接口,算法选项仅支持 interior-point、ipopt。常用选项 MaxIterations、OptimalityTolerance、ConstraintTolerance、Display 分别对应 max_iter、tol、constr_viol_tol、print_level。
sp_linsolve、fsolve 的成功状态是末项 0;其他优化接口的状态约定不同,应按求解器与回调检查,不要只用解是否非零判断成功。
结构体、日志与文件
Section titled “结构体、日志与文件”结构体与通用空值检查函数随求解功能包提供:
| 调用 | 含义 |
|---|---|
struct()、struct(`name`,value,...) | 创建结构体;字段名与值成对出现。 |
getfield(s,`name`) | 读取字段,字段不存在时报错。 |
s=setfield(s,`name`,value) | 返回加入或替换字段后的结构体。 |
isfield(s,`name`)、isstruct(value) | 检查字段是否存在、值是否为结构体,返回脚本布尔值。 |
isempty(value) | 检查空值、空字符串、空结构、空数组或空数值容器;不是 is_empty 的别名。 |
普通完整脚本与混合图内嵌脚本均可使用以下日志函数:
| 调用 | 含义 |
|---|---|
println(`message`,value,...) | 输出文本、数值或表达式。 |
debug(value,...)、info(value,...)、warn(value,...) | 按对应级别记录运行日志。 |
error(`message`) | 有求解功能包时中止脚本并报告错误;未提供该功能包时只记录错误级别日志。 |
monotonic_ms() | 进程内相对毫秒,可用于计算耗时;不是日期时间戳。 |
文件与网络读取仅用于普通完整脚本,混合图内嵌脚本不提供:
| 调用 | 含义 |
|---|---|
read_tensor(`server_path`) | 读取服务可访问的数值文件。 |
read_tensor_url(`url`) | 从 URL 读取数值文件,要求服务端可访问该地址。 |
读取支持 xls/xlsx/parquet/csv;其他扩展名按数值表达式文本尝试读取,失败返回空值。服务路径不是浏览器本机路径;浏览器上传的数据通过源节点与入边传入数值脚本。
极值计算与结果导出
Section titled “极值计算与结果导出”求最小模值时,用 min(abs(A)),结果是模值而非原复数元素;稀疏矩阵若需计入隐含零,先用 full 展开。当前不使用 min_abs(A) 处理数组,它可能返回错误的零值。结果导出使用 WriteFile 边。
数值入口没有 all/chol/cond/inv/linspace/log/mean/median/nnz/numel/qr/repmat/reshape/spy/std/tril/triu/var 这些函数名;不要根据 MATLAB 或 Python 同名函数推断支持。表格表达式里的聚合函数按其自身规则使用。
DataFrame 整表函数
Section titled “DataFrame 整表函数”在 TensorEval 节点勾选“是否Polars”后,使用本节函数。整表函数处理整张表;列表达式写在 select、with_columns、agg 等函数内部。它们采用 MEMS 的调用格式。
下表以 df 表示输入表,x/y 表示列表达式,name 表示列名。字符串使用双引号,例如 col("value")、cast(col("value"), "f64")。含可选参数的完整形式见相应表格。
选列、分组与清理
Section titled “选列、分组与清理”| 函数 | 调用格式 | 用途 |
|---|---|---|
select | select(expr, ..., df) | 选择列或计算新结果列 |
filter | filter(expr, ..., predicate, df) | 先按条件筛行,再输出前面的表达式列 |
with_column / withcolumn | with_column(expr, df) | 新增或替换一列 |
with_columns / withcolumns | with_columns(expr, ..., df) | 新增或替换多列 |
group_by / groupby | group_by(key, ..., df) | 按键分组,其余列收集为列表 |
agg / aggregate | agg(group_by(key, ...), expr, ..., df) | 按键分组后计算聚合结果 |
rename / rename_columns | rename(old_names, new_names, df) | 按等长的新旧名称列表重命名列 |
drop_nulls / dropnulls | drop_nulls(df) | 删除含 null 的行 |
drop_nans / dropnans | drop_nans(df) | 删除含 NaN 的行 |
fill_null / fillnull | fill_null(value, df) | 填充 null |
fill_nan / fillnan | fill_nan(value, df) | 填充 NaN |
cast_all / castall | cast_all(dtype, df) | 把全部列转为同一类型 |
filter 中最后一个列表达式是条件,前面列出需要保留的结果列。agg 的第一项必须写成 group_by(...),其中不再放输入表。rename 可写单个名称或名称数组,旧列也可用从 0 开始的列序号。整表 drop_nulls/drop_nans 检查全表,没有指定列子集的参数。
行序、计数与统计
Section titled “行序、计数与统计”| 函数 | 调用格式 | 用途 |
|---|---|---|
height / width | height(df) / width(df) | 取得行数或列数,返回可供后续计算的标量 |
count / null_count(别名 nullcount) | count(df) / null_count(df) | 按列统计非 null 数量或 null 数量 |
first / last / reverse | first(df) / last(df) / reverse(df) | 取首行、末行或反转行序 |
limit / tail | limit(n, df) / tail(n, df) | 取前 n 行或后 n 行 |
sum / max / min / mean / median | sum(df) 等,均接收一张表 | 按列求和、最大值、最小值、均值或中位数 |
shift | shift(periods, df) | 沿行移动,空出位置补 null |
shift_and_fill / shiftandfill | shift_and_fill(fill_value, periods, df) | 沿行移动并填充空出位置 |
n 使用非负整数,periods 使用整数。height/width 的结果应作为中间参数,最终报表仍需返回表。标准差和方差通过下节的 std/var 列表达式计算。
连接、拼接与变形
Section titled “连接、拼接与变形”| 函数 | 调用格式 | 用途 |
|---|---|---|
join | join(left, right, left_keys, right_keys, how) | 按键连接两张表 |
sort | sort(by, descending, maintain_order, df) | 按一列或多列排序 |
concat | concat(how, df1, df2, ...) | 拼接多张表 |
pivot | pivot(on, index, values, aggregate_expr, maintain_order, separator, df) | 把分类值展开成列 |
unpivot | unpivot(on, index, df) | 把多列收拢成长表 |
import_df_url | import_df_url(url) | 从 HTTP/HTTPS 地址读取表格数据 |
join 的 how 仅支持 "inner"、"full"、"left"、"right"。键、排序列及透视列可用名称数组,例如 ["id", "phase"]。连接后如需固定顺序,再显式排序。
sort 的 descending 用 "false" 表示升序、"true" 表示降序;多列可提供一个公共方向,或与排序列等长的方向数组。maintain_order="true" 保持同键记录的原顺序。
concat 的 how 使用 "vertical" 纵向叠加、"horizontal" 横向拼接或 "diagonal" 按列名对齐叠加。横向拼接前应核对行数和行序;纵向拼接前应核对列与类型。pivot 的聚合表达式可使用 sum(element()) 等,按分组后的值进行计算。
selected = select(col("id"), col("value"), input);positive = filter(col("id"), col("value"), col("value") > 0, selected);result = sort("id", "false", "true", positive);边的 Eval 动作隐含提供一张输入表,常用单表调用可省去最后的表参数,例如 select(col("value"))、drop_nans()。这里使用单表变换;多表连接、拼接、透视、URL 读取及配电网分析放在 TensorEval 脚本中。height/width 也放在脚本中使用。
DataFrame 列表达式
Section titled “DataFrame 列表达式”列表达式放在整表函数内部。例如 select(alias(cast(col("value"), "f64"), "analog"), input) 先取列、转换类型并命名,再组成结果表。col/cols/all/cast/alias、均值、中位数和方差等函数属于本模式;不要把这些调用直接写入普通数值张量表达式。
| 函数 | 调用格式 | 用途 |
|---|---|---|
col | col(name) | 引用一个列名 |
cols | cols(name, ...) | 引用多个列名 |
all | all() | 选择全部列 |
alias | alias(x, name) | 为表达式结果指定列名 |
cast | cast(x, dtype) | 转换表达式的数据类型 |
element | element() | 引用透视聚合中的当前值 |
pi | pi() | 圆周率常量 |
列名和类型名都使用双引号。常用类型为 "i8"/"i16"/"i32"/"i64"、"u8"/"u16"/"u32"/"u64"、"f32"/"f64"、"str"、"bool"、"date"、"time"。all() 选择全部列,也可写 col("*")。
比较与缺失值
Section titled “比较与缺失值”| 函数 | 调用格式 | 用途 |
|---|---|---|
not | not(x) | 逻辑取反 |
eq / eq_missing / neq / neq_missing / lt / gt / lt_eq / gt_eq | eq(x, y) 等,均为两个参数 | 相等、不等及大小比较 |
not_null / is_null / not_nan / is_nan | not_null(x) / is_null(x) / not_nan(x) / is_nan(x) | 判断 null 或 NaN |
drop_nulls / drop_nans | drop_nulls(x) / drop_nans(x) | 删除表达式中的 null 或 NaN |
when_then_otherwise | when_then_otherwise(condition, yes, no) | 按条件选择两个表达式的值 |
eq_missing/neq_missing 把 null 也作为可比较值;其余比较可写常用的 ==、!=、<、<=、>、>=。null 与 NaN 应分别检查。
计数、统计与去重
Section titled “计数、统计与去重”| 函数 | 调用格式 | 用途 |
|---|---|---|
count / null_count / len | count(x) / null_count(x) / len(x) | 统计非 null 数量、null 数量或总长度 |
sum / min / max / mean / avg / median | sum(x) / min(x) / max(x) / mean(x) / avg(x) / median(x) | 求和、极值、均值、中位数 |
nan_min / nan_max | nan_min(x) / nan_max(x) | 保留 NaN 传播语义的极值 |
std / var | std(x, ddof) / var(x, ddof) | 标准差或方差 |
n_unique / unique / arg_unique | n_unique(x) / unique(x) / arg_unique(x) | 不同值数量、去重值或首次唯一值位置 |
arg_min / arg_max | arg_min(x) / arg_max(x) | 最小值或最大值的位置 |
is_unique / is_duplicated | is_unique(x) / is_duplicated(x) | 逐元素标记唯一值或重复值 |
any_horizontal / min_horizontal / max_horizontal / sum_horizontal | any_horizontal(xs) / min_horizontal(xs) / max_horizontal(xs) / sum_horizontal(xs) | 按行计算任一真、最小、最大或总和 |
dot | dot(x, y) | 两个表达式的点积 |
std/var 的 ddof 必填,通常取 0 或 1。当前横向统计只接收一个表达式参数;多列使用 sum_horizontal(cols("a", "b")) 这样的选择器形式。unique 不保证保持原顺序。
顺序、截取与累计
Section titled “顺序、截取与累计”| 函数 | 调用格式 | 用途 |
|---|---|---|
sort / filter | sort(x, descending) / filter(x, predicate) | 排序或筛选单个表达式的值 |
reverse / first / last | reverse(x) / first(x) / last(x) | 反转、取首值或取末值 |
head / tail | head(x, n) / tail(x, n) | 取表达式前 n 个或后 n 个值 |
shift | shift(x, periods) | 沿行移动表达式 |
shift_and_fill | shift_and_fill(x, periods, fill_value) | 移动并填充表达式 |
cum_count / cum_sum / cum_min / cum_max / cum_prod | cum_count(x, reverse) 等,均为两个参数 | 累计计数、和、最小值、最大值或乘积 |
arange | arange(start, end[, step[, dtype]]) | 构造整数序列 |
head/tail 的 n、shift 的 periods 使用数字字面量。累计函数的 reverse="false" 为正向、"true" 为反向。arange 默认步长为 1、类型为 "i32"。列表达式 shift_and_fill 的顺序是“表达式、位移、填充值”,与整表版本不同;优先用于 f64 数值列。
| 函数 | 调用格式 | 用途 |
|---|---|---|
abs / exp / log1p / sqrt / cbrt / sign / floor / ceil | abs(x)、exp(x)、log1p(x)、sqrt(x)、cbrt(x)、sign(x)、floor(x)、ceil(x) | 绝对值、指数、log(1+x)、平方根、立方根、符号及向下/向上取整 |
pow / log / round | pow(x, exponent) / log(x, base) / round(x, decimals) | 幂、指定底数对数、小数位取整 |
sin / cos / tan / cot / arcsin / arccos / arctan | sin(x) 等,均为一个参数 | 三角与反三角函数 |
sinh / cosh / tanh / arcsinh / arccosh / arctanh | sinh(x) 等,均为一个参数 | 双曲与反双曲函数 |
degrees / radians | degrees(x) / radians(x) | 弧度转角度、角度转弧度 |
pow 的指数与 round 的小数位数使用数字字面量。也可使用逐元素 +、-、*、/、% 和幂运算。
| 函数 | 调用格式 | 用途 |
|---|---|---|
slice | slice(x, offset, length) | 截取字符串 |
replace | replace(x, pattern, replacement[, literal]) | 替换字符串中的首个匹配 |
contains | contains(x, pattern[, strict]) | 判断是否匹配正则表达式 |
starts_with / ends_with | starts_with(x, prefix) / ends_with(x, suffix) | 判断前缀或后缀 |
find | find(x, pattern[, strict]) | 查找正则匹配的位置 |
split | split(x, separator) | 按分隔符拆分字符串,返回列表值 |
to_lowercase / to_uppercase | to_lowercase(x) / to_uppercase(x) | 转换大小写 |
slice 截取字符串;split 按分隔符拆分后得到列表值。replace 的 literal 默认 1,按字面文本匹配;设为 0 时按正则表达式匹配。contains/find 始终使用正则表达式,strict 默认 1,遇到无效正则时报错;设为 0 时允许这类无效模式,不因此中断计算。
配电网分析函数
Section titled “配电网分析函数”以下函数用于 TensorEval 的 DataFrame 脚本,需要所使用的 MEMS 版本提供对应分析能力。完整网络表顺序、参数表和结果选择见 DSS与RSS配电网仿真及配电网分析。下表列出各项分析可用的函数,调用时按对应章节准备输入表和参数。
| 任务 | 函数 |
|---|---|
| 静态网络导入 | import_dss、import_dss_url、import_bmopf、import_bmopf_url |
| DSS 执行输入导入 | import_dss_execution、import_dss_execution_url |
| 研究表组投影 | project_dss_static_model、project_dss_execution_plan、project_dss_fault_study、project_dss_dynamic_plan、project_dss_harmonic_plan、project_dss_study_sequence |
| 静态潮流 | ds_radial_pf、ds_newton_raphson_pf |
| 准静态时序 | ds_radial_qsts、ds_newton_raphson_qsts |
| DSS 潮流与时序命令流 | ds_radial_dss_plan、ds_newton_raphson_dss_plan、ds_newton_raphson_dss_plan_v2、ds_radial_dss_plan_url、ds_newton_raphson_dss_plan_url、ds_newton_raphson_dss_plan_v2_url |
| 已投影的执行计划 | ds_radial_execution_plan、ds_newton_raphson_execution_plan、ds_newton_raphson_execution_plan_v2 |
| 谐波 | ds_harmonic_study、ds_harmonic_execution_plan、ds_dss_harmonic_plan |
| 短路 | ds_fault_study、ds_dss_fault_study |
| 状态估计 | ds_wls_se、ds_mnmr_se、ds_mce_se |
| 随机场景与回放 | ds_monte_carlo |
| 故障后恢复 | ds_restore |
| 故障定位 | ds_fault_location |
| 保护配合检查 | ds_protection_coordination |
| RMS/相量动态 | ds_motor_dynamics、ds_network_dynamics、ds_dss_dynamic_plan |
| 自动添加与可靠性 | ds_dss_auto_add、ds_dss_relcalc |
| 多研究顺序执行 | ds_dss_study_sequence、ds_study_sequence |
import_* 和 project_* 均只接收一个参数,返回按位置排列的输入表组。本地入口接收路径,名称带 _url 的入口接收 URL;URL 只接受 HTTP/HTTPS,DSS 和 BMOPF 分别使用 .dss 和 .json 内容。
ds_radial_dss_plan、ds_newton_raphson_dss_plan 及其 v2、URL 版本接收模型位置,并可追加结果选择字符串或参数表。ds_dss_fault_study/harmonic_plan/auto_add/relcalc/dynamic_plan/study_sequence 使用 (path, selector_or_para),需要指定依赖文件根目录时使用 (path, source_root, selector_or_para)。
多表返回使用 [a, b] = function(...) 按位置接收,数量与返回结果一致;_ 丢弃该位置。节点最终输出多张表时,还需开启 Multi-returns 并填写等量名称。与 OpenDSS 结果比较时,参数表设置 line_model="exact"。运行后先检查诊断、收敛和供电状态,再使用数值结果。