Spec-Zone.ru › Matplotlib 1.5

ось

matplotlib.axis

Классы для делений и осей x и y

class matplotlib.axis.Axis(axes, pickradius=15)

Базы: matplotlib.artist.Artist

Общедоступные атрибуты

  • axes.transData - преобразование координат данных в координаты отображения
  • axes.transAxes - преобразование координат оси в координаты отображения
  • labelpad - количество точек между осью и её подписью

Инициализация оси с экземпляром родительского объекта Axes

OFFSETTEXTPAD = 3
axis_date(tz=None)

Настройка делений и подписей оси x, рассматривая данные x как даты. tz — экземпляр tzinfo или строка часового пояса. Этот часовой пояс используется для создания подписей дат.

cla()

очистить текущую ось

convert_units(x)
draw(artist, renderer, *args, **kwargs)

Отрисовка линий оси, линий сетки, делений и подписей

get_children()
get_data_interval()

возвращает экземпляр Interval для пределов данных этой оси

get_gridlines()

Возвращает линии сетки как список экземпляров Line2D

get_label()

Возвращает подпись оси как экземпляр Text

get_label_text()

Получить текст подписи

get_major_formatter()

Получить форматтер основного масштабирования

get_major_locator()

Получить локатор основного масштабирования

get_major_ticks(numticks=None)

получить экземпляры делений; увеличивать по мере необходимости

get_majorticklabels()

Возвращает список экземпляров Text для основных подписей делений

get_majorticklines()

Возвращает основные линии делений как список экземпляров Line2D

get_majorticklocs()

Получить расположения основных делений в координатах данных как массив numpy

get_minor_formatter()

Получить форматтер вспомогательного масштабирования

get_minor_locator()

Получить локатор вспомогательного масштабирования

get_minor_ticks(numticks=None)

получить экземпляры вспомогательных делений; увеличивать по мере необходимости

get_minorticklabels()

Возвращает список экземпляров Text для вспомогательных подписей делений

get_minorticklines()

Возвращает вспомогательные линии делений как список экземпляров Line2D

get_minorticklocs()

Получить расположения вспомогательных делений в координатах данных как массив numpy

get_offset_text()

Возвращает подпись смещения оси как экземпляр Text

get_pickradius()

Возвращает глубину оси, используемой для выбора

get_scale()
get_smart_bounds()

получить информацию о том, имеет ли ось интеллектуальные границы

get_ticklabel_extents(renderer)

Получить размеры подписей делений по обеим сторонам осей.

get_ticklabels(minor=False, which=None)

Получить метки делений оси x как список экземпляров Text.

Параметры:

minor : bool

Если True, возвращает вспомогательные метки делений, иначе возвращает основные метки делений

which : None, (‘minor’, ‘major’, ‘both’)

Переопределяет minor.

Выбирает, какие метки делений возвращать

Возвращает:

ret : список

Список экземпляров Text.

get_ticklines(minor=False)

Возвращает линии делений как список экземпляров Line2D

get_ticklocs(minor=False)

Получить расположения делений в координатах данных как массив numpy

get_tightbbox(renderer)

Возвращает область, которая включает ось. Она учитывает только метки делений, подпись оси и подпись смещения.

get_transform()
get_units()

возвращает единицы измерения для оси

get_view_interval()

возвращает экземпляр Interval для пределов отображения этой оси

grid(b=None, which='major', **kwargs)

Включить или выключить сетку оси; b — булево значение. Используйте which = ‘major’ | ‘minor’ | ‘both’, чтобы включить сетку для основных или вспомогательных делений.

Если b равно None и len(kwargs)==0, переключает состояние сетки. Если kwargs заданы, предполагается, что вы хотите включить сетку, и b будет установлено в True.

kwargs используются для настройки свойств линий сетки, например:

xax.grid(color=’r’, linestyle=’-‘, linewidth=2)
have_units()
iter_ticks()

