Huawei_Technology
/
mindspore
Not watched
1
0
Fork 0
Code
Releases 13 Wiki evaluate Activity
Issues 0 Pull Requests 0 Datasets Model Cloudbrain HPC
You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.
16399 Commits
11 Branches
1.3 GB
177 Download
 
 
 
 
 
 
Tree: 13bb96b3b1
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '13bb96b3b1'
${ noResults }
mindspore/model_zoo/official/cv/ssd
mindspore-ci-bot c0b6a67819 !10292 fix some errors and add resnext50 Chinese README 5 years ago
..
scripts mobilenetv2+ssd gpu 5 years ago
src fix some errors and add resnext50 Chinese README 5 years ago
README.md add mobilenetv1 5 years ago
eval.py add ssd-mobilenetv1-fpn 5 years ago
export.py modify export file to support mindir 5 years ago
mindspore_hub_conf.py add mobilenetv2 and ssd hub 5 years ago
train.py add ssd-mobilenetv1-fpn 5 years ago

README.md

Contents

SSD Description

SSD discretizes the output space of bounding boxes into a set of default boxes over different aspect ratios and scales per feature map location. At prediction time, the network generates scores for the presence of each object category in each default box and produces adjustments to the box to better match the object shape.Additionally, the network combines predictions from multiple feature maps with different resolutions to naturally handle objects of various sizes.

Paper: Wei Liu, Dragomir Anguelov, Dumitru Erhan, Christian Szegedy, Scott Reed, Cheng-Yang Fu, Alexander C. Berg.European Conference on Computer Vision (ECCV), 2016 (In press).

Model Architecture

The SSD approach is based on a feed-forward convolutional network that produces a fixed-size collection of bounding boxes and scores for the presence of object class instances in those boxes, followed by a non-maximum suppression step to produce the final detections. The early network layers are based on a standard architecture used for high quality image classification, which is called the base network. Then add auxiliary structure to the network to produce detections.

We present two different base architecture.

  • ssd300, reference from the paper. Using mobilenetv2 as backbone and the same bbox predictor as the paper pressent.
  • *ssd-mobilenet-v1-fpn, using mobilenet-v1 and FPN as feature extractor with weight-shared box predcitors.

Dataset

Note that you can run the scripts based on the dataset mentioned in original paper or widely used in relevant domain/network architecture. In the following sections, we will introduce how to run the scripts using the related dataset below.

Dataset used: COCO2017

  • Dataset size：19G
    • Train：18G，118000 images
    • Val：1G，5000 images
    • Annotations：241M，instances，captions，person_keypoints etc
  • Data format：image and json files
    • Note：Data will be processed in dataset.py

Environment Requirements

  • Install MindSpore.

  • Download the dataset COCO2017.

  • We use COCO2017 as training dataset in this example by default, and you can also use your own datasets.
    First, install Cython ,pycocotool and opencv to process data and to get evaluation result.

    pip install Cython

pip install pycocotools

pip install opencv-python

    1. If coco dataset is used. Select dataset to coco when run script.

      Change the coco_root and other settings you need in src/config.py. The directory structure is as follows:

      .
└─coco_dataset
  ├─annotations
    ├─instance_train2017.json
    └─instance_val2017.json
  ├─val2017
  └─train2017

    2. If VOC dataset is used. Select dataset to voc when run script.
      Change classes, num_classes, voc_json and voc_root in src/config.py. voc_json is the path of json file with coco format for evalution, voc_root is the path of VOC dataset, the directory structure is as follows:

      .
└─voc_dataset
  └─train
    ├─0001.jpg
    └─0001.xml
    ...
    ├─xxxx.jpg
    └─xxxx.xml
  └─eval
    ├─0001.jpg
    └─0001.xml
    ...
    ├─xxxx.jpg
    └─xxxx.xml

    3. If your own dataset is used. Select dataset to other when run script.
      Organize the dataset infomation into a TXT file, each row in the file is as follows:

      train2017/0000001.jpg 0,259,401,459,7 35,28,324,201,2 0,30,59,80,2

      Each row is an image annotation which split by space, the first column is a relative path of image, the others are box and class infomations of the format [xmin,ymin,xmax,ymax,class]. We read image from an image path joined by the image_dir(dataset directory) and the relative path in anno_path(the TXT file path), image_dir and anno_path are setting in src/config.py.

