비전 검사 도움말

1. 한눈에 보기

비전 검사는 카메라 한 장을 검사 레시피(.vrp)로 판정해 OK · NG · 판정 없음을 냅니다. 결과는 시스템 태그 vision.<작업>.* 로 나오고, 원하면 사용자 태그(PLC)에 되쓰며, NG 그림과 결과 기록을 게이트웨이에 남깁니다.

2. 권한

3. 검사 레시피

검사 레시피 탭에서 .vrp 를 올립니다. 게이트웨이가 엔진으로 시험 적재해 통과한 것만 담습니다(한 벌 32 MB · 이 장비 전체 32 벌 128 MB · 프로젝트 묶음에 실리는 버전 합 33 MB — 묶음은 48 MB 까지). 담을 때 엔진이 한 번 싣고 다시 저장한 꼴로 담으므로 내려받은 파일이 올린 파일과 글자 차례가 다를 수 있습니다. 엔진이 받지 않으면 까닭을 화면 언어로 보입니다. 레시피는 프로젝트 묶음에 실립니다. 레시피 본문은 관리자만 내려받을 수 있습니다.

4. 검사 작업 만들기

1. id — 영소문자·숫자·_. 결과 태그 이름이 vision.<id>.* 가 됩니다.
2. 카메라와 검사 레시피를 고릅니다.
3. 트리거(수동·태그 에지·주기)를 정합니다.
4. 출력 대응 — 레시피에서 출력을 골라 결과 태그 out.<이름> 로 냅니다. 주소(작업 UUID)는 손으로 적지 않습니다. 작업 UUID 는 늘 소문자로 저장됩니다 — 비전 엔진 r5 부터 엔진이 레시피의 작업 ID 를 소문자로 읽기 때문입니다. 대문자로 저장된 옛 설정은 게이트웨이가 켜질 때 한 번 소문자로 고쳐 적고, 그 아래 버전의 엔진에서도 그대로 돕니다.
5. 결과 쓰기 — 판정·출력·누적 수를 사용자 태그로 씁니다(PLC 되쓰기). 판정 없음일 때는 “판정 없음일 때 쓸 값” 이 있을 때만 씁니다.

5. 트리거와 프레임

• 트리거 뒤 프레임만 쓰기(기본 켬) — 트리거 시각 뒤에 들어온 프레임으로만 판정합니다. 3 초 안에 없으면 판정 없음(reason=camera)입니다.
• 트리거 뒤 기다림(settleMs, 0~5000 ms) — 카메라 프레임의 시각은 “게이트웨이가 받은 시각” 이라 RTSP 지연만큼 늦습니다. 부품이 멈춘 뒤 찍힌 영상만 쓰려면 지연보다 조금 크게 둡니다. 0 보다 크면 위 칸을 꺼도 기다립니다.
• 주기 트리거의 주기는 50 ms ~ 24 시간입니다(트리거는 50 ms 마다 살핍니다). 검사 한 번이 주기보다 오래 걸리면 그 사이 트리거는 버려지고 overrun 이 늡니다 — 짧은 주기는 레시피 · 장비의 검사 시간을 재 보고 고르세요.
• 트리거를 50 ms 마다 살피므로 100 ms 미만 주기는 50 ms 단위로 맞춰집니다(평균 주기는 지키지만 한 번 한 번의 간격은 고르지 않습니다).
• 일반 작업(움직임 영역 · 물체 추적이 없는 레시피)은 트리거 뒤 프레임만 쓰기가 켜져 있으면 트리거마다 새 프레임을 기다립니다. 주기가 카메라 한 장 간격보다 짧으면 기다리는 동안 친 주기가 버려져 overrun 이 늡니다 — 주기를 카메라 간격과 같거나 길게 두세요.
• 짧은 주기(초당 여러 번)로 오래 돌릴 때는 결과 기록 보관 줄 수(results keep)를 줄이고 결과 그림은 NG 만 남기세요 — 기록 · 그림 쓰기가 저장 장치(CM4 의 eMMC)를 많이 씁니다.
• 이미 검사 중인 작업에 트리거가 또 오면 버리고 overrun 을 셉니다(대기는 한 번뿐).
• RTSP 카메라 권장치 — 게이트웨이는 스트림을 카메라 속도로 계속 받아 디코드하므로 장비 부담은 카메라 쪽 해상도 · fps 가 정합니다. 카메라에서 서브스트림 720p · 15 fps 이하를 고르고, 게이트웨이의 내보내는 빈도는 기본 2 fps 로 두세요(검사가 더 자주 필요할 때만 올립니다). CM4 는 RTSP 카메라 6 대까지 등록됩니다(720p · 15 fps 6 대 실측 약 0.8 코어). 7 대째는 까닭과 함께 거절됩니다. 맥 · 윈도는 논리 코어 × 2 대(6~32 대)까지이고, 설정 폴더 cameras.json 의 maxRtspCameras(1~64)로 바꿀 수 있습니다.

6. 출력·범위 판정

출력에 최소·최대를 두면 결과 태그 out.<이름>.ok(1 = 범위 안, 0 = 밖)가 생깁니다. 값이 없거나 수가 아니면 범위 밖입니다. 판정 출처로 무엇이 OK·NG 를 정할지 고릅니다.

판정 출처가 엔진 판정이면 검사 기록 표의 범위 밖 표시는 “참고 — 범위 밖” 으로 흐리게 보입니다(판정에 들어가지 않았다는 뜻).

레시피의 부분 판정(JudgeLogics)은 결과 태그 partial.0, partial.1 … 로 나옵니다(1 · 0, 판정 없음이면 비어 있음).

7. 레시피 입력 덮기

열거 입력(예: OCR 띄어쓰기·읽기 방식, 코드 판독 맞춤 방식)은 비전 엔진 r4(C API 레벨 4) 이상에서 덮을 수 있습니다. 후보는 엔진이 지금 들고 있는 목록을 보이고(저장해 엔진에 올라간 작업), 값은 이름으로 넣습니다. 그 아래 버전의 엔진이면 목록에 “보류” 로 보이고 저장도 거절합니다. 형식을 바꾸는 입력(TypeConverter·CreateObject·ObjectAttribute·ArrayElementAccess 의 형 고르기)은 그 작업의 출력이 다른 작업에 이어져 있으면 엔진이 “연결된 출력이 있어 바꿀 수 없음” 으로 거절합니다 — 레시피에서 연결을 먼저 끊으세요. 이미 고른 값을 다시 고르는 것은 됩니다.

레시피를 바꾸지 않고 임계값 같은 입력만 바꿀 때 씁니다. 작업 편집의 레시피 입력 덮기에서 입력을 고르고 값을 적으면, 레시피를 실은 뒤 그 값으로 덮습니다. 수·참거짓·글자 입력과 열거 입력(엔진 r4 이상)을 덮을 수 있습니다(영상·영역·좌표는 안 됩니다).

입력 덮기는 결과 태그를 바꾸지 않으므로 폴링 중에도 저장할 수 있습니다. 저장하면 그 작업만 새 값으로 덮습니다 — 다른 작업은 그대로이고, 이 작업이 검사 중이면 그 검사가 끝난 뒤에 덮습니다(검사를 끊지 않습니다). 덮기를 빼면 레시피를 다시 실어 레시피 값으로 돌아갑니다.

8. 결과 태그

9. 누적 수와 자동 리셋

누적 수는 재시작을 넘어 이어집니다. 누적 자동 리셋을 켜면 게이트웨이 현지 시각으로 경계를 지날 때 0 으로 합니다.

• 일 마감 — 시각 하나(비우면 00:00).
• 교대 경계 — 시각 2~6 개(예: 06:00, 14:00, 22:00).
• 검사 번호(seq)는 되돌리지 않습니다 — 그림·기록과 잇는 열쇠입니다.
• 꺼져 있던 사이 지난 경계는 켤 때 되돌립니다. 시계가 뒤로 가도(시간 맞춤) 같은 경계로 두 번 되돌리지 않습니다.
• 주의 — 시계가 하루~이틀 뒤로 가면(잘못 맞춘 시계를 고칠 때 등) 그 사이 경계에서는 되돌리지 않습니다. 마지막으로 되돌린 경계보다 앞 시각이라 "이미 지난 경계" 로 보기 때문입니다. 시계가 그 경계를 다시 넘어선 다음 경계부터 정상으로 되돌립니다. 이틀 넘게 앞서 있던 시계는 기준을 당겨 바로 정상이 됩니다. 시계를 크게 고친 날에는 필요하면 누적 되돌리기를 손으로 누르세요.

손으로 되돌리려면 작업 카드의 누적 되돌리기(admin)를 씁니다.

10. 결과 그림·검사 기록

