matplotlib#

객체 지향 플로팅 라이브러리.

절차적 인터페이스는 함께 제공되는 pyplot 모듈에 의해 제공되며 직접 가져올 수 있습니다. 예를 들면 다음과 같습니다.

import matplotlib.pyplot as plt

또는 ipython 사용:

ipython

터미널에서 다음을 수행합니다.

In [1]: %matplotlib
In [2]: import matplotlib.pyplot as plt

ipython 쉘 프롬프트에서.

대부분의 경우 프로그래밍할 때 명시적 객체 지향 라이브러리를 직접 사용하는 것이 좋습니다. 암시적 pyplot 인터페이스는 주로 대화식 작업을 위한 것입니다. 이 제안의 예외는 스크립팅을 크게 단순화할 수 있는 pyplot 함수 pyplot.figure, pyplot.subplot, pyplot.subplots및 입니다. 암시적 인터페이스와 명시적 인터페이스 간의 장단점에 대한 설명은 Matplotlib API(응용 프로그램 인터페이스)pyplot.savefig 를 참조하세요 .

모듈에는 다음이 포함됩니다.

matplotlib.axes

Axes수업 . 대부분의 pyplot 함수는 Axes메서드의 래퍼입니다. 축 모듈은 라이브러리에 대한 OO 액세스의 최상위 수준입니다.

matplotlib.figure

Figure수업 .

matplotlib.artist

Artist사물을 그리는 모든 클래스 의 기본 클래스입니다.

matplotlib.lines

Line2D선과 마커를 그리는 클래스입니다 .

matplotlib.patches

다각형을 그리기 위한 클래스입니다.

matplotlib.text

및 Text클래스 Annotation.

matplotlib.image

및 AxesImage클래스 FigureImage.

matplotlib.collections

라인 또는 폴리곤 그룹을 효율적으로 그리기 위한 클래스입니다.

matplotlib.colors

색상 사양 및 색상표 만들기.

matplotlib.cm

Colormaps 및 ScalarMappable다른 클래스에 색상 매핑 기능을 제공하기 위한 mixin 클래스.

matplotlib.ticker

눈금 표시 위치 계산 및 눈금 레이블 서식 지정.

matplotlib.backends

다양한 GUI 라이브러리 및 출력 형식을 위한 모듈이 포함된 하위 패키지.

기본 matplotlib 네임스페이스에는 다음이 포함됩니다.

rcParams

기본 구성 설정 기본값은 matplotlibrc파일을 사용하여 재정의할 수 있습니다.

use

Matplotlib 백엔드 설정. 이것은 Figure가 생성되기 전에 호출되어야 합니다. 그 이후에는 다른 GUI 백엔드 간에 전환할 수 없기 때문입니다.

Matplotlib은 처음에 John D. Hunter(1968-2012)가 작성했으며 현재 다른 많은 사람들이 개발 및 유지 관리하고 있습니다.

때때로 내부 문서(python 독스트링)는 The MathWorks, Inc.의 등록 상표인 MATLAB®을 참조합니다.

백엔드 관리 #

matplotlib입니다. 사용 ( 백엔드 , * , 힘 = True ) [소스] #

렌더링 및 GUI 통합에 사용되는 백엔드를 선택합니다.

매개변수 :
백엔드 문자열

전환할 백엔드입니다. 이것은 대소문자를 구분하지 않는 표준 백엔드 이름 중 하나일 수 있습니다.

  • 대화식 백엔드: GTK3Agg, GTK3Cairo, GTK4Agg, GTK4Cairo, MacOSX, nbAgg, QtAgg, QtCairo, TkAgg, TkCairo, WebAgg, WX, WXAgg, WXCairo, Qt5Agg, Qt5Cairo

  • 비대화형 백엔드: agg, cairo, pdf, pgf, ps, svg, 템플릿

또는 형식의 문자열: module://my.module.name.

관련 없는 이벤트 루프가 이미 시작된 경우 대화식 백엔드로 전환할 수 없습니다(예: TkAgg 창이 이미 열린 경우 GTK3Agg로 전환). 비대화형 백엔드로의 전환은 항상 가능합니다.

