主要内容

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

ClusterPool

计算机集群上的并行工作单元池

说明

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

创建对象

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

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

  • 使用 partition 函数从现有并行池创建池分区。 (自 R2025a 起)

属性

全部展开

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

此 属性 为只读。

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

数据类型: logical

此 属性 为只读。

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

此 属性 为只读。

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

数据类型: logical

此 属性 为只读。

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

此 属性 为只读。

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

数据类型: FevalQueue

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

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

此 属性 为只读。

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

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

此 属性 为只读。

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

此 属性 为只读。

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

数据类型: logical

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

自 R2025a 起

此 属性 为只读。

并行池中工作单元的信息,以 parallel.Worker 对象数组的形式返回。

对象函数

addAttachedFiles将文件或文件夹附加到并行池
Composite从客户端创建并访问多个工作单元上的非分布式变量
delete关闭并行池
listAutoAttachedFiles自动附加到作业、任务或并行池的文件列表
parfeval在并行池工作单元上运行函数
parfevalOnAll在并行池中的所有工作单元上异步运行函数
parforOptionsparfor 设置的选项
partition对并行池进行分区
ticBytes开始计算并行池中传输的字节数
tocBytes读取自调用 ticBytes 以来已传输了多少字节
updateAttachedFiles更新并行池上的附加文件或文件夹
spmd在并行池的工作单元上并行执行代码

版本历史记录

在 R2020a 中推出

全部展开