matplotlib.pyplot.contour #

matplotlib.pyplot. contour ( * args , data = None , ** kwargs ) [출처] #

등고선을 플로팅합니다.

호출 서명:

contour([X, Y,] Z, [levels], **kwargs)

contour윤곽선 과 contourf채워진 윤곽선을 각각 그립니다. 명시된 경우를 제외하고 함수 서명과 반환 값은 두 버전에서 동일합니다.

매개변수 :
X, Y 배열 유사, 선택 사항

Z 값의 좌표입니다 .

X 와 Y 는 모두 Z 와 같은 모양을 가진 2D여야 합니다 (예: 를 통해 생성됨 numpy.meshgrid). 또는 둘 다 Z 의 열 수이고 Z 의 행 수인 1D여야 합니다 .len(X) == Nlen(Y) == M

X 와 Y 는 모두 단조롭게 정렬되어야 합니다.

지정하지 않으면 정수 인덱스, 즉 , 로 간주됩니다 .X = range(N)Y = range(M)

Z (M, N) 배열형

윤곽선이 그려지는 높이 값입니다. 색상 매핑은 cmap , norm , vmin 및 vmax 에 의해 제어됩니다 .

레벨 int 또는 배열 유사, 선택 사항

등고선/영역의 수와 위치를 결정합니다.

int n 인 경우 vmin 과 vmax 사이에서 n+1 "좋은" 등고선 수준 MaxNLocator을 자동으로 선택하려고 시도하는 를 사용합니다 .

배열과 같은 경우 지정된 수준에서 등고선을 그립니다. 값은 오름차순이어야 합니다.

반환 :
QuadContourSet
기타 매개변수 :
corner_mask 부울, 기본값: rcParams["contour.corner_mask"](기본값: True)

코너 마스킹을 활성화/비활성화합니다 . Z 가 마스킹된 배열인 경우에만 효과가 있습니다. 인 경우 False마스킹된 점에 닿는 모든 쿼드가 마스킹됩니다. 이면 True해당 점에 가장 가까운 쿼드의 삼각형 모서리만 항상 가려지고 마스크되지 않은 세 점으로 구성된 다른 삼각형 모서리는 평소와 같이 윤곽이 그려집니다.

색상 색상 문자열 또는 색상 시퀀스, 선택 사항

레벨의 색상, 즉 라인 contour및 영역 contourf.

시퀀스는 오름차순으로 레벨별로 순환됩니다. 시퀀스가 레벨 수보다 짧으면 반복됩니다.

바로 가기로, 하나의 요소 목록 대신 단일 색상 문자열을 사용할 수 있습니다. 즉, 모든 레벨을 동일한 색상으로 지정하는 'red'대신에 사용할 수 있습니다. ['red']이 단축키는 색상 문자열에 대해서만 작동하며 색상을 지정하는 다른 방법에는 작동하지 않습니다.

기본적으로(값 None ) cmap 에 의해 지정된 컬러맵 이 사용됩니다.

알파 플로트, 기본값: 1

0(투명)과 1(불투명) 사이의 알파 블렌딩 값입니다.

cmap str 또는 Colormap, 기본값: rcParams["image.cmap"](기본값: 'viridis')

스칼라 데이터를 색상에 매핑하는 데 사용되는 Colormap 인스턴스 또는 등록된 컬러맵 이름입니다.

색상 이 설정된 경우 이 매개변수는 무시됩니다 .

norm str 또는 Normalize, 선택 사항

cmap 을 사용하여 색상에 매핑하기 전에 스칼라 데이터를 [0, 1] 범위로 조정하는 데 사용되는 정규화 방법 입니다. 기본적으로 선형 스케일링이 사용되어 가장 낮은 값을 0으로, 가장 높은 값을 1로 매핑합니다.

주어진 경우 다음 중 하나일 수 있습니다.

  • 서브클래스 의 인스턴스 Normalize또는 그 중 하나입니다( 컬러맵 정규화 참조 ).

  • 척도 이름, 즉 "linear", "log", "symlog", "logit" 등 중 하나. 사용 가능한 척도 목록을 보려면 matplotlib.scale.get_scale_names(). 이 경우 적절한 Normalize하위 클래스가 동적으로 생성되고 인스턴스화됩니다.