Проходит по всем основным и вспомогательным делениям.

limit_range_for_scale(vmin, vmax)
pan(numsteps)

Перемещение на numsteps (может быть положительным или отрицательным)

reset_ticks()
set_clip_path(clippath, transform=None)
set_data_interval()

установить пределы данных оси

set_default_intervals()

установить значения по умолчанию для пределов данных и отображения оси, если они не были изменены

set_label_coords(x, y, transform=None)

Установить координаты подписи. По умолчанию координата x подписи по оси y определяется границами меток делений, но это может привести к плохому выравниванию нескольких подписей по оси y, если есть несколько осей. Аналогично для координаты y подписи по оси x.

Вы также можете указать систему координат подписи с помощью transform. Если None, то будет использоваться система координат осей (0,0) — (левый, нижний), (0,5, 0,5) — середина и т.д.

set_label_text(label, fontdict=None, **kwargs)

Устанавливает текстовое значение подписи оси

ПРИНИМАЕТ: Строковое значение для подписи

set_major_formatter(formatter)

Установить форматтер основного масштабирования

ПРИНИМАЕТ: Экземпляр Formatter

set_major_locator(locator)

Установить локатор основного масштабирования

ПРИНИМАЕТ: экземпляр Locator

set_minor_formatter(formatter)

Установить форматтер вспомогательного масштабирования

ПРИНИМАЕТ: Экземпляр Formatter

set_minor_locator(locator)

Установить локатор вспомогательного масштабирования

ПРИНИМАЕТ: Экземпляр Locator

set_pickradius(pickradius)

Установить глубину оси, используемой для выбора

ПРИНИМАЕТ: расстояние в пунктах

set_smart_bounds(value)

установить для оси интеллектуальные границы

set_tick_params(which='major', reset=False, **kw)

Установить параметры отображения делений и меток делений.

Документацию по ключевым аргументам см. в matplotlib.axes.Axes.tick_params().

END_OF_DOCUMENT_MARKER
set_ticklabels(ticklabels, *args, **kwargs)

Установите текстовые значения меток делений. Возвращает список объектов Text. Используйте kwarg minor=True для выбора мелких делений. Все остальные kwargs используются для обновления свойств объекта текста. Как и в случае с get_ticklabels, метка 1 (слева или снизу) изменяется для данного деления только в том случае, если его атрибут label1On равен True, и аналогично для метки 2. Список возвращаемых объектов текста меток содержит все такие объекты метки 1, за которыми следуют все такие объекты метки 2.

Входной параметр ticklabels предполагается соответствующим набору расположений делений, независимо от состояния label1On и label2On.

ПРИНИМАЕТ: последовательность строк или объектов Text

set_ticks(ticks, minor=False)

Устанавливает расположения делений по последовательности ticks.

ПРИНИМАЕТ: последовательность чисел с плавающей точкой

set_units(u)

установить единицы измерения для оси

ПРИНИМАЕТ: тег единиц измерения

set_view_interval(vmin, vmax, ignore=False)
update_units(data)

Проанализируйте data для поиска преобразователя единиц и обновите экземпляр axis.converter, если необходимо. Возвращает True, если data зарегистрирован для преобразования единиц.

zoom(direction)

Увеличить/уменьшить масштаб оси; если direction > 0, увеличить масштаб, иначе уменьшить.

class matplotlib.axis.Tick(axes, loc, label, size=None, width=None, color=None, tickdir=None, pad=None, labelsize=None, labelcolor=None, zorder=None, gridOn=None, tick1On=True, tick2On=True, label1On=True, label2On=False, major=True)

Базовый класс для меток делений, линий сетки и подписей оси

1 относится к нижней части графика для x-делений и левой для y-делений 2 относится к верхней части графика для x-делений и правой для y-делений

Доступные атрибуты:

