matplotlib.ticker

찾기 및 서식 확인

이 모듈에는 눈금 찾기 및 형식 지정을 구성하기 위한 클래스가 포함되어 있습니다. 일반 틱 로케이터 및 포매터는 물론 도메인별 사용자 지정 로케이터도 제공됩니다.

로케이터는 메이저 또는 마이너 틱에 대해 아무것도 모르지만 Axis 클래스에서 메이저 및 마이너 틱 찾기 및 서식 지정을 지원하는 데 사용됩니다.

틱 찾기

Locator 클래스는 모든 진드기 위치 지정자의 기본 클래스입니다. 로케이터는 데이터 제한 및 눈금 위치 선택을 기반으로 보기 제한의 자동 크기 조정을 처리합니다. 유용한 반자동 진드기 탐지기는 MultipleLocator. 예를 들어 10과 같은 기준으로 초기화되며 해당 기준의 배수인 축 제한과 틱을 선택합니다.

여기에 정의된 로케이터 하위 클래스는 다음과 같습니다.

AutoLocator	MaxNLocator간단한 기본값으로. 이것은 대부분의 플로팅에 대한 기본 눈금 로케이터입니다.
MaxNLocator	좋은 위치에서 틱으로 최대 간격 수를 찾습니다.
LinearLocator	간격은 최소에서 최대까지 균등하게 틱됩니다.
LogLocator	공간은 최소에서 최대까지 대수적으로 틱합니다.
MultipleLocator	틱과 범위는 기본의 배수입니다. 정수 또는 부동 소수점.
FixedLocator	틱 위치는 고정되어 있습니다.
IndexLocator	인덱스 플롯의 로케이터(예: where ).x = range(len(y))
NullLocator	진드기가 없습니다.
SymmetricalLogLocator	symlog norm과 함께 사용하기 위한 로케이터. 임계값을 벗어난 부분에 대해 작동 LogLocator하고 한계 내에 있으면 0을 추가합니다.
AsinhLocator	asinh 규범과 함께 사용하기 위한 로케이터로 틱 간격을 거의 균일하게 시도합니다.
LogitLocator	로짓 스케일링을 위한 로케이터.
AutoMinorLocator	축이 선형이고 주요 눈금이 균일한 간격으로 있을 때 작은 눈금에 대한 로케이터입니다. 메이저 틱 간격을 지정된 수의 마이너 간격으로 세분화합니다. 기본 간격은 메이저 간격에 따라 4 또는 5입니다.

날짜 위치에 특화된 여러 로케이터가 있습니다 dates. 모듈을 참조하십시오.

Locator에서 파생하여 고유한 로케이터를 정의할 수 있습니다. 일련의 위치를 ​​반환하는 메서드를 재정의해야 __call__하며 자동 크기 조정 메서드를 재정의하여 데이터 제한에서 보기 제한을 설정하는 것이 좋습니다.

기본 로케이터를 재정의하려면 위 또는 사용자 정의 로케이터 중 하나를 사용하여 x 또는 y축 인스턴스에 전달하십시오. 관련 방법은 다음과 같습니다.

ax.xaxis.set_major_locator(xmajor_locator)
ax.xaxis.set_minor_locator(xminor_locator)
ax.yaxis.set_major_locator(ymajor_locator)
ax.yaxis.set_minor_locator(yminor_locator)

기본 마이너 로케이터는 기본적으로 NullLocator마이너 틱이 없습니다.

메모

Locator인스턴스는 둘 이상의 Axis또는 와 함께 사용하면 안 됩니다 Axes. 따라서 대신:

locator = MultipleLocator(5)
ax.xaxis.set_major_locator(locator)
ax2.xaxis.set_major_locator(locator)

대신 다음을 수행하십시오.

ax.xaxis.set_major_locator(MultipleLocator(5))
ax2.xaxis.set_major_locator(MultipleLocator(5))

틱 서식

눈금 서식은 Formatter에서 파생된 클래스에 의해 제어됩니다. 포맷터는 단일 눈금 값에서 작동하고 축에 문자열을 반환합니다.

NullFormatter	진드기에 라벨이 없습니다.
FixedFormatter	레이블에 대한 문자열을 수동으로 설정합니다.
FuncFormatter	사용자 정의 함수는 레이블을 설정합니다.
StrMethodFormatter	문자열 format방식을 사용합니다.
FormatStrFormatter	이전 스타일의 sprintf 형식 문자열을 사용하십시오.
ScalarFormatter	스칼라의 기본 포맷터: 포맷 문자열을 자동으로 선택합니다.
LogFormatter	로그 축의 포매터.
LogFormatterExponent	를 사용하여 로그 축의 값을 포맷합니다 .exponent = log_base(value)
LogFormatterMathtext	수학 텍스트 를 사용하여 로그 축의 값을 포맷합니다 .exponent = log_base(value)
LogFormatterSciNotation	과학적 표기법을 사용하여 로그 축의 값을 포맷합니다.
LogitFormatter	확률 포맷터.
EngFormatter	엔지니어링 표기법으로 라벨을 포맷합니다.
PercentFormatter	레이블 형식을 백분율로 지정합니다.

__call__단순히 메서드 를 재정의하여 Formatter 기본 클래스에서 고유한 포맷터를 파생시킬 수 있습니다 . 포맷터 클래스는 축 보기 및 데이터 제한에 액세스할 수 있습니다.

메이저 및 마이너 눈금 레이블 형식을 제어하려면 다음 방법 중 하나를 사용하십시오.

ax.xaxis.set_major_formatter(xmajor_formatter)
ax.xaxis.set_minor_formatter(xminor_formatter)
ax.yaxis.set_major_formatter(ymajor_formatter)
ax.yaxis.set_minor_formatter(yminor_formatter)

Formatter인스턴스 외에도 a set_major_formatter또는 함수 set_minor_formatter도 허용 합니다. 입력은 내부적으로 입력 으로 자동 생성된 것으로 대체됩니다 . 함수 입력 의 경우 입력 함수가 있는 a를 생성하여 사용합니다.strstrStrMethodFormatterstrFuncFormatter

