--- loncom/html/adm/help/tex/Authoring_Dynamic_Plot_Gnuplot.tex 2013/07/13 21:50:50 1.7 +++ loncom/html/adm/help/tex/Authoring_Dynamic_Plot_Gnuplot.tex 2013/08/22 19:42:55 1.8 @@ -1,22 +1,23 @@ \label{Authoring_Dynamic_Plot_Gnuplot} \index{gnuplot}\index{plot}\index{dynamic plot} -The \textbf{gnuplot} LON-CAPA tag allows an author to design a plot which is created -when it is viewed. This is intended for use in homework problems -where each student needs to see a distinct plot. It can be used in -conjunction with a \textbf{script} tag to generate curve data for random plots. +The \textbf{gnuplot} LON-CAPA tag allows an author to design a plot which will be +created programatically at the time when it is requested for display by a student. +This is intended for use in homework problems where a distinct plot should be +rendered for each student. It can be used in conjunction with a +\textbf{script} tag to generate curve data for random plots. If you are using static data a dynamically generated plot is not appropriate because of the overhead associated with generating the plot. In that case, use a -picture (see \ref{Authoring_Adding_Pictures}). +picture (see Adding Picture section \ref{Authoring_Adding_Pictures}). The easiset way to create a template for a gnuplot tag is to use the colorful problem editor, and select \textbf{GnuPlot} from the \textbf{Insert} dropdown menu. -Then the boxes may be filled with the assistance of this documentation. By default, only +Thereafter the boxes may be filled using this documentation to assist you. By default, only the parent \textbf{gnuplot} tag and the child \textbf{curve} tag are created by -default when the plot is inserted with the colorful editor. Other tags can be +when the plot is inserted into a problem using the colorful editor. Other tags can be added to decorate and polish your plot using the \textbf{Insert:} dropdown -from the colorful editor. +provided by the colorful editor. The following \textbf{gnuplot} parameters may be set: @@ -30,7 +31,7 @@ See the color selection section \ref{Aut for help on specifying colors. \item \texttt{foreground color of image (x000000)} -See the color selection section \ref{Authoring_Dynamic_Plot_Color_Selection} +See the color selection section \ref{Authoring_Dynamic_Plot_Color_Selection} for help on specifying colors. \item \texttt{height of image (pixels)} @@ -45,10 +46,10 @@ If the image is transparent the backgrou \item \texttt{Display grid} ``Yes'' or ``No''. -\item \texttt{Number of samples for non-data plots} If a \textbf{function} tag -(see section \ref{Authoring_Dynamic_Plot_Curve_Function}) is used to specify the -\textbf{curve} (see section \ref{Authoring_Dynamic_Plot_Curve}), this indicates the number -of sample points to use. +\item \texttt{Number of samples for non-data plots} If a \textbf{function} tag is used +(see Plotting Functions section \ref{Authoring_Dynamic_Plot_Curve_Function}) to specify the +\textbf{curve} (see Specifying Curves to Plot section \ref{Authoring_Dynamic_Plot_Curve}), +this indicates the number of sample points to use. \item \texttt{Draw border around plot} ``Yes'' or ``No'' @@ -81,12 +82,12 @@ The parent \texttt{gnuplot} tag allows u editor): \begin{itemize} -\item \textbf{curve} (see section \ref{Authoring_Dynamic_Plot_Curve}) -\item \textbf{title}, \textbf{xlabel}, and \textbf{ylabel} (see section +\item \textbf{curve} (see Specifying Curves to Plot section \ref{Authoring_Dynamic_Plot_Curve}) +\item \textbf{title}, \textbf{xlabel}, and \textbf{ylabel} (see Plot Labels and Key section \ref{Authoring_Dynamic_Plot_Title_X_Y_Label}) -\item \textbf{key} (see section \ref{Authoring_Dynamic_Plot_Key}) -\item \textbf{label} (see section \ref{Authoring_Dynamic_Plot_Label}) -\item \textbf{axes} (see section \ref{Authoring_Dynamic_Plot_Axes}) -\item \textbf{tics} (see section \ref{Authoring_Dynamic_Plot_Tics}) +\item \textbf{key} (see Plot Labels and Key section \ref{Authoring_Dynamic_Plot_Key}) +\item \textbf{label} (see Plot Labels and Key section \ref{Authoring_Dynamic_Plot_Label}) +\item \textbf{axes} (see Plot Axes Details section \ref{Authoring_Dynamic_Plot_Axes}) +\item \textbf{tics} (see Plot Axes Details section \ref{Authoring_Dynamic_Plot_Tics}) \end{itemize}