ROVI-EVS · USER MANUAL

ROVI-EVS 사용자 매뉴얼

이벤트 카메라로 움직이는 사람 · 차량을 실시간으로 추적하는 ROVI-EVS 평가 키트의 설치, 연결, 라이브 추적, 녹화 · 재생, 결과 저장, 슈퍼 슬로모션, 초점 맞추기를 안내합니다.

1. 소개

ROVI-EVS는 바뀐 픽셀만 출력하는 이벤트 카메라(LUCID Triton2 EVS)와 FLOYD 처리 소프트웨어로 이루어진 평가 키트입니다. 움직이는 사람 · 차량을 찾아 ID · 박스 · 속도를 실시간으로 화면에 표시하고 파일로 저장합니다.

라이브 추적 화면 — 박스 · ID · 속도(px/s) · 이동 궤적 · 움직임 화살표

이벤트 카메라란

일반 카메라는 정해진 간격으로 화면 전체를 찍습니다. 이벤트 카메라는 픽셀마다 따로, 밝기가 바뀐 순간에만 신호(이벤트)를 냅니다. 이벤트 하나는 위치(x, y), 시각(µs 단위), 밝아졌는지 어두워졌는지(극성)로 이루어집니다.

센서 구조와 원리, RGB 카메라와의 차이는 이벤트 카메라(EVS) 백서에 그림과 영상으로 정리해 두었습니다.

이 매뉴얼에서 다루는 것

할 일장
카메라 · PC 준비, 네트워크 연결2 · 3장
점검 → 라이브 → 녹화 → 재생4장
화면 읽기, 키 조작5장
녹화 파일 다루기, 결과를 CSV로 저장6 · 7장
10,000 fps 슈퍼 슬로모션8장
초점 맞추기, 촬영 환경9 · 10장
문제 해결11장

2. 구성과 사양

구성품

항목내용
카메라LUCID Triton2 EVS (TRT009S-EC) · Sony IMX636 · 1280 × 720 · 2.5GigE
렌즈6.5 mm C-mount (8 mm도 사용 가능)
처리 PCx86-64 PC · Ubuntu 22.04 LTS · FLOYD 처리 소프트웨어 설치
케이블 · 전원Cat6 LAN 케이블, PoE+ 또는 외부 12–24 V 전원 (카메라 사양서 확인)

PC 권장 사양

항목파일 재생만라이브 추적 (권장)
CPUx86-64 4코어, AVX26–8코어 이상, 단일 코어 최대 클럭 4.5 GHz 이상
메모리8 GB16 GB
저장 장치SSD 20 GB 여유NVMe SSD 250 GB 이상 (녹화용)
네트워크없음카메라 전용 2.5GbE 포트
GPU필요 없음필요 없음 (AI 검출 기능을 쓸 때만 NVIDIA GPU)
모니터없어도 됨1920 × 1080
처리 속도는 코어 수보다 단일 코어 속도에 따라 정해집니다. PC가 느리면 소프트웨어가 스스로 처리량을 낮춰 멈추지 않고 계속 동작합니다(11장 "DEGRADE").

성능

항목값근거
추적 갱신 주기100 Hz (10 ms)실측
추적 처리 시간p95 3 ms실측
라이브 처리 상한초당 9.8 M 이벤트, 손실 0실측
슈퍼 슬로모션 가상 프레임10,000 fps (0.1 ms 간격)실측
다이내믹 레인지120 dB 이상센서 사양
픽셀 지연100 µs 이하 @ 1000 lx센서 사양
Windows용은 준비 중입니다. 지금은 Ubuntu 22.04에서 사용합니다.

3. 설치와 연결

3.1 카메라 설치

  1. 렌즈를 카메라에 끼우고 삼각대나 브래킷에 흔들리지 않게 고정합니다. 카메라가 흔들리면 장면 전체에서 이벤트가 나와 추적이 어려워집니다.
  2. 대상이 화면 안에서 충분히 크게 보이도록 거리를 정합니다. 박스는 화면에서 약 24 px 이상 크기의 움직이는 대상에 생깁니다.
  3. 초점은 9장의 방법으로 맞춥니다.
