From c7be195387e78caaef9f0ab5558363da1023533c Mon Sep 17 00:00:00 2001 From: MyungJoo Ham Date: Fri, 27 Jul 2018 13:51:04 +0900 Subject: [PATCH] [Release] Version 0.0.1 As the basic requirement (stream app with camera and single-tensor output tf-lite model) is fulfilled finally with #360, we hereby announce the release of 0.0.1. We will move on to 0.0.2-rc1 after this. Signed-off-by: MyungJoo Ham --- CMakeLists.txt | 2 +- README.md | 38 +++++++++++++++++++++++++++----------- 2 files changed, 28 insertions(+), 12 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index b7fc832..13410a0 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -6,7 +6,7 @@ OPTION(TIZEN "Enable Tizen build mode" OFF) OPTION(DISABLE_TENSORFLOW_LITE "Disable tensorflow-lite support" OFF) OPTION(INSTALL_EXAMPLE_APP "Install example applications" OFF) -ADD_DEFINITIONS(-DVERSION="0.0.0") +ADD_DEFINITIONS(-DVERSION="0.0.1") SET(PREFIX ${CMAKE_INSTALL_PREFIX}) SET(EXEC_PREFIX "${PREFIX}/bin") diff --git a/README.md b/README.md index 61c70a8..f56e307 100644 --- a/README.md +++ b/README.md @@ -11,10 +11,14 @@ Neural Network Streamer for AI Projects. - **Composite Models!**: Allow to use multiple neural network models in a single stream instance. - **Multi Modal Intelligence!**: Allow to use multiple sources for neural network models. +- Provide easy methods to construct media streams with neural network models using the de-facto-standard media stream framework, **GStreamer**. + - Allow any gstreamer users to put neural network models as if they are media filters. + - Allow any neural network developers to manage media streams fairly easily. + ## Maintainers * MyungJoo Ham (myungjoo.ham@samsung.com) -## Committers +## Reviewers * Jijoong Moon (jijoon.moon@samsung.com) * Geunsik Lim (geunsik.lim@samsung.com) * Sangjung Woo (sangjung.woo@samsung.com) @@ -32,8 +36,9 @@ Note that this project has just started and most of the components are in design - other/tensor - other/tensors (W.I.P. jijoong-moon) +- other/tensorsave (W.I.P. myungjoo) -findtype specifics: TBD +findtype specifics: refer to the wiki (other/tensorsave) meta specifics: W.I.P. jijoong-moon ### Gstreamer Elements (Plugins) @@ -43,7 +48,7 @@ meta specifics: W.I.P. jijoong-moon - Prototype for video/xraw (RGB/BGRx) is implemented. - Caution: if width is not divisible by 4, RGB video incurs memcpy. - Audio - - Planned + - Planned (wooksong) - Text - Planned - tensor\_filter @@ -52,36 +57,47 @@ meta specifics: W.I.P. jijoong-moon - Fixed input/ouput dimensions (fixed by subplugin) - Flexible dimensions (output dimension determined by subplugin according to the input dimension determined by pipeline initialization) - Invoke subplugin with pre-allocated buffers - - TODO: Invoke subplugin and let subplugin allocate output buffers. + - Invoke subplugin and let subplugin allocate output buffers. + - TODO: Accept other/tensors. + - TODO: Allow to manage synchronization policies. - Tensorflow-Lite - - W.I.P. jinhyuck83-park hello-ahn + - Supported: jinhyuck83-park hello-ahn - Custom - Supported with example custom subplugins. - - Other NNFW TBD + - Other NNFW TBD (coming soon: tensorflow, caffe2, caffe) - tensor\_sink - - W.I.P. jy1210-jung + - Supported jy1210-jung + - TODO: ROS integration - tensor\_transformer - - Planned + - Partially supported. + - TODO: a lot of features to be implemented - tensor\_merge - Planned - tensor\_decode - - W.I.P. jijoong-moon + - Partially supported: jijoong-moon + - TODO: prepare tensor-to-media transforms for many popular neural network models. - tensormux - Supported - Mux mutiple "other/tensor"s and make "other/tensors" - Currently maximum number of tensor to be muxed is 16 + - TODO: Allow to manage synchronization policies. - tensordemux - Supported - Demux "other/tensors' to "other/tensor"s - tensor to be pushed to downstream can be choosen with "tensorpick" option. - tensor\_source - Planned +- tensor\_save + - Planned +- tensor\_load + - Planned Note that test elements in /tests/ are not elements for applications. They exist as scaffoldings to test the above elements especially in the case where related elements are not yet implemented. ### Other Components -- CI: up and running. sewon-oh -- Stream test cases: W.I.P. sangjung-woo wook16-song +- CI (internal in-house): up and running. sewon-oh +- CI (github.com): W.I.P. sewon-oh, leemgs +- Stream test cases: partially supported. will be extended by sangjung-woo wook16-song ## Getting Started For more details, please access the following manual. -- 2.7.4