# deep_sort_with_yolov3

**Repository Path**: today1010/deep_sort_with_yolov3

## Basic Information

- **Project Name**: deep_sort_with_yolov3
- **Description**: No description available
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2021-04-27
- **Last Updated**: 2021-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Introduction

  本项目参考[deep_sort_yolov3](https://github.com/Qidian213/deep_sort_yolov3), 但将[deep_sort](https://github.com/nwojke/deep_sort)和[keras-yolo3](https://github.com/qqwweee/keras-yolo3)作为独立的git项目引用而不是直接复制源代码到本项目中，以便与原项目进行同步更新;

  在原deep_sort_yolov3的基础上，定义了更多的参数方便测试，这些参数会传递给deep_sort和keras-yolo3;

  为了提高视频跟踪的实时性，采用了隔帧检测的方法，每n帧视频进行一次检测，n可以通过参数指定, 默认为1，即每帧都检测。

  原项目地址：

    https://github.com/Qidian213/deep_sort_yolov3

    https://github.com/nwojke/deep_sort
  
    https://github.com/qqwweee/keras-yolo3
  

# Quick Start

1. 下载本项目以及deep_sort和keras-yolo3源码；

   ```bash
   git clone https://gitee.com/zch-ai/deep_sort_with_yolov3.git
   cd deep_sort_with_yolov3/
   git submodule update --init

   ```

2. 从[YOLO官网](http://pjreddie.com/darknet/yolo/)下载训练好的 YOLOv3 模型参数(也可以选择yolov3-tiny等其他网络)，使用keras-yolo3提供的转换脚本转换为会.h5格式；

   ```bash
   wget https://pjreddie.com/media/files/yolov3.weights
   python3 ./keras_yolo3/convert.py keras_yolo3/yolov3.cfg yolov3.weights yolo.h5
   ```

3. 下载deep_sort中提取特征用的模型参数, 解压到deep_sort_with_yolov3目录下；
   deep_sort官方提供的文件在google网盘上，国内无法直接访问，可以使用百度网盘的文件：

     链接：https://pan.baidu.com/s/1_S84pzx6V6R5sNEPN2rePQ
     提取码：xv0o

    ```bash
    unzip resources.zip
    ```

4. 下载解压测试数据：这里使用的是[MOT16](https://motchallenge.net/data/MOT16/)，如果官方下载太慢，也可以使用网盘提供的文件；

   将下载的MOT16.zip放到deep_sort_with_yolov3目录下

   ```bash

   mkdir MOT16
   cd MOT16
   unzip ../MOT16.zip
   cd ..
   ```

4. 运行命令测试:

   ```bash
   python3 deep_sort_app.py --input MOT16/test/MOT16-06/img1/%6d.jpg
   ```

   也可以指定每3帧检测一次

   ```bash
   python3 deep_sort_app.py --input MOT16/test/MOT16-06/img1/%6d.jpg --update_step 3
   ```


# Dependencies

  我使用的测试环境是Ubuntu 18.04，Python 3.6，tensorflow-gpu 1.14，GPU使用NVIDIA GTX1660Ti；

  项目中使用了以下python库：

    NumPy
    sklean
    OpenCV
    Pillow