Annotation of loncom/html/adm/help/tex/Authoring_Dynamic_Plot_Gnuplot.tex, revision 1.9
1.1 matthew 1: \label{Authoring_Dynamic_Plot_Gnuplot}
2:
1.6 lira 3: \index{gnuplot}\index{plot}\index{dynamic plot}
1.8 raeburn 4: The \textbf{gnuplot} LON-CAPA tag allows an author to design a plot which will be
5: created programatically at the time when it is requested for display by a student.
6: This is intended for use in homework problems where a distinct plot should be
7: rendered for each student. It can be used in conjunction with a
8: \textbf{script} tag to generate curve data for random plots.
1.6 lira 9: If you are using
10: static data a dynamically generated plot is not appropriate because of
11: the overhead associated with generating the plot. In that case, use a
1.9 ! raeburn 12: picture (see ``Adding Picture'' section \ref{Authoring_Adding_Pictures}).
1.6 lira 13:
14: The easiset way to create a template for a gnuplot tag is to use the colorful
15: problem editor, and select \textbf{GnuPlot} from the \textbf{Insert} dropdown menu.
1.8 raeburn 16: Thereafter the boxes may be filled using this documentation to assist you. By default, only
1.6 lira 17: the parent \textbf{gnuplot} tag and the child \textbf{curve} tag are created by
1.8 raeburn 18: when the plot is inserted into a problem using the colorful editor. Other tags can be
1.6 lira 19: added to decorate and polish your plot using the \textbf{Insert:} dropdown
1.8 raeburn 20: provided by the colorful editor.
1.1 matthew 21:
1.6 lira 22: The following \textbf{gnuplot} parameters may be set:
1.1 matthew 23:
24: \begin{itemize}
25: \item \texttt{brief description of the plot}
1.6 lira 26: This text is used as the \texttt{alt} value of the \texttt{img} tag
27: used to display the plot on a web page.
1.1 matthew 28:
29: \item \texttt{background color of image (xffffff)}
1.9 ! raeburn 30: See the ``Color Selection'' section \ref{Authoring_Dynamic_Plot_Color_Selection}
1.1 matthew 31: for help on specifying colors.
32:
33: \item \texttt{foreground color of image (x000000)}
1.9 ! raeburn 34: See the ``Color Selection'' section \ref{Authoring_Dynamic_Plot_Color_Selection}
1.1 matthew 35: for help on specifying colors.
36:
37: \item \texttt{height of image (pixels)}
38:
39: \item \texttt{width of image (pixels)}
40:
41: \item \texttt{Size of font to use} ``small'', ``medium'', or ``large''.
42: The font used for any text on the plot is set with this tag.
43:
44: \item \texttt{Transparent image} ``Yes'' or ``No''.
45: If the image is transparent the background color will be ignored.
46:
47: \item \texttt{Display grid} ``Yes'' or ``No''.
48:
1.8 raeburn 49: \item \texttt{Number of samples for non-data plots} If a \textbf{function} tag is used
1.9 ! raeburn 50: (see ``Plotting Functions'' section \ref{Authoring_Dynamic_Plot_Curve_Function}) to specify the
! 51: \textbf{curve} (see ``Specifying Curves to Plot'' section \ref{Authoring_Dynamic_Plot_Curve}),
1.8 raeburn 52: this indicates the number of sample points to use.
1.1 matthew 53:
54: \item \texttt{Draw border around plot} ``Yes'' or ``No''
55:
56: \item \texttt{alignment for image in html} ``Left'', ``Center'', or ``Right''.
57: This is the value used for the \texttt{align} parameter in the \texttt{img}
58: tag which embeds the plot in the problem.
59:
1.3 matthew 60: \item \texttt{Width of plot when printed (mm)} The width in mm of the plot when
61: it is printed. The default is approximately one half of a U.S. letter size
62: page, 93 mm.
63:
64: \item \texttt{Font size to use in TeX output (pts)} The size in points of text
65: on the graph when it is printed out.
66:
1.4 vandui11 67: \item \texttt{Plot type} ``Cartesian'' or ``Polar''.
68:
69: \item \texttt{margin width (pts)} The left, right, top, or bottom margin width
70: measured in points.
71:
72: \item \texttt{Size of major tic marks} The size of the larger tic marks on the
73: plot border or axes, measured in graph units.
74:
75: \item \texttt{Size of minor tic marks} The size of the smaller tic marks on the
76: plot border or axes, measured in graph units.
77:
1.1 matthew 78: \end{itemize}
79:
1.7 lira 80: The parent \texttt{gnuplot} tag allows use of the following child tags
1.6 lira 81: (only the \textbf{curve} tag is added automatically when inserting with the colorful
82: editor):
1.1 matthew 83:
84: \begin{itemize}
1.9 ! raeburn 85: \item \textbf{curve} (see ``Specifying Curves to Plot'' section \ref{Authoring_Dynamic_Plot_Curve})
! 86: \item \textbf{title}, \textbf{xlabel}, and \textbf{ylabel} (see ``Plot Labels and Key'' section
1.6 lira 87: \ref{Authoring_Dynamic_Plot_Title_X_Y_Label})
1.9 ! raeburn 88: \item \textbf{key} (see ``Plot Labels and Key'' section \ref{Authoring_Dynamic_Plot_Key})
! 89: \item \textbf{label} (see ``Plot Labels and Key'' section \ref{Authoring_Dynamic_Plot_Label})
! 90: \item \textbf{axes} (see ``Plot Axes Details'' section \ref{Authoring_Dynamic_Plot_Axes})
! 91: \item \textbf{tics} (see ``Plot Axes Details'' section \ref{Authoring_Dynamic_Plot_Tics})
1.1 matthew 92: \end{itemize}
93:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>