一、gate目录下指令
ls /gate
以下是gate中各个目录下的指令及其使用示例和说明:
/gate/actor/
### /gate/actor/addActor
- **命令**:`/gate/actor/addActor`
- **说明**:这个命令用于在Gate中添加一个新的传感器,也就是我们通常所说的“演员”(Actor)。通过这个命令,您可以指定传感器的类型和名称,从而在模拟中加入特定的数据收集器或处理单元。
- **示例**:如果您想要添加一个名为“mySD”的敏感探测器,您可以使用以下命令:
- `/gate/actor/addActor SensitiveDetector mySD`
### /gate/actor/init
- **命令**:`/gate/actor/init`
- **说明**:这个命令用于初始化所有已经添加到模拟中的传感器。在开始模拟之前,您需要确保所有的传感器都已经被正确初始化,以便它们可以正常工作并收集数据。
- **示例**:在模拟开始前,您可以执行以下命令来初始化所有传感器:
- `/gate/actor/init`
### /gate/actor/resetAfterSaving
- **命令**:`/gate/actor/resetAfterSaving`
- **说明**:这个命令用于在传感器保存结果之后重置传感器。这在实现检查点(checkpointing)功能时非常有用,因为它允许您在模拟的某个阶段保存状态,并在需要时重置传感器,以便重新开始数据收集或处理。
- **示例**:如果您有一个名为“mySD”的传感器,并希望在保存数据后重置它,可以使用以下命令: - `/gate/actor/resetAfterSaving mySD`
/gate/physics/
1. **addProcess**:启用特定的物理过程。
- 例子:`addProcess e+ e-` 启用正电子和电子的物理过程。
2. **addProcessMixed**:启用混合物理过程。
- 例子:`addProcessMixed emstandard_opt3_mixed_emdna` 启用一个混合物理过程,结合了标准电磁过程和DNA过程。
3. **removeProcess**:禁用特定的物理过程。
- 例子:`removeProcess gamma` 禁用伽马射线的物理过程。
4. **processList**:列出所有已启用的物理过程。
- 例子:`processList` 将显示当前所有已启用的物理过程列表。
5. **print**:打印物理列表。
- 例子:`print` 将打印出当前配置的物理过程列表。
6. **init**:初始化物理列表。
- 例子:`init` 将初始化物理过程列表,通常在开始模拟前使用。
7. **displayCuts**:打印体积中的截止值。
- 例子:`displayCuts` 将显示所有体积的截止值设置。
8. **SetMaxStepSizeInRegion**:为特定区域设置最大步长。
- 例子:`SetMaxStepSizeInRegion myRegion 1.0 cm` 为名为“myRegion”的区域设置最大步长为1厘米。
9. **SetMaxToFInRegion**:为特定区域设置最大飞行时间。
- 例子:`SetMaxToFInRegion myRegion 10 ns` 为名为“myRegion”的区域设置最大飞行时间为10纳秒。
10. **SetMinKineticEnergyInRegion**:为特定区域设置最小动能。
- 例子:`SetMinKineticEnergyInRegion myRegion 100 keV` 为名为“myRegion”的区域设置最小动能为100千电子伏特。
11. **SetMaxTrackLengthInRegion**:为特定区域设置最大轨迹长度。
- 例子:`SetMaxTrackLengthInRegion myRegion 10 cm` 为名为“myRegion”的区域设置最大轨迹长度为10厘米。
12. **SetMinRemainingRangeInRegion**:为特定区域设置最小剩余射程。
- 例子:`SetMinRemainingRangeInRegion myRegion 1.0 cm` 为名为“myRegion”的区域设置最小剩余射程为1厘米。
13. **ActivateStepLimiter**:激活步长限制器。
- 例子:`ActivateStepLimiter e-` 为电子激活步长限制器。
14. **ActivateSpecialCuts**:激活特殊截止。
- 例子:`ActivateSpecialCuts gamma` 为伽马射线激活特殊截止。
15. **setDEDXBinning**:设置能量损失的DEDX分箱。
- 例子:`setDEDXBinning 100` 设置能量损失的DEDX分箱为100。
16. **setLambdaBinning**:设置Lambda分箱。
- 例子:`setLambdaBinning 50` 设置Lambda分箱为50。
17. **setEMin**:设置最小能量。
- 例子:`setEMin 100 eV` 设置最小能量为100电子伏特。
18. **setEMax**:设置最大能量。
- 例子:`setEMax 10 GeV` 设置最大能量为10吉电子伏特。
19. **addAtomDeexcitation**:将原子退激发加到能量损失表管理器中。
- 例子:`addAtomDeexcitation` 将原子退激发加入到能量损失表中。
20. **addPhysicsList**:选择一个Geant4物理列表构建器。
- 例子:`addPhysicsList emstandard_opt3` 选择一个名为“emstandard_opt3”的物理列表构建器。
21. **addPhysicsListMixed**:选择一个混合Geant4物理列表构建器。
- 例子:`addPhysicsListMixed emlivermore_mixed_emdna` 选择一个名为“emlivermore_mixed_emdna”的混合物理列表构建器。
22. **ConstructProcessMixed**:为DNA构建混合过程。
- 例子:`ConstructProcessMixed` 为DNA构建混合过程。
23. **SetEnergyRangeMinLimit**:设置能量范围的最小限制。
- 例子:`SetEnergyRangeMinLimit 250 eV` 将能量范围的最小限制设置为250电子伏特。
/gate/random/
这些指令与随机数引擎的配置和管理有关,通常用于确保模拟实验的可重复性或引入随机性。下面是每个指令的详细解释和使用例子:
1. **setEngineName**:设置随机引擎的类型。
- 例子:`setEngineName CLHEP` 设置随机引擎为CLHEP(CERN库的高能物理随机数引擎)。
2. **setEngineSeed**:设置随机引擎的种子值。
- 默认种子:`setEngineSeed default` 使用CLHEP内部的默认种子值,每次运行结果相同。
- 自动种子:`setEngineSeed auto` 使用基于CPU时间和Gate实例进程ID自动生成的随机种子。
- 用户定义种子:`setEngineSeed 1234567890` 手动设置一个种子值,这里`1234567890`是一个例子,实际值应为一个长无符号整数,范围在[0, 900000000]之间。
3. **verbose**:设置随机引擎的详细程度,范围从0到2。
- `verbose 0`:不打印任何信息。
- `verbose 1`:在获取(acquisition)开始时打印一次信息。
- `verbose 2`:在每次运行(run)开始时打印信息。
4. **showStatus**:显示随机引擎的状态。
- 例子:`showStatus` 将输出当前随机引擎的状态信息。
5. **resetEngineFrom**:从文件中设置随机引擎的种子。
- 例子:`resetEngineFrom /path/to/seedfile.txt` 从指定路径的文件中读取种子值,这里`/path/to/seedfile.txt`是文件的完整路径。
/gate/run
在GATE(Geant4 Application for Tomographic Emission)软件中,`/gate/run` 是一个用于控制模拟运行的命令目录。以下是该目录下两个命令的详细解释和如何使用它们:
1. **initialize**:初始化几何结构、参与者(actors)和物理列表。
- 这个命令用于在开始模拟之前设置所有的模拟参数,包括几何结构、参与