강제 부울, 기본값: True

True(기본값) ImportError이면 백엔드를 설정할 수 없는 경우(가져오기에 실패했거나 호환되지 않는 GUI 대화형 프레임워크가 이미 실행 중이기 때문에)를 발생시킵니다. False인 경우 오류를 자동으로 무시합니다.

또한보십시오

백엔드
matplotlib.get_backend
matplotlib입니다. get_backend ( ) [출처] #

현재 백엔드의 이름을 반환합니다.

또한보십시오

matplotlib.use
matplotlib입니다. 대화형 ( b ) [출처] #

모든 플로팅 명령(예: ) 후에 다시 그릴지 여부를 설정합니다 pyplot.xlabel.

matplotlib입니다. is_interactive ( ) [출처] #

모든 플로팅 명령 후 다시 그릴지 여부를 반환합니다.

메모

이 기능은 백엔드에서만 사용할 수 있습니다. 최종 사용자는 대신 사용해야 pyplot.isinteractive합니다.

기본값 및 스타일 지정 #

matplotlib입니다. rcParams [소스] #

RcParams기본 Matplotlib 값을 처리하기 위한 인스턴스입니다 .

클래스 matplotlib. RcParams ( * args , ** kwargs ) [소스] #

유효성 검사를 포함하는 사전 개체입니다.

유효성 검사 함수는 에서 정의되고 rc 매개 변수와 연결됩니다 matplotlib.rcsetup.