• 결과 그림 — 기본은 NG 만 디스크에 남깁니다(작업당 장 수·MB 상한, 모든 작업 합 1 GB). 오래된 것부터 지웁니다.
• 검사 기록 탭(operator) — NG 그림 모음과 결과 기록 표. 표는 판정으로 거르고 “더 보기” 로 앞 기록을 봅니다. 그림 칸이 “지워짐” 이면 상한 때문에 그림이 지워진 것입니다.
• 내려받기 — 검사 기록 탭의 결과 기록 CSV(지금 거르기대로, 2 만 줄까지)와 그림 zip(200 장·64 MB 까지, 목록 index.csv 포함). 브라우저가 기존 조회를 한 번에 하나씩 불러 묶으므로 게이트웨이에 큰 짐을 주지 않습니다. 레시피(.vrp)는 관리자만 검사 레시피 탭에서 받습니다.
• 보고서 부록 — 보고서 서식의 비전 NG 부록에서 작업을 고르면 보고서 구간 안 NG 결과(작업마다 최근 1~24 줄)가 표 뒤에 붙습니다. CSV 에는 번호·시각·출력, 화면·인쇄에는 그림(운전자 이상)이 나갑니다. 부록이 실린 보고서 파일은 운전자 이상만 받을 수 있습니다(그 파일을 만들 때 정해져, 서식을 뒤에 고쳐도 바뀌지 않습니다).
• 결과 기록은 작업마다 결과 기록 행 수(기본 5000, 최대 20000, 0 = 끔)까지만 남습니다. 한 줄은 4 KB 까지이고, 넘으면 출력 값을 줄여 “(줄임)” 으로 표시합니다. 작업마다 파일은 8 MB 를 넘지 않습니다.

11. 돌리기·시험·일시정지

• 한 번 돌리기 — 수동 트리거. 결과 태그·PLC 쓰기·기록이 모두 바뀝니다.
• 한 장 시험 — 판정·출력·결과 그림만 봅니다. 누적 수·결과 태그·PLC 결과 쓰기는 바뀌지 않습니다. 영상 파일로도 시험할 수 있습니다.
• 일시정지 — 멈춘 동안 모든 트리거(에지·주기·수동·스크립트)를 버립니다. 한 장 시험은 됩니다. 게이트웨이를 다시 켜면 풀립니다.

12. SCADA 비전 요소

SCADA 카메라 요소의 소스를 비전 검사 결과(vision:<작업>)로 고르면 마지막 결과 그림과 판정 띠(위·아래·없음), 누적 수를 보입니다. 그림은 검사 번호가 바뀔 때만 받습니다. viewer 키오스크에서도 보입니다.

13. 알람 제안·OEE

• 알람 제안(admin, 작업 카드) — 확인하면 알람 규칙 둘을 만듭니다: NG 3 번 잇달아(ngStreak, 심각), 지연이 작업 시간 상한을 넘음(latencyMs, 경고). 물체 검출 작업은 대상 갈래 개수 · 검출 결과 믿을 수 없음 규칙을 더해 넷입니다(20 장). 알람 화면에서 고칠 수 있습니다.
• OEE — 품질 수량으로 양품 vision.<작업>.okCount, 전체 vision.<작업>.count 를 고릅니다.

14. 스크립트·MCP

• 스크립트: vision.run("작업")(= vision.trigger)는 검사를 넣고 바로 돌아옵니다. vision.last("작업") 은 마지막 결과 {result, judgment, seq, ts, outputs, …} 또는 null. 결과를 기다리려면 on("vision.작업.seq", …).
• 배열 출력(히스토그램 칸·선 프로파일 표본 등)은 값 하나가 아니라서 이름 붙은 출력·범위 판정으로 고를 수 없습니다. 수 배열은 결과마다 arrays({"<작업 ID>.out[<번호>]": [수…]})로 따로 실려 vision.last("작업").arrays 로 읽을 수 있고, 화면 작화에서 차트 요소의 '비전 결과 배열로 그리기'로 결과마다 통째로 그립니다. 히스토그램·선 프로파일 도구는 배열 출력 입력을 켜야 배열이 실립니다.
• MCP: vision_* 도구(상태·작업·레시피·돌리기·시험·요약·그림 목록·결과 기록·일시정지·재개·속성 읽기·입력 덮기).

15. 문제 해결

16. 샘플 프로젝트 — 비전 검사 라인

동봉 샘플 비전 검사 라인(프로젝트 › 샘플)은 검사 작업 넷을 폴더 재생 카메라로 돌립니다. 합성 영상 26 장(앞 세 작업은 OK 3 · NG 3, 정밀 검사는 8 장)을 2 초마다 판정해 OK·NG·양품률·연속 NG 를 보입니다. 화면은 두 장이고 머리의 검사 화면 · 정밀 검사 탭으로 옮깁니다.

준비(관리자, 열기 전에)

1. vision-sample-images.zip(3.2 MB)을 받아 풉니다. 그림 폴더 넷(6 · 6 · 6 · 8 장)과 보정 연습 파일(calibration/)이 있습니다.
2. 구성 › 공용 연결 › 영상 › 카메라 등록에서 종류 폴더 재생 카메라를 넷 만듭니다 — id vision_count · vision_area · vision_code · vision_flange, 그림 폴더 vision-count · vision-area · vision-code · vision-flange, 한 장 간격 2500 ms.
3. 각 카메라를 저장하기 전에 창 아래 그림 폴더 판의 JPEG 올리기로 같은 이름 폴더의 그림을 올립니다(저장한 뒤에 더 올리면 카메라를 다시 저장해야 반영됩니다).
4. 프로젝트 › 샘플에서 비전 검사 라인을 엽니다. 카메라가 먼저 있어야 검사 작업이 들어옵니다 — 순서를 바꿨다면 카메라를 만든 뒤 샘플을 다시 엽니다. 열면 이 장비의 비전 작업 · 레시피 · 보정이 샘플 것으로 바뀝니다.

• 검사 주기(2 초)를 카메라 간격(2.5 초)보다 짧게 두어 트리거 뒤 프레임이 한 장을 한 번씩 봅니다. 그림은 이름 차례로 돌아 작업마다 NG 가 세 번 이어지고, 최대 연속 NG 가 3 이 되면 알람이 납니다. 비전 검사 화면의 overrun 수가 조금씩 느는 것은 정상입니다(트리거가 카메라보다 잦아 다음 그림을 기다리는 동안 친 주기).
• 누적 수는 자정에 0 으로 돌아갑니다. 아래 줄의 전체 OK · 전체 NG · 양품률 · 최대 연속 NG 는 네 작업을 합칩니다. 그림은 묶음(.acproj)에 담기지 않으므로 다른 게이트웨이로 옮길 때 다시 올립니다(정밀 검사 카메라의 보정은 묶음에 담깁니다).
• 오래 켜 두는 시연·전시에서는 연속 NG 알람이 한 바퀴(약 15 초)마다 울렸다 풀리므로 알람 이력이 계속 쌓입니다. 필요하면 알람 규칙을 끄거나 이력 보존 기간을 줄이세요.
• 결과 그림 위의 PASS · FAIL 같은 글은 검사 엔진이 그림에 직접 그리는 글이라 화면 언어와 상관없이 영어로 보입니다. 판정 띠와 화면 글은 화면 언어를 따릅니다.
• 비전 엔진(CM4 선택 꾸러미 · 윈도우 설치 구성요소)이나 라이선스의 vision 기능이 없으면 화면은 열리고 각 칸에 비전 검사 기능이 설치되지 않음이 보입니다.

16-1. 정밀 검사 — 레시피 조정(티칭) 연습

넷째 작업 precision 은 판 부품 한 장에서 도구 셋을 차례로 돌립니다: Locate(패턴 모델로 위치 맞춤) → Bore(구멍 지름) → Lot(로트 글자 읽기). Bore 와 Lot 의 영역은 Locate 가 찾은 위치를 따라 옮겨집니다(위치 맞춤 결과를 받는 입력 Align). 카메라 vision_flange 의 보정(격자 판 그림으로 만든 0.1 mm/화소)이 프로젝트에 함께 실려 있어 지름이 mm 로 나옵니다.

처음 레시피는 연습을 위해 일부러 덜 가르쳐 두었습니다. 패턴 모델은 회전 ±5° 까지만 찾고, 글자 모델에는 8 표본이 없습니다.

연습(관리자 · 라이선스 vision-teach) — 작업 카드 › 레시피 조정으로 작업대를 열고, 영상 출처는 폴더 재생 그림 vision-flange 에서 고릅니다. 자세한 화면은 17 의 각 절에 있습니다.

