ZED SDK AI 모델을 수동으로 최적화하려면 어떻게 해야 하나요?
Last updated: October 22, 2026
ZED SDK는 깊이 추정(신경 LIGHT, 신경 및 신경 PLUS 깊이 모드), 객체 감지 및 추적, 인간 신체 감지 및 추적(스켈레톤 추적)을 위한 AI 모델을 제공합니다.
AI 모델은 크기 때문에 ZED SDK 설치 프로그램에 포함되어 있지 않지만, 설치 중에 당사 서버에서 다운로드하여 호스트 장치에서 사용 가능한 GPU에 맞게 최적화할 수 있습니다.
ZED SDK 설치 중에 AI 모델을 다운로드하고 최적화하지 않도록 선택하면, 필요한 AI 모델을 처음 사용할 때 ZED SDK가 자동으로 프로세스를 수행합니다.
AI 모델을 수동으로 정리하고 최적화해야 하는 상황은 다음과 같습니다:
- 호스트 장치의 GPU가 교체된 경우;
- ZED SDK가 새 버전으로 업데이트된 경우;
- 예기치 않은 이유로 다운로드 프로세스가 실패한 경우(예: 정전, 인터넷 연결 끊김 등);
- 예기치 않은 이유로 최적화 프로세스가 중단된 경우;
- ZED SDK 처리에서 예기치 않은 동작이 발생한 경우(예: 신경 깊이 모드에서 잘못된 깊이 맵, 잘못된 객체 감지, 잘못된 스켈레톤 감지 등).
참고: 아래에 설명된 모든 작업은 진단 테스트를 완료한 후 사용할 수 있는 AI MODELS 버튼을 클릭하여 ZED Diagnostics 도구의 그래픽 인터페이스에서도 수행할 수 있습니다. ZED Diagnostics 문서를 참조하십시오. 헤드리스 장치(예: 디스플레이가 없는 NVIDIA® Jetson™)에서는 -c 옵션을 추가하여 도구를 명령줄 모드로 실행하십시오.
명령을 실행하는 방법
셸 콘솔을 열고 아래 표에 설명된 옵션을 사용하여 도구를 실행하십시오.
- Linux / NVIDIA® Jetson™ (현재 폴더는 관련이 없음):
ZED_Diagnostic <option> - Windows (명령 프롬프트 또는 PowerShell):
명령 프롬프트(cmd.exe)에서는 앞에 있는cd "C:\Program Files (x86)\ZED SDK\tools"
& ".\ZED Diagnostic.exe" <option>&를 생략하십시오:"ZED Diagnostic.exe" <option>
<option>을 다음 중 하나로 바꾸십시오:
| 옵션 | 작업 |
|---|---|
-aic | 다운로드 및 최적화된 모든 AI 모델을 정리(제거)합니다. 디스크 공간을 확보하거나 문제가 제대로 작동하지 않을 때 최적화를 재설정하는 데 유용합니다 |
-nrlo_light | 신경 LIGHT 깊이 모델을 다운로드하고 최적화합니다 |
-nrlo | 신경 깊이 모델을 다운로드하고 최적화합니다 |
-nrlo_plus | 신경 PLUS 깊이 모델을 다운로드하고 최적화합니다 |
-nrlo_all | AI 기반 깊이 모델을 모두 다운로드하고 최적화합니다 |
-ais X | 단일 AI 모델을 다운로드하고 최적화합니다(아래 목록 참조) |
-aid | 최적화하지 않고 모든 AI 모델을 다운로드합니다(오프라인 배포를 준비하는 데 유용하며, 최적화는 나중에 대상 장치에서 수행됩니다) |
-aio | 한 단계로 모든 AI 모델을 다운로드하고 최적화합니다(시간이 다소 걸릴 수 있음) |
단일 AI 모델 다운로드 및 최적화
-ais X 옵션을 사용하여 sl::AI_MODELS 열거형에 따라 "X"를 정수로 바꿉니다:
- 0 - MULTI_CLASS_DETECTION:
sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_FAST와 관련 - 1 - MULTI_CLASS_MEDIUM_DETECTION:
sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_MEDIUM와 관련 - 2 - MULTI_CLASS_ACCURATE_DETECTION:
sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_ACCURATE와 관련 - 3 - HUMAN_BODY_FAST_DETECTION:
sl::BODY_TRACKING_MODEL::HUMAN_BODY_FAST와 관련 - 4 - HUMAN_BODY_MEDIUM_DETECTION:
sl::BODY_TRACKING_MODEL::HUMAN_BODY_MEDIUM와 관련 - 5 - HUMAN_BODY_ACCURATE_DETECTION:
sl::BODY_TRACKING_MODEL::HUMAN_BODY_ACCURATE와 관련 - 6 - HUMAN_BODY_38_FAST_DETECTION:
sl::BODY_TRACKING_MODEL::HUMAN_BODY_FAST및sl::BODY_FORMAT::BODY_38과 관련 - 7 - HUMAN_BODY_38_MEDIUM_DETECTION:
sl::BODY_TRACKING_MODEL::HUMAN_BODY_MEDIUM및sl::BODY_FORMAT::BODY_38과 관련 - 8 - HUMAN_BODY_38_ACCURATE_DETECTION:
sl::BODY_TRACKING_MODEL::HUMAN_BODY_ACCURATE및sl::BODY_FORMAT::BODY_38과 관련 - 9 - PERSON_HEAD_DETECTION:
sl::OBJECT_DETECTION_MODEL::PERSON_HEAD_BOX_FAST와 관련 - 10 - PERSON_HEAD_ACCURATE_DETECTION:
sl::OBJECT_DETECTION_MODEL::PERSON_HEAD_BOX_ACCURATE와 관련 - 11 - REID_ASSOCIATION:
sl::BatchParameters::enable과 관련 - 12 - NEURAL_LIGHT_DEPTH:
sl::DEPTH_MODE::NEURAL_LIGHT와 관련 - 13 - NEURAL_DEPTH:
sl::DEPTH_MODE::NEURAL와 관련 - 14 - NEURAL_PLUS_DEPTH:
sl::DEPTH_MODE::NEURAL_PLUS와 관련
참고: 숫자 ID는 sl::AI_MODELS 열거형의 순서를 따르며 주요 ZED SDK 버전 간에 변경될 수 있습니다. 설치된 ZED SDK 버전에 해당하는 목록을 확인하려면 항상 -h 플래그와 함께 도구를 실행하세요.
사용 가능한 모든 ZED Diagnostics 명령에 대한 자세한 내용은 -h 플래그를 사용하거나 ZED Diagnostics 문서를 참조하세요.