메이저 및 마이너 틱 설정의 예는 메이저 및 마이너 틱을 참조하십시오 . matplotlib.dates날짜 로케이터 및 포맷터 사용에 대한 자세한 내용과 예제는 모듈을 참조하십시오 .

클래스 matplotlib.ticker. AsinhLocator ( linear_width , numticks = 11 , symthresh = 0.2 , base = 10 , subs = None )

베이스:Locator

inverse-sinh 스케일에 특화된 axis tick locator

AsinhScale클래스 이외의 용도로는 거의 사용되지 않습니다 .

메모

이 API는 잠정적이며 초기 사용자 피드백에 따라 향후 수정될 수 있습니다.

매개변수 :

linear_width 부동

준선형 영역의 범위를 정의하는 축척 매개변수입니다.

numticks int, 기본값: 11

전체 축에 맞는 대략적인 주요 눈금 수

symthresh float, 기본값: 0.2

0에 대해 대략적으로 대칭인 범위를 포함하는 데이터가 정확히 대칭인 눈금이 있는 분수 임계값 아래에 있습니다.

기본 정수, 기본값: 10

눈금 위치를 로그 눈금으로 반올림하는 데 사용되는 숫자 기준입니다. 이것이 1보다 작으면 10의 거듭제곱에 가장 가까운 정수 배수로 반올림됩니다.

subs 튜플, 기본값: 없음

기본이 10인 경우 예를 들어 (2, 5)와 같이 작은 눈금에 일반적으로 사용되는 숫자 밑의 배수입니다.

set_params ( numticks = 없음 , symthresh = 없음 , base = 없음 , subs = 없음 )

이 로케이터 내에서 매개변수를 설정합니다.

tick_values ​​( vmin , vmax )

주어진 vmin 및 vmax 에서 찾은 틱의 값을 반환합니다 .

메모

관련 항목에 대해 자동으로 정의된 vmin 및 vmax 값으로 틱 위치를 얻으려면 axisLocator 인스턴스를 호출하기만 하면 됩니다.

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

클래스 matplotlib.ticker. AutoLocator

베이스:MaxNLocator

주요 틱 위치를 동적으로 찾습니다. 이것은 실제로 nbins = 'auto' 및 steps = [1, 2, 2.5, 5, 10]MaxNLocator 매개변수 가 있는 의 하위 클래스입니다 .

비공개 매개변수의 값을 알려면 기본값인 를 살펴보십시오 MaxNLocator.

클래스 matplotlib.ticker. AutoMinorLocator ( n = 없음 )

베이스:Locator

주요 틱의 위치를 ​​기반으로 작은 틱 위치를 동적으로 찾습니다. 축척은 주요 눈금이 균일한 간격으로 선형이어야 합니다.

n 은 주 눈금 사이의 간격을 세분화한 수입니다. 예를 들어, n=2는 메이저 틱 사이의 중간에 단일 마이너 틱을 배치합니다.

n 이 생략되거나 None이면 5 또는 4로 설정됩니다 .

tick_values ​​( vmin , vmax )

주어진 vmin 및 vmax 에서 찾은 틱의 값을 반환합니다 .

메모

관련 항목에 대해 자동으로 정의된 vmin 및 vmax 값으로 틱 위치를 얻으려면 axisLocator 인스턴스를 호출하기만 하면 됩니다.

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

클래스 matplotlib.ticker. EngFormatter ( 단위 = '' , 장소 = 없음 , sep = ' ' , * , usetex = 없음 , useMathText = 없음 )

베이스:Formatter

1000의 거듭제곱과 지정된 단위(예: 1e7 대신 10MHz)를 나타내는 엔지니어링 접두사를 사용하여 축 값의 형식을 지정합니다.

매개변수 :

단위 문자열, 기본값: ""

사용할 단위 기호로, 1000의 거듭제곱을 한 글자로 표현하는 데 적합합니다. 예: 'Hz' 또는 'm'.

장소 int, 기본값: 없음

숫자를 표시할 정밀도로, 소수점 이하 숫자로 지정됩니다(소수점 앞에 1~3자리가 있음). None이면 형식은 최대 6개의 유효 숫자를 표시하는 부동 소수점 형식 '%g'로 돌아갑니다. 즉, 자릿수 에 해당하는 값 은 0에서 5(포함) 사이입니다.

9월 문자열, 기본값: " "

값과 접두사/단위 사이에 사용되는 구분 기호입니다. 예를 들어 sep" "(기본값)인 경우 '3.14mV'를 얻고 sep""인 경우 '3.14mV'를 얻습니다. 기본 동작 외에 다른 유용한 옵션은 다음과 같습니다.

• sep=""접두사/단위를 값에 직접 추가합니다.

• sep="\N{THIN SPACE}"( U+2009);

• sep="\N{NARROW NO-BREAK SPACE}"( U+202F);

• sep="\N{NO-BREAK SPACE}"( U+00A0).

유텍스 부울, 기본값: rcParams["text.usetex"](기본값: False)

포맷터에서 숫자를 렌더링하기 위해 TeX의 수학 모드 사용을 활성화/비활성화합니다.

useMathText 부울, 기본값: rcParams["axes.formatter.use_mathtext"](기본값: False)

포맷터에서 숫자를 렌더링하기 위해 mathtext 사용을 활성화/비활성화합니다.

ENG_PREFIXES = {-24: 'y', -21: 'z', -18: 'a', -15: 'f', -12: 'p', -9: 'n', -6: 'µ ', -3: 'm', 0: '', 3: 'k', 6: 'M', 9: 'G', 12: 'T', 15: 'P', 18: 'E', 21: '지', 24: '와이'}

format_eng ( 숫자 )

원래 숫자의 1000제곱을 나타내는 문자를 추가하여 공학 표기법으로 숫자의 서식을 지정합니다. 몇 가지 예:

>>> format_eng(0)        # for self.places = 0
'0'

>>> format_eng(1000000)  # for self.places = 1
'1.0 M'

>>> format_eng("-1e-6")  # for self.places = 2
'-1.00 µ'

