AnnoBoost の使い方
サインイン、画像フォルダの読み込み、BBox作成、データセット生成、学習、自動ラベル、Wチェック、変換までの基本操作を順に確認します。
このガイドで作るもの
このページでは、画像フォルダを読み込み、BBoxを作成し、学習用データセットを生成します。その後、学習済みモデルで自動ラベル候補を作成し、人がWチェックして、最後にYOLO txt / COCO json / VOC xml へ出力します。
Step 0 — 有効化から初回起動
アノテーション作業の前に、WebからDesktopまでの開始ルートを完了します。アカウント作成はWebだけで行い、Desktopではサインインだけを行います。
Trialまたはプランを有効化
Webでアカウントを作成してメール認証し、無料Trialを明示的に開始するか有料Checkoutを完了します。SignupだけではTrialは開始しません。
Plansを開く ->Windows版をDownload
InstallerまたはPortable ZIPを選びます。ページは公開ですが、保護されたファイルURLは利用可能なログイン済みAccountだけに発行されます。
Downloadを開く ->インストールまたは展開して起動
Installerを実行するか、ZIPを展開してから起動します。署名・timestampの案内は、Downloadページに対応する成果物情報が表示されている場合だけ検証済みとして扱います。
導入情報を確認 ->Setup diagnosticsを実行
手動BBox作業だけなら学習runtimeは不要です。学習または自動ラベルの前にsetup diagnosticsを実行し、失敗した場合はstable error codeを控えます。
診断手順を見る ->最初の成功ルート
作業の流れ
作業前の確認
- サインインできる AnnoBoost アカウントと有効なライセンスを用意します。
- 学習や自動ラベリングを使う場合だけ、必要に応じてセットアップ状態を確認します。
- 最初は小さな画像フォルダで、生成・学習・確認の流れを短く試します。
Step 1 サインイン
目的
AnnoBoost のアカウントとライセンス状態を確認し、アプリを使える状態にします。
操作
アカウント作成時のメールアドレスとパスワードを入力します。Server connection: OK を確認して、Sign in を押します。
確認
サインインに成功すると、ワークスペース画面へ進みます。
注意
初回サインイン時は、サーバー接続とライセンス確認のためインターネット接続が必要です。一度サインインすると、ライセンス有効期間中はオフラインでもデスクトップアプリを利用できます。サーバー接続またはライセンス確認に失敗すると、サインインできません。
Step 2 画像フォルダを開く
目的
このプロジェクトでラベル付けする画像フォルダを読み込み、正しい画像セットを作業していることを確認します。
操作
File > Open folder から画像フォルダを選びます。読み込み後、画像一覧から数枚を切り替えて、キャンバス表示が正しく更新されるか確認します。
確認
画像一覧にファイルが表示され、選択中の画像がキャンバスに表示され、画像を切り替えられることを確認します。既存のBBoxは、アノテーションデータがある場合だけ表示されます。
注意
画像一覧が空の場合は、対応画像が入っていない、別フォルダを選んでいる、またはパスに問題がある可能性があります。既存のBBoxは、フォルダにアノテーションデータがある場合だけ表示されます。フォルダを開くだけで自動作成されるものではありません。
この例では既存のアノテーションデータがあるためBBoxが表示されています。画像フォルダを開くだけでBBoxが自動作成されるわけではありません。
Step 3 クラスとBBoxを作成
目的
モデルに学習させたい対象クラスを決め、最初の正解ラベルとなるBBoxを作成します。
操作
クラスを作成または選択してから、対象物をBBoxで囲みます。BBoxは対象物を切らず、不要な背景を含めすぎないように描きます。
確認
選択中のクラス名とBBoxラベルが一致していることを確認します。画像を切り替えても、作成したBBoxが正しく表示されるか確認します。
注意
初期段階でクラスを増やしすぎると、学習品質と確認作業が不安定になります。最初は少ないクラスで、正確なBBoxを作ることを優先してください。
Step 4 データセットを生成
目的
作成したアノテーションを、学習で使えるデータセットフォルダに変換します。
操作
出力名、保存先、train / validation / test の分割比率を設定します。必要な場合だけ水増しを有効にします。設定を確認したら、データセット生成を開始します。
確認
生成後、出力データセットフォルダが作成され、画像・ラベル・設定ファイルが入っていることを確認します。このデータセットが次の学習入力になります。
注意
水増しはラベルの間違いを修正する機能ではありません。元のBBox品質が低いまま水増しすると、間違ったラベルも増えます。
Step 5 モデルを学習
目的
出力したデータセットを使って、対象クラスを検出するモデルを学習します。
操作
Training parameters で dataset、classes、train_images、val_images を確認します。最初は batch、img、epochs を控えめにして開始します。
確認
学習が完了し、学習済みモデルまたはチェックポイントが保存されていることを確認します。その出力が次の自動ラベリングで使うモデルになります。
注意
GPUメモリ不足や停止が起きた場合は、まず batch または img を下げます。大きな設定は学習時間とGPUメモリ使用量を増やします。
画像サイズやエポック数は同じ学習パラメータ内で確認します。最初は小さめの設定で動作確認するのが安全です。
Step 6 自動ラベル候補を作成
目的
学習済みモデルで未確認画像に候補BBoxを作成し、人の確認作業を短縮します。
操作
通常は Dataset Mode を選びます。特定のモデルファイルを指定する場合だけ Explicit Model Mode を使います。必要に応じて Score threshold を調整して実行します。
確認
完了後、画像上に候補BBoxが表示されることを確認します。これは確定ラベルではないため、出力前に必ずWチェックへ進みます。
注意
自動ラベリング結果は確定ラベルではありません。迷った場合は Dataset Mode を選び、Score threshold と NMS threshold は初期値のまま実行します。候補が多すぎる、または重複が多い場合だけ調整します。
Step 7 Wチェック
目的
自動ラベリングで作成された候補を、人が確認して信頼できるラベルにします。
操作
画像ごとに、抜け、誤検出、クラス違い、BBoxの位置ずれを確認します。必要に応じてBBoxを追加、削除、移動、リサイズします。
確認
抜け、誤検出、クラス違い、BBoxの位置やサイズの誤りを確認済みにします。Wチェック済みのラベルだけを次の出力へ進めます。
注意
この工程は任意ではありません。自動ラベリング結果をそのまま納品・学習用データとして扱うと、誤検出や漏れが混ざる可能性があります。
Step 8 形式変換して出力
目的
Wチェック済みのラベルを、次に使う学習ツール・納品形式・外部パイプラインに合わせて出力します。
操作
Convert formats から YOLO txt、COCO json、VOC xml のいずれかを選びます。YOLO系の学習には YOLO txt、COCO対応ツールには COCO json、Pascal VOC形式が必要な場合は VOC xml を使います。
確認
完了後、選択した形式のファイルが出力フォルダに作成され、次のツールや納品ワークフローへ渡せることを確認します。
注意
形式を間違えると、次に使うツールで読み込めません。出力前に、相手側のツールや納品条件が求める形式を確認してください。
トラブルシューティングとセットアップ確認
学習、自動ラベリング、変換が想定どおり進まない場合にだけ確認します。
セットアップ診断
目的
学習や自動ラベリングに必要なローカル実行環境が準備できているか確認します。
操作
学習や自動ラベリングが開始前に失敗する場合、アプリメニューからセットアップ確認を開きます。
確認
PASS の項目は準備済みです。失敗した項目がある場合は詳細を確認します。
注意
通常の手動BBox作成だけを行う場合、この確認は必須ではありません。
セットアップ検証の進行状況
目的
学習や自動ラベリングを再実行する前に、セットアップ検証が完了するのを待ちます。
操作
進行状況が完了するまで検証ダイアログを開いたまま待ちます。時間がかかる場合は詳細ログを確認します。
確認
最新ログが更新されるか、最終結果が表示されることを確認します。
注意
検証が繰り返し失敗する場合は、サポート用に診断内容を残してください。
途中で止まった場合
該当FAQを確認し、アプリに表示されたstable error codeを控え、private support ticketを作成してください。診断レポートはDesktopの明示操作からだけ添付し、public boardへ診断やAccount情報を投稿しないでください。