Add function showBinaryPicByTimeInterval

yucicheung · Sep 2, 2018 · b9bb96b · b9bb96b
1 parent 7163519
commit b9bb96b
Show file tree

Hide file tree

Showing 10 changed files with 34 additions and 12 deletions.
diff --git a/.gitignore b/.gitignore
@@ -4,3 +4,4 @@ releaseNotes.md
 *.asv
 createImgFromRawData.m
 functions/*.m
+*.mlx
diff --git a/CelexMatlabToolbox_UserGuide_English.md b/CelexMatlabToolbox_UserGuide_English.md
@@ -10,7 +10,7 @@ CelexMatlabToolbox is a matlab toolbox to process the events collected using Cel
     - Real-time showing and saving binary pics from raw data.
     - Real-time showing and saving gray pics from raw data..
     - Real-time showing and saving accumulated gray pics from raw data..
-  -  `functions`: a collection of matlab functions.
+  - `functions`: a collection of matlab functions.
     - Decode from raw data(`.bin` file) in batches and return events in format of `x,y,adc,t`，where `t`  is the **continuous time stamp**.
     - Save decoded events as mat file in memory-efficient way.
     - Load events from mat file.
@@ -20,6 +20,7 @@ CelexMatlabToolbox is a matlab toolbox to process the events collected using Cel
     - Show and save denoised binary pics from events.
     - Show and save denoised gray pics from events.
     - Display 3D events flow from events.
+    - Accumulate frames by specified time interval in certain range (in percentage), and user can skip the first specified amount of frames if needed and also determine the time for each frame to show.
   - `demo.m`
     - An executable demo file, which includes all sample usage to call the functions in folder `functions`.
 
@@ -81,4 +82,11 @@ CelexMatlabToolbox is a matlab toolbox to process the events collected using Cel
 
 | Prototype                    | Description                                                  |
 | :--------------------------- | :----------------------------------------------------------- |
-| `showEventsFlow3D( events )` | Dynamically show the 3D events flow based on the input `events`struct. |
+| `showEventsFlow3D( events )` | Dynamically show the 3D events flow based on the input `events`struct. |
+
+- **Accumulate frames by specified time interval**
+
+| **Prototype**                                                | **Description**                                              |
+| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| `showBinaryPicByTimeInteval(events,timeDelta,`<br>`displayTime,startPer,endPer,skipPic)` | Based on `events`, the function form each frame by `timeDelta`(ms) in events slice ranging in` [startPer,endPer] `(in percentage).User can skip the first `skipPic` pics. Showing time for each frame is `displayTime`(ms). |
+
diff --git a/CelexMatlabToolbox_UserGuide_English.pdf b/CelexMatlabToolbox_UserGuide_English.pdf
diff --git a/CelexMatlabToolbox_UserGuide_中文.md b/CelexMatlabToolbox_UserGuide_中文.md
@@ -18,7 +18,8 @@ CelexMatlabToolbox是针对Celex IV的采集数据进行处理的Matlab工具箱
     - 累积式灰度图的显示及存储；
     - 去噪二值图的显示及存储；
     - 去噪灰度图的显示及存储；
-    - 事件流的三维动态显示。
+    - 事件流的三维动态显示；
+    - 在指定区间内，基于规定时间片累积帧，并按照指定帧率慢放二值图片，可以根据需要跳过前若干张图片。
   - `demo.m`
     - 可运行的示例文件，提供对所有工具箱函数的调用示例。
 
@@ -82,3 +83,10 @@ CelexMatlabToolbox是针对Celex IV的采集数据进行处理的Matlab工具箱
 | 函数原型                     | 功能描述                                   |
 | ---------------------------- | ------------------------------------------ |
 | `showEventsFlow3D( events )` | 根据输入的`events`结构体动态显示三维事件流 |
+
+- **规定区间内基于固定事件片累积**
+
+| 函数原型                                                     | 功能描述                                                     |
+| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| `showBinaryPicByTimeInteval(events,timeDelta,`<br>`displayTime,startPer,endPer,skipPic)` | 输入`events`结构体，根据`timeDelta`(ms)事件百分比区间`[startPer,endPer]`中跳过前`skipPic`张图片开始显示，每张图片显示时间为`displayTime`ms。 |
+
diff --git a/CelexMatlabToolbox_UserGuide_中文.pdf b/CelexMatlabToolbox_UserGuide_中文.pdf
diff --git a/README.md b/README.md
@@ -11,7 +11,7 @@ CelexMatlabToolbox is a matlab toolbox to process the events collected using Cel
   - Real-time showing and saving binary pics from raw data.
   - Real-time showing and saving gray pics from raw data.
   - Real-time showing and saving accumulated gray pics from raw data.
--  `functions`: a collection of matlab functions.
+- `functions`: a collection of matlab functions.
   - Decode from raw data(`.bin` file) in batches and return events in format of `x,y,adc,t`，where `t`  is the **continuous time stamp**.
   - Save decoded events as mat file in memory-efficient way.
   - Load events from mat file.
@@ -21,6 +21,7 @@ CelexMatlabToolbox is a matlab toolbox to process the events collected using Cel
   - Show and save denoised binary pics from events.
   - Show and save denoised gray pics from events.
   - Display 3D events flow from events.
+  - Accumulate frames by specified time interval in certain range (in percentage), and user can skip the first specified amount of frames if needed and also determine the time for each frame to show.
 - `demo.m`
   - An executable demo file, which **includes all sample usage to call the functions in folder `functions`.**
 
@@ -47,10 +48,10 @@ CelexMatlabToolbox is a matlab toolbox to process the events collected using Cel
 
 ## TODO
 
+- [x] Visualizing by accumulating events through a specified time interval.
 - [ ] Take spatial connection  into consideration to improve denoising results.
 - [ ] Take FPN into consideration to improve denoising results.
 - [ ] Add `overlap` parameter for visualizing.
-- [ ] Visualizing by accumulating events through a specified time interval.
 
 ## LICENSE
 

diff --git a/README_中文.md b/README_中文.md
@@ -21,7 +21,8 @@ CelexMatlabToolbox是针对Celex IV的采集数据进行处理的Matlab工具箱
   - 累积式灰度图的显示及存储；
   - 去噪二值图的显示及存储；
   - 去噪灰度图的显示及存储；
-  - 事件流的三维动态显示。
+  - 事件流的三维动态显示；
+  - 在指定区间内，基于规定时间片累积帧，并按照指定帧率慢放二值图片，可以根据需要跳过前若干张图片。
 - `demo.m`
   - 可运行的示例文件，**提供对所有工具箱函数的调用示例**。
 
@@ -48,11 +49,10 @@ CelexMatlabToolbox是针对Celex IV的采集数据进行处理的Matlab工具箱
 ![运行节](pics/runCodeSection.png)
 
 ## TODO
-
+- [x] 基于时间片段的事件累积
 - [ ] 考虑空间关联特性改进去噪效果
 - [ ] 考虑FPN改进去噪效果
 - [ ] 对于事件显示加入`overlap`参数
-- [ ] 基于时间片段的事件累积
 
 ## LICENSE
 

diff --git a/demo.m b/demo.m
@@ -21,7 +21,7 @@
 upperADC=511;
 lowerADC=0;
 bytesPerEvent=4;
-timeResolution=40; %ns
+timeResolution=4e-5; %ms
 %% Convert all events to pixels in format [x,y,a,t] and save as mat in memory-efficient way
 binName='Recording_20180705_124529343_E_25MHz_tennis_thresh40.bin';
 binDir='D:/03DVS_BinFile/ver2_1/classifiedBin';
@@ -77,6 +77,10 @@
 % showDenoisedGrayComparison(events,eventDelta,displayTime)
 
 %% Accumulate Pic  by timeInterval
-timeDelta=1e-5;
-displayTime=1e-11;
-showAllPicAccumulatedByTimeInteval( events,timeDelta,displayTime );
+timeDelta=0.1;  % ms
+displayTime=25; % ms
+startPer=0.2;  % percent of index to start
+endPer=0.3;     % percent of index to end
+skipPic=5000;   % num of skipped pics from the start index under order of "timeDelta"
+
+showBinaryPicByTimeInteval(events,timeDelta,displayTime,startPer,endPer,skipPic);
diff --git a/functions/showAllPicAccumulatedByTimeInteval.p b/functions/showAllPicAccumulatedByTimeInteval.p
diff --git a/functions/showBinaryPicByTimeInteval.p b/functions/showBinaryPicByTimeInteval.p
-Original file line number
+Diff line change
@@ Expand Up / @@ -4,3 +4,4 @@ releaseNotes.md @@
     *.asv
     createImgFromRawData.m
     functions/*.m
+    *.mlx