# 마이그레이션 시 유의사항

이 항목에서는 기존 프로젝트를 이전 릴리스에서 현재 Deep Learning 릴리스로 마이그레이션할 때 기존 프로젝트에 영향을 미칠 수 있는 변경 사항을 다룹니다.

## 기존 Green 분류 도구 아키텍쳐

이전 버전(ViDi Suite)에서 생성 된 워크스페이스를 열 때 Green Classify Tool이 있으면 Focused 모드로 나타납니다. Green 분류 도구의 기존 아키텍쳐를 Focused 모드라고 하고 새로운 Green 분류 도구의 아키텍쳐를 High Detail 모드라고 합니다.

## API의 기존 이름 유지

VisionPro Deep Learning은 ViDi를 상속하므로 API의 많은 부분에서 ViDi라는 이름을 유지합니다.

## API의 내부 버전

제품의 버전은1.0.0이지만, APIs와 바이너리에서는 5.0.0 버전이 사용됩니다.

## 사용 중단 또는 지원되지 않는 C 및 .NET 기능

GPUMode.MultipleDevicesPerTool는 더 이상 지원하지 않습니다. 자세한 정보는 API 최신 변경 사항을 참고 바랍니다.

사용 중단된 API 리스트는 다음을 참고하십시오(사용 중단 또는 삭제된 C 및 .NET 기능).

## 디자이너 기능 변경

4.1 (또는 이전) 버전의 Designer Deep Learning Plugin으로 만들어진 프로젝트는 Cognex Deep Learning Plugin과 호환되지 않습니다. 해당되는 플러그인을 사용하려면 Designer 's Utilities에서 Project Plugin Configurator를 사용하십시오.

Designer에서 학습 할 수 없으며 Cognex Deep Learning Studio 1.0에서 생성 된 Cognex Deep Learning Studio 런타임 워크스페이스 (.vrws 파일)을 가져 와서 이미지를 처리 ​​할 수 ​​있습니다.

런타임 블록에는 하나의 출력 핀만 포함됩니다. 도구 체인의 개별 도구는 UI에 표시되지 않습니다. 또한 사전 구성된 결과 핀이 없으므로 모든 단일 애플리케이션에 대한 스크립트가 필요합니다.

## 이전 릴리스 - ViDi 3.4 - 4.1

## 오버레이 그래픽 보기 방식의 변경

3.4.0 및 4.1.0 릴리스에서 이미지 디스플레이 영역의 오버레이 그래픽을 보이거나 숨기는 단축키가 변경되었습니다. 새로운 단축키는 다음과 같습니다.

- ALT + 오른쪽 화살표 키 또는 ALT + 왼쪽 화살표 키

이 단축키를 이용하면, 현재 있는 디스플레이 그래픽(라벨, 마킹, 라벨 및 마킹, 오버레이 그래픽이 없는 경우)을 순환합니다.

이전 릴리스에서는 스페이스바를 이용해 모든 오버레이 그래픽을 보이거나 감출 수 있었는데, 이제는 이 기능이 지원되지 않습니다.

## 도구 트레이닝 Workflow(워크플로우)의 변경

3.4.0 릴리스에는 도구를 트레이닝하는 데 이용할 이미지/뷰를 지정하는 새로운 방법이 제공됩니다. 이전 버전에서 트레이닝된 도구를 다시 트레이닝하려면, 트레이닝 Set 선택 대화 상자를 통해 새로운 트레이닝 Set 패러다임을 이용하도록 도구를 구성해야 합니다. 트레이닝 Set'와 '트레이닝 Set 선택 대화 상자 이용' 항목을 참고하십시오.

## Feature 필터 syntax 변경

3.4.0 와 4.1.0 릴리스에서, feature 필터 프로세싱 도구 매개변수 syntax가 변경되었습니다. 식에 width 또는 height를 쓰는 경우, view로 한정되어야 합니다(예: view.width, view.height).

예를 들어, 3.2 이전 버전에서는, feature의 중심이 ROI 내에 있는 feature만을 찾도록 하기 위한 syntax가 다음과 같았습니다.

x < width and x > 0 and y > 0 and y < height

3.4.0 이후 버전에서는, 이렇게 써야 합니다.

x < view.width and x > 0 and y > 0 and y < view.height

Note:

in 연산자를 쓰면, 이 syntax를 쉽게 쓸 수 있습니다. 예를 들어, 다음 syntax를 이용하면 식이 간단해집니다.

x in [0,view.width] and y in [0,view.height]

## C 라이브러리 Overlay Function(오버레이 함수) 사용 중단

Deep Learning은 결과 그래픽을 표시하기 위해 C API 및 .NET API의 두 가지 메커니즘을 제공합니다 하지만 다음의 C 라이브러리 오버레이 함수는 이 릴리스에서 사용 중단되고 다음 릴리스에서 제거될 것입니다.

