Readme

Author: springkim

CNTK/FasterRCNN/bin/download_runfile.bat

@@ -1,10 +1,6 @@
 ::Train file
 powershell "(New-Object System.Net.WebClient).DownloadFile('https://www.dropbox.com/s/p726xk5pjvzxvly/FasterRCNN_Train_SE.exe?dl=1','FasterRCNN_Train_SE.exe')"
 
-
-::Detect file. See also https://github.com/springkim/FasterRCNN_SpringEdition
-powershell "(New-Object System.Net.WebClient).DownloadFile('https://www.dropbox.com/s/oon50vg9rfiv1lw/FasterRCNN_Detect_SE.exe?dl=1','FasterRCNN_Detect_SE.exe')"
-
 ::Download requirement dlls
 powershell "(New-Object System.Net.WebClient).DownloadFile('https://www.dropbox.com/s/tj0c19eoz17yzgo/FasterRCNN_SE_dll.zip?dl=1','FasterRCNN_SE_dll.zip')"
 

FasterRCNN_SE_Detection_Example/FasterRCNN_SE.h

@@ -43,8 +43,8 @@ class FasterRCNN {
 		m_shmem = ::CreateFileMappingA(INVALID_HANDLE_VALUE, nullptr,PAGE_READWRITE, 0, m_size, m_key_shmem.c_str());
 		m_buffer = (char*)::MapViewOfFile(m_shmem, FILE_MAP_ALL_ACCESS, 0, 0, m_size);
 		m_buffer[0] = 0;
-		std::string exec = "python \"C:/Users/spring/Documents/SourceTree/FasterRCNN_SpringEdition/CNTK/FasterRCNN/src/FasterRCNN_Detect_SE.py\"";
-		//std::string exec = "FasterRCNN_Detect_SE.exe";
+		//std::string exec = "python \"C:/Users/spring/Documents/SourceTree/FasterRCNN_SpringEdition/CNTK/FasterRCNN/src/FasterRCNN_Detect_SE.py\"";
+		std::string exec = "FasterRCNN_Detect_SE.exe";
 		std::ostringstream oss;
 		oss << exec << " " << m_key_shmem << " " << m_key_mutex << " " << m_size << " " << "\"" << model_path << "\"";
 		UINT ret=WinExec(oss.str().c_str(), SW_SHOW);

FasterRCNN_SE_Detection_Example/download_detect_exe.bat

@@ -1,3 +1,11 @@
 ::Detect file. See also https://github.com/springkim/FasterRCNN_SpringEdition
 powershell "(New-Object System.Net.WebClient).DownloadFile('https://www.dropbox.com/s/oon50vg9rfiv1lw/FasterRCNN_Detect_SE.exe?dl=1','FasterRCNN_Detect_SE.exe')"
 
+::Download requirement dlls
+powershell "(New-Object System.Net.WebClient).DownloadFile('https://www.dropbox.com/s/tj0c19eoz17yzgo/FasterRCNN_SE_dll.zip?dl=1','FasterRCNN_SE_dll.zip')"
+
+powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory('FasterRCNN_SE_dll.zip', '.'); }"
+
+IF EXIST "FasterRCNN_SE_dll.zip" (
+	DEL "FasterRCNN_SE_dll.zip"
+)

README.md

@@ -1,5 +1,88 @@
-# FasterRCNN_SpringEdition
-Easy FasterRCNN C++ library. 
+# FasterRCNN_SpringEdition <img src="https://i.imgur.com/oYejfWp.png" title="Windows8" width="48">
+
+###### FasterRCNN C++ library. (Train,Detect both)
+* All dependencies are included.
+* Can Train FasterRCNN as double click.
+* Need only 1 header file, To detect by FasterRCNN.
+
+<img src="https://i.imgur.com/ElCyyzT.png" title="Windows8" width="48"><img src="https://i.imgur.com/O5bye0l.png" width="48">
 
 ## Setup for train
