github-mirrors/kibana
1
0
Fork 0
mirror of https://github.com/elastic/kibana.git synced 2025-04-23 17:28:26 -04:00
Code Issues Projects Releases Packages Wiki Activity

doc checkin

Browse source
This commit is contained in:
Thomas Neirynck 2016-11-21 16:21:17 -05:00
parent 63101d2c36
commit fefa40a4c0
2 changed files with 48 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

2
docs/visualize.asciidoc
View file

@ -118,3 +118,5 @@ include::visualize/pie.asciidoc[]
include::visualize/tilemap.asciidoc[]
include::visualize/vertbar.asciidoc[]
include::visualize/tagcloud.asciidoc[]

46
docs/visualize/tagcloud.asciidoc Normal file
View file

@ -0,0 +1,46 @@
[[tagcloud]]
== Tag Cloud
A tag cloud visualization is a visual representation of text data, typically used to visualize free form text.
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:
*Terms*:: A {es-ref}search-aggregations-bucket-terms-aggregation.html[_terms_] aggregation enables you to specify the top
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
{es-ref}modules-scripting.html[dynamic Groovy scripting].
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. This kind of data, where
the variability is itself variable over the domain being examined, is known as _heteroscedastic_ data. For example, if
a data set of height versus weight has a relatively narrow range of variability at the short end of height, but a wider
range at the taller end, the data set is heteroscedastic.
*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.
include::visualization-raw-data.asciidoc[]