figure함수의 옵션(키워드 인자 상세사항) - matplotlib(24)

파이썬 버전 3.7 기준

matplotlib 버전 3.1.0 기준

figure함수의 키워드 인자 상세사항

본 포스팅에서는 figure() 함수의 입력 키워드인자에 대한 상세 설명를 다룬다.

서브플롯의 기초적인 작성법은 선행포스팅(링크)를 참고하도록 한다.

figure(num=None, figsize=None, dpi=None, facecolor=None, edgecolor=None, frameon=True, FigureClass=<class 'matplotlib.figure.Figure'>, clear=False, **kwargs)

이 함수는 Figure를 생성 및 편집 할 수 있게 해준다. 

num

입력 형태: int, str

설명

선택적으로 입력이 가능하다.

입력 형태에 따라 거동이 변화하며, 크게 입력되지 않을 경우와 정수(int)가 입력되는 경우, 그리고 문자열(string, str)이 입력되는 경우가 존재한다.

값이 입력되지 않는 경우(혹은 None의 입력)

새로운 Figure를 생성시키며 Figure 개수가 늘어난다.

생성된 Figure 오브젝트는 Figure의 number 어트리뷰트에 몇 번째 Figure인지에 대한 정보가 들어가있다.

정수가 입력된 경우

만약 이 값이 정수(int)로 입력되고, 이미 해당 Figure가 존재할 경우 해당 Figure를 활성화(active)시키며, 이를 참조로 반환한다.

만약 이 값이 정수(int)로 입력되는데, 해당 Figure가 존재하지 안는다면 입력된 번호에 해당하는 Figure를 생성한다.

문자열이 입력된 경우

이 값에 문자열(string, str)이 입력될 경우, 윈도우(window)의 타이틀은 num에 입력된 문자열로 설정된다.

기본값은 None이며, 이 경우 위에 설명된바와 같이 새로운 Figure를 생성한다.

figsize

입력 형태: (float, float)

설명

선택적으로 입력이 가능하다.

figure의 너비(width), 높이(height)를 인치(inch)단위로 입력 받는다.

기본값은 None이고, 이 경우 rcParams["figure.figsize"]=[6.4, 4.8]으로 입력된다. 

dpi

입력 형태: int

설명

선택적으로 입력이 가능하다.

figure의 해상도(resolution)을 설정할 수 있다.

기본값은 None이며, 이 경우 rcParams["figure.dpi"]=100가 입력된다.

facecolor

입력 형태: color spec

설명

선택적으로 입력이 가능하다.

figure의 배경(background)의 색을 설정한다.

선행포스팅(링크) 색상 설정과 동일한 색상 코드를 입력받을 수 있다.

edgecolor

입력 형태: color spec

설명

선택적으로 입력이 가능하다.

figure의 모서리(edge)의 색을 설정한다.

선행포스팅(링크) 색상 설정과 동일한 색상 코드를 입력받을 수 있다.

frameon

입력 형태: bool

설명

선택적으로 입력이 가능하다.

False이 입력될 경우, figure의 프레임(frame)을 그리는 것을 막는다.

기본값은 True이다. 

FigureClass

입력 형태: subclass of Figure 

설명

선택적으로 입력이 가능하다.

커스터마이징된 Figure 인스턴스를 사용할 수 있다.

clear

입력 형태: bool

설명

선택적으로 입력이 가능하다.

True가 입력되고 이미 figure가 존재하는 경우에 이를 제거한다.

기본값은 False이다.

	참고자료   https://matplotlib.org/api/_as_gen/matplotlib.pyplot.figure.html