matplotlib.pyplot.pcolormesh #

matplotlib.pyplot. pcolormesh ( * args , alpha = None , norm = None , cmap = None , vmin = None , vmax = None , shading = None , antialiased = False , data = None , ** kwargs ) [출처] #

비정규 직사각형 그리드를 사용하여 의사색상 플롯을 생성합니다.

호출 서명:

pcolormesh([X, Y,] C, **kwargs)

X 와 Y 는 사변형의 모서리를 지정하는 데 사용할 수 있습니다.

힌트

pcolormesh와 유사합니다 pcolor. 대부분의 경우 훨씬 빠르고 선호됩니다. 차이점 에 대한 자세한 내용 은 pcolor()와 pcolormesh() 의 차이점을 참조하십시오 .

매개변수 :

C 2D 배열과 유사

색상 매핑된 값입니다. 색상 매핑은 cmap , norm , vmin 및 vmax 에 의해 제어됩니다 .

X, Y 배열 유사, 선택 사항

pcolormesh의 사변형 모서리 좌표:

(X[i+1, j], Y[i+1, j])       (X[i+1, j+1], Y[i+1, j+1])
                      +-----+
                      |     |
                      +-----+
    (X[i, j], Y[i, j])       (X[i, j+1], Y[i, j+1])

열 인덱스는 x 좌표에 해당하고 행 인덱스는 y에 해당합니다. 자세한 내용은 아래 참고 섹션을 참조하십시오.

X 와 Yshading='flat' 의 치수가 C 의 치수 보다 하나 커야 하고 사변형 은 의 값으로 인해 색상이 지정됩니다 . X , Y 및 C 의 크기 가 같으면 경고가 발생하고 C 의 마지막 행과 열 이 무시됩니다.C[i, j]

shading='nearest'또는 인 경우 X 및 Y'gouraud' 의 차원은 C 의 차원과 같아야 합니다 (그렇지 않으면 ValueError가 발생합니다). 색상 이 중앙에 있기 때문 입니다 . 의 경우 사변형 모서리 사이에 부드러운 보간이 수행됩니다.'nearest'C[i, j](X[i, j], Y[i, j])'gouraud'

X 및/또는 Y 가 1D 배열 또는 열 벡터인 경우 필요에 따라 적절한 2D 배열로 확장되어 직사각형 그리드를 만듭니다.

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

edgecolors {'없음', 없음, '면', 색상, 색상 순서}, 선택 사항

가장자리의 색상입니다. 기본값은 '없음'입니다. 가능한 값:

'없음' 또는 '': 가장자리가 없습니다.
없음 : rcParams["patch.edgecolor"](기본값: 'black')이 사용됩니다. 이것이 작동하려면 현재 rcParams["patch.force_edgecolor"](기본값: False)가 True여야 합니다.
'face': 인접한 면 색상을 사용합니다.
색상 또는 일련의 색상이 가장자리 색상을 설정합니다.

단수형 edgecolor 는 별칭으로 작동합니다.

알파 플로트, 기본값: 없음

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

음영 {'flat', 'nearest', 'gouraud', 'auto'}, 선택 사항

사변형의 채우기 스타일입니다. 기본값은 '플랫' 또는 rcParams["pcolor.shading"](기본값: 'auto')입니다. 가능한 값:

'flat': 각 쿼드에 단색이 사용됩니다. 쿼드 (i, j), (i+1, j), (i, j+1), (i+1, j+1)의 색상은 로 지정됩니다 . X 와 Y 의 차원은 C 의 차원 보다 1 커야 합니다 . C 와 같으면 사용 중단 경고가 발생하고 C 의 마지막 행과 열 이 삭제됩니다.C[i, j]
'nearest': 각 그리드 포인트는 인접한 그리드 중심 사이의 중간까지 확장되는 중앙에 색상을 갖습니다. X 와 Y 의 차원은 C 와 같아야 합니다 .
'gouraud': 각 쿼드는 Gouraud 음영 처리됩니다. 모서리(i', j')의 색상은 . 사이 영역의 색상 값은 모서리 값에서 보간됩니다. X 와 Y 의 차원은 C 와 같아야 합니다 . Gouraud 음영이 사용되면 edgecolors 가 무시됩니다.C[i', j']
'auto': X 와 Y 의 차원이 C 보다 하나 더 크면 'flat' 을 선택하십시오 . 치수가 동일한 경우 '가장 가까운'을 선택합니다.

자세한 설명은 pcolormesh 그리드 및 음영 을 참조하십시오.

스냅 부울, 기본값: False

메시를 픽셀 경계에 스냅할지 여부입니다.

래스터화 된 부울, 선택 사항

