EXTERNAL ARROW

此存储库是使用kwiver和diva wheel注册外部插件的示例

需求

1. libgl1-mesa-dev
2. libexpat1-dev
3. libgtk2.0-dev
4. liblapack-dev
5. libpython3-dev
6. kwiver
7. diva-framework

安装

EXTERNAL ARROW

pip install external-arrow

验证注册

plugin_explorer --algo image_object_detector

Plugins that implement type "image_object_detector"
---------------------
Info on algorithm type "image_object_detector" implementation "TestObjectDetector"
  Plugin name: TestObjectDetector
        Test to verify if a python algorithm can be registered externally
---------------------
Info on algorithm type "image_object_detector" implementation "external_arrow.arrow.test_object_detector"
  Plugin name: external_arrow.arrow.test_object_detector
        Version: 1.0
        Test to verify if a cpp algorithm can be registered externall
---------------------
Info on algorithm type "image_object_detector" implementation "create_detection_grid"
  Plugin name: create_detection_grid
	    Create a grid of detections across the input image.
---------------------
Info on algorithm type "image_object_detector" implementation "example_detector"
  Plugin name: example_detector
	    Simple example detector that just creates a user-specified bounding box.
---------------------
Info on algorithm type "image_object_detector" implementation "hough_circle"
  Plugin name: hough_circle
        Hough circle detector
---------------------
Info on algorithm type "image_object_detector" implementation "detect_heat_map"
  Plugin name: detect_heat_map
	    OCV implementation to create detections from heatmaps

TestObjectDetector 和 external_arrow.arrow.test_object_detector 是由external_arrow注册的python和c++箭头

从外部包注册ARROW/流程

Kwiver使用entrypoints来注册重要的箭头和sprokit流程。

PYTHON ARROW/流程

python流程和箭头使用 setup.py 中的 kwiver.python_plugin_registration 进行注册。外部包中的每个流程和箭头都必须通过指定与entrypoint相关联的唯一键值对单独进行注册。例如

'kwiver.python_plugin_registration':
[ 'simple_detector=external_arrow.arrow.test_object_detector']

其中 external_arrow.arrow.test_object_detector 是包含 __vital_algorithm_register__ 的python箭头

C++ ARROW/流程

C++流程和箭头使用 setup.py 中的 kwiver.cpp_search_paths 进行注册。对于注册C++库，Kwiver需要包中C++库所在的目录的绝对路径。例如

'kwiver.cpp_search_paths':
['simple_detector=external_arrow.register_cpp_arrow:get_cpp_path']

其中 external_arrow.register_cpp_arrow:get_cpp_path 是一个python函数，它返回包中 external_arrow 的C++库所在的目录。

注意：Kwiver wheel不提供依赖于Kwiver的C++扩展的开发环境。基于C++ vital arrow 和 sprokit process 的扩展将与 fletch 和 kwiver 的静态构建进行构建。