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