rcParams 목록은 다음과 같습니다.

  • _internal.classic_mode

  • agg.path.chunksize

  • animation.bitrate

  • animation.codec

  • animation.convert_args

  • animation.convert_path

  • animation.embed_limit

  • animation.ffmpeg_args

  • animation.ffmpeg_path

  • animation.frame_format

  • animation.html

  • animation.writer

  • 축.자동제한_모드

  • 축.축아래

  • 축.edgecolor

  • 축.면색

  • axis.formatter.limits

  • axis.formatter.min_exponent

  • axis.formatter.offset_threshold

  • axis.formatter.use_locale

  • axis.formatter.use_mathtext

  • 축.포맷터.사용오프셋

  • 축 그리드

  • 축.그리드.축

  • 축.그리드.어느

  • 축.레이블 색상

  • 축.레이블 패드

  • 축.레이블 크기

  • 축.라벨가중치

  • 축.선폭

  • 축.prop_cycle

  • 축.척추.바닥

  • 축.척추.왼쪽

  • 축.척추.오른쪽

  • 축.척추.상단

  • 축.제목색상

  • 축.제목위치

  • 축.제목 패드

  • 축.제목 크기

  • 축.제목가중치

  • 축.제목

  • 축.unicode_minus

  • 축.xmargin

  • 축.ymargin

  • 축.zmargin

  • 축 3d.그리드

  • 백엔드

  • backend_fallback

  • boxplot.bootstrap

  • boxplot.boxprops.color

  • boxplot.boxprops.linestyle

  • boxplot.boxprops.linewidth

  • boxplot.capprops.color

  • boxplot.capprops.linestyle

  • boxplot.capprops.linewidth

  • boxplot.flierprops.color

  • boxplot.flierprops.linestyle

  • boxplot.flierprops.linewidth

  • boxplot.flierprops.marker

  • boxplot.flierprops.markeredgecolor

  • boxplot.flierprops.markeredgewidth

  • boxplot.flierprops.markerfacecolor

  • boxplot.flierprops.markerssize

  • boxplot.meanline

  • boxplot.meanprops.color

  • boxplot.meanprops.linestyle

  • boxplot.meanprops.linewidth

  • boxplot.meanprops.marker

  • boxplot.meanprops.markeredgecolor

  • boxplot.meanprops.markerfacecolor

  • boxplot.meanprops.markerssize

  • boxplot.medianprops.color

  • boxplot.medianprops.linestyle

  • boxplot.medianprops.linewidth

  • boxplot.notch

  • boxplot.patchartist

  • boxplot.showbox

  • boxplot.showcaps

  • boxplot.showfliers

  • boxplot.showmeans

  • boxplot.vertical

  • boxplot.whiskerprops.color

  • boxplot.whiskerprops.linestyle

  • boxplot.whiskerprops.linewidth

  • boxplot.whiskers

  • 윤곽.알고리즘

  • contour.corner_mask

  • 등고선.선폭

  • contour.negative_linestyle

  • date.autoformatter.day

  • 날짜.자동포맷터.시간

  • 날짜.자동포맷터.마이크로초

  • 날짜.자동포맷터.분

  • 날짜.자동포매터.월

  • 날짜.자동포맷터.초

  • date.autoformatter.year

  • 날짜 변환기

  • 날짜.기원

  • date.interval_multiples

  • 독스트링.하드카피

  • errorbar.capsize

  • 그림.자동 레이아웃

  • 그림.constrained_layout.h_pad

  • figure.constrained_layout.hspace

  • figure.constrained_layout.use

  • 그림.constrained_layout.w_pad

  • 그림.constrained_layout.wspace

  • 그림.dpi

  • 그림.edgecolor

  • 피규어.페이스컬러

  • 그림.무화과 크기

  • 피규어.프레임온

  • 그림.라벨 크기

  • figure.labelweight

  • 그림.max_open_warning

  • figure.raise_window

  • 그림.서브플롯.하단

  • figure.subplot.hspace

  • 그림.서브플롯.왼쪽

  • 그림.서브플롯.오른쪽

  • figure.subplot.top

  • 그림.서브플롯.wspace

  • 그림.제목 크기

  • 피규어.타이틀웨이트

  • 글꼴.필기체

  • 글꼴.가족

  • font.fantasy

  • font.monospace

  • font.sans-serif

  • font.serif

  • 글꼴 크기

  • font.stretch

  • 글꼴.스타일

  • 글꼴.변형

  • font.weight

  • 그리드.알파

  • 그리드.색상

  • 그리드.선 스타일

  • 그리드.선폭

  • 해치.컬러

  • 해치.선폭

  • hist.bins

  • 이미지.면

  • 이미지.cmap

  • 이미지.복합_이미지

  • 이미지.보간

  • 이미지.루트

  • 이미지.원본

  • 이미지.재샘플

  • 인터렉티브

  • 키맵.백

  • 키맵.복사

  • 키맵.앞으로

  • 키맵.전체화면

  • 키맵.그리드

  • keymap.grid_minor

  • 키맵.도움말

  • 키맵.홈

  • 키맵.팬

  • 키맵.종료

  • keymap.quit_all

  • 키맵.저장

  • keymap.xscale

  • 키맵.yscale

  • 키맵.줌

  • legend.borderaxespad

  • 범례.경계 패드

  • 범례.열 간격

  • 범례.edgecolor

  • 범례.페이스컬러

  • 범례.fancybox

  • 범례.글꼴 크기

  • 범례.프레임알파

  • 범례.프레임온

  • 범례.핸들 높이

  • 범례.핸들 길이

  • 범례.핸들텍스트 패드

  • 범례.레이블 색상

  • 범례.레이블 간격

  • legend.loc

  • 범례.마커스케일

  • legend.numpoints

  • legend.scatterpoints

  • 범례.그림자

  • legend.title_fontsize

  • 선.안티앨리어싱

  • 선.색상

  • lines.dash_capstyle

  • lines.dash_joinstyle

  • 선.dashdot_pattern

  • 선.dashed_pattern

  • lines.dotted_pattern

  • 선.선 스타일

  • 선.선폭

  • 라인.마커

  • 라인.마커에지 색상

  • 라인.마커에지폭

  • 라인.마커페이스 색상

  • 라인.마커 크기

  • 라인.스케일_대시

  • lines.solid_capstyle

  • lines.solid_joinstyle

  • markers.fillstyle

  • mathtext.bf

  • mathtext.cal

  • mathtext.default

  • mathtext.fallback

  • mathtext.fontset

  • mathtext.it

  • mathtext.rm

  • mathtext.sf

  • mathtext.tt

  • patch.antialiased

  • patch.edgecolor

  • patch.facecolor

  • patch.force_edgecolor

  • 패치.선폭

  • 경로.효과

  • 경로.단순화

  • 경로.simplify_threshold

  • 경로.스케치

  • 경로.스냅

  • pcolor.shading

  • pcolormesh.snap

  • pdf.압축

  • pdf.폰트타입

  • pdf.inheritcolor

  • pdf.use14core글꼴

  • pgf.preamble

  • pgf.rc글꼴

  • pgf.texsystem

  • polaraxes.grid

  • ps.distiller.res

  • ps.폰트타입

  • ps.종이크기

  • ps.useafm

  • ps.usedistiller

  • savefig.bbox

  • savefig.directory

  • savefig.dpi

  • savefig.edgecolor

  • savefig.facecolor

  • savefig.format

  • savefig.orientation

  • savefig.pad_inches

  • savefig.transparent

  • scatter.edgecolors

  • 산란.마커

  • svg.글꼴 유형

  • svg.hashsalt

  • svg.image_inline

  • text.antialiased

  • 텍스트.색상

  • 텍스트.힌팅

  • text.hinting_factor

  • text.kerning_factor

  • text.latex.preamble

  • text.parse_math

  • text.usetex

  • 시간대

  • tk.window_focus

  • 툴바

  • webag.address

  • webag.open_in_browser

  • webagg.port

  • webag.port_retries

  • xaxis.label위치

  • xtick.정렬

  • xtick.바닥

  • xtick.color

  • xtick.방향

  • xtick.labelbottom

  • xtick.labelcolor

  • xtick.labelsize

  • xtick.labeltop

  • xtick.major.bottom

  • xtick.major.pad

  • xtick.major.size

  • xtick.major.top

  • xtick.major.width

  • xtick.minor.bottom

  • xtick.minor.pad

  • xtick.minor.size

  • xtick.minor.top

  • xtick.minor.visible

  • xtick.minor.width

  • xtick.top

  • yaxis.labellocation

  • ytick.정렬

  • ytick.color

  • ytick.방향

  • ytick.labelcolor

  • ytick.labelleft

  • ytick.labelright

  • ytick.labelsize

  • ytick.왼쪽

  • ytick.major.left

  • ytick.major.pad

  • ytick.major.right

  • ytick.major.size

  • ytick.major.width

  • ytick.minor.left

  • ytick.minor.pad

  • ytick.minor.right

  • ytick.minor.size

  • ytick.minor.visible

  • ytick.minor.width

  • ytick.right

