얼굴 인식
이미지 속 얼굴을 감지하고 주요 얼굴 특징을 식별하는 노드입니다.
설명
얼굴 인식 노드는 이미지에서 얼굴을 자동으로 탐지하고, 얼굴의 주요 특징점(눈, 코, 입 등)과 감정, 식별 확실성 등의 정보를 추출합니다.
얼굴 특징점의 좌표값을 반환하여 얼굴 분석, 감정 인식, 얼굴 비교 등 다양한 응용 프로그램에 활용할 수 있습니다.
탐지된 얼굴 정보는 데이터셋으로 출력되어 추가 분석이나 시각화에 사용할 수 있습니다.
포트 구성
입력 포트
- 데이터셋: 얼굴 이미지가 포함된 데이터셋
출력 포트
- 데이터셋: 얼굴 특징 정보가 추가된 데이터셋
출력 데이터셋
기본 정보
| 컬럼명 | 설명 |
|---|---|
| (원본 컬럼) | 원본 컬럼 |
| detectionConfidence | 얼굴 탐지 확실성 (0.0 ~ 1.0) |
| landmarkingConfidence | 얼굴 특징점 탐지 확실성 (0.0 ~ 1.0) |
감정 분석
| 컬럼명 | 설명 |
|---|---|
| joyLikelihood | 기쁨 가능성 (VERY_LIKELY, LIKELY, UNLIKELY, VERY_UNLIKELY) |
| sorrowLikelihood | 슬픔 가능성 |
| angerLikelihood | 분노 가능성 |
| surpriseLikelihood | 놀람 가능성 |
이미지 품질
| 컬럼명 | 설명 |
|---|---|
| underExposedLikelihood | 노출 부족 가능성 |
| blurredLikelihood | 흐림 가능성 |
| headwearLikelihood | 모자 착용 가능성 |
얼굴 각도
| 컬럼명 | 설명 |
|---|---|
| rollAngle | 회전 각도 (Roll) |
| panAngle | 좌우 회전 각도 (Pan) |
| tiltAngle | 상하 회전 각도 (Tilt) |
경계 상자
| 컬럼명 | 설명 |
|---|---|
| BoundingPoly_LT_X/Y | 경계 상자 좌상단 좌표 |
| BoundingPoly_RT_X/Y | 경계 상자 우상단 좌표 |
| BoundingPoly_RB_X/Y | 경계 상자 우하단 좌표 |
| BoundingPoly_LB_X/Y | 경계 상자 좌하단 좌표 |
| fdBoundingPoly_LT_X/Y | 얼굴 탐지 경계 상자 좌상단 |
| fdBoundingPoly_RT_X/Y | 얼굴 탐지 경계 상자 우상단 |
| fdBoundingPoly_RB_X/Y | 얼굴 탐지 경계 상자 우하단 |
| fdBoundingPoly_LB_X/Y | 얼굴 탐지 경계 상자 좌하단 |
주요 얼굴 특징점
| 컬럼명 | 설명 |
|---|---|
| LEFT_EYE_x, LEFT_EYE_y | 왼쪽 눈 중심 좌표 |
| RIGHT_EYE_x, RIGHT_EYE_y | 오른쪽 눈 중심 좌표 |
| NOSE_TIP_x, NOSE_TIP_y | 코 끝 좌표 |
| UPPER_LIP_x, UPPER_LIP_y | 윗입술 중심 좌표 |
| LOWER_LIP_x, LOWER_LIP_y | 아랫입술 중심 좌표 |
| MOUTH_CENTER_x, MOUTH_CENTER_y | 입 중심 좌표 |
상세 특징점
눈, 눈썹, 코, 입, 귀, 턱, 볼 등의 세부 특징점 좌표가 포함됩니다:
- 눈 세부:
LEFT_EYE_TOP_BOUNDARY,LEFT_EYE_BOTTOM_BOUNDARY,LEFT_EYE_LEFT_CORNER,LEFT_EYE_RIGHT_CORNER등 - 눈썹:
LEFT_OF_LEFT_EYEBROW,RIGHT_OF_LEFT_EYEBROW,LEFT_EYEBROW_UPPER_MIDPOINT등 - 코:
NOSE_BOTTOM_CENTER,NOSE_BOTTOM_LEFT,NOSE_BOTTOM_RIGHT등 - 입:
MOUTH_LEFT,MOUTH_RIGHT등 - 기타:
LEFT_EAR_TRAGION,RIGHT_EAR_TRAGION,FOREHEAD_GLABELLA,CHIN_GNATHION,LEFT_CHEEK_CENTER등
속성
대상 열 선택
연결된 데이터셋에서 얼굴 이미지가 담긴 열을 선택합니다.
선택한 열의 이미지에서 얼굴을 탐지하고 특징을 추출합니다.
깊이 정보 삭제
얼굴 특징의 depth를 나타내는 z 좌표값을 삭제할지 선택합니다.
- 삭제: 2D 좌표(x, y)만 반환
- 유지: 3D 좌표(x, y, z) 모두 반환
일반적으로 2D 이미지 분석에는 z 좌표가 불필요하므로 삭제하는 것이 좋습니다.
선택한 대상 열을 삭제
출력 데이터셋에 원본 이미지 열을 포함할지 선택합니다.
- 삭제: 얼굴 특징 정보만 출력
- 유지: 원본 이미지 + 얼굴 특징 정보 출력
사용 방법
- 얼굴 인식 노드를 캔버스에 추가합니다
- 얼굴 이미지가 포함된 데이터셋을 연결합니다
- 대상 열에서 얼굴 이미지가 담긴 열을 선택합니다
- 깊이 정보 삭제 여부를 선택합니다 (보통 삭제 권장)
- 원본 이미지 열 유지 여부를 선택합니다
- 노드를 실행하면 얼굴 특징 정보가 데이터셋으로 출력됩니다
- 출력 데이터를 데이터 테이블 노드에 연결하여 결과를 확인할 수 있습니다
예제
주의사항
여러 얼굴 탐지 시 행 분리
하나의 이미지에서 여러 얼굴이 탐지되면 각 얼굴마다 별도의 행으로 분리됩니다.
- 예: 4개 이미지에서 총 10개 얼굴 탐지 → 10행 출력
- 원본 이미지 정보는 동일하게 유지되고, 얼굴 특징점만 각 행마다 다르게 기록됩니다
얼굴이 탐지되지 않는 경우
이미지에서 얼굴이 탐지되지 않으면 해당 이미지의 행은 출력되지 않습니다.
감정 분석 결과
감정 가능성(Likelihood)은 확률값이 아닌 등급으로 표시됩니다:
- VERY_LIKELY: 매우 높음
- LIKELY: 높음
- POSSIBLE: 보통
- UNLIKELY: 낮음
- VERY_UNLIKELY: 매우 낮음