렌즈화각 (가로 × 세로)3 m에서 보이는 높이5 m10 m
6.5 mm51° × 30°1.6 m2.7 m5.4 m
8 mm43° × 25°1.3 m2.2 m4.4 m

3.2 네트워크

  1. 카메라를 PC의 2.5GbE 포트에 직접 연결합니다. 다른 장치와 같은 포트 · 스위치를 쓰지 않는 것이 좋습니다.
  2. 그 포트에 점보 프레임(MTU 9000)을 켭니다. 포트 이름은 ip link로 확인합니다.
ip link                                              # 카메라가 연결된 포트 이름 확인 (예: enp3s0)
sudo ip link set dev enp3s0 mtu 9000                 # 지금만 적용
nmcli connection modify "<연결 이름>" 802-3-ethernet.mtu 9000   # 재부팅 후에도 유지
  1. 카메라와 PC는 같은 서브넷에 있어야 합니다. 카메라 IP 확인 · 변경은 LUCID Arena SDK의 IpConfigUtility나 ArenaView를 씁니다.
MTU 1500에서도 초당 10 M 이벤트 이하에서는 오류 없이 동작했지만, 여유를 위해 9000을 권장합니다.

3.3 소프트웨어

~/evs-venv/bin/evs-env check        # 설치 경로 · 라이브러리 점검

명령을 짧게 쓰려면 실행 폴더를 PATH에 넣어 둡니다. 이 매뉴얼의 예시는 이렇게 했다고 보고 evs-demo로 적습니다.

echo 'export PATH="$HOME/evs-venv/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

4. 빠른 시작

  1. 점검 — 환경, 카메라 연결, 이벤트 수신, 녹화 시작을 차례로 시험합니다. 카메라가 없으면 환경 점검까지만 하고 끝나며, 이것도 정상입니다.
   evs-demo check
  1. 라이브 추적 — 카메라 영상과 추적 결과가 창에 나옵니다. 카메라가 여러 대면 -s <시리얼 번호>로 고릅니다.
   evs-demo live
  1. 녹화 — 라이브 화면에서 r을 누르면 녹화가 시작 · 정지됩니다. 처음부터 녹화하려면:
   evs-demo live --record
  1. 재생 — 녹화한 파일을 같은 화면으로 다시 봅니다.
   evs-demo replay runs/recordings/recording_261118_143000.raw

창을 닫으려면 q 또는 Esc를 누릅니다.

결과가 저장되는 곳

위치내용
runs/<날짜_시각>_<명령>/실행 기록 log.txt, 요약 summary.json, 스크린샷, CSV 결과
runs/<날짜_시각>_check/checklist.json점검 결과
runs/recordings/녹화 파일 recording_<YYMMDD_HHMMSS>.raw

runs/는 명령을 실행한 폴더 아래에 생깁니다. 다른 곳에 저장하려면 -o <폴더>를 붙입니다.

5. 화면 보기

추적 표시

표시뜻
색 박스추적 중인 이동 객체
#번호객체 ID — 같은 대상은 계속 같은 번호
px/s화면 속도 (초당 픽셀)
색 선지나온 궤적
화살표움직임 방향 · 크기 (색 = 방향, 오른쪽 아래 색 바퀴 참고)
점선 박스아직 확인 전인 후보

상단 정보 줄

줄내용
1모드(LIVE / REPLAY) · 파일 이름 · 재생 배율 · 시각 t · 갱신 주기(Hz) · 화면 fps
2ev 초당 이벤트 수 (Mev/s = 초당 백만 개)
3ms 단계별 처리 시간과 합계 · backlog 밀린 시간 · drop 버린 양 — 0이면 정상
4tracks 확정 · 확인 전 · 잠시 가려짐 객체 수, 화살표 수

뷰

숫자 키로 화면 종류를 바꿉니다. 최대 2개를 고르면 나란히 보이고, 같은 키를 다시 누르면 해제됩니다.

