Main Content

本页采用了机器翻译。点击此处可查看最新英文版本。

ClusterPool

机器集群上的并行工作进程池

自 R2020a 起

说明

使用 parpool 在机器集群上创建并行工作进程池。创建池后,并行池功能(例如 parforparfeval)将在工作进程上运行。通过 ClusterPool 对象,您可以与并行池进行交互。

创建对象

使用 parpool 函数在机器集群上创建并行池。

pool = parpool("myCluster")
其中 myCluster 是机器集群的集群配置文件的名称。

属性

全部展开

复制到工作进程的文件和文件夹,指定为字符向量单元格数组。要将文件和文件夹附加到池,请使用 addAttachedFiles

此 属性 为只读。

指示客户端路径上用户添加的条目是否添加到工作进程路径,指定为逻辑值。

数据类型: logical

此 属性 为只读。

并行池正在运行的集群,指定为 parallel.Cluster 对象。

此 属性 为只读。

指示并行池是否正在运行的标志,指定为逻辑值。

数据类型: logical

此 属性 为只读。

复制到工作进程的环境变量,指定为字符向量单元格数组。

此 属性 为只读。

在并行池上运行的 FevalFutures 队列,作为 FevalQueue 对象返回。您可以使用此属性来检查并行池的待处理和正在运行的未来变量。要创建未来变量,请使用 parfevalparfevalOnAll。有关未来变量的更多信息,请参阅 Future

数据类型: FevalQueue

客户端和工作进程均可访问的文件存储,指定为 FileStore 对象。

池在空闲时关闭的时间(以分钟为单位),指定为大于零的整数。如果池未在工作进程上运行代码,则该池处于空闲状态。默认情况下,'IdleTimeout' 与并行选项中的值相同。有关并行首选项的更多信息,请参阅 指定您的并行首选项

此 属性 为只读。

组成并行池的工作进程数量,指定为整数。

ClusterPool 对象支持最多包含 2000 个工作进程的池。 (自 R2024a 起)

此 属性 为只读。

指示并行池是否繁忙的标志,指定为 truefalse。如果有未完成的工作需要池完成,则该池很忙。

此 属性 为只读。

指示池是否可以运行 spmd 代码,指定为逻辑值。

数据类型: logical

客户端和工作进程均可访问的数据存储,指定为 ValueStore 对象。

对象函数

addAttachedFiles将文件或文件夹附加到并行池
delete关闭并行池
listAutoAttachedFiles自动附加到作业、任务或并行池的文件列表
parfeval在并行池工作进程上运行函数
parfevalOnAll在并行池中的所有工作进程上异步运行函数
ticBytes开始计算并行池中传输的字节数
tocBytes读取自调用 ticBytes 以来已传输了多少字节
updateAttachedFiles更新并行池上的附加文件或文件夹

版本历史记录

在 R2020a 中推出

全部展开