UI Object that displays one or several circles. This object is typically used as an overlay for an image.

If no data source is specified, a single circle will be drawn in the center of the frame. If a data source is defined it will be used to set the center of one or several circles. The positions must be between 0 and 1.

The different circles can be given different colors by specifying a list of colors or a color table for the color attribute.

the circle object
Example Circle Views

Example XML definition



Attribute Description Default
class must be "Circle"  
title title of the object module.source
x placement of the object  
y placement of the object  
w width of the object 1
h height of the object 1
module name of the module to be visualized  
source name of the output to be visualized  
length_module module with length data module
length_source source with length data indicating the number of valid rows in the source  
order format of the data (row, col) col
select select the first column in the source matrix to use; if not set, the whole matrix will be used 0
select_size select the column in the source matrix to use for the size of the circles; if not set, the size attribute will be used
scale_size is select_size is set, the size of each circle will be scaled with this value 1
min minimum value 0
max maximum value 1
min_x minimum value for x min
max_x maximum value for x max
min_y minimum value for y min
max_y maximum value for y max
flip_x_axis flip the coordinate system (yes, no) "no"
flip_y_axis flip the coordinate system (yes, no) "no"
color* color of the lines or color list "yelow"
fill* color for filling or color list "none"
line_width* line width in pixels 1
line_dash* line dash pattern (see HTML 5 canvas) []

* For these attributes, an array can be supplied instead of a single value. Each line will pick the next value from the array, for example "red, green" will color every other line red and the others green.


Christian Balkenius
Lund University Cognitive Science