Quick Start

Prepare the model

  1. Chose the model by chaning the using_model in src/confgi.py. The optional models are: ssd300, ssd_mobilenet_v1_fpn.
  2. Change the datset config in the corresponding config. src/config_ssd300.py or src/config_ssd_mobilenet_v1_fpn.py.
  3. If you are running with ssd_mobilenet_v1_fpn, you need a pretrained model for mobilenet_v1. Set the checkpoint path to feature_extractor_base_param in src/config_ssd_mobilenet_v1_fpn.py. For more detail about training mobilnet_v1, please refer to the mobilenetv1 model.

Run the scripts

After installing MindSpore via the official website, you can start training and evaluation as follows:

  • runing on Ascend
# distributed training on Ascend
sh run_distribute_train.sh [DEVICE_NUM] [EPOCH_SIZE] [LR] [DATASET] [RANK_TABLE_FILE]

# run eval on Ascend
sh run_eval.sh [DATASET] [CHECKPOINT_PATH] [DEVICE_ID]
  • runing on GPU
# distributed training on GPU
sh run_distribute_train_gpu.sh [DEVICE_NUM] [EPOCH_SIZE] [LR] [DATASET]

# run eval on GPU
sh run_eval_gpu.sh [DATASET] [CHECKPOINT_PATH] [DEVICE_ID]
  • runing on CPU(support Windows and Ubuntu)

CPU is usually used for fine-tuning, which needs pre_trained checkpoint.

# training on CPU
python train.py --run_platform=CPU --lr=[LR] --dataset=[DATASET] --epoch_size=[EPOCH_SIZE] --batch_size=[BATCH_SIZE] --pre_trained=[PRETRAINED_CKPT] --filter_weight=True --save_checkpoint_epochs=1

# run eval on GPU
python eval.py --run_platform=CPU --dataset=[DATASET] --checkpoint_path=[PRETRAINED_CKPT]

Script Description

Script and Sample Code

.
└─ cv
  └─ ssd
    ├─ README.md                      # descriptions about SSD
    ├─ scripts
      ├─ run_distribute_train.sh      # shell script for distributed on ascend
      ├─ run_distribute_train_gpu.sh  # shell script for distributed on gpu
      ├─ run_eval.sh                  # shell script for eval on ascend
      └─ run_eval_gpu.sh              # shell script for eval on gpu
    ├─ src
      ├─ __init__.py                  # init file
      ├─ box_utils.py                 # bbox utils
      ├─ eval_utils.py                # metrics utils
      ├─ config.py                    # total config
      ├─ dataset.py                   # create dataset and process dataset
      ├─ init_params.py               # parameters utils
      ├─ lr_schedule.py               # learning ratio generator
      └─ ssd.py                       # ssd architecture
    ├─ eval.py                        # eval scripts
    ├─ train.py                       # train scripts
    ├─ export.py                      # export mindir script
    └─ mindspore_hub_conf.py          # mindspore hub interface

Script Parameters

Major parameters in train.py and config.py as follows:

  "device_num": 1                                  # Use device nums
  "lr": 0.05                                       # Learning rate init value
  "dataset": coco                                  # Dataset name
  "epoch_size": 500                                # Epoch size
  "batch_size": 32                                 # Batch size of input tensor
  "pre_trained": None                              # Pretrained checkpoint file path
  "pre_trained_epoch_size": 0                      # Pretrained epoch size
  "save_checkpoint_epochs": 10                     # The epoch interval between two checkpoints. By default, the checkpoint will be saved per 10 epochs
  "loss_scale": 1024                               # Loss scale
  "filter_weight": False                           # Load paramters in head layer or not. If the class numbers of train dataset is different from the class numbers in pre_trained checkpoint, please set True.
  "freeze_layer": "none"                           # Freeze the backbone paramters or not, support none and backbone.

  "class_num": 81                                  # Dataset class number
  "image_shape": [300, 300]                        # Image height and width used as input to the model
  "mindrecord_dir": "/data/MindRecord_COCO"        # MindRecord path
  "coco_root": "/data/coco2017"                    # COCO2017 dataset path
  "voc_root": "/data/voc_dataset"                  # VOC original dataset path
  "voc_json": "annotations/voc_instances_val.json" # is the path of json file with coco format for evalution
  "image_dir": ""                                  # Other dataset image path, if coco or voc used, it will be useless
  "anno_path": ""                                  # Other dataset annotation path, if coco or voc used, it will be useless

