README.jp.rst

labelImg

LabelImgは、PythonとQtを使うアノテーション補助ツールです。

このツールはPascalVOCフォーマットとYOLOとCreateMLをサポートしています。

`サンプル動画は <https://youtu.be/p0nR2YsCY_U>にあります。`__

インストール方法

ソースからビルドする

Linuxまたは、Ubuntuまたは、macOSの場合は

Ubuntuの場合

Python 3とQt5を使う場合

sudo apt-get install pyqt5-dev-tools
sudo pip3 install -r requirements/requirements-linux-python3.txt
make qt5py3
python3 labelImg.py
python3 labelImg.py [IMAGE_PATH] [PRE-DEFINED CLASS FILE]

macOSの場合

Python 3とQt5を使う場合

brew install qt  # Install qt-5.x.x by Homebrew
brew install libxml2

or using pip

pip3 install pyqt5 lxml # Install qt and lxml by pip

make qt5py3
python3 labelImg.py
python3 labelImg.py [IMAGE_PATH] [PRE-DEFINED CLASS FILE]

Python 3 Virtualenv (推奨)

VirtualenvはQtとPythonのバージョン衝突問題を解消できます。

brew install python3
pip3 install pipenv
pipenv run pip install pyqt5==5.15.2 lxml
pipenv run make qt5py3
pipenv run python3 labelImg.py
[任意で] rm -rf build dist; python setup.py py2app -A;mv "dist/labelImg.app" /Applications

注意：最後のコマンドを実行すると、/ApplicationsフォルダにSVGアイコンを含む.appファイルが生成されます。build-tools/build-for-macos.shというスクリプトの仕様も検討してください。

Windowsの場合

最初に`Python <https://www.python.org/downloads/windows/>`__ と PyQt5 と install lxml をインストールしてください。

コマンドプロンプトを起動し labelImg がインストールされているフォルダに移動してから以下のコマンドを実行します。

pyrcc4 -o libs/resources.py resources.qrc
（pyqt5の場合は、 pyrcc5 -o libs/resources.py resources.qrc）

python labelImg.py
python labelImg.py [画像パス] [定義済みクラスファイル]

Windows + Anaconda

Anaconda をダウンロードしてからインストールしてください。

Anaconda Promptを起動し labelImg インストールされているフォルダに移動してから以下のコマンドを実行します。

conda install pyqt=5
conda install -c anaconda lxml
pyrcc5 -o libs/resources.py resources.qrc
python labelImg.py
python labelImg.py [IMAGE_PATH] [PRE-DEFINED CLASS FILE]

PyPIから入手する（Python 3以降のみ）

現代的なLinuxディストリビューションの場合は以下のコマンドを入力するだけでインストールできます。

pip3 install labelImg
labelImg
labelImg [IMAGE_PATH] [PRE-DEFINED CLASS FILE]

Dockerの場合

docker run -it \
--user $(id -u) \
-e DISPLAY=unix$DISPLAY \
--workdir=$(pwd) \
--volume="/home/$USER:/home/$USER" \
--volume="/etc/group:/etc/group:ro" \
--volume="/etc/passwd:/etc/passwd:ro" \
--volume="/etc/shadow:/etc/shadow:ro" \
--volume="/etc/sudoers.d:/etc/sudoers.d:ro" \
-v /tmp/.X11-unix:/tmp/.X11-unix \
tzutalin/py2qt4

make qt4py2;./labelImg.py

あとは`サンプル動画<https://youtu.be/nw1GexJzbCI>`__ を見るだけです。

定義済みクラスを作成するには？

data/predefined_classes.txt を編集してください。

ショートカット一覧

開発に参加するには？

このリポジトリにPull Request を送ってください。