simplify

polyshape 경계 단순화하기

구문

polyout = simplify(polyin)

polyout = simplify(polyin,'KeepCollinearPoints',TF)

설명

polyout = simplify(polyin)은 중복된 꼭짓점이 모두 제거되고 경계 교차와 올바르지 않은 중첩이 모두 해결된 상태의 다각형 polyin의 경계로 구성된 polyshape 객체를 반환합니다.

polyout = simplify(polyin,'KeepCollinearPoints',TF)는 polyout에서 동일직선상의 점을 유지할지 또는 제거할지 여부를 지정합니다.

예제

교차 경계

경계 교차를 포함하는 다각형을 생성하고 플로팅합니다.

P = [0 0; 1 1; 1 0; 0.5 0.5; 0 1; 0 0];
polyin = polyshape(P,'Simplify',false)

polyin = 
  polyshape with properties:

      Vertices: [5×2 double]
    NumRegions: 1
      NumHoles: 0

plot(polyin)

simplify 함수를 사용해서 교차를 제거하여 잘 정의된 다각형을 만듭니다. 다각형을 단순화하면 경계 형태는 유지되지만 다각형이 2개의 개별 영역으로 분할됩니다.

polyout = simplify(polyin)

polyout = 
  polyshape with properties:

      Vertices: [7×2 double]
    NumRegions: 2
      NumHoles: 0

입력 인수

polyin — 입력 polyshape

스칼라 | 벡터 | 행렬 | 다차원 배열

입력 polyshape로, 스칼라, 벡터, 행렬 또는 다차원 배열로 지정됩니다.

데이터형: polyshape

TF — 동일직선상의 꼭짓점 표시자

false | true

동일직선상의 꼭짓점 표시자로, 다음과 같이 false 또는 true로 지정됩니다.

• false — 출력 polyshape가 경계를 정의하는 데 필요한 가장 적은 수의 꼭짓점을 갖도록 동일직선상의 점을 제거합니다.

• true — 모든 동일직선상의 점을 꼭짓점으로 유지합니다.

'KeepCollinearPoints' 파라미터가 지정되지 않은 경우 해당 값은 입력 polyshape를 만들 때 사용된 값으로 자동 설정됩니다.

데이터형: logical

확장 기능

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 코드 생성 시 동적 메모리 할당이 활성화되어 있어야 합니다.

• 이름-값 쌍은 컴파일타임 상수여야 합니다.

스레드 기반 환경
MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

버전 내역

R2017b에 개발됨

R2024b: 많은 경계를 갖는 polyshape 객체를 단순화할 때의 성능이 향상됨

simplify 함수가 많은 경계를 갖는 polyshape 객체에 대한 연산을 수행할 때의 성능이 향상되었습니다. 예를 들어, 다음 코드는 꼭짓점이 11,100개 있는 polyshape 객체를 간소화합니다. 이 코드는 이전 릴리스보다 약 23배 빠릅니다.

function t = timingTest
n = 300;
x = (1:n)'*[sind(0:10:360),NaN];
y = (1:n)'*[cosd(0:10:360),NaN];
p = polyshape(x(:),y(:),Simplify=false);

f = @() simplify(p);

t = timeit(f);
end

대략적인 실행 시간은 다음과 같습니다.

R2024a: 0.28초

R2024b: 0.012초

코드 실행 시간은 Windows^® 11, AMD EPYC™ 74F3 24-Core Processor @ 3.19GHz 테스트 시스템에서 timingTest 함수를 호출하여 측정했습니다.

참고 항목

issimplified | polyshape