textscatter3
3-D scatter plot of text
Syntax
Description
specifies additional ts
= textscatter3(___,Name,Value
)TextScatter
properties using one or more
name-value pair arguments.
Examples
Create 3-D Text Scatter Plot
Plot a string array of numbers at random points on a 3-D text scatter plot.
x = rand(50,1); y = rand(50,1); z = rand(50,1); str = string(1:50); figure textscatter3(x,y,z,str);
Alternatively, you can pass the coordinates x
, y
, and z
as a matrix xyz
, where x
, y
, and z
are the columns of xyz
.
xyz = [x y z]; figure textscatter3(xyz,str)
Specify Word Colors
Create text scatter plot of a word embedding and specify word colors.
Load a pretrained word embedding using fastTextWordEmbedding
. This function requires Text Analytics Toolbox™ Model for fastText English 16 Billion Token Word Embedding support package. If this support package is not installed, then the function provides a download link.
emb = fastTextWordEmbedding;
Convert the first 250 words to vectors using word2vec
. V
is a matrix of word vectors of length 300.
words = emb.Vocabulary(1:250); V = word2vec(emb,words); size(V)
ans = 1×2
250 300
Embed the word vectors in a 3-D space using tsne
.
XYZ = tsne(V,'NumDimensions',3);
Plot the words at the coordinates specified by XYZ
in a 3-D text scatter plot. Specify the word colors to be random.
numWords = numel(words); colorData = rand(numWords,3); figure textscatter3(XYZ,words,'ColorData',colorData) title("Word Embedding t-SNE Plot")
Input Arguments
xyz
— x, y, and z values
matrix
x, y, and z
values, specified as a matrix. The first, second, and third columns of
xyz
correspond to the x,
y, and z values,
respectively.
ax
— Axes object
axes object
Axes object. If you do not specify an axes object, then the function uses the current axes.
Name-Value Arguments
Specify optional pairs of arguments as
Name1=Value1,...,NameN=ValueN
, where Name
is
the argument name and Value
is the corresponding value.
Name-value arguments must appear after other arguments, but the order of the
pairs does not matter.
Before R2021a, use commas to separate each name and value, and enclose
Name
in quotes.
Example: 'Marker','*'
specifies the markers to be
asterisks.
The TextScatter
object properties listed here are only a subset.
For a complete list, see TextScatter Properties.
TextDensityPercentage
— Percentage of text data to show
60 (default) | scalar from 0 through 100
Percentage of text data to show, specified as a scalar from 0 through 100. To show all text,
set TextDensityPercentage
to 100. To show no text, set
TextDensityPercentage
to 0.
If you set TextDensityPercentage
to 100, then the software does not plot markers.
Example: 70
MaxTextLength
— Maximum length of text labels
40 (default) | positive integer
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
MarkerColor
— Marker colors
'auto'
(default) | 'none'
| RGB triplet
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]
ColorData
— Text colors
[]
(default) | RGB triplet | matrix of RGB triplets | categorical vector
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. Specify
ColorData
as a vector the same length asXData
. Specify the colors for each category using theColors
property
Example: [1 0 0; 0 1 0; 0 0 1]
Colors
— Category colors
matrix of RGB triplets
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, Colors
is equal to the ColorOrder
property of the axes object.
Example: [1 0 0; 0 1 0; 0 0 1]
Output Arguments
ts
— TextScatter
object
TextScatter
object
TextScatter
object. Use ts
to access and
modify properties of the text scatter chart after it has been created. For more
information, see TextScatter Properties.
Version History
Introduced in R2017b
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)