validate

验证集群对象

自 R2026a 起

全页折叠

语法

validate(myCluster)

validate(___,Name=Value)

说明

validate(myCluster) 对由集群对象 myCluster 指定的集群进行验证。修改集群对象的属性后，您可以使用 validate 函数对该集群对象进行验证。

validate 函数打印已执行的验证阶段，并指示每个阶段是否通过、失败或被跳过。

如果验证阶段失败，函数将验证报告保存到临时文件夹中。

示例

validate(___,Name=Value) 使用一个或多个名称-值参量来指定额外的集群验证选项。

示例

全部折叠

验证集群对象

使用 parcluster 函数，为配置文件名为 myMJSCluster 的远程集群创建一个集群对象。

c = parcluster(myMJSCluster);

验证集群对象 c。validate 函数打印已执行的验证阶段，并指示每个阶段是否通过、失败或被跳过。

validate(c)

Beginning cluster validation.
Cluster connection test (parcluster)
   Stage started at 15:52:05.
   Using existing cluster object.
   ✓ Network latency: 6 ms
   ✓ Upload speed: 22915 KB/s
   ✓ Download speed: 43480 KB/s
   For more information on these results, see the
   "Troubleshooting Slow Network Connection" documentation
   page.
   Finished at 15:52:11.
......................................................PASSED
Job test (createJob)
   Stage started at 15:52:11.
   Finished at 15:52:21.
......................................................PASSED
SPMD job test (createCommunicatingJob)
   Stage started at 15:52:21.
   Job ran with 1 worker.
   Finished at 15:52:26.
......................................................PASSED
Pool job test (createCommunicatingJob)
   Stage started at 15:52:26.
   Job ran with 1 worker.
   Finished at 15:52:45.
......................................................PASSED
Parallel pool test (parpool)
   Stage started at 15:52:45.
   Connected to parallel pool with 12 workers.
   Parallel pool is shutting down.
   Parallel pool ran with 12 worker.
   Finished at 15:52:53.
......................................................PASSED
Finished cluster validation with status: PASSED

指定验证阶段

使用默认集群配置文件创建一个集群对象。

c = parcluster;

使用 5 个工作单元对集群对象 c 进行验证。仅运行 "job"、"spmd-job" 和 "pool-job" 阶段。将验证结果保存到一个名为 "validation.txt" 的报告文件中。

validate(c,NumWorkersToUse=5, ...
    StagesToRun=["job","spmd-job","pool-job"],ReportFile="validation.txt")

Beginning cluster validation
Cluster connection test (parcluster)
   Stage started at 14:46:04.
   Using existing cluster object.
   Finished at 14:46:06.
..........................................................................PASSED

Job test (createJob)
   Stage started at 14:46:06.
   Finished at 14:46:52.
..........................................................................PASSED

SPMD job test (createCommunicatingJob)
   Stage started at 14:46:55.
   Job ran with 5 workers.
   Finished at 14:47:57.
..........................................................................PASSED

Pool job test (createCommunicatingJob)
   Stage started at 14:48:01.
   Job ran with 5 workers.
   Finished at 14:49:11.
..........................................................................PASSED

Finished validation with status: PASSED
Validation report written to validation.txt

输入参数

全部折叠

`myCluster` — 集群
`parallel.Cluster` 对象

集群，指定为代表集群计算资源的 parallel.Cluster 对象。要创建 parallel.Cluster 对象，请使用 parcluster 函数。

示例: cluster = parcluster; validate(cluster);

数据类型: parallel.Cluster

名称-值参数

全部折叠

将可选参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

示例: NumWorkersToUse=4

`NumWorkersToUse` — 要使用的工作单元
非负整数

验证中使用的工作单元数，指定为非负整数。使用此参量，可对工作单元数量少于集群对象的 PreferredPoolNumWorkers 或 NumWorkers 属性中指定数量的集群对象进行验证。

示例: NumWorkersToUse=4

`StagesToRun` — 验证阶段需执行
字符串数组 | 字符向量元胞数组

