clabel

Метка подъема контурного графика

Свернуть все на странице

Синтаксис

clabel(C,h)
clabel(C,h,v)
clabel(C,h,'manual')
t = clabel(C,h,'manual')
clabel(C)
clabel(C,v)
clabel(C,'manual')
tl = clabel(___)
clabel(___,Name,Value)

Описание

пример

clabel(C,h) помечает текущий контурный график повернутым текстом, вставленным в каждую контурную линию. Контурные линии должны быть достаточно длинными, чтобы соответствовать метке, в противном случае clabel не вставляет метку. Если у вас нет матрицы контуров C, затем замените C с [].

пример

clabel(C,h,v) помечает уровни контура, заданные вектором v.

clabel(C,h,'manual') помечает выбранные местоположения мышью. Щелкните мышью или нажмите клавишу пробел, чтобы пометить контур, ближайший к центру перекрестия. Нажмите клавишу Return, пока курсор находится внутри окна рисунка, чтобы завершить маркировку.

t = clabel(C,h,'manual') возвращает созданные текстовые объекты.

пример

clabel(C) метки контуров с помощью '+' символы и вертикальный текст.

clabel(C,v) добавляет вертикальные метки к уровням контура, заданным вектором, v.

clabel(C,'manual') добавляет вертикальные метки в выбранных расположениях с помощью мыши. Щелкните мышью или нажмите клавишу пробел, чтобы пометить контур, ближайший к центру перекрестия. Нажмите клавишу Return, пока курсор находится внутри окна рисунка, чтобы завершить маркировку.

tl = clabel(___) возвращает созданные текст и объекты линии. Используйте любое из комбинаций входных аргументов в предыдущих синтаксисах, которые не включают объект контура h.

пример

clabel(___,Name,Value) изменяет внешний вид метки с помощью одной или нескольких Name,Value аргументы в виде пар. Используйте любой из комбинаций входных аргументов в предыдущих синтаксисах. Для примера, 'FontSize',14 устанавливает размер шрифта равным 14 точкам.

Примеры

свернуть все

Открыть Live Script

Создайте контурный график и получите контурную матрицу, C, и объект контура, h. Затем пометьте контурный график.

[x,y,z] = peaks;
[C,h] = contour(x,y,z);   
clabel(C,h)

Figure contains an axes. The axes contains an object of type contour.

Открыть Live Script

Пометьте только контуры с уровнями контуров 2 или 6. 

[x,y,z] = peaks;
[C,h] = contour(x,y,z);
v = [2,6];
clabel(C,h,v)

Figure contains an axes. The axes contains an object of type contour.

Открыть Live Script

Установите размер шрифта меток равным 15 точкам и установите цвет красным с помощью Name,Value аргументы в виде пар.

[x,y,z] = peaks;
[C,h] = contour(x,y,z);
clabel(C,h,'FontSize',15,'Color','red')

Figure contains an axes. The axes contains an object of type contour.

Установите дополнительные свойства путем переиздания clabel команда. Для примера установите полужирную толщину шрифта и измените цвет на синий. 

clabel(C,h,'FontWeight','bold','Color','blue')

Figure contains an axes. The axes contains an object of type contour.

Верните размер шрифта к размеру по умолчанию с помощью 'default' ключевое слово.

clabel(C,h,'FontSize','default')

Figure contains an axes. The axes contains an object of type contour.

Открыть Live Script

Создайте контурный график и верните контурную матрицу, C. Затем пометьте контуры.

[x,y,z] = peaks;
C = contour(x,y,z);  
clabel(C)

Figure contains an axes. The axes contains 25 objects of type contour, line, text.

Входные параметры

свернуть все

Матрица контура, возвращенная contour, contour3, или contourf функция. C содержит данные, определяющие контурные линии. Для получения дополнительной информации о горизонтальной матрице смотрите ContourMatrix.

Примечание

Если вы передаете объект контура h на clabel функцию, тогда можно заменить C с []. Для примера используйте clabel([],h).

Объект контура, возвращенный contour, contour3, или contourf функция.

Значения уровня контура, заданные как строка или вектор-столбец отдельных значений.

Пример: [0 10 20]

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: clabel(C,h,'Color','red','FontSize',12) задает красные метки с 12 точками.

