2016-11-21 23:03:25 +01:00
|
|
|
[[tagcloud-chart]]
|
2016-12-03 00:56:22 +01:00
|
|
|
== Tag Clouds
|
2016-11-21 23:03:25 +01:00
|
|
|
|
2017-06-27 19:13:42 +02:00
|
|
|
A tag cloud visualization is a visual representation of text data, typically used to visualize free form text.
|
2016-11-21 23:03:25 +01:00
|
|
|
Tags are usually single words, and the importance of each tag is shown with font size or color.
|
|
|
|
|
|
|
|
The font size for each word is determined by the _metrics_ aggregation. The following aggregations are available for
|
|
|
|
this chart:
|
|
|
|
|
|
|
|
include::y-axis-aggs.asciidoc[]
|
|
|
|
|
|
|
|
|
|
|
|
The _buckets_ aggregations determine what information is being retrieved from your data set.
|
|
|
|
|
|
|
|
Before you choose a buckets aggregation, select the *Split Tags* option.
|
|
|
|
|
|
|
|
You can specify the following bucket aggregations for tag cloud visualization:
|
|
|
|
|
2017-06-27 19:13:42 +02:00
|
|
|
*Terms*:: A {ref}/search-aggregations-bucket-terms-aggregation.html[_terms_] aggregation enables you to specify the top
|
2016-11-21 23:03:25 +01:00
|
|
|
or bottom _n_ elements of a given field to display, ordered by count or a custom metric.
|
|
|
|
|
|
|
|
You can click the *Advanced* link to display more customization options for your metrics or bucket aggregation:
|
|
|
|
|
|
|
|
*JSON Input*:: A text field where you can add specific JSON-formatted properties to merge with the aggregation
|
|
|
|
definition, as in the following example:
|
|
|
|
|
|
|
|
[source,shell]
|
|
|
|
{ "script" : "doc['grade'].value * 1.2" }
|
|
|
|
|
|
|
|
NOTE: In Elasticsearch releases 1.4.3 and later, this functionality requires you to enable
|
2017-06-27 19:13:42 +02:00
|
|
|
{ref}/modules-scripting.html[dynamic Groovy scripting].
|
2016-11-21 23:03:25 +01:00
|
|
|
|
|
|
|
|
|
|
|
Select the *Options* tab to change the following aspects of the chart:
|
|
|
|
|
|
|
|
*Text Scale*:: You can select *linear*, *log*, or *square root* scales for the text scale. You can use a log
|
|
|
|
scale to display data that varies exponentially or a square root scale to
|
|
|
|
regularize the display of data sets with variabilities that are themselves highly variable.
|
|
|
|
*Orientation*:: You can select how to orientate your text in the tag cloud. You can choose one of the following options:
|
|
|
|
Single, right angles and multiple.
|
|
|
|
*Font Size*:: Allows you to set minimum and maximum font size to use for this visualization.
|