Annotation of loncom/xml/lonplot.pm, revision 1.24

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

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>