5.4 KiB
5.4 KiB
Hansero Hai-Studio 설치 및 사용 안내
한세로테크노 AI 비전 학습 프로그램 설치파일입니다.
이 설치파일에는 학습 프로그램, 실행 런타임, 샘플 프로그램이 포함되어 있습니다.
1. 설치 방법
- 설치파일을 다운로드합니다.
- 설치파일을 마우스 오른쪽 버튼으로 클릭합니다.
관리자 권한으로 실행을 선택합니다.- 설치 안내에 따라 설치를 진행합니다.
- 설치가 완료되면 바탕화면 또는 시작 메뉴에서 프로그램을 실행합니다.
기본 설치 위치는 다음과 같습니다.
C:\Program Files\Hansero\VisionCore\
2. 학습 프로그램 사용 방법
2.1 프로그램 실행
설치 후 Hai-Studio 또는 Hansero AI Trainer를 실행합니다.
2.2 새 프로젝트 생성
새 프로젝트를 선택합니다.- 프로젝트 이름을 입력합니다.
- 학습 유형을 선택합니다.
지원 학습 유형:
Detection
Segmentation
Classification
Pose
- 프로젝트 저장 위치를 선택합니다.
- 프로젝트를 생성합니다.
2.3 이미지 추가
- 학습에 사용할 이미지 폴더를 선택합니다.
- 이미지를 프로젝트에 추가합니다.
- 이미지 목록에서 라벨링할 이미지를 선택합니다.
2.4 라벨링
- 이미지에서 검사할 대상을 박스로 지정합니다.
- 클래스 이름을 선택하거나 새로 추가합니다.
- 필요한 이미지에 라벨을 추가합니다.
- 작업 후 저장합니다.
2.5 학습 실행
학습메뉴로 이동합니다.- 모델 종류와 학습 옵션을 선택합니다.
- 학습을 실행합니다.
- 학습 진행 상태와 로그를 확인합니다.
학습이 완료되면 결과 모델이 생성됩니다.
2.6 추론 테스트
- 학습된 모델을 선택합니다.
- 테스트 이미지를 선택합니다.
- 추론을 실행합니다.
- 검출 결과, 점수, 처리 시간을 확인합니다.
2.7 ONNX 변환 및 Native 추론
학습된 PT 모델은 ONNX로 변환할 수 있습니다.
ONNX 모델은 C# Native ONNX 추론 모드에서 사용할 수 있습니다.
사용 모드:
PT / Python YOLO 모드
C# Native ONNX 모드
속도 비교나 실제 검사 프로그램 연동 테스트가 필요한 경우 Native ONNX 모드를 사용합니다.
3. 샘플 프로그램 사용 방법
설치 후 샘플은 다음 위치에서 확인할 수 있습니다.
C:\Program Files\Hansero\VisionCore\Samples\
3.1 샘플 폴더 확인
Samples 폴더에는 테스트용 이미지, 모델, 설정 파일이 포함되어 있습니다.
예시 구조:
Samples
├─ BoltInspection
├─ TrainerSample
├─ Models
└─ Images
설치 버전에 따라 폴더 이름은 다를 수 있습니다.
3.2 샘플 실행
Samples폴더를 엽니다.- 실행 파일 또는 샘플 프로젝트 파일을 선택합니다.
- 프로그램을 실행합니다.
- 샘플 이미지와 모델이 자동으로 불러와지는지 확인합니다.
- 추론 또는 검사를 실행합니다.
3.3 샘플 프로젝트 열기
학습 프로그램에서 샘플을 열려면:
프로젝트 열기를 선택합니다.Samples폴더로 이동합니다.- 샘플 프로젝트 폴더를 선택합니다.
- 프로젝트가 정상적으로 열리는지 확인합니다.
- 라벨, 이미지, 모델이 정상적으로 표시되는지 확인합니다.
3.4 샘플 검사 실행
샘플 검사 프로그램에서는 다음 항목을 확인합니다.
이미지 로드
모델 로드
추론 실행
OK / NG 결과 표시
검출 박스 표시
처리 시간 표시
결과 저장
샘플이 정상 동작하면 설치가 정상적으로 완료된 것입니다.
4. 설치 후 확인사항
설치 후 다음 항목을 확인합니다.
학습 프로그램 실행 여부
샘플 프로젝트 열기 여부
이미지 추가 가능 여부
라벨링 가능 여부
학습 실행 가능 여부
ONNX 변환 가능 여부
Native ONNX 추론 가능 여부
샘플 검사 프로그램 실행 여부
5. 문제 발생 시 확인사항
프로그램이 실행되지 않는 경우
다음을 확인합니다.
관리자 권한으로 실행했는지 확인
설치가 정상 완료되었는지 확인
백신 프로그램에서 차단하지 않았는지 확인
설치 폴더가 삭제되지 않았는지 확인
샘플이 열리지 않는 경우
다음을 확인합니다.
Samples 폴더가 있는지 확인
샘플 이미지가 있는지 확인
샘플 모델 파일이 있는지 확인
설치파일 용량이 비정상적으로 작지 않은지 확인
GPU가 표시되지 않는 경우
다음을 확인합니다.
NVIDIA 그래픽카드 장착 여부
NVIDIA 드라이버 설치 여부
GPU 사용 옵션 선택 여부
GPU 사용이 불가능한 경우 CPU 모드로 실행할 수 있습니다.
6. 권장 사용 순서
처음 설치 후에는 아래 순서로 확인합니다.
1. 학습 프로그램 실행
2. 샘플 프로젝트 열기
3. 샘플 이미지 추론 실행
4. 새 프로젝트 생성
5. 이미지 추가
6. 라벨링
7. 학습 실행
8. 학습 모델 추론 테스트
9. ONNX 변환
10. Native ONNX 추론 테스트