키뷰용도
1이벤트기본 화면. 밝아진 곳 · 어두워진 곳이 점으로
2셀이벤트가 모인 격자 칸
3필터 마스크노이즈로 걸러진 이벤트
4시간 표면최근에 바뀐 곳일수록 밝게 — 움직임의 흐름을 보기 좋음
이벤트 뷰(왼쪽)와 시간 표면 뷰(오른쪽)를 나란히 본 화면

키 조작

키동작
q / Esc종료
Space일시 정지 · 다시 재생
r녹화 시작 · 정지 (라이브에서만)
p스크린샷 저장 (실행 폴더에 PNG)
t박스 보이기 · 숨기기
iID 보이기 · 숨기기
l궤적 보이기 · 숨기기
f화살표: 격자 → 객체별 → 끄기
n확인 전 후보 보이기 · 숨기기
h상단 정보 줄 보이기 · 숨기기
1 ~ 4뷰 선택 (위 표)
< / >화면 축소 · 확대
k조명 깜빡임 필터 켜기 · 끄기 (10장)
[ / ]이벤트 수 상한 절반 · 두 배 (10장)
x추적 초기화

제어 창

라이브 · 재생을 시작하면 영상 창 옆에 제어 창(Control)이 함께 열립니다. 버튼을 누르는 것은 버튼 아래 [ ] 안의 키를 누르는 것과 같고, 파랗게 칠해진 버튼이 지금 켜져 있는 기능입니다.

제어 창 — 파란 버튼이 켜진 기능. 빗금 칸은 이 매뉴얼에서 다루지 않는 고급 · 개발용 기능입니다(기본값 그대로 사용)
제어 창 — 파란 버튼이 켜진 기능. 빗금 칸은 이 매뉴얼에서 다루지 않는 고급 · 개발용 기능입니다(기본값 그대로 사용)
버튼키하는 일
RECr녹화 시작 · 정지 (라이브에서만, 6장)
PAUSESpace일시 정지 · 다시 재생
TRACK ALGOT추적 계산 켜기 · 끄기 (끄면 추적이 초기화됨)
FLOW ALGOF움직임(흐름) 계산 켜기 · 끄기 — 화살표 표시에 필요
BOXES · ARROWS · TRAILSt · f · l박스 · 화살표 · 궤적 보이기 (5장 추적 표시)
CLUSTERSc추적 전 단계의 이벤트 묶음 보이기
HUDh상단 정보 줄 보이기 · 숨기기
VIEW EVENTS · CELLS · TIME1 · 2 · 4뷰 선택 (위 뷰 표, 두 개까지 나란히)
ACTIVITYa주변에 이웃이 없는 외톨이 점을 지우는 노이즈 필터 (소프트웨어)
SW STCs소프트웨어 노이즈 필터 방식 바꾸기 — 누를 때마다 끔 → cut → keep → trail
HW AFKk조명 깜빡임 필터 (카메라 안, 10장)
HW STCj노이즈 필터 (카메라 안) 켜기 · 끄기
ERC /2 · ERC x2[ · ]이벤트 수 상한 절반 · 두 배 (10장)
ACC − · ACC +- · =이벤트를 모아 한 화면으로 보는 시간(누적 시간) 줄이기 · 늘리기 — 빠른 물체는 짧게, 느린 물체는 길게
FLOW SLOW · FLOW FAST, · .흐름 계산 설정을 느린 움직임용 ↔ 빠른 움직임용으로
ASSOCg프레임 사이 물체를 잇는 방식을 두 가지 중에서 바꾸기 — ID가 자주 바뀔 때 시험
RESET TRKx추적 초기화
SNAPSHOTp스크린샷 저장
ZOOM − · ZOOM +< · >화면 축소 · 확대
QUITq종료
제어 창의 설정은 이번 실행에만 적용됩니다. 잘 모르겠으면 RESET TRK 후 기본값으로 다시 시작하세요.

6. 녹화와 재생

녹화

방법명령
라이브 중 원할 때라이브 화면에서 r (다시 누르면 정지)
처음부터 녹화evs-demo live --record
정해진 시간만evs-demo record --duration 30 (30초)

