New samples

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Alexander Varakosov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,4 +1,38 @@
-# Размеченный набор данных для тренировки каскада Хаара.
+# Размеченный набор данных для тренировки каскада Хаара
 
+### Использование
 
-**14.02.2018** 114 положительных и 20 отрицательных семплов.
+1. Скачайте [последний релиз](https://github.com/TheLongRunSmoke/bird-haar/releases) тренированного каскада.
+2. Инициализируйте им CascadeClassifier.
+```python
+cascade = cv2.CascadeClassifier('cascade_226.xml')
+```
+
+### Создание каскада
+
+**1.** Сэмплирование
+```
+opencv_createsamples -vec traning.vec -info positive\desc.txt -bg neg_desc.txt -w 24 -h 24
+```
+
+**2.** Тренировка
+```
+opencv_traincascade -data cascade -vec traning.vec -bg negative/desc.txt 
+    -numPos 180 -numNeg 60 -numStages 30 -featureType HAAR -w 24 -h 24
+    -minHitRate 0.995 -maxFalseAlarmRate 0.2 
+    -precalcValBufSize 1024 -precalcValBufSize 1024 -numThreads 4
+```
+
+### Аннотация
+
+Вы можете аннотировать сет самостоятельно. Например, встроенными средствами OpenCV.
+```
+opencv_annotation --annotations=positive\desc.txt --images=positive\img\
+opencv_annotation --annotations=negative\desc.txt --images=negative\img\
+``` 
+
+### История изменений
+
+**08.03.2018** 226 положительных и 72 отрицательных семпла.
+
+**14.02.2018** 114 положительных и 20 отрицательных семплов.