`matplotlib.colorbar`#

컬러바는 스칼라 값에서 색상으로의 매핑을 시각화한 것입니다. Matplotlib에서는 전용 Axes.

메모

컬러바는 일반적으로 내부적으로 (포지셔닝된 축의 경우) 또는 ( 포지셔닝되지 않은 축의 경우) 와 함께 사용되는 pyplot Figure.colorbar래퍼 를 통해 생성됩니다 .pyplot.colorbarColorbarmake_axes_gridspecGridSpecmake_axesGridSpec

최종 사용자는 이 모듈의 API를 직접 사용할 필요가 없을 것입니다.

클래스 matplotlib.colorbar. Colorbar ( ax , mappable=None , * , cmap=None , norm=None , alpha=None , values=None , boundary=None , orientation='vertical' , ticklocation='auto' , extend=None , 간격='uniform ' , ticks=None , format=None , drawedges=False , filled=<사용되지 않는 매개변수> , extendfrac=None , extendrect=False , label='') [출처] #

베이스:object

기존 좌표축에 컬러바를 그립니다.

일반적으로 컬러바는 Figure.colorbar또는 를 사용하여 생성되고 s pyplot.colorbar와 연결됩니다 ScalarMappable(예: 를 AxesImage통해 생성됨 imshow).

그림의 다른 요소와 연결되지 않은 컬러바를 그리려면(예: 컬러맵을 단독으로 표시할 때) 비어 있는 를 만들 거나 에 매핑 가능한 대신 cmap 및 normScalarMappable 을 직접 전달할 수 있습니다.Colorbar

유용한 공개 방법은 set_label()및 add_lines()입니다.

매개변수 :

도끼Axes

Axes색상 막대가 그려지는 인스턴스입니다 .

매핑 가능ScalarMappable

컬러맵과 노름이 사용될 매핑 가능 항목입니다.

과소 및 과대 값 색상을 표시하려면 매핑 가능한 표준을 다음과 같이 지정해야 합니다.

norm = colors.Normalize(clip=False)

0-1 스케일 대신 색상 대 색인을 표시하려면 다음을 사용하십시오.

norm=colors.NoNorm()

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

사용할 컬러맵입니다. mappable 이 None이 아니면 이 매개변수는 무시 됩니다.

표준Normalize

사용할 정규화입니다. mappable 이 None이 아니면 이 매개변수는 무시 됩니다.

알파 플로트

0(투명)과 1(불투명) 사이의 컬러바 투명도입니다.

오리엔테이션 {'수직', '수평'}

ticklocation {'자동', '왼쪽', '오른쪽', '상단', '하단'}

드로어 에지 부울

채워진 부울

확장 {'모두', '둘 다', '최소', '최대'}

범위를 벗어난 값에 대해 뾰족한 끝을 만듭니다('둘 다'가 아닌 경우). 컬러맵 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()일반적으로 인덱스 색상(예: ) 또는 기타 비정상적인 상황 에만 유용합니다 .

속성 :

도끼Axes: Axes색상 막대가 그려지는 인스턴스입니다 .
라인 목록: 목록 LineCollection(선이 그려지지 않은 경우 비어 있음).
분할기LineCollection: LineCollection( drawedges 가 인 경우 비어 있음 False).

add_lines ( * 인수 , ** kwargs ) [소스] #

컬러바에 선을 그립니다.

줄이 목록에 추가됩니다 lines.

매개변수 :

배열과 같은 레벨: 라인의 위치.
색상 색상 또는 색상 목록: 모든 라인에 단일 색상을 적용하거나 각 라인에 대해 하나의 색상 값을 적용합니다.
선폭 은 플로트 또는 배열과 유사합니다.: 모든 줄에 적용되는 단일 선폭 또는 각 선에 대해 하나의 선폭입니다.
부울 지우기 , 기본값: True: 이전에 추가한 줄을 제거할지 여부입니다.

메모

또는 이 메서드를 서명과 함께 호출할 수도 있습니다 . 이 경우 레벨 , 색상 및 선폭 은 contour_set 에서 가져옵니다 .colorbar.add_lines(contour_set, erase=True)

drag_pan ( 버튼 , 키 , x , y ) [소스] #

draw_all ( ) [출처] #

[ Deprecated ] 현재 cmap 및 norm을 기반으로 자유 매개변수를 계산하고 모든 도면을 수행합니다.

메모

버전 3.6부터 폐지됨: fig.draw_without_rendering()을 대신 사용하십시오.

속성 이 채워짐 [소스] #

속성 포맷터 #: 컬러바의 주요 눈금 레이블 Formatter입니다.

get_ticks ( 마이너 = 거짓 ) [소스] #

틱을 위치 목록으로 반환합니다.

매개변수 :

마이너 부울, 기본값: False: True이면 마이너 틱을 반환합니다.

속성 로케이터 #: 컬러바의 주요 눈금 Locator입니다.

속성 마이너 포맷터 #: 컬러바에 대한 작은 눈금 Formatter입니다.

속성 마이너로케이터 #: 컬러바에 대한 작은 눈금 Locator입니다.

minorticks_off ( ) [출처] #: 컬러바의 작은 눈금을 끕니다.

minorticks_on ( ) [출처] #: 컬러바 마이너 틱을 켭니다.

n_rasterize = 50 #

속성 패치 [출처] #

제거 ( ) [출처] #

Figure에서 이 컬러바를 제거합니다.

컬러바가 이전 그리드 사양 으로 생성된 경우 use_gridspec=True복원됩니다.

set_alpha ( 알파 ) [소스] #

0(투명)과 1(불투명) 사이의 투명도를 설정합니다.

배열이 제공되면 알파 는 없음으로 설정되어 컬러맵과 관련된 투명도 값을 사용합니다.

