matplotlib.cm#

내장 컬러맵, 컬러맵 처리 유틸리티 및 ScalarMappable믹스인.

또한보십시오

내장 색상표 목록에 대한 색상표 참조 입니다.

색상표 를 만드는 방법에 대한 예는 Matplotlib에서 색상표 만들기 .

Matplotlib에서 컬러맵 선택하기에서 컬러맵 선택에 대해 자세히 설명합니다.

데이터 정규화에 대한 자세한 내용은 컬러맵 정규화 를 참조하십시오.

클래스 matplotlib.cm. ColormapRegistry ( cmaps ) [소스] #

베이스:Mapping

이름으로 Matplotlib에 알려진 컬러맵의 컨테이너입니다.

실험적

API가 최종 버전이 될 것으로 예상하지만 필요에 따라 API를 3.6에 계속 적용할 수 있는 옵션을 유지하기를 원하기 때문에 공식적으로 3.5에 대해 실험적이라고 표시합니다.

범용 레지스트리 인스턴스는 matplotlib.colormaps. 사용자가 자신을 인스턴스화할 필요가 없어야 합니다 ColormapRegistry.

Colormap읽기 액세스는 이름을 s 에 매핑하는 딕셔너리와 같은 인터페이스를 사용합니다 .

import matplotlib as mpl
cmap = mpl.colormaps['viridis']

반환 Colormap된 s는 복사본이므로 수정해도 컬러맵의 전역 정의가 변경되지 않습니다.

추가 색상표는 다음을 통해 추가할 수 있습니다 ColormapRegistry.register.

mpl.colormaps.register(my_colormap)
레지스터 ( cmap , * , 이름 = 없음 , 강제 = False ) [소스] #

새 컬러맵을 등록합니다.

cmap 그런 다음 색상표 이름 을 Matplotlib의 모든 매개변수에 대한 문자열 인수로 사용할 수 있습니다 . 에서도 사용할 수 있습니다 pyplot.get_cmap.

컬러맵 레지스트리는 지정된 컬러맵의 복사본을 저장하므로 원본 컬러맵 인스턴스에 대한 향후 변경 사항이 등록된 컬러맵에 영향을 미치지 않습니다. 이것을 등록 시 컬러맵의 스냅샷을 찍는 레지스트리로 생각하십시오.

매개변수 :
cmap matplotlib.colors.Colormap

등록할 컬러맵입니다.

이름 문자열, 선택 사항

컬러맵의 이름입니다. 지정하지 않으면 cmap.name사용됩니다.

강제 bool, 기본값: False

False인 경우 이미 등록된 이름을 덮어쓰려고 하면 ValueError가 발생합니다. True는 내장 색상표가 아닌 등록된 색상표 덮어쓰기를 지원합니다.

등록 취소 ( 이름 ) [출처] #

레지스트리에서 컬러맵을 제거합니다.

내장 컬러맵은 제거할 수 없습니다.

명명된 컬러맵이 등록되지 않은 경우 오류 없이 반환되고 기본 컬러맵의 등록을 취소하려고 하면 발생합니다.

경고

컬러맵 이름은 현재 여러 패키지에서 사용할 수 있는 공유 네임스페이스입니다. unregister이전에 해당 이름을 등록한 적이 있는 경우에만 사용하십시오 . 특히 새로운 컬러맵을 등록하기 전에 이름을 정리할 경우를 대비하여 등록을 취소하지 마십시오.

매개변수 :
이름 문자열

제거할 컬러맵의 이름입니다.

레이즈 :
값 오류

기본 내장 컬러맵을 제거하려는 경우.

클래스 matplotlib.cm. ScalarMappable ( norm = None , cmap = None ) [소스] #

베이스:object

스칼라 데이터를 RGBA에 매핑하는 혼합 클래스입니다.

ScalarMappable은 주어진 컬러맵에서 RGBA 색상을 반환하기 전에 데이터 정규화를 적용합니다.

