parallel.Task
访问任务属性和行为
容器层次结构
父 | parallel.Job |
子 | 无 |
描述
parallel.Task 对象提供对任务的访问,该工作单元作为作业上执行。
类型
下表描述了可用的任务对象类型,由集群的类型决定。
| 任务类型 | 描述 |
|---|---|
| parallel.task.MJSTask | MATLAB® 作业调度器集群上的任务 |
| parallel.task.CJSTask | CJS 集群上的任务 |
方法
所有任务类型对象都有相同的方法,如下表所述。
| cancel | Cancel job or task |
| delete | Remove job or task object from cluster and memory |
属性
适用于所有任务类型
以下属性是所有任务对象类型所共有的。
| 属性 | 描述 |
|---|---|
CaptureDiary | 指定是否返回日记输出 |
CreateDateTime | 任务创建的日期和时间 |
Diary | 执行任务对象的函数产生的文本 |
Error | 任务错误信息 |
ErrorIdentifier | 任务错误标识符 |
ErrorMessage | 任务错误消息 |
FinishDateTime | 任务完成的日期和时间 |
Function | 评估任务时调用的函数 |
ID | 任务的数值标识符 |
InputArguments | 任务函数的输入参量 |
Name | 此任务的名称 |
NumOutputArguments | 任务函数返回的参量数量 |
OutputArguments | 在工作单元上运行任务函数的输出参量 |
Parent | 包含此任务的作业对象 |
RunningDuration | 任务的当前持续时间,指定为 duration 对象。 |
StartDateTime | 任务开始的日期和时间 |
State | 任务的当前状态 |
UserData | 与此任务对象关联的信息 |
Warnings | 任务执行过程中发出的警告信息,被捕获在一个包含字段 message、identifier 和 stack 的结构体数组中 |
Worker | 表示运行此任务的工作单元的对象 |
MATLAB 作业调度器任务
MATLAB 作业调度器任务对象除了具有公共属性外,还具有以下属性:
| 属性 | 描述 |
|---|---|
FailureInfo | 失败任务返回的信息 |
FinishedFcn | 任务完成时在客户端执行回调 |
MaximumRetries | 重新运行失败任务的最大次数 |
NumFailures | 任务失败的次数 |
RunningFcn | 任务开始运行时在客户端执行的回调 |
Timeout | 完成任务的时间限制(以秒为单位) |
CJS 任务
CJS 任务对象除了具有公共属性外,还具有以下属性:
| 属性 | 描述 |
|---|---|
SchedulerID | 如果您已将任务提交给第三方调度器,这是调度器在提交时为任务提供的 ID。例如,这对应于 SLURM 调度器上的 |
帮助
要获得有关任一类型的 parallel.Task 对象的更多帮助,包括其属性的帮助链接列表,请输入:
help parallel.task.MJSTask help parallel.task.CJSTask
版本历史记录
在 R2012a 中推出