Add 'labelImg/' from commit 'b33f965b6d14c14f1e46b247f1bf346e03f2e950'

git-subtree-dir: labelImg git-subtree-mainline: dbe80aca78 git-subtree-split: b33f965b6d
2023-02-21 21:52:18 +05:30
parent dbe80aca78 b33f965b6d
commit a52800deb9
117 changed files with 10290 additions and 0 deletions
@@ -0,0 +1,197 @@
+labelImg
+========
+
+.. image:: https://img.shields.io/pypi/v/labelimg.svg
+        :target: https://pypi.python.org/pypi/labelimg
+
+.. image:: https://img.shields.io/github/workflow/status/tzutalin/labelImg/Package?style=for-the-badge   :alt: GitHub Workflow Status
+
+
+.. image:: https://img.shields.io/badge/lang-en-blue.svg
+        :target: https://github.com/tzutalin/labelImg
+
+.. image:: https://img.shields.io/badge/lang-zh-green.svg
+        :target: https://github.com/tzutalin/labelImg/blob/master/readme/README.zh.rst
+
+.. image:: https://img.shields.io/badge/lang-jp-green.svg
+        :target: https://github.com/tzutalin/labelImg/blob/master/readme/README.jp.rst
+
+.. image:: /resources/icons/app.png
+    :width: 200px
+    :align: center
+
+LabelImgは、PythonとQtを使うアノテーション補助ツールです。
+
+このツールはPascalVOCフォーマットとYOLOとCreateMLをサポートしています。
+
+.. image:: https://raw.githubusercontent.com/tzutalin/labelImg/master/demo/demo3.jpg
+     :alt: Demo Image
+
+.. image:: https://raw.githubusercontent.com/tzutalin/labelImg/master/demo/demo.jpg
+     :alt: Demo Image
+
+`サンプル動画は <https://youtu.be/p0nR2YsCY_U>にあります。`__
+
+インストール方法
+-------------------
+
+
+ソースからビルドする
+~~~~~~~~~~~~~~~~~~~~
+
+Linuxまたは、Ubuntuまたは、macOSの場合は
+
+Ubuntuの場合
+^^^^^^^^^^^^
+
+Python 3とQt5を使う場合
+
+.. code:: shell
+
+    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を使う場合
+
+.. code:: shell
+
+    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のバージョン衝突問題を解消できます。
+
+.. code:: shell
+
+    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 <https://www.riverbankcomputing.com/software/pyqt/download5>`__ と
+`install lxml <http://lxml.de/installation.html>`__ をインストールしてください。
+
+コマンドプロンプトを起動し `labelImg <#labelimg>`__ がインストールされているフォルダに移動してから以下のコマンドを実行します。
+
+.. code:: shell
+
+    pyrcc4 -o libs/resources.py resources.qrc
+    （pyqt5の場合は、 pyrcc5 -o libs/resources.py resources.qrc）
+
+    python labelImg.py
+    python labelImg.py [画像パス] [定義済みクラスファイル]
+
+Windows + Anaconda
+^^^^^^^^^^^^^^^^^^
+
+`Anaconda <https://www.anaconda.com/download/#download>`__ をダウンロードしてからインストールしてください。
+
+Anaconda Promptを起動し `labelImg <#labelimg>`__ インストールされているフォルダに移動してから以下のコマンドを実行します。
+
+.. code:: shell
+
+    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ディストリビューションの場合は以下のコマンドを入力するだけでインストールできます。
+
+.. code:: shell
+
+    pip3 install labelImg
+    labelImg
+    labelImg [IMAGE_PATH] [PRE-DEFINED CLASS FILE]
+
+Dockerの場合
+~~~~~~~~~~~~~~~~~
+.. code:: shell
+
+    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 <https://github.com/tzutalin/labelImg/blob/master/data/predefined_classes.txt>`__
+を編集してください。
+
+ショートカット一覧
+~~~~~~~~~~~~~~~~~~
+
+--------------------+--------------------------------------------+
+| Ctrl + u           | そのディレクトリの画像を読み込む              |
+--------------------+--------------------------------------------+
+| Ctrl + r           | アノテーションの生成ディレクトリを変更         |
+--------------------+--------------------------------------------+
+| Ctrl + s           | 保存する                                    |
+--------------------+--------------------------------------------+
+| Ctrl + d           | 現在選択している矩形トラベルをコピー          |
+--------------------+--------------------------------------------+
+| Ctrl + Shift + d   | 現在表示している画像を削除                   |
+--------------------+--------------------------------------------+
+| Space              | 現在の画像に検証済みフラグを立てる            |
+--------------------+--------------------------------------------+
+| w                  | 矩形を生成する                              |
+--------------------+--------------------------------------------+
+| d                  | 次の画像へ移動する                           |
+--------------------+--------------------------------------------+
+| a                  | 前の画像へ移動する                           |
+--------------------+--------------------------------------------+
+| del                | 選択した矩形を削除                           |
+--------------------+--------------------------------------------+
+| Ctrl++             | 画像を拡大                                  |
+--------------------+--------------------------------------------+
+| Ctrl--             | 画像を縮小                                  |
+--------------------+--------------------------------------------+
+| ↑→↓←               | 十字キーで矩形を移動する                     |
+--------------------+--------------------------------------------+
+
+開発に参加するには？
+~~~~~~~~~~~~~~~~~~~~~
+
+このリポジトリにPull Request を送ってください。
@@ -0,0 +1,195 @@
+LabelImg
+========
+
+.. image:: https://img.shields.io/pypi/v/labelimg.svg
+        :target: https://pypi.python.org/pypi/labelimg
+
+.. image:: https://img.shields.io/github/workflow/status/tzutalin/labelImg/Package?style=for-the-badge   :alt: GitHub Workflow Status
+
+.. image:: https://img.shields.io/badge/lang-en-blue.svg
+        :target: https://github.com/tzutalin/labelImg
+
+.. image:: https://img.shields.io/badge/lang-zh-green.svg
+        :target: https://github.com/tzutalin/labelImg/blob/master/readme/README.zh.rst
+
+.. image:: https://img.shields.io/badge/lang-jp-green.svg
+        :target: https://github.com/tzutalin/labelImg/blob/master/readme/README.jp.rst
+
+.. image:: /resources/icons/app.png
+    :width: 200px
+    :align: center
+
+LabelImg 是影像標註工具，它是用python 和 QT 寫成的.
+
+支持的儲存格式包括PASCAL VOC format, YOLO, createML.
+
+.. image:: https://raw.githubusercontent.com/tzutalin/labelImg/master/demo/demo3.jpg
+     :alt: Demo Image
+
+.. image:: https://raw.githubusercontent.com/tzutalin/labelImg/master/demo/demo.jpg
+     :alt: Demo Image
+
+`展示影片 <https://youtu.be/p0nR2YsCY_U>`__
+
+安裝
+------------------
+
+
+透過編譯原始碼
+~~~~~~~~~~~~~~~~~
+
+Linux/Ubuntu/Mac 需要 Python 和 `PyQt <https://pypi.org/project/PyQt5/>`__
+
+Ubuntu Linux
+^^^^^^^^^^^^
+
+Python 3 + Qt5
+
+.. code:: shell
+
+    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
+
+.. code:: shell
+
+    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 可以避免版本和相依性問題
+
+.. code:: shell
+
+    brew install python3
+    pip3 install pipenv
+    pipenv run pip install pyqt5==5.15.2 lxml
+    pipenv run make qt5py3
+    pipenv run python3 labelImg.py
+    [Optional] rm -rf build dist; python setup.py py2app -A;mv "dist/labelImg.app" /Applications
+
+
+Windows
+^^^^^^^
+
+安裝 `Python <https://www.python.org/downloads/windows/>`__,
+`PyQt5 <https://www.riverbankcomputing.com/software/pyqt/download5>`__
+和 `install lxml <http://lxml.de/installation.html>`__.
+
+安裝並到 `labelImg <#labelimg>`__ 目錄
+
+.. code:: shell
+
+    pyrcc4 -o libs/resources.py resources.qrc
+    For pyqt5, pyrcc5 -o libs/resources.py resources.qrc
+
+    python labelImg.py
+    python labelImg.py [IMAGE_PATH] [PRE-DEFINED CLASS FILE]
+
+Windows + Anaconda
+^^^^^^^^^^^^^^^^^^
+
+下載並安裝 `Anaconda <https://www.anaconda.com/download/#download>`__ (Python 3+)
+
+打開 Anaconda Prompt 然後到 `labelImg <#labelimg>`__ 目錄
+
+.. code:: shell
+
+    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]
+
+Get from PyPI but only python3.0 or above
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code:: shell
+
+    pip3 install labelImg
+    labelImg
+    labelImg [IMAGE_PATH] [PRE-DEFINED CLASS FILE]
+
+
+Use Docker
+~~~~~~~~~~~~~~~~~
+.. code:: shell
+
+    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 <https://github.com/tzutalin/labelImg/blob/master/data/predefined_classes.txt>`__
+
+快捷鍵
+~~~~~~~
+
+--------------------+--------------------------------------------+
+| Ctrl + u           | 讀取所有影像從每個目錄                     |
+--------------------+--------------------------------------------+
+| Ctrl + r           | 改變標示結果的存檔目錄                     |
+--------------------+--------------------------------------------+
+| Ctrl + s           | 存檔                                       |
+--------------------+--------------------------------------------+
+| Ctrl + d           | 複製目前的標籤和物件的區塊                 |
+--------------------+--------------------------------------------+
+| Ctrl + Shift + d   | 刪除目前影像                               |
+--------------------+--------------------------------------------+
+| Space              | 標示目前照片已經處理過                     |
+--------------------+--------------------------------------------+
+| w                  | 產生新的物件區塊                           |
+--------------------+--------------------------------------------+
+| d                  | 下張影像                                   |
+--------------------+--------------------------------------------+
+| a                  | 上張影像                                   |
+--------------------+--------------------------------------------+
+| del                | 刪除所選的物件區塊                         |
+--------------------+--------------------------------------------+
+| Ctrl++             | 放大影像                                   |
+--------------------+--------------------------------------------+
+| Ctrl--             | 縮小影像                                   |
+--------------------+--------------------------------------------+
+| ↑→↓←               | 移動所選的物件區塊                         |
+--------------------+--------------------------------------------+
+
+如何貢獻
+~~~~~~~~~~~~~~~~~
+
+歡迎上傳程式碼直接貢獻