매개변수 :
norm Normalize(또는 하위 클래스) 또는 str 또는 None

데이터를 일반적으로 간격으로 조정하는 정규화 개체입니다 . 이면 해당 이름의 척도를 기반으로 하위 클래스가 동적으로 생성됩니다 . None 인 경우 , norm 은 기본적으로 처리된 첫 번째 데이터를 기반으로 스케일링을 초기화 하는 colors.Normalize 객체입니다.[0, 1]strNormalize

cmap 문자열 또는Colormap

정규화된 데이터 값을 RGBA 색상에 매핑하는 데 사용되는 색상표입니다.

자동 크기 조정 ( ) [소스] #

현재 배열을 사용하여 표준 인스턴스에 대한 스칼라 제한을 자동 확장합니다.

autoscale_None ( ) [출처] #

없음인 제한만 변경하여 현재 배열을 사용하여 표준 인스턴스의 스칼라 제한을 자동 확장합니다.

속성 콜백SM [소스] #
변경됨 ( ) [출처] #

모든 콜백SM 리스너에게 '변경된' 신호를 알리기 위해 매핑 가능 항목이 변경될 때마다 이것을 호출합니다.

컬러바 #

이 ScalarMappable과 연결된 마지막 컬러바입니다. 없음일 수 있습니다.

get_alpha ( ) [출처] #
반환 :
뜨다

항상 1을 반환합니다.

get_array ( ) [소스] #

색상에 매핑된 값의 배열을 반환합니다.

기본 클래스 ScalarMappable는 배열의 차원 및 모양에 대해 어떠한 가정도 하지 않습니다.

get_clim ( ) [출처] #

컬러맵 한계에 매핑된 값(최소, 최대)을 반환합니다.

get_cmap ( ) [출처] #

Colormap인스턴스를 반환합니다 .

속성 규범 #
set_array ( A ) [소스] #

배열과 같은 A 에서 값 배열을 설정합니다 .

매개변수 :
배열과 같은 또는 None

색상에 매핑된 값입니다.

기본 클래스 는 값 배열 AScalarMappable 의 차원 및 모양에 대해 어떠한 가정도 하지 않습니다 .

set_clim ( vmin = 없음 , vmax = 없음 ) [소스] #

이미지 스케일링에 대한 표준 한계를 설정합니다.

매개변수 :
vmin, vmax 플로트

한계.

한계는 단일 위치 인수로 튜플( vmin , vmax )로 전달될 수도 있습니다 .

set_cmap ( cmap ) [소스] #

휘도 데이터의 컬러맵을 설정합니다.

매개변수 :
cmap Colormap또는 str 또는 없음
set_norm ( 규범 ) [출처] #

정규화 인스턴스를 설정합니다.

매개변수 :
규범 Normalize또는 str 또는 없음

메모

이 표준에 대해 매핑 가능을 사용하는 컬러바가 있는 경우 매핑 가능의 표준을 설정하면 컬러바의 표준, 로케이터 및 포맷터가 기본값으로 재설정됩니다.

to_rgba ( x , 알파 = 없음 , 바이트 = 거짓 , 규범 = ) [소스] #

x 에 해당하는 정규화된 rgba 배열을 반환합니다 .

일반적인 경우 x 는 1D 또는 2D 스칼라 시퀀스이며 이 ScalarMappable에 대해 설정된 표준 및 색상 맵에 따라 rgba 값의 해당 ndarray가 반환됩니다.

이미지 파일에서 읽은 것과 같이 이미 rgb 또는 rgba인 이미지를 처리하는 특별한 경우가 있습니다. x 가 3차원 ndarray 이고 마지막 차원이 3 또는 4인 경우 rgb 또는 rgba 배열로 처리되며 매핑이 수행되지 않습니다. 배열은 uint8이거나 0-1 범위의 값을 가진 부동 소수점일 수 있습니다. 그렇지 않으면 ValueError가 발생합니다. 마스킹된 배열인 경우 마스크가 무시됩니다. 마지막 차원이 3이면 알파 kwarg(기본값은 1)가 투명도를 채우는 데 사용됩니다. 마지막 차원이 4이면 알파 kwarg가 무시됩니다. 기존 알파를 대체하지 않습니다. 세 번째 차원이 3 또는 4가 아닌 경우 ValueError가 발생합니다.

