从matlab迁移
2.7 从matlab迁移
Section titled “2.7 从matlab迁移”迁移已有 MATLAB 程序时,先把数值计算部分改写为 RustScript,再接入 DFF 的输入和输出。矩阵和常用运算比较接近,但下标、矩阵写法、字符串及求解函数的参数并不完全相同,不能直接把 .m 文件作为 RSS 脚本上传。
在前端运行迁移后的脚本
Section titled “在前端运行迁移后的脚本”- 先选一个输入、输出明确的小计算,保留 MATLAB 的输入和参考结果。
- 按下面的规则改写,保存为 UTF-8 的
.rss文件。在编辑模式进入“设置项 → 报表”,新建或编辑 DFF,添加TensorEval节点并上传脚本。 - 数值脚本不勾选“是否Polars”;矩阵结果勾选“是否矩阵”,对应文件参数2为
2。脚本末尾用return返回要查看的结果。 - 本机表格数据通过
Source → Data上传,用边名称作为脚本变量;绘图改用报表的表格或图表模板。文件路径指 MEMS 服务所在计算机,不能直接照搬 MATLAB 电脑上的路径。 - 保存并加载流程,到“事件 → 策略”手动运行,再到“仪表盘 → 报表”选择本次记录,对照数值、形状、单位和求解状态。
只输出一个结果时,可以连接一个 None 节点作为输出节点。多结果的勾选项和名称写法见 TensorEval 与 DataFrame。函数名称与调用形式见支持的函数。
常用写法对照
Section titled “常用写法对照”表中的 i、j 指原 MATLAB 程序的一基下标;迁移时需要减1。
| MATLAB | RustScript | 说明 |
|---|---|---|
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)=v | A=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\b | A\b 或 linsolve(A,b) | 解矩阵方程,需要安装版本提供线性代数功能 |
inv(A) | A^-1 | 没有名为 inv 的数值函数;解方程优先用左除或 linsolve |
log(x) | ln(x) | 自然对数函数名不同;常用对数仍写 log10(x) |
1:n | range(1,n+1) | range 不包含终点;例如 1:2:5 写 range(1,6,2) |
'text' | 反引号字符串:`text` | 本表适用于数值脚本;DataFrame 列表达式的字符串用双引号 |
% 注释 | // 注释 | 多行注释可用 /* ... */ |
a ~= b | a != b | 不等于 |
~a | ~~a | 逻辑非;单个 ~ 是位取反 |
if flag | 按含义写 if flag != 0 { ... } | 数值条件先明确为标量;直接使用实数时,大于0才为真 |
for k=1:4 ... end | for 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,具体参数见支持的函数。
一个完整的矩阵迁移示例
Section titled “一个完整的矩阵迁移示例”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,在报表中核对这两个数值。
条件、循环和自定义函数
Section titled “条件、循环和自定义函数”代码块使用大括号,函数使用 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,并保证依赖文件或链接可访问。
求解函数不能直接照搬参数
Section titled “求解函数不能直接照搬参数”| MATLAB 调用 | 迁移时的处理 |
|---|---|
fsolve(fun,x0) | 使用符号残差、初值和变量名称列表,不能直接传同名函数句柄协议 |
intlinprog(f,intcon,...) | 使用符号目标、约束、完整变量类型码和名称列表 |
fmincon(fun,x0,...) | 回调形式要求提供目标梯度;非线性约束还需提供约束导数 |
[x,fval,exitflag,...]=fmincon(...) | 回调形式返回独立结果;符号表达式形式返回单个拼接向量 |
optimoptions(...) | 只用于已支持的 fmincon 选项,不能直接照搬 MATLAB 的算法与选项全集 |
完整调用示例、返回值和状态码见 RustScript 求解器与回调。先比较解、原目标和约束,再把求解结果接入控制或写回。
检查没有直接对应的函数
Section titled “检查没有直接对应的函数”纯数值脚本目前没有 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。