1. 패턴 모델(17-3) — 그림 01 을 고르고 위 줄 마스터 영상의 지금 영상 넣기. 도구 Locate 의 모델 줄 가르치기 → 회전 범위(±도) 15 → 가르치기. 영역은 그대로 둡니다(기준 위치). 그림 03 · 05 로 돌리면 위치를 찾습니다(점수 약 97~99).
2. 보정(17-2) — 폴더 그림은 보정 없이 열리므로 Bore 가 화소(약 100)로 재어 NG 입니다. 위 줄 보정 없음 옆 고르기에서 vision_flange 를 고르면 10.02 mm 로 OK 가 됩니다.
3. 글자 학습(17-4) — 그림 08 을 고르고 도구 Lot 의 글자 학습 → (1) 나누기(상자 7 개) → (2) 2610B08 입력 → (3) 표본으로 더하기 → (4) 학습 시작 → (5) 이 영상 읽기 가 2610B08. 표본은 약 90 개라 학습은 맥에서 1 초가 안 걸립니다.

세 가지를 마친 뒤 게시로 새 버전을 만들고 게시 창에서 precision 을 고르면 운전 검사에 쓰입니다. 처음 상태로 돌아가려면 버전 관리에서 원본 버전으로 되돌립니다.

• 처음 레시피(약 280 KB)는 글자 표본 84 개를 담은 채(표본 보존 켬) 학습했습니다 — 표본을 더해 다시 학습할 수 있습니다.
• 처음 레시피로 돌리면 돈 부품 둘과 지름 NG 둘이 이어져 정밀 검사의 연속 NG 가 4 가 됩니다.
• ZIP 의 calibration/ 에 격자 판 그림(5 mm 칸)과 그것으로 만든 보정 파일 vision_flange.cal 이 있습니다. 캘리브레이션 탭에서 지우기 · 올리기를 연습할 때 씁니다 — 지우면 작업이 보정 없이 다시 적용되어 지름이 화소로 나오고 모두 NG 가 됩니다.
• 마스터 영상(640×480 회색)은 날 화소 약 0.3 MB · 레시피 안에서 약 0.4 MB 입니다.

16-2. 번호판 인식 — 글자 읽기 · 등록 차량 대조

동봉 샘플 자동차 번호판 인식(프로젝트 › 샘플)은 검사 작업 하나(plate)가 합성 번호판 그림 20 장을 읽고, 프로젝트 스크립트 plate-judge 가 읽은 글자를 등록 차량 목록과 맞춰 등록 차량 · 미등록 차량 · 읽기 실패 로 가릅니다. 번호판과 번호는 모두 컴퓨터로 그린 합성물(번호는 무작위)이라 실제 차량 번호와 우연히 같을 수 있고, 실제 차량 판독이나 출입 통제에 쓸 수 없습니다.

준비(관리자, 열기 전에)

1. plate-sample-images.zip(0.3 MB)을 받아 풉니다. plate-demo 폴더에 JPEG 20 장, 등록 목록, 글꼴 고지(SIL OFL 1.1)가 있습니다.
2. 구성 › 공용 연결 › 영상 › 카메라 등록에서 종류 폴더 재생 카메라를 만듭니다 — id plate_cam, 그림 폴더 plate-demo, 한 장 간격 2500 ms. 카메라를 저장하기 전에 창 아래 그림 폴더 판의 JPEG 올리기로 그림 20 장을 먼저 올립니다(저장한 뒤에 더 올리면 카메라를 다시 저장해야 반영됩니다).
3. 프로젝트 › 샘플에서 자동차 번호판 인식을 엽니다. 카메라가 먼저 있어야 검사 작업이 들어옵니다.

판정 규칙(검사 엔진은 글자를 읽었는지만 압니다 — 기준 글자는 비워 둡니다)

• 등록 목록은 태그 PLATE.REGISTRY(쉼표로 구분, 15 대)입니다. 태그 값을 바꾸면 스크립트를 고치지 않고 목록이 바뀝니다. 처음 열 때 비어 있으면 스크립트가 기본 목록을 써 넣습니다.
• 시연 20 장의 한 바퀴(50 초) 결과는 등록 14 · 미등록 6 · 읽기 실패 0(20 장 모두 바르게 읽음)입니다. 샘플 레시피의 글자 읽기 모델은 판 꼴 힌트(NNHNNNN|NNNHNNNN, 한글 칸 폭 1.0)를 켜고 학습했습니다 — 받침 없는 한글(예: demo_08 의 '가')이 자음·모음 두 조각으로 갈려 숫자로 읽히던 것을 한 글자로 묶습니다.
• 샘플 레시피는 비전 검사 기능 r12 이상이 있어야 돕니다. 그보다 낮은 버전 장비에서는 열어도 비전 검사 작업·레시피가 들어오지 않고, 불러오기 보고에 '이 레시피는 비전 검사 기능 r12 이상이 필요합니다' 가 보입니다 — 비전 꾸러미(CM4 선택 꾸러미 · 윈도우 설치 구성요소)를 올린 뒤 다시 엽니다.
• 한계: 한 글자만 틀리게 읽은 등록 차량은 미등록으로, 다른 등록 번호와 우연히 같게 읽히면 등록으로 나옵니다. 엔진의 글자별 점수는 쓰지 않습니다.
• 미등록·읽기 실패 때마다 PLATE.ALERT 가 2 초 펄스로 켜졌다 꺼져 알람 이력에 발생·해제가 쌍으로 쌓입니다. 누적은 누적 되돌리기 단추로 0 으로 돌립니다.
• 그림은 묶음(.acproj)에 담기지 않으므로 다른 게이트웨이로 옮길 때 다시 올립니다. 비전 엔진(CM4 선택 꾸러미 · 윈도우 설치 구성요소)이나 라이선스의 vision 기능이 없으면 화면은 열리고 비전 검사 기능이 설치되지 않음 이 보입니다.

16-3. 주차장 출입 번호판 장면 — 번호판 찾기 · 글자 읽기

동봉 샘플 주차장 출입 번호판 장면(프로젝트 › 샘플)은 16-2 와 달리 판만 찍은 그림이 아니라 입구 장면(1280×720)을 봅니다. 검사 작업 gate 의 레시피는 도구 둘 — 번호판 찾기(Finder)가 장면에서 판 자리를 찾아 그 영역을 글자 읽기(Plate)의 검사 영역으로 넘깁니다. 차 위치 · 판 크기(0.8~1.15 배) · 기울기(±5°) · 밝기가 장마다 다릅니다. 스크립트 gate-judge 가 16-2 와 같은 규칙으로 등록 차량 · 미등록 차량 · 읽기 실패를 가르고, 판을 못 찾은 장은 차 없음(누계 · 경보에 넣지 않음)으로 둡니다. 장면 · 번호판 · 번호는 모두 합성이며 실제 차량 · 현장 판독에 쓸 수 없습니다.

준비(관리자, 열기 전에)

1. plate-scene-images.zip(3.9 MB)을 받아 풉니다. gate-scene 폴더에 장면 28 장(차 24 · 빈 차로 4), 등록 목록(18 대), 글꼴 고지가 있습니다.
2. 폴더 재생 카메라 gate_cam(그림 폴더 gate-scene, 한 장 간격 2500 ms)을 만들고, 저장하기 전에 그림 28 장을 올립니다.
3. 프로젝트 › 샘플에서 주차장 출입 번호판 장면을 엽니다. 비전 검사 기능 r13 이상이 필요합니다(번호판 찾기 도구).

• 화면 왼쪽 카메라 칸은 검사한 장(겹그림 없이)을 보이고, 그 위의 초록 상자가 찾은 판입니다 — 스크립트가 판 상자 출력(가운데 X · Y, 폭, 각도)을 화면 좌표로 바꿔 상자를 옮깁니다(폭은 다섯 단계 중 가까운 것).
• 한 바퀴(70 초) 결과는 등록 16 · 미등록 8 · 읽기 실패 0 · 차 없음 4 입니다(맥 실측, 한 장 검사 약 6~10 ms).
• 레시피의 글자 읽기는 장면에서 찾은 영역으로 다시 가르쳤습니다(이진화 offset −40, 기울기 −8~8°, 판 꼴 힌트 NNHNNNN|NNNHNNNN). 샘플에 안 쓴 합성 장면 200 장에서는 194 장을 바르게 읽고 6 장은 읽기 실패, 다른 유효 번호로 잘못 읽은 판은 없었습니다.
• 판을 못 찾으면 차가 있어도 '차 없음' 으로 나옵니다(이 검사는 차를 따로 찾지 않습니다).

16-4. 컨베이어 물체 세기 — 같은 영상 · 초당 2 · 5 · 10 장

동봉 샘플 컨베이어 물체 세기(프로젝트 › 샘플)는 같은 합성 컨베이어 영상(상자 8 개가 왼쪽 → 오른쪽 160 px/s, 한 바퀴 약 38 초)을 초당 2 · 5 · 10 장 세 폴더로 나란히 돌립니다. 작업 셋(c2 · c5 · c10)의 레시피는 같은 꼴 — 글자 읽기(Label, 맨 앞) · 움직임 영역(Motion) · 물체 추적(Track)이고, 화면은 작업마다 개수(A→B · B→A · 합) · 지난 바퀴 / 이번 바퀴 · 최근 사건(번호 · 읽은 라벨) · 한 장 처리 시간 중앙값 · 배우는 중을 보입니다. 영상은 합성이며 실제 현장 계수에 쓸 수 없습니다.

