Draws a circle (really an ellipse) of the designated size based on the variable named in txt. The circle is colored according to the value relabeling options, which are interpreted as RGB color definitions. For example
COLORCIRCLE,"STOP VAL?0=0-256-0?1=256-256-0?2=256-0-0",10,10,20,20
Would draw a green circle if STOP VAL is 0, yellow is STOP VAL is 1 and red if STOP VAL is 2. If STOP VAL were to take on any other value the circle would be shown as black.
For subscripted variables COLORCIRCLE uses the last subscript to divide up the circle into a series of equal sized pie wedges, and the second last subscripts to divide the circle into a series of radii. If there is only one subscript, the pie wedges will all start at the center and go to the edge. Consider the equations:
rad : (r1-r2) ~~|
arc: (a1-a2) ~~|
color[rad,arc] = rad + .1*arc ~~|
and the control
COLORCIRCLE,"COLOR[rad,arc]?1.1=0-0-0?1.2=128-128-128?\
2.1=192-192-192?2.2=256-256-256",10,10,80,80
The use of gray scale here is for the purposes of printed output only. In general you will want to use colors to see what is happening.
The variable name is subscripted using Subscript Ranges. Vensim expands those subscript ranges to determine how many values there are. If you use a Subscript Constant it is treated literally. You can use the format var[subscript range, subscript constant] to get concentric circles.
See the SHOWVAR command for more discussion on the conventions around specifying the time, run and so on for the variable's data.
COLORCIRCLE and COLORRECT provide a novel and sometimes very powerful method for displaying three dimensional data. The COLORCIRCLE control is most powerful if there is a reasonable physical interpretation of the circle (locations in a city for example). COLORRECT is appropriate for showing such things as the value of two parameters are they influence an output.
