Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

initialize

アルゴリズム実行の状態の初期化 (オプション)

説明

initialize メソッドは、オートメーション アルゴリズムの実行前に、オートメーション アルゴリズムの状態を初期化します。

AutomationAlgorithm のクライアントはこのメソッドを必要に応じて実装できます。

initialize(algObj,frame) は、ラベル付けされるデータの時間間隔の最初のフレームを使用して、algObj オートメーション アルゴリズムの状態を初期化します。

AutomationAlgorithm のクライアントはこのユーザー定義メソッドを実装しなければなりません。

initialize(algObj,frame,labelsToAutomate) はさらに、オートメーション アルゴリズムがラベル付けに使用するよう選択されたラベルを含む table、labelsToAutomate を提供します。この構文は、ピクセル ラベルのオートメーションをサポートしていません。また、この構文は、時間依存 (時間的) オートメーション アルゴリズムでのみ使用できます。グラウンド トゥルース ラベラー (Automated Driving Toolbox) (Automated Driving Toolbox™ が必要) アプリとビデオ ラベラー アプリは時間的アルゴリズムをサポートしていますが、イメージ ラベラーはサポートしていません。これらのタイプのアルゴリズムの詳細については、時間的オートメーション アルゴリズムを参照してください。

入力引数

すべて展開する

オートメーション アルゴリズム。vision.labeler.AutomationAlgorithm オブジェクトとして指定します。

時間間隔の開始位置に対応するフレーム。Image 信号の数値行列か、PointCloud 信号の pointCloud オブジェクトとして指定します。

オートメーション用に選択されているラベル。次の列を持つテーブルとして指定します。

列名説明
Type

ラベル タイプを保持する labelType の列挙値。有効なラベル タイプは次のとおりです。

  • labelType.Rectangle

  • labelType.Cuboid (グラウンド トゥルース ラベラー アプリのみ)

  • labelType.Line

  • labelType.Scene

labelType.PixelLabellabelType.Custom はサポートされていません。

Nameラベルの名前を保持する文字ベクトル。
Timeラベルがマークされた時刻を秒単位で指定する double 型のスカラー。
Position

フレーム内のラベルの位置。このベクトルの形式はラベル タイプによって異なります。

ラベルのタイプPosition の形式
Rectangle — 四角形の関心領域 (ROI) ラベル

[x, y, w, h] 形式の 1 行 4 列の数値ベクトル。ここで、

  • xy は四角形の左上隅を指定します。

  • w は四角形の幅、つまり x 軸に沿った四角形の長さを指定します。

  • h は四角形の高さ、つまり y 軸に沿った四角形の長さを指定します。

Cuboid — 直方体の ROI ラベル

[xctr, yctr, zctr, xlen, ylen, zlen, xrot, yrot, zrot] 形式の 1 行 9 列の数値ベクトル。ここで、

  • xctryctr、および zctr は直方体の中心を指定します。

  • xlenylen、および zlen はそれぞれ、x 軸、y 軸、および z 軸に沿った直方体の長さを指定します。

  • xrotyrot、および zrot はそれぞれ、x 軸、y 軸、および z 軸に沿った直方体の回転角度を指定します。これらの角度は、それぞれが対応する軸の正方向を見たときに、時計回りが正となります。

次の図は、これらの値で直方体の位置をどのように指定するかを示しています。

Line — ポリラインの ROI ラベルポリラインの N 個の点に関する [x1 y1; x2 y2; ... ; xN yN] 形式の N 行 2 列の数値行列。
Scene — シーン ラベル[]

テーブルの各行が、オートメーション用に選択されたラベルに対応しています。次の labelsToAutomate テーブルには、四角形のラベル、5 個の点を持つラインのラベル、直方体のラベルが含まれています。

       Type           Name           Time        Position  
     _________    ____________    _________    ____________
 
     Rectangle    'Car'           0.033333     [1x4 double]
     Line         'LaneMarker'    0.066667     [5x2 double]
     Cuboid       'Truck'         0.099999     [1x9 double] 

R2017a で導入