createTask
ジョブに新しいタスクを作成する
構文
t = createTask(j, F, N, {inputargs})
t = createTask(j, F, N, {C1,...,Cm})
t = createTask(..., 'p1
',v1,'p2
',v2,...)
t = createTask(...,'Profile', 'ProfileName',...)
引数
| タスク オブジェクトまたはタスク オブジェクトを成分とするベクトル |
| タスク オブジェクトが作成されるジョブ |
| タスクが評価されるときに呼び出される関数のハンドル、または関数ハンドルからなる配列 |
| タスク関数の実行から返される出力引数の数。これは double 値、または double 値からなる配列です。 |
| 関数 |
|
|
| オブジェクト作成時に構成されるタスク オブジェクト プロパティ |
| 対応するタスク オブジェクト プロパティの初期値 |
説明
t = createTask(j, F, N, {inputargs})
はジョブ j
に新しいタスク オブジェクトを作成し、追加したタスク オブジェクトへの参照 t
を返します。このタスクは関数ハンドルまたは関数名 F
で指定される関数を、指定された入力引数 {inputargs}
を用いて評価し、N
個の出力引数を返します。
t = createTask(j, F, N, {C1,...,Cm})
は、m
個の cell 配列からなる cell 配列を使用してジョブ j
に m
個のタスク オブジェクトを作成し、それら新しいタスク オブジェクトへの参照を成分とするベクトル t
を返します。各タスクは、関数ハンドルまたは関数名 F
で指定される関数を評価します。cell 配列 C1
は最初のタスクに、C2
は 2 番目のタスクにといった形で、cell 配列ごとに 1 つのタスクが対応して入力引数が提供されます。各タスクは N
個の出力引数を返します。F
が cell 配列の場合、F
の各要素はベクトル内の各タスクの関数を指定します。これには m
個の要素がなければなりません。N
が倍精度型の配列である場合、各要素はベクトル内の各タスクの出力引数の数を指定します。入力 F
、N
および {C1,...,Cm}
からなる多次元行列がサポートされます。F
に cell 配列列が使用されるか、N
に double の配列が使用される場合、その次元は cell 配列からなる入力引数 cell 配列の次元と一致しなければなりません。出力 t
は {C1,...,Cm}
と同数の成分をもつベクトルとなります。通信ジョブには 1 つのタスクしかないため、ベクトル化されたこのような形式のタスクの作成には適していません。
t = createTask(..., '
は、指定されたプロパティ値をもつタスク オブジェクトを追加します。作成されたオブジェクトの有効なプロパティのリストは、p1
',v1,'p2
',v2,...)parallel.Task
オブジェクトのリファレンス ページを参照してください。プロパティ名は文字ベクトルでなければならず、その値はそのプロパティに適した型でなければなりません。これらのプロパティと値のペアで指定された値によって、プロファイルの値がオーバーライドされます。無効なプロパティ名またはプロパティ値が指定された場合、オブジェクトは作成されません。
t = createTask(...,'Profile', 'ProfileName',...)
は、クラスター プロファイル ProfileName
で指定されたプロパティ値をもつタスク オブジェクトを作成します。クラスター プロファイルの定義と適用についての詳細は、クラスターの検出とクラスター プロファイルの使用を参照してください。
例
バージョン履歴
R2006a より前に導入