벡터 그래픽을 그릴 때 pcolormesh를 래스터화합니다. 이렇게 하면 렌더링 속도가 빨라지고 대용량 데이터 세트에 대해 더 작은 파일을 생성할 수 있습니다. 벡터 그래픽의 래스터화를 참조하십시오 .

반환 :

matplotlib.collections.QuadMesh

기타 매개변수 :

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

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

**kwargs

또한 다음 인수가 허용됩니다. 그것들은 QuadMesh생성자에게 전달됩니다:

재산	설명
`agg_filter`	(m, n, 3) 부동 소수점 배열과 dpi 값을 사용하고 (m, n, 3) 배열과 이미지의 왼쪽 하단에서 두 오프셋을 반환하는 필터 함수
`alpha`	배열형 또는 스칼라 또는 없음
`animated`	부울
`antialiased`또는 aa 또는 앤티앨리어싱	부울 또는 부울 목록
`array`	(M, N) 배열형 또는 M*N 배열형
`capstyle`	`CapStyle`또는 {'butt', 'projecting', 'round'}
`clim`	(vmin: 플로트, vmax: 플로트)
`clip_box`	`Bbox`
`clip_on`	부울
`clip_path`	패치 또는 (경로, 변환) 또는 없음
`cmap`	`Colormap`또는 str 또는 없음
`color`	rgba 튜플의 색상 또는 목록
`edgecolor`또는 ec 또는 edgecolors	색상 또는 색상 목록 또는 '얼굴'
`facecolor`또는 facecolors 또는 fc	색상 또는 색상 목록
`figure`	`Figure`
`gid`	str
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`in_layout`	부울
`joinstyle`	`JoinStyle`또는 {'마이터', '라운드', '베벨'}
`label`	물체
`linestyle`또는 대시 또는 선 스타일 또는 ls	str 또는 튜플 또는 그 목록
`linewidth`또는 선폭 또는 lw	플로트 또는 플로트 목록
`mouseover`	부울
`norm`	`Normalize`또는 str 또는 없음
`offset_transform`또는 트랜스오프셋	알려지지 않은
`offsets`	(N, 2) 또는 (2,) 배열형
`path_effects`	`AbstractPathEffect`
`picker`	None 또는 bool 또는 float 또는 호출 가능
`pickradius`	알려지지 않은
`rasterized`	부울
`sketch_params`	(스케일: float, 길이: float, 임의성: float)
`snap`	부울 또는 없음
`transform`	`Transform`
`url`	str
`urls`	str 또는 None 목록
`visible`	부울
`zorder`	뜨다

또한보십시오

pcolor: 기능이 약간 다른 대체 구현입니다. 차이점 에 대한 자세한 내용 은 pcolor()와 pcolormesh() 의 차이점을 참조하십시오 .
imshow: X 와 Y 가 각각 등거리인 경우 imshow더 빠른 대안이 될 수 있습니다.

메모

마스킹된 배열

C 는 마스킹된 배열일 수 있습니다. 가 가려 지면 해당 사변형이 투명해집니다. X 와 Y 의 마스킹은 지원되지 않습니다. 이 기능이 필요한 경우 사용하십시오 .C[i, j]pcolor

그리드 방향

그리드 방향은 표준 행렬 규칙을 따릅니다. 모양이 (nrows, ncolumns) 인 배열 C 는 열 번호를 X 로, 행 번호를 Y 로 하여 플로팅됩니다 .

pcolor()와 pcolormesh()의 차이점

두 방법 모두 사변형을 사용하여 2D 배열의 의사색상 플롯을 만드는 데 사용됩니다.

주요 차이점은 생성된 개체와 내부 데이터 처리에 있습니다. a를 반환하는 동안 pcolora PolyCollection를 pcolormesh 반환합니다 QuadMesh. 후자는 주어진 목적에 더 특화되어 더 빠릅니다. 거의 항상 선호되어야 합니다.

마스킹된 배열을 처리하는 데에도 약간의 차이가 있습니다. 둘 다 C 에 대해 마스킹된 배열을 지원 pcolor합니다 . 그러나 X 및 Y 에 대해 마스킹된 배열 만 지원합니다 . 그 이유는 마스킹된 값의 내부 처리에 있습니다. PolyCollection에서 각 다각형을 제외합니다. 마스킹된 요소의 면색을 투명으로 설정합니다. edgecolors를 사용할 때 차이를 볼 수 있습니다. 모든 가장자리는 QuadMesh에서 마스킹에 관계없이 그려지지만 PolyCollection에 해당 다각형이 존재하지 않기 때문에 인접한 두 개의 마스킹된 사변형 사이의 가장자리는 그려지지 않습니다.pcolormeshpcolorpcolorpcolormeshpcolor

pcolormesh또 다른 차이점은 에서 사용할 수 없는 Gouraud 음영 지원입니다 pcolor.