get_useMathText ( )

get_usetex ( )

set_useMathText ( val )

set_usetex ( val )

속성 useMathText

속성 usetex

클래스 matplotlib.ticker. FixedFormatter ( seq )

베이스:Formatter

값이 아닌 위치만을 기준으로 눈금 레이블에 대한 고정 문자열을 반환합니다.

메모

FixedFormatter와 함께만 사용해야 합니다 FixedLocator. 그렇지 않으면 레이블이 예기치 않은 위치에 놓일 수 있습니다.

레이블에 사용할 문자열 의 시퀀스 seq 를 설정합니다.

get_offset ( )

set_offset_string ( ofs )

클래스 matplotlib.ticker. FixedLocator ( locs , nbins = 없음 )

베이스:Locator

틱 위치는 고정되어 있습니다. nbins가 None이 아닌 경우 가능한 위치의 배열은 틱 <= nbins +1 수를 유지하기 위해 서브샘플링됩니다. 가장 작은 절대값을 포함하도록 서브샘플링이 수행됩니다. 예를 들어 가능성의 배열에 0이 포함되어 있으면 선택한 틱 중 하나임을 보장합니다.

set_params ( nbins = 없음 )

이 로케이터 내에서 매개변수를 설정합니다.

tick_values ​​( vmin , vmax )

진드기의 위치를 ​​반환합니다.

메모

값이 고정되어 있으므로 이 방법에서는 vmin 및 vmax를 사용하지 않습니다.

클래스 matplotlib.ticker. FormatStrFormatter ( fmt )

베이스:Formatter

이전 스타일('%' 연산자) 형식 문자열을 사용하여 눈금의 형식을 지정합니다.

형식 문자열에는 단일 변수 형식(%)이 있어야 합니다. 눈금의 값(위치가 아님)에 적용됩니다.

음수 값은 유니코드 마이너스가 아닌 대시를 사용합니다. 형식 지정자를 $로 래핑하여 유니코드 빼기를 얻으려면 mathtext를 사용하십시오(예: "$%g$").

클래스 matplotlib.ticker. 포매터

베이스:TickHelper

눈금 값과 위치를 기반으로 문자열을 만듭니다.

static fix_minus ( s )

일부 클래스는 인쇄상의 정확성을 위해 마이너스에 대한 하이픈을 적절한 유니코드 기호(U+2212)로 대체할 수 있습니다. rcParams["axes.unicode_minus"]이는 (기본값: ) 을 통해 활성화될 때 이러한 교체를 수행하는 도우미 메서드 True입니다.

format_data ( 값 )

위치가 지정되지 않은 값의 전체 문자열 표현을 반환합니다.

format_data_short ( 값 )

눈금 값의 짧은 문자열 버전을 반환합니다.

위치 독립적인 긴 값이 기본값입니다.

format_ticks ( 값 )

모든 눈금에 대한 눈금 레이블을 한 번에 반환합니다.

get_offset ( )

위치 = []

set_locs ( locs )

눈금 위치를 설정합니다.

일부 포맷터는 그렇게 하기 위해 모든 눈금 위치를 알아야 하기 때문에 눈금 레이블을 계산하기 전에 이 메서드를 호출합니다.

클래스 matplotlib.ticker. FuncFormatter ( func )

베이스:Formatter

서식 지정을 위해 사용자 정의 함수를 사용하십시오.

이 함수는 두 개의 입력(눈금 값 x및 위치 pos)을 받고 해당 눈금 레이블이 포함된 문자열을 반환해야 합니다.

get_offset ( )

set_offset_string ( ofs )

클래스 matplotlib.ticker. IndexLocator ( 베이스 , 오프셋 )

베이스:Locator

예를 들어, 5번째 포인트마다 플롯된 몇 가지 기본 포인트 수의 모든 배수에 체크 표시를 합니다. 인덱스 플로팅을 수행한다고 가정합니다. 즉, 축은 0, len(data)입니다. 이것은 주로 x 틱에 유용합니다.

offset 에서 시작하여 모든 기본 데이터 포인트에 틱 을 배치합니다 .

set_params ( 기본 = 없음 , 오프셋 = 없음 )

이 로케이터 내에서 매개변수 설정

tick_values ​​( vmin , vmax )

주어진 vmin 및 vmax 에서 찾은 틱의 값을 반환합니다 .

메모

관련 항목에 대해 자동으로 정의된 vmin 및 vmax 값으로 틱 위치를 얻으려면 axisLocator 인스턴스를 호출하기만 하면 됩니다.

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

클래스 matplotlib.ticker. LinearLocator ( numticks = 없음 , 사전 설정 = 없음 )

베이스:Locator

진드기 위치 결정

이 함수가 처음 호출되면 멋진 틱 분할을 만들기 위해 틱 수를 설정하려고 시도합니다. 그 이후에는 대화식 탐색이 원활하도록 틱 수가 고정됩니다.

사전 설정을 사용하여 lom을 기반으로 위치를 설정합니다. 사전 매핑 vmin, vmax->locs

속성 숫자 기호

set_params ( numticks = 없음 , 사전 설정 = 없음 )

이 로케이터 내에서 매개변수를 설정합니다.

tick_values ​​( vmin , vmax )

주어진 vmin 및 vmax 에서 찾은 틱의 값을 반환합니다 .

메모

관련 항목에 대해 자동으로 정의된 vmin 및 vmax 값으로 틱 위치를 얻으려면 axisLocator 인스턴스를 호출하기만 하면 됩니다.

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( vmin , vmax )

보기 제한을 지능적으로 선택하십시오.

클래스 matplotlib.ticker. 로케이터

베이스:TickHelper

진드기 위치를 결정합니다.

Axis로케이터는 Axis 데이터 및 보기 제한에 대한 참조를 저장하기 때문에 동일한 로케이터를 여러 개에서 사용해서는 안 됩니다.

MAXTICKS = 1000

비특이 ( v0 , v1 )

특이점을 피하기 위해 필요에 따라 범위를 조정합니다.

