<p>物体検出用のアノテーションツールである<code>labelImg</code>の導入方法についてまとめる。</p>
<aside class="msg message"><span class="msg-symbol">!</span><div class="msg-content">
<p>普段、開発作業を行わない人向けに初歩的な部分まで記載しています。<br>
また、最新の情報まで追えておらず少し情報が古いです。<br>
適宜追記予定。</p>
</div></aside>
<hr>
<h2 id="python%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">
<a class="header-anchor-link" href="#python%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> pythonのインストール</h2>
<p><code>labelme</code>はpythonアプリケーションとして展開されているので、pythonのインストールが必要。<br>
pythonはlabelmeの動作の関係上、<code>3.9</code>以下あるいは<code>3.11</code>を推奨</p>
<ul>
<li>
<a href="https://www.python.org/downloads/release/python-3913/" target="_blank" rel="nofollow noopener noreferrer">python-3913</a><br>
・Windows installer (64-bit)</li>
<li>
<a href="https://www.python.org/downloads/release/python-3111/" target="_blank" rel="nofollow noopener noreferrer">python-3111</a><br>
・Windows installer (64-bit)</li>
</ul>
<p>カスタム設定は必要ないのでデフォルト設定のままインストール<br>
デフォルトではpythonは<code>%LOCALAPPDATA%\Programs\Python</code>にインストールされる</p>
<hr>
<h2 id="labelimg%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">
<a class="header-anchor-link" href="#labelimg%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> labelImgのインストール</h2>
<p><code>labelImg</code>を動作させるために必要なパッケージのインストール</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash">pip <span class="token function">install</span> PyQT5
pip <span class="token function">install</span> lxml
</code></pre></div><hr>
<h2 id="%E4%BD%9C%E6%A5%AD%E3%83%87%E3%82%A3%E3%83%AC%E3%82%AF%E3%83%88%E3%83%AA%E3%81%AE%E4%BD%9C%E6%88%90%E3%81%A8%E7%A7%BB%E5%8B%95">
<a class="header-anchor-link" href="#%E4%BD%9C%E6%A5%AD%E3%83%87%E3%82%A3%E3%83%AC%E3%82%AF%E3%83%88%E3%83%AA%E3%81%AE%E4%BD%9C%E6%88%90%E3%81%A8%E7%A7%BB%E5%8B%95" aria-hidden="true"></a> 作業ディレクトリの作成と移動</h2>
<div class="code-block-container"><pre class="language-bat"><code class="language-bat">cd %USERPROFILE%
mkdir work\annotation_tool &amp;&amp; cd work\annotation_tool
</code></pre></div><p><a href="https://github.com/heartexlabs/labelImg" target="_blank" rel="nofollow noopener noreferrer">こちら</a>からプロジェクトをDL(<code>&lt;&gt; Code</code> -&gt; <code>Download ZIP</code>をクリック)して上記ディレクトリに格納</p>
<p>以下を初回だけ実行</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash"><span class="token builtin class-name">cd</span> labelImg
pyrcc5 <span class="token parameter variable">-o</span> libs/resources.py resources.qrc
</code></pre></div><hr>
<h2 id="%E8%B5%B7%E5%8B%95">
<a class="header-anchor-link" href="#%E8%B5%B7%E5%8B%95" aria-hidden="true"></a> 起動</h2>
<div class="code-block-container"><pre class="language-bat"><code class="language-bat">cd %USERPROFILE%\work\annotation_tool
python labelImg.py
</code></pre></div><hr>
<h2 id="%E3%82%A2%E3%83%8E%E3%83%86%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E6%96%B9%E6%B3%95">
<a class="header-anchor-link" href="#%E3%82%A2%E3%83%8E%E3%83%86%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E6%96%B9%E6%B3%95" aria-hidden="true"></a> アノテーション方法</h2>
<p>以下のフォルダ構成でフォルダを準備</p>
<div class="code-block-container"><pre><code>dataset
├── images
└── xmls
</code></pre></div><p><code>images</code>: 画像保存フォルダ<br>
<code>xmls</code>:  アノテーション情報を格納するxmlファイルを保存するフォルダ</p>
<h3 id="%E7%94%BB%E5%83%8F%E3%83%95%E3%82%A9%E3%83%AB%E3%83%80%E3%82%92%E9%96%8B%E3%81%8F">
<a class="header-anchor-link" href="#%E7%94%BB%E5%83%8F%E3%83%95%E3%82%A9%E3%83%AB%E3%83%80%E3%82%92%E9%96%8B%E3%81%8F" aria-hidden="true"></a> 画像フォルダを開く</h3>
<p>アノテーション対象のフォルダを格納しているフォルダを開く<br>
<code>ファイル</code> -&gt; <code>ディレクトリを開く</code>をクリックし、画像フォルダを選択</p>
<h3 id="%E3%82%A2%E3%83%8E%E3%83%86%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%83%87%E3%83%BC%E3%82%BF%E3%82%92%E4%BF%9D%E5%AD%98%E3%81%99%E3%82%8B%E3%83%95%E3%82%A9%E3%83%AB%E3%83%80%E3%82%92%E8%A8%AD%E5%AE%9A">
<a class="header-anchor-link" href="#%E3%82%A2%E3%83%8E%E3%83%86%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%83%87%E3%83%BC%E3%82%BF%E3%82%92%E4%BF%9D%E5%AD%98%E3%81%99%E3%82%8B%E3%83%95%E3%82%A9%E3%83%AB%E3%83%80%E3%82%92%E8%A8%AD%E5%AE%9A" aria-hidden="true"></a> アノテーションデータを保存するフォルダを設定</h3>
<p>アノテーション情報を格納するjsonファイルを保存するフォルダを設定する<br>
<code>ファイル</code> -&gt; <code>保存先を変更する</code>をクリックし、jsonファイルを保存するフォルダを選択</p>
<h3 id="%E8%87%AA%E5%8B%95%E4%BF%9D%E5%AD%98">
<a class="header-anchor-link" href="#%E8%87%AA%E5%8B%95%E4%BF%9D%E5%AD%98" aria-hidden="true"></a> 自動保存</h3>
<p><code>表示</code> -&gt; <code>自動で保存する</code>で次の画像に進む時に自動的にアノテーション情報を保存するように設定しておく</p>
<h3 id="%E3%83%A9%E3%83%99%E3%83%AB%E3%83%AA%E3%82%B9%E3%83%88%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6">
<a class="header-anchor-link" href="#%E3%83%A9%E3%83%99%E3%83%AB%E3%83%AA%E3%82%B9%E3%83%88%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" aria-hidden="true"></a> ラベルリストについて</h3>
<p><code>labelImg\data</code>配下にラベルリスト(例として<code>\custom_classes.txt</code>とする)を追加し以下のコマンドで起動するとラベルリストをインポートして<code>labelImg</code>を起動することができる。<br>
リストから選択してラベルを付与することができるので手入力によるラベルミスがなくなる。</p>
<div class="code-block-container"><pre class="language-bat"><code class="language-bat">cd %USERPROFILE%\work\annotation_tool
python labelImg.py class_file data\custom_classes.txt
</code></pre></div><h2 id="%E3%82%B7%E3%83%A7%E3%83%BC%E3%83%88%E3%82%AB%E3%83%83%E3%83%88%E3%82%AD%E3%83%BC">
<a class="header-anchor-link" href="#%E3%82%B7%E3%83%A7%E3%83%BC%E3%83%88%E3%82%AB%E3%83%83%E3%83%88%E3%82%AD%E3%83%BC" aria-hidden="true"></a> ショートカットキー</h2>
<p>公式にも記載されているが、一部注意点があるので記載<br>
覚えているとアノテーション効率が上がる。</p>
<table>
<thead>
<tr>
<th>ショートカットキー</th>
<th>アクション</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<code>ctrl</code> + <code>h</code>
</td>
<td>矩形の非表示</td>
</tr>
<tr>
<td>
<code>ctrl</code> + <code>a</code>
</td>
<td>矩形の表示</td>
</tr>
<tr>
<td>
<code>ctrl</code> + <code>+</code>
</td>
<td>ズームイン</td>
</tr>
<tr>
<td>
<code>ctrl</code> + <code>-</code>
</td>
<td>ズームアウト</td>
</tr>
<tr>
<td>
<code>ctrl</code>  + <code>shift</code> + (テンキーの<code>+</code>)</td>
<td>画像を一時的に明るくする</td>
</tr>
<tr>
<td>
<code>ctrl</code>  + <code>shift</code> + (テンキーの<code>-</code>)</td>
<td>画像を一時的に暗くする</td>
</tr>
<tr>
<td><code>d</code></td>
<td>次の画像</td>
</tr>
<tr>
<td><code>a</code></td>
<td>前の画像</td>
</tr>
</tbody>
</table>
<hr>
<h2 id="reference">
<a class="header-anchor-link" href="#reference" aria-hidden="true"></a> reference</h2>
<ul>
<li><a href="https://github.com/heartexlabs/labelImg" target="_blank" rel="nofollow noopener noreferrer">heartexlabs/labelImg</a></li>
</ul>


labelImgの導入方法(Windows)

作業ディレクトリの作成と移動

アノテーションデータを保存するフォルダを設定

Discussion