fetchOutputs
ジョブ内の全タスクから出力引数を取得する
説明
は、完了したジョブのタスクに含まれる出力引数を取得します。data
= fetchOutputs(j
)
createJob
または createCommunicatingJob
を使用して作成するジョブから出力を取得する場合、m
行 n
列の cell 配列である data
の各行には、ジョブ内にある m
件のタスクそれぞれの出力引数が含まれます。data
の各行には n
個の要素があります。ここで、n
はジョブ内の任意のタスクにある出力引数の数のうち、最大のものです。行の n
個の要素は、そのタスクの出力引数を含む配列です。タスクの出力引数が n
個未満の場合、そのタスクの行内の余分な要素は空になります。
batch
を使用して作成するジョブから出力を取得する場合は、次のようになります。
fcn
構文を使用してバッチ ジョブを作成し、N
個の出力を指定する場合、data
は1
行N
列の cell 配列です。script
またはexpression
構文を使用してバッチ ジョブを作成する場合、data
は構造体スカラーを含む1
行1
列の cell 配列です。バッチ ジョブを作成する際にPool
引数を指定する場合、この構造体スカラーにはクライアントとして機能するワーカーのワークスペースが含まれます。それ以外の場合、構造体スカラーにはジョブを実行するワーカーのワークスペースが含まれます。
ジョブの出力データは、ジョブが実行されるクラスターの JobStorageLocation
プロパティで指定された場所に格納されます。fetchOutputs
を実行しても、出力データは JobStorageLocation
から削除されません。出力データを削除するには、関数 delete
を使用して個々のタスクまたはジョブ全体を削除します。
以下の場合、関数 fetchOutputs
はエラーをスローします。
ジョブ
j
のState
プロパティが'finished'
でない。ジョブ
j
のState
が'finished'
で、ジョブj
のTasks
プロパティで指定されたタスクのいずれかでエラーが発生している。
ヒント
ジョブ j
のタスクのいずれかがエラーの発生後に失敗しているかどうかを確認するには、j.Tasks.Error
が空かどうかを確認します。返される配列が空の場合、ジョブ j
にエラーが発生したタスクはありません。
一部のタスクが正常に完了している場合、タスクの OutputArguments
プロパティを使用してそのタスクの出力引数に直接アクセスできます。
例
入力引数
バージョン履歴
R2012a で導入