이 메서드는 축에 데이터가 포함되어 있거나 포함되어 있지 않은 경우 축의 데이터 제한으로 설정되어 자동 크기 조정 중에 호출됩니다 .(v0, v1)(-inf, +inf)

• (아마도 일부 부동 소수점 기울기까지) 경우 이 메서드는 이 값 주변의 확장된 간격을 반환합니다 .v0 == v1

• 인 경우 이 메서드는 적절한 기본 보기 제한을 반환합니다.(v0, v1) == (-inf, +inf)

• 그렇지 않으면 수정 없이 반환됩니다.(v0, v1)

raise_if_exceeds ( locs )

locs 가 보다 긴 경우 WARNING 수준에서 기록합니다 Locator.MAXTICKS.

이것은 로케이터가 엄청난 수의 틱을 반환하여 Matplotlib의 메모리 부족을 유발하는 경우 사용자에게 알리기 위해 locs 를 반환하기 직전에 호출하기 위한 것 입니다.__call__

이 메서드의 "이상한" 이름은 로그를 내보내는 대신 예외를 발생시키던 때로 거슬러 올라갑니다.

set_params ( ** kwargs )

아무 조치도 취하지 않고 경고를 표시합니다. set_params() 함수를 지원하지 않는 모든 로케이터 클래스는 이것을 호출합니다.

tick_values ​​( vmin , vmax )

주어진 vmin 및 vmax 에서 찾은 틱의 값을 반환합니다 .

메모

관련 항목에 대해 자동으로 정의된 vmin 및 vmax 값으로 틱 위치를 얻으려면 axisLocator 인스턴스를 호출하기만 하면 됩니다.

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( vmin , vmax )

vmin에서 vmax까지의 범위에 대한 척도를 선택합니다.

하위 클래스는 이 메서드를 재정의하여 로케이터 동작을 변경해야 합니다.

클래스 matplotlib.ticker. LogFormatter ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None )

베이스:Formatter

로그 또는 symlog 척도에서 눈금 서식을 지정하기 위한 기본 클래스입니다.

직접 인스턴스화하거나 서브클래싱할 수 있습니다.

매개변수 :

기본 부동 소수점, 기본값: 10.

모든 계산에 사용되는 로그의 밑.

labelOnlyBase 부울, 기본값: False

True인 경우 레이블은 밑의 정수 거듭제곱에서만 틱합니다. 이것은 일반적으로 주요 틱의 경우 True이고 작은 틱의 경우 False입니다.

minor_thresholds (하위 집합, 모두), 기본값: (1, 0.4)

labelOnlyBase가 False인 경우 이 두 숫자는 밑의 정수 거듭제곱이 아닌 눈금의 레이블 지정을 제어합니다. 일반적으로 이들은 작은 진드기입니다. 제어 매개변수는 축 데이터 범위의 로그입니다. 기본이 10인 일반적인 경우에는 축에 걸쳐 있는 십진수이므로 'numdec'이라고 부를 수 있습니다. 이면 모든 작은 눈금에 레이블이 지정됩니다. 이면 붐비는 것을 방지하기 위해 사소한 진드기의 하위 집합에만 레이블이 지정됩니다. 그렇다면 사소한 진드기에 레이블이 지정되지 않습니다.numdec <= allall < numdec <= subsetnumdec > subset

linthresh 없음 또는 부동, 기본값: 없음

대칭 로그 척도를 사용 중인 경우 해당 linthresh 매개변수를 여기에 제공해야 합니다.

메모

매개 변수에 의해 제어 되는 set_locs부분 집합 논리를 활성화하려면 메서드를 호출해야 합니다 minor_thresholds.

색상 막대와 같은 일부 경우에는 주 눈금과 보조 눈금이 구분되지 않습니다. 틱 위치는 수동으로 설정하거나 기본 및 중간 위치의 정수 거듭제곱에 틱을 배치하는 로케이터에 의해 설정될 수 있습니다. 이 상황에서는 를 사용하여 minor_thresholds 논리를 비활성화하여 모든 눈금에 레이블이 지정되도록 합니다.minor_thresholds=(np.inf, np.inf)

'labelOnlyBase'가 False일 때 작은 눈금의 레이블 지정을 비활성화하려면 를 사용 하십시오. 이것은 "클래식" 스타일의 기본값입니다.minor_thresholds=(0, 0)

예

보기 제한이 최대 20개까지 확장되고 모든 눈금이 0.50개 이하로 확대될 때 작은 눈금의 하위 집합에 레이블을 지정하려면 를 사용 합니다.minor_thresholds=(2, 0.5)

보기 제한이 최대 1.50년 범위일 때 모든 작은 눈금에 레이블을 지정하려면 를 사용 하십시오.minor_thresholds=(1.5, 1.5)

베이스 ( 베이스 )

[ Deprecated ] 레이블 지정 기준 을 변경합니다.

경고

에 사용된 베이스와 항상 일치해야 합니다.LogLocator

메모

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

format_data ( 값 )

위치가 지정되지 않은 값의 전체 문자열 표현을 반환합니다.

format_data_short ( 값 )

눈금 값의 짧은 문자열 버전을 반환합니다.

위치 독립적인 긴 값이 기본값입니다.

label_minor ( labelOnlyBase )

[ Deprecated ] 작은 눈금 레이블 지정을 켜거나 끕니다.

매개변수 :

labelOnlyBase 부울

True인 경우 레이블은 밑의 정수 거듭제곱에서만 틱합니다.

메모

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

set_base ( 기초 )

라벨링 기준 을 변경합니다 .

경고

에 사용된 베이스와 항상 일치해야 합니다.LogLocator

set_label_minor ( labelOnlyBase )

사소한 진드기 라벨링을 켜거나 끕니다.

매개변수 :

labelOnlyBase 부울

True인 경우 레이블은 밑의 정수 거듭제곱에서만 틱합니다.

set_locs ( locs = 없음 )

축 보기 제한을 사용하여 레이블이 지정되는 눈금을 제어합니다.

locs 매개변수 는 현재 알고리즘에서 무시됩니다.

클래스 matplotlib.ticker. LogFormatterExponent ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None )

베이스:LogFormatter