또한보십시오

matplotlibrc 파일
find_all ( 패턴 ) [소스] #

re.search()주어진 를 사용하여 키가 일치하는 이 RcParams 사전의 하위 집합을 반환합니다 pattern.

메모

반환된 사전에 대한 변경 사항 은 상위 RcParams 사전으로 전파 되지 않습니다 .

복사 ( ) [출처] #

이 RcParams 인스턴스를 복사합니다.

matplotlib입니다. rc_context ( rc = 없음 , fname = 없음 ) [소스] #

일시적으로 rcParams를 변경하기 위한 컨텍스트 관리자를 반환합니다.

는 rcParams["backend"]컨텍스트 관리자에 의해 재설정되지 않습니다.

매개변수 :
rc 사전

임시로 설정할 rcParams입니다.

fname str 또는 경로 유사

Matplotlib rc 설정이 있는 파일. fname 과 rc 를 모두 지정하면 rc 의 설정 이 우선합니다.

또한보십시오

matplotlibrc 파일

예

사전을 통해 명시적 값 전달:

with mpl.rc_context({'interactive': False}):
    fig, ax = plt.subplots()
    ax.plot(range(3), range(3))
    fig.savefig('example.png')
    plt.close(fig)

파일에서 설정 로드:

with mpl.rc_context(fname='print.rc'):
    plt.plot(x, y)  # uses 'print.rc'
matplotlib입니다. rc ( 그룹 , ** kwargs ) [출처] #

