matplotlib.pyplot.contourf #
- matplotlib.pyplot. contourf ( * 인수 , 데이터 = 없음 , ** kwargs ) [출처] #
채워진 등고선을 플로팅합니다.
호출 서명:
contourf([X, Y,] Z, [levels], **kwargs)
contour윤곽선 과contourf채워진 윤곽선을 각각 그립니다. 명시된 경우를 제외하고 함수 서명과 반환 값은 두 버전에서 동일합니다.- 매개변수 :
- X, Y 배열 유사, 선택 사항
Z 값의 좌표입니다 .
X 와 Y 는 모두 Z 와 같은 모양을 가진 2D여야 합니다 (예: 를 통해 생성됨
numpy.meshgrid). 또는 둘 다 Z 의 열 수이고 Z 의 행 수인 1D여야 합니다 .len(X) == Nlen(Y) == MX 와 Y 는 모두 단조롭게 정렬되어야 합니다.
지정하지 않으면 정수 인덱스, 즉 , 로 간주됩니다 .
X = range(N)Y = range(M)- Z (M, N) 배열형
윤곽선이 그려지는 높이 값입니다. 색상 매핑은 cmap , norm , vmin 및 vmax 에 의해 제어됩니다 .
- 레벨 int 또는 배열 유사, 선택 사항
등고선/영역의 수와 위치를 결정합니다.
int n 인 경우 vmin 과 vmax 사이에서 n+1 "좋은" 등고선 수준
MaxNLocator을 자동으로 선택하려고 시도하는 를 사용합니다 .배열과 같은 경우 지정된 수준에서 등고선을 그립니다. 값은 오름차순이어야 합니다.
- 반환 :
- 기타 매개변수 :
- 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로 매핑합니다.
주어진 경우 다음 중 하나일 수 있습니다.
척도 이름, 즉 "linear", "log", "symlog", "logit" 등 중 하나. 사용 가능한 척도 목록을 보려면
matplotlib.scale.get_scale_names(). 이 경우 적절한Normalize하위 클래스가 동적으로 생성되고 인스턴스화됩니다.
색상 이 설정된 경우 이 매개변수는 무시됩니다 .
- vmin, vmax float, 옵션
스칼라 데이터를 사용하고 명시적 norm 을 사용하지 않는 경우 vmin 및 vmax 는 컬러 맵이 다루는 데이터 범위를 정의합니다. 기본적으로 컬러맵은 제공된 데이터의 전체 값 범위를 포함합니다. norm 인스턴스가 주어졌을 때 vmin / vmax를 사용하는 것은 오류입니다(단, vmin / vmax 와 함께 norm 이름 을 사용 하는 것은 허용됨).
strvmin 또는 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]
- corner_mask 부울, 기본값:
메모