를 사용하여 로그 축의 값을 포맷합니다 .exponent = log_base(value)

클래스 matplotlib.ticker. LogFormatterMathtext ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None )

베이스:LogFormatter

를 사용하여 로그 축의 값을 포맷합니다 .exponent = log_base(value)

클래스 matplotlib.ticker. LogFormatterSciNotation ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None )

베이스:LogFormatterMathtext

로그 축에서 과학적 표기법을 따르는 값의 서식을 지정합니다.

클래스 matplotlib.ticker. LogLocator ( base = 10.0 , subs = (1.0,) , numdecs = 4 , numticks = None )

베이스:Locator

로그 축의 눈금 위치 결정

위치에 틱 표시: subs[j] * base**i

매개변수 :

기본 부동, 기본값: 10.0

사용된 로그의 기준이므로 주요 눈금은 base**nn 정수에 배치됩니다.

subs None 또는 str 또는 float 시퀀스, 기본값: (1.0,)

진드기를 배치할 기준의 배수 정수 거듭제곱을 제공합니다. 기본 장소는 밑의 정수 거듭제곱에서만 틱합니다. 허용되는 문자열 값은 'auto'및 'all'이며 둘 다 축 보기 제한을 기반으로 하는 알고리즘을 사용하여 밑의 정수 거듭제곱 사이에 눈금을 넣을지 여부와 방법을 결정합니다. 를 사용 'auto'하면 눈금은 정수 거듭제곱 사이에만 배치됩니다. 로 'all'정수 거듭제곱이 포함됩니다. 없음 값은 와 같습니다 'auto'.

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

지정된 축에서 허용할 최대 틱 수입니다. 기본값은 None이 로케이터가 이미 를 사용하여 축에 할당되어 있는 한 지능적으로 선택하려고 시도 get_tick_space하지만 그렇지 않으면 9로 돌아갑니다.

베이스 ( 베이스 )

[ Deprecated ] 로그 기준을 설정합니다(major tick every base**i, i integer).

메모

버전 3.6부터 폐지: 대신 set_params(base=...) 를 사용하십시오.

비 특이 ( vmin , vmax )

특이점을 피하기 위해 필요에 따라 범위를 조정합니다.

이 메서드는 축에 데이터가 포함되어 있거나 포함되어 있지 않은 경우 축의 데이터 제한으로 설정되어 자동 크기 조정 중에 호출됩니다 .(v0, v1)(-inf, +inf)

• (아마도 일부 부동 소수점 기울기까지) 경우 이 메서드는 이 값 주변의 확장된 간격을 반환합니다 .v0 == v1

• 인 경우 이 메서드는 적절한 기본 보기 제한을 반환합니다.(v0, v1) == (-inf, +inf)

• 그렇지 않으면 수정 없이 반환됩니다.(v0, v1)

set_params ( base = 없음 , subs = 없음 , numdecs = 없음 , numticks = 없음 )

이 로케이터 내에서 매개변수를 설정합니다.

서브 ( 서브 )

[ Deprecated ] 로그 스케일링 주기에 대한 마이너 틱을 설정합니다 base**i*subs[j].

메모

버전 3.6부터 폐지: 대신 set_params(subs=...) 를 사용하십시오.

tick_values ​​( vmin , vmax )

주어진 vmin 및 vmax 에서 찾은 틱의 값을 반환합니다 .

메모

관련 항목에 대해 자동으로 정의된 vmin 및 vmax 값으로 틱 위치를 얻으려면 axisLocator 인스턴스를 호출하기만 하면 됩니다.

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( vmin , vmax )

보기 제한을 지능적으로 선택하십시오.

클래스 matplotlib.ticker. LogitFormatter ( * , use_overline = False , one_half = '\\frac{1}{2}' , minor = False , minor_threshold = 25 , minor_number = 6 )

베이스:Formatter

확률 포맷터(수학 텍스트 사용).

매개변수 :

use_overline 부울, 기본값: 거짓

x > 1/2이고 x = 1-v인 경우 x를 $overline{v}$로 표시해야 하는지 여부를 나타냅니다. 기본값은 $1-v$를 표시하는 것입니다.

one_half str, 기본값: r"frac{1}{2}"

1/2을 나타내는 데 사용되는 문자열입니다.

마이너 부울, 기본값: False

포맷터가 작은 눈금을 포맷하는지 여부를 나타냅니다. 기본적으로 작은 틱은 레이블이 지정되지 않습니다. 단, 소수의 틱만 제공되는 경우를 제외하고는 이웃 틱이 있는 대부분의 공간이 있는 틱에 레이블이 지정됩니다. 기본 동작을 변경하려면 다른 매개변수를 참조하십시오.

minor_threshold int, 기본값: 25

일부 사소한 진드기에 레이블을 지정하기 위한 최대 loc 수입니다. 이 매개변수는 minor가 False인 경우 영향을 미치지 않습니다.

minor_number int, 기본값: 6

틱 수가 임계값 미만일 때 레이블이 지정되는 틱 수입니다.

format_data_short ( 값 )

눈금 값의 짧은 문자열 버전을 반환합니다.

위치 독립적인 긴 값이 기본값입니다.

set_locs ( locs )

눈금 위치를 설정합니다.

일부 포맷터는 그렇게 하기 위해 모든 눈금 위치를 알아야 하기 때문에 눈금 레이블을 계산하기 전에 이 메서드를 호출합니다.

set_minor_number ( minor_number )

일부 작은 눈금에 레이블을 지정할 때 레이블을 지정할 작은 눈금 수를 설정합니다.

매개변수 :

minor_number int

틱 수가 임계값 미만일 때 레이블이 지정되는 틱 수입니다.

set_minor_threshold ( minor_threshold )

미성년자 진드기에 레이블을 지정하기 위한 임계값을 설정합니다.

매개변수 :

minor_threshold int

일부 사소한 진드기에 레이블을 지정하기 위한 최대 위치 수입니다. 이 매개변수는 minor가 False인 경우 영향을 미치지 않습니다.

set_one_half ( one_half )

절반이 표시되는 방식을 설정합니다.

