cbook

matplotlib.cbook

Коллекция служебных функций и классов. Изначально многие (но не все) были из Python Cookbook – отсюда и название cbook.

Этот модуль безопасно импортировать из любой точки matplotlib; он импортирует matplotlib только во время выполнения.

class matplotlib.cbook.Bunch(**kwds)

Базы: object

Часто нам нужно просто собрать несколько вещей вместе, присвоив имя каждому элементу; словарь подходит для этого, но небольшой класс без действий ещё удобнее и приятнее в использовании. Всякий раз, когда вам нужно сгруппировать несколько переменных:

>>> point = Bunch(datum=2, squared=4, coord=12)
>>> point.datum

By: Alex Martelli
From: https://code.activestate.com/recipes/121294/

class matplotlib.cbook.CallbackRegistry(exception_handler=<function _exception_printer>)

Базы: object

Обработка регистрации и отключения для набора сигналов и обратных вызовов:

>>> def oneat(x):
...    print('eat', x)
>>> def ondrink(x):
...    print('drink', x)

>>> from matplotlib.cbook import CallbackRegistry
>>> callbacks = CallbackRegistry()

>>> id_eat = callbacks.connect('eat', oneat)
>>> id_drink = callbacks.connect('drink', ondrink)

>>> callbacks.process('drink', 123)
drink 123
>>> callbacks.process('eat', 456)
eat 456
>>> callbacks.process('be merry', 456) # nothing will be called
>>> callbacks.disconnect(id_eat)
>>> callbacks.process('eat', 456)      # nothing will be called

На практике всегда следует отключать все обратные вызовы, когда они больше не нужны, чтобы избежать висячих ссылок (и, следовательно, утечек памяти). Однако реальный код в matplotlib редко это делает, и из-за его дизайна довольно сложно разместить этот вид кода. Чтобы обойти эту проблему и предотвратить этот класс утечек памяти, мы вместо этого храним только слабые ссылки на связанные методы, поэтому, когда целевой объект необходимо удалить, CallbackRegistry не будет его поддерживать. Модуль weakref стандартной библиотеки Python не может создавать слабые ссылки на связанные методы напрямую, поэтому нам нужно создать прокси-объект для обработки слабых ссылок на связанные методы (или обычные свободные функции). Этот метод был предоставлен Питером Паранте на его “Mindtrove” блоге.

Параметры:

Параметры:	exception_handler : callable, optional Если указано, должно иметь сигнатуру def handler(exc: Exception) -> None: Если не None, эта функция будет вызываться с любым `Exception` подклассом, поднятым обратными вызовами в `CallbackRegistry.process`. Обработчик может либо обработать исключение, либо повторно поднять его. Вызываемый объект должен быть сериализуемым. По умолчанию используется обработчик def h(exc): traceback.print_exc()

exception_handler : callable, optional

Если указано, должно иметь сигнатуру

def handler(exc: Exception) -> None:

Если не None, эта функция будет вызываться с любым Exception подклассом, поднятым обратными вызовами в CallbackRegistry.process. Обработчик может либо обработать исключение, либо повторно поднять его.

Вызываемый объект должен быть сериализуемым.

По умолчанию используется обработчик

def h(exc):
    traceback.print_exc()

connect(s, func): зарегистрировать func для вызова при генерации сигнала s func будет вызван

disconnect(cid): отключить обратный вызов, зарегистрированный с идентификатором обратного вызова cid

process(s, *args, **kwargs): обработать сигнал s. Все функции, зарегистрированные для получения обратных вызовов на s будут вызваны с **args и **kwargs

class matplotlib.cbook.GetRealpathAndStat: Базы: object

class matplotlib.cbook.Grouper(init=())

Базы: object

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

Объекты можно объединять с помощью join(), проверять связность с помощью joined(), и получать все непересекающиеся множества, используя объект в качестве итератора.

Объединяемые объекты должны быть хэшируемыми и поддерживать слабые ссылки.

Например:

