U3V camera Performance test tool

Windows

こちらよりSDKをインストールしてください。

sensing-dev バージョン v25.01.00 を使用してください。

その後、pipで以下のモジュールをインストールしてください。

pip3 install -U pip
pip3 uninstal ion-python
pip3 install ion-contrib-python==3.2.6
pip3 install gendc-python==0.4.0

もしフレームドロップがどこで起きているかをグラフにしたい場合はmatplotlibもインストールする必要があります。

pip3 install matplotlib

How to use

以下のpythonプログラムを実行してください。

python3 test_performance.py

各引数は以下をご確認ください。

$ python src/test_performance.py
usage: test_performance.py [-h] [-d DIRECTORY] [-nd NUMBER_OF_DEVICE] [-nf NUMBER_OF_FRAMES] [-nt NUMBER_OF_TESTS] [-rt] [-re] [-db]

Performance test for your U3V Camera

options:
  -h, --help            show this help message and exit
  -d DIRECTORY, --directory DIRECTORY
                        Directory to save log
  -nd NUMBER_OF_DEVICE, --number-of-device NUMBER_OF_DEVICE
                        The number of devices
  -nf NUMBER_OF_FRAMES, --number-of-frames NUMBER_OF_FRAMES
                        The number of frames to obtain per test
  -nt NUMBER_OF_TESTS, --number-of-tests NUMBER_OF_TESTS
                        The number of tests to perform in this script
  -rt, --realtime-display-mode
                        Image capture in Realtime-display mode.
  -re, --realtime-evaluation-mode
                        Run performance test in Realtime-evaluation.
  -db, --delete-bins    Delete bin files in --realtime-ecaluation-mode.

以下のような出力が表示されます。

$ python src/test_performance.py 
[LOG ion-kit] This is ion-kit with debug-log; internal-develop 231011
[LOG ion-kit] The device is not GenDC supported
[LOG ion-kit] The device is not GenDC supported
log written in <output directory>\U3V-performance-test-YYYY-MM-DD-HH-mm-SS\0\frame_log.txt
0.964516129032258
log written in <output directory>\U3V-performance-test-YYYY-MM-DD-HH-mm-SS\1\frame_log.txt
1.0
log written in <output directory>\U3V-performance-test-YYYY-MM-DD-HH-mm-SS\2\frame_log.txt
1.0
log written in <output directory>\U3V-performance-test-YYYY-MM-DD-HH-mm-SS\3\frame_log.txt
1.0

数字はフレーム取得率です。つまり、表示が1.0の時はフレームドロップはありません。

グラフの作成

ドロップが起きた箇所を視覚化したい場合はvisualize_frame_log.pyを実行してください。

以下のような出力とともに、stat.pngが保存され、録画中のどのタイミングでフレームドロップが起きたかを青いまるで確認することができます。

$ python visualize_frame_log.py <output directory>\U3V-performance-test-YYYY-MM-DD-HH-mm-SS/
total run: 50
[96.47435897435898, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0, 100.0]
image is saved under <output directory>\U3V-performance-test-YYYY-MM-DD-HH-mm-SS/stat0.png

Linux

こちらよりSDKをインストールしてください。

sensing-dev バージョン v25.01.00 を使用してください。

How to use

以下のpythonプログラムを実行してください。

python3 test_performance.py