one_half str, 기본값: r"frac{1}{2}"

1/2을 나타내는 데 사용되는 문자열입니다.

use_overline ( use_overline )

p>1/2 라벨링을 위해 오버라인으로 디스플레이 모드를 전환합니다.

매개변수 :

use_overline 부울, 기본값: 거짓

x > 1/2이고 x = 1-v인 경우 x를 $overline{v}$로 표시해야 하는지 여부를 나타냅니다. 기본값은 $1-v$를 표시하는 것입니다.

클래스 matplotlib.ticker. LogitLocator ( minor = False , * , nbins = 'auto' )

베이스:MaxNLocator

로짓 축의 눈금 위치 결정

로짓 위치에 틱 표시

매개변수 :

nbins int 또는 'auto', 선택 사항

틱 수. minor가 False인 경우에만 사용됩니다.

마이너 부울, 기본값: False

이 로케이터가 작은 진드기용인지 여부를 나타냅니다.

재산 미성년자

비 특이 ( vmin , vmax )

특이점을 피하기 위해 필요에 따라 범위를 조정합니다.

이 메서드는 축에 데이터가 포함되어 있거나 포함되어 있지 않은 경우 축의 데이터 제한으로 설정되어 자동 크기 조정 중에 호출됩니다 .(v0, v1)(-inf, +inf)

• (아마도 일부 부동 소수점 기울기까지) 경우 이 메서드는 이 값 주변의 확장된 간격을 반환합니다 .v0 == v1

• 인 경우 이 메서드는 적절한 기본 보기 제한을 반환합니다.(v0, v1) == (-inf, +inf)

• 그렇지 않으면 수정 없이 반환됩니다.(v0, v1)

set_params ( 미성년자 = 없음 , ** kwargs )

이 로케이터 내에서 매개변수를 설정합니다.

tick_values ​​( vmin , vmax )

주어진 vmin 및 vmax 에서 찾은 틱의 값을 반환합니다 .

메모

관련 항목에 대해 자동으로 정의된 vmin 및 vmax 값으로 틱 위치를 얻으려면 axisLocator 인스턴스를 호출하기만 하면 됩니다.

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

클래스 matplotlib.ticker. MaxNLocator ( nbins = None , ** kwargs )

베이스:Locator

보기 제한 내에 있는 N개 이하의 멋진 눈금 위치를 찾으십시오. 자동 크기 조정을 지원하기 위해 한도를 초과하는 위치가 추가됩니다.

매개변수 :

nbins int 또는 'auto', 기본값: 10

최대 간격 수 최대 틱 수보다 하나 적습니다. 문자열이 'auto'인 경우 빈의 수는 축의 길이에 따라 자동으로 결정됩니다.

단계 배열 유사, 선택 사항

1로 시작하여 10으로 끝나는 멋진 숫자 시퀀스; 예를 들어, [1, 2, 4, 5, 10], 여기서 값은 허용 가능한 틱 배수입니다. 예를 들어, 20, 40, 60은 0.4, 0.6, 0.8이 2의 배수이기 때문에 허용되는 틱 집합입니다. 그러나 30, 60, 90은 3이 표시되지 않기 때문에 허용되지 않습니다. 단계 목록.

정수 부울, 기본값: False

True인 경우 최소 min_n_ticks 정수가 보기 제한 내에서 발견 되면 틱은 정수 값만 사용 합니다.

대칭 부울, 기본값: False

True인 경우 자동 크기 조정은 0에 대한 대칭 범위가 됩니다.

prune {'lower', 'upper', 'both', None}, 기본값: 없음

rcParams["axes.autolimit_mode"]가장자리 눈금 제거 - 주로 (기본값: 'data')이 인 경우 한 축의 위쪽 눈금이 그 위에 있는 축의 아래쪽 눈금과 겹치는 누적 또는 집단 플롯에 유용합니다 'round_numbers'. 이면 prune=='lower'가장 작은 눈금이 제거됩니다. 이면 가장 큰 눈금이 제거됩니다. 이면 가장 큰 틱과 가장 작은 틱이 제거됩니다. prune 이 None 이면 틱이 제거되지 않습니다.prune == 'upper'prune == 'both'

min_n_ticks int, 기본값: 2

이 최소 틱 수를 얻기 위해 필요한 경우 nbins 및 정수 제약 조건 을 완화 합니다 .

default_params = {'integer': False, 'min_n_ticks': 2, 'nbins': 10, 'prune': 없음, 'steps': 없음, 'symmetric': False}

set_params ( ** kwargs )

이 로케이터에 대한 매개변수를 설정합니다.

매개변수 :

nbins int 또는 'auto', 선택 사항

보다MaxNLocator

단계 배열 유사, 선택 사항

보다MaxNLocator

정수 부울, 선택 사항

보다MaxNLocator

대칭 부울, 선택 사항

보다MaxNLocator

자두 {'lower', 'upper', 'both', None}, 선택 사항

보다MaxNLocator

min_n_ticks 정수, 선택 사항

보다MaxNLocator

tick_values ​​( vmin , vmax )

주어진 vmin 및 vmax 에서 찾은 틱의 값을 반환합니다 .

메모

관련 항목에 대해 자동으로 정의된 vmin 및 vmax 값으로 틱 위치를 얻으려면 axisLocator 인스턴스를 호출하기만 하면 됩니다.

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( dmin , dmax )

vmin에서 vmax까지의 범위에 대한 척도를 선택합니다.

하위 클래스는 이 메서드를 재정의하여 로케이터 동작을 변경해야 합니다.

클래스 matplotlib.ticker. MultipleLocator ( base = 1.0 )

베이스:Locator

보기 간격 내에서 기본의 각 정수 배수에 눈금을 설정합니다.

set_params ( 기본 )

이 로케이터 내에서 매개변수를 설정합니다.

tick_values ​​( vmin , vmax )

주어진 vmin 및 vmax 에서 찾은 틱의 값을 반환합니다 .

메모

관련 항목에 대해 자동으로 정의된 vmin 및 vmax 값으로 틱 위치를 얻으려면 axisLocator 인스턴스를 호출하기만 하면 됩니다.

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( dmin , dmax )

