Skip to content

annotation tool for auto label with pytorch

License

Notifications You must be signed in to change notification settings

cosao/udk_labeler

Repository files navigation

udk_label

PYTORCH Python 3.7

Object Detection Task는 객체마다 Bounding Box 처리해주는 이른바 Label작업이 필요합니다. 작업은 주로 사용자가 수동으로 진행해야했으며, 이는 상당한 시간과 정신을 소모하게 됩니다.

이러한점에 착안하여 Label작업을 자동으로 해주는 udk_label를 개발하였습니다.

udk_label는 오픈소스 labelImg를 수정하여 개발되었습니다. 대부분의 UI는 변경된것이 없으며 active learning 기반의 AI 엔진이 탑재되어있습니다. AI 엔진은 RetinaNet(ResNet50_FPN) 모델이며 COCO dataset으로 학습된 pretrained 모델을 사용합니다. (GPU 장치가 있어야 사용가능하며 cuda, cudnn은 필수적입니다.)

추후에 다양한 AI모델을 추가할 예정에 있으며, UI/UX를 고려한 디자인도 보완해나갈 예정입니다.

Install

conda, venv 등 가상환경위에서 설치하는것을 추천합니다.

pip install -r requirements.txt

만약 설치 도중 에러가 나는 모듈이 있다면 개별 설치를 진행합니다.

pip install torch
pip install torchvision
pip install PyQt5
pip install pycocotools
pip install scikit-image
pip install opencv-python
pip install tqdm
pip install tensorboardX
pip install lxml

Windows

Ubuntu

  • [opencv] lib error: 아래의 패키지를 설치해주세요.
sudo apt-get install -y libglib2.0-0 libsm6 libxext6 libxrender1 libfontconfig1

발생했던 에러에 대해서 Issues에 남겨주시면 case별로 다루도록 하겠습니다.

How to Use

UI와 기능은 모두 labelImg와 동일합니다. Auto Labeler를 사용하지 않을 경우에는 기존 방법대로 사용할 수 있습니다.

labelImg의 사용법은 원작자의 github를 참고하시기 바랍니다.

udk_label

Step

  1. 이미지 폴더와 Label이 저장될 폴더를 지정합니다. 반드시 이미지와 Label파일의 폴더구조가 아래와 같이되도록 설정해야만 합니다.

    root_dir/
        | --- Image/
        |      |-- 0001.jpg
        |      |-- 0002.jpg
        |      |-- 0003.jpg
        |      |-- ...
        |
        | --- Label/
        |      |-- 0001.xml
        |      |-- 0002.xml
        |      |-- 0003.xml
        |      |-- ...
    
  2. pretrained_weight를 다운 받습니다. /udk_labeler/하위에 pretrained_weight 폴더를 생성한 후 그 하위에 넣어줍니다.

  3. 사용자가 직접 Label작업을 진행합니다. 초기에 얼마나 많이 Labeling 되어있는지에 따라 작업 속도와 성능에 차이를 주게 됩니다. 경험상 최소 1000장 이상의 이미지에 대하여 Label을 진행하는것을 추천합니다.

  4. 활성화된 Active Learning 버튼을 누릅니다. 우측 하단에 상태바에 학습과 추론의 진행상황이 표시됩니다. Default 셋팅은 아래와 같습니다. 자신의 HW 성능에 따라 해당 값을 조절하시면 됩니다. udk_labeler/engine/cfg/config.py

    • Image_Resize: 512x512 (현재 수정 불가)
    • Batch_Size: 6
    • lr: 0.00005
    • epoch: 10 (GTX1060 6GB 기준으로 약 2000장의 이미지를 1epoch 처리하는데 10분가량 소요됩니다.)
  5. 완료가 되면 Unconfirmed File List에 100장의 이미지 목록이 나타납니다. 100장의 이미지는 AI 모델이 Label처리 하기 어려운 이미지를 뜻하며, 사용자가 직접 Label 작업을 다시 진행합니다. 작업이 완료되면 Continue 버튼을 누릅니다. 우측 하단에 상태바에 학습과 추론의 진행상황이 표시됩니다.

  6. 4번 과정을 반복해서 진행합니다.

  7. 반복작업이 어느정도 진행되었다고 판단이 되면 Stop 버튼을 누릅니다. 그러면, Label 작업을 하지 않은 나머지 이미지에 대해서 모두 Auto Label을 진행합니다.

  8. 모든 작업은 Background에서 동작하며, 터미널에서 자세한 Log를 확인할 수 있습니다.

TODO

  • EfficientDet 모델 교체
  • 앱 실행 후 파일 이동, 수정, 제거 예외처리추가
  • Auto Label 버튼 추가
  • Custom Model 콤보박스 추가

References

About

annotation tool for auto label with pytorch

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages