⋮

# 变量操作

仿真浏览器的变量树包含了实例的所有变量与参数，显示内容包括变量的名字、值、单位以及描述信息。

变量树

# 显示变量曲线

当模型实例求解结束，可以利用曲线窗口查看变量曲线，以直观地了解变量随时间的变化规律。具体操作步骤如下：

  • 从仿真浏览器中勾选变量

    展开damper组件使得 phi_rel 变量节点可见，单击 phi_rel 变量节点前的方框或变量名，立即在当前曲线窗口中显示出变量曲线。

    单选变量

    Sysplorer 支持在变量树中一次选中或取消选中多个变量。先选中变量damper.phi_rel，然后按 Shift 键，选中变量 tau，组件damper中从 phi_rel 到 tau 之间的所有变量均被选中，单击任意一个选中变量前的方框或变量名，所有被选中的变量曲线全部显示当前曲线窗口。

    多选变量

  • 从仿真浏览器中拖拽变量

    从仿真浏览器中选中变量，按住鼠标左键，拖动鼠标至曲线窗口，系统立即在该曲线窗口中显示出变量曲线。当变量节点的拖拽终点不在曲线窗口内时，系统将创建 y(t) 曲线窗口，并将该变量曲线添加至该曲线窗口。

    拖拽变量

提示

如果变量节点前的方框中有 √，表示当前曲线窗口中包含该变量，即仿真浏览器中变量的勾选状态与当前曲线窗口显示的变量曲线有关。

# 删除变量曲线

在仿真浏览器中删除曲线窗口中的变量曲线，有以下几种方式，您可根据需要自行选择：

  • 在仿真浏览器上取消变量前的勾选；

  • 在曲线窗口选中曲线并右击，在弹出的上下文菜单中选择删除所选变量；

  • 在曲线窗口选中曲线，按 Delete 键删除变量曲线；

  • 在曲线窗口中右击，在弹出的上下文菜单中选择清空当前子窗口，可清空当前曲线子窗口中所有变量曲线。

删除变量

# 过滤变量

仿真浏览器上默认显示仿真实例的所有参数与变量，仿真浏览器工具栏中提供过滤变量和参数操作选项，对仿真浏览器上的所有实例生效。

  • ：显示实例中的所有变量和参数

  • ：仅显示参数

  • ：仅显示变量

# 查找变量

对于结构复杂的模型，其组件层次较深，直接在仿真浏览器中定位变量并非易事。为此，Sysplorer 提供变量查找功能。

下面以变量damper.tau为例介绍查找功能的使用方法。

在仿真浏览器查找输入框中输入 tau，此时不含字符 tau 的组件和变量节点被排除，仅保留符合搜索条件的组件和节点。

查找变量

# 保存变量数据

模型实例求解成功之后，模型中所有变量的数据保存在 Sysplorer 自有格式的结果文件中。仿真浏览器中支持另存 Sysplorer 自有格式结果文件，或通过导出仿真结果和导出勾选的结果两种方式导出为 CSV、TXT 等格式结果；曲线窗口支持导出窗口结果和导出子窗口结果两种方式进行结果导出为 CSV、TXT 等格式文件。

# 另存仿真结果

另存仿真结果可以将当前 Sysplorer 仿真浏览器中的自有格式结果文件另存到新的存储目录。

  • 单击仿真浏览器工具栏，在弹出的窗口选择路径，将仿真结果保存到指定目录；

  • 仿真浏览器变量树中选中模型名右击，在弹出的上下文菜单中选择另存为，在弹出的窗口选择路径，将仿真结果保存到指定目录。

    另存为

# 导出仿真结果

单击仿真浏览器工具栏上的，或在仿真浏览器变量树中选中模型名右击，在弹出的上下文菜单中选择结果导出 > 导出仿真结果，导出仿真结果功能会将当前仿真浏览器选中的结果实例中的全部变量导出为指定格式的结果文件，支持CSV with unit、CSV without unit、TXT with unit、TXT without unit、以及MAT格式。