준비(관리자, 열기 전에)

1. conveyor-sample-images.zip(21 MB)을 받아 풉니다. 폴더 셋 conveyor-2fps(76 장) · conveyor-5fps(190 장) · conveyor-10fps(380 장) — 장 수 × 간격이 셋 다 38.0 초라 오래 돌려도 세 칸 장면이 어긋나지 않습니다.
2. 폴더 재생 카메라 셋 — conv2_cam · conv5_cam · conv10_cam, 그림 폴더는 같은 이름, 한 장 간격 500 · 200 · 100 ms. 각각 저장하기 전에 그림을 올립니다.
3. 프로젝트 › 샘플에서 컨베이어 물체 세기를 엽니다. 링크비온 게이트웨이 0.1.0.19 이상(100 ms 주기 트리거)과 비전 검사 기능 r18 이상(다수결 학습 · 물체별 읽기 · 놓침 허용 시간)이 필요합니다.

• 계수 선은 화면 가운데 세로선(아래 → 위로 그음), A 쪽이 왼쪽이라 상자는 모두 A→B 로 셉니다. 한 바퀴 정답은 8 개, 라벨 차례는 P205 · P420 · H499 · P809 · B930 · A479 · E436 · T172 입니다.
• 최대 속도(px/s)는 세 레시피 모두 240(잰 물체 속도 160 × 1.5)입니다. 최대 이동(px/프레임) · 확정 프레임 · 놓침 허용 프레임 · 학습 프레임은 초당 장수에 맞춰 레시피마다 다르고(확정 · 놓침 허용 약 1 초, 학습 4 초), 놓침 허용 시간은 1000 ms 입니다. 움직임 영역의 배경 학습률(LearningRate) · 흡수 프레임(AbsorbFrames)도 프레임 단위라 초당 장수를 바꾸면 같은 값이 다른 시간이 됩니다 — 이 샘플은 흡수 프레임을 4 초분(8 · 20 · 40)으로 맞췄고 학습률은 기본값입니다. 기본 흡수 300 프레임(초당 2 장이면 150 초)이면 상자가 벨트에 있을 때 흐름이 시작될 때 배운 상자 자리가 유령 영역으로 오래 남아 개수가 틀립니다. 흡수만으로는 모자랍니다 — 같은 꼴 상자가 3.5 초마다 그 자리를 지나며 흡수를 끊어, 샘플을 연 순간 · 재개 때 벨트 위에 있던 상자 자리가 한 바퀴 가까이 남아 거짓 B→A 를 냈습니다. 그래서 세 레시피 모두 다수결 학습(18 장)을 켜고 학습을 4 초분(8 · 20 · 40)으로 늘렸습니다 — 상자 하나가 한 자리를 지나는 시간(약 1.1 초)의 두 배보다 길어 지나가는 상자를 배우지 않습니다. 그래서 학습 뒤 안정 구간(18 장)은 끕니다 — 샘플을 연 직후 · 재개 직후에도 학습 4 초('배우는 중') 뒤부터 모두 셉니다. 켜면 이 장면은 화면에 상자가 늘 둘쯤 있어 빈 프레임이 바퀴 끝 빈 벨트에서만 오므로 그때까지(최대 약 31 초) 지나간 상자를 세지 않습니다. 최소 넓이(MinArea)는 2000 px(상자 넓이의 약 9 %)로 작은 조각을 영역으로 보지 않게 했습니다. 판정 논리(전체 · 부분 1)는 물체 추적 하나로 두었습니다 — 기본(모든 작업 통과)이면 빈 벽을 읽는 Label 때문에 겹그림에 FAIL, 카드에 부분 1 이 늘 거짓으로 떴습니다. 확정을 약 1 초로 둔 까닭은 상자 앞머리만 보일 때 확정되면 첫 라벨 읽기가 일부 글자만 읽고 그치기 때문입니다.
• 물체별 라벨 읽기는 세 작업 모두 켰습니다(작업 편집 › 프레임 흐름). 새로 확정된 물체의 영역을 글자 읽기 작업으로 읽습니다(검사 결과 · 흐름 · 개수는 그대로, 18 장). 판정은 rules — 벨트 위 물체 영역 수 0~4 면 OK 입니다(글자 읽기의 고정 영역은 빈 벽이라 엔진 판정은 쓰지 않습니다).
• 맥 실측(20 분, 32 바퀴): 세 작업 모두 256 개(바퀴마다 8) · B→A 0 · 판정 없음 0 · 검사 2,432 · 6,080 · 12,160 번(장 수 그대로) · overrun 0, 읽은 라벨은 빠짐 · 겹침 없이 차례대로였습니다. 한 장 처리 중앙값은 약 4 ms 입니다(물체별 읽기 포함, 맥 Debug 라이브러리). 샘플을 연 직후와 상자가 벨트에 있을 때 재개한 직후 모두 학습 4 초 뒤 곧바로 세기 시작했고(B→A 0), 재개한 작업은 쉬는 동안과 학습 4 초 동안 지나간 상자만큼(1~2 개) 다른 작업보다 적습니다.
• 세 작업은 여는 순간 · 카메라 위상이 달라 누적 합계가 바퀴 안에서 조금씩 엇갈리고, 안정 구간이 끝나는 때도 작업마다 다릅니다. 같은 개수는 지난 바퀴 칸으로 봅니다(빈 벨트 틈 8 초를 넘으면 새 바퀴).
• 초당 장수(2 · 5 · 10)는 샘플이 고른 값이며 처리 한계가 아닙니다. CM4 등 장비별 처리 시간은 따로 재야 합니다. 사건 이벤트 기록은 기본 끔 그대로라 화면은 결과 태그(track.*)와 스크립트 conveyor-events 가 모은 최근 사건으로 보입니다. 결과 태그는 마지막 사건 하나뿐이라 한 프레임에 두 물체가 함께 선을 넘으면 목록에는 하나만 보입니다(개수는 둘 다 셉니다).

17. 레시피 조정(티칭)

검사 레시피의 임계값·선택 값을 영상으로 돌려 보며 맞추는 작업대입니다. 운전 검사와 따로 연 엔진에서 돌므로, 작업 덮기로 저장하거나 게시해 작업에 적용하기 전에는 운전 검사가 바뀌지 않습니다. 관리자만 쓰고, 라이선스에 vision-teach 기능이 있어야 합니다(시험 버전에서는 열리지 않습니다).

여는 길

• 검사 레시피 탭 › 줄 끝 조정 — 레시피 값으로 엽니다.
• 작업 카드 › 레시피 조정 — 그 작업의 입력 덮기를 얹은 상태로 엽니다(작업의 시간 상한·화소 형도 같이).
• 검사 기록 › 그림 창 › 이 그림으로 조정 — 그 그림을 영상으로 두고 엽니다.

영상 출처 — 머리의 영상 출처에서 다섯 가지 중 고릅니다: 카메라 지금 한 장 · 폴더 재생 그림 · 파일 올리기(JPEG·PNG, 8 MB) · 검사 기록 NG 그림 · 시험 묶음 그림. 검사 기록 그림은 보통 결과를 덧그린 겹그림이라 그 위에서 다시 돌린 판정은 참고만 하세요. 작업 편집 › 결과 그림의 NG 원본도 남김을 켜 두면 NG 마다 카메라 원본을 함께 남겨 그것을 씁니다(같은 용량 상한).

화면

자동 미리보기를 켜 두면 값을 바꿀 때마다 잠시 뒤 한 번 돌립니다. 끄면 돌리기를 누릅니다.

시험 묶음 — 머리의 시험 묶음에서 OK·NG 그림을 모아(한 묶음 100 장, 전체 200 MB) 한꺼번에 돌립니다. 기대는 기대 들이기로 expected.json(그림 이름 → judgment OK·NG, outputs 의 {"eq": 값}·{"min": a, "max": b}, 열쇠는 도구 이름.출력 이름)을 넣습니다. 결과는 조정 값과 열 때 값 두 갈래로 나란히 나오고, 맞음·거짓 합격·거짓 불합격·바뀐 판정 수를 보입니다. 어긋난 것만·CSV 받기·캔버스로(그 그림을 영상으로)를 씁니다. 시험 묶음은 게이트웨이에 남지만 프로젝트 묶음(.acproj)에는 담기지 않습니다.

저장 — 작업 덮기로 저장은 지금 조정 값을 같은 레시피를 쓰는 작업의 입력 덮기로 저장합니다. 레시피 값으로 되돌린 칸은 덮기에서 빠집니다. 저장한 다음 검사부터 운전에 쓰입니다. 영역 바꾼 것은 덮기로 남지 않습니다 — 게시하세요.

