分析界面操作#

软件内的每一个分析都是由数据、选项、结果所组成的,接下来将分别介绍三者的基本界面操作方法。

在阅读本节之前,推荐先阅读:软件基本用户界面数据集界面操作

新建分析#

有如下三种方式来新建一个分析:

  • 点击标签页栏右侧的加号按钮来增加一个新建分析页(图 133),并在其中点击需要新建的分析即可完成创建。

../_images/ui-analysis-new-by-tabs.png

图 133 从新建分析页面创建分析示意图#

  • 右键想要在其中新建分析的工作流,在右键菜单中选择 “新建分析”图 134)。在弹出的窗口(图 135)中点击选择所需的分析即可完成创建。

../_images/ui-analysis-new-by-right-click.png

图 134 从右键菜单新建分析示意图#

../_images/ui-analysis-new-analysis-modal.png

图 135 新建分析窗口示意图#

  • 点击左侧侧边选项栏的 “功能” 功能按钮 按钮(图 136),在其侧边栏中选择并点击想要新建的分析后便将在根工作流(位于项目下第一级的工作流)中创建一个对应的新分析。

../_images/ui-analysis-new-by-sidebar.png

图 136 “功能” 按钮位置示意图#

导入文件并新建分析#

除了上文中所述的方法外,我们也可以通过导入文件的方式来创建一个分析。目前支持导入 NONMEM 控制文件(后缀名为 ctl 或 mod 的文件)并生成含有对应 Masmod 代码的 Notebook,其操作步骤如下:

  1. 右键想要导入文件的工作流,在右键菜单中选择 “导入文件 > 导入 NONMEM 控制文件 (ctl/mod)” 选项(图 137)。在弹出的文件选择窗口中选择需要导入的控制文件,并点击 “导入”图 138)。

  2. 成功读取需要导入的本地文件后,将出现 “导入 NONMEM 控制文件” 窗口。在其中我们可以首先检查导入的控制文件是否正确以及选择对应的文件编码(图 139)。

  3. 确认 NONMEM 源码无误后,点击 “下一步” 按钮即可将其翻译为 Masmod 代码。我们应仔细检查翻译后的代码有无纰漏(图 140)。

  4. 检查翻译结果后,点击 “确定” 按钮即可生成含有翻译后 Masmod 代码的 Notebook(图 141)。Notebook 的相关操作方法可以参考:Notebook 界面操作

../_images/ui-analysis-import-ctl.png

图 137 导入 NONMEM 控制文件选项示意图#

../_images/ui-analysis-select-ctl.png

图 138 文件选择窗口示意图#

../_images/ui-analysis-check-ctl.png

图 139 检查 NONMEM 源码操作示意图#

../_images/ui-analysis-translate-result.png

图 140 检查翻译后代码操作示意图#

../_images/ui-analysis-translate-notebook.png

图 141 含有翻译代码的 Notebook 示意图#

载入仿例#

若你是初识我们的软件或对某个分析功能不甚熟悉,可以点击页面右上角的 “载入仿例” 按钮(图 142)以使用载入仿例功能来快速熟悉此分析所需的数据、分析内的常用选项与期望结果。

../_images/ui-analysis-load-demo.png

图 142 “载入仿例” 按钮位置示意图#

数据操作#

我们可以手动录入分析所需的数据,也可以直接采用软件 “数据集” 内的数据。接下来将分别介绍上述两种途径的操作方法。

快捷输入#

点击数据集左上方的 “快捷输入” 按钮(图 143)即可切换至快捷输入模式以手动录入数据。

快捷输入模式下数据的录入与数据集操作方法与 数据集界面操作 中提及的基本一致。需要注意的是,若某一列的列标签中带有星号 * 则表明该列为必填列。

../_images/ui-analysis-quick-enter.png

图 143 “快捷输入” 按钮位置示意图#

重要

分析界面内数据集的列标签指代了此列数据的映射关系:即表明此列内的数据将用作何种用途。例如在非房室分析中,若一列被映射为“浓度”,则其中的数据将被视为血药浓度并将在分析过程中计算其对应的曲线下面积。

链接数据#

点击数据集左上方的 “链接数据” 按钮(图 144)则可以切换至链接数据模式以直接使用 “数据集” 内的数据或其他分析的分析结果。

在此模式下,我们首先点击上方的 选择数据按钮 按钮(图 145)。点击后将出现数据集选择窗口(图 146),在其中选中所需的数据集并点击下方 “选择” 按钮即可将此数据链接至当前分析内。点击右侧的 取消链接按钮 按钮可以取消链接。

../_images/ui-analysis-select-data.png

图 145 选择数据按钮位置示意图#

../_images/ui-analysis-select-data-modal.png

图 146 数据集选择窗口示意图#

链接完成后,我们需要使用鼠标拖拽 “数据列” 栏内合适的数据列至下方各个卡片内以完成数据映射关系(图 147)。点击卡片内的 取消映射按钮 按钮可以取消映射关系。

../_images/ui-analysis-data-mapping.png

图 147 拖拽映射操作示意图#

小技巧

可以使用 Ctrl + 左键单击Shift + 左键单击 的方法来同时选中多个数据列。选中后可以同时拖拽这些数据列(图 148)。

../_images/ui-analysis-multi-select.png

图 148 多选后拖拽操作示意图#

小技巧

拖拽数据列时,数据映射卡片的颜色表明了该映射关系不同的状态:

  • 若为蓝色,表明可以将当前列映射至此关系;

  • 若为绿色,表明可以将当前列映射至此关系并将替换已映射的列;

  • 若为红色,表明当前列不能被映射至此关系。

