Main Content

textscatter

2-D scatter plot of text

所有的页面崩溃

Syntax

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

Description

example

ts= textscatter(x,y,str)creates a text scatter plot with elements ofstrat the locations specified by the vectorsxandy, and returns the resultingTextScatterobject.

example

ts= textscatter(xy,str)uses locations specified by the rows ofxy. This syntax is equivalent totextscatter(xy(:,1),xy(:,2),str).

ts= textscatter(ax,___)plots into axesax. You can use any input arguments from previous syntaxes.

ts= textscatter(___,Name,Value)specifies additionalTextScatterproperties using one or more name-value pair arguments.

Examples

collapse all

Open Live Script

Plot a string array of numbers at random points on a text scatter plot.

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

Alternatively, you can pass the coordinatesxandyas a matrixxy, wherexandyare the columns ofxy.

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

Open Live Script

Create text scatter plot of a word embedding and specify word colors.

Load a pretrained word embedding usingfastTextWordEmbedding. This function requires Text Analytics Toolbox™ Modelfor fastText English 16 Billion Token Word Embeddingsupport package. If this support package is not installed, then the function provides a download link.

emb = fastTextWordEmbedding
emb = wordEmbedding with properties: Dimension: 300 Vocabulary: [1×1000000 string]

Convert the first 500 words to vectors usingword2vec.Vis a matrix of word vectors of length 300.

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

Embed the word vectors in two-dimensional space usingtsne.

XY = tsne(V);

Plot the words at the coordinates specified byXYin a 2-D text scatter plot. Specify the word colors to be random.

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

Input Arguments

collapse all

xvalues, specified as a vector.x,y, andstrmust be of equal length.

Example:[1 2 3]

yvalues, specified as a vector.x,y, andstrmust be of equal length.

Example:[1 2 3]

xandyvalues, specified as a matrix with two columns.xy(i,1)andxy(i,2)对应于xandyvalues of theith element ofstr, respectively.xymust have thenumel(str)rows.

textscatter(xy,str)是等效totextscatter(xy(:,1),xy(:,2),str).

Example:[1 2 3]

Input text, specified as a string array or cell array of character vectors.x,y, andstrmust be of equal length.

Example:["one" "two" "three"]

Data Types:string|cell

Axes object. If you do not specify an axes object, then the function uses the current axes.

Name-Value Pair Arguments

Specify optional comma-separated pairs ofName,Valuearguments.Nameis the argument name andValueis the corresponding value.Namemust appear inside quotes. You can specify several name and value pair arguments in any order asName1,Value1,...,NameN,ValueN.

Example:'Marker','*'specifies the markers to be asterisks.

TheTextScatterobject properties listed here are only a subset. For a complete list, seeTextScatter Properties.

Percentage of text data to show, specified as a scalar from 0 through 100. To show all text, setTextDensityPercentageto 100. To show no text, setTextDensityPercentageto 0.

If you setTextDensityPercentageto 100, then the software does not plot markers.

Example:70

Maximum length of text labels, specified as a positive integer. The software truncates the text labels to this length and adds ellipses at the point of truncation.

Example:10

Marker colors, specified as one of these values:

  • 'auto'— For each marker, use the same color as the corresponding text labels.

  • 'none'— Do not show markers.

  • RGB triplet — Use the same color for all the markers in the plot. An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range[0,1]; for example,[0.5 0.6 0.7].

Example:[1 0 0]

Text colors, specified as one of these values:

  • RGB triplet — Use the same color for all the text in the plot. An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range[0,1]; for example,[0.5 0.6 0.7].

  • Three-column matrix of RGB triplets — Use a different color for each text label in the plot. Each row of the matrix defines one color. The number of rows must equal the number of text labels.

  • Categorical vector — Use a different color for each category in the vector. SpecifyColorDataas a vector the same length asXData. Specify the colors for each category using theColorsproperty

Example:[1 0 0; 0 1 0; 0 0 1]

Category colors, specified as a matrix of RGB triplets. An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range[0,1]; for example,[0.5 0.6 0.7].

By default,Colorsis equal to theColorOrderproperty of the axes object.

Example:[1 0 0; 0 1 0; 0 0 1]

Output Arguments

collapse all

TextScatterobject. Usetsto access and modify properties of the text scatter chart after it has been created. For more information, seeTextScatter Properties.

See Also

|||||

Topics

Introduced in R2017b

Text Analytics Toolbox Documentation

金宝app

Getting Started with Text Analytics in MATLAB

Getting Started with Text Analytics in MATLAB

Download now