데이터를 포함하는 기준의 가장 가까운 배수로 보기 제한을 설정합니다.

클래스 matplotlib.ticker. NullFormatter

베이스:Formatter

항상 빈 문자열을 반환합니다.

클래스 matplotlib.ticker. NullLocator

베이스:Locator

진드기 없음

tick_values ​​( vmin , vmax )

진드기의 위치를 ​​반환합니다.

메모

값이 Null이므로 vmin 및 vmax는 이 방법에서 사용되지 않습니다.

클래스 matplotlib.ticker. PercentFormatter ( xmax = 100 , 십진수 = 없음 , 기호 = '%' , is_latex = False )

베이스:Formatter

숫자를 백분율로 표시합니다.

매개변수 :

xmax 플로트

숫자를 백분율로 변환하는 방법을 결정합니다. xmax 는 100%에 해당하는 데이터 값입니다. 백분율은 로 계산됩니다 . 따라서 데이터가 이미 백분율로 조정된 경우 xmax 는 100이 됩니다. 또 다른 일반적인 상황은 xmax 가 1.0인 경우입니다.x / xmax * 100

10진수 None 또는 int

점 뒤에 배치할 소수 자릿수입니다. None (기본값) 이면 숫자가 자동으로 계산됩니다.

기호 str 또는 없음

레이블에 추가될 문자열입니다. 기호를 사용하지 않아야 함을 나타내기 위해 None 또는 비어 있을 수 있습니다 . LaTeX 특수 문자는 is_latex 가 True 가 아닌 한 라텍스 모드가 활성화될 때마다 기호 로 이스케이프됩니다 .

is_latex 부울

False 이면 기호 의 예약된 LaTeX 문자 가 이스케이프됩니다.

convert_to_pct ( x )

format_pct ( x , display_range )

올바른 소수점 이하 자릿수를 사용하여 숫자 형식을 백분율로 지정하고 백분율 기호(있는 경우)를 추가합니다.

이면 축의 display_range 를 기준으로 다음과 같이 소수점 이하 자릿수가 설정 self.decimals됩니다 .None

디스플레이 범위	소수	견본
>50	0	x = 34.5=> 35%
>5	1	x = 34.5=> 34.5%
>0.5	2	x = 34.5=> 34.50%
...	...	...

이 방법은 작은 축 범위나 매우 큰 축 범위에는 적합하지 않습니다. 차트의 값이 합리적인 배율로 표시되는 백분율이라고 가정합니다.

속성 기호

문자열로 구성된 백분율 기호입니다.

rcParams["text.usetex"](기본값: ) 을 통해 LaTeX를 활성화 하면 문자열에서 False특수 문자 가 자동으로 이스케이프됩니다.{'#', '$', '%', '&', '~', '_', '^', '\', '{', '}'}

클래스 matplotlib.ticker. ScalarFormatter ( useOffset = None , useMathText = None , useLocale = None )

베이스:Formatter

눈금 값을 숫자 형식으로 지정합니다.

매개변수 :

useOffset bool 또는 float, 기본값: rcParams["axes.formatter.useoffset"](기본값: True)

오프셋 표기를 사용할지 여부입니다. 참조하십시오 set_useOffset.

useMathText 부울, 기본값: rcParams["axes.formatter.use_mathtext"](기본값: False)

멋진 수학 서식을 사용할지 여부입니다. 참조하십시오 set_useMathText.

useLocale 부울, 기본값: rcParams["axes.formatter.use_locale"](기본값: False).

소수점 기호 및 양수 기호에 대한 로케일 설정 사용 여부입니다. 참조하십시오 set_useLocale.

메모

위의 매개변수 외에도 과학 대 부동 소수점 표현의 형식은 set_scientific 및 set_powerlimits)를 통해 구성할 수 있습니다.

오프셋 표기법 및 과학적 표기법

오프셋 표기법과 과학적 표기법은 언뜻 보기에 꽤 비슷해 보입니다. 둘 다 형식이 지정된 눈금 값에서 일부 정보를 분할하여 축 끝에 표시합니다.

• 과학적 표기법은 크기의 차수, 즉 승법 배율 인수를 나눕니다. 예를 들어 1e6.

• 오프셋 표기법은 예를 들어 가산 상수를 구분합니다 +1e6. 오프셋 표기 레이블은 항상 접두사 +또는 -기호가 붙기 때문에 크기 레이블의 차수 레이블과 구별할 수 있습니다.

x 제한이 있는 다음 플롯 은 다양한 형식 1_000_000을 보여줍니다. 1_000_010x 축의 오른쪽 가장자리에 있는 레이블을 확인하십시오.

( 소스 코드 , png )

format_data ( 값 )

위치가 지정되지 않은 값의 전체 문자열 표현을 반환합니다.

format_data_short ( 값 )

눈금 값의 짧은 문자열 버전을 반환합니다.

위치 독립적인 긴 값이 기본값입니다.

get_offset ( )

과학 표기법과 오프셋을 반환합니다.

get_useLocale ( )

로케일 설정이 포맷에 사용되는지 여부를 반환합니다.

또한보십시오

ScalarFormatter.set_useLocale

get_useMathText ( )

멋진 수학 서식을 사용할지 여부를 반환합니다.

또한보십시오

ScalarFormatter.set_useMathText

get_useOffset ( )

오프셋 표기 자동 모드 활성화 여부를 반환합니다.

이것은 다음과 같은 경우 True를 반환합니다 set_useOffset(True). 예를 들어 명시적 오프셋이 설정된 경우 False를 반환합니다 set_useOffset(1000).

또한보십시오

ScalarFormatter.set_useOffset

set_locs ( locs )

눈금 위치를 설정합니다.

일부 포맷터는 그렇게 하기 위해 모든 눈금 위치를 알아야 하기 때문에 눈금 레이블을 계산하기 전에 이 메서드를 호출합니다.

set_powerlimits ( lims )

과학 표기법에 대한 크기 임계값을 설정합니다.

매개변수 :

