текст

matplotlib.text

Классы для включения текста в график.

class matplotlib.text.Annotation(s, xy, xytext=None, xycoords='data', textcoords=None, arrowprops=None, annotation_clip=None, **kwargs) [source]

Bases: matplotlib.text.Text, matplotlib.text._AnnotationBase

Подпишите точку xy текстом s.

Дополнительные ключевые параметры передаются в Text.

Параметры:

s : str Текст аннотации xy : iterable Последовательность длиной 2, определяющая точку (x,y) для аннотации xytext : iterable, optional Последовательность длиной 2, определяющая положение текста (x,y). Если None, по умолчанию используется xy. xycoords : str, Artist, Transform, callable or tuple, optional Система координат, в которой задана xy. Для str допустимые значения: Свойство Описание 'figure points' точки от нижнего левого угла фигуры 'figure pixels' пиксели от нижнего левого угла фигуры 'figure fraction' доля фигуры от нижнего левого угла 'axes points' точки от нижнего левого угла осей 'axes pixels' пиксели от нижнего левого угла осей 'axes fraction' доля осей от нижнего левого угла 'data' используйте систему координат объекта, к которому добавляется аннотация (по умолчанию) 'polar' (theta,r), если не родные координаты 'data' Если передан объект Artist, единицы — это доля, если это область его границ. Если передан объект Transform, используйте его для преобразования xy в экранные координаты Если вызываемый объект, он должен принять объект RendererBase и вернуть объект Transform или Bbox Если tuple, это должна быть кортеж длиной 2 из str, Artist, Transform или вызываемых объектов. Первый преобразователь используется для координаты x, а второй для y. См. Расширенная аннотация для получения дополнительной информации. По умолчанию 'data' textcoords : str, Artist, Transform, callable or tuple, optional Система координат, в которой задан xytext, которая может отличаться от системы координат, используемой для xy. Все значения xycoords допустимы, а также следующие строки: Свойство Описание 'offset points' смещение (в пунктах) от значения xy 'offset pixels' смещение (в пикселях) от значения xy по умолчанию — вход xycoords arrowprops : dict, optional Если не равно None, свойства, используемые для рисования стрелки FancyArrowPatch между xy и xytext. Если arrowprops не содержит ключа 'arrowstyle', допустимые ключи: Ключ Описание width ширина стрелки в пунктах headwidth ширина основания головки стрелки в пунктах headlength длина головки стрелки в пунктах shrink доля общей длины, чтобы «уменьшить» с обеих концов ? любой ключ для matplotlib.patches.FancyArrowPatch Если arrowprops содержит ключ 'arrowstyle', вышеперечисленные ключи запрещены. Допустимые значения 'arrowstyle': Имя Атрибуты '-' None '->' head_length=0.4,head_width=0.2 '-[' widthB=1.0,lengthB=0.2,angleB=None '|-|' widthA=1.0,widthB=1.0 '-|>' head_length=0.4,head_width=0.2 '<-' head_length=0.4,head_width=0.2 '<->' head_length=0.4,head_width=0.2 '<|-' head_length=0.4,head_width=0.2 '<|-|>' head_length=0.4,head_width=0.2 'fancy' head_length=0.4,head_width=0.4,tail_width=0.4 'simple' head_length=0.5,head_width=0.5,tail_width=0.2 'wedge' tail_width=0.3,shrink_factor=0.5 Допустимые ключи для FancyArrowPatch: Ключ Описание arrowstyle стиль стрелки connectionstyle стиль соединения relpos по умолчанию (0.5, 0.5) patchA по умолчанию — граница текста patchB по умолчанию — None shrinkA по умолчанию — 2 пункта shrinkB по умолчанию — 2 пункта mutation_scale по умолчанию — размер текста (в пунктах) mutation_aspect по умолчанию — 1. ? любой ключ для matplotlib.patches.PathPatch По умолчанию None annotation_clip : bool, optional Управляет видимостью аннотации, когда она выходит за область осей. Если True, аннотация будет отображаться только тогда, когда xy находится внутри осей. Если False, аннотация всегда будет отображаться независимо от ее положения. По умолчанию None, что ведет себя как True только если xycoords — "data".