색상 이 설정된 경우 이 매개변수는 무시됩니다 .

vmin, vmax float, 옵션

스칼라 데이터를 사용하고 명시적 norm 을 사용하지 않는 경우 vmin 및 vmax 는 컬러 맵이 다루는 데이터 범위를 정의합니다. 기본적으로 컬러맵은 제공된 데이터의 전체 값 범위를 포함합니다. norm 인스턴스가 주어졌을 때 vmin / vmax를 사용하는 것은 오류입니다(단, vmin / vmax 와 함께 norm 이름 을 사용 하는 것은 허용됨).str

vmin 또는 vmax 가 지정되지 않은 경우 기본 색상 스케일링은 레벨 을 기반으로 합니다 .

색상 이 설정된 경우 이 매개변수는 무시됩니다 .

origin { 없음 , '위', '아래', '이미지'}, 기본값: 없음

의 위치를 ​​지정하여 Z 의 방향과 정확한 위치를 결정합니다 . X , Y 가 제공되지 않은 경우에만 해당됩니다 .Z[0, 0]

  • 없음 : 왼쪽 하단 모서리에서 X=0, Y=0에 있습니다.Z[0, 0]

  • 'lower': 왼쪽 하단 모서리에서 X=0.5, Y=0.5에 있습니다.Z[0, 0]

  • 'upper': 왼쪽 상단 모서리에서 X=N+0.5, Y=0.5에 있습니다.Z[0, 0]

  • '이미지': rcParams["image.origin"](기본값: 'upper')의 값을 사용합니다.

범위 (x0, x1, y0, y1), 선택사항

origin 이 None 이 아니면 범위 는 다음 과 같이 해석됩니다 imshow. 외부 픽셀 경계를 제공합니다. 이 경우 Z[0, 0]의 위치는 모서리가 아닌 픽셀의 중심입니다. origin 이 None 이면 ( x0 , y0 ) 은 Z[0, 0]의 위치이고 ( x1 , y1 ) 은 Z[-1, -1]의 위치입니다.

X 와 Y 가 윤곽 호출에 지정된 경우 이 인수는 무시됩니다 .

locator ticker.Locator 하위 클래스, 선택 사항

로케이터는 레벨 을 통해 명시적으로 지정되지 않은 경우 등고선 레벨을 결정하는 데 사용됩니다 . 기본값은 MaxNLocator입니다.

확장 {'둘 다', '둘 다', '최소', '최대'}, 기본값: '둘 다'

레벨 범위 contourf밖에 있는 값 의 색상 지정을 결정합니다 .

'둘 다'이면 수준 범위를 벗어난 값은 색상이 지정되지 않습니다. 'min', 'max' 또는 'both'인 경우 수준 범위 아래, 위 또는 아래 및 위의 값에 색을 지정합니다 .

아래 값 min(levels)과 위 max(levels)값은 의 아래/위 값에 매핑됩니다 Colormap. 대부분의 컬러맵에는 기본적으로 전용 색상이 없으므로 초과 및 미달 값이 컬러맵의 가장자리 값입니다. Colormap.set_under및 를 사용하여 이러한 값을 명시적으로 설정할 수 있습니다 Colormap.set_over.

메모

QuadContourSet컬러맵의 속성이 변경되면 기존 에 알림이 전송되지 않습니다. QuadContourSet.changed()따라서 색상표를 수정한 후에는 명시적 호출 이 필요합니다. QuadContourSet내부적으로 를 호출하기 때문에 컬러바가 에 할당된 경우 명시적 호출을 생략할 수 있습니다 QuadContourSet.changed().

예시:

x = np.arange(1, 10)
y = x.reshape(-1, 1)
h = x * y

cs = plt.contourf(h, levels=[10, 30, 50],
    colors=['#808080', '#A0A0A0', '#C0C0C0'], extend='both')
cs.cmap.set_over('red')
cs.cmap.set_under('blue')
cs.changed()
xunits, yunits 등록 단위, 선택 사항

의 인스턴스를 지정하여 축 단위를 재정의합니다 matplotlib.units.ConversionInterface.

앤티앨리어싱 부울, 선택 사항