Training Process

To train the model, run train.py. If the mindrecord_dir is empty, it will generate mindrecord files by coco_root(coco dataset), voc_root(voc dataset) or image_dir and anno_path(own dataset). Note if mindrecord_dir isn't empty, it will use mindrecord_dir instead of raw images.

Training on Ascend

  • Distribute mode
    sh run_distribute_train.sh [DEVICE_NUM] [EPOCH_SIZE] [LR] [DATASET] [RANK_TABLE_FILE] [PRE_TRAINED](optional) [PRE_TRAINED_EPOCH_SIZE](optional)

We need five or seven parameters for this scripts.

  • DEVICE_NUM: the device number for distributed train.
  • EPOCH_NUM: epoch num for distributed train.
  • LR: learning rate init value for distributed train.
  • DATASET：the dataset mode for distributed train.
  • RANK_TABLE_FILE : the path of rank_table.json, it is better to use absolute path.
  • PRE_TRAINED : the path of pretrained checkpoint file, it is better to use absolute path.
  • PRE_TRAINED_EPOCH_SIZE : the epoch num of pretrained.

Training result will be stored in the current path, whose folder name begins with "LOG". Under this, you can find checkpoint file together with result like the followings in log

epoch: 1 step: 458, loss is 3.1681802
epoch time: 228752.4654865265, per step time: 499.4595316299705
epoch: 2 step: 458, loss is 2.8847265
epoch time: 38912.93382644653, per step time: 84.96273761232868
epoch: 3 step: 458, loss is 2.8398118
epoch time: 38769.184827804565, per step time: 84.64887516987896
...

epoch: 498 step: 458, loss is 0.70908034
epoch time: 38771.079778671265, per step time: 84.65301261718616
epoch: 499 step: 458, loss is 0.7974688
epoch time: 38787.413120269775, per step time: 84.68867493508685
epoch: 500 step: 458, loss is 0.5548882
epoch time: 39064.8467540741, per step time: 85.29442522723602

Training on GPU

  • Distribute mode
    sh run_distribute_train_gpu.sh [DEVICE_NUM] [EPOCH_SIZE] [LR] [DATASET] [PRE_TRAINED](optional) [PRE_TRAINED_EPOCH_SIZE](optional)

We need five or seven parameters for this scripts.

  • DEVICE_NUM: the device number for distributed train.
  • EPOCH_NUM: epoch num for distributed train.
  • LR: learning rate init value for distributed train.
  • DATASET：the dataset mode for distributed train.
  • PRE_TRAINED : the path of pretrained checkpoint file, it is better to use absolute path.
  • PRE_TRAINED_EPOCH_SIZE : the epoch num of pretrained.

Training result will be stored in the current path, whose folder name is "LOG". Under this, you can find checkpoint files together with result like the followings in log

epoch: 1 step: 1, loss is 420.11783
epoch: 1 step: 2, loss is 434.11032
epoch: 1 step: 3, loss is 476.802
...
epoch: 1 step: 458, loss is 3.1283689
epoch time: 150753.701, per step time: 329.157
...

Evaluation Process

Evaluation on Ascend

sh run_eval.sh [DATASET] [CHECKPOINT_PATH] [DEVICE_ID]

We need two parameters for this scripts.

  • DATASET：the dataset mode of evaluation dataset.
  • CHECKPOINT_PATH: the absolute path for checkpoint file.
  • DEVICE_ID: the device id for eval.

checkpoint can be produced in training process.

Inference result will be stored in the example path, whose folder name begins with "eval". Under this, you can find result like the followings in log.

Average Precision (AP) @[ IoU=0.50:0.95 | area= all | maxDets=100 ] = 0.238
Average Precision (AP) @[ IoU=0.50 | area= all | maxDets=100 ] = 0.400
Average Precision (AP) @[ IoU=0.75 | area= all | maxDets=100 ] = 0.240
Average Precision (AP) @[ IoU=0.50:0.95 | area= small | maxDets=100 ] = 0.039
Average Precision (AP) @[ IoU=0.50:0.95 | area=medium | maxDets=100 ] = 0.198
Average Precision (AP) @[ IoU=0.50:0.95 | area= large | maxDets=100 ] = 0.438
Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets= 1 ] = 0.250
Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets= 10 ] = 0.389
Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets=100 ] = 0.424
Average Recall (AR) @[ IoU=0.50:0.95 | area= small | maxDets=100 ] = 0.122
Average Recall (AR) @[ IoU=0.50:0.95 | area=medium | maxDets=100 ] = 0.434
Average Recall (AR) @[ IoU=0.50:0.95 | area= large | maxDets=100 ] = 0.697

