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