앤티앨리어싱을 활성화하여 기본값을 재정의합니다. 채워진 윤곽선의 경우 기본값은 True 입니다. 선 윤곽의 경우 rcParams["lines.antialiased"](기본값: True)에서 가져옵니다.

청크 int >= 0, 선택 사항

0이면 도메인의 세분화가 없습니다. 도메인 을 nchunk 쿼드 로 nchunk 의 하위 도메인으로 나누려면 양의 정수를 지정하십시오 . 청킹은 컨투어링 알고리즘에 의해 생성된 폴리곤의 최대 길이를 줄여 백엔드로 전달되는 렌더링 워크로드를 줄이고 필요한 RAM도 약간 줄입니다. 그러나 백엔드, 앤티앨리어싱 플래그 및 alpha 값 에 따라 청크 경계에서 렌더링 아티팩트를 도입할 수 있습니다 .

linewidths float 또는 array-like, 기본값: rcParams["contour.linewidth"](기본값: None)

에만 적용됩니다 contour .

등고선의 선 너비입니다.

숫자인 경우 모든 레벨이 이 선폭으로 플롯됩니다.

시퀀스인 경우 오름차순 레벨은 지정된 순서대로 선폭으로 플롯됩니다.

rcParams["lines.linewidth"]None이면 (기본값: )으로 돌아갑니다 1.5.

linestyles { None , 'solid', 'dashed', 'dashdot', 'dotted'}, 선택 사항

에만 적용됩니다 contour .

linestyles 가 None 이면 선이 단색이 아닌 한 기본값은 'solid'입니다. 이 경우 음수 윤곽선은 대신 negative_linestyles 인수에서 선 스타일을 가져옵니다.

linestyles 는 사용할 선 스타일 집합을 지정하는 위 문자열의 반복 가능 항목일 수도 있습니다. 이 iterable이 등고선 수준의 수보다 짧으면 필요에 따라 반복됩니다.

negative_linestyles { None , 'solid', 'dashed', 'dashdot', 'dotted'}, 선택 사항

에만 적용됩니다 contour .

linestyles 가 None 이고 선이 단색인 경우 이 인수는 음수 윤곽선의 선 스타일을 지정합니다.

negative_linestyles 가 None 이면 기본값은 에서 가져옵니다 rcParams["contour.negative_linestyles"].

negative_linestyles 는 사용할 선 스타일 집합을 지정하는 위 문자열의 반복 가능 항목일 수도 있습니다. 이 iterable이 등고선 수준의 수보다 짧으면 필요에 따라 반복됩니다.

해치 목록[str], 선택 사항

에만 적용됩니다 contourf .

채워진 영역에 사용할 크로스해칭 패턴 목록입니다. 없음인 경우 윤곽선에 해칭이 추가되지 않습니다. 해칭은 PostScript, PDF, SVG 및 Agg 백엔드에서만 지원됩니다.

알고리즘 {'mpl2005', 'mpl2014', '직렬', '스레드'}, 선택 사항

등고선과 다각형을 계산하는 데 사용할 등고선 알고리즘. 알고리즘은 ContourPy 에서 구현되며 자세한 내용은 ContourPy 설명서 를 참조하십시오 .

기본값은 rcParams["contour.algorithm"](기본값: 'mpl2014')에서 가져옵니다.

데이터 인덱싱 가능 개체, 선택 사항

주어진 경우, 모든 매개변수는 문자열도 허용하며 , 이는 (예외가 발생하지 않는 한 s) 로 해석됩니다 .data[s]

메모

  1. contourf다각형 가장자리를 그리지 않는다는 점에서 MATLAB 버전과 다릅니다. 가장자리를 그리려면 를 호출하여 선 윤곽선을 추가합니다 contour.

  2. contourf상단에서 닫힌 간격을 채웁니다. 즉, z1 및 z2 경계 에 대해 채워진 영역은 다음과 같습니다.

    z1 < Z <= z2

    양쪽이 닫혀 있는 가장 낮은 간격을 제외하고(즉, 가장 낮은 값을 포함함).

  3. contour행진 사각형 알고리즘을 사용하여 등고선 위치를 계산 합니다 contourf. 자세한 내용은 ContourPy 문서 에서 확인할 수 있습니다 .

# 을 사용하는 예matplotlib.pyplot.contour

대화식 기능

대화식 기능

대화식 기능