게시 — 머리의 게시는 지금 조정 값과 영역을 레시피의 새 버전으로 담습니다(엔진이 저장한 꼴, 메모를 붙임). 기존 버전은 바뀌지 않고, 게시 창에서 고른 작업만 새 버전을 씁니다. 세션을 연 작업은 입력 덮기 지움이 기본으로 켜집니다(그 덮기 값은 이미 새 버전에 들어 있습니다). 다른 작업의 덮기는 새 버전에 들어가지 않으므로 작업마다 따로 골라 지웁니다. 옛 버전과 같은 내용을 게시하면 새 버전을 만들지 않고 그 버전이 다시 게시 버전이 됩니다. 엔진이 레시피 저장을 못 하는 버전이면 게시 단추가 꺼집니다. 폴링 중에는 게시·적용이 거절됩니다.

버전 관리 — 검사 레시피 탭의 버전 관리에서 한 계보의 버전(게시·지난)을 보고, 지난 버전을 게시 버전과 비교하고(값이 다른 칸·연결·도구 이름·판정 논리), 이 버전으로 되돌리기로 작업이 옛 버전을 쓰게 합니다. 처음 올린 원본 버전은 늘 남고, 그 밖에 쓰는 작업이 없는 지난 버전은 계보마다 3 개까지 남깁니다(오래된 것부터 지움). 프로젝트 묶음에는 작업이 쓰는 버전과 게시 버전만 실립니다 — 원본·지난 버전은 이 게이트웨이에만 남고, 프로젝트를 다른 장비로 옮기면 버전 이력은 따라가지 않습니다(옮긴 장비에서는 실린 버전이 새 계보의 첫 버전처럼 보이고, 없는 앞 버전을 가리켜도 깨지지 않습니다). 이 장비 전체가 128 MB 를 넘으면 쓰지 않는 지난 버전부터 지워 자리를 내고, 그래도 모자라면 게시·올리기를 거절합니다. 작업대 머리와 게시 창에 남은 여유를 보입니다.

되돌리기·초안 — 머리의 되돌리기·다시하기(Ctrl+Z · Ctrl+Shift+Z)는 값·영역 바꾸기를 한 단계씩 거꾸로 돌립니다(세션당 100 단계). 바꾼 세션은 30 초마다 초안으로 자동 저장되고(머리에 "자동 저장 시각"), 닫거나 시간이 지나도 남습니다. 다시 열 때 초안이 있으면 이어서 열지, 버리고 게시 버전에서 열지 묻습니다. 초안이 다른 버전에서 시작했으면 그 버전 번호를 함께 보이고, 이어서 열면 초안의 버전으로(작업 덮기 없이) 열립니다. 초안은 프로젝트 묶음에 담기지 않습니다. 같은 레시피(계보)는 한 사람만 고칠 수 있습니다.

자동 설정·작업 이름·중간 영상·진단(비전 검사 기능 버전 r6 이상)