+#### 1. Download model and files.
+There is a **download_model.bat** in [CNTK/FasterRCNN/](https://github.com/springkim/FasterRCNN_SpringEdition/tree/master/CNTK/FasterRCNN).
+This file can download **VGG16_ImageNet_Caffe.model** . because our **FasterRCNN** use **VGG16** instead of **Alexnet**.
+
+And move to [CNTK/FasterRCNN/bin](https://github.com/springkim/FasterRCNN_SpringEdition/tree/master/CNTK/FasterRCNN/bin) and run **download_runfile.bat**.
+This file download **FasterRCNN_Train_SE.exe** and dependency dlls.
+
+**FasterRCNN_train_SE.exe** needs 1 integer argument. This argument is epoch for train.
+The example run script is in [CNTK/FasterRCNN/](https://github.com/springkim/FasterRCNN_SpringEdition/tree/master/CNTK/FasterRCNN)**train.bat**.
+
+#### 2. Train our own data format and location.
+
+Actually, **FasterRCNN_Train_SE.exe** read only two files. first one is `../train_img_file.txt`, Second one is `../train_roi_file.txt`. That's why i made **FasterRCNN_Train_SE.exe** in **bin** folder.
+
+This format follows the [Microsoft/CNTK](https://github.com/Microsoft/CNTK) format.
+
+`train_img_file.txt` follows the format below.
+```
+0	<image-path>	0
+1	<image-path>	0
+2	<image-path>	0
+```
+First column is number of image. Second column is image path. Last column must be zero.
+You can see [CNTK/FasterRCNN/train_img_file.txt](https://github.com/springkim/FasterRCNN_SpringEdition/blob/master/CNTK/FasterRCNN/train_img_file.txt) for understand.
+`train_roi_file.txt` follows the format below.
+```
+0 |roiAndLabel <x1 y1 x2 y2 class>
+1 |roiAndLabel <x1 y1 x2 y2 class> <x1 y1 x2 y2 class>
+```
+First column is number of image~~(stupid format)~~, Second column must be `|roiAndLabel` ,Third column is coordinate of object. You can write multiple coordinate of object in same line.
+
+Finally, It looks like below.
+```
+┌ bin
+│  ├ FasterRCNN_Train_SE.exe
+│  └ <Requirement dlls>
+├ img
+│  └ <images that wrote in train_img_file.txt>
+├ train_img_file.txt
+├ train_roi_file.txt
+└ train.bat
+```
+Now you can run **train.bat** for trainning.
+
+model file will generate at the same location.
+
+## Setup for detect
+#### 1. Download pre-trained model and files.
+Run both **download_detect_exe.bat** and **download_pretrained_model.bat** in the [FasterRCNN_SE_Detection_Example](https://github.com/springkim/FasterRCNN_SpringEdition/tree/master/FasterRCNN_SE_Detection_Example).
+
+#### 2. Run.
+
+And open **FasterRCNN_SE_Detection_Example.sln** as [Visual Studio 2015](https://www.visualstudio.com/ko/downloads/?rr=https%3A%2F%2Fwww.google.co.kr%2F).~~(Maybe it works on VS2013 and VS2017 too)~~
+
+We needs only 1 header file**(FasterRCNN_SE.h)** for detect. Of course your exe file needs **FasterRCNN_Detect_SE.exe** and requirement dlls(22 files).
+
+Model loading time is about 20~30s.
+
+## Technical issue.
+The [CNTK](https://github.com/Microsoft/CNTK) is python wrapper. They support C++ interface. But it works only in CPU to detection.
+
+[CPU version detection](https://github.com/springkim/FasterRCNN_SpringEdition/blob/master/dev/CNTK-
+eval-CPU-only.cpp)
+
+I have to run this code on C++ without Python dependencies.
+
+So, I used IPC with python executable file. I used [pyinstaller](http://www.pyinstaller.org/) for make exe file.
+
+Finally, It does not support GPU SLI.
+
+I tested it on (Windows10,GTX1080) and (windows10,TITAN X).
+
+
+
+
+
+