1: # The LearningOnline Network with CAPA
2: # Dynamic plot
3: #
4: # $Id: lonplot.pm,v 1.38 2002/01/10 19:45:51 matthew Exp $
5: #
6: # Copyright Michigan State University Board of Trustees
7: #
8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
9: #
10: # LON-CAPA is free software; you can redistribute it and/or modify
11: # it under the terms of the GNU General Public License as published by
12: # the Free Software Foundation; either version 2 of the License, or
13: # (at your option) any later version.
14: #
15: # LON-CAPA is distributed in the hope that it will be useful,
16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18: # GNU General Public License for more details.
19: #
20: # You should have received a copy of the GNU General Public License
21: # along with LON-CAPA; if not, write to the Free Software
22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23: #
24: # /home/httpd/html/adm/gpl.txt
25: #
26: # http://www.lon-capa.org/
27: #
28: # 12/15/01 Matthew
29: # 12/17 12/18 12/19 12/20 12/21 12/27 12/28 12/30 12/31 Matthew
30: # 01/01/02 Matthew
31: # 01/02 01/03 01/04 01/07 01/08 01/09 Matthew
32:
33: # Current issues
34: # 1. Gnuplot is unable to vary the color or linestyle of <data> plots.
35: # The key does not know this so it is misleading for the user.
36: # Multiple <function>s can be plotted with varying line styles and
37: # colors.
38: #
39: package Apache::lonplot;
40:
41: use strict;
42: use Apache::File;
43: use Apache::response;
44: use Apache::lonxml;
45: use Apache::edit;
46:
47: BEGIN {
48: &Apache::lonxml::register('Apache::lonplot',('plot'));
49: }
50:
51: ##
52: ## Description of data structures:
53: ##
54: ## %plot %key %axis
55: ## --------------------------
56: ## height title color
57: ## width box xmin
58: ## bgcolor pos xmax
59: ## fgcolor ymin
60: ## transparent ymax
61: ## grid
62: ## border
63: ## font
64: ## align
65: ##
66: ## @labels: $labels[$i] = \%label
67: ## %label: text, xpos, ypos, justify
68: ##
69: ## @curves: $curves[$i] = \%curve
70: ## %curve: name, linestyle, ( function | data )
71: ##
72: ## $curves[$i]->{'data'} = [ [x1,x2,x3,x4],
73: ## [y1,y2,y3,y4] ]
74: ##
75:
76: ###################################################################
77: ## ##
78: ## Tests used in checking the validitity of input ##
79: ## ##
80: ###################################################################
81:
82: my $max_str_len = 50; # if a label, title, xlabel, or ylabel text
83: # is longer than this, it will be truncated.
84:
85: my %linestyles =
86: (
87: lines => 2, # Maybe this will be used in the future
88: linespoints => 2, # to check on whether or not they have
89: dots => 2, # supplied enough <data></data> fields
90: points => 2, # to use the given line style. But for
91: steps => 2, # now there are more important things
92: fsteps => 2, # for me to deal with.
93: histeps => 2,
94: errorbars => 3,
95: xerrorbars => [3,4],
96: yerrorbars => [3,4],
97: xyerrorbars => [4,6],
98: boxes => 3,
99: # boxerrorbars => [3,4,5],
100: # boxxyerrorbars => [4,6,7],
101: # financebars => 5,
102: # candlesticks => 5,
103: vector => 4
104: );
105:
106: my $int_test = sub {$_[0]=~s/\s+//g;$_[0]=~/^\d+$/};
107: my $real_test =
108: sub {$_[0]=~s/\s+//g;$_[0]=~/^[+-]?\d*\.?\d*([eE][+-]\d+)?$/};
109: my $color_test = sub {$_[0]=~s/\s+//g;$_[0]=~/^x[\da-f]{6}$/};
110: my $onoff_test = sub {$_[0]=~/^(on|off)$/};
111: my $key_pos_test = sub {$_[0]=~/^(top|bottom|right|left|outside|below| )+$/};
112: my $sml_test = sub {$_[0]=~/^(small|medium|large)$/};
113: my $linestyle_test = sub {exists($linestyles{$_[0]})};
114: my $words_test = sub {$_[0]=~s/\s+/ /g;$_[0]=~/^([\w\(\)]+ ?)+$/};
115:
116: ###################################################################
117: ## ##
118: ## Attribute metadata ##
119: ## ##
120: ###################################################################
121: my @plot_edit_order =
122: qw/bgcolor fgcolor height width font transparent grid border align/;
123: my %plot_defaults =
124: (
125: height => {
126: default => 200,
127: test => $int_test,
128: description => 'height of image (pixels)',
129: edit_type => 'entry',
130: size => '10'
131: },
132: width => {
133: default => 200,
134: test => $int_test,
135: description => 'width of image (pixels)',
136: edit_type => 'entry',
137: size => '10'
138: },
139: bgcolor => {
140: default => 'xffffff',
141: test => $color_test,
142: description => 'background color of image (xffffff)',
143: edit_type => 'entry',
144: size => '10'
145: },
146: fgcolor => {
147: default => 'x000000',
148: test => $color_test,
149: description => 'foreground color of image (x000000)',
150: edit_type => 'entry',
151: size => '10'
152: },
153: transparent => {
154: default => 'off',
155: test => $onoff_test,
156: description => 'Transparent image',
157: edit_type => 'on_off'
158: },
159: grid => {
160: default => 'off',
161: test => $onoff_test,
162: description => 'Display grid',
163: edit_type => 'on_off'
164: },
165: border => {
166: default => 'on',
167: test => $onoff_test,
168: description => 'Draw border around plot',
169: edit_type => 'on_off'
170: },
171: font => {
172: default => 'medium',
173: test => $sml_test,
174: description => 'Size of font to use',
175: edit_type => 'choice',
176: choices => ['small','medium','large']
177: },
178: align => {
179: default => 'left',
180: test => sub {$_[0]=~/^(left|right|center)$/},
181: description => 'alignment for image in html',
182: edit_type => 'choice',
183: choices => ['left','right','center']
184: }
185: );
186:
187: my %key_defaults =
188: (
189: title => {
190: default => '',
191: test => $words_test,
192: description => 'Title of key',
193: edit_type => 'entry',
194: size => '40'
195: },
196: box => {
197: default => 'off',
198: test => $onoff_test,
199: description => 'Draw a box around the key?',
200: edit_type => 'on_off'
201: },
202: pos => {
203: default => 'top right',
204: test => $key_pos_test,
205: description => 'position of the key on the plot',
206: edit_type => 'choice',
207: choices => ['top left','top right','bottom left','bottom right',
208: 'outside','below']
209: }
210: );
211:
212: my %label_defaults =
213: (
214: xpos => {
215: default => 0,
216: test => $real_test,
217: description => 'x position of label (graph coordinates)',
218: edit_type => 'entry',
219: size => '10'
220: },
221: ypos => {
222: default => 0,
223: test => $real_test,
224: description => 'y position of label (graph coordinates)',
225: edit_type => 'entry',
226: size => '10'
227: },
228: justify => {
229: default => 'left',
230: test => sub {$_[0]=~/^(left|right|center)$/},
231: description => 'justification of the label text on the plot',
232: edit_type => 'choice',
233: choices => ['left','right','center']
234: }
235: );
236:
237: my %axis_defaults =
238: (
239: color => {
240: default => 'x000000',
241: test => $color_test,
242: description => 'color of axes (x000000)',
243: edit_type => 'entry',
244: size => '10'
245: },
246: xmin => {
247: default => '-10.0',
248: test => $real_test,
249: description => 'minimum x-value shown in plot',
250: edit_type => 'entry',
251: size => '10'
252: },
253: xmax => {
254: default => ' 10.0',
255: test => $real_test,
256: description => 'maximum x-value shown in plot',
257: edit_type => 'entry',
258: size => '10'
259: },
260: ymin => {
261: default => '-10.0',
262: test => $real_test,
263: description => 'minimum y-value shown in plot',
264: edit_type => 'entry',
265: size => '10'
266: },
267: ymax => {
268: default => ' 10.0',
269: test => $real_test,
270: description => 'maximum y-value shown in plot',
271: edit_type => 'entry',
272: size => '10'
273: }
274: );
275:
276: my %curve_defaults =
277: (
278: color => {
279: default => 'x000000',
280: test => $color_test,
281: description => 'color of curve (x000000)',
282: edit_type => 'entry',
283: size => '10'
284: },
285: name => {
286: default => '',
287: test => $words_test,
288: description => 'name of curve to appear in key',
289: edit_type => 'entry',
290: size => '20'
291: },
292: linestyle => {
293: default => 'lines',
294: test => $linestyle_test,
295: description => 'Line style',
296: edit_type => 'choice',
297: choices => [keys(%linestyles)]
298: }
299: );
300:
301: ###################################################################
302: ## ##
303: ## parsing and edit rendering ##
304: ## ##
305: ###################################################################
306: my (%plot,%key,%axis,$title,$xlabel,$ylabel,@labels,@curves);
307:
308: sub start_plot {
309: %plot = (); %key = (); %axis = ();
310: $title = undef; $xlabel = undef; $ylabel = undef;
311: $#labels = -1; $#curves = -1;
312: #
313: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
314: my $result='';
315: &Apache::lonxml::register('Apache::lonplot',
316: ('title','xlabel','ylabel','key','axis','label','curve'));
317: push (@Apache::lonxml::namespace,'lonplot');
318: if ($target eq 'web') {
319: my $inside = &Apache::lonxml::get_all_text("/plot",$$parser[-1]);
320: $inside=&Apache::run::evaluate($inside,$safeeval,$$parstack[-1]);
321: &Apache::lonxml::newparser($parser,\$inside);
322: &get_attributes(\%plot,\%plot_defaults,$parstack,$safeeval,
323: $tagstack->[-1]);
324: } elsif ($target eq 'edit') {
325: $result .= &Apache::edit::tag_start($target,$token,'Plot');
326: $result .= &edit_attributes($target,$token,\%plot_defaults,
327: \@plot_edit_order);
328: } elsif ($target eq 'modified') {
329: my $constructtag=&Apache::edit::get_new_args
330: ($token,$parstack,$safeeval,keys(%plot_defaults));
331: if ($constructtag) {
332: $result = &Apache::edit::rebuild_tag($token);
333: # $result.= &Apache::edit::handle_insert();
334: }
335: }
336: return $result;
337: }
338:
339: sub end_plot {
340: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
341:
342: pop @Apache::lonxml::namespace;
343: &Apache::lonxml::deregister('Apache::lonplot',
344: ('title','xlabel','ylabel','key','axis','label','curve'));
345: my $result = '';
346: if ($target eq 'web') {
347: &check_inputs(); # Make sure we have all the data we need
348: ##
349: ## Determine filename
350: my $tmpdir = '/home/httpd/perl/tmp/';
351: my $filename = $ENV{'user.name'}.'_'.$ENV{'user.domain'}.
352: '_'.time.'_'.$$.int(rand(1000)).'_plot.data';
353: ## Write the plot description to the file
354: my $fh=Apache::File->new(">$tmpdir$filename");
355: print $fh &write_gnuplot_file();
356: close($fh);
357: ## return image tag for the plot
358: $result .= <<"ENDIMAGE";
359: <img src = "/cgi-bin/plot.gif?$filename"
360: width = "$plot{'width'}"
361: height = "$plot{'height'}"
362: align = "$plot{'align'}"
363: alt = "/cgi-bin/plot.gif?$filename" />
364: ENDIMAGE
365: } elsif ($target eq 'edit') {
366: $result.=&Apache::edit::tag_end($target,$token);
367: }
368: return $result;
369: }
370:
371: ##----------------------------------------------------------------- key
372: sub start_key {
373: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
374: my $result='';
375: if ($target eq 'web') {
376: &get_attributes(\%key,\%key_defaults,$parstack,$safeeval,
377: $tagstack->[-1]);
378: } elsif ($target eq 'edit') {
379: $result .= &Apache::edit::tag_start($target,$token,'Plot Key');
380: $result .= &edit_attributes($target,$token,\%key_defaults);
381: } elsif ($target eq 'modified') {
382: my $constructtag=&Apache::edit::get_new_args
383: ($token,$parstack,$safeeval,keys(%key_defaults));
384: if ($constructtag) {
385: $result = &Apache::edit::rebuild_tag($token);
386: $result.= &Apache::edit::handle_insert();
387: }
388: }
389: return $result;
390: }
391:
392: sub end_key {
393: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
394: my $result = '';
395: if ($target eq 'web') {
396: } elsif ($target eq 'edit') {
397: $result.=&Apache::edit::tag_end($target,$token);
398: }
399: return $result;
400: }
401:
402: ##------------------------------------------------------------------- title
403: sub start_title {
404: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
405: my $result='';
406: if ($target eq 'web') {
407: $title = &Apache::lonxml::get_all_text("/title",$$parser[-1]);
408: if (length($title) > $max_str_len) {
409: $title = substr($title,0,$max_str_len);
410: }
411: } elsif ($target eq 'edit') {
412: $result.=&Apache::edit::tag_start($target,$token,'Plot Title');
413: my $text=&Apache::lonxml::get_all_text("/title",$$parser[-1]);
414: $result.='</td></tr><tr><td colspan="3">'.
415: &Apache::edit::editfield('',$text,'',60,1);
416: } elsif ($target eq 'modified') {
417: my $text=$$parser[-1]->get_text("/title");
418: $result.=&Apache::edit::modifiedfield($token);
419: }
420: return $result;
421: }
422:
423: sub end_title {
424: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
425: my $result = '';
426: if ($target eq 'web') {
427: } elsif ($target eq 'edit') {
428: $result.=&Apache::edit::tag_end($target,$token);
429: }
430: return $result;
431: }
432: ##------------------------------------------------------------------- xlabel
433: sub start_xlabel {
434: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
435: my $result='';
436: if ($target eq 'web') {
437: $xlabel = &Apache::lonxml::get_all_text("/xlabel",$$parser[-1]);
438: if (length($xlabel) > $max_str_len) {
439: $xlabel = substr($xlabel,0,$max_str_len);
440: }
441: } elsif ($target eq 'edit') {
442: $result.=&Apache::edit::tag_start($target,$token,'Plot Xlabel');
443: my $text=&Apache::lonxml::get_all_text("/xlabel",$$parser[-1]);
444: $result.='</td></tr><tr><td colspan="3">'.
445: &Apache::edit::editfield('',$text,'',60,1);
446: } elsif ($target eq 'modified') {
447: my $text=$$parser[-1]->get_text("/xlabel");
448: $result.=&Apache::edit::modifiedfield($token);
449: }
450: return $result;
451: }
452:
453: sub end_xlabel {
454: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
455: my $result = '';
456: if ($target eq 'web') {
457: } elsif ($target eq 'edit') {
458: $result.=&Apache::edit::tag_end($target,$token);
459: }
460: return $result;
461: }
462:
463: ##------------------------------------------------------------------- ylabel
464: sub start_ylabel {
465: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
466: my $result='';
467: if ($target eq 'web') {
468: $ylabel = &Apache::lonxml::get_all_text("/ylabel",$$parser[-1]);
469: if (length($ylabel) > $max_str_len) {
470: $ylabel = substr($ylabel,0,$max_str_len);
471: }
472: } elsif ($target eq 'edit') {
473: $result .= &Apache::edit::tag_start($target,$token,'Plot Ylabel');
474: my $text = &Apache::lonxml::get_all_text("/ylabel",$$parser[-1]);
475: $result .= '</td></tr><tr><td colspan="3">'.
476: &Apache::edit::editfield('',$text,'',60,1);
477: } elsif ($target eq 'modified') {
478: my $text=$$parser[-1]->get_text("/ylabel");
479: $result.=&Apache::edit::modifiedfield($token);
480: }
481: return $result;
482: }
483:
484: sub end_ylabel {
485: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
486: my $result = '';
487: if ($target eq 'web') {
488: } elsif ($target eq 'edit') {
489: $result.=&Apache::edit::tag_end($target,$token);
490: }
491: return $result;
492: }
493:
494: ##------------------------------------------------------------------- label
495: sub start_label {
496: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
497: my $result='';
498: if ($target eq 'web') {
499: my %label;
500: &get_attributes(\%label,\%label_defaults,$parstack,$safeeval,
501: $tagstack->[-1]);
502: my $text = &Apache::lonxml::get_all_text("/label",$$parser[-1]);
503: $text = substr($text,0,$max_str_len) if (length($text) > $max_str_len);
504: $label{'text'} = $text;
505: push(@labels,\%label);
506: } elsif ($target eq 'edit') {
507: $result .= &Apache::edit::tag_start($target,$token,'Plot Label');
508: $result .= &edit_attributes($target,$token,\%label_defaults);
509: my $text = &Apache::lonxml::get_all_text("/label",$$parser[-1]);
510: $result .= '</td></tr><tr><td colspan="3">'.
511: &Apache::edit::editfield('',$text,'',60,1);
512: } elsif ($target eq 'modified') {
513: my $constructtag=&Apache::edit::get_new_args
514: ($token,$parstack,$safeeval,keys(%label_defaults));
515: if ($constructtag) {
516: $result = &Apache::edit::rebuild_tag($token);
517: $result.= &Apache::edit::handle_insert();
518: }
519: my $text=$$parser[-1]->get_text("/label");
520: $result.=&Apache::edit::modifiedfield($token);
521: }
522: return $result;
523: }
524:
525: sub end_label {
526: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
527: my $result = '';
528: if ($target eq 'web') {
529: } elsif ($target eq 'edit') {
530: $result.=&Apache::edit::tag_end($target,$token);
531: }
532: return $result;
533: }
534:
535: ##------------------------------------------------------------------- curve
536: sub start_curve {
537: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
538: my $result='';
539: &Apache::lonxml::register('Apache::lonplot',('function','data'));
540: push (@Apache::lonxml::namespace,'curve');
541: if ($target eq 'web') {
542: my %curve;
543: &get_attributes(\%curve,\%curve_defaults,$parstack,$safeeval,
544: $tagstack->[-1]);
545: push (@curves,\%curve);
546: } elsif ($target eq 'edit') {
547: $result .= &Apache::edit::tag_start($target,$token,'Curve');
548: $result .= &edit_attributes($target,$token,\%curve_defaults);
549: } elsif ($target eq 'modified') {
550: my $constructtag=&Apache::edit::get_new_args
551: ($token,$parstack,$safeeval,keys(%curve_defaults));
552: if ($constructtag) {
553: $result = &Apache::edit::rebuild_tag($token);
554: $result.= &Apache::edit::handle_insert();
555: }
556: }
557: return $result;
558: }
559:
560: sub end_curve {
561: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
562: my $result = '';
563: pop @Apache::lonxml::namespace;
564: &Apache::lonxml::deregister('Apache::lonplot',('function','data'));
565: if ($target eq 'web') {
566: } elsif ($target eq 'edit') {
567: $result.=&Apache::edit::tag_end($target,$token);
568: }
569: return $result;
570: }
571:
572: ##------------------------------------------------------------ curve function
573: sub start_function {
574: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
575: my $result='';
576: if ($target eq 'web') {
577: if (exists($curves[-1]->{'data'})) {
578: &Apache::lonxml::warning('Use of <function> precludes use of <data>. The <data> will be omitted in favor of the <function> declaration.');
579: delete $curves[-1]->{'data'} ;
580: }
581: $curves[-1]->{'function'} =
582: &Apache::lonxml::get_all_text("/function",$$parser[-1]);
583: } elsif ($target eq 'edit') {
584: $result .= &Apache::edit::tag_start($target,$token,'Gnuplot compatible curve function');
585: my $text = &Apache::lonxml::get_all_text("/function",$$parser[-1]);
586: $result .= '</td></tr><tr><td colspan="3">'.
587: &Apache::edit::editfield('',$text,'',60,1);
588: } elsif ($target eq 'modified') {
589: # Why do I do this?
590: my $text=$$parser[-1]->get_text("/function");
591: $result.=&Apache::edit::modifiedfield($token);
592: }
593: return $result;
594: }
595:
596: sub end_function {
597: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
598: my $result = '';
599: if ($target eq 'web') {
600: } elsif ($target eq 'edit') {
601: $result .= &Apache::edit::end_table();
602: }
603: return $result;
604: }
605:
606: ##------------------------------------------------------------ curve data
607: sub start_data {
608: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
609: my $result='';
610: if ($target eq 'web') {
611: if (exists($curves[-1]->{'function'})) {
612: &Apache::lonxml::warning('Use of <data> precludes use of .'.
613: '<function>. The <function> will be omitted in favor of '.
614: 'the <data> declaration.');
615: delete($curves[-1]->{'function'});
616: }
617: my $datatext = &Apache::lonxml::get_all_text("/data",$$parser[-1]);
618: $datatext =~ s/\s+/ /g;
619: # Need to do some error checking on the @data array -
620: # make sure it's all numbers and make sure each array
621: # is of the same length.
622: my @data;
623: if ($datatext =~ /,/) { # comma deliminated
624: @data = split /,/,$datatext;
625: } else { # Assume it's space seperated.
626: @data = split / /,$datatext;
627: }
628: for (my $i=0;$i<=$#data;$i++) {
629: # Check that it's non-empty
630: if (! defined($data[$i])) {
631: &Apache::lonxml::warning(
632: 'undefined <data> value. Replacing with '.
633: ' pi/e = 1.15572734979092');
634: $data[$i] = 1.15572734979092;
635: }
636: # Check that it's a number
637: if (! &$real_test($data[$i]) & ! &$int_test($data[$i])) {
638: &Apache::lonxml::warning(
639: 'Bad <data> value of '.$data[$i].' Replacing with '.
640: ' pi/e = 1.15572734979092');
641: $data[$i] = 1.15572734979092;
642: }
643: }
644: # complain if the number of data points is not the same as
645: # in previous sets of data.
646: if (($curves[-1]->{'data'}) && ($#data != $#{@{$curves[-1]->{'data'}->[0]}})){
647: &Apache::lonxml::warning
648: ('Number of data points is not consistent with previous '.
649: 'number of data points');
650: }
651: push @{$curves[-1]->{'data'}},\@data;
652: } elsif ($target eq 'edit') {
653: $result .= &Apache::edit::tag_start($target,$token,'Comma or space deliminated curve data');
654: my $text = &Apache::lonxml::get_all_text("/data",$$parser[-1]);
655: $result .= '</td></tr><tr><td colspan="3">'.
656: &Apache::edit::editfield('',$text,'',60,1);
657: } elsif ($target eq 'modified') {
658: my $text=$$parser[-1]->get_text("/data");
659: $result.=&Apache::edit::modifiedfield($token);
660: }
661: return $result;
662: }
663:
664: sub end_data {
665: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
666: my $result = '';
667: if ($target eq 'web') {
668: } elsif ($target eq 'edit') {
669: $result .= &Apache::edit::end_table();
670: }
671: return $result;
672: }
673:
674: ##------------------------------------------------------------------- axis
675: sub start_axis {
676: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
677: my $result='';
678: if ($target eq 'web') {
679: &get_attributes(\%axis,\%axis_defaults,$parstack,$safeeval,
680: $tagstack->[-1]);
681: } elsif ($target eq 'edit') {
682: $result .= &Apache::edit::tag_start($target,$token,'Plot Axes');
683: $result .= &edit_attributes($target,$token,\%axis_defaults);
684: } elsif ($target eq 'modified') {
685: my $constructtag=&Apache::edit::get_new_args
686: ($token,$parstack,$safeeval,keys(%axis_defaults));
687: if ($constructtag) {
688: $result = &Apache::edit::rebuild_tag($token);
689: $result.= &Apache::edit::handle_insert();
690: }
691: }
692: return $result;
693: }
694:
695: sub end_axis {
696: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
697: my $result = '';
698: if ($target eq 'web') {
699: } elsif ($target eq 'edit') {
700: $result.=&Apache::edit::tag_end($target,$token);
701: } elsif ($target eq 'modified') {
702: }
703: return $result;
704: }
705:
706: ###################################################################
707: ## ##
708: ## Utility Functions ##
709: ## ##
710: ###################################################################
711:
712: ##----------------------------------------------------------- set_defaults
713: sub set_defaults {
714: my ($var,$defaults) = @_;
715: my $key;
716: foreach $key (keys(%$defaults)) {
717: $var->{$key} = $defaults->{$key}->{'default'};
718: }
719: }
720:
721: ##------------------------------------------------------------------- misc
722: sub get_attributes{
723: my ($values,$defaults,$parstack,$safeeval,$tag) = @_;
724: foreach my $attr (keys(%{$defaults})) {
725: $values->{$attr} =
726: &Apache::lonxml::get_param($attr,$parstack,$safeeval);
727: if ($values->{$attr} eq '' | !defined($values->{$attr})) {
728: $values->{$attr} = $defaults->{$attr}->{'default'};
729: next;
730: }
731: my $test = $defaults->{$attr}->{'test'};
732: if (! &$test($values->{$attr})) {
733: &Apache::lonxml::warning
734: ($tag.':'.$attr.': Bad value.'.'Replacing your value with : '
735: .$defaults->{$attr}->{'default'} );
736: $values->{$attr} = $defaults->{$attr}->{'default'};
737: }
738: }
739: return ;
740: }
741: ##------------------------------------------------------- write_gnuplot_file
742: sub write_gnuplot_file {
743: my $gnuplot_input = '';
744: my $curve;
745: # Collect all the colors
746: my @Colors;
747: push @Colors, $plot{'bgcolor'};
748: push @Colors, $plot{'fgcolor'};
749: push @Colors, (defined($axis{'color'})?$axis{'color'}:$plot{'fgcolor'});
750: foreach $curve (@curves) {
751: push @Colors, ($curve->{'color'} ne '' ?
752: $curve->{'color'} :
753: $plot{'fgcolor'} );
754: }
755: # set term
756: $gnuplot_input .= 'set term gif ';
757: $gnuplot_input .= 'transparent ' if ($plot{'transparent'} eq 'on');
758: $gnuplot_input .= $plot{'font'} . ' ';
759: $gnuplot_input .= 'size '.$plot{'width'}.','.$plot{'height'}.' ';
760: $gnuplot_input .= "@Colors\n";
761: # grid
762: $gnuplot_input .= 'set grid'.$/ if ($plot{'grid'} eq 'on');
763: # border
764: $gnuplot_input .= ($plot{'border'} eq 'on'?
765: 'set border'.$/ :
766: 'set noborder'.$/ ); # title, xlabel, ylabel
767: $gnuplot_input .= "set output\n";
768: $gnuplot_input .= "set title \"$title\"\n" if (defined($title)) ;
769: $gnuplot_input .= "set xlabel \"$xlabel\"\n" if (defined($xlabel));
770: $gnuplot_input .= "set ylabel \"$ylabel\"\n" if (defined($ylabel));
771: if (%axis) {
772: $gnuplot_input .= "set xrange \[$axis{'xmin'}:$axis{'xmax'}\]\n";
773: $gnuplot_input .= "set yrange \[$axis{'ymin'}:$axis{'ymax'}\]\n";
774: }
775: # Key
776: if (%key) {
777: $gnuplot_input .= 'set key '.$key{'pos'}.' ';
778: if ($key{'title'} ne '') {
779: $gnuplot_input .= 'title "'.$key{'title'}.'" ';
780: }
781: $gnuplot_input .= ($key{'box'} eq 'on' ? 'box ' : 'nobox ').$/;
782: } else {
783: $gnuplot_input .= 'set nokey'.$/;
784: }
785: # labels
786: my $label;
787: foreach $label (@labels) {
788: $gnuplot_input .= 'set label "'.$label->{'text'}.'" at '.
789: $label->{'xpos'}.','.$label->{'ypos'}.' '.$label->{'justify'}.$/ ;
790: }
791: # curves
792: $gnuplot_input .= 'plot ';
793: my $datatext = '';
794: for (my $i = 0;$i<=$#curves;$i++) {
795: $curve = $curves[$i];
796: $gnuplot_input.= ', ' if ($i > 0);
797: if (exists($curve->{'function'})) {
798: $gnuplot_input.=
799: $curve->{'function'}.' title "'.
800: $curve->{'name'}.'" with '.
801: $curve->{'linestyle'};
802: } elsif (exists($curve->{'data'})) {
803: $gnuplot_input.= '\'-\' title "'.
804: $curve->{'name'}.'" with '.
805: $curve->{'linestyle'};
806: my @Data = @{$curve->{'data'}};
807: my @Data0 = @{$Data[0]};
808: for (my $i =0; $i<=$#Data0; $i++) {
809: my $dataset;
810: foreach $dataset (@Data) {
811: $datatext .= $dataset->[$i] . ' ';
812: }
813: $datatext .= $/;
814: }
815: $datatext .=$/;
816: }
817: }
818: $gnuplot_input .= $/.$datatext;
819: return $gnuplot_input;
820: }
821:
822: #---------------------------------------------- check_inputs
823: sub check_inputs {
824: ## Note: no inputs, no outputs - this acts only on global variables.
825: ## Make sure we have all the input we need:
826: if (! %plot) { &set_defaults(\%plot,\%plot_defaults); }
827: if (! %key ) {} # No key for this plot, thats okay
828: # if (! %axis) { &set_defaults(\%axis,\%axis_defaults); }
829: if (! defined($title )) {} # No title for this plot, thats okay
830: if (! defined($xlabel)) {} # No xlabel for this plot, thats okay
831: if (! defined($ylabel)) {} # No ylabel for this plot, thats okay
832: if ($#labels < 0) { } # No labels for this plot, thats okay
833: if ($#curves < 0) {
834: &Apache::lonxml::warning("No curves specified for plot!!!!");
835: return '';
836: }
837: my $curve;
838: foreach $curve (@curves) {
839: if (!defined($curve->{'function'})&&!defined($curve->{'data'})){
840: &Apache::lonxml::warning("One of the curves specified did not contain any <data> or <function> declarations\n");
841: return '';
842: }
843: }
844: }
845:
846: #------------------------------------------------ make_edit
847: sub edit_attributes {
848: my ($target,$token,$defaults,$keys) = @_;
849: my ($result,@keys);
850: if ($keys && ref($keys) eq 'ARRAY') {
851: @keys = @$keys;
852: } else {
853: @keys = sort(keys(%$defaults));
854: }
855: foreach my $attr (@keys) {
856: # append a ' ' to the description if it doesn't have one already.
857: my $description = $defaults->{$attr}->{'description'};
858: $description .= ' ' if ($description !~ / $/);
859: if ($defaults->{$attr}->{'edit_type'} eq 'entry') {
860: $result .= &Apache::edit::text_arg
861: ($description,$attr,$token,
862: $defaults->{$attr}->{'size'});
863: } elsif ($defaults->{$attr}->{'edit_type'} eq 'choice') {
864: $result .= &Apache::edit::select_arg
865: ($description,$attr,$defaults->{$attr}->{'choices'},$token);
866: } elsif ($defaults->{$attr}->{'edit_type'} eq 'on_off') {
867: $result .= &Apache::edit::select_arg
868: ($description,$attr,['on','off'],$token);
869: }
870: $result .= '<br />';
871: }
872: return $result;
873: }
874:
875:
876: ###################################################################
877: ## ##
878: ## Insertion functions for editing plots ##
879: ## ##
880: ###################################################################
881:
882: #------------------------------------------------ insert_xxxxxxx
883: sub insert_plot {
884: my $result = '';
885: # plot attributes
886: $result .= "<plot \n";
887: foreach my $attr (keys(%plot_defaults)) {
888: $result .= " $attr=\"$plot_defaults{$attr}->{'default'}\"\n";
889: }
890: $result .= ">\n";
891: # Add the components
892: $result .= &insert_key();
893: $result .= &insert_axis();
894: $result .= &insert_title();
895: $result .= &insert_xlabel();
896: $result .= &insert_ylabel();
897: $result .= &insert_curve();
898: # close up the <plot>
899: $result .= "</plot>\n";
900: return $result;
901: }
902:
903: sub insert_key {
904: my $result;
905: $result .= " <key \n";
906: foreach my $attr (keys(%key_defaults)) {
907: $result .= " $attr=\"$key_defaults{$attr}->{'default'}\"\n";
908: }
909: $result .= " />\n";
910: return $result;
911: }
912:
913: sub insert_axis{
914: my $result;
915: $result .= ' <axis ';
916: foreach my $attr (keys(%axis_defaults)) {
917: $result .= " $attr=\"$axis_defaults{$attr}->{'default'}\"\n";
918: }
919: $result .= " />\n";
920: return $result;
921: }
922:
923: sub insert_title { return " <title></title>\n"; }
924: sub insert_xlabel { return " <xlabel></xlabel>\n"; }
925: sub insert_ylabel { return " <ylabel></ylabel>\n"; }
926:
927: sub insert_label {
928: my $result;
929: $result .= ' <label ';
930: foreach my $attr (keys(%label_defaults)) {
931: $result .= ' '.$attr.'="'.
932: $label_defaults{$attr}->{'default'}."\"\n";
933: }
934: $result .= " ></label>\n";
935: return $result;
936: }
937:
938: sub insert_curve {
939: my $result;
940: $result .= ' <curve ';
941: foreach my $attr (keys(%curve_defaults)) {
942: $result .= ' '.$attr.'="'.
943: $curve_defaults{$attr}->{'default'}."\"\n";
944: }
945: $result .= " ></curve>\n";
946: }
947:
948: sub insert_function {
949: my $result;
950: $result .= "<function></function>\n";
951: return $result;
952: }
953:
954: sub insert_data {
955: my $result;
956: $result .= " <data></data>\n";
957: return $result;
958: }
959:
960: ##----------------------------------------------------------------------
961: 1;
962: __END__
963:
964:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/back.gif){kind=icon}
Return to lonplot.pm CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / loncom / xml