DynamicImages2

From WeBWorK_wiki
Revision as of 21:28, 23 February 2010 by Pearson (talk | contribs)
Jump to navigation Jump to search

Adding Labels, Lines and Points to Dynamic Graphs: PG Code Snippet

This code snippet shows the essential PG code to add labels, lines and points to dynamically generated graphs. Note that these are insertions, not a complete PG file. This code will have to be incorporated into the problem file on which you are working.

Problem Techniques Index

PG problem file Explanation
  loadMacros("PGgraphmacros.pl");

We have no required additions to the tagging and description section of the file, and we obviously need to include PGgraphmacros.pl to do dynamic graphs.

# a graph object
$gr = init_graph(-1,-1,4,4,
axes=>[0,0],
size=>[400,400]);

# specify the grid manually
$gr->h_grid("gray",1.5,3);
$gr->v_grid("gray",1,2,3);

# plot a function
add_functions($gr, "4-3*e^(-x) for x in <-1,4> " .
    "using color:blue and weight:2");

# add a label
$gr->lb( new Label(0.25,3.25,'(0,3)',
    'black','center','middle'));

# a line
$gr->moveTo(-1,1);
$gr->lineTo(4,1,'black');

# a thicker, blue line
#    (only works for WeBWorK > 2.4)
$gr->lineTo(4,-1,'blue',2);

# a dashed blue line
#    (only works for WeBWorK > 2.4)
$gr->lineTo(4,-1,'blue',1,'dashed');

# a thicker red arrow from (0,0) to (4,1)
#    (only works for WeBWorK > 2.4;
#    also supports the 'dashed' option)
$gr->moveTo(0,0);
$gr->arrowTo(4,1,'red',2);

# and a point
$gr->stamps( closed_circle(0,3,'blue') );

#$gr->gifName($gr->gifName()."-$newProblemSeed");

In the initialization part of the file, we define a [dynamically generated graph|DynamicImages]. Then we can add labels, lines and points to the graph.

To add labels, we use the lb method of the graph object. The argument is a new Label object, defined by an x-coordinate, y-coordinate, label text, color, and justification. The justification can be left, center or right for the left-to-right justification, and top, middle or bottom for the top-to-bottom justification.

Lines are added by moving the graph "cursor" to a point and then drawing a line to a new point. Note that the "cursor" remains at the endpoint of the line after drawing is completed, so that any line drawn thereafter without an additional moveTo method call will start at that endpoint.

And we add points by using the stamps method of the graph object. We've added a closed circle here; as might expect, open_circles are also supported.

BEGIN_TEXT
$BCENTER
\{ image( insertGraph($gr), width=>400,height=>400,tex_size=>800 ) \}
$BR
(Click on graph to enlarge)
$ECENTER
END_TEXT

And the graph is inserted in the text portion of the problem as we'd expect any static or dynamic image to be.

Note that there is a more complete list of the plotting options available in a graph object in the CVS documentation for WWPlot and PGgraphmacros.

Problem Techniques Index