Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (13.5%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

Basic Info
  • Host: GitHub
  • Owner: dominikc21
  • License: agpl-3.0
  • Language: Python
  • Default Branch: main
  • Size: 1.05 MB
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Created about 2 years ago · Last pushed about 2 years ago
Metadata Files
Readme Contributing License Citation

README.md

Training YOLOv5 on a Custom Dataset of Thermal Images

  • Set up the code
  • clone yolov5 to machine
    • install dependencies (pip install -r yolov5/requirements.txt) (I think conda should work too)
    • import required models (if not already done)
    • Importing dataset
    • make a new directory (mkdir)
    • download the dataset into it

Details about dataset: We have found one dataset that may be adequate for our purposes, a portion of it is included in the folder 'FLIR_Dataset'. Since the training and validation frames from this set are taken from a vehicle, it is best suited for that application. However, it may be general enough for our purposes. The provided annotation of the dataset is in similar to Microsoft's COCO annotation file format, but with added modifications for FLIR's proprietary dataset management tool called Conservator. The annotations will have to be changed to fit the yolov5 model (where each image annotation is a .txt file where each line describes a bounding box, shown below). Converters can be found online, or they can be manually created.

Alt text

Partition the dataset into train, validation and test sets containing approximately 80%, 10%, and 10%, respectively

the FLIR dataset is already split Specify training options: batch, epochs, data, workers, cfg(model architecture: yolo5s.yml, yolov5m.yml, yolov5l.yml, yolo5x.yml), weights (pretrained weights, if from scratch, use --weights ' ')

I will likely use yolo5s.yml since it is the smallest model Data config file, specify: * locations of training, testing, and validation images * number of classes in the dataset * names of the classes in the dataset * Hyperparameter config file (unlikely that I will change anything)

Customizing network architecture (unlikely that I will change anything)

When training the model, choose:

  • batch size (# of training examples in one forward/backward pass)
  • image size (# pixels)
  • number of epochs (complete passes through training set)

Inference * in detect.py change the source of the detector to the camera input stream (after conversion from I2C) * other parameters: weights (of the trained model), conf (confidence threshold), name (where detections are stored, default yoloroaddet) * Run inference on dataset

Writing the output frames with bounding boxes to output stream: * this will likely be combined later with temperature estimation of the objects of interest * saved to sd card or continuously displayed on a monitor

Owner

  • Name: Dominik Culo
  • Login: dominikc21
  • Kind: user

Citation (CITATION.cff)

cff-version: 1.2.0
preferred-citation:
  type: software
  message: If you use YOLOv5, please cite it as below.
  authors:
  - family-names: Jocher
    given-names: Glenn
    orcid: "https://orcid.org/0000-0001-5950-6979"
  title: "YOLOv5 by Ultralytics"
  version: 7.0
  doi: 10.5281/zenodo.3908559
  date-released: 2020-5-29
  license: AGPL-3.0
  url: "https://github.com/ultralytics/yolov5"

GitHub Events

Total
Last Year

Dependencies

requirements.txt pypi
  • Pillow >=10.0.1
  • PyYAML >=5.3.1
  • gitpython >=3.1.30
  • matplotlib >=3.3
  • numpy >=1.22.2
  • opencv-python >=4.1.1
  • pandas >=1.1.4
  • psutil *
  • requests >=2.23.0
  • scipy >=1.4.1
  • seaborn >=0.11.0
  • setuptools >=65.5.1
  • thop >=0.1.1
  • torchvision >=0.9.0
  • tqdm >=4.64.0
  • ultralytics >=8.0.147