clabel поддерживает LabelSpacing свойство плюс подмножество текстовых свойств.

Пространство между метками, заданное в виде скалярного значения в модули точки.

Примечание

Используйте эту опцию с любым из clabel(C,h) или clabel(C,h,v) синтаксис. Другие синтаксисы не поддерживают эту опцию.

Пример: clabel(C,h,'LabelSpacing',100)

Цвет текста, заданный как триплет RGB, шестнадцатеричный код цвета, название цвета или краткое имя. Значение по умолчанию [0 0 0] соответствует черному.

Для пользовательского цвета укажите триплет RGB или шестнадцатеричный код цвета.

  • Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; для примера, [0.4 0.6 0.7].

  • Шестнадцатеричный код цвета - это вектор символов или строковый скаляр, который начинается с хэш-символа (#), за которым следуют три или шесть шестнадцатеричных цифр, которые могут варьироваться от 0 на F. Значения не зависят от регистра. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' являются эквивалентными.

Кроме того, вы можете задать имена некоторых простых цветов. В этой таблице перечислены именованные опции цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Название цветаКраткое имяТриплет RGBШестнадцатеричный цветовой кодВнешность
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

'none'Не применяетсяНе применяетсяНе применяетсяНет цвета

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию MATLAB® использует на многих типах графиков.

Триплет RGBШестнадцатеричный цветовой кодВнешность
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

Пример: 'blue'

Пример: [0 0 1]

Пример: '#0000FF'

Цвет контура текстового поля, заданный как 'none', триплет RGB, шестнадцатеричный цветовой код, название цвета или краткое имя.

Для пользовательского цвета укажите триплет RGB или шестнадцатеричный код цвета.

  • Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; для примера, [0.4 0.6 0.7].

  • Шестнадцатеричный код цвета - это вектор символов или строковый скаляр, который начинается с хэш-символа (#), за которым следуют три или шесть шестнадцатеричных цифр, которые могут варьироваться от 0 на F. Значения не зависят от регистра. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' являются эквивалентными.

Кроме того, вы можете задать имена некоторых простых цветов. В этой таблице перечислены именованные опции цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Название цветаКраткое имяТриплет RGBШестнадцатеричный цветовой кодВнешность
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

'none'Не применяетсяНе применяетсяНе применяетсяНет цвета

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

Триплет RGBШестнадцатеричный цветовой кодВнешность
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

Пример: clabel(C,h,'EdgeColor','k')

Цвет фона текстового поля, заданный как 'none', триплет RGB, шестнадцатеричный цветовой код, название цвета или краткое имя.

Для пользовательского цвета укажите триплет RGB или шестнадцатеричный код цвета.

  • Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; для примера, [0.4 0.6 0.7].

  • Шестнадцатеричный код цвета - это вектор символов или строковый скаляр, который начинается с хэш-символа (#), за которым следуют три или шесть шестнадцатеричных цифр, которые могут варьироваться от 0 на F. Значения не зависят от регистра. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' являются эквивалентными.

Кроме того, вы можете задать имена некоторых простых цветов. В этой таблице перечислены именованные опции цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Название цветаКраткое имяТриплет RGBШестнадцатеричный цветовой кодВнешность
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

'none'Не применяетсяНе применяетсяНе применяетсяНет цвета

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

Триплет RGBШестнадцатеричный цветовой кодВнешность
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

Пример: clabel(C,h,'BackgroundColor','g')

Размер шрифта, заданный как скалярное значение, больше 0. По умолчанию в размере шрифта используются модули точки. Одна точка равна 1/72 дюйма. Однако некоторые синтаксисы позволяют изменять модули шрифта с помощью FontUnits свойство.

Пример: clabel(C,h,'FontSize',15)

Название шрифта, заданное как поддерживаемое название шрифта шрифта или 'FixedWidth'. Для правильного отображения и печати текста необходимо выбрать шрифт, поддерживаемый системой. Шрифт по умолчанию зависит от операционной системы и локали.

Чтобы использовать шрифт фиксированной ширины, который хорошо выглядит в любой локали, используйте 'FixedWidth'. Шрифт фиксированной ширины опирается на корень FixedWidthFontName свойство. Установка корневого FixedWidthFontName свойство приводит к немедленному обновлению отображения, чтобы использовать новый шрифт.

Наклон символов, заданный как 'normal' или 'italic'.

Не все шрифты имеют оба стилей шрифта. Поэтому курсив шрифта может выглядеть так же, как и обычный шрифт.

Толщина символов, заданная как 'normal' или 'bold'.

MATLAB использует FontWeight свойство для выбора шрифта из доступных в вашей системе. Не все шрифты имеют жирный вес. Поэтому установка полужирного шрифта веса все еще может привести к нормальной толщине шрифта.

Сглаживание шрифта, заданное как 'on' или 'off', или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

  • 'on' - Применить сглаживание шрифта. Уменьшите внешний вид блуждания в текстовых символах, чтобы облегчить чтение текста.

  • 'off' - Не применять сглаживание шрифта.

Пример: clabel(C,h,'FontSmoothing','on')

Модули измерения размера шрифта, заданные как одно из значений в этой таблице.

UnitsОписание
'points'Точки. Одна точка равна 1/72 дюйма.
'inches'Дюймы.
'centimeters'Сантиметры.
'characters'

На основе размера символа системного шрифта по умолчанию.

  • Ширина символа = ширина буквы x.

  • Высота символа = расстояние между базовыми линиями двух строк текста.

'normalized' Интерпретируйте размер шрифта как часть высоты осей. При изменении размера осей размер шрифта изменяется соответствующим образом. Для примера, если FontSize является 0.1 в нормированных модулях, тогда текст равен 1/10 высоты осей.
'pixels'

Пиксели.

Начиная с R2015b, расстояния в пикселях не зависят от вашего системного разрешения в Windows® и системы Macintosh:

  • В системах Windows пиксель составляет 1/96 дюйма.

  • В системах Macintosh пиксель составляет 1/72 дюйма.

На Linux® систем, размер пикселя определяется вашим системным разрешением.

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

Примечание

The clabel(C,h) и clabel(C,h,v) синтаксис не поддерживает эту опцию. Они всегда используют значение по умолчанию точек.

Пример: clabel(C,'FontUnits','normalized')

Ориентация текста, заданная в виде скалярного значения в степенях. Поворот по умолчанию на 0 степени делает текст горизонтальным. Для вертикального текста задайте для этого свойства 90 или -90. Положительные значения поворачивают текст против часовой стрелки. Отрицательные значения поворачивают текст по часовой стрелке.

Примечание

The clabel(C,h) и clabel(C,h,v) синтаксис не поддерживает эту опцию. Вместо этого они вставляют повернутый текст в линии контура, причем каждая метка поворачивается так, чтобы соответствовать локальной ориентации соответствующей строки.

Пример: clabel(C,'Rotation',90)

Интерпретация текстовых символов, заданная как одно из следующих значений:

  • 'tex' - Отображать текст с помощью разметки TeX.

  • 'latex' - Отображать текст с помощью разметки LaTeX.

  • 'none' - Отображать буквальные символы.

Поскольку метки являются числовым текстом, эффект этого свойства ограничивается тонкими изменениями стиля и веса шрифта.

Пример: clabel(C,h,'Interpreter','latex')

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

Стиль линииОписаниеРезультирующая линия
'-'Сплошная линия

'--'Штриховая линия

':'Пунктирная линия

'-.'Штрих-пунктирная линия

'none'Нет линииНет линии

Пример: clabel(C,h,'LineStyle','--')

Ширина контура текстового поля в виде скалярного значения в модули точки. Одна точка равна 1/72 дюйма.

Пример: clabel(C,h,'LineWidth',1)

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

MATLAB использует Extent значение свойства плюс Margin значение свойства для определения размера текстового поля.

Пример: clabel(C,h,'Margin',4)

Выходные аргументы

свернуть все

Текстовые объекты, возвращенные как вектор. The String свойства текстовых объектов содержат отображаемые значения контуров.

Текст и объекты линии, возвращенные как вектор. The String свойства текстовых объектов содержат отображаемые значения контуров. Объекты линии соответствуют '+' символы.

Расширенные возможности

См. также

Функции

Свойства

Представлено до R2006a

Документация MATLAB

Поддержка

Для просмотра документации необходимо авторизоваться на сайте