Skip to main content
Jump to: navigation, search

GEF/GEF4/Cloudio/User Guide

< GEF‎ | GEF4‎ | Cloudio
Revision as of 07:35, 20 May 2016 by Miklossy.itemis.de (Talk | contribs) (fix a typo)

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 Description

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

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.

Number of Words: allows the user to set the maximum number of elements which will be displayed on 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.

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.

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".

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 weight of the more frequently occuring words are more enhanced).

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 tag cloud. The displayed elements will be updated using 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.

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.

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

Below are some 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).

GEF4 Introduction

GEF4 TagCloud 1.png GEF4 TagCloud 2.png

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