README.md

Integrated-Vision-Inspection-System 📷

The Integrated-Vision-Inspection-System (IVIS) is a computer vision app that allows users to train/customize/deploy their own model to fit various application.

Installation 💻

1. This application is supported on both Windows and Linux OS.
2. This application supports both navtive and docker installation.
3. This application has version with GPU and without GPU support.
4. Only installation on Ubuntu have been tested for Linux OS.
5. For Windows OS, native installation is recommended while Linux OS, docker installation is recommended.

• Windows Native Installation
• Linux Native Installation
• Windows Docker Installation
• Linux Docker Installation

Basic User Guide 📖

NOTE: For more detailed user guide, counsult the wiki.

Application Log in

1. During first time log in, the application will prompt for an admin password change and a PostgreSQL password.
2. Once the application is fully setup, the normal username and password prompt will show up everytime the application is launched.

Project Creation

1. After login, create a project at the Home page.
2. Fill in the details and add a dataset using one of the options shown in the page.

3. Once everything is filled up click Submit and the project will be created.

Labelling

1. During project creation, if the dataset selected was already labelled, this step can be skipped.
2. if not, proceed to labelling and label the uploaded dataset.
3. The labelling of this application uses the app LabelStudio interface.
4. Due to some PC computation, loading time between each label can be slow, consider installing Label Studio natively and label there.

Training

1. Once preparation of data is completed, navigate to the training section.
2. Create a training session and follow the instruction in the application to setup the model, training parameters and image augmentation.
3. When setting up the training parameters, beware of the PC resources and make sure it can handle.
4. Start the training. Once the training is done, the model will be saved.
5. Adjust the training parameters and continue the training if necessary.
6. If desired, uploading a user model is possible as well if the file format is compatible.

Deployment

1. Once a training is done, proceed to deployment page and select the desired model.
2. Deploy the model and select the media for deployment. (image upload/camera/mqtt)
3. If desired, deploying a user model is possible as well.

Settings

1. This section will allow for deletion of object.
2. This section allows the following deletion.
   • Training session/model
   • Dataset
   • Project

User Management Page

1. At Home page, the User Management option is located at the side tab.

2. This option allows addition/deletion/check info of a user.
3. It is also possible to alter the user password in this option.

Node-RED:link:

This repo also features some integration with Node-RED. Camera feeds can be sent to an MQTT broker where it can be fetched and displayed in Node-RED dashboard. Example flows can be found here.

Citation

@misc{Integrated Vision Inspection System,
  title={{Integrated Vision Inspection System}},
  url={https://github.com/msf4-0/Integrated-Vision-Inspection-System},
  author={
    Chu Zhen Hao,
    Anson,
    Yap Jun Kang,
    Lee Shi-Hau
    Nicholas Tan Chien Yuan},
  year={2021},
}

License

This software is licensed under the GNU GPLv3 LICENSE © Selangor Human Resource Development Centre. 2021. All Rights Reserved.