림 (int, int)

전환 임계값을 결정하는 10의 거듭제곱을 포함하는 튜플 (min_exp, max_exp) 입니다. 다음과 같이 나타낼 수 있는 숫자의 경우 \(a \times 10^\mathrm{exp}\)~와 함께\(1 <= |a| < 10\), 과학적 표기법은 또는 인 경우에 사용됩니다 .exp <= min_expexp >= max_exp

기본 제한은 rcParams["axes.formatter.limits"](기본값: )에 의해 제어됩니다.[-5, 6]

특히 임계값과 동일한 exp 를 갖는 숫자는 과학적 표기법으로 작성됩니다.

일반적으로 min_exp 는 음수이고 max_exp 는 양수입니다.

예를 들어 다음 형식을 제공합니다. formatter.set_powerlimits((-3, 4))\(1 \times 10^{-3}, 9.9 \times 10^{-3}, 0.01,\) \(9999, 1 \times 10^4\).

또한보십시오

ScalarFormatter.set_scientific

set_scientific ( b )

과학 표기법을 켜거나 끕니다.

또한보십시오

ScalarFormatter.set_powerlimits

set_useLocale ( val )

소수점 기호 및 양수 기호에 대한 로케일 설정 사용 여부를 설정합니다.

매개변수 :

값 부울 또는 없음

없음rcParams["axes.formatter.use_locale"] 은 (기본값: )으로 재설정됩니다 False.

set_useMathText ( val )

멋진 수학 서식을 사용할지 여부를 설정합니다.

활성인 경우 과학 표기법은 다음과 같이 형식화됩니다.\(1.2 \times 10^3\).

매개변수 :

값 부울 또는 없음

없음rcParams["axes.formatter.use_mathtext"] 은 (기본값: )으로 재설정됩니다 False.

set_useOffset ( val )

오프셋 표기 사용 여부를 설정합니다.

범위에 비해 값이 큰 집합 숫자를 포맷할 때 포맷터는 가산 상수를 분리할 수 있습니다. 이렇게 하면 형식이 지정된 숫자가 축에 그려질 때 겹치지 않도록 줄일 수 있습니다.

매개변수 :

val bool 또는 float

• False인 경우 오프셋 표기법을 사용하지 마십시오.

• True(=자동 모드)인 경우 잔여 숫자를 상당히 짧게 만들 수 있는 경우 오프셋 표기법을 사용합니다. 정확한 동작은 rcParams["axes.formatter.offset_threshold"](기본값: 4)에 의해 제어됩니다.

• 숫자인 경우 지정된 값의 오프셋을 강제 적용합니다.

예

활성 오프셋 표기법을 사용하면 값이

100_000, 100_002, 100_004, 100_006, 100_008

축의 가장자리에 기록되는 더하기 오프셋 으로 형식이 지정됩니다 .0, 2, 4, 6, 8+1e5

속성 useLocale

로케일 설정이 포맷에 사용되는지 여부를 반환합니다.

또한보십시오

ScalarFormatter.set_useLocale

속성 useMathText

멋진 수학 서식을 사용할지 여부를 반환합니다.

또한보십시오

ScalarFormatter.set_useMathText

속성 useOffset

오프셋 표기 자동 모드 활성화 여부를 반환합니다.

이것은 다음과 같은 경우 True를 반환합니다 set_useOffset(True). 예를 들어 명시적 오프셋이 설정된 경우 False를 반환합니다 set_useOffset(1000).

또한보십시오

ScalarFormatter.set_useOffset

클래스 matplotlib.ticker. StrMethodFormatter ( fmt )

베이스:Formatter

새 스타일 형식 문자열( 에서 사용 str.format)을 사용하여 눈금의 형식을 지정합니다.

눈금 값에 사용되는 필드에는 x 레이블 이 지정되어야 하고 눈금 위치에 사용되는 필드에는 pos 레이블이 지정되어야 합니다 .

클래스 matplotlib.ticker. SymmetricalLogLocator ( transform = None , subs = None , linthresh = None , base = None )

베이스:Locator

대칭 로그 축의 눈금 위치를 결정합니다.

매개변수 :

변형 SymmetricalLogTransform, 선택 사항

설정된 경우 symlog 변환의 기본 및 linthresh 를 정의합니다.

기본, linthresh 플로트, 선택 사항

에 대해 문서화된 symlog 변환 의 기본 및 linthreshSymmetricalLogScale 입니다 . 이 매개변수는 변환 이 설정되지 않은 경우에만 사용됩니다 .

float의 subs 시퀀스, 기본값: [1]

틱이 배치되는 밑의 정수 거듭제곱의 배수, 즉 틱이 배치됩니다 .[sub * base**i for i in ... for sub in subs]

메모

transform 이나 base 와 linthresh 둘 다 지정 해야 합니다.

set_params ( subs = 없음 , numticks = 없음 )

이 로케이터 내에서 매개변수를 설정합니다.

tick_values ​​( vmin , vmax )

주어진 vmin 및 vmax 에서 찾은 틱의 값을 반환합니다 .

메모

관련 항목에 대해 자동으로 정의된 vmin 및 vmax 값으로 틱 위치를 얻으려면 axisLocator 인스턴스를 호출하기만 하면 됩니다.

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( vmin , vmax )

보기 제한을 지능적으로 선택하십시오.

클래스 matplotlib.ticker. TickHelper

베이스:object

축 = 없음

create_dummy_axis ( ** kwargs )

set_axis ( 축 )

set_bounds ( vmin , vmax )

[ 더 이상 사용되지 않음 ]

메모

버전 3.5부터 사용되지 않음:Axis.set_view_interval and Axis.set_data_interval를 대신 사용하십시오 .

set_data_interval ( vmin , vmax )

[ 더 이상 사용되지 않음 ]

메모

버전 3.5부터 사용되지 않음: 대신 사용하십시오 Axis.set_data_interval.

set_view_interval ( vmin , vmax )

[ 더 이상 사용되지 않음 ]

메모

버전 3.5부터 사용되지 않음: 대신 사용하십시오 Axis.set_view_interval.