exponenta event banner

clabel

Отметка на графике горизонталей

Описание

пример

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 точкам.

Примеры

свернуть все

Создайте контурный график и получите контурную матрицу. 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.

Пометить только контуры уровнями контуров 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.

Установите размер шрифта меток равным 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.

Создайте график горизонталей и верните матрицу горизонталей. 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. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл 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 сначала свойство, чтобы оси правильно интерпретировали указанный размер шрифта.

Примечание

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

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

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

Примечание

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)

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

свернуть все

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

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

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

См. также

Функции

Свойства

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