현재를 설정합니다 rcParams. group 은 rc에 대한 그룹화입니다. 예를 들어 lines.linewidthgroup is lines, for axes.facecolor, group is axes등입니다. 그룹은 그룹 이름의 목록 또는 튜플일 수도 있습니다(예: ( xtick , ytick ). kwargs 는 사전 속성 이름/값 쌍입니다. 예:

rc('lines', linewidth=2, color='r')

전류를 설정하고 다음 rcParams과 동일합니다.

rcParams['lines.linewidth'] = 2
rcParams['lines.color'] = 'r'

다음 별칭은 대화형 사용자를 위해 입력을 저장하는 데 사용할 수 있습니다.

별명

재산

'lw'

'선의 폭'

'일'

'선 스타일'

'씨'

'색깔'

'fc'

'페이스컬러'

'에크'

'엣지컬러'

'갈매기'

'마커에지폭'

'아'

'안티앨리어싱'

따라서 위의 호출을 다음과 같이 축약할 수 있습니다.

rc('lines', lw=2, c='r')

파이썬의 kwargs 사전 기능을 사용하여 기본 매개변수의 사전을 저장할 수 있습니다. 예를 들어 다음과 같이 글꼴 rc를 사용자 정의할 수 있습니다.

font = {'family' : 'monospace',
        'weight' : 'bold',
        'size'   : 'larger'}
rc('font', **font)  # pass in the font dict as kwargs

이를 통해 여러 구성 간에 쉽게 전환할 수 있습니다. 변경 후 기본값을 복원 하려면 matplotlib.style.use('default')또는 를 사용하십시오 .rcdefaults()rcParams

메모

일반 dict 인터페이스를 사용하여 유사한 기능을 사용할 수 있습니다 (단 , 약어나 그룹화는 지원하지 않음).rcParams.update({"lines.linewidth": 2, ...})rcParams.update

matplotlib입니다. rcdefaults ( ) [출처] #

rcParamsMatplotlib의 내부 기본 스타일에서 복원합니다 .

스타일 블랙리스트 rcParams( 에 정의됨 matplotlib.style.core.STYLE_BLACKLIST)는 업데이트되지 않습니다.

또한보십시오

matplotlib.rc_file_defaults

rcParams원래 Matplotlib에서 로드한 rc 파일에서 를 복원합니다 .

matplotlib.style.use

특정 스타일 파일을 사용하십시오. style.use('default')기본 스타일을 복원하려면 전화하십시오 .

matplotlib입니다. rc_file_defaults ( ) [소스] #

rcParamsMatplotlib에서 로드한 원본 rc 파일에서 를 복원합니다 .

스타일 블랙리스트 rcParams( 에 정의됨 matplotlib.style.core.STYLE_BLACKLIST)는 업데이트되지 않습니다.

matplotlib입니다. rc_file ( fname , * , use_default_template = True ) [소스] #

파일에서 업데이트 rcParams합니다.

스타일 블랙리스트 rcParams( 에 정의됨 matplotlib.style.core.STYLE_BLACKLIST)는 업데이트되지 않습니다.

매개변수 :
fname str 또는 경로 유사

Matplotlib rc 설정이 있는 파일.

use_default_template 부울

True인 경우 지정된 파일의 매개변수로 업데이트하기 전에 기본 매개변수로 초기화합니다. False인 경우 현재 구성이 유지되고 파일에 지정된 매개변수만 업데이트됩니다.

matplotlib입니다. rc_params ( fail_on_error = False ) [소스] #

기본 Matplotlib RcParamsrc 파일에서 인스턴스를 생성합니다.

matplotlib입니다. rc_params_from_file ( fname , fail_on_error = False , use_default_template = True ) [소스] #

RcParams파일 fname 에서 구성 합니다 .

매개변수 :
fname str 또는 경로 유사

Matplotlib rc 설정이 있는 파일.

fail_on_error 부울

True인 경우 파서가 매개변수 변환에 실패할 때 오류를 발생시킵니다.

use_default_template 부울

True인 경우 지정된 파일의 매개변수로 업데이트하기 전에 기본 매개변수로 초기화합니다. False인 경우 구성 클래스에는 파일에 지정된 매개변수만 포함됩니다. (dicts 업데이트에 유용합니다.)

matplotlib입니다. get_configdir ( ) [소스] #

구성 디렉토리의 문자열 경로를 반환합니다.

디렉토리는 다음과 같이 선택됩니다.

  1. MPLCONFIGDIR 환경 변수가 제공되면 이를 선택하십시오.

  2. Linux에서는 XDG 사양을 따르고 $XDG_CONFIG_HOME정의된 경우 에서 먼저 살펴보거나 $HOME/.config. 다른 플랫폼에서는 를 선택합니다 $HOME/.matplotlib.

  3. 선택한 디렉토리가 존재하고 쓰기 가능한 경우 해당 디렉토리를 구성 디렉토리로 사용합니다.

  4. 그렇지 않으면 임시 디렉토리를 만들어 구성 디렉토리로 사용합니다.

matplotlib입니다. matplotlib_fname ( ) [출처] #

구성 파일의 위치를 ​​가져옵니다.

파일 위치는 다음 순서로 결정됩니다.

  • $PWD/matplotlibrc

  • $MATPLOTLIBRC디렉토리가 아닌 경우

  • $MATPLOTLIBRC/matplotlibrc

  • $MPLCONFIGDIR/matplotlibrc

  • 리눅스에서,

    • $XDG_CONFIG_HOME/matplotlib/matplotlibrc( $XDG_CONFIG_HOME 정의된 경우)

    • 또는 $HOME/.config/matplotlib/matplotlibrc( $XDG_CONFIG_HOME 정의되지 않은 경우)

  • 다른 플랫폼에서는 - 정의된 $HOME/.matplotlib/matplotlibrc경우$HOME

  • $MATPLOTLIBDATA/matplotlibrc마지막으로 항상 존재해야 하는 를 찾습니다 .

matplotlib입니다. get_data_path ( ) [소스] #

Matplotlib 데이터의 경로를 반환합니다.

로깅 #

matplotlib입니다. set_loglevel ( 레벨 ) [소스] #

Matplotlib의 루트 로거 및 루트 로거 처리기 수준을 설정하고 아직 존재하지 않는 경우 처리기를 만듭니다.

일반적으로 추가 디버깅 정보를 얻으려면 set_loglevel("info")또는 를 호출해야 합니다.set_loglevel("debug")

매개변수 :
레벨 {"notset", "debug", "info", "warning", "error", "critical"}

처리기의 로그 수준입니다.

메모

이 함수가 처음 호출될 때 추가 처리기가 Matplotlib의 루트 처리기에 연결됩니다. 이 핸들러는 매번 재사용되며 이 함수는 단순히 로거와 핸들러의 수준을 조작합니다.

컬러맵과 컬러 시퀀스 #

matplotlib입니다. 컬러맵 [출처] #

이름으로 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)
matplotlib입니다. color_sequences [출처] #

이름으로 Matplotlib에 알려진 일련의 색상에 대한 컨테이너입니다.

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

읽기 액세스는 이름을 색상 목록에 매핑하는 사전과 같은 인터페이스를 사용합니다.

import matplotlib as mpl
cmap = mpl.color_sequences['tab10']

반환된 목록은 복사본이므로 수정해도 색상 순서의 전역 정의가 변경되지 않습니다.

추가 색상 시퀀스는 다음을 통해 추가할 수 있습니다 ColorSequenceRegistry.register.

mpl.color_sequences.register('rgb', ['r', 'g', 'b'])

기타 #

클래스 matplotlib. MatplotlibDeprecationWarning [출처] #

Matplotlib 사용자에 대한 지원 중단 경고를 발행하는 클래스입니다.

matplotlib입니다. get_cachedir ( ) [출처] #

캐시 디렉토리의 문자열 경로를 반환합니다.

$XDG_CACHE_HOME디렉터리를 찾는 데 사용되는 절차는 대신 / 를 사용하는 것을 제외하고는 _get_config_dir의 경우와 동일 $HOME/.cache합니다.