Skip to main content
Jump to: navigation, search

GEF/GEF4/Cloudio/User Guide

< GEF‎ | GEF4‎ | Cloudio
Revision as of 01:00, 21 May 2016 by Miklossy.itemis.de (Talk | contribs) (move the description of the background mask at the end, since this is the most special setting)

Note to non-wiki readers: This documentation is generated from the Eclipse wiki - if you have corrections or additions it would be awesome if you added them in the original wiki page.


Introduction

The GEF4 Cloudio component provides a Tag Cloud view that can be used to create word clouds.

GEF4-Cloudio-TagCloud.png

The words, which are used to render the word cloud can be loaded from a text file via the 'File -> Load File'. In case the file contains words that should be excluded from the word cloud, a list of stop words (blacklist) can be loaded in addition via 'File -> Load Stopwords'. After having loaded words and/or stop words, the tag cloud is automatically rendered. The rendered tag cloud can be exported to an PNG file via 'File -> Export Image'.

The Cloudio Control Panel

The view delivers various controls on the Cloudio Control Panel to adjust the generation of the word cloud. Currently, the following settings are supported:

Number of Words: allows the user to set the maximum number of elements which will be displayed on the tag cloud. The predefined values are 100, 200, 300, 400, 500, 600, 700, 800, 900, 1000, 1100, 1200, 1300, 1400, 1500, 1600, 1700, 1800, 1900, 2000. The screenshot below represents the GEF4 Cloudio Tag Cloud limited to the first 100 most frequently occurring words:

GEF4 TagCloud 3.png

Fonts: allows the user to define new fonts (or switch between the predefined ones) which are used for the rendering font of the tag cloud.

Max Font Size: allows the user to set the maximum font size used by the tag cloud rendering. Note that the words which are too large to fit into the cloud region will be ignored. By default, this value is 100.

Min Font Size: allows the user to set the minimum font size. By default, this value is 12. GEF4 Cloudio Tag Cloud with different font settings.

The screenshot below represents the GEF4 Cloudio Tag Cloud with different font settings:

GEF4 TagCloud 4.png

Boost: allows the user to enable element boosting (extra enlarging). When the boost is set to 0 (by default), no elements are enlarged. When the boost is set to 10, the first 10 most frequently appearing elements are enlarged.

Boost Factor: allows the user to specify the boost factor used by the boosting (extra enlarging). When the boost factor is set to 1 (by default), the elements are enlarged by factor 1 (no extra enlarging). When the boost is set to 5, the "to be boosted" elements will appear 5 times larger than the other elements.

The screenshot below represents the GEF4 Cloudio Tag Cloud where the first 10 most frequently occurring words are extra enlarged by a factor of 5:

GEF4 TagCloud 5.png

Angles: allows the user to set the words orientation used by the rendering of the tag cloud. The predefined values are: "Horizontal only" (the words are aligned parallel to the x-axis), "Vertical only" (the words are aligned parallel to the y-axis), "Horizontal & Vertical" (the words are aligned either parallel to the x-axis or parallel to the y-axis), "45 Degrees" (the words can be aligned diagonally) "45 Degrees , mostly horizontal" and "Random". The following screenshots represents the tag cloud with the different angle settings:

GEF4 TagCloud 6 angles horizontal only.png GEF4 TagCloud 7 angles vertical only.png GEF4 TagCloud 8 angles horizontal and vertical.png GEF4 TagCloud 9 angles 45 degrees mostly horizontal.png GEF4 TagCloud 10 angles 45 degrees.png GEF4 TagCloud 11 angles random.png

Scale: allows the user to set the scaling factor that are used to visualize the differences (to determine the "drawing weight" of each words) on the tag cloud. The predefined values are "linear" (the differences are spreaded evenly among the word weights) and "logarithmic" (the differences are spreaded logaritmically among the word weights). The following two screenshots represent the differences between the logaritmic and the linear scale settings, respectively.

GEF4 TagCloud 12 scale logaritmic.png GEF4 TagCloud 13 scale linear.png

X Axis Variation: allows the user to set the percentage of the x axis variation. By default, searching for free space is started in the center of the available area. By increasing this value the start point will be moved on the x axis.

Y Axis Variation: allows the user to set the percentage of the y axis variation. By default, searching for free space is started in the center of the available area. By increasing this value, the start point will be moved on the y axis.

Re-Position: allows the user to re-position the words on the tag cloud. The displayed elements will only be re-positioned, keeping fonts, colors and angles untouched.

Re-Layout: allows the user to re-layout the words on tag cloud. The displayed elements will be completely updated using all the current values of the Cloudio Control Panel (inclusive the font, color and angle settings).

Colors: allows the user to define new color schemes (or switch between the predefined ones) which are used as the foregound/background rendering colors of the tag cloud. The screenshots below represent the tag could based on the GEF4 Introduction document rendered with different color schemes:

GEF4 TagCloud 1.png GEF4 TagCloud 2.png

Mask: allows the user to upload a background mask (a square PNG image containing black and white pixels only) to modify the rendering of the tag cloud so that the words are drawn only on the white areas, since the black pixels are interpreted as used. The following two screenshots represent such a background mask and the GEF4 Cloudio Tag Cloud rendering result based on that background mask:

GEF4 Mask Image.png GEF4 Cloudio.png

After any changes to these properties, the tag cloud can be rendered again using 'Re-Position' or 'Re-Layout'.

Below are some further examples of tag clouds generated with Cloudio. The images were created with the help of the TagCloud view, modifying different parameters (such as colors, fonts or rotation angles).

Woyzeck

Zest cloudio woyzeck.png

Created from Georg Büchner's Woyzeck. The most frequent word was boosted.

Winnetou

Zest cloudio winnetou.png

Karl May's Winnetou III, using two different fonts, 45-degree rotation and a relatively large x-axis variation when placing the words.

Nietzsche

Zest cloudio nietzsche.png

'Also sprach Zarathustra', by Nietzsche. 90 degree rotation and a large x-axis variation.

Woyzeck Cluster

Zest cloudio woyzeck cluster.png

Same text as in the first example, but with a modified layout algorithm and label provider: Both labels and initial position are assigned based on the first character of the word (for instance, words starting with a to l are at the bottom left). Doesn't really look good, but shows how to extend the functionality to realize a cluster visualization or else...


Back to the top