EarBand Build 260722 Release Notes

프로그램: fineAi_inferencer_cam_multi(EB)_v2.2_cu128_build_260722 작업일: 2026-07-22 이전 빌드: Build 260716 (v2.1)

핵심 요약: YOLO 판정용 새 모드 yolo_align 추가 — Live 이미지에 Canny 없이 Align+Center(회전정렬 + 중심이동) 만 적용해 YOLO로 판정. 정렬은 Augmentation Tool의 FeatureAligner를 그대로 이식하고 config_align.ini를 그대로 사용한다. 기존 yolo 모드 및 검사 판정 로직은 동작 불변.

---

1. 신규 모드: yolo_align (Live + Align+Center → YOLO, Canny 미적용)

배경

기존 yolo 모드는 Canny가 적용된 rotation-fix 이미지로 YOLO 판정을 한다. 새 모드는 동일한 YOLO 판정을 하되 입력을 Live 이미지에 Canny 없이 Align+Center만 적용한 것으로 사용한다.

정렬 기능 (Augmentation Tool 그대로 이식)

• earband_aligner.py (신규 모듈): Augmentation Tool Image_Processing_Tool_Aug_v1.6.1.py의 FeatureAligner + config 로더를 그대로 추출·이식.
• config/config_align.ini (신규): Aug Tool의 정렬 설정 복사본. [aligner] 섹션을 읽어 Aug Tool에서 튜닝한 것과 동일한 정렬을 재현.
• 정렬 = 제품 검출 → 회전각을 target_deg(-90°=12시)로 정렬 + 중심을 target_x/y(0.5,0.5)로 이동.

동작 흐름

Live 원본(Canny 없음)
  └ _apply_align_center(): config_align.ini[aligner] → FeatureAligner.align()  (Center+Rotation)
  └ 정렬 이미지 → evaluate_yolo_detection(cache=None)   (기존 YOLO 판정 로직 그대로)

모드별 독립 설정

evaluate_yolo_detection에 cfg_prefix 파라미터를 추가하여, threshold/iou/클래스별 threshold를 해당 모드 번호(modeN_*) 로 독립 지정. 기존 yolo(예: mode2)는 자기 번호 키를 그대로 사용해 동작 불변.

설정 예 (config_inferencer.ini [MULTI_INSPECT])

modeN_name = ObjectDetection-Align
modeN_source = live
modeN_type = yolo_align                 ; ← 핵심
modeN_model = C:/fine_Ai_viewer/model/yolov8l_EarBand-Hook_0320_last_v3.pt
modeN_threshold = 0.7
modeN_iou = 0.25
modeN_align_config = config_align.ini   ; (선택) 기본 config/config_align.ini
modeN_threshold_hook_ok = 0.5           ; (선택) 클래스별 threshold
modeN_threshold_hook_ng = 0.3

안전장치

• 정렬 실패(제품 미검출 등) 시 원본 이미지로 YOLO 판정을 계속 수행(로그 [ALIGN]).
• earband_aligner 모듈 미로딩 시에도 앱은 정상 실행(해당 모드만 원본 사용).
• 정렬 파라미터 변경은 Augmentation Tool에서 튜닝 후 config_align.ini 교체로 즉시 반영.

---

2. 변경 파일

파일	변경
...v2.2_cu128_build_260722.py	버전 v2.2, yolo_align 분기 + 정렬 헬퍼 + cfg_prefix + 분기점 확장
earband_aligner.py	신규 — Aug Tool FeatureAligner 이식 모듈
config/config_align.ini	신규 — Aug Tool 정렬 설정([aligner]) 복사
config/config_inferencer.ini	[MULTI_INSPECT]에 yolo_align 예시
...v2.2_cu128_build_260722.spec	hiddenimports에 earband_aligner 추가
docs/yolo_align_모드_가이드.md	신규 — 사용 가이드

참고: v2.2는 v2.1 build_260716의 모든 기능(Auto-RUN 유출 방지/무손실 프레임 큐/Quick-INSPECT GPU 최적화/시뮬레이터)을 포함하며, 위 yolo_align 기능이 추가된 것.

---

3. 검증

• config/config_align.ini 로더 OK (method=ring, target_deg=-90).
• 실제 2448×2048 Live 이미지 정렬 OK (같은 크기 출력, 회전+중심이동 적용).
• 소스 + earband_aligner COMPILE OK.
• 현장 실모델 Quick-INSPECT 테스트 양호(사용자 확인).

---

변경 로그

• 2026-07-22: v2.2 초판. yolo_align 모드 추가(Live+Align+Center→YOLO), FeatureAligner 이식, config_align.ini 연동, evaluate_yolo_detection 모드별 독립키화.