分析选项相关操作#

前往“选项”页#

在大多数情况下,必填列的数据填写完整后,可以点击底部 “下一步” 按钮(图 149)进入 “选项” 页。在其中可以修改分析相关的选项设置。以 非房室分析 为例,其选项页界面如 图 150 所示。

../_images/ui-analysis-next-step.png

图 149 “下一步”按钮位置示意图#

../_images/ui-analysis-nca-option.png

图 150 非房室分析选项页示意图#

小技巧

我们不仅可以通过底部的 “下一步”“上一步” 按钮来切换页面。也可以点击顶部导航栏(图 151)来直接跳转至相应页面。

../_images/ui-analysis-page-navigation.png

图 151 顶部导航栏示意图#

填写分析选项#

软件中出现的分析选项类型有如下几种,接下来将介绍它们各自的填写或修改方式:

备注

图表绘制相关功能的选项与一般分析功能中的有所不同,如需查阅图表绘制选项相关的文档,请移步至:图表绘制

  • 勾选框图 152):勾选后即意为启用该分析选项。某些选项勾选后将影响此分析后续页面中的内容,例如 非房室分析 中的 “计算区域 AUC” 选项被勾选后需要在后续页面中填写区域相关的设置。

../_images/ui-analysis-checkbox.png

图 152 勾选框示意图#

  • 数字输入框图 153):在其中可以填入数字,如房室模型分析中的 “最大迭代次数”。在输入时,也可以点击数字输入框右侧的箭头来调整数值。如果输入框左侧有 1E 的前缀,则代表输入的数字为科学计数法的指数,即实际值为 \(1 \times 10^{输入值}\),如 房室模型分析 中的 “xtol” 输入框。

../_images/ui-analysis-num-input.png

图 153 数字输入框示意图#

  • 文本输入框图 154):在其中可以填入文本,如 非房室分析 中的 “数据单位” 相关选项。

../_images/ui-analysis-text-input.png

图 154 文本输入框示意图#

  • 下拉菜单图 155):点击后将展开所有可选项,点击其中所需的项即可选中该项,如 非房室分析 中的 “计算方法” 选项。

../_images/ui-analysis-dropdown.png

图 155 下拉菜单示意图#

  • 公式输入框图 156):公式输入框的 “~” 左侧为公式的因变量,右侧为 线性回归模型线性混合效应模型 的自变量组合形式。每个自变量的数据取自 “数据” 页中数据集与其同名的数据列。自变量与自变量之间允许以加法(+)的形式进行组合。以线性回归模型为例,自变量可有如下组合形式:

WIDTH + WEIGHT
../_images/ui-analysis-formula.png

图 156 公式输入框示意图#

更多公式输入框相关的内容请见:线性回归模型模型选项Cox 回归分析模型选项交叉设计 ABE 分析固定效应选项

运行分析#

在数据与分析选项均确认无误后,可以点击底部 “运行” 按钮或右上角 运行按钮 按钮(图 157)来运行分析。

../_images/ui-analysis-run.png

图 157 运行按钮位置示意图#

也可以右键需要运行的分析,在右键菜单中选择 “运行”图 158)来完成运行操作。

../_images/ui-analysis-run-by-right-click.png

图 158 右键菜单运行选项示意图#

查看结果#

运行分析后,可以在 “项目” 侧边栏对应分析下的 “结果” 内(图 159)查看分析结果。

点击 “结果” 可以查看对应的分析报告。如果需要查看详细的数据表格或修改结果中的图片样式等,可以展开 “结果” 并点击其中需要查看的项目即可(图 160)。

../_images/ui-analysis-result.png

图 159 查看结果报告操作示意图#

../_images/ui-analysis-result-details.png

图 160 查看数据表格操作示意图#

导出结果#

若想导出完整报告,可以点击 “结果” 进入报告页并随后点击右上角 导出按钮 按钮(图 161)。选择需要的导出格式并在后续路径选择窗口中指定导出路径即可完成报告导出。或也可通过右键 “结果” 并在右键菜单中选择导出相关选项来完成导出操作(图 162)。

../_images/ui-analysis-export-report.png

图 161 导出按钮位置示意图#

../_images/ui-analysis-export-report-by-right-click.png

图 162 通过右键菜单导出报告操作示意图#

若想导出单个结果表格或图片,可以展开 “结果” 并点击需要导出的内容。随后在对应的标签页中点击右上角 导出按钮 导出按钮即可。或也可以右键需要导出的内容,在右键菜单中选择 “导出”。以上两种方法的示意图如 图 163 所示。

../_images/ui-analysis-export-content.png

图 163 导出单个结果操作示意图#

复制分析#

若想复制某个分析,可以右键需要复制的分析,在右键菜单中选择 “复制” 选项(图 164)。随后右键某个工作流,选择 “粘贴”图 165),即可将被复制的分析粘贴入选中的工作流内。

../_images/ui-analysis-copy.png

图 164 复制选项示意图#

../_images/ui-analysis-paste.png

图 165 粘贴选项示意图#

重命名与删除分析#

若想重命名或删除工作流中的某分析,可右键需要重命名或删除的分析,在右键菜单中选择 “重命名”“删除”图 166)即可。

../_images/ui-analysis-rename-delete.png

图 166 重命名与删除操作示意图#

我们也可以在可视化工作流中执行复制、重命名、删除等操作,详细可参见:查看可视化工作流