# FindPatMaxRedLine

트레이닝된 패턴을 기반으로 이미지에서 개체를 찾습니다. (찾고자 하는 개체에 대해 트레이닝된 (내부) 기하학적 설명) FindPatMaxRedLine은 Patterns 구조체에서 트레이닝된 패턴을 기반으로 이미지 내에서 패턴을 찾습니다.

## FindPatMaxRedLine 입력

매개 변수 | 설명
이미지 | This parameter must reference a spreadsheet cell that contains an 이미지 data structure; by default, this parameter references A0, the cell containing the data structure. This parameter can also reference other Image data structures, such as those returned by the 이미지 Vision Data Access functions or 좌표 변환 함수.
Fixture | Fixture 입력 또는 비전 도구 함수의 이미지 좌표 시스템 출력을 기준으로 영역 검색을 정의합니다. ROI를 Fixture 기준으로 설정하면 Fixture가 회전하거나 변환된 경우에도 ROI가 Fixture 기준으로 회전하거나 변환됩니다. 기본 설정은 이미지의 왼쪽 상단 모서리인 (0, 0, 0)입니다.
X (기본값 = 0) | 이미지 좌표계에서의 X 오프셋.
Y (기본값 = 0) | 이미지 좌표계에서의 Y 오프셋.
세타 (기본값 = 0) | 이미지 좌표계 내에서 이미지 X축으로부터의 회전(+/-360도 시계 방향).
영역 찾기 | 관심 영역(ROI)이라고도 하며, 이미지 중 분석 대상이 되는 영역을 지정합니다. 영역 매개 변수를 두 번 클릭하면 변환하고 회전할 수 있는 대화형 그래픽 모드를 만듭니다. 이 매개 변수를 선택하고 속성 시트의 작업 편집 도구 모음에서 영역 최대화 버튼을 누르면 영역이 자동으로 확대되어 전체 이미지가 포함됩니다.
X | Fixture 좌표에서 원점으로부터의 x 오프셋.
Y | Fixture 좌표에서 원점으로부터의 y 오프셋.
폭(기본값 = 320) | 영역의 x 축 방향 크기.
높이(기본값 = 440) | 영역의 y 축을 방향 크기.
각도(기본값 = 0) | Fixture 좌표에서의 방향.
곡률(기본값 = 0) | 영역의 x 축과 반대 가장자리선 사이의 각 편차.
외부 영역 | 이 매개 변수는셀 참조로 Annulus, Circle, Region, EditAnnulus, EditCircle, EditCompositeRegion, EditPolygon, EditRegion을 포함하는 스프레드시트 셀을 이용합니다. 이 매개 변수를 사용하면 함수는 영역 및 Fixture 설정을 무시하고 참조된 영역에서 지정한 이미지 영역을 검사합니다. 복합영역편집 컨트롤을 참조하는 경우, 검사 영역에는 다수 도형이 혼합될 수 있습니다. 복합 영역의 각 도형은 검사 영역에 추가되거나 검사 영역에서 뺄(마스킹) 수 있습니다. 참고 : 이 매개 변수가 외부 영역에 대한 참조로 설정된 경우 함수의 내부 영역을 사용하려면 셀 참조 대신 0 값을 입력하여 수동으로 이 매개 변수를 0으로 설정해야 합니다. 그렇지 않으면 함수가 외부 영역을 계속 참조합니다.
패턴 | 이 인수는 TrainPatMaxRedLine 함수에서 반환되는 유효한 Patterns 데이터 구조를 포함하는 스프레드시트 셀을 참조해야 합니다.
찾을 개수 | 반환할 최대 미확인 개체 수를 지정합니다(1 - 1000, 기본값 = 1).
수락 임계치 | 유효한 인스턴스의 가장 낮은 점수인 수락 임계값을 지정합니다. 잠재적으로 일치하는 항목의 점수는 수락 임계값 (0 - 100, 기본값 = 50)보다 커야 합니다. 그렇지 않으면 일치 항목이 반환되지 않습니다.
극성 무시 | 트레이닝된 패턴과 관련하여 색상 반전된 일치 형상이 포함된 일치 항목을 찾을 수 있는지 여부를 지정합니다.
0 = 꺼짐(기본값) | 색상이 반전된 형상은 일치하지 않습니다.
1 = 켜짐 | 반대 극성으로 일치하는 가장자리를 고려합니다.
극성을 무시하면 PatMax가 찾는 패턴이 다양해집니다. 아래 그림은 극성이 일치하거나 일치하지 않는 경우의 몇 가지 예입니다. PatMaxRedLine이 극성을 무시하도록 설정하면, 그림에 나오는 패턴을 모두 찾습니다. 극성을 고려하도록 PatMaxRedLine을 구성하면 아랫줄의 패턴을 찾지 못하거나 찾더라도 윗줄의 패턴보다 낮은 점수가 할당될 수 있습니다.
정확성 모드 | 정확도/신뢰도와 실행 속도 간의 균형을 지정합니다.
0 = 낮음 | 정확도/신뢰도는 낮고 실행 속도는 빠르게 지정합니다.
1 = 높음(기본값) | 정확도/신뢰도는 높고 실행 속도는 느리게 지정합니다.
점수 내 간섭 | 패턴 형상이 누락되거나 가려지면 응답 점수가 줄어들지 여부를 지정합니다.
0 = 꺼짐(기본값) | 간섭의 영향을 점수에 포함하지 않습니다.
1 = 켜짐 | 간섭의 영향을 포함합니다.
대비 임계치 | 유효한 인스턴스의 가장 낮은 대비를 지정합니다. 잠재적 일치에 대한 대비가 대비 임계값보다 커야 합니다(0 - 100, 기본값 = 0). 그렇지 않으면 해당 인스턴스가 고려되지 않습니다. FindPatMaxRedLine 대비는 트레이닝된 패턴의 특징과 검색된 영상의 일치하는 특징을 서로 비교하여 대비 변화를 백분율로 나타내는 "상대적인" 측정 수단입니다. 따라서 특징의 대비가 패턴 대비와 비슷하거나 그보다 큰 경우 보고되는 대비 값은 ~100입니다. 특징의 대비가 패턴 대비보다 작은 경우 보고되는 대비 값은 100 미만입니다. 참고 : FindPatMaxRedLine의 대비는 FindPatMaxRedLine의 대비와 다릅니다. FindPatMaxRedLine 대비는 검색 ROI의 이미지 대비 "절대값"을 회색조 레벨로 나타낸 것입니다.
찾기 허용 오차 | 트레이닝된 패턴과 관련해 회전 또는 비례 변환된 패턴을 찾기 위한 설정을 지정합니다. 참고 : 허용 오차 찾기는 엄격한 한계입니다. 즉, 지정된 허용 오차 찾기를 벗어나는 결과는 스프레드시트에 반환되지 않습니다.
각도 시작 | 일치 항목 검색을 시작할 반시계 방향 각도를 으로 지정합니다(-180 - 180, 기본값 = -15).
각도 종료 | 일치 항목 검색을 중지하는 반시계 방향 각도를 지정합니다(-180 - 180, 기본값 = 15).
배율 시작 | 일치 항목 검색을 시작할 배율을 지정합니다(1 - 10000, 기본값 = 100).
배율 종료 | 일치 항목 검색을 종료할 배율을 지정합니다(1 - 10000, 기본값 = 100).
XY 겹침 | 대략 동일한 X, Y 위치에 있는 복수의 겹치는 패턴 사이의 예상 위치 차이, 트레이닝된 패턴 크기의 백분율로 지정합니다(0 - 100, 기본값 = 70). 참고 : 이 값을 늘리면 동일한 패턴의 겹치는 일치 항목을 여러 개 찾을 수 있습니다.
고급 설정 |
대략적 백분율 사용 | 대략적 검색 단계에서 대략적 수락 백분율 값을 사용할지 여부를 지정합니다. 참고 : 대부분의 경우 이 설정을 활성화할 필요는 없습니다.
0 = 꺼짐(기본값) | 대략적 검색 단계에서는 수락 임계값만 사용됩니다( 대략적 수락 백분율 값은 무시됨).
1 = 켜짐 | 대략적 수락 백분율 매개 변수를 활성화하면 대략적 검색 단계에서 사용되는 수락 임계값으로부터의 편차를 백분율로 지정할 수 있습니다.
대략적 수락 백분율 | 대략적 검색 단계에서 사용되는 수락 임계값과의 편차를 백분율로 지정합니다(0 - 100, 기본값 = 60). 이 매개 변수는 수락 임계값으로 인스턴스의 범위를 효과적으로 좁힐 수 없고 함수가 반환하는 불일치 또는 일치 항목이 너무 많은 경우에 유용합니다. 대략적 수락 백분율 작동 방식 FindPatMaxRedLine은 먼저 큰 형상을 사용하여 런타임 이미지에서 근사적 패턴 일치를 찾고(대략적 검색 단계), 작은 형상을 사용하여 패턴 위치를 정확하게 결정합니다(정밀 검색 단계). 두 단계 모두 수락 임계값을 사용하여 발견된 인스턴스의 범위를 좁힙니다. 일반적 흐름(대략적 백분율 사용 = 꺼짐) 드문 경우이지만 대략적 검색 단계에서는 점수가 낮은 인스턴스만 발견되므로 FindPatMaxRedLine이 일치하는 항목을 반환하지 않을 수 있습니다. 이렇게 되면 임계값 수락 설정을 낮춰도 됩니다. 그러나 수락 임계값이 낮아지면 일치하는 항목이 과도하게 반환될 수 있습니다. 불일치 또는 과도한 일치 항목 반환 (대략적 백분율 사용 = 꺼짐) 이러한 경우 대략적 수락 백분율을 설정하면 대략적 검색 단계에 대한 수락 임계값을 정의할 수 있습니다. 이제 검색 단계마다 다른 수락 임계값을 사용함으로써 예상 결과를 반환할 수 있습니다. 예상 결과 반환(대략적 백분율 사용 = 켜짐)
타임아웃 | 실행을 중지하고 #ERR을 반환하기 전에 함수가 패턴을 검색할 시간을 밀리초 단위로 지정합니다( 0 - 30000, 기본값 = 5000). 값을 0으로 지정할 경우 설정이 비활성화되고 타임아웃이 적용되지 않습니다.
표시 | 이미지에서 그래픽 오버레이를 표시하는 모드를 지정합니다.
0 = 모두 숨기기(기본값) | FindPatMaxRedLine 함수를 포함하는 셀이 스프레드시트의 활성 셀인 경우를 제외하고 모든 그래픽이 표시되지 않습니다.
1 = 결과 그래픽만 | 발견된 각 패턴에 대해 항상 십자가 표시됩니다.
2 = 입력 및 결과 그래픽 | 입력 이미지 영역과 발견된 각 패턴에 대한 십자가 항상 표시됩니다.
3 = 모두 표시: 입력, 결과, 일치 형상 | 입력 이미지 영역, 발견된 각 패턴에 대한 십자, PatMax RedLine 일치 형상이 항상 표시됩니다.

## FindPatMaxRedLine 출력

반환 | 모델 및 점수별로 정렬된 패턴 응답 목록을 포함하는 Patterns 데이터 구조. 입력 매개 변수 중 하나라도 유효하지 않은 경우 #ERR. 참고 : FindPatMaxRedLine은 트레이닝된 패턴을 찾을 수 없는 경우 #ERR을 반환하지 않습니다. 이 경우 일치하는 패턴을 찾지 못하면 0을 반환하는 Patterns Vision Data Access functions GetNFound(Patterns)을 사용합니다.
결과 | FindPatMaxRedLine이 처음으로 셀에 삽입되면 다음 Patterns Vision Data Access functions를 사용하여 스프레드시트에 결과표가 만들어집니다.
레이블 | 함수 | 설명
X | GetX(패턴, 인덱스) | 패턴 위치의 x 좌표.
Y | GetY(패턴, 인덱스) | 패턴 위치의 y 좌표.
각도 | GetAngle(패턴, 인덱스) | 패턴 위치의 방향.
크기 | GetScale(패턴, 인덱스) | 발견된 패턴을 트레이닝된 모델과 비교한 크기(단위: 백분율).
점수 | GetScore(패턴, 인덱스) | 패턴 응답 점수.