• 자동 설정 — 속성 판의 단추. 세션 영상으로 그 도구의 임계값·허용 범위를 엔진이 정합니다(면적·개수·밝기·대비·지름·길이·각도·색 도구만 — 다른 도구는 단추가 꺼지고 까닭이 보입니다). 바뀐 값은 속성 판에 "가르친 결과" 로 보이고 되돌리기 한 단계입니다. 가르친 뒤에는 판정이 없어 미리보기를 다시 돌립니다. 운전 검사 엔진은 건드리지 않고, 게시해야 작업에 쓰입니다.
• 이름 바꾸기 — 속성 판 머리에서 도구(작업) 이름을 고칩니다(UTF-8 128 바이트까지). 레시피 안의 이름이라 게시하면 새 버전에 들어갑니다.
• 중간 영상 — 출력 중 영상 출력은 "보기" 로 엔진이 만든 영상을 엽니다(마지막 미리보기 뒤에만). 긴 변이 2048 화소를 넘으면 줄여 받습니다.
• 진단 — 머리의 진단 단추가 레시피의 연결·영역·논리 문제를 알립니다. 마스터 영상 없음은 실행 때 영상을 붙이므로 결함이 아니라 걸러 수만 보입니다.
• 이름이 겹치는 열거 후보 — 후보 이름에 깨진 글자가 있어 같은 이름이 둘 이상이면 번호(#)로 고르고, 덮기에 이름과 번호를 함께 저장합니다. 레시피가 바뀌어 그 번호의 이름이 달라지면 작업이 오류로 알립니다.

• 세션은 이 장비에 엔진 하나를 더 올립니다. CM4 는 한 번에 하나, 그 밖은 둘까지 열리고, 한 사람은 하나만 엽니다(새로 열면 앞 것이 닫힙니다). 남은 메모리가 256 MB 아래면 열리지 않습니다.
• 10 분 동안 아무것도 안 하면 닫히고, 최대 2 시간입니다(아래 줄의 연장). 닫혀도 저장한 덮기는 남습니다.
• 세션 열기·닫기(바꾼 칸 목록)·덮기 저장·게시·버전 적용·시험 묶음 결과는 이벤트 기록에 남습니다.

17-1. 마스터 영상

작업대 머리 아래 줄에 마스터 영상: 있음 W×H 또는 없음 과 지금 영상 넣기 · 지우기 가 있습니다. 지금 세션 영상을 레시피의 기준 영상으로 넣습니다.

• 마스터 영상은 판정에 쓰이지 않습니다 — 검사는 늘 그때의 카메라 영상으로 돕니다. 위치 맞춤 결과를 받는 도구의 영역과 패턴 모델은 기준 자세에서 가르치므로(17-3), 그 기준 자세 그림을 레시피에 함께 남겨 두는 자리입니다. 진단의 “마스터 영상 없음” 은 결함이 아닙니다.
• 날 화소로 들어가 레시피가 커집니다(640×480 회색은 날 화소 약 0.3 MB · 레시피 안에서 약 0.4 MB, 5 MP 색은 약 15 MB) — 회색 카메라를 권합니다. 레시피에 8 MiB 넘게 더하면 확인을 묻고, 레시피가 32 MiB 를 넘으면 앞 상태로 되돌립니다.
• 넣기 · 지우기는 되돌리기 한 단계입니다. 작업 덮기 저장으로는 남지 않으므로 게시해야 운전 레시피에 들어갑니다.

17-2. 보정(캘리브레이션)

보정이 실리면 지름 · 길이 · 각도 · 면적 같은 측정 도구가 화소 대신 보정의 단위(보통 mm)로 값을 냅니다. 보정은 카메라마다 파일 하나이고 레시피와 따로 둡니다.

올리기 — 비전 검사 화면의 캘리브레이션 탭에서 카메라 줄의 올리기(있으면 바꾸기) → 보정 파일 고르기 → 가로 · 세로(비우면 파일에 든 원본 영상 크기, 0 이면 크기를 보지 않음) · 메모 → 올리기. 게이트웨이가 검사 기능으로 읽어 본 뒤 담고, 그 카메라를 쓰는 작업을 다시 적용합니다(“다시 적용한 작업 n · 실패 f”). 지우기는 그 작업들을 보정 없이 다시 적용합니다. 내려받기는 담은 파일 그대로입니다.

• 보정 파일은 이 화면에서 만들지 않습니다 — 격자 판 등으로 따로 만든 파일을 올립니다. 한 벌 4 MiB · 합계 16 MiB 까지이고, 프로젝트 묶음에 함께 실립니다(레시피 본문과 합쳐 묶음 48 MiB 까지).
• 작업은 보정을 실을 수 없으면 멈춥니다 — 작업 카드에 보정 파일을 읽을 수 없음 또는 영상 크기가 보정과 다름(카메라 영상 크기가 보정의 영상 크기와 다를 때). 틀린 mm 값을 조용히 내지 않기 위해서입니다.

작업대에서 고르기 — 머리 아래 줄에 보정: <카메라> 또는 보정 없음 과 고르기 가 있습니다. 영상 출처가 카메라 지금 한 장이면 그 카메라의 보정이 저절로 실립니다. 폴더 재생 · 파일 · 검사 기록 · 시험 묶음 그림은 보정 없음 으로 시작하므로 고르기 → 세션 보정 고르기 창에서 카메라를 고릅니다. 그런 그림으로 영상을 바꾸면 다시 보정 없음이 되니 다시 고릅니다. 세션에서 고른 보정은 운전 작업의 보정을 바꾸지 않습니다. 캘리브레이션 탭에서 파일을 바꾸면 줄에 “(보정 파일이 바뀜 — 다음 카메라 영상 때 다시 실음)” 이 보입니다.

17-3. 패턴 모델 가르치기

위치 맞춤처럼 패턴 모델 입력이 있는 도구는 속성 판의 모델 줄에 패턴 모델 있음(또는 패턴 모델 없음(아직 가르치지 않음))과 가르치기 단추가 있습니다. 세션 영상이 있어야 켜집니다.

1. 가르치기 → 패턴 모델 가르치기 창. 위에서 영상을 이 도구가 보는 영상(앞 도구의 전처리를 거친 것) 또는 원본으로 봅니다.
2. 모델 영역(기준 위치) — 처음에는 모델의 지금 영역입니다. 그대로 두거나, 모양을 골라 영상에서 끌어 새 영역으로 가르칩니다(큰 영상은 줄여 보여도 원본 좌표로 보냅니다).
3. 설정 — 에지 임계값 · 에지 모양 · 에지 대비 · 회전 범위(±도) · 피라미드 단계 등 모델 형마다 다릅니다. 빈 칸은 모델의 지금 값을 그대로 둡니다.
4. 가르치기(최대 30 초, 가르치기 취소). 결과는 되돌리기 한 단계이고, 미리보기를 다시 돌려 확인합니다.

• 영역은 기준 위치로 저장되고, 실행 때 위치 맞춤 결과(Align)만큼 옮겨 적용됩니다. 그래서 기준 자세 영상에서 가르칩니다 — 위치 맞춤 결과를 받는 도구의 창에는 이 안내와 마스터 영상 상태(17-1)가 함께 보입니다. 밀리거나 돈 그림에서 가르치면 뒤 도구의 영역이 그만큼 어긋납니다.
• 가르친 패턴 모델은 작업 덮기로 남지 않습니다 — 게시합니다. 레시피는 32 MiB 까지입니다.
• 운전 검사가 바쁘면 가르치기를 멈추고 알립니다. 운전을 멈추거나 덜 바쁠 때 다시 하거나, 운전 보호 없이 가르치기(관리자 확인, 그 한 번만, 기록에 남음 — 가르치는 약 2 초 동안 운전 검사가 느려집니다)를 씁니다.

17-4. 글자 표본 · 학습

글자 읽기 도구의 모델 줄에 표본 n 과 글자 학습 단추가 있습니다. 글자 읽기 학습 창은 다섯 단계입니다.

1. (1) 나누기 — 그 도구의 지금 글자 영역(또는 고른 모양)으로 영상을 글자 상자로 나눕니다. 나누기 설정(이진화 · 기울기 보정 · 조각 거르기 · 조각 잇기)을 바꿔 상자를 맞춥니다. 장비 버전에 따라 글자 높이 자동 추정(r11 이상)과 판 꼴 힌트(r12 이상 — 꼴 문자 N 숫자 칸 · H 한글 칸 · A 영문 칸 · / 줄 바꿈 · | 꼴 구분, 예 NNHNNNN|NNNHNNNN) 칸이 보입니다. 둘 다 기본은 끔이고, 켠 레시피는 그 기능이 없는 옛 버전 장비에서 쓸 수 없습니다. 한 모델의 표본은 한 나누기 설정이라, 표본이 있으면 설정이 잠깁니다(바꾸려면 표본을 모두 지웁니다).
2. (2) 이름 붙이기 — 왼쪽 위 상자부터 한 줄로 한 글자씩 칩니다. 빈칸은 그 상자를 건너뜁니다. 글자 수가 상자 수와 같아야 하고, 한글은 완성형으로 칩니다.
3. (3) 표본 — 표본으로 더하기. 글자별 개수, 목록(고른 것 지우기), 글자마다 모두 지우기, 내보내기 · 들이기(이 화면에서 내보낸 파일만, 32 MiB 까지). 표본 고침은 되돌리기 단계입니다.
4. (4) 학습 — 정확도 확인(교차 검증)(끄면 학습이 약 4~5 배 짧고 모델은 같습니다) · 나눌 묶음 수 · 표본 보존을 정하고 학습 시작.
5. (5) 확인 — 이 영상 읽기로 지금 영상의 읽은 글을 봅니다.

학습 시간 · 진행률 — 시작 전에 “표본 n · 이 장비 예상 약 t · 메모리 약 m MiB” 가 보이고, 남은 메모리가 모자라면 시작하지 않습니다(리눅스 장비). 학습 중에는 “p % · 지난 시간 / 예상 약 t” 와 단계(특징 만들기 · 분류기 맞추기 · 교차 검증)가 보이며, 진행률은 예상 시간의 몫이라 지난 시간과 거의 같이 갑니다. 창을 닫아도 학습은 계속되고 머리 줄에 “글자 학습 p %” 가 남습니다. 학습 취소는 표본 · 모델을 그대로 둡니다. 게이트웨이마다 한 번에 하나만 학습합니다.

운전 보호 — 학습은 운전 검사와 같은 게이트웨이에서 돕니다. 먼저 운전 검사의 평소 걸린 시간을 잡고(“운전 검사 기준을 잡는 중”), 학습하는 동안 운전 검사가 늦어지면 학습을 멈췄다가 처음부터 다시 시작합니다(자동 재개 3 회). 3 회를 다 쓰면 지금 재개를 사람이 누릅니다. 그래도 끝나지 않으면 세 길이 있습니다.

1. 운전(통신)을 멈추고 학습합니다.
2. 다른 게이트웨이(맥 · PC)에서 학습해 레시피를 올립니다 — 여기서 학습한 것과 같은 레시피가 됩니다.
3. 관리자가 확인하고 운전 보호 없이 재개합니다 — 학습하는 동안 운전 검사가 느려지고 감사 기록에 남습니다.

표본 보존(8 MiB) — 표본 보존을 켜면 학습 뒤에도 표본이 레시피에 남아 나중에 표본을 더해 다시 학습할 수 있습니다. 끄면 레시피가 작아지는 대신 그 레시피로는 다시 학습할 수 없습니다. 학습하면 예상 레시피가 8 MiB 이하이면 표본 보존이 기본으로 켜지고, 넘으면 기본으로 꺼집니다 — 끌 때는 먼저 표본을 내보내기로 받아 두세요. 표본을 보존한 채 레시피가 32 MiB 를 넘으면 학습을 거절합니다.

• 학습 결과는 되돌리기 한 단계이고, 게시해야 운전 검사에 닿습니다.
• 같은 표본이라도 다른 장비에서 다시 학습하면 모델 바이트가 달라 레시피 번호가 다를 수 있습니다(읽는 결과는 같습니다).

17-5. 자주 보는 오류

18. 움직임 영역·물체 추적(프레임 흐름)

레시피에 움직임 영역이나 물체 추적(비전 검사 기능 r15 이상)이 있으면 그 작업은 카메라 하나의 프레임 흐름입니다. 트리거마다 프레임 한 장을 차례로 넣어 배경을 배우고 물체에 번호를 붙여 따라갑니다. 고정 카메라와 주기 트리거로 씁니다.

• 프레임 시각 — 작업 편집 '프레임 흐름' 의 프레임 시각을 검사에 넘김(기본 켬)은 카메라 프레임을 받은 시각으로 빠진 프레임·속도(px/s)·사건 시각을 셉니다. 비전 검사 기능이 r15 미만이면 시각 없이 돌고 작업 카드에 '시각 없음' 이 보입니다.
• 주기 트리거의 프레임 고르기 — 주기 트리거로 도는 흐름 작업은 '트리거 뒤 프레임만 쓰기' 와 상관없이 지난 프레임 바로 다음 프레임을 한 장씩 넣습니다(프레임을 건너뛰거나 같은 프레임을 두 번 넣지 않음). 트리거 간격은 카메라 한 장 간격과 같거나 짧게 두세요 — 길면 그 사이 프레임은 넘어갑니다. 수동·에지 트리거는 그대로 트리거 뒤 프레임입니다.
• 낮은 FPS — 2~5 FPS 에서는 레시피 물체 추적의 최대 속도(px/s)를 '가장 빠른 물체 속도 × 1.5' 로 켜야 개수를 놓치지 않습니다. 0(끔)이면 한 프레임에 최대 이동(px/프레임)보다 많이 움직인 물체를 놓칩니다(예: 600 px/s · 2 FPS 는 한 프레임 300 px). 너무 크게 잡으면 가까운 다른 물체를 잡습니다.
• 계수 선 — A 끝에서 B 끝으로 긋습니다. A 쪽은 A 에서 B 를 바라볼 때 왼쪽입니다(화면 기준, 아래로 갈수록 y 가 큼). 왼쪽에서 오른쪽으로 그은 선이면 위쪽, 위에서 아래로 그은 선이면 오른쪽이 A 쪽입니다. 선분 안을 지난 물체만 셉니다. 물체가 서로 떨어져 지나는 곳에 긋습니다(붙어 지나면 하나로 셀 수 있습니다).
• 배우는 중 — 처음 프레임(학습 프레임 수)은 배경을 배우는 중입니다(흐름 상태 0). 이 동안의 결과는 판정 없음(사유 learning)이고 판정·출력 태그는 불확실(uncertain)로 나갑니다. 알람은 불확실 값으로 울리거나 꺼지지 않고, PLC 결과 쓰기는 판정 없음 값(noneValue)이 없으면 지난 값을 그대로 둡니다. 결과 태그 learning 과 작업 카드 '배우는 중' 으로 보입니다.
• 학습 뒤 안정 구간(0.1.0.19, 작업 편집 › 프레임 흐름 › 학습 뒤 안정 구간 최대, 기본 0 = 끔) — 물체가 화면에 있을 때 배운 배경은 그 물체 자리를 배경으로 기억합니다. 물체가 떠나면 그 자리가 '유령' 영역으로 남고, 비슷한 물체가 계속 그 자리를 지나가면 흡수(이어진 움직임만 배경으로)가 거듭 끊겨 오래 남습니다 — 그 조각이 계수 선 양쪽을 오가면 거짓 B→A 가 납니다. 켜면 학습이 끝난 뒤 화면에 움직임 영역이 하나도 없는 프레임이 오거나 최대 시간이 지날 때까지 개수 · 사건을 누적에 넣지 않고, 결과는 학습 중과 같게 판정 없음(사유 settling) · learning 참입니다. 엔진 개수의 바탕은 그동안에도 따라가므로 구간이 끝난 뒤 늘어난 만큼만 셉니다. 원인은 레시피의 다수결 학습(r18)으로 먼저 막고, 이 구간은 다수결 학습이 못 막는 현장 — 물체가 화면을 절반 넘게 덮는 붐비는 벨트, 학습 중 멈춰 있던 물체 — 의 방어용으로 씁니다(그동안 지난 물체는 세지 않습니다). 물체가 늘 지나가는 라인은 빈 틈이 한 번 지나가는 시간보다 길게 둡니다. 구간 동안 지나간 물체는 세지 않으니 누계는 그만큼 모자랄 수 있습니다.
• 다수결 학습(비전 검사 기능 r18 이상, 레시피 움직임 영역의 입력 WarmupMajority, 기본 끔) — 켜면 학습 프레임 동안 화소마다 가장 자주 보인 값을 배경으로 배웁니다. 학습 중 지나가는 물체를 배경으로 배우지 않으므로, 물체가 지나가는 중에 흐름이 시작 · 재개되어도 유령 영역이 남지 않습니다(위 안정 구간이 막던 원인). 학습 시간의 절반 넘게 한자리에 머무는 물체(느리거나 멈춘 물체)는 배경이 될 수 있으니 학습 프레임 수를 물체가 한 자리를 지나는 시간의 두 배보다 길게 둡니다(컨베이어 샘플은 4 초분). 물체가 화면을 절반 넘게 덮을 만큼 붐비거나 화면이 흔들리면 덜 정확합니다. 끄면 예전처럼 평균으로 배우고 레시피에 쓰지 않습니다 — 켠 레시피는 r17 이하 장비에서 열리지 않습니다. 다수결 학습만으로 모자란 현장에서만 안정 구간을 함께 켭니다(구간은 빈 프레임이 와야 끝나므로 물체가 늘 보이는 장면에서는 그만큼 세지 않는 시간이 남습니다).
• 처음부터 다시 배우는 때 — 이 작업의 설정·레시피·보정을 바꿀 때, 카메라 영상 크기가 바뀔 때, 카메라 연결이 끊겼다 다시 이어질 때(카메라를 아무도 30 초 넘게 보지 않다가 다시 열 때 포함 — 프레임이 늦게 오는 것만으로는 아님), 일시정지를 풀 때. 다른 작업만 고친 저장은 이 작업을 이어 둡니다.
• 개수 — 결과 태그 track.countAtoB·track.countBtoA·track.countTotal(누적, 9 장의 누적 자동 리셋·되돌리기를 따름), track.active(지금 추적 수). 다시 배워도 누적은 이어집니다.
• 사건 — 마지막으로 선을 넘은 물체가 track.lastId·track.lastDir(1 A→B · 2 B→A)·track.lastText·track.lastTs 와 검사 기록·작업 카드에 남습니다. 이벤트 기록에도 남기기는 기본 끔입니다 — 켜면 작업마다 분당 30 건까지 남기고 넘은 수는 한 줄로 알립니다(이벤트 기록을 많이 씁니다).
• 물체별 글자 읽기(비전 검사 기능 r17 이상) — 켜면 검사 바로 뒤 같은 프레임에서, 새로 잡힌 물체부터 그 물체 영역들을 고른 글자 읽기 작업으로 한 번에 읽습니다. 작업을 다시 돌리지 않고 레시피 입력도 바꾸지 않으므로 검사 결과·흐름·개수는 그대로입니다. 물체마다 글자 점수(아래)가 가장 높은 결과를 남기고(같으면 먼저 읽은 것), 같은 글이 두 번 나오면 그 물체는 더 읽지 않습니다. 작업 편집 멈춤 점수(기본 0 = 끔)를 켜면 점수가 그 값 이상인 첫 읽기에서 그 물체는 더 읽지 않아 읽는 횟수와 검사 시간이 줄어듭니다(같은 글 두 번·읽는 횟수 상한은 그대로, 최소 점수보다 낮게 두면 화면이 경고합니다). 선을 넘을 때 그 글과 점수가 사건·track.lastText·검사 기록으로 나갑니다. 글자 읽기 작업의 영상 입력은 검사 영상이어야 합니다(전처리 출력에 이으면 읽지 못함). 검사 영역 입력은 연결해도 됩니다(물체 영역을 따로 넘깁니다). 검사 시간 상한 안에서만, 프레임마다 정한 수까지 읽습니다.
• 글자 점수 · 최소 점수(r17 이상) — 글자 읽기는 글자마다 점수(0~1000, 읽은 글자일 확률의 천분율)를 내고, 읽기 점수는 그 가운데 가장 낮은 글자의 점수입니다(−1 은 모름 — 글자 없음·확률 없는 모델). 작업 카드·검사 기록에 마지막 검사의 글자 점수가, 티칭 미리보기 출력에 CharScores·Score 가 보입니다. 작업 편집 글자 읽기 최소 점수(기본 0 = 끔)를 켜면 점수가 그보다 낮은 OK 검사는 판정 없음(사유 '읽기 불확실', 판정·출력 태그 불확실 — 알람은 울리거나 꺼지지 않고, PLC 결과 쓰기는 판정 없음 값 규칙, 결과 그림은 원래 판정 OK 로 남길지 정함)이 됩니다. NG(엔진 NG·범위 밖)는 점수가 낮아도 NG 그대로입니다. 또 물체별 읽기는 가장 좋은 읽기가 그보다 낮으면 그 글을 '읽기 불확실'로 냅니다(track.lastText 불확실, PLC 결과 쓰기는 빈 글 — 판정 없음 값을 두었으면 그 값 — 이라 앞 물체 글이 남지 않음). 모름(−1)은 거르지 않습니다. 값은 현장에서 정합니다 — 실제 카메라로 바르게 읽은 것과 틀리게 읽은 것 몇 장의 점수를 검사 기록에서 보고 그 사이로 둡니다. 합성 글자는 대부분 900 대이지만, 실제 글자·한글은 바르게 읽어도 훨씬 낮을 수 있습니다(합성 번호판 시험에서 바르게 읽은 판의 점수가 28~954). 점수는 같은 모델 안에서만 비교합니다 — 다시 학습하면 같은 영상의 점수도 바뀝니다.
• 번호판 찾아 읽기 · 실행에서 건너뛰기(비전 검사 기능 r19 이상) — 물체별 글자 읽기에서 작업 편집 번호판 찾아 읽기에 레시피의 번호판 찾기 작업을 고르면, 추적 상자(차 전체 등)마다 그 안에서 번호판을 먼저 찾고 찾은 판을 읽습니다. 판을 못 찾은 상자(차 앞이 아직 안 보임 등)는 읽기 실패가 아니라 '판 없음'이라 읽는 횟수에 들지 않고 다음 프레임에 다시 봅니다. 판 찾기 점수(0~1000)는 글자 점수와 따로 남고, 글자 점수가 같은 두 읽기 가운데 고를 때만 씁니다(사건·작업 카드에 '판 찾기 점수'). 한 상자에서 판을 여러 개 찾았으면(두 차가 한 상자) 카드에 '상자에 판 여러 개'가 붙습니다. 상자가 판을 자르면 찾기 상자 넓히기(천분율, 200 = 상자 폭·높이의 20 % 씩 좌우·위아래)를 씁니다 — 찾는 넓이에 비례해 시간이 늡니다. 번호판 찾기 작업의 영상 입력도 검사 영상이어야 합니다. 권장 레시피는 움직임 영역 → 물체 추적에, 번호판 찾기 · 글자 읽기 작업을 서로와 흐름에서 끊고 티칭 화면 작업 속성의 실행에서 건너뛰기를 둘 다 켠 것입니다 — 그러면 프레임마다 두 작업이 돌지 않아(전체 영상 찾기 + 글자 읽기, CM4 720p 약 34 ms) 물체별 읽기 시간만 듭니다. 건너뛴 작업은 판정 OK 이고 출력은 그대로이며, 도는 작업이 그 출력을 읽으면 켤 수 없습니다(연결을 먼저 끊음). 건너뛰기는 레시피에 남으므로 게시해야 운전에 반영되고, 켠 레시피는 r18 이하 장비에서 열리지 않습니다. 건너뛰지 않은 읽기 작업이 있으면 작업 카드가 알립니다.
• 한 장 시험 — 카메라 프레임으로만 됩니다(그 프레임도 흐름에 들어가고 늘어난 개수는 누적에 더함). 올린 그림으로는 시험할 수 없습니다(흐름을 끊습니다).
• 사람을 가리지 않습니다 — 움직이는 것은 무엇이든 셉니다. 실제 현장 카메라로는 검증 전입니다.

19. 초점 맞추기(선명도)

레시피에 선명도 작업(비전 검사 기능 r24 이상)이 있으면 작업 카드 더보기의 초점 맞추기(operator 이상)로 렌즈 초점을 맞춥니다. 카메라 한 장으로 선명도 작업의 값만 읽고 그림은 받지 않으며, 누적 수·결과 태그·PLC 결과 쓰기·검사 기록은 바뀌지 않습니다. 작업 상태 조건은 한 장 시험과 같습니다.

• 일시정지 먼저 — 트리거(태그 변화·주기)로 도는 작업은 운전을 일시정지한 뒤 초점을 맞춥니다. 일시정지가 아니면 게이트웨이가 거절하고 화면은 그 까닭을 보인 채 읽기를 멈춥니다. 일시정지한 뒤 창을 다시 엽니다.
• 흐름 작업은 안 됨 — 움직임 영역·물체 추적(18 장)처럼 프레임 흐름을 쓰는 작업은 초점 맞추기를 거절합니다(흐름에 운전 밖 프레임이 들어가지 않게). 초점 전용 레시피의 작업을 따로 둡니다.

1. 기준 맞추기 — 초점이 맞은 영상으로 레시피 조정에서 선명도 작업을 가르칩니다. 그때의 점수가 기준(100 %)이 됩니다. 기준을 맞추기 전에는 막대 대신 점수만 보이고 '기준 없음: 먼저 기준을 가르치세요' 안내가 붙습니다.
2. 막대 보기 — 작업마다 막대 한 줄이 기준 대비 %(Relative)를 보입니다. 눈금은 0~150 % 이고 세로 선은 그 작업 Relative 출력에 둔 허용 범위의 하한이고, 범위가 없으면 기본 85 %로 봅니다. 줄 아래에 '허용 범위 하한 90 %' 처럼 실제 값이 보이고(범위가 없으면 '기본 85 %'), 값이 하한보다 낮으면 막대가 빨강입니다. 렌즈를 돌려 막대가 100 % 근처에 오게 맞춥니다. 화면은 응답을 받은 뒤 0.1 초 쉬고 다음 장을 읽습니다(응답이 느리면 간격을 늘려 최대 1 초). 창을 닫거나 탭이 가려지면 읽기를 멈춥니다.
3. 읽기 실패 — 읽기가 실패하면 막대를 비우고(지난 값을 초록·빨강으로 남기지 않음) 까닭을 보입니다. 최고값은 남습니다. 일시정지 아님·흐름 작업 거절이 아니면 1 초 간격으로 다시 읽습니다.
4. 최고값 — 줄마다 지금까지의 최고값과 지금 값의 최고값 대비 % 가 보입니다. 최고값은 '측정' 상태로 잰 값으로만 오르고 게이트웨이를 다시 켜면 지워집니다. 최고값 초기화 뒤 아무것도 건드리지 않고 두면 최고값 대비 % 로 값이 얼마나 흔들리는지 봅니다.
5. 허용 범위 — 작업 편집에서 선명도 작업의 Relative 출력을 고르면 허용 범위 하한 85 % 가 기본으로 채워집니다(이미 범위가 있으면 그대로). 생산 판정은 판정 출처 규칙(6 장)을 따릅니다. 판정 출처가 엔진 판정이면 이 허용 범위는 참고용이고 줄에 그 안내가 붙습니다 — 게이트웨이 허용 범위가 판정에 쓰이려면 판정 출처를 출력 범위만(rules) 또는 엔진 + 출력 범위(both)로 바꿉니다.

레시피에 선명도 작업이 없거나 카메라·검사가 실패하면 막대 자리는 비고 까닭이 보입니다.

20. 물체 검출 결과

안전 기능이 아닙니다 — 물체 검출은 인증된 안전 기능이 아닙니다. 사람의 안전이나 설비 보호를 위한 유일한 수단으로 쓰지 마세요. 검출 결과는 조명·카메라 각도·모델에 따라 달라지며, 물체를 놓치거나 잘못 검출할 수 있습니다.

레시피에 물체 검출 작업이 있으면 그 작업의 결과가 vision.<작업>.det.* 결과 태그로 나옵니다. 물체 검출 작업이 여럿이면 레시피 앞의 작업 하나입니다. 상자(위치)는 태그로 내지 않습니다 — 결과 그림의 겹그림과 물체 추적 입력으로 씁니다.

• 검출 작업 오류 — 레시피의 검출 작업 가운데 하나라도 오류(검출 모델 없음 · 라벨 불일치 · 추론 실패)이면 그 검사는 판정 없음(사유 detector_error)입니다. 판정식이 'NOT 검출 작업'처럼 되어 있거나 검출 작업을 판정식에 넣지 않았어도 OK 로 나가지 않고, NG 로도 세지 않습니다. 판정 없음이므로 result 는 none, judgment · 출력 태그는 불확실, PLC 결과 쓰기의 ok · ng 같은 판정 칸은 판정 없음 값을 둔 줄만 그 값을 쓰고, 잇단 NG(ngStreak)는 끊지도 잇지도 않습니다 — 그래서 잇단 NG 알람으로는 검출 오류를 잡을 수 없습니다. 검출 오류 · 모델 없음 · 카메라 끊김은 det.valid 가 1 보다 작으면 울리는 알람으로 잡습니다(작업 카드 알람 제안이 만들어 줍니다). 검사 기록에는 엔진 판정이 따로 남습니다.
• 값을 모를 때 — 판정 없음이거나 검출 작업이 오류이거나 실행에서 건너뛴 검출 작업(지난 값이 남아 있음)이면 det.* 태그는 모두 불확실(값 없음)이고 det.valid 는 0 입니다. 검사기는 오류 때 개수 0 을 내지만 그 0 을 '물체 없음'으로 내지 않습니다. 불확실한 태그로는 알람이 울리지 않으므로 det.valid 가 1 보다 작으면 울리는 알람을 함께 둡니다.
• PLC 결과 쓰기 — det.isResult · det.count · det.targetCount · det.maxScore · det.valid 를 출처로 고를 수 있습니다(배열은 쓰지 않음). 값을 모르면 판정 없음 값을 둔 줄만 그 값을 쓰고, 두지 않은 줄은 쓰지 않습니다(PLC 에 지난 값이 남음). 판정 없음 값을 −1 처럼 두거나 det.valid(늘 1 · 0 을 씀)를 함께 쓰면 PLC 가 '모름'을 가릴 수 있습니다.
• 알람 — 작업 카드의 알람 제안이 검출 작업에 규칙 둘을 더합니다: 대상 갈래 개수(det.targetCount 가 1 이상, 경고)와 검출 결과를 믿을 수 없음(det.valid 가 1 보다 작음 — 모델 없음 · 카메라 끊김 · 오류, 심각). 검출 결과 태그에 알람을 걸거나 검출 작업에 PLC 결과 쓰기를 새로 이을 때 위 고지를 확인하는 창이 뜹니다.
• 연결 기록 — 화면 · REST · 어시스턴트 · 묶음 들이기 어느 길로 이었든, 검출 결과를 PLC 결과 쓰기나 알람 규칙에 새로 이으면 보안 감사(vision.detector.link)와 이벤트 기록에 남고, 작업 카드에 '검출 결과가 알람 · PLC 에 연결됨'이 늘 보입니다.
• 갈래 걸러내기 — 걸러내기는 상자마다 가장 높은 갈래를 고르기 전에 적용됩니다. 상자 하나에는 갈래 하나입니다. 예를 들어 'person' 만 고르면 감지된 사람은 모두 남습니다. 걸러내기가 비어 있으면 모든 갈래를 봅니다.