终端使用

PSD-PREP支持在终端中使用。

1. 终端中使用的模块与功能

模块与功能介绍可以参考此处。

2. PSD-PREP的终端使用命令

(1) run

这个指令用于指定ID文件来执行工程计算。

指令定义：

1
PSD-PREP run [resultName] [IDFile]
  • PSD-PREP: 程序名，也可以为PSD-PREP.exe或者./bin/PSD-PREP.exe
  • run: 告诉程序需要执行的任务类型，这里是指需要执行计算
  • [resultName]: 计算任务选择需要返还的结果类型
  • IDFile: 需要执行计算的工程ID名，其一般是位于./Project文件夹下的ID文件

使用该指令时，程序会使用./Project文件夹下的IDFile文件，载入其指定的任务模式以及参数，并执行计算。随后在终端返还[resultName]所指定的结果。

该指令还可以额外附加[outputfile]参数，其是指定1个结果输出地址，用于保存输出的结果。例如：

1
PSD-PREP run [resultName] [IDFile] [outputfile]

举例：

1
./PSD-PREP.exe run result_cumulative_PSD 10000000 ./Project/result/output.txt

上述指令表示：

1
2
载入./Project下的ID=10000000的工程，执行计算，返还result_cumulative_PSD结结果
并输出到./Project/result/output.txt文件中

PSD-PREP目前支持的输出结果有如下类：

img.png

  • result_cumulative_PSD: 输出数据为点群，每行为(d, F)的点，d为颗粒尺寸，F为累计到此处的累计分布，F属于(0,1)
  • result_diameter_mean: 输出数据为点群，每行为d的点，d为颗粒尺寸（可能有多组颗粒，每行1组）
  • result_diameter_mean_fraction: 输出数据为点群，每行为frac的点，frac为颗粒尺寸所对应的分数（可能有多组颗粒，每行1组）
  • result_frequency_psd: 输出数据为点群，每行为(d, f)的点，d为颗粒尺寸，f为此处颗粒的概率