Improve document format

README.md markdown correct.
pull/2569/head
Sun Aries 5 years ago committed by GitHub
parent 39ced2af67
commit 598c01b635
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
  1. 9
      modules/cnn_3dobj/README.md

@ -1,4 +1,4 @@
#Convolutional Neural Networks for 3D object classification and pose estimation.
Convolutional Neural Networks for 3D object classification and pose estimation.
===========================================================
# Module Description on cnn_3dobj:
#### This module uses Convolutional Neural Networks (Caffe) to train and recognize 3D poses of objects using triplet networks. The main reference paper can be found at:
@ -12,7 +12,7 @@
```
$ git clone https://github.com/Wangyida/caffe/tree/cnn_triplet.
```
===========================================================
# Module Building Process:
#### Prerequisites for this module are protobuf and Caffe. For libcaffe installation, you can install it on the standard system path so that it can be linked by this OpenCV module when compiling and linking using: -D CMAKE_INSTALL_PREFIX=/usr/local as an build option when you cmake. The building process on Caffe on system could be like this:
```
@ -63,7 +63,7 @@ $ ./examples/triplet/create_3d_triplet.sh
$ ./examples/triplet/train_3d_triplet.sh
```
#### After doing this, you will get .caffemodel files as the trained parameters of the network. I have already provide the network definition .prototxt files and the pretrained .caffemodel in <opencv_contrib>/modules/cnn_3dobj/testdata/cv folder, so you could just use them instead of training with Caffe.
===========================================================
## Demo2: Feature extraction and classification
```
$ cd
@ -77,13 +77,12 @@ $ ./example_cnn_3dobj_classify
```
$ ./example_cnn_3dobj_classify -mean_file=../data/images_mean/triplet_mean.binaryproto
```
===========================================================
## Demo3: Model performance test
#### This demo will run a performance test of a trained CNN model on several images. If the the model fails on telling different samples from separate classes apart, or is confused on samples with similar pose but from different classes, this will give some information for model analysis.
```
$ ./example_cnn_3dobj_model_analysis
```
===========================================================
# Test
#### If you want to run a test on the cnn_3dobj module, the path of test data must be set in advance:
```

Loading…
Cancel
Save