- vidi_training_tool_get_overlay ();
- vidi_runtime_sample_get_overlay ();
- vidi_runtime_get_overlay ();
- vidi_training_sample_get_overlay();

To access the overlay graphics in the future, you will need to use either Cognex Designer, the .NET API or In-Sight Deep Learning.

## 이전 릴리스 - ViDi 3.2 - 3.3

- 2.1 이전 버전에서 생성된 워크스페이스 아카이브 가져오기는 지원되지 않습니다. ViDi Suite 버전 2.1 이상에서 마이그레이션하는 경우 먼저 ViDi 3.3.0으로 가져 오기 전에 버전 3.0, 3.1, 3.2 또는 3.2.1을 사용하여 워크스페이스를 가져온 후 내 보내야합니다.

- ViDi 3.3.0에는 411.31 이상의 NVIDIA 드라이버가 필요합니다.

  업데이트된 NVIDIA 드라이버는 https://www.nvidia.com/download/find.aspx에서 구할 수 있습니다.

  드라이버 호환성에 대한 자세한 내용은 https://support.cognex.com/en/downloads/detail/deep-learning/3763/1033를 참고하십시오.

- 3.3.0의 클라이언트/서버 기능이 HTTP통신 프로토콜을 이용하도록 업데이트되었고, 이제 TCP 프로토콜은 지원하지 않습니다. 클라이언트/서버 응용 프로그램에서 HTTP 프로토콜을 이용하려면, 클라이언트와 서버를 모두 3.3.0으로 업그레이드해야 합니다. 버전 간 클라이언트/서버 호환성은 없습니다(예: 3.2.1을 실행 중인 클라이언트는 3.2.1을 실행 중인 서버만 연결할 수 있고, 3.3.0을 실행 중인 클라이언트는 3.3.0을 실행 중인 서버만 연결할 수 있음).

  Note: HTTP 통신을 이용하면, 일반적으로 런타임 이미지 프로세싱 시 프로세싱 양이 증가합니다. 하지만 긴 대기 시간 네트워크 토폴로지에서는 HTTP 통신이 트레이닝 및 개발 중 인터페이스 대기 시간이 늘어날 수 있습니다.

## 이전 릴리스 - ViDi 3.1 - 3.2

### C 라이브러리 함수 사용 중단

다음과 같은 다수의 C 라이브러리 함수가 사용 중단되었습니다.

- 런타임 함수

  Note: 사용 중단된 함수는 새로운 vidi_runtime_legacy.h 헤더 파일에 있습니다.

  이전 버전 | 새 버전
  --- | ---
  vidi_runtime_get_overlay | 불가
  vidi_runtime_process_sample | vidi_runtime_sample_process
  vidi_runtime_get_image | vidi_runtime_sample_get_image

- 트레이닝 함수

  Note: 사용 중단된 함수는 새로운 vidi_training_legacy.h 헤더 파일에 있습니다.

  이전 버전 | 새 버전
  --- | ---
  vidi_training_stream_process_sample | vidi_training_sample_process
  vidi_training_blue_add_feature | vidi_training_blue_set_feature
  vidi_training_blue_add_model | vidi_training_blue_create_model
  vidi_training_tool_set_mask | vidi_training_roi_set_mask
  vidi_training_tool_get_mask | vidi_training_roi_get_mask
  vidi_training_ini_sample | vidi_training_add_sample
  vidi_training_process_sample | vidi_training_sample_process

### NuGet 패키지 사용 중단

NuGet 패키지가 사용 중단되었으며, ViDi 설치 파일에 포함되지 않습니다. 이전 릴리스에서 NuGet 패키지를 참조하는 런타임 또는 트레이닝 응용 프로그램이 있다면, 이러한 참조를 제거하고 대신 .NET .dll 라이브러리를 참조하게 해야 합니다.

Visual Studio에서 NuGet 패키지를 제거하려면 도구 -> NuGet 패키지 관리자 -> 솔루션용 NuGet 패키지 관리...를 선택하십시오.

.NET .dll을 추가하려면, 프로젝트에서 마우스 우클릭한 후 추가 -> 참조를 선택하십시오.

## 이전 릴리스 - ViDi 3.0 - 3.1

- Blue 위치 도구에서 모델 매칭을 이용할 때 X 및 Y 위치를 고정하는 방식에 변화가 있었습니다. 2.1 버전에서는 이러한 제약이 모델 좌표의 원점 위치에 적용되는 것으로 해석되었습니다. 3.0 버전에서는 모델 내에서 노드의 중심 위치에 대한 제약으로 해석됩니다.