Возвращает:

Аннотация

anncoords

contains(event) [source]

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

В случае с текстом попадание — True в любом месте прямоугольника, содержащего текст.

Возвращает True или False.

draw(renderer) [source]

Отображение объекта Annotation в заданном renderer.

get_window_extent(renderer=None) [source]

Возвращает объект Bbox, определяющий область текста и аннотированной стрелки в единицах отображения.

renderer по умолчанию — атрибут _renderer объекта текста. Он не присваивается до первого выполнения draw(), поэтому вы должны использовать этот параметр, если хотите вызвать get_window_extent() до первого draw(). Для получения областей веб-страниц проще вызвать метод после сохранения фигуры. Используемая по умолчанию dpi — self.figure.dpi; dpi рендера не имеет значения.

set_figure(fig) [source]

Установите экземпляр Figure, к которому принадлежит элемент.

Параметры:	fig : Figure

update_positions(renderer) [source]

«Обновление пиксельных координат аннотированной точки и текста.

xyann

class matplotlib.text.OffsetFrom(artist, ref_coord, unit='points') [source]

Базы: object

Вспомогательный вызываемый класс для работы с Annotation

Параметры:

artist : Artist, BboxBase, or Transform Объект, от которого вычисляется смещение. ref_coord : length 2 sequence Если artist является Artist или BboxBase, это значение — положение начала смещения в долях от artist границы. Если artist — преобразование, то начало смещения — результат применения преобразования к этому значению. unit : {'points, 'pixels'} Единицы экрана (пиксели или точки) для ввода смещения.

get_unit() [source]

Единицы ввода для преобразования, используемого в __call__

set_unit(unit) [source]

Единицы ввода для преобразования, используемого в __call__

Параметры:	unit : {'points', 'pixels'}

class matplotlib.text.Text(x=0, y=0, text='', color=None, verticalalignment='baseline', horizontalalignment='left', multialignment=None, fontproperties=None, rotation=None, linespacing=None, rotation_mode=None, usetex=None, wrap=False, **kwargs) [source]

Bases: matplotlib.artist.Artist

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

Создайте экземпляр Text в точке x, y со строкой text.

Допустимые ключевые аргументы:

Свойство	Описание
agg_filter	Функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha	Вещественное число (от 0.0 — прозрачный до 1.0 — непрозрачный)
animated	Булево значение
backgroundcolor	Любой цвет matplotlib
bbox	Свойства FancyBboxPatch
clip_box	Экземпляр matplotlib.transforms.Bbox
clip_on	Булево значение
clip_path	[ (Path, Transform) | Patch | None ]
color	Любой цвет matplotlib
contains	Вызываемая функция
family или fontfamily или fontname или name	[НАЗВАНИЕ ШРИФТА | 'serif' | 'sans-serif' | 'cursive' | 'fantasy' | 'monospace' ]
figure	Экземпляр Figure
fontproperties или font_properties	Экземпляр matplotlib.font_manager.FontProperties
gid	Строка-идентификатор
horizontalalignment или ha	[ 'center' | 'right' | 'left' ]
label	Объект
linespacing	Вещественное число (кратное размеру шрифта)
multialignment или ma	['left' | 'right' | 'center' ]
path_effects	AbstractPathEffect
picker	[None | bool | float | вызываемая функция]
position	(x,y)
rasterized	bool или None
rotation	[ угол в градусах | 'vertical' | 'horizontal' ]
rotation_mode	[ None | "default" | "anchor" ]
size или fontsize	[размер в пунктах | 'xx-small' | 'x-small' | 'small' | 'medium' | 'large' | 'x-large' | 'xx-large' ]
sketch_params	(масштаб: float, длина: float, случайность: float)
snap	bool или None
stretch или fontstretch	[ числовое значение в диапазоне 0-1000 | 'ultra-condensed' | 'extra-condensed' | 'condensed' | 'semi-condensed' | 'normal' | 'semi-expanded' | 'expanded' | 'extra-expanded' | 'ultra-expanded' ]
style или fontstyle	[ 'normal' | 'italic' | 'oblique']
text	строка или что угодно, что можно распечатать с преобразованием '%s'.
transform	Transform
url	строка url
usetex	bool или None
variant или fontvariant	[ 'normal' | 'small-caps' ]
verticalalignment или va	[ 'center' | 'top' | 'bottom' | 'baseline' ]
visible	Булево значение
weight или fontweight	[ числовое значение в диапазоне 0-1000 | 'ultralight' | 'light' | 'normal' | 'regular' | 'book' | 'medium' | 'roman' | 'semibold' | 'demibold' | 'demi' | 'bold' | 'heavy' | 'extra bold' | 'black' ]
wrap	Булево значение
x	Вещественное число
y	Вещественное число
zorder	Вещественное число

contains(mouseevent) [source]

Проверка, произошла ли нажатие мыши внутри объекта.

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

Возвращает True или False.

draw(renderer) [source]

Отображает объект Text на заданном renderer.

get_bbox_patch() [source]

Возвращает объект-объект Patch рамки. Возвращает None, если FancyBboxPatch не создан.

get_color() [source]

Возвращает цвет текста

get_family() [source]

Возвращает список шрифтов, используемых для поиска шрифта

get_font_properties() [source]

Псевдоним для get_fontproperties

get_fontfamily() [source]

Псевдоним для get_family

get_fontname() [source]

Псевдоним для get_name

get_fontproperties() [source]

Возвращает объект FontProperties

get_fontsize() [source]

Псевдоним для get_size

get_fontstretch() [source]

Псевдоним для get_stretch

get_fontstyle() [source]

Псевдоним для get_style

get_fontvariant() [source]

Псевдоним для get_variant

get_fontweight() [source]

Псевдоним для get_weight

get_ha() [source]

Псевдоним для get_horizontalalignment

get_horizontalalignment() [source]

Возвращает горизонтальное выравнивание в виде строки. Будет одним из 'left', 'center' или 'right'.

get_name() [source]

Возвращает имя шрифта в виде строки

get_position() [source]

Возвращает позицию текста в виде кортежа (x, y)

get_prop_tup(renderer=None) [source]

Возвращает хешируемый кортеж свойств.

Не предназначен для чтения человеком, но полезен для бэкендов, которые хотят кешировать полученную информацию о тексте (например, макеты) и должны знать, изменился ли текст.

get_rotation() [source]

Возвращает угол текста в градусах в виде числа с плавающей точкой

get_rotation_mode() [source]

Возвращает режим поворота текста

get_size() [source]

Возвращает размер шрифта как целое число

get_stretch() [source]

Возвращает растяжение шрифта как строку или число

get_style() [source]

Возвращает стиль шрифта как строку

get_text() [source]

Возвращает текст как строку

get_unitless_position() [source]

Возвращает безразмерную позицию текста в виде кортежа (x, y)

get_usetex() [source]

Возвращает, использует ли этот объект Text TeX для отрисовки.

Если пользователь не установил это значение вручную, оно по умолчанию равно rcParams["text.usetex"].

get_va() [source]

Псевдоним для getverticalalignment()

get_variant() [source]

Возвращает вариант шрифта как строку

get_verticalalignment() [source]

Возвращает вертикальное выравнивание в виде строки. Будет одним из 'top', 'center', 'bottom' или 'baseline'.

get_weight() [source]

Возвращает вес шрифта как строку или число

get_window_extent(renderer=None, dpi=None) [source]

Возвращает объект Bbox, ограничивающий текст, в единицах отображения.

Помимо внутреннего использования, это полезно для определения нажимаемых областей в файле png на веб-странице.

renderer по умолчанию задается атрибутом _renderer объекта текста. Этот атрибут не присваивается до первого выполнения draw(), поэтому вы должны использовать этот параметр, если хотите вызвать get_window_extent() до первого draw(). Для получения областей веб-страницы проще вызвать метод после сохранения изображения.

dpi по умолчанию равен self.figure.dpi; разрешение рендерера не имеет значения. Для веб-приложения, если figure.dpi не равно значению, используемому при сохранении изображения, тогда значение, которое было использовано, должно быть указано как аргумент dpi.

get_wrap() [source]

Возвращает состояние перевода текста.

static is_math_text(s, usetex=None) [source]

Возвращает очищенную строку и логический флаг. Флаг указывает, содержит ли заданная строка s математический текст, определяемый подсчётом неуправляемых знаков доллара. Если математический текст отсутствует, очищенная строка имеет свои знаки доллара, неэкранированные. Если включен usetex, флаг всегда имеет значение "TeX".

set_backgroundcolor(color) [source]

Устанавливает цвет фона текста, обновляя область bbox.

См. также

set_bbox()

Изменение положения области ограничивающей рамки.

ПРИНИМАЕТ: любой цвет matplotlib

set_bbox(rectprops) [source]

Отображает область ограничивающей рамки вокруг self. rectprops - любые устанавливаемые свойства для FancyBboxPatch, например, facecolor='red', alpha=0.5.

t.set_bbox(dict(facecolor='red', alpha=0.5))

По умолчанию boxstyle - 'square'. Масштаб мутации FancyBboxPatch установлен в значение размера шрифта.

ПРИНИМАЕТ: словарь свойств FancyBboxPatch

set_clip_box(clipbox) [source]

Устанавливает область обрезки объекта-артиста Bbox.

ПРИНИМАЕТ: экземпляр matplotlib.transforms.Bbox

set_clip_on(b) [source]

Устанавливает, использует ли артефакт обрезку.

Если значение False, артефакты будут видны за пределами осей, что может привести к неожиданным результатам.

Параметры:	b : bool

set_clip_path(path, transform=None) [source]

Устанавливает траекторию обрезки объекта-артиста, которая может быть:

• экземпляр Patch (или подкласс)

• a Path instance, in which case

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

• None, чтобы удалить траекторию обрезки

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

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

set_color(color) [source]

Устанавливает цвет текста

ПРИНИМАЕТ: любой цвет matplotlib

set_family(fontname) [source]

Устанавливает семейство шрифтов. Может быть одной строкой или списком строк в порядке убывания приоритета. Каждая строка может быть либо именем реального шрифта, либо общим именем класса шрифта. Если последнее, имена конкретных шрифтов будут найдены в файле matplotlibrc.

ПРИНИМАЕТ: [ИМЯ_ШРИФТА | 'serif' | 'sans-serif' | 'cursive' | 'fantasy' |

'monospace' ]

set_font_properties(fp) [source]

Псевдоним для set_fontproperties

set_fontname(fontname) [source]

Псевдоним для set_family

set_fontproperties(fp) [source]

Устанавливает свойства шрифта, которые управляют текстом. fp должен быть объектом matplotlib.font_manager.FontProperties.

ПРИНИМАЕТ: экземпляр matplotlib.font_manager.FontProperties

set_fontsize(fontsize) [source]

Псевдоним для set_size

set_fontstretch(stretch) [source]

Псевдоним для set_stretch

set_fontstyle(fontstyle) [source]

Псевдоним для set_style

set_fontvariant(variant) [source]

Псевдоним для set_variant

set_fontweight(weight) [source]

Псевдоним для set_weight

set_ha(align) [source]

Псевдоним для set_horizontalalignment

set_horizontalalignment(align) [source]

Устанавливает горизонтальное выравнивание в одном из

ПРИНИМАЕТ: [ 'center' | 'right' | 'left' ]

set_linespacing(spacing) [source]

Устанавливает интервал между строками в качестве кратного размера шрифта. По умолчанию 1.2.

ПРИНИМАЕТ: число с плавающей запятой (кратное размера шрифта)

set_ma(align) [source]

Псевдоним для set_multialignment

set_multialignment(align) [source]

Устанавливает выравнивание для нескольких строк. Макет области ограничивающей рамки всех строк определяется свойствами horizontalalignment и verticalalignment, но многострочный текст в этой области может быть

ПРИНИМАЕТ: ['left' | 'right' | 'center' ]

set_name(fontname) [source]

Псевдоним для set_family

set_position(xy) [source]

Устанавливает позицию (x, y) текста

ПРИНИМАЕТ: (x,y)

set_rotation(s) [source]

Установить угол поворота текста

ПРИНИМАЕТ: [ угол в градусах | 'вертикально' | 'горизонтально' ]

set_rotation_mode(m) [source]

Установить режим поворота текста.

Параметры:	m : None or "default" or "anchor" Если None или "default", текст сначала повернётся, а затем будет выровнен в соответствии с горизонтальным и вертикальным выравниванием. Если "anchor", то выравнивание происходит до поворота.

set_size(fontsize) [source]

Установить размер шрифта. Может быть строкой размера, относительной к размеру шрифта по умолчанию, или абсолютным размером шрифта в пунктах.

ПРИНИМАЕТ: [размер в пунктах | 'xx-small' | 'x-small' | 'small' |

'medium' | 'large' | 'x-large' | 'xx-large' ]

set_stretch(stretch) [source]

Установить начертание шрифта (горизонтальное сжатие или расширение).

ПРИНИМАЕТ: [числовое значение в диапазоне 0-1000 | 'ultra-condensed' |

'extra-condensed' | 'condensed' | 'semi-condensed' | 'normal' | 'semi-expanded' | 'expanded' | 'extra-expanded' | 'ultra-expanded' ]

set_style(fontstyle) [source]

Установить стиль шрифта.

ПРИНИМАЕТ: [ 'normal' | 'italic' | 'oblique']

set_text(s) [source]

Установить строку текста s

Может содержать новые строки (\n) или математические обозначения в формате LaTeX.

ПРИНИМАЕТ: строка или что-либо, что можно распечатать с помощью преобразования '%s'.

set_usetex(usetex) [source]

Параметры:	usetex : bool or None Использовать TeX для рендеринга, None означает использовать rcParams["text.usetex"].

set_va(align) [source]

Псевдоним для set_verticalalignment

set_variant(variant) [source]

Установить вариант шрифта, 'normal' или 'small-caps'.

ПРИНИМАЕТ: [ 'normal' | 'small-caps' ]

set_verticalalignment(align) [source]

Установить вертикальное выравнивание

ПРИНИМАЕТ: [ 'center' | 'top' | 'bottom' | 'baseline' ]

set_weight(weight) [source]

Установить начертание шрифта.

ПРИНИМАЕТ: [числовое значение в диапазоне 0-1000 | 'ultralight' | 'light' |

'normal' | 'regular' | 'book' | 'medium' | 'roman' | 'semibold' | 'demibold' | 'demi' | 'bold' | 'heavy' | 'extra bold' | 'black' ]

set_wrap(wrap) [source]

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

Параметры:	wrap : bool

set_x(x) [source]

Установить координату x текста

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

set_y(y) [source]

Установить координату y текста

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

update(kwargs) [source]

Обновить свойства из словаря.

update_bbox_position_size(renderer) [source]

Обновить положение и размер области. Этот метод необходимо использовать, когда положение и размер области должны быть обновлены перед фактической отрисовкой области.

update_from(other) [source]

Копировать свойства из other в self

zorder = 3

class matplotlib.text.TextWithDash(x=0, y=0, text='', color=None, verticalalignment='center', horizontalalignment='center', multialignment=None, fontproperties=None, rotation=None, linespacing=None, dashlength=0.0, dashdirection=0, dashrotation=None, dashpad=3, dashpush=0) [source]

Основы: matplotlib.text.Text

Это в основном Text с тире (нарисованным с помощью Line2D) перед/после него. Он предназначен для прямого замещения Text и должен вести себя идентично ему, когда dashlength = 0.0.

Тире всегда находится между точкой, указанной set_position(), и текстом. Когда тире существует, аргументы выравнивания текста (horizontalalignment, verticalalignment) игнорируются.

dashlength — длина тире в единицах холста. (по умолчанию = 0.0).

dashdirection — одно из значений 0 или 1, где 0 рисует тире после текста, а 1 — перед. (по умолчанию = 0).

dashrotation задаёт поворот тире и обычно должен оставаться None. В этом случае get_dashrotation() возвращает get_rotation(). (т.е. тире принимает свой поворот от поворота текста). Поскольку центр текста проецируется на тире, значительные отклонения в повороте приводят к визуально непривлекательным результатам. (по умолчанию = None)

dashpad — это длина отступа, которая добавляется (или вычитается) для создания промежутка между текстом и тире в единицах холста. (по умолчанию = 3)

dashpush «отодвигает» тире и текст от точки, указанной set_position(), на указанное значение в единицах холста. (по умолчанию = 0)

Примечание

Выравнивание двух объектов основано на области, определяемой рамкой Text, полученной с помощью get_window_extent(). Это, в свою очередь, зависит от метрик шрифта, заданных ядром визуализации. Поэтому качество «центрирования» текста метки относительно тире зависит от используемого ядра.

Примечание

Я не уверен, что правильно понял get_window_extent(), или достаточно ли этого для определения области объекта.

draw(renderer) [source]

Отобразить объект TextWithDash на заданном renderer.

get_dashdirection() [source]

Получить направление тире. 1 — перед текстом, 0 — после.

get_dashlength() [source]

Получить длину тире.

get_dashpad() [source]

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

get_dashpush() [source]

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

get_dashrotation() [source]

Получить угол поворота тире в градусах.

get_figure() [source]

возвратить экземпляр фигуры, к которому принадлежит элемент

get_position() [source]

Возвращает позицию текста как кортеж (x, y)

get_prop_tup(renderer=None) [source]

Возвращает хешируемый кортеж свойств.

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

get_unitless_position() [source]

Возвращает безразмерную позицию текста как кортеж (x, y)

get_window_extent(renderer=None) [source]

Возвращает объект Bbox, определяющий область текста в единицах отображения.

Помимо внутреннего использования, это полезно для задания нажимаемых областей в файле png на веб-странице.

renderer по умолчанию равен атрибуту _renderer объекта текста. Он не назначается до первого выполнения draw(), поэтому вы должны использовать этот аргумент, если хотите вызвать get_window_extent() до первого draw(). Для получения областей веб-страниц проще вызвать метод после сохранения фигуры.

set_dashdirection(dd) [source]

Установить направление тире, идущего за текстом. 1 — перед текстом, 0 — после. По умолчанию 0, что нужно для типичного случая делений ниже и слева от фигуры.

ПРИНИМАЕТ: int (1 — перед, 0 — после)

set_dashlength(dl) [source]

Установить длину тире.

ПРИНИМАЕТ: float (единицы холста)

set_dashpad(dp) [source]

Установить «отступ» TextWithDash, который представляет собой дополнительный отступ между тире и текстом в единицах холста.

ПРИНИМАЕТ: float (единицы холста)

set_dashpush(dp) [source]

Установить «сдвиг» TextWithDash, который представляет собой дополнительный отступ между началом тире и заданной позицией.

ПРИНИМАЕТ: float (единицы холста)

set_dashrotation(dr) [source]

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

ПРИНИМАЕТ: float (градусы)

set_figure(fig) [source]

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

ПРИНИМАЕТ: экземпляр matplotlib.figure.Figure

set_position(xy) [source]

Установить позицию (x, y) TextWithDash.

ПРИНИМАЕТ: (x, y)

set_transform(t) [source]

Установите экземпляр matplotlib.transforms.Transform, используемый этим объектом.

ПРИНИМАЕТ: экземпляр matplotlib.transforms.Transform.

set_x(x) [source]

Установите позицию по оси x для TextWithDash.

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

set_y(y) [source]

Установите позицию по оси y для TextWithDash.

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

update_coords(renderer) [source]

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

matplotlib.text.get_rotation(rotation) [source]

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

rotation может быть 'horizontal', 'vertical' или числовым значением в градусах.