========================================

mAP: 0.23808886505483504

Evaluation on GPU

sh run_eval_gpu.sh [DATASET] [CHECKPOINT_PATH] [DEVICE_ID]

We need two parameters for this scripts.

  • DATASET：the dataset mode of evaluation dataset.
  • CHECKPOINT_PATH: the absolute path for checkpoint file.
  • DEVICE_ID: the device id for eval.

checkpoint can be produced in training process.

Inference result will be stored in the example path, whose folder name begins with "eval". Under this, you can find result like the followings in log.

Average Precision (AP) @[ IoU=0.50:0.95 | area= all | maxDets=100 ] = 0.224
Average Precision (AP) @[ IoU=0.50 | area= all | maxDets=100 ] = 0.375
Average Precision (AP) @[ IoU=0.75 | area= all | maxDets=100 ] = 0.228
Average Precision (AP) @[ IoU=0.50:0.95 | area= small | maxDets=100 ] = 0.034
Average Precision (AP) @[ IoU=0.50:0.95 | area=medium | maxDets=100 ] = 0.189
Average Precision (AP) @[ IoU=0.50:0.95 | area= large | maxDets=100 ] = 0.407
Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets= 1 ] = 0.243
Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets= 10 ] = 0.382
Average Recall (AR) @[ IoU=0.50:0.95 | area= all | maxDets=100 ] = 0.417
Average Recall (AR) @[ IoU=0.50:0.95 | area= small | maxDets=100 ] = 0.120
Average Recall (AR) @[ IoU=0.50:0.95 | area=medium | maxDets=100 ] = 0.425
Average Recall (AR) @[ IoU=0.50:0.95 | area= large | maxDets=100 ] = 0.686

========================================

mAP: 0.2244936111705981

Export MindIR

python export.py --ckpt_file [CKPT_PATH] --file_name [FILE_NAME] --file_format [FILE_FORMAT]

The ckpt_file parameter is required.

Model Description

Performance

Evaluation Performance

Parameters Ascend GPU
Model Version SSD V1 SSD V1
Resource Ascend 910 ；CPU 2.60GHz，192cores；Memory，755G NV SMX2 V100-16G
uploaded Date 09/15/2020 (month/day/year) 09/24/2020 (month/day/year)
MindSpore Version 1.0.0 1.0.0
Dataset COCO2017 COCO2017
Training Parameters epoch = 500, batch_size = 32 epoch = 800, batch_size = 32
Optimizer Momentum Momentum
Loss Function Sigmoid Cross Entropy,SmoothL1Loss Sigmoid Cross Entropy,SmoothL1Loss
Speed 8pcs: 90ms/step 8pcs: 121ms/step
Total time 8pcs: 4.81hours 8pcs: 12.31hours
Parameters (M) 34 34
Scripts https://gitee.com/mindspore/mindspore/tree/master/model_zoo/official/cv/ssd https://gitee.com/mindspore/mindspore/tree/master/model_zoo/official/cv/ssd

Inference Performance

Parameters Ascend GPU
Model Version SSD V1 SSD V1
Resource Ascend 910 GPU
Uploaded Date 09/15/2020 (month/day/year) 09/24/2020 (month/day/year)
MindSpore Version 1.0.0 1.0.0
Dataset COCO2017 COCO2017
batch_size 1 1
outputs mAP mAP
Accuracy IoU=0.50: 23.8% IoU=0.50: 22.4%
Model for inference 34M(.ckpt file) 34M(.ckpt file)

Description of Random Situation

In dataset.py, we set the seed inside “create_dataset" function. We also use random seed in train.py.

ModelZoo Homepage

Please check the official homepage.

Delete task

Are you sure you want to delete this task? Once this task is deleted, it cannot be recovered.

cancel
confirm

MindSpore is a new open source deep learning training/inference framework that could be used for mobile, edge and cloud scenarios.

C++ Python Text Unity3D Asset C other