跳到正文
SemantaSemanta文档

输入、变量与输出

配置运行字段、结构来源、环境变量和输出引用。

更新日期

选择参数从哪里来

工作流中的数据可以来自本次运行填写的内容、节点固定设置、上游结果或环境变量。先决定哪些内容每次运行会变,再设置字段和引用。

来源适合的内容
用户输入每次运行需要填写或更换的文本、数值、选项、文件等
固定值当前节点使用的明确参数
上游节点前一步产生的结构、文件或计算结果
环境变量多个节点共同引用的固定配置
系统变量平台提供的用户、工作流、运行和时间等标识信息

设置运行输入

  1. 在材料计算专家中打开目标工作流,选中用户输入节点,进入输入设置。
  2. 点击添加字段,选择字段类型并填写变量名。
  3. 按需设置显示名称、默认值、必填要求和取值限制。
  4. 保存字段,然后在使用它的下游参数中选择该变量。

变量名用于引用,显示名称用于帮助填写。名称应有明确含义,例如 structure_file 或 sample_label。同一个节点中不要重复使用变量名。

字段类型决定可配置的约束:文本有长度限制,数值有上下限,选项需要设置可选值,文件需要设置数量、大小和允许的格式。限制应与下游节点实际接收的输入一致。

隐藏并使用默认值适合无需在运行表单中反复填写的字段。启用前先确认默认值已填写正确。点击测试运行后,可以在运行输入中核对最终展示给使用者的表单。

选择结构来源

结构输入节点用于提供结构;后续节点可以引用上游结构结果。选择来源时,区分原始结构、准备后的结构和变换后的结构。

例如,构建超胞后进行后续计算,应引用结构变换节点输出的结构,而不是继续引用原始晶胞。用节点名称与输出字段一起核对,尤其是在有多个分支时。

在固定值与引用之间切换

支持变量的参数提供固定与引用两种设置。固定值直接写在当前节点中;引用从可用变量列表中选择来源。

找不到变量时,先确认源节点已连接到当前节点、源字段存在且类型兼容。更改字段类型或删除源字段后,应重新选择引用并运行检查。

配置环境变量与查看系统变量

点击工具栏的环境变量,添加名称、类型和值并保存,再到节点参数中引用。变量名以字母或下划线开头,可包含字母、数字和下划线,最长 64 个字符。

删除被使用的环境变量前,需要先移除节点引用。对于每次运行都要改变的内容,使用用户输入字段更便于填写。

系统变量提供平台维护的字段定义,只读,不需要自行添加或修改。

选择最终输出

选中输出节点,添加输出字段,并为每个字段选择来源。可以分别暴露结构、文件、晶胞信息和校验结果,便于运行后直接查看。

仅把处理节点连到输出节点,还不足以指定具体展示哪些字段。保存后点击检查,确认输出变量完整,再进行测试运行。