재생

evs-demo replay <파일>                           # 실제 속도로 재생
evs-demo replay <파일> --replay-factor 0.5       # 절반 속도 (0 = 최대 속도)
evs-demo replay <파일> --process-from 2000000 --process-to 5000000   # 2초 ~ 5초 구간만 (µs)

재생할 수 있는 파일: .raw(이 장비의 녹화), .dat, .hdf5.

7. 결과 저장 (CSV)

추적 결과(박스)를 CSV로 저장해 엑셀 · 파이썬 등에서 쓸 수 있습니다. 화면 없이 빠르게 처리하려면 --no-display --replay-factor 0을 함께 씁니다.

evs-demo replay <파일> --output-bbox-npy boxes.npy --output-bbox-csv boxes.csv
evs-demo replay <파일> --output-bbox-npy boxes.npy --output-bbox-csv boxes.csv --no-display --replay-factor 0   # 화면 없이 최대 속도
evs-demo live --output-bbox-npy boxes.npy --output-bbox-csv boxes.csv                                           # 라이브 중 저장
지금 버전은 --output-bbox-csv를 --output-bbox-npy와 함께 써야 CSV가 만들어집니다(같은 내용의 NumPy 파일이 함께 생김).

파일 이름만 쓰면 이번 실행 폴더(runs/<날짜_시각>_<명령>/)에 저장됩니다.

boxes.csv 열

