VGG Image Annotator (VIA)：お手軽アノテーションツール

• 以下のURLから、via-2.0.10.zipをダウンロードし、好きなディレクトリに解凍する。この例では~/srcに解凍する。
  • http://www.robots.ox.ac.uk/~vgg/software/via/
• 画像を読み込むディレクトリと、プロジェクトを保存するディレクトリを事前に用意し、画像読み込み用のディレクトリに、アノテーションする画像を入れておく。この例では「sample」という名前で作成しているが、名前は自由。
  • 端末を開き以下のコマンドを実行して、画像読み込み用のディレクトリを作成する。
    • $ cd ~/src/via-2.0.10/data
    • $ mkdir sample
    • $ cd sample
    • 訓練用データ、検証用データを格納する。trainとvalディレクトリを作成する。画像データをtrainに9割、valに1割になるように保存する。
    • $mkdir train  val
  • プロジェクト保存用ディレクトリを作成する。
    • $ cd  ~/via-2.0.10
    • $ mkdir project
    • $ cd project
    • $ mkdir sample
    • $ mkdir train  val

アノテーション作業

• ファイルマネージャーを使って以下のファイルをダブルクリックして起動する。
  • ~/src/via-2.0.10/dist/via.html
• 画像を読み込むには、左にあるバーの赤丸で囲んだ[Add Files]を左クリックした後に、画像読み込み用ディレクトリまで移動し、画像を選択する。選択に成功した場合、以下のように選択した画像が表示される。

• Region Shapeの中の形状を選択しアノテーションする。右から3番目の[Polygon region shape (多角形)]を選択した場合は、多角形の頂点で左マウスボタンをクリックし、アノテーション終了時にはEnterキーを押す。

• アノテーションしてできた各形状を区別するためにその属性(name, type, image_qualityなど)を定義しなければならない。左サイドバーのAttributesにキーボード入力できる欄がある。そこに「name」と入力し、他の欄に下図のように入力し、横にある「+」を左クリックする。それから下の[Toggle Annotation Editor]をクリックする。
  
• [name]を入力する欄が下図のように出る。[name]にはクラス名を入れる。ここではじゃんけんのパーを表す「paper」を入力する。
  
• 現在、表示している画像のアノテーションが終われば、キーボードの「→」キーを入力し、次の画像をアノテーションする。このソフトウェアにおけるショートカットキーは、左サイドバーのなかにあるKeyboard Shortcutsの中に記載されている。他の例として、キーボードの「↑」キーを入力することで、下図のように、ラベリング情報の表示形式を変更できる。デフォルトでは番号になっているが、上で付けたnameのpaperと表示されている。

JSONファイルの出力

アノテーションした情報を教師データとして使われるJSON(JavaScript Object Notation)フォーマットのファイルに出力する。JSONはウェブ等で良く使われる軽量のデータ交換フォーマットである。

• アノテーション作業が全て終了したら、その情報をJSONファイルに出力する。COCOフォーマットで出力したいときは、上のバーのAnnotationからExport Annotations (COCO Format)を左クリックして選択する。
• 「via-***_coco.json」というファイル名で保存される。このファイルは学習と検証に使われるので画像読み込み用ディレクトリのtrainまたはvalに移動させる。この例では、trainの中の画像をアノテーションしていると仮定しているので、端末を開き以下のコマンドを実行して、trainへ移動する。
  • $ cd ~/src/via-2.0.10
  • $ mv via_***_coco.json  ~/via-2.0.10/data/sample/train

分担作業した場合のJSONファイルの作り方

アノテーション作業を複数人で実施して、お互いのアノテーションデータを統合したい場合が良くあると思うのでここで説明する。

• 各人のtrainディレクトリにある画像データをアノテーション作業した要領で読み込み、アノテーションファイルをメニューバーの[Annotation]→[Import Annotations (***)]から読みこむ。ここで***は保存したAnnotationの形式で、(from csv)、 (from json)、 (from COCO format)の３タイプがあるのでファイル名を見て適切なものを選択する。COCO formatの場合は拡張子jsonの前にcocoがついている（つまり、coco.json)。
• 画像ファイルの統合。統合用のtrainディレクトリを新たに作成する。各人のtrainディレクトリの画像ファイルを新しく作成した統合用trainディレクトリにコピーする。
• あとはアノテーションファイルを統合用trainディレクトリにエクスポートするだけ。[Annotation]→[Export Annotations (COCO format)]でファイルを統合用trainディレクトリにエクスポートする。
• 上と同じ作業をevalディレクトリに対しても行う。

プロジェクトの保存

アノテーション情報をプロジェクトとして保存することで、そのファイルを読み込めば前回終了した画像の続きからアノテーションを再開できる。

• プロジェクトの保存の前に、読み込んでいる画像へのパスを指定する。上のバーのProjectからSettingsに移動。
• Default Pathに画像へのパスを入力する。この例で、trainのディレクトリから読み込んでいるので、パスは以下になる。
  • ~/src/via-2.0.10/data/sample/train/
• 最後に、下の「Save」ボタンを左クリックして設定完了。
• 次に、プロジェクトを保存する。上のバーのProjectからSaveを選択。Project Nameを好きな名前に変更してOKを左クリックすると本プロジェクトがJSONファイル形式で保存される。

• このファイルをプロジェクト保存用ディレクトリに移動する。
  • $ cd download
  • $ mv star.json  ~/via-2.0.10/project/sample/train

プロジェクトの読み込み

• 上のバーのProjectからLoadを選択する。そこからプロジェクト(JSONファイル(jsonファイル)