matplotlib.projections

Неразделимые преобразования, которые отображают пространство данных в пространство экрана.

Проекции определяются как Axes подклассы. Они включают следующие элементы:

• Преобразование из координат данных в координаты отображения.
• Обратное преобразование. Оно используется, например, для преобразования координат курсора из пространства экрана в пространство данных.
• Преобразования для линий сетки, делений и меток делений. Пользовательские проекции часто требуют размещения этих элементов в особых местах, и Matplotlib предоставляет инструменты для этого.
• Установка значений по умолчанию (переопределение cla), так как значения по умолчанию для прямоугольных осей могут быть неподходящими.
• Определение формы осей, например, эллиптических осей, которые будут использоваться для отрисовки фона графика и обрезки элементов данных.
• Определение пользовательских локаторов и форматировщиков для проекции. Например, в географической проекции удобнее отображать сетку в градусах, даже если данные представлены в радианах.
• Настройка интерактивного масштабирования и перемещения. Это оставлено как "дополнительная" функция, но пример для полярных графиков находится в matplotlib.projections.polar.
• Любые дополнительные методы для удобства или дополнительных функций.

После определения проекции оси, её можно использовать двумя способами:

• Определяя атрибут класса name, проекцию оси можно зарегистрировать с помощью matplotlib.projections.register_projection и затем просто вызвать по имени:

  fig.add_subplot(projection="my_proj_name")
  

• Для более сложных параметризуемых проекций может быть определён общий объект «проекции», который включает метод _as_mpl_axes. _as_mpl_axes не должен принимать аргументов и возвращать подкласс оси проекции и словарь дополнительных аргументов для передачи методу __init__ подкласса. После этого параметризованную проекцию можно инициализировать:

  fig.add_subplot(projection=MyProjection(param1=param1_value))
  

  где MyProjection — объект, реализующий метод _as_mpl_axes.

Полный и подробно аннотированный пример находится в Пользовательская проекция. Функциональность полярного графика в matplotlib.projections.polar также может быть интересной.

classmatplotlib.projections.ProjectionRegistry[source]

Bases: object

Сопоставление зарегистрированных имён проекций с классами проекций.

get_projection_class(name)[source]

Получение класса проекции по его имени.

get_projection_names()[source]

Возвращает имена всех зарегистрированных проекций.

register(*projections)[source]

Регистрация нового набора проекций.

matplotlib.projections.get_projection_class(projection=None)[source]

Получение класса проекции по имени.

Если projection равно None, возвращается стандартная прямолинейная проекция.

matplotlib.projections.get_projection_names()[source]

Возвращает имена всех зарегистрированных проекций.

matplotlib.projections.register_projection(cls)[source]