>>> from matplotlib.cbook import Grouper
>>> class Foo(object):
...     def __init__(self, s):
...         self.s = s
...     def __repr__(self):
...         return self.s
...
>>> a, b, c, d, e, f = [Foo(x) for x in 'abcdef']
>>> grp = Grouper()
>>> grp.join(a, b)
>>> grp.join(b, c)
>>> grp.join(d, e)
>>> sorted(map(tuple, grp))
[(a, b, c), (d, e)]
>>> grp.joined(a, b)
True
>>> grp.joined(a, c)
True
>>> grp.joined(a, d)
False

clean(): Очистка устаревших слабых ссылок из словаря

get_siblings(a): Возвращает все элементы, объединённые с a, включая себя.

join(a, *args): Объединение указанных аргументов в одно множество. Принимает один или несколько аргументов.

joined(a, b): Возвращает True, если a и b являются членами одного и того же множества.

remove(a)

exception matplotlib.cbook.IgnoredKeywordWarning

Базы: UserWarning

Класс для выдачи предупреждений об аргументах ключевых слов, которые будут проигнорированы matplotlib

class matplotlib.cbook.Locked(path)

Базы: object

Менеджер контекста для обработки блокировок.

Основан на коде из conda.

conda распространяется на условиях лицензии BSD 3-clause. См. LICENSE_CONDA или https://opensource.org/licenses/BSD-3-Clause.

LOCKFN = '.matplotlib_lock'

exception TimeoutError: Базы: RuntimeError

class matplotlib.cbook.Null(*args, **kwargs)

Базы: object

Устарело начиная с версии 2.1: Класс Null устарел в версии 2.1.

Объекты Null всегда и надёжно «ничего не делают».

class matplotlib.cbook.RingBuffer(*args, **kwargs)

Базы: object

Устарело начиная с версии 2.1: Класс RingBuffer устарел в версии 2.1.

класс, реализующий неполный буфер

append(x): добавление элемента в конец буфера

get(): Возвращает список элементов от самого старого к самому новому.

class matplotlib.cbook.Sorter(*args, **kwargs)

Базы: object

Устарело начиная с версии 2.1: sorted(…, key=itemgetter(…))

Сортировка по атрибуту или элементу

Пример использования:

sort = Sorter()

list = [(1, 2), (4, 8), (0, 3)]
dict = [{'a': 3, 'b': 4}, {'a': 5, 'b': 2}, {'a': 0, 'b': 0},
        {'a': 9, 'b': 9}]

sort(list)       # default sort
sort(list, 1)    # sort by index 1
sort(dict, 'a')  # sort a list of dicts by key 'a'

byAttribute(data, attributename, inplace=1)

byItem(data, itemindex=None, inplace=1)

sort(data, itemindex=None, inplace=1)

class matplotlib.cbook.Stack(default=None)

Базы: object

Реализация стека, где элементы могут быть добавлены, и можно перемещаться вперёд и назад. Но нет pop. Должен имитировать домашнюю / обратную / вперёд в браузере

back(): перемещение назад и возврат текущего элемента

bubble(o): поднять o наверх стека и вернуть o. o должен быть в стеке

clear(): очистить стек

empty()

forward(): перемещение вперёд и возврат текущего элемента

home(): добавление первого элемента в верх стека

push(o): добавить объект в стек в текущей позиции - все элементы, появляющиеся позже текущей позиции, удаляются

remove(o): удалить элемент o из стека

class matplotlib.cbook.Xlator(*args, **kwargs)

Базы: dict

Устарело начиная с версии 2.1: Класс Xlator устарел в версии 2.1.

Класс для многострочной подстановки

Пример использования:

text = "Larry Wall is the creator of Perl"
adict = {
"Larry Wall" : "Guido van Rossum",
"creator" : "Benevolent Dictator for Life",
"Perl" : "Python",
}

print(multiple_replace(adict, text))

xlat = Xlator(adict)
print(xlat.xlat(text))

xlat(text): Перевод текста, возвращает изменённый текст.

matplotlib.cbook.align_iterators(func, *iterables)

Этот генератор берёт несколько итерируемых объектов, упорядоченных по func Он отправляет упорядоченные кортежи:

(func(row), [rows from all iterators matching func(row)])

Он используется matplotlib.mlab.recs_join() для объединения массивов записей

