5 Handles laying out data on to a virtual canvas square canvas between 0.0
6 and 1.0. If you want to add new chart/plot types such as point plots,
7 you need to add them here.
11 Copyright 2005,2006 (c) Alastair Tse <alastair^liquidx.net>
12 For use under the BSD license. <http://www.liquidx.net/plotkit>
17 if (typeof(PlotKit
.Base
) == 'undefined')
23 throw "PlotKit.Layout depends on MochiKit.{Base,Color,DOM,Format} and PlotKit.Base"
26 // --------------------------------------------------------------------
27 // Start of Layout definition
28 // --------------------------------------------------------------------
30 if (typeof(PlotKit
.Layout
) == 'undefined') {
34 PlotKit
.Layout
.NAME
= "PlotKit.Layout";
35 PlotKit
.Layout
.VERSION
= PlotKit
.VERSION
;
37 PlotKit
.Layout
.__repr__
= function() {
38 return "[" + this.NAME
+ " " + this.VERSION
+ "]";
41 PlotKit
.Layout
.toString
= function() {
42 return this.__repr__();
45 PlotKit
.Layout
.valid_styles
= ["bar", "line", "pie", "point"];
47 // --------------------------------------------------------------------
48 // Start of Layout definition
49 // --------------------------------------------------------------------
51 PlotKit
.Layout
= function(style
, options
) {
54 "barWidthFillFraction": 0.75,
55 "barOrientation": "vertical",
56 "xOriginIsZero": true,
57 "yOriginIsZero": true,
58 "xAxis": null, // [xmin, xmax]
59 "yAxis": null, // [ymin, ymax]
60 "xTicks": null, // [{label: "somelabel", v: value}, ..] (label opt.)
61 "yTicks": null, // [{label: "somelabel", v: value}, ..] (label opt.)
69 // valid external options : TODO: input verification
71 MochiKit
.Base
.update(this.options
, options
? options
: {});
73 // externally visible states
74 // overriden if xAxis and yAxis are set in options
75 if (!MochiKit
.Base
.isUndefinedOrNull(this.options
.xAxis
)) {
76 this.minxval
= this.options
.xAxis
[0];
77 this.maxxval
= this.options
.xAxis
[1];
78 this.xscale
= this.maxxval
- this.minxval
;
83 this.xscale
= null; // val -> pos factor (eg, xval * xscale = xpos)
86 if (!MochiKit
.Base
.isUndefinedOrNull(this.options
.yAxis
)) {
87 this.minyval
= this.options
.yAxis
[0];
88 this.maxyval
= this.options
.yAxis
[1];
89 this.yscale
= this.maxyval
- this.minyval
;
97 this.points
= new Array(); // array of points to plot for line plots
99 this.xticks
= new Array();
100 this.yticks
= new Array();
103 this.datasets
= new Array();
108 this.hitTestCache
= {x2maxy
: null};
112 // --------------------------------------------------------------------
113 // Dataset Manipulation
114 // --------------------------------------------------------------------
117 PlotKit
.Layout
.prototype.addDataset
= function(setname
, set_xy
) {
118 this.datasets
[setname
] = set_xy
;
121 PlotKit
.Layout
.prototype.removeDataset
= function(setname
, set_xy
) {
122 delete this.datasets
[setname
];
125 // --------------------------------------------------------------------
126 // Evaluates the layout for the current data and style.
127 // --------------------------------------------------------------------
129 PlotKit
.Layout
.prototype.evaluate
= function() {
130 this._evaluateLimits();
131 this._evaluateScales();
132 if (this.style
== "line") {
133 this._evaluateLineCharts();
134 this._evaluateLineTicks();
141 // --------------------------------------------------------------------
142 // START Internal Functions
143 // --------------------------------------------------------------------
145 PlotKit
.Layout
.prototype._evaluateLimits
= function() {
146 // take all values from all datasets and find max and min
147 var map
= PlotKit
.Base
.map
;
148 var items
= PlotKit
.Base
.items
;
149 var itemgetter
= MochiKit
.Base
.itemgetter
;
150 var collapse
= PlotKit
.Base
.collapse
;
151 var listMin
= MochiKit
.Base
.listMin
;
152 var listMax
= MochiKit
.Base
.listMax
;
153 var isNil
= MochiKit
.Base
.isUndefinedOrNull
;
156 var all
= collapse(map(itemgetter(1), items(this.datasets
)));
157 if (isNil(this.options
.xAxis
)) {
158 if (this.options
.xOriginIsZero
)
161 this.minxval
= listMin(map(parseFloat
, map(itemgetter(0), all
)));
163 this.maxxval
= listMax(map(parseFloat
, map(itemgetter(0), all
)));
166 this.minxval
= this.options
.xAxis
[0];
167 this.maxxval
= this.options
.xAxis
[1];
168 this.xscale
= this.maxval
- this.minxval
;
171 if (isNil(this.options
.yAxis
)) {
172 if (this.options
.yOriginIsZero
)
175 this.minyval
= listMin(map(parseFloat
, map(itemgetter(1), all
)));
177 this.maxyval
= listMax(map(parseFloat
, map(itemgetter(1), all
)));
180 this.minyval
= this.options
.yAxis
[0];
181 this.maxyval
= this.options
.yAxis
[1];
182 this.yscale
= this.maxyval
- this.minyval
;
187 PlotKit
.Layout
.prototype._evaluateScales
= function() {
188 this.xrange
= this.maxxval
- this.minxval
;
189 if (this.xrange
== 0)
192 this.xscale
= 1/this.xrange
;
194 this.yrange
= this.maxyval
- this.minyval
;
195 if (this.yrange
== 0)
198 this.yscale
= 1/this.yrange
;
202 // Create the line charts
203 PlotKit
.Layout
.prototype._evaluateLineCharts
= function() {
204 var items
= PlotKit
.Base
.items
;
206 var setCount
= items(this.datasets
).length
;
209 this.points
= new Array();
211 for (var setName
in this.datasets
) {
212 var dataset
= this.datasets
[setName
];
213 if (PlotKit
.Base
.isFuncLike(dataset
)) continue;
214 dataset
.sort(function(a
, b
) { return compare(parseFloat(a
[0]), parseFloat(b
[0])); });
215 for (var j
= 0; j
< dataset
.length
; j
++) {
216 var item
= dataset
[j
];
218 x
: ((parseFloat(item
[0]) - this.minxval
) * this.xscale
),
219 y
: 1.0 - ((parseFloat(item
[1]) - this.minyval
) * this.yscale
),
220 xval
: parseFloat(item
[0]),
221 yval
: parseFloat(item
[1]),
225 // limit the x, y values so they do not overdraw
226 if (point
.y
<= 0.0) {
229 if (point
.y
>= 1.0) {
232 if ((point
.x
>= 0.0) && (point
.x
<= 1.0)) {
233 this.points
.push(point
);
241 PlotKit
.Layout
.prototype._evaluateLineTicksForXAxis
= function() {
242 var isNil
= MochiKit
.Base
.isUndefinedOrNull
;
244 this.xticks
= new Array();
245 var makeTicks
= function(tick
) {
246 var label
= tick
.label
;
248 label
= tick
.v
.toString();
249 var pos
= this.xscale
* (tick
.v
- this.minxval
);
250 if ((pos
>= 0.0) && (pos
<= 1.0)) {
251 this.xticks
.push([pos
, label
]);
254 MochiKit
.Iter
.forEach(this.options
.xTicks
, bind(makeTicks
, this));
257 PlotKit
.Layout
.prototype._evaluateLineTicksForYAxis
= function() {
258 var isNil
= MochiKit
.Base
.isUndefinedOrNull
;
260 this.yticks
= new Array();
261 var makeTicks
= function(tick
) {
262 var label
= tick
.label
;
264 label
= tick
.v
.toString();
265 var pos
= 1.0 - (this.yscale
* (tick
.v
- this.minyval
));
266 if ((pos
>= 0.0) && (pos
<= 1.0)) {
267 this.yticks
.push([pos
, label
]);
270 MochiKit
.Iter
.forEach(this.options
.yTicks
, bind(makeTicks
, this));
273 PlotKit
.Layout
.prototype._evaluateLineTicks
= function() {
274 this._evaluateLineTicksForXAxis();
275 this._evaluateLineTicksForYAxis();
279 // --------------------------------------------------------------------
280 // END Internal Functions
281 // --------------------------------------------------------------------
284 // Namespace Iniitialisation
286 PlotKit
.LayoutModule
= {};
287 PlotKit
.LayoutModule
.Layout
= PlotKit
.Layout
;
289 PlotKit
.LayoutModule
.EXPORT
= [
293 PlotKit
.LayoutModule
.EXPORT_OK
= [];
295 PlotKit
.LayoutModule
.__new__
= function() {
296 var m
= MochiKit
.Base
;
298 m
.nameFunctions(this);
301 ":common": this.EXPORT
,
302 ":all": m
.concat(this.EXPORT
, this.EXPORT_OK
)
306 PlotKit
.LayoutModule
.__new__();
307 MochiKit
.Base
._exportSymbols(this, PlotKit
.LayoutModule
);