tick1line
экземпляр Line2D
tick2line
экземпляр Line2D
gridline
экземпляр Line2D
label1
экземпляр Text
label2
экземпляр Text
gridOn
логическое значение, определяющее, рисовать ли линию деления
tick1On
логическое значение, определяющее, рисовать ли первую линию деления
tick2On
логическое значение, определяющее, рисовать ли вторую линию деления
label1On
логическое значение, определяющее, рисовать ли метку деления
label2On
логическое значение, определяющее, рисовать ли метку деления

bbox — прямоугольник, определяющий область деления в координатах отображения; loc — положение деления в координатах данных; size — размер деления в пунктах

apply_tickdir(tickdir)

Вычисление self._pad и self._tickmarkers

contains(mouseevent)

Проверка, произошла ли нажатие мыши на метках делений.

Эта функция всегда возвращает false. Более полезно проверить, содержит ли ось в целом нажатие мыши, а не набор меток делений.

draw(artist, renderer, *args, **kwargs)
get_children()
get_loc()

Возвращает положение деления (в координатах данных) как скаляр

get_pad()

Получение значения отступа метки деления в пунктах

get_pad_pixels()
get_view_interval()

Возвращает экземпляр Interval для оси, по которой отмечается данное деление.

set_clip_path(clippath, transform=None)

Установить область обрезки элемента. Это может быть:

  • экземпляр Patch (или подкласс)
  • a Path instance, in which case

    опциональный экземпляр Transform может быть предоставлен, который будет применён к пути перед использованием его для обрезки.

  • None для удаления области обрезки

Для эффективности, если путь оказывается прямоугольником, выровненным по осям, этот метод установит прямоугольник обрезки соответствующему прямоугольнику и установит clip_path равным None.

ПРИНИМАЕТ: [ (Path, Transform) | Patch | None ]

set_label(s)

Установить текст метки деления

ПРИНИМАЕТ: строка

set_label1(s)

Установить текст метки деления

ПРИНИМАЕТ: строка

set_label2(s)

Установить текст метки деления 2

ПРИНИМАЕТ: строка

set_pad(val)

Установить отступ метки деления в пунктах

ПРИНИМАЕТ: число с плавающей точкой

class matplotlib.axis.Ticker

Базовый класс object

formatter = None
locator = None
class matplotlib.axis.XAxis(axes, pickradius=15)

Базовый класс matplotlib.axis.Axis

Инициализация оси с экземпляром Axes

axis_name = 'x'
contains(mouseevent)

Проверка, произошла ли нажатие мыши на оси x.

get_data_interval()

Возвращает экземпляр Interval для пределов данных этой оси.

get_label_position()

Возвращает положение подписи (верх или низ).

get_minpos()
get_text_heights(renderer)

Возвращает количество места, которое следует зарезервировать для текста над и под осями. Возвращает кортеж (верх, низ).

get_ticks_position()

Возвращает положение делений (верх, низ, оба, по умолчанию или неизвестно).

get_view_interval()

Возвращает экземпляр Interval для пределов отображения этой оси.

set_data_interval(vmin, vmax, ignore=False)

Установка пределов данных для оси.

set_default_intervals()

Устанавливает пределы по умолчанию для интервала оси, если они не изменены.

set_label_position(position)

Установить положение подписи (верх или низ).

ПРИНИМАЕТ: [ ‘верх’ | ‘низ’ ]

set_ticks_position(position)

Установить положение делений (верх, низ, оба, по умолчанию или нет) оба устанавливает деления для отображения в обоих положениях, но не изменяет метки делений. «по умолчанию» сбрасывает положение делений к значениям по умолчанию: деления в обоих положениях, метки делений внизу. «нет» может быть использовано, если вы не хотите отображать какие-либо деления. «нет» и «оба» влияют только на деления, а не на метки.

ПРИНИМАЕТ: [ ‘верх’ | ‘низ’ | ‘оба’ | ‘по умолчанию’ | ‘нет’ ]

set_view_interval(vmin, vmax, ignore=False)