END_OF_DOCUMENT_MARKER

matplotlib.cbook.allequal(seq): Устарело начиная с версии 2.1: Функция allequal устарела в версии 2.1.

Возвращает True, если все элементы последовательности seq равны. Если seq имеет длину 0 или 1, возвращает True.

matplotlib.cbook.allpairs(x): Устарело начиная с версии 2.1: Функция allpairs устарела в версии 2.1.

возвращает все возможные пары в последовательности x

matplotlib.cbook.alltrue(seq): Устарело начиная с версии 2.1: Функция alltrue устарела в версии 2.1.

Возвращает True, если все элементы последовательности seq вычисляются как True. Если seq пуста, возвращает False.

matplotlib.cbook.boxplot_stats(X, whis=1.5, bootstrap=None, labels=None, autorange=False)

Возвращает список словарей со статистикой, используемой для построения ряда диаграмм размаха. Раздел Returns перечисляет необходимые ключи словаря. Пользователи могут пропустить эту функцию и передать пользовательский набор словарей в новый метод axes.bxp, вместо того, чтобы полагаться на MPL для выполнения вычислений.

Параметры:

X : массив-подобный объект

Данные, которые будут представлены в диаграммах размаха. Должен иметь 2 или меньше измерений.

whis : число, строка или последовательность (по умолчанию = 1.5)

В виде числа определяет область усов за пределами первого и третьего квартилей. Другими словами, где IQR — это межквартильный размах (Q3-Q1), верхний ус будет распространяться до последнего значения, меньшего Q3 + whis*IQR. Аналогично, нижний ус будет распространяться до первого значения, большего Q1 - whis*IQR. За пределами усов данные считаются выбросами и отображаются как отдельные точки. Это можно установить в возрастающую последовательность процентилей (например, [5, 95]), чтобы установить усы в определенных процентилях данных. Наконец, whis может быть строкой 'range', чтобы зафиксировать усы на минимальном и максимальном значениях данных. В крайнем случае, если 25-й и 75-й процентили равны, whis может быть автоматически установлен в 'range' с помощью опции autorange.

bootstrap : целое число, необязательно

Количество раз, когда доверительные интервалы вокруг медианы должны быть получены методом бутстрепа.

labels : массив-подобный объект, необязательно

Метки для каждого набора данных. Длина должна быть совместима с размерами X.

autorange : bool, необязательно (False)

Когда True и данные распределены таким образом, что 25-й и 75-й процентили равны, whis устанавливается в 'range' таким образом, что концы усов находятся на минимальном и максимальном значениях данных.

Возвращает:

bxpstats : список словарей

Список словарей, содержащих результаты для каждого столбца данных. Ключи каждого словаря следующие:

Ключ	Описание значения
label	метка шкалы для диаграммы размаха
mean	арифметическое среднее значение
med	50-й процентиль
q1	первый квартиль (25-й процентиль)
q3	третий квартиль (75-й процентиль)
cilo	нижний вырез вокруг медианы
cihi	верхний вырез вокруг медианы
whislo	конец нижнего уса
whishi	конец верхнего уса
fliers	выбросы

Примечания

Подход без бутстрепа к доверительному интервалу использует асимптотическое приближение на основе Гаусса:

Общий подход из: McGill, R., Tukey, J.W., and Larsen, W.A. (1978) «Variations of Boxplots», The American Statistician, 32:12-16.

class matplotlib.cbook.converter(*args, **kwargs)

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

Устарело начиная с версии 2.1: Класс converter устарел в версии 2.1.

Базовый класс для обработки строк -> тип Python с поддержкой пропущенных значений

is_missing(s)

matplotlib.cbook.dedent(s)

Удалить избыточное отступы из строки документации s.

Отбрасывает любые начальные пустые строки, затем удаляет до n символов пробелов с каждой строки, где n — количество начальных символов пробелов в первой строке. Он отличается от textwrap.dedent тем, что удаляет начальные пустые строки и использует первую непустую строку для определения отступа.

В большинстве случаев он также быстрее.

matplotlib.cbook.delete_masked_points(*args)