두 경우 모두 바이트False (기본값)이면 rgba 배열은 0-1 범위에서 부동 소수점입니다. True 인 경우 반환된 rgba 배열은 0에서 255 범위의 uint8이 됩니다.

norm이 False이면 입력 데이터의 정규화가 수행되지 않으며 범위(0-1)에 있는 것으로 가정합니다.

matplotlib.cm. get_cmap ( 이름 = 없음 , lut = 없음 ) [소스] #

[ Deprecated ] 이름 이 None 이면 rc 값을 기본값으로 하는 컬러맵 인스턴스를 가져옵니다 .

매개변수 :
이름 matplotlib.colors.Colormap또는 str 또는 없음, 기본값: 없음

인스턴스인 경우 Colormap반환됩니다. 그렇지 않으면 lut 에 의해 리샘플링될 Matplotlib에 알려진 컬러맵의 이름입니다 . 기본값인 없음은 rcParams["image.cmap"](기본값: 'viridis')을 의미합니다.

lut int 또는 없음, 기본값: 없음

name 이 아직 Colormap 인스턴스 가 아니고 lut 가 None이 아닌 경우 , 색상 표는 룩업 테이블에 lut 항목을 포함 하도록 리샘플링됩니다 .

반환 :
컬러맵

메모

버전 3.6부터 사용되지 않음: 대신 사용하십시오 matplotlib.colormaps[name].

matplotlib.cm. register_cmap ( name = None , cmap = None , * , override_builtin = False ) [소스] #

[ 비추천 ] 에서 인식하는 세트에 컬러맵을 추가합니다 get_cmap().

이름으로 액세스할 새 컬러맵을 등록합니다.

LinearSegmentedColormap('swirly', data, lut)
register_cmap(cmap=swirly_cmap)
매개변수 :
이름 문자열, 선택 사항

get_cmap()또는 에서 사용할 수 있는 이름 rcParams["image.cmap"](기본값: 'viridis')

없는 경우 이름은 cmapname 의 속성이 됩니다.

cmap matplotlib.colors.Colormap

두 번째 인수이고 기본값이 있음에도 불구하고 이것은 필수 인수입니다.

override_builtin 부울

내장 색상표를 사용자 제공 색상표로 재정의할 수 있습니다.

필요하다고 확신하지 않는 한 사용하지 마십시오.

메모

버전 3.6부터 사용되지 않음: 대신 사용하십시오 matplotlib.colormaps.register(name).

matplotlib.cm. unregister_cmap ( 이름 ) [소스] #

[ 비추천 ] 에서 인식한 컬러맵을 제거합니다 get_cmap().

내장 컬러맵은 제거할 수 없습니다.

명명된 컬러맵이 등록되지 않은 경우 오류 없이 반환되고 기본 컬러맵의 등록을 취소하려고 하면 발생합니다.

경고

컬러맵 이름은 현재 여러 패키지에서 사용할 수 있는 공유 네임스페이스입니다. unregister_cmap이전에 해당 이름을 등록한 적이 있는 경우에만 사용하십시오 . 특히 새로운 컬러맵을 등록하기 전에 이름을 정리할 경우를 대비하여 등록을 취소하지 마십시오.

매개변수 :
이름 문자열

등록을 취소할 컬러맵의 이름

반환 :
ColorMap 또는 없음

컬러맵이 등록되었으면 반환하지 않으면 반환None

레이즈 :
값 오류

기본 내장 컬러맵을 등록 취소하려는 경우.

메모

버전 3.6부터 사용되지 않음: 대신 사용하십시오 matplotlib.colormaps.unregister(name).