Если ignore — False, порядок vmin, vmax не имеет значения; исходная ориентация оси будет сохранена. Кроме того, пределы отображения могут быть расширены, но не уменьшены. Этот метод предназначен для внутреннего использования mpl; для нормального использования см. set_xlim().

tick_bottom()

использовать деления только снизу

tick_top()

использовать деления только сверху

class matplotlib.axis.XTick(axes, loc, label, size=None, width=None, color=None, tickdir=None, pad=None, labelsize=None, labelcolor=None, zorder=None, gridOn=None, tick1On=True, tick2On=True, label1On=True, label2On=False, major=True)

Базовый класс matplotlib.axis.Tick

Содержит все элементы, необходимые для создания x-деления: линию деления, текст метки и линию сетки

bbox — прямоугольник, определяющий область деления в координатах отображения; loc — положение деления в координатах данных; size — размер деления в пунктах

apply_tickdir(tickdir)
get_view_interval()

Возвращает экземпляр Interval для пределов отображения этой оси.

update_position(loc)

Установить положение деления в координатах данных со скаляром loc

class matplotlib.axis.YAxis(axes, pickradius=15)

Bases: matplotlib.axis.Axis

Инициализирует ось с экземпляром родительского объекта Axes.

axis_name = 'y'
contains(mouseevent)

Проверяет, произошла ли обработка события мыши на оси Y.

Возвращает True | False

get_data_interval()

Возвращает экземпляр Interval для пределов данных этой оси.

get_label_position()

Возвращает позицию метки (слева или справа).

get_minpos()
get_text_widths(renderer)
get_ticks_position()

Возвращает позицию делений (слева, справа, обе или неизвестно).

get_view_interval()

Возвращает экземпляр Interval для пределов отображения этой оси.

set_data_interval(vmin, vmax, ignore=False)

Устанавливает пределы данных оси.

set_default_intervals()

Устанавливает стандартные пределы для интервала оси, если они не изменены.

set_label_position(position)

Устанавливает позицию метки (слева или справа).

ПРИНИМАЕТ: [ ‘слева’ | ‘справа’ ]

set_offset_position(position)
set_ticks_position(position)

Устанавливает положение делений (слева, справа, обе, по умолчанию или нет) ‘обе’ отображает деления с обеих сторон, но не меняет надписи. ‘по умолчанию’ восстанавливает положение делений по умолчанию: деления с обеих сторон, подписи слева. ‘нет’ может быть использовано, если вам не нужны деления. ‘нет’ и ‘обе’ влияют только на деления, а не на метки.

ПРИНИМАЕТ: [ ‘слева’ | ‘справа’ | ‘обе’ | ‘по умолчанию’ | ‘нет’ ]

set_view_interval(vmin, vmax, ignore=False)

Если ignore равно False, порядок vmin, vmax не имеет значения; исходная ориентация оси будет сохранена. Кроме того, пределы отображения могут быть расширены, но не уменьшены. Этот метод предназначен для внутреннего использования mpl; для обычного использования см. set_ylim().

tick_left()

Использовать деления только слева.

tick_right()

Использовать деления только справа.

class matplotlib.axis.YTick(axes, loc, label, size=None, width=None, color=None, tickdir=None, pad=None, labelsize=None, labelcolor=None, zorder=None, gridOn=None, tick1On=True, tick2On=True, label1On=True, label2On=False, major=True)

Bases: matplotlib.axis.Tick

Содержит все объекты-графические элементы, необходимые для создания отметки Y: линию деления, текстовую метку и линию сетки.

bbox — прямоугольник границ в координатах отображения Axes loc — положение деления в данных координатах size — размер деления в пунктах

apply_tickdir(tickdir)
get_view_interval()

Возвращает экземпляр Interval для пределов отображения этой оси.

update_position(loc)

Устанавливает положение деления в координатах данных со скалярным значением loc.

© 2012–2016 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
http://matplotlib.org/1.5.3/api/axis_api.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API