Находит все замаскированные и/или нечисловые точки в наборе аргументов и возвращает аргументы, содержащие только незамаскированные точки.

Аргументы могут быть любого из 5 категорий:

1-мерные замаскированные массивы
1-мерные массивы NumPy
массивы NumPy с более чем одним измерением
другие нестроковые итерируемые объекты
все остальное

Первый аргумент должен принадлежать к одной из первых четырех категорий; любой аргумент с длиной, отличающейся от длины первого аргумента (и, следовательно, любой аргумент из категории 5), передаётся без изменений.

Маски получаются от всех аргументов правильной длины в категориях 1, 2 и 4; точка считается неверной, если она замаскирована в замаскированном массиве или если она равна nan или inf. Не предпринимается попыток извлечь маску из категорий 2, 3 и 4, если np.isfinite() не возвращает массив булевых значений.

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

Ранее значительно упрощённая версия этой функции изначально использовалась как вспомогательная функция для Axes.scatter().

matplotlib.cbook.dict_delall(d, keys): Устарело начиная с версии 2.1: Функция dict_delall устарела в версии 2.1.

удаляет все keys из dict d

matplotlib.cbook.exception_to_str(s=None): Устарело начиная с версии 2.1: Функция exception_to_str устарела в версии 2.1.

matplotlib.cbook.file_requires_unicode(x): Возвращает True, если для записи в данный объект файла требуется Unicode.

matplotlib.cbook.finddir(o, match, case=False): Устарело начиная с версии 2.1: Функция finddir устарела в версии 2.1.

возвращает все атрибуты o, которые совпадают со строкой в match. если case равно True, требуется точное соответствие по регистру.

matplotlib.cbook.flatten(seq, scalarp=<function is_scalar_or_string>)

Возвращает генератор сглаженных вложенных контейнеров.

Например:

>>> from matplotlib.cbook import flatten
>>> l = (('John', ['Hunter']), (1, 23), [[([42, (5, 23)], )]])
>>> print(list(flatten(l)))
['John', 'Hunter', 1, 23, 42, 5, 23]

Автор: Композиция Хольгера Крекеля и Лютера Блиссета Из: https://code.activestate.com/recipes/121294/ и рецепт 1.12 в сборнике рецептов

matplotlib.cbook.get_label(y, default_name)

matplotlib.cbook.get_recursive_filelist(args): Устарело начиная с версии 2.1: Функция get_recursive_filelist устарела в версии 2.1.

Рекурсивно обходит все файлы и каталоги в args, игнорируя символические ссылки, и возвращает файлы в виде списка строк

matplotlib.cbook.get_sample_data(fname, asfileobj=True)

Возвращает файл со справочными данными. fname — путь, относящийся к каталогу mpl-data/sample_data. Если asfileobj равно True, возвращает объект файла, в противном случае — просто путь к файлу.

