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 색상을 반환하기 전에 데이터 정규화를 적용합니다.
- 매개변수 :
- 컬러바 #
이 ScalarMappable과 연결된 마지막 컬러바입니다. 없음일 수 있습니다.
- get_array ( ) [소스] #
색상에 매핑된 값의 배열을 반환합니다.
기본 클래스
ScalarMappable
는 배열의 차원 및 모양에 대해 어떠한 가정도 하지 않습니다.
- 속성 규범 #
- set_array ( A ) [소스] #
배열과 같은 A 에서 값 배열을 설정합니다 .
- 매개변수 :
- 배열과 같은 또는 None
색상에 매핑된 값입니다.
기본 클래스 는 값 배열 A
ScalarMappable
의 차원 및 모양에 대해 어떠한 가정도 하지 않습니다 .
- set_clim ( vmin = 없음 , vmax = 없음 ) [소스] #
이미지 스케일링에 대한 표준 한계를 설정합니다.
- 매개변수 :
- vmin, vmax 플로트
한계.
한계는 단일 위치 인수로 튜플( vmin , vmax )로 전달될 수도 있습니다 .
- 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'
)없는 경우 이름은 cmap
name
의 속성이 됩니다.- 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)
.