要运行的验证阶段，指定为字符串数组或字符向量元胞数组，包含一个或多个以下阶段值：

"parcluster" - Cluster connection test (parcluster) 阶段。
"job" - Job test (createJob) 阶段。
"spmd-job" - SPMD job test (createCommunicatingJob) 阶段。
"pool-job" - Pool job test (createCommunicatingJob) 阶段。
"parpool" - Parallel pool test (parpool) 阶段。
"spark" - Spark job test (tall) 阶段。
"tall" - Tall evaluation test (tall gather) 阶段。

某些阶段仅适用于特定的并行环境或集群类型。如果指定了 StagesToSkip 参量，则不能指定此参量。要了解每个阶段的详细信息，请参阅验证阶段列表。

示例: StagesToRun=["job","parpool"]

数据类型: char | string | cell

`StagesToSkip` — 可跳过的验证阶段
字符串数组 | 字符向量元胞数组

要跳过的验证阶段，指定为字符串数组或字符向量元胞数组，其中包含一个或多个以下阶段值：

"parcluster" - Cluster connection test (parcluster) 阶段。
"job" - Job test (createJob) 阶段。
"spmd-job" - SPMD job test (createCommunicatingJob) 阶段。
"pool-job" - Pool job test (createCommunicatingJob) 阶段。
"parpool" - Parallel pool test (parpool) 阶段。
"spark" - Spark job test (tall) 阶段。
"tall" - Tall evaluation test (tall gather) 阶段。

某些阶段仅适用于特定的并行环境或集群类型。如果指定了 StagesToRun 参量，则不能指定此参量。要了解每个阶段的详细信息，请参阅验证阶段列表。

示例: StagesToSkip=["job","spmd-job"]

数据类型: char | string | cell

`ReportFile` — 保存验证报告的文件
字符向量 | 字符串

保存验证报告的文件名，指定为字符向量或字符串。

如果未设置 ReportFile 参量且验证成功，则 validate 不会创建报告。如果未设置 ReportFile 参量且验证失败，validate 会自动创建一个验证报告并将其保存在临时文件夹中。

示例: ReportFile="validation.txt"

数据类型: char | string

算法

全部折叠

验证阶段列表

validate 函数执行这些验证阶段。

验证阶段	描述
`Cluster connection test (parcluster)`	对于远程集群对象，该功能会测试集群连接并显示集群延迟。
`Job test (createJob)`	使用 `createJob` 函数测试独立作业的创建。
`SPMD job test (createCommunicatingJob)`	使用 `createCommunicatingJob` 函数测试使用启用了 SPMD 的并行池创建批处理作业。
`Pool job test (createCommunicatingJob)`	使用 `createCommunicatingJob` 函数测试并行池中批处理作业的创建。
`Parallel pool test (parpool)`	使用 `parpool` 函数创建交互式并行池。
`Spark job test (tall)`	测试在 Spark™ 集群上创建作业。
`Tall evaluation test (tall gather)`	使用 `tall` 和 `gather` 函数对 Spark 集群上的 tall 数组进行测试评估。

版本历史记录

在 R2026a 中推出

另请参阅

parallel.validateProfile | parcluster

validate

语法

说明

示例

验证集群对象

指定验证阶段

输入参数

myCluster — 集群 parallel.Cluster 对象

名称-值参数

NumWorkersToUse — 要使用的工作单元 非负整数

StagesToRun — 验证阶段需执行 字符串数组 | 字符向量元胞数组

StagesToSkip — 可跳过的验证阶段 字符串数组 | 字符向量元胞数组

ReportFile — 保存验证报告的文件 字符向量 | 字符串

算法

验证阶段列表

版本历史记录

另请参阅

`myCluster` — 集群
`parallel.Cluster` 对象

`NumWorkersToUse` — 要使用的工作单元
非负整数

`StagesToRun` — 验证阶段需执行
字符串数组 | 字符向量元胞数组

`StagesToSkip` — 可跳过的验证阶段
字符串数组 | 字符向量元胞数组

`ReportFile` — 保存验证报告的文件
字符向量 | 字符串