Установите параметр rc examples.directory в каталог, в котором должны быть поиски, если файлы sample_data хранятся в месте отличном от стандартного (который — ‘mpl-data/sample_data` на том же уровне, что и файлы Python-модуля ‘matplotlib’).

Если имя файла заканчивается на .gz, файл неявно распаковывается.

matplotlib.cbook.get_split_ind(seq, N)

Устарело начиная с версии 2.1: Функция get_split_ind устарела в версии 2.1.

seq — список слов. Возвращает индекс в seq такой, что:

len(' '.join(seq[:ind])<=N

matplotlib.cbook.index_of(y)

Вспомогательная функция для получения индекса входных данных для построения графика, если значения x не заданы явно.

Пытается получить y.index (работает, если это pd.Series), если это не удаётся, возвращает np.arange(y.shape[0]).

В будущем это будет расширено для обработки других типов маркированных данных.

Параметры:

Параметры:	y : скаляр или массив-подобный объект Предлагаемое значение y
Возвращает:	x, y : массив NumPy Значения x и y для построения графика.

y : скаляр или массив-подобный объект

Предлагаемое значение y

Возвращает:

x, y : массив NumPy

Значения x и y для построения графика.

matplotlib.cbook.is_hashable(obj): Возвращает True, если obj может быть хеширован

matplotlib.cbook.is_math_text(s)

matplotlib.cbook.is_numlike(obj): возвращает true, если obj выглядит как число

matplotlib.cbook.is_scalar(obj): Устарело начиная с версии 2.1: Функция is_scalar устарела в версии 2.1.

возвращает true, если obj не похож на строку и не итерируемый

matplotlib.cbook.is_scalar_or_string(val): Возвращает значение, если заданный объект является скаляром или подобен строке.

matplotlib.cbook.is_sequence_of_strings(obj): Устарело начиная с версии 2.1: Функция is_sequence_of_strings устарела в версии 2.1.

Возвращает true, если obj итерируемый и содержит строки

matplotlib.cbook.is_string_like(obj): Устарело начиная с версии 2.1: Функция is_string_like устарела в версии 2.1.

Возвращает True, если obj выглядит как строка

matplotlib.cbook.is_writable_file_like(obj): возвращает true, если obj выглядит как объект файла с методом write

matplotlib.cbook.issubclass_safe(x, klass): Устарело начиная с версии 2.1: Функция issubclass_safe устарела в версии 2.1.

возвращает issubclass(x, klass) и возвращает False при ошибке TypeError

matplotlib.cbook.iterable(obj): возвращает true, если obj итерируемый

matplotlib.cbook.listFiles(root, patterns='*', recurse=1, return_folders=0)

Рекурсивно перечисляет файлы

из книги рецептов Python от Пармара и Мартелли

matplotlib.cbook.local_over_kwdict(local_var, kwargs, *keys)

Обеспечивает приоритет локальной переменной над потенциально конфликтующими аргументами из словаря kwargs. Следующие возможные выходные значения рассматриваются в порядке приоритета:

локальная_переменная > kwargs[ключ[0]] > … > kwargs[ключ[-1]]

Первое из этих значений, отличное от None, будет возвращено. Если все они None, то будет возвращено None. Каждый ключ в ключе будет удален из словаря kwargs на месте.

Параметры:

Параметры:	local_var: любой объект Локальная переменная (высший приоритет) kwargs: dict Словарь ключевых аргументов; изменяется на месте keys: str(s) Имя(а) ключевых аргументов для обработки, в порядке убывания приоритета
Возвращает:	out: любой объект Либо local_var, либо одно из kwargs[key] для key в keys
Возможные исключения:	IgnoredKeywordWarning Для каждого ключа в ключах, который удаляется из kwargs, но не используется в качестве выходного значения

local_var: любой объект

Локальная переменная (высший приоритет)

kwargs: dict: Словарь ключевых аргументов; изменяется на месте
keys: str(s): Имя(а) ключевых аргументов для обработки, в порядке убывания приоритета

Возвращает:

out: любой объект

Либо local_var, либо одно из kwargs[key] для key в keys

Возможные исключения:

IgnoredKeywordWarning

Для каждого ключа в ключах, который удаляется из kwargs, но не используется в качестве выходного значения

class matplotlib.cbook.maxdict(maxsize)

Базовые классы: dict

Словарь с максимальным размером; это не переопределяет все соответствующие методы для ограничения размера, только setitem, поэтому используйте с осторожностью

matplotlib.cbook.mkdirs(newdir, mode=511)

Рекурсивно создаёт директорию newdir и устанавливает mode. Эквивалентно

> mkdir -p NEWDIR
> chmod MODE NEWDIR

matplotlib.cbook.normalize_kwargs(kw, alias_mapping=None, required=(), forbidden=(), allowed=None)

Вспомогательная функция для нормализации входных данных kwarg

Порядок их разрешения:

алиасинг
обязательные
запрещённые
разрешённые

Этот порядок означает, что только канонические имена должны появляться в allowed, forbidden, required

Параметры:

Параметры:	alias_mapping, dict, необязательно Отображение между каноническим именем и списком псевдонимов, в порядке приоритета от низшего к высшему. Если каноническое значение не находится в списке, предполагается, что оно имеет наивысший приоритет. required : iterable, необязательно Кортеж полей, которые должны быть в kwargs. forbidden : iterable, необязательно Список ключей, которые не должны быть в kwargs allowed : кортеж, необязательно Кортеж разрешённых полей. Если это не None, то вызывать исключение, если `kw` содержит какие-либо ключи, не входящие в объединение `required` и `allowed`. Для разрешения только требуемых полей передайте `()` для `allowed`
Возможные исключения:	TypeError Для соответствия тому, что Python поднимает, если переданы недопустимые аргументы/kwargs вызываемому объекту.

alias_mapping, dict, необязательно

Отображение между каноническим именем и списком псевдонимов, в порядке приоритета от низшего к высшему.

Если каноническое значение не находится в списке, предполагается, что оно имеет наивысший приоритет.

required : iterable, необязательно

Кортеж полей, которые должны быть в kwargs.

forbidden : iterable, необязательно

Список ключей, которые не должны быть в kwargs

allowed : кортеж, необязательно

Кортеж разрешённых полей. Если это не None, то вызывать исключение, если kw содержит какие-либо ключи, не входящие в объединение required и allowed. Для разрешения только требуемых полей передайте () для allowed

Возможные исключения:

TypeError

Для соответствия тому, что Python поднимает, если переданы недопустимые аргументы/kwargs вызываемому объекту.

matplotlib.cbook.onetrue(seq): Устарело начиная с версии 2.1: Функция onetrue устарела в версии 2.1.

Возвращает True, если один элемент seq равен True. Если seq пуст, возвращает False.

matplotlib.cbook.pieces(seq, num=2): Устарело начиная с версии 2.1: Функция pieces устарела в версии 2.1.

Разбить seq на num кортежей

matplotlib.cbook.print_cycles(objects, outstream=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='UTF-8'>, show_progress=False)

objects: Список объектов, в которых нужно найти циклы. Часто полезно передавать gc.garbage, чтобы найти циклы, препятствующие сборке мусора некоторых объектов.
outstream: Поток для вывода.
show_progress: Если True, выводит количество достигнутых объектов по мере их обнаружения.

matplotlib.cbook.pts_to_midstep(x, *args)

Преобразование непрерывной линии в средние шаги.

Даны набор N точек, преобразовать в 2N точки, которые при линейном соединении дают ступенчатую функцию, меняющую значения посередине интервалов.

Параметры:

Параметры:	x : массив Положение x шагов. y1, …, yp : массив массивы y, которые нужно превратить в шаги; все должны иметь такую же длину, как `x`.
Возвращает:	out : массив Значения x и y, преобразованные в шаги в том же порядке, что и входные данные; могут быть распакованы как `x_out, y1_out, ..., yp_out`. Если длина входных данных `N`, каждый из этих массивов будет длиной `2N`.

x : массив

Положение x шагов.

y1, …, yp : массив

массивы y, которые нужно превратить в шаги; все должны иметь такую же длину, как x.

Возвращает:

out : массив

Значения x и y, преобразованные в шаги в том же порядке, что и входные данные; могут быть распакованы как x_out, y1_out, ..., yp_out. Если длина входных данных N, каждый из этих массивов будет длиной 2N.

Примеры

>> x_s, y1_s, y2_s = pts_to_midstep(x, y1, y2)

matplotlib.cbook.pts_to_poststep(x, *args)

Преобразование непрерывной линии в шаги «после».

Даны набор N точек, преобразовать в 2N + 1 точки, которые при линейном соединении дают ступенчатую функцию, меняющую значения в конце интервалов.

Параметры:

Параметры:	x : массив Положение x шагов. y1, …, yp : массив массивы y, которые нужно превратить в шаги; все должны иметь такую же длину, как `x`.
Возвращает:	out : массив Значения x и y, преобразованные в шаги в том же порядке, что и входные данные; могут быть распакованы как `x_out, y1_out, ..., yp_out`. Если длина входных данных `N`, каждый из этих массивов будет длиной `2N + 1`.

x : массив

Положение x шагов.

y1, …, yp : массив

массивы y, которые нужно превратить в шаги; все должны иметь такую же длину, как x.

Возвращает:

out : массив

Примеры

>> x_s, y1_s, y2_s = pts_to_poststep(x, y1, y2)

matplotlib.cbook.pts_to_prestep(x, *args)

Преобразование непрерывной линии в шаги «до».

Даны набор N точек, преобразовать в 2N - 1 точки, которые при линейном соединении дают ступенчатую функцию, меняющую значения в начале интервалов.

Параметры:

Параметры:	x : массив Положение x шагов. y1, …, yp : массив массивы y, которые нужно превратить в шаги; все должны иметь такую же длину, как `x`.
Возвращает:	out : массив Значения x и y, преобразованные в шаги в том же порядке, что и входные данные; могут быть распакованы как `x_out, y1_out, ..., yp_out`. Если длина входных данных `N`, каждый из этих массивов будет длиной `2N + 1`.

x : массив

Положение x шагов.

y1, …, yp : массив

массивы y, которые нужно превратить в шаги; все должны иметь такую же длину, как x.

Возвращает:

out : массив

Примеры

>> x_s, y1_s, y2_s = pts_to_prestep(x, y1, y2)

matplotlib.cbook.recursive_remove(path): Устарело начиная с версии 2.1: Функция recursive_remove устарела в версии 2.1. Используйте shutil.rmtree вместо неё.

matplotlib.cbook.report_memory(i=0): возвращает память, используемую процессом

matplotlib.cbook.restrict_dict(d, keys): Устарело начиная с версии 2.1: Функция restrict_dict была устарела в версии 2.1.

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

matplotlib.cbook.reverse_dict(d): Устарело начиная с версии 2.1: Функция reverse_dict была устарела в версии 2.1.

Инвертирует словарь; может потерять данные, если значения не уникальны!

matplotlib.cbook.safe_first_element(obj)

matplotlib.cbook.safe_masked_invalid(x, copy=False)

matplotlib.cbook.safezip(*args): Убедитесь, что args имеют одинаковую длину перед объединением.

matplotlib.cbook.sanitize_sequence(data): Преобразует объект dictview в список.

class matplotlib.cbook.silent_list(type, seq=None)

Базируется на list

Переопределяет repr при возвращении списка matplotlib-объектов, чтобы предотвратить вывод длинных бесполезных строк. Предназначено для однородного списка заданного типа.

matplotlib.cbook.simple_linear_interpolation(a, steps)

matplotlib.cbook.soundex(name, len=4): Устарело начиная с версии 2.1: Функция soundex была устарела в версии 2.1.

Функция модуля soundex, соответствующая алгоритму Оделл-Рассела.

matplotlib.cbook.strip_math(s): Удаляет форматирование LaTeX из mathtext.

matplotlib.cbook.to_filehandle(fname, flag='rU', return_opened=False): fname может быть именем файла или файловым дескриптором. Поддержка сжатых gzip-файлов автоматическая, если имя файла заканчивается на .gz. flag — флаг чтения/записи для file().

class matplotlib.cbook.todate(*args, **kwargs)

Базируется на matplotlib.cbook.converter

Устарело начиная с версии 2.1: Класс todate был устарел в версии 2.1.

Преобразовать в дату или None.

class matplotlib.cbook.todatetime(*args, **kwargs)

Базируется на matplotlib.cbook.converter

Устарело начиная с версии 2.1: Класс todatetime был устарел в версии 2.1.

Преобразовать в datetime или None.

class matplotlib.cbook.tofloat(*args, **kwargs)

Базируется на matplotlib.cbook.converter

Устарело начиная с версии 2.1: Класс tofloat был устарел в версии 2.1.

Преобразовать в float или None.

class matplotlib.cbook.toint(*args, **kwargs)

Базируется на matplotlib.cbook.converter

Устарело начиная с версии 2.1: Класс toint был устарел в версии 2.1.

Преобразовать в целое число или None.

class matplotlib.cbook.tostr(*args, **kwargs)

Базируется на matplotlib.cbook.converter

Устарело начиная с версии 2.1: Класс tostr был устарел в версии 2.1.

Преобразовать в строку или None.

matplotlib.cbook.unicode_safe(s)

matplotlib.cbook.unique(x): Устарело начиная с версии 2.1: Функция unique была устарела в версии 2.1.

Возвращает список уникальных элементов из x

matplotlib.cbook.unmasked_index_ranges(mask, compressed=True)

Устарело начиная с версии 2.1: Функция unmasked_index_ranges была устарела в версии 2.1.

Находит диапазоны индексов, где mask равен False.

mask будет сглажен, если он не является одномерным.

Возвращает Nx2 numpy.ndarray, где каждая строка — начальный и конечный индексы срезов сжатого numpy.ndarray, соответствующие каждому из N непрерывных участков не замаскированных значений. Если необязательный аргумент compressed равен False, он возвращает начальный и конечный индексы в исходном numpy.ndarray, а не в сжатом numpy.ndarray. Возвращает None, если нет незамаскированных значений.

Пример:

y = ma.array(np.arange(5), mask = [0,0,1,0,0])
ii = unmasked_index_ranges(ma.getmaskarray(y))
# returns array [[0,2,] [2,4,]]

y.compressed()[ii[1,0]:ii[1,1]]
# returns array [3,4,]

ii = unmasked_index_ranges(ma.getmaskarray(y), compressed=False)
# returns array [[0, 2], [3, 5]]

y.filled()[ii[1,0]:ii[1,1]]
# returns array [3,4,]

До рефакторинга преобразований это использовалось для поддержки замаскированных массивов в Line2D.

matplotlib.cbook.violin_stats(X, method, points=100)

Возвращает список словарей данных, которые можно использовать для построения ряда диаграмм размаха. См. раздел Returns ниже, чтобы увидеть необходимые ключи словаря. Пользователи могут пропустить эту функцию и передать пользовательский набор словарей в метод axes.vplot вместо использования MPL для вычислений.

Параметры:

Параметры:	X : массив Данные образцов, которые будут использоваться для создания оценок плотности вероятности с помощью ядра Гаусса. Должны иметь 2 или менее измерения. method : вызываемая функция Метод, используемый для вычисления оценки плотности вероятности с помощью ядра Гаусса для каждого столбца данных. При вызове через `method(v, coords)`, он должен вернуть вектор значений оценки KDE, вычисленной в указанных координатах. points : скаляр, по умолчанию = 100 Определяет количество точек для вычисления каждой оценки плотности вероятности с помощью ядра Гаусса.
Возвращает:	Список словарей, содержащих результаты для каждого столбца данных. Словари содержат по крайней мере следующие ключи: coords: Список скаляров, содержащих координаты, в которых была вычислена конкретная оценка плотности вероятности с помощью ядра Гаусса. vals: Список скаляров, содержащих значения оценки плотности вероятности с помощью ядра Гаусса в каждой из координат, указанных в `coords`. mean: Среднее значение для этого столбца данных. median: Медианное значение для этого столбца данных. min: Минимальное значение для этого столбца данных. max: Максимальное значение для этого столбца данных.

X : массив

Данные образцов, которые будут использоваться для создания оценок плотности вероятности с помощью ядра Гаусса. Должны иметь 2 или менее измерения.

method : вызываемая функция

Метод, используемый для вычисления оценки плотности вероятности с помощью ядра Гаусса для каждого столбца данных. При вызове через method(v, coords), он должен вернуть вектор значений оценки KDE, вычисленной в указанных координатах.

points : скаляр, по умолчанию = 100

Определяет количество точек для вычисления каждой оценки плотности вероятности с помощью ядра Гаусса.

Возвращает:

Список словарей, содержащих результаты для каждого столбца данных.

Словари содержат по крайней мере следующие ключи:

coords: Список скаляров, содержащих координаты, в которых была вычислена конкретная оценка плотности вероятности с помощью ядра Гаусса.
vals: Список скаляров, содержащих значения оценки плотности вероятности с помощью ядра Гаусса в каждой из координат, указанных в coords.
mean: Среднее значение для этого столбца данных.
median: Медианное значение для этого столбца данных.
min: Минимальное значение для этого столбца данных.
max: Максимальное значение для этого столбца данных.

matplotlib.cbook.wrap(prefix, text, cols): Устарело начиная с версии 2.1: Функция wrap была устарела в версии 2.1. Используйте textwrap.TextWrapper вместо нее.

Обёртывает text с prefix на длине cols.