跳转到内容

从matlab迁移

迁移已有 MATLAB 程序时,先把数值计算部分改写为 RustScript,再接入 DFF 的输入和输出。矩阵和常用运算比较接近,但下标、矩阵写法、字符串及求解函数的参数并不完全相同,不能直接把 .m 文件作为 RSS 脚本上传。

  1. 先选一个输入、输出明确的小计算,保留 MATLAB 的输入和参考结果。
  2. 按下面的规则改写,保存为 UTF-8 的 .rss 文件。在编辑模式进入“设置项 → 报表”,新建或编辑 DFF,添加 TensorEval 节点并上传脚本。
  3. 数值脚本不勾选“是否Polars”;矩阵结果勾选“是否矩阵”,对应文件参数2为 2。脚本末尾用 return 返回要查看的结果。
  4. 本机表格数据通过 Source → Data 上传,用边名称作为脚本变量;绘图改用报表的表格或图表模板。文件路径指 MEMS 服务所在计算机,不能直接照搬 MATLAB 电脑上的路径。
  5. 保存并加载流程,到“事件 → 策略”手动运行,再到“仪表盘 → 报表”选择本次记录,对照数值、形状、单位和求解状态。

只输出一个结果时,可以连接一个 None 节点作为输出节点。多结果的勾选项和名称写法见 TensorEval 与 DataFrame。函数名称与调用形式见支持的函数。

表中的 i、j 指原 MATLAB 程序的一基下标;迁移时需要减1。

MATLABRustScript说明
A = [1 2; 3 4];A = [[1,2],[3,4]];矩阵按行嵌套,元素用逗号分隔
zeros(n)、ones(n)zeros(n,n)、ones(n,n)MATLAB 单参数创建方阵;这里单参数创建一维向量
A(i,j)get(A,i-1,j-1)下标从0开始,首元素是 get(A,0,0)
A(i,j)=vA=select_assign(A,v,[i-1],[j-1]);更新函数返回新矩阵,需赋回 A
A(:,[1 3])select(A,[],[0,2])空行索引表示全部行,列号也需减1
size(A,1)、size(A,2)size(A,0)、size(A,1)维度编号同样从0开始
sum(A,1)sum(A,0)指定维度求和时,把原维号减1
A .* B、A ./ B、A .^ B相同运算符逐元素运算;矩阵乘法仍用 *
[A B]、[A;B]horzcat(A,B)、vertcat(A,B)水平、垂直拼接
A.'transpose(A) 或 A'普通转置,不取共轭
A'ctranspose(A)复数共轭转置;RustScript 的 ' 仅转置
A\bA\b 或 linsolve(A,b)解矩阵方程,需要安装版本提供线性代数功能
inv(A)A^-1没有名为 inv 的数值函数;解方程优先用左除或 linsolve
log(x)ln(x)自然对数函数名不同;常用对数仍写 log10(x)
1:nrange(1,n+1)range 不包含终点;例如 1:2:5 写 range(1,6,2)
'text'反引号字符串:`text`本表适用于数值脚本;DataFrame 列表达式的字符串用双引号
% 注释// 注释多行注释可用 /* ... */
a ~= ba != b不等于
~a~~a逻辑非;单个 ~ 是位取反
if flag按含义写 if flag != 0 { ... }数值条件先明确为标量;直接使用实数时,大于0才为真
for k=1:4 ... endfor k in 1..=4 { ... }..= 包含终点,.. 不包含终点
sparse(A)使用 sparse(rows,cols,values,m,n)提供零基行列坐标、值及矩阵大小,不支持直接把 A 传给 sparse

get_multi、set 等函数使用按行展开的扁平下标,不能直接套用 MATLAB 按列展开的线性下标。例如 A=[[1,2,3],[4,5,6]] 中,MATLAB 的 A(2) 为4;对应脚本应写 get(A,1,0),而不是 get_multi(A,[1])。

矩阵更新需要接收返回值;只调用更新函数而不赋回变量,不会改动原矩阵。assign 用于稠密数组,稀疏矩阵更新使用 select_assign 或 set,具体参数见支持的函数。

MATLAB 中读取一个元素、修改矩阵,再计算各行的和:

A = [1 2 3; 4 5 6];
picked = A(2,3);
A(2,3) = 10;
y = A * ones(3,1);

改写为可上传的 RSS 脚本:

A = [[1,2,3],[4,5,6]];
picked = get(A,1,2);
A = select_assign(A,10,[1],[2]);
y = A * ones(3,1);
return y;

picked 为6;修改后的第二行为 [4,5,10],返回结果是两行一列的 [[6],[19]]。按前面的步骤上传,参数2使用 2,在报表中核对这两个数值。

代码块使用大括号,函数使用 fn 和 return;不使用 MATLAB 的 function、end,也不需要 let、mut 等声明。

下面把 MATLAB 中的累计循环改写为脚本,结果应为10:

total = 0;
for k in 1..=4 {
total = total + k;
}
return total;

范围循环的步长固定为1。需要倒序或其他步长时,使用 while,在循环体内更新计数器。

自定义函数可返回一个值,也可返回多个值:

fn split(value) {
return (value*0.8,value*0.2);
}
[main,extra] = split(100);
return [[main,extra]];

本例只向 DFF 返回一张数值表,参数2用 2,结果为 [[80,20]]。函数内部接收多个值不要求勾选 Multi-returns;只有节点最终输出多个独立结果时,才需要对应的多结果设置。

目前不使用直接 a[i]、obj.field、try/catch 或 mod/import 写法。结构体通过 struct/getfield/setfield 等函数访问;复用外部脚本使用 #include 或 #include_url,并保证依赖文件或链接可访问。

MATLAB 调用迁移时的处理
fsolve(fun,x0)使用符号残差、初值和变量名称列表,不能直接传同名函数句柄协议
intlinprog(f,intcon,...)使用符号目标、约束、完整变量类型码和名称列表
fmincon(fun,x0,...)回调形式要求提供目标梯度;非线性约束还需提供约束导数
[x,fval,exitflag,...]=fmincon(...)回调形式返回独立结果;符号表达式形式返回单个拼接向量
optimoptions(...)只用于已支持的 fmincon 选项,不能直接照搬 MATLAB 的算法与选项全集

完整调用示例、返回值和状态码见 RustScript 求解器与回调。先比较解、原目标和约束,再把求解结果接入控制或写回。

纯数值脚本目前没有 all/chol/cond/inv/linspace/mean/median/nnz/numel/qr/repmat/reshape/spy/std/tril/triu/var 这些内置名称,不要仅凭 MATLAB 中可用就直接调用。先查支持的函数,选择合适的计算或改写方法。

DataFrame 模式有自己的 all/mean/median/std/var 等列表达式;它们接收列或表,不能当作 MATLAB 数值数组函数直接替换。需要从表中取出数值再计算时,见 TensorEval 与 DataFrame。