结果导出

# 导出勾选的仿真结果

单击仿真浏览器工具栏上的，或在仿真浏览器变量树中选中模型名右击，在弹出的上下文菜单中选择结果导出 > 导出勾选的仿真结果，导出勾选的仿真结果功能会将当前仿真浏览器选中的结果实例中已勾选绘制曲线的变量导出为指定格式的结果文件，支持CSV with unit、CSV without unit、TXT with unit、TXT without unit、以及MAT格式。已勾选的变量会随曲线窗口的焦点变化而变化。

结果导出

# 导出窗口结果

单击图表工具栏导出窗口结果中的导出窗口结果按钮，仅导出当前曲线窗口结果变量。

另存为

导出当前曲线窗口结果变量的功能还可通过曲线窗口右键上下文菜单中导出窗口结果 > 导出窗口结果按钮使用。

另存为

# 导出子窗口结果

单击图表工具栏导出窗口结果中的导出子窗口结果按钮，仅导出当前曲线子窗口结果变量。

另存为

导出当前曲线子窗口结果变量的功能还可通过曲线窗口右键上下文菜单中导出窗口结果 > 导出子窗口结果按钮使用。

另存为

# 结果导出配置窗口

以上导出结果的按钮均会统一打开结果导出配置窗口，在配置窗口中可以对变量、时间、路径进行自定义配置。同时，不同的入口打开配置窗口时，窗口内容将会默认切换到对应入口的配置。

另存为

# 变量配置

变量配置中支持对变量范围和仿真结果/曲线窗口进行配置。

  1. 变量范围：支持从“全部变量”、“已勾选变量”、“曲线窗口变量”、“曲线子窗口变量”四个选项中选取。不同的入口打开配置窗口时，变量范围会自动切换。例如从导出仿真结果按钮打开结果导出配置窗口时，变量范围将会自动切换至“全部变量”。

  2. 仿真结果/曲线窗口：支持从当前仿真实例清单/曲线窗口清单/曲线子窗口清单中选择一项进行结果导出。当“变量范围”配置为“全部变量”或“已勾选变量”时，可配置仿真结果；当“变量范围”配置为“曲线窗口变量”或“曲线子窗口变量”，可配置曲线窗口或曲线子窗口。不同的入口打开配置窗口时，此配置项会自动切换。例如从某个子窗口中通过导出子窗口结果按钮打开结果导出配置窗口时，曲线窗口将会自动切换至当前曲线窗口名，曲线子窗口将会自动切换至当前曲线子窗口名。

    另存为

    曲线子窗口的命名格式为：曲线窗口名称[行数，列数]。

  3. 单位配置：支持从默认单位和国际标准单位中选择，默认单位为当前结果实例中的单位。导出变量过程中会根据单位配置对变量数据进行单位转换。

  4. 顺序配置：支持从默认顺序和字典顺序中选择，默认顺序为当前结果实例中的排列顺序。

  5. 导出变量描述配置：支持配置是否导出变量描述。

  6. 导出至 Syslab 工作区：支持直接将结果导出至 Syslab 工作区，提供快捷切换 Julia/MLang 目标工作区。

# 时间配置

  1. 时间配置：支持从全部时间、结束时间点及自定义时间周期中选择。配置为全部时间时将会导出全部时间段的仿真结果；配置为结束时间点时仅会导出最后一个时间点的仿真结果；配置为自定义时间周期时会按照用户设置时间段进行结果导出。另外，当变量配置中变量范围选择“曲线窗口变量”、“曲线子窗口变量”时，由于单个曲线窗口内可能存在多实例结果、多时钟结果情况，因此无法配置为自定义时间周期进行结果导出。

  2. 输出采样倍率配置：支持配置结果导出的采样倍率，默认值为 1，即不进行采样导出。采样输出时必定会保留结果的起始时间点和结束时间点两个点的结果。

