matplotlib.pyplot.colorbar #
- matplotlib.pyplot. colorbar ( 매핑 가능 = 없음 , cax = 없음 , ax = 없음 , ** kwargs ) [출처] #
플롯에 컬러바를 추가합니다.
- 매개변수 :
- 매핑 가능
이 컬러바가 설명하는
matplotlib.cm.ScalarMappable(ie,AxesImage,ContourSet등). 이 인수는Figure.colorbar메서드에서는 필수이지만pyplot.colorbar기본값을 현재 이미지로 설정하는 함수에서는 선택 사항입니다.ScalarMappable예를 들어 이전에 그린 아티스트에 첨부되지 않은 컬러바를 생성하기 위해 "온더플라이"를 생성 할 수 있습니다.fig.colorbar(cm.ScalarMappable(norm=norm, cmap=cmap), ax=ax)
- cax
Axes, 선택 사항 컬러바가 그려질 축입니다.
- ax
Axes, 축 목록, 선택사항 cax 가 None 인 경우 새 컬러바 축에 대한 공간이 도난당할 하나 이상의 부모 축입니다 . cax 가 설정되어 있으면 아무 효과가 없습니다 .
- use_gridspec 부울, 선택 사항
cax 가 이면
None새 cax 가 Axes의 인스턴스로 생성됩니다. ax 가 Subplot의 인스턴스이고 use_gridspec 이True인 경우 cax 는 모듈 을 사용하여 Subplot의 인스턴스로 생성됩니다gridspec.
- 반환 :
- 컬러바
Colorbar
- 컬러바
- 기타 매개변수 :
- 위치 없음 또는 {'left', 'right', 'top', 'bottom'}
컬러바 축이 생성되는 부모 축에 상대적인 위치입니다. 또한 컬러바의 방향 을 결정합니다(왼쪽 및 오른쪽의 컬러바는 수직, 상단 및 하단의 컬러바는 수평). 없음인 경우 위치 가 설정된 경우 방향 (오른쪽의 수직 컬러바, 하단의 수평 컬러바)에서 오거나, 방향 이 설정되지 않은 경우 기본적으로 '오른쪽'으로 지정됩니다.
- 방향 없음 또는 {'수직', '수평'}
컬러바의 방향입니다. 방향 도 결정하므로 컬러바 의 위치 를 설정하는 것이 좋습니다 . 위치 및 방향 에 대해 호환되지 않는 값을 전달 하면 예외가 발생합니다.
- 분수 float, 기본값: 0.15
컬러바에 사용할 원래 축의 비율입니다.
- 축소 플로트, 기본값: 1.0
컬러바의 크기를 곱할 비율입니다.
- 가로세로 부동, 기본값: 20
긴 치수와 짧은 치수의 비율.
- 패드 부동, 기본값: 수직인 경우 0.05, 수평인 경우 0.15
컬러바와 새 이미지 축 사이의 원래 축 비율입니다.
- 앵커 (플로트, 플로트), 선택 사항
컬러바 축의 앵커 포인트입니다. 수직인 경우 기본값은 (0.0, 0.5)입니다. (0.5, 1.0) 수평인 경우.
- panchor (float, float) 또는 False , 선택 사항
컬러바 부모 축의 앵커 포인트입니다. False 이면 상위 축의 앵커가 변경되지 않습니다. 수직인 경우 기본값은 (1.0, 0.5)입니다. (0.5, 0.0) 수평인 경우.
- 확장 {'모두', '둘 다', '최소', '최대'}
범위를 벗어난 값에 대해 뾰족한 끝을 만듭니다('둘 다'가 아닌 경우). 컬러맵 set_under 및 set_over 메서드를 사용하여 지정된 컬러맵에 대해 설정됩니다.
- extendfrac { 없음 , '자동', 길이, 길이}
None 으로 설정 하면 최소 및 최대 삼각형 컬러바 확장의 길이는 모두 내부 컬러바 길이의 5%입니다(기본 설정).
'자동'으로 설정하면 삼각형 컬러바 확장을 내부 상자와 동일한 길이( 간격 이 '균일'로 설정된 경우) 또는 각각의 인접한 내부 상자와 동일한 길이( 간격 이 '비례'로 설정된 경우)로 만듭니다.
스칼라인 경우 최소 및 최대 삼각형 컬러바 확장의 길이를 내부 컬러바 길이의 일부로 나타냅니다. 최소 및 최대 컬러바 확장의 길이를 각각 내부 컬러바 길이의 일부로 나타내는 분수의 2개 요소 시퀀스도 제공될 수 있습니다.
- extendrect 부울
False 이면 최소 및 최대 컬러바 확장이 삼각형이 됩니다(기본값). True 이면 확장이 직사각형이 됩니다.
- 간격 {'균일', '비례'}
불연속 색상 막대(
BoundaryNorm또는 윤곽선)의 경우 'uniform'은 각 색상에 동일한 공간을 제공합니다. 'proportional'은 공간을 데이터 간격에 비례하게 만듭니다.- 틱 없음 또는 틱 또는 로케이터 목록
None이면 틱이 입력에서 자동으로 결정됩니다.
- 형식 없음 또는 str 또는 포매터
None이면
ScalarFormatter사용됩니다. 형식 문자열(예:"%4.2e"또는"{x:.2e}")이 지원됩니다. 대신 대안Formatter이 주어질 수 있습니다.- 드로어 에지 부울
색상 경계에 선을 그릴지 여부입니다.
- 레이블 문자열
컬러바의 긴 축에 있는 레이블입니다.
- 경계, 값 없음 또는 시퀀스
설정하지 않으면 컬러맵이 0-1 스케일로 표시됩니다. 시퀀스인 경우 값 의 길이는 boundary 보다 1 작아야 합니다 . 경계 의 인접한 항목으로 구분된 각 영역 에 대해 values의 해당 값에 매핑된 색상이 사용됩니다.
norm=NoNorm()일반적으로 인덱스 색상(예: ) 또는 기타 비정상적인 상황 에만 유용합니다 .
메모
mappable 이 a 이면 extend kwarg가 자동으로 포함됩니다
ContourSet.shrink kwarg는 축을 기준으로 컬러바의 크기를 조정하는 간단한 방법을 제공합니다 . cax 가 지정된 경우 컬러바의 크기를 결정하고 수축 및 종횡비 kwargs는 무시됩니다.
보다 정밀한 제어를 위해 mappable 및 colorbar가 그려지는 axes 객체의 위치를 수동으로 지정할 수 있습니다. 이 경우 축 속성 kwargs를 사용하지 마십시오.
일부 벡터 그래픽 뷰어(svg 및 pdf)는 컬러바의 세그먼트 사이에 흰색 간격을 렌더링하는 것으로 알려져 있습니다. 이는 Matplotlib이 아닌 뷰어의 버그 때문입니다. 이 문제를 해결하려면 컬러바를 겹치는 세그먼트로 렌더링할 수 있습니다.
cbar = colorbar() cbar.solids.set_edgecolor("face") draw()
그러나 이는 반투명 이미지(알파 < 1) 및 컬러바 확장과 같은 다른 상황에서 부정적인 결과를 초래합니다. 따라서 이 해결 방법은 기본적으로 사용되지 않습니다(문제 #1188 참조).
