get_sketch_confidence

ZumiAI.get_sketch_confidence(name: str = 'Sketch') → float

스트리밍되는 카메라 영상에서 인식된 스케치의 신뢰도 점수를 가져옵니다.

이 함수는 sketch_detector_start() 로 스케치 인식이 활성화된 상태에서, 현재 영상에 스케치가 인식되었다면 해당 스케치 인식의 정확도를 나타내는 숫자를 반환합니다. 이 신뢰도 점수는 0.0(0%)부터 1.0(100%) 사이의 값으로, 주미가 스케치를 얼마나 확실하게 인식했는지 판단하는 데 사용될 수 있습니다.

매개변수:

name (str, optional) – 신뢰도 점수를 가져올 스케치의 이름. 이름은 영어로만 입력해야 합니다. 기본값은 “Sketch”입니다.

반환:

인식된 스케치의 신뢰도 점수. 0.0부터 1.0 사이의 값입니다.: 스케치가 인식되지 않았거나, 지정된 name`의 스케치 데이터가 없으면 0.0을 반환합니다. 예시: `0.92 (92%의 정확도로 인식됨)

반환 형식:

float

예제

>>> zumiAI.camera_stream_start()  # 카메라 스트리밍 시작
>>> zumiAI.sketch_detector_init() # 스케치 인식 초기화
>>> zumiAI.sketch_detector_start() # 스케치 인식 시작

>>> while True:
>>>     confidence_score = zumiAI.get_sketch_confidence(name="my_tree")
>>>     if confidence_score > 0.0: # 스케치가 감지되어 유효한 신뢰도 값이 반환된 경우
>>>         print(f"스케치 'my_tree'의 신뢰도: {confidence_score:.2f}")
>>>         if confidence_score > 0.85:
>>>             print("정확도가 매우 높네요! 잘 인식했어요!")
>>>     else:
>>>         print("'my_tree' 스케치 감지 대기 중...")
>>>     time.sleep(1) # 1초 대기

>>> zumiAI.sketch_detector_stop() # 스케치 인식 중지

참고

이 함수를 사용하기 전에 camera_stream_start() 로 영상 스트리밍을 시작하고, sketch_detector_init() 로 스케치 인식 기능을 초기화한 후, sketch_detector_start() 를 호출하여 스케치 인식을 활성화해야 합니다.
스케치 인식은 흰 종이에 검은 펜으로 사각형 테두리를 그리고, 그 안에 그린 그림을 보여줄 때 가장 잘 작동합니다.
이 기능은 주미 자체의 하드웨어 기능이 아니라, PC 기반 소프트웨어로 처리됩니다.