跳转到内容

支持的函数

在 DFF 的 TensorEval 节点中,先根据计算对象选择模式,再查对应函数:

  • 数值计算:不勾选“是否Polars”,使用矩阵、向量和 RustScript 函数。
  • 表格计算:勾选“是否Polars”,使用 DataFrame 整表函数和列表达式。
  • 配电网分析:使用 DataFrame 脚本中的 import_*、project_*、ds_* 函数。

同名函数在不同模式下可能有不同的参数和返回值。调用格式中的 ... 表示可继续提供同类参数,[,参数] 表示可选;索引向量等实际需要的方括号仍须保留。节点上传、输入连接、结果显示和多结果设置见 TensorEval 与 DataFrame,MATLAB 写法对照见从matlab迁移。

本节用于 TensorEval 的数值表达式和完整 RustScript 程序。表格表达式有自己的函数集合,不能混用。函数名按表中大小写书写,索引和维度编号从 0 开始;字符串使用反引号,例如 `message`。

基础数值函数处理标量、向量和矩阵;各函数允许的输入形状见下表。线性代数、方程求解、优化与结构体函数需要安装对应计算功能包。日志、文件读取和符号求解函数用于完整脚本;完整脚本应有 return 返回数值结果。

调用含义
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 表示虚数单位。

调用含义
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。

调用含义
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 的 [] 才表示全部,且不支持负索引和负步长。

调用含义
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) 按列检查。

调用含义
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;其他优化接口的状态约定不同,应按求解器与回调检查,不要只用解是否非零判断成功。

结构体与通用空值检查函数随求解功能包提供:

调用含义
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;其他扩展名按数值表达式文本尝试读取,失败返回空值。服务路径不是浏览器本机路径;浏览器上传的数据通过源节点与入边传入数值脚本。

求最小模值时,用 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 同名函数推断支持。表格表达式里的聚合函数按其自身规则使用。

在 TensorEval 节点勾选“是否Polars”后,使用本节函数。整表函数处理整张表;列表达式写在 select、with_columns、agg 等函数内部。它们采用 MEMS 的调用格式。

下表以 df 表示输入表,x/y 表示列表达式,name 表示列名。字符串使用双引号,例如 col("value")、cast(col("value"), "f64")。含可选参数的完整形式见相应表格。

函数调用格式用途
selectselect(expr, ..., df)选择列或计算新结果列
filterfilter(expr, ..., predicate, df)先按条件筛行,再输出前面的表达式列
with_column / withcolumnwith_column(expr, df)新增或替换一列
with_columns / withcolumnswith_columns(expr, ..., df)新增或替换多列
group_by / groupbygroup_by(key, ..., df)按键分组,其余列收集为列表
agg / aggregateagg(group_by(key, ...), expr, ..., df)按键分组后计算聚合结果
rename / rename_columnsrename(old_names, new_names, df)按等长的新旧名称列表重命名列
drop_nulls / dropnullsdrop_nulls(df)删除含 null 的行
drop_nans / dropnansdrop_nans(df)删除含 NaN 的行
fill_null / fillnullfill_null(value, df)填充 null
fill_nan / fillnanfill_nan(value, df)填充 NaN
cast_all / castallcast_all(dtype, df)把全部列转为同一类型

filter 中最后一个列表达式是条件,前面列出需要保留的结果列。agg 的第一项必须写成 group_by(...),其中不再放输入表。rename 可写单个名称或名称数组,旧列也可用从 0 开始的列序号。整表 drop_nulls/drop_nans 检查全表,没有指定列子集的参数。

函数调用格式用途
height / widthheight(df) / width(df)取得行数或列数,返回可供后续计算的标量
count / null_count(别名 nullcount)count(df) / null_count(df)按列统计非 null 数量或 null 数量
first / last / reversefirst(df) / last(df) / reverse(df)取首行、末行或反转行序
limit / taillimit(n, df) / tail(n, df)取前 n 行或后 n 行
sum / max / min / mean / mediansum(df) 等,均接收一张表按列求和、最大值、最小值、均值或中位数
shiftshift(periods, df)沿行移动,空出位置补 null
shift_and_fill / shiftandfillshift_and_fill(fill_value, periods, df)沿行移动并填充空出位置

n 使用非负整数,periods 使用整数。height/width 的结果应作为中间参数,最终报表仍需返回表。标准差和方差通过下节的 std/var 列表达式计算。

函数调用格式用途
joinjoin(left, right, left_keys, right_keys, how)按键连接两张表
sortsort(by, descending, maintain_order, df)按一列或多列排序
concatconcat(how, df1, df2, ...)拼接多张表
pivotpivot(on, index, values, aggregate_expr, maintain_order, separator, df)把分类值展开成列
unpivotunpivot(on, index, df)把多列收拢成长表
import_df_urlimport_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 也放在脚本中使用。

列表达式放在整表函数内部。例如 select(alias(cast(col("value"), "f64"), "analog"), input) 先取列、转换类型并命名,再组成结果表。col/cols/all/cast/alias、均值、中位数和方差等函数属于本模式;不要把这些调用直接写入普通数值张量表达式。

