textscatter

2-D график поля точек текста

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

Синтаксис

ts = textscatter(x,y,str)
ts = textscatter(xy,str)
ts = textscatter(ax,___)
ts = textscatter(___,Name,Value)

Описание

пример

ts = textscatter(x,y,str) создает текстовый график поля точек с элементами str в местах, заданных векторами x и y, и возвращает получившееся TextScatter объект.

пример

ts = textscatter(xy,str) использует местоположения, заданные строками xy. Этот синтаксис эквивалентен textscatter(xy(:,1),xy(:,2),str).

ts = textscatter(ax,___) графики в оси ax. Можно использовать любые входные параметры из предыдущих синтаксисов.

ts = textscatter(___,Name,Value) задает дополнительные TextScatter свойства с использованием одного или нескольких аргументов пары "имя-значение".

Примеры

свернуть все

Открыть Live Script

Постройте график строковых массивов чисел в случайных точках на графике поля точек текста.

x = rand(50,1);
y = rand(50,1);
str = string(1:50);
figure
textscatter(x,y,str);

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

Также можно передать координаты x и y как матрица xy, где x и y являются столбцами xy.

xy = [x y];
figure
textscatter(xy,str)

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

Открыть Live Script

Создайте график поля точек текста для встраивания слова и задайте цвета слова.

Загрузите предварительно обученное встраивание слов с помощью fastTextWordEmbedding. Эта функция требует Text Analytics Toolbox™ Model для fastText English 16 млрд Token Word Embedding пакет поддержки. Если этот пакет поддержки не установлен, то функция предоставляет ссылку на загрузку.

emb = fastTextWordEmbedding
emb = 
  wordEmbedding with properties:

     Dimension: 300
    Vocabulary: [1×1000000 string]

Преобразуйте первые 500 слов в векторы с помощью word2vec. V является матрицей векторов слов длиной 300.

words = emb.Vocabulary(1:500);
V = word2vec(emb,words);
size(V)
ans = 1×2

   500   300

Встройте векторы слов в двумерное пространство с помощью tsne.

XY = tsne(V);

Постройте график слов в координатах, заданных XY в 2-D текстовом графике поля точек. Задайте случайные цвета слов.

numWords = numel(words);
colorData = rand(numWords,3);
figure
textscatter(XY,words,'ColorData',colorData)
title("Word Embedding t-SNE Plot")

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

свернуть все

x значения, заданные как вектор. x, y, и str должна иметь одинаковую длину.

Пример: [1 2 3]

y значения, заданные как вектор. x, y, и str должна иметь одинаковую длину.

Пример: [1 2 3]

x и y значения, заданные как матрица с двумя столбцами. xy(i,1) и xy(i,2) соответствуют x и y значениям i-го элемента str, соответственно. xy должны иметь numel(str) строки.

textscatter(xy,str) эквивалентно textscatter(xy(:,1),xy(:,2),str).

Пример: [1 2 3]

Вход текст, заданный как строковые массивы или массив ячеек векторов символов. x, y, и str должна иметь одинаковую длину.

Пример: ["one" "two" "three"]

Типы данных: string | cell

Объект осей. Если вы не задаете объект осей, то функция использует текущие системы координат.

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

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

Пример: 'Marker','*' определяет маркеры, которые должны быть звездочками.

The TextScatter перечисленные здесь свойства объектов являются только подмножеством. Полный список см. в разделе Свойства TextScatter.

Процент отображаемых текстовых данных, заданный как скаляр от 0 до 100. Чтобы показать весь текст, задайте TextDensityPercentage до 100. Чтобы не показывать текст, задайте TextDensityPercentage в 0.

Если вы задаете TextDensityPercentage до 100, тогда программное обеспечение не строит маркеры.

Пример: 70

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

Пример: 10

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

  • 'auto' - Для каждого маркера используйте тот же цвет, что и соответствующие текстовые метки.

  • 'none' - Не показывать маркеры.

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

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

Текстовые цвета, заданные как одно из следующих значений:

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

  • Трехколоночная матрица триплетов RGB - используйте другой цвет для каждой текстовой метки на графике. Каждая строка матрицы задает один цвет. Количество строк должно равняться количеству текстовых меток.

  • Категориальный вектор - Использование другого цвета для каждой категории в векторе. Задайте ColorData как вектор с той же длиной, что и XData. Задайте цвета для каждой категории используя Colors свойство

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

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

По умолчанию Colors равно ColorOrder свойство объекта осей.

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

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

свернуть все

TextScatter объект. Использование ts для доступа и изменения свойств текста, диаграммы поля точек после создания. Дополнительные сведения см. в разделе Свойства TextScatter.

См. также

| | | | |

Темы

Введенный в R2017b

Symbolic Math Toolbox

Поддержка

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