열뜻단위
t시각µs (녹화 시작부터)
x, y박스 왼쪽 위 모서리px
w, h박스 너비 · 높이px
class_id분류 번호 (AI 검출을 쓰지 않으면 0)–
track_id객체 ID (화면의 #번호)–
class_confidence추적 신뢰도 — 오래 안정적으로 추적될수록 높아짐0–1

예 (--bbox-rate 10):

t,x,y,w,h,class_id,track_id,class_confidence
3070000,374.2,108.8,58.7,18.4,0,1,0.300
3160000,926.8,65.9,23.1,49.9,0,3,0.300

그 밖의 출력

옵션내용
--bbox-rate 10박스 기록 횟수를 초당 10번으로 (기본 50)
--output-sparse-csv-filename flow.csv움직임 화살표 원자료: x,y,polarity,timestamp,vx,vy,feature_id,center_x,center_y
--output-metrics metrics.jsonl갱신마다 이벤트 수 · 처리 시간 등 통계 (한 줄에 JSON 하나)
--roi X Y W H화면의 일부 영역만 처리

8. 슈퍼 슬로모션

이벤트를 0.1 ms 간격(가상 10,000 fps) 프레임으로 다시 그려, 같은 장면을 30 fps 카메라로 찍었을 때와 나란히 보여 줍니다. 빠른 낙하 · 회전 · 충돌처럼 일반 카메라에서는 한두 장으로 끝나는 순간을 자세히 볼 수 있습니다.

왼쪽: 30 fps 카메라로 찍었을 때(노출 33 ms) · 오른쪽: 같은 순간의 EVS 10,000 fps 프레임
evs-demo slowmo <파일> --start 1.0 --duration 0.3        # 파일의 1.0초부터 0.3초 구간
evs-demo slowmo --live --capture 0.5                     # 라이브: 미리보기에서 c 를 누르면 직전 0.5초를 슬로모션으로
evs-demo slowmo <파일> --start 1.0 --duration 0.3 --out clip.mp4 --stride 10   # MP4로 저장
키 (재생 창)동작
Space일시 정지
, / .한 프레임 뒤로 · 앞으로
[ / ]재생 속도 느리게 · 빠르게
r처음으로
v30 fps 비교 화면 켜기 · 끄기
s현재 프레임 PNG 저장
q닫기

9. 초점 맞추기

이벤트 카메라는 멈춘 화면을 보지 못하므로, 모니터에 초점 패턴을 깜빡이게 띄우고 그것을 찍으며 초점을 맞춥니다.

  1. 다른 PC나 모니터에서 초점 패턴 페이지를 엽니다. Siemens star(기본) 또는 slanted edge를 고르고, 화면을 누르면 전체 화면에서 10 Hz로 깜빡입니다.
  2. 모니터 밝기는 100%, 표시 배율은 100%로 하고, 자동 밝기 · 다이내믹 콘트라스트는 끕니다.
  3. 카메라를 모니터 정면에 두고 패턴이 화면 가운데에 크게 보이게 합니다.
  4. 초점 도구를 실행합니다.
   evs-demo focus --pattern star
  1. 창에 점수 막대가 나옵니다. 렌즈의 초점 링을 천천히 돌려 점수가 가장 높은 곳에서 고정합니다.
키동작
s현재 영상(PNG)과 점수(JSON) 저장
r누적 초기화 (렌즈를 크게 돌린 뒤)
q종료
패턴 페이지 주소: https://floyd.kr/manual/rovi-evs/focus.html. 60 Hz 모니터에서는 5 · 10 · 15 Hz처럼 60의 약수로 깜빡이는 것이 좋습니다.

10. 촬영 환경 팁

상황할 일
형광등 · LED 조명 아래에서 화면 전체에 점이 많음조명이 눈에 보이지 않게 깜빡이는 것을 카메라가 감지한 것입니다. k로 조명 깜빡임 필터를 켭니다(100 · 120 Hz 대역 제거).
PC가 따라가지 못함 (backlog · drop 증가)[로 이벤트 수 상한을 절반으로 낮춥니다(기본 초당 10 M). 필요한 영역만 --roi로 처리하는 것도 효과적입니다.
나뭇잎 · 물결 등 원치 않는 움직임--roi X Y W H로 관심 영역만 처리합니다.
대상이 박스로 잡히지 않음대상이 화면에서 너무 작거나(약 24 px 미만) 너무 느릴 수 있습니다. 가까이 두거나 렌즈를 바꿉니다. n으로 확인 전 후보를 볼 수 있습니다.
카메라가 차량 · 로봇에 달려 함께 움직임배경 전체가 움직임으로 보입니다. 지금 버전은 고정 카메라 기준입니다.
이벤트 카메라는 밝기 "변화"를 보므로 어둡거나 역광인 장면에서도 움직임을 잘 잡습니다. 다만 완전히 어두우면(빛이 없으면) 변화도 없습니다.

11. 문제 해결

증상확인할 것
check에서 카메라가 보이지 않음 (devices: (none))케이블 · 전원(카메라 LED), 같은 서브넷인지(3.2), Arena SDK 설치, ArenaView 등 다른 프로그램이 카메라를 쓰고 있지 않은지
창이 열리지 않음 (원격 접속 등)데스크톱 화면에서 실행하거나, 화면 없이 --no-display로 실행해 CSV만 저장
상단에 DEGRADE 표시PC 처리 한계에 닿아 소프트웨어가 스스로 처리량을 낮춘 상태입니다. 이벤트 수 상한을 낮추고([), 다른 프로그램을 닫고, MTU 9000을 확인합니다.
drop이 0이 아님위와 같음. 녹화 파일은 카메라 원본이라 나중에 재생해 다시 처리할 수 있습니다.
화면 전체가 지글거림조명 깜빡임(k) 또는 카메라 흔들림
r을 눌러도 녹화되지 않음녹화는 라이브에서만 됩니다(재생 중에는 안 됨).
재생이 너무 빠르거나 느림--replay-factor 값 확인 (1 = 실제 속도)
초점 점수가 오르지 않음패턴이 깜빡이는지, 모니터 밝기 100%인지, 패턴이 화면 가운데에 크게 보이는지

문제가 계속되면 runs/<날짜_시각>_<명령>/log.txt와 evs-demo check 결과(checklist.json)를 첨부해 문의해 주세요.

12. 문의

회사FLOYD Inc.
메일floyd@floyd.kr
전화070-8676-7976
웹floyd.kr — 검토 요청

평가 키트 대여 · 적용 검토(고속 낙하물 계수, 역광 · 저조도 이동체 추적 등)는 검토 요청으로 보내 주시면 회신드리겠습니다.