SWB 第 8 章：清理项目

来源：swb_ug.pdf 第 8 章（W-2024.09）

本章目录

• 清理项目
• 清理节点输出
• 命令行清理项目
• 检测待移除文件
• 指定项目排除文件模式

---

清理项目

可以从 Projects Browser 同时清理多个选中的项目。

注意：Cleanup Options 对话框中的选项因项目组织方式不同而异。

清理项目步骤：

1. 选择 Project > Operations > Clean Up 或按 Ctrl+L。 Clean Up Options 对话框打开。对于传统组织的项目，对话框如图所示：

对于层级组织的项目，对话框如图所示：

2. 选择所需选项：

传统组织的项目的选项：

选项	说明
预处理数据
Preprocessed Files	删除所有预处理文件（pp*）。
Set Variables	从 gvars.dat 中删除预处理器设置的变量。
仿真数据
Output Files	删除所有输出文件（n<nkey>、pp<nkey> 等）。
Extracted Variables	从 gvars.dat 中删除提取的变量。
项目数据
Log Files	删除项目级日志文件（glog.txt、gsummary.txt、preprocessor.log、.history 等）。
Backup Files	删除项目目录中的 .backup 子目录。
Reset Project Status	删除项目状态文件（.status）。
Renumber the Tree	对树重新编号。仅在选中 Preprocessor Data 和 Simulation Data 下所有选项时此选项才可用。

层级组织的项目的选项：

选项	说明
预处理和仿真数据
Node Files (Output, Preprocessed)	删除所有预处理和输出文件（n<nkey>、pp<nkey> 等）。
Set Variables	从 gvars.dat 中删除预处理器设置的变量。
Extracted Variables	从 gvars.dat 中删除提取的变量。
项目数据
Log Files	删除项目日志文件（glog.txt、gsummary.txt、preprocessor.log、.history 等）。
Reset Project Status	删除项目状态文件（.status）。
Renumber the Tree	对树重新编号。

3. 点击 Cleanup（对于传统项目可点击 Fast Cleanup）。

注意：Fast Cleanup 按钮仅适用于传统项目。它执行更快的项目清理，在包含大量文件的大型项目上效果尤为明显。原项目目录在此类清理期间会被删除然后重新创建。因此，强烈建议关闭所有正在访问项目文件的其他应用程序，以避免意外错误或可能的数据丢失。

---

清理节点输出

删除选中节点的输出和预处理数据：

1. 选中节点（参见使用鼠标和键盘操作选中节点）。
2. 选择 Nodes > Clean Up Node Output。
3. 选择是否要从 gvars.dat 中删除仿真提取的变量。
4. 选择是否要从 gvars.dat 中删除预处理变量。
5. 选择要删除的输出和预处理文件。 所有与选中节点关联的输出和预处理文件均已预选。
6. 点击 OK。

---

命令行清理项目

gcleanup 工具可以从命令行清理项目。例如：

gcleanup -default /folder/project

gcleanup 命令行选项：

选项	说明
-back	清理备份文件
-default	启用以下选项：-back、-log、-pp、-res、-sv、-unlock、-xv
-fast	执行快速清理
	注意：原项目目录会被删除然后重新创建。应关闭所有正在访问项目文件的其他应用程序，以避免意外错误或可能的数据丢失。
-help	显示帮助信息
-log	清理日志文件
-n "node list"	仅清理指定节点
-pp	清理预处理文件
-ren	重新编号；自动启用以下选项：-pp、-res、-sv、-xv
-res	清理输出文件
-sv	清理 set 变量
-unlock	删除项目状态文件
-version	显示版本信息
-verbose	显示额外信息
-xv	清理提取的变量

参数：

• PROJECT：项目目录

---

检测待移除文件

默认 Sentaurus Workbench 清理场景会检测项目的可重现部分并将其删除。所有作为项目预处理和执行结果出现的文件均被视为可重现文件。

Sentaurus Workbench 使用工具数据库中声明的 cleanup patterns 来检测项目和节点级别要删除的文件。每个工具都会设置可重现节点文件。例如，以下行设置了 Sentaurus Device 节点的输出文件模式：

set WB_tool(sdevice,output,files) "n@node@_* pp@node@_* *_n@node@_*"

节点文件会在整体项目清理和选中节点清理期间被删除。

---

指定项目排除文件模式

Sentaurus Workbench 允许指定多个排除文件模式。这些模式定义了在项目打包时必须排除的项目文件，以及在项目清理期间必须删除的项目文件。默认的 Sentaurus Workbench 模式为：

set WB_tool(garbage_exclude_patterns) ".nfs* core core.*"
set WB_tool(export_exclude_patterns)  ""
set WB_tool(cleanup_exclude_patterns) ""

• WB_tool(garbage_exclude_patterns)：定义系统崩溃或删除打开文件时产生的残留文件。这些文件必须在项目清理期间删除，且不得出现在导出的项目包中。
• WB_tool(export_exclude_patterns)：定义导出项目时不包含在包中的文件。
• WB_tool(cleanup_exclude_patterns)：定义必须在项目清理期间删除、但可以包含在导出项目包中的文件。

表：影响项目操作的模式设置

模式设置	Cleanup	Export	Export as clean
WB_tool(garbage_exclude_patterns)	是	是	是
WB_tool(export_exclude_patterns)	否	是	是
WB_tool(cleanup_exclude_patterns)	是	否	是
WB_tool(<tool>,output,files)	是	否	是

---

Sentaurus™ Workbench User Guide W-2024.09 第 8 章