set_label ( 라벨 , * , loc = 없음 , ** kwargs ) [출처] #

색상 막대의 긴 축에 레이블을 추가합니다.

매개변수 :

레이블 문자열

레이블 텍스트입니다.

loc str, 선택 사항

레이블의 위치입니다.

가로 방향의 경우 {'left', 'center', 'right'} 중 하나
세로 방향의 경우 {'bottom', 'center', 'top'} 중 하나

방향에 따라 기본값은 rcParams["xaxis.labellocation"](기본값: 'center') 또는 rcParams["yaxis.labellocation"](기본값: )입니다.'center'

**kwargs

키워드 인수는 set_xlabel/ 에 전달됩니다 set_ylabel. 지원되는 키워드는 labelpad 및 Text속성입니다.

set_ticklabels ( ticklabels , update_ticks=<deprecated parameter> , * , minor=False , **kwargs ) [소스] #

[ 권장되지 않음 ] 눈금 레이블을 설정합니다.

낙담

눈금 위치에 대한 종속성 때문에 이 방법을 사용하지 않는 것이 좋습니다. 대부분의 경우 대신 사용하고 싶을 것입니다.set_ticks(positions, labels=labels)

이 방법을 사용하는 경우, 예를 들어 컬러바의 긴 축에서 Colorbar.set_ticksa를 사용하거나 명시적으로 설정 하여 이전에 눈금 위치를 항상 고정해야 합니다. FixedLocator그렇지 않으면 진드기가 자유롭게 움직이고 레이블이 예기치 않은 위치에 놓일 수 있습니다.

매개변수 :

str 또는 of의 ticklabels 시퀀스Text

에 의해 설정된 시퀀스의 각 눈금 위치에 레이블을 지정하기 위한 텍스트 Colorbar.set_ticks; 레이블 수는 위치 수와 일치해야 합니다.

update_ticks 부울, 기본값: True

이 키워드 인수는 무시되며 제거됩니다. 더 이상 사용되지 않음

마이너 부울: True인 경우 메이저 틱 대신 마이너 틱을 설정합니다.

**kwargs

Text레이블에 대한 속성입니다.

set_ticks ( ticks , update_ticks=<deprecated parameter> , labels=None , * , minor=False , **kwargs ) [소스] #

틱 위치를 설정합니다.

매개변수 :

플로트의 진드기 목록: 진드기 위치 목록.
str의 레이블 목록, 선택 사항: 눈금 레이블 목록입니다. 설정하지 않으면 레이블에 데이터 값이 표시됩니다.
마이너 부울, 기본값: False: 이면 False주요 틱을 설정합니다. if True, 마이너 틱.
**kwargs: Text레이블에 대한 속성입니다. 레이블 을 전달하는 경우에만 적용됩니다 . 그 외의 경우에는 를 이용해 주십시오 tick_params.

update_normal ( 매핑 가능 ) [소스] #

실선 패치, 선 등을 업데이트합니다.

이 색상 막대가 속한 이미지 또는 등고선 플롯의 표준이 변경될 때 호출됩니다.

매핑 가능 항목의 기준이 이전과 다른 경우 축에 대한 로케이터 및 포맷터가 재설정되므로 사용자 정의된 경우 다시 사용자 정의해야 합니다. 그러나 규범이 vmin , vmax 또는 cmap 의 값만 변경 하는 경우 이전 포맷터 및 로케이터가 보존됩니다.

update_ticks ( ) [출처] #: 눈금 및 눈금 레이블을 설정합니다. 이것은 사용자에게 필요하지 않습니다.

matplotlib.colorbar. ColorbarBase [출처] #: 별칭Colorbar

matplotlib.colorbar. make_axes ( 부모 , 위치 = 없음 , 방향 = 없음 , 분수 = 0.15 , 축소 = 1.0 , 측면 = 20 , ** kwargs ) [출처] #

Axes컬러바에 적합한 것을 만듭니다 .

축은 부모 축의 크기를 조정하고 재배치 하여 부모 축의 그림에 배치됩니다 .

매개변수 :

부모 Axes또는 목록Axes: 컬러바를 배치하기 위해 부모로 사용할 축입니다.
위치 없음 또는 {'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) 수평인 경우.

반환 :

택시Axes: 하위 축입니다.
kwargs 딕셔너리: colorbar 인스턴스를 생성할 때 전달할 축소된 키워드 사전입니다.

matplotlib.colorbar. make_axes_gridspec ( 부모 , * , 위치 = 없음 , 방향 = 없음 , 분수 = 0.15 , 축소 = 1.0 , 종횡비 = 20 , ** kwargs ) [출처] #

SubplotBase컬러바에 적합한 것을 만듭니다 .

축은 부모 축의 크기를 조정하고 위치를 변경 하여 부모 축의 그림에 배치됩니다 .

이 기능은 와 유사합니다 make_axes. 주요 차이점은

make_axes_gridspecSubplotBase반드시 부모 와 함께 사용해야 합니다 .
make_axes를 생성합니다 Axes. make_axes_gridspec를 생성합니다 SubplotBase.
make_axes부모의 위치를 업데이트합니다. 부모 make_axes_gridspec 의 속성을 새 속성으로 바꿉니다 .grid_spec

이 기능은 과(와) 호환되도록 되어 make_axes있지만 약간의 차이가 있을 수 있습니다.

매개변수 :

부모의Axes: 컬러바를 배치하기 위해 부모로 사용할 축입니다.
위치 없음 또는 {'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) 수평인 경우.

반환 :

택시SubplotBase: 하위 축입니다.
kwargs 딕셔너리: colorbar 인스턴스를 생성할 때 전달할 축소된 키워드 사전입니다.

matplotlib.colorbar#

`matplotlib.colorbar`#