函数调用格式用途
colcol(name)引用一个列名
colscols(name, ...)引用多个列名
allall()选择全部列
aliasalias(x, name)为表达式结果指定列名
castcast(x, dtype)转换表达式的数据类型
elementelement()引用透视聚合中的当前值
pipi()圆周率常量

列名和类型名都使用双引号。常用类型为 "i8"/"i16"/"i32"/"i64"、"u8"/"u16"/"u32"/"u64"、"f32"/"f64"、"str"、"bool"、"date"、"time"。all() 选择全部列,也可写 col("*")。

函数调用格式用途
notnot(x)逻辑取反
eq / eq_missing / neq / neq_missing / lt / gt / lt_eq / gt_eqeq(x, y) 等,均为两个参数相等、不等及大小比较
not_null / is_null / not_nan / is_nannot_null(x) / is_null(x) / not_nan(x) / is_nan(x)判断 null 或 NaN
drop_nulls / drop_nansdrop_nulls(x) / drop_nans(x)删除表达式中的 null 或 NaN
when_then_otherwisewhen_then_otherwise(condition, yes, no)按条件选择两个表达式的值

eq_missing/neq_missing 把 null 也作为可比较值;其余比较可写常用的 ==、!=、<、<=、>、>=。null 与 NaN 应分别检查。

函数调用格式用途
count / null_count / lencount(x) / null_count(x) / len(x)统计非 null 数量、null 数量或总长度
sum / min / max / mean / avg / mediansum(x) / min(x) / max(x) / mean(x) / avg(x) / median(x)求和、极值、均值、中位数
nan_min / nan_maxnan_min(x) / nan_max(x)保留 NaN 传播语义的极值
std / varstd(x, ddof) / var(x, ddof)标准差或方差
n_unique / unique / arg_uniquen_unique(x) / unique(x) / arg_unique(x)不同值数量、去重值或首次唯一值位置
arg_min / arg_maxarg_min(x) / arg_max(x)最小值或最大值的位置
is_unique / is_duplicatedis_unique(x) / is_duplicated(x)逐元素标记唯一值或重复值
any_horizontal / min_horizontal / max_horizontal / sum_horizontalany_horizontal(xs) / min_horizontal(xs) / max_horizontal(xs) / sum_horizontal(xs)按行计算任一真、最小、最大或总和
dotdot(x, y)两个表达式的点积

std/var 的 ddof 必填,通常取 0 或 1。当前横向统计只接收一个表达式参数;多列使用 sum_horizontal(cols("a", "b")) 这样的选择器形式。unique 不保证保持原顺序。

函数调用格式用途
sort / filtersort(x, descending) / filter(x, predicate)排序或筛选单个表达式的值
reverse / first / lastreverse(x) / first(x) / last(x)反转、取首值或取末值
head / tailhead(x, n) / tail(x, n)取表达式前 n 个或后 n 个值
shiftshift(x, periods)沿行移动表达式
shift_and_fillshift_and_fill(x, periods, fill_value)移动并填充表达式
cum_count / cum_sum / cum_min / cum_max / cum_prodcum_count(x, reverse) 等,均为两个参数累计计数、和、最小值、最大值或乘积
arangearange(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 / ceilabs(x)、exp(x)、log1p(x)、sqrt(x)、cbrt(x)、sign(x)、floor(x)、ceil(x)绝对值、指数、log(1+x)、平方根、立方根、符号及向下/向上取整
pow / log / roundpow(x, exponent) / log(x, base) / round(x, decimals)幂、指定底数对数、小数位取整
sin / cos / tan / cot / arcsin / arccos / arctansin(x) 等,均为一个参数三角与反三角函数
sinh / cosh / tanh / arcsinh / arccosh / arctanhsinh(x) 等,均为一个参数双曲与反双曲函数
degrees / radiansdegrees(x) / radians(x)弧度转角度、角度转弧度

pow 的指数与 round 的小数位数使用数字字面量。也可使用逐元素 +、-、*、/、% 和幂运算。

函数调用格式用途
sliceslice(x, offset, length)截取字符串
replacereplace(x, pattern, replacement[, literal])替换字符串中的首个匹配
containscontains(x, pattern[, strict])判断是否匹配正则表达式
starts_with / ends_withstarts_with(x, prefix) / ends_with(x, suffix)判断前缀或后缀
findfind(x, pattern[, strict])查找正则匹配的位置
splitsplit(x, separator)按分隔符拆分字符串,返回列表值
to_lowercase / to_uppercaseto_lowercase(x) / to_uppercase(x)转换大小写

slice 截取字符串;split 按分隔符拆分后得到列表值。replace 的 literal 默认 1,按字面文本匹配;设为 0 时按正则表达式匹配。contains/find 始终使用正则表达式,strict 默认 1,遇到无效正则时报错;设为 0 时允许这类无效模式,不因此中断计算。

以下函数用于 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"。运行后先检查诊断、收敛和供电状态,再使用数值结果。