# 路径配置

  1. 导出格式配置：支持从带单位 CSV 文件、不带单位 CSV 文件、带单位 TXT 文件、不带单位 TXT 文件及 MAT 文件格式中选择。其中，“带单位”与“不带单位”不会影响变量配置--单位配置中的单位转换功能。另外，当变量配置中变量范围选择“曲线窗口变量”、“曲线子窗口变量”时，由于单个曲线窗口内可能存在多实例结果、多时钟结果情况，因此无法配置为 MAT 文件格式进行结果导出。
  2. 导出路径配置：支持手动输入目标文件路径或单击浏览按钮选择目标文件路径。

# 数据格式说明

为方便用户获取变量数据，系统提供了数据输出接口，允许将多个变量数据导出为文本文件.csv、.txt和 MAT 文件.mat，以支持外部其他应用程序访问结果数据。其中，.csv和.txt根据是否带有单位显示可以有两种导出模式，带单位CSV文件、带单位TXT文件指的是导出的变量结果带有单位显示，不带单位CSV文件、不带单位TXT文件则不带单位显示。下图显示了使用 Microsoft Excel 打开保存的表格文件带单位CSV文件内容，其中包括时间 Time 和其他三个变量。

CSV表格

当导出曲线窗口 y(t) 时，因为 Yt 窗口可能包含来自多个任意结果的变量，故来自同一仿真结果的变量会公用同一个 Time 列，运算曲线每个变量均会导出各自的 Time，在文件中运算曲线名为 OP [运算曲线名]，该运算曲线可能会来自不同的仿真结果，故运算曲线名会添加曲线仿真结果名。具体导出效果显示如下：

CSV表格

当导出曲线窗口 y(x) 时，因为 Yx 只允许添加来自同一结果的变量，故导出格式只存在一列 Time。具体导出效果显示如下：

CSV表格

导出结果中的单位变量描述支持配置，CSV和TXT文件内的变量名定义为：<变量名><(单位)><##描述##>。其中<变量名>为必选项、<(单位)><##描述##>两项跟随配置动态生成。

# 打开变量数据

支持MAT、CSV、msr格式变量数据的导入，可通过单击仿真浏览器工具栏上的，或在仿真浏览器变量树空白处右击，单击打开仿真结果。

如上图所示，将导出的结果重新导入，会重新构建一个仿真结果树，文件名称作为根节点名称，将结果文件中的变量名称拆分构造变量树节点。其中左边为部分变量再导入的结果树，而右边是所有变量再导入的结果树（结构与导出前保持一致）。

# 变量时间点

仿真浏览器中的参数和变量节点默认只显示参数值，使用设置变量时间点功能，可以查看所有变量在指定时间点的数据。操作步骤如下：

  1. 在仿真浏览器中右击模型名，在弹出的上下文菜单中选择显示指定时刻变量值，在弹出的设置变量时间点窗口中键入指定的时间点数值；

    显示指定时刻变量值

    • 键入的时间点不应超出模型仿真区间，即不小于开始时间，也不大于停止时间，否则该选项无效；

    • 键入的时间点不是输出时刻，系统按照就近原则自动获取最近输出时刻的变量值。

  2. 在设置变量时间点窗口中输入 2，单击确定，由于 2 不是输出时刻，系统自动选择并在仿真浏览器上显示最近输出时刻 1.998 的变量值。

    显示变量值

# 保存参数到模型

通过修改参数，可以无需再次编译，直接进行仿真并生成新的仿真结果。

如果模型可修改，可以在模型实例的根结点上右击，在弹出上下文菜单中选择保存参数到模型，在弹出参数保存对话框中勾选要保存的参数，单击确定，将参数保存到模型中。

保存参数到模型

提示

对话框中的参数值是按国际标准单位显示的。

# 选择显示单位

仿真浏览器中，单位栏显示出变量的 displayUnit 属性。单击后，弹出的下拉列表中显示出候选的显示单位。选择新的显示单位后，系统自动将仿真浏览器上的变量结果换算成显示单位进行显示。

选择显示单位