Return to Authoring_Dynamic_Plot_Tics.tex CVS log

Up to [LON-CAPA] / loncom / html / adm / help / tex

BZ5635 - Document the new <tic> tag.

    1: \label{Authoring_Dynamic_Plot_Tics}
    2: 
    3: The \textbf{xtics} and \textbf{ytics} tags can be inserted by selecting 
    4: the \textbf{Plot tics} item from the insert selection list of the 
    5: \textbf{gnuplot} tag.
    6: 
    7: The \textbf{xtics} and \textbf{ytics} tags have identical structure and the
    8: description presented here applies to both.
    9: 
   10: The tics tags allow specification of the following attributes:
   11: 
   12: \begin{itemize}
   13: 
   14: \item \texttt{Location of major tic marks}
   15: ``Border'' or ``Axis''.
   16: Tic marks can be placed on the border or on the axes.  The images below
   17: illustrate the effects of each of these options.
   18: 
   19: \includegraphics[  width=0.40\paperwidth]{Authoring_Dynamic_Plot_Axis_Tics_border}
   20: \includegraphics[  width=0.40\paperwidth]{Authoring_Dynamic_Plot_Axis_Tics_x_axis}
   21: 
   22: \item \texttt{Mirror tics on opposite axis?}
   23: ``Yes'' or ``No''.
   24: If the \textbf{location of tic marks} is set to ``border'' this parameter 
   25: determines if they are shown on both the top and bottom or right and left 
   26: sides of the graph.  The ``mirror'' tic marks are unlabelled.
   27: 
   28: \includegraphics[  width=0.40\paperwidth]{Authoring_Dynamic_Plot_Axis_Tics_border}
   29: \includegraphics[  width=0.40\paperwidth]{Authoring_Dynamic_Plot_Axis_Tics_nomirror}
   30: 
   31: \item \texttt{Start major tics at}
   32: 
   33: The point in graph coordinates which to start making major tics.  
   34: This may be less than or greater than the lower limit for the axis.
   35: 
   36: \item \texttt{Place a major tic every}
   37: 
   38: The span, in graph coordinates, between each major tic mark.
   39: 
   40: \item \texttt{Stop major tics at}
   41: 
   42: This may be less than or greater than the upper limit for the axis.
   43: 
   44: \item \texttt{Number of minor tics between major tic marks}
   45: 
   46: The number of subdivisions to make of the span between major tic marks.
   47: Using a value of ``10'' leads to 9 minor tic marks.  The example below
   48: uses a value of ``5'' to produce 4 tic marks.
   49: 
   50: \includegraphics[  width=0.40\paperwidth]{Authoring_Dynamic_Plot_Axis_Tics_minor}
   51: 
   52: 
   53: \item \texttt{rotate}
   54: 
   55: For output devices that support it, the \texttt{rotate=`1'} attribute rotates
   56: the tic label.  This is most useful with large lables defined by the
   57: \textbf{tic} tag described below.
   58: 
   59: \end{itemize}
   60: 
   61: In addition to specifying regular tic intervals via the attributes of the
   62: \textbf{xtics} and \textbf{ytics} you can specify arbitrary tic locations
   63: by enclosing \textbf{tic} tags within the body of these tags.  Each
   64: \textbf{tic} tag requires the \textbf{location} attribute which specifies the
   65: location of a tic on the axis.  The body of the tag contains the label of
   66: that tic.
   67: 
   68: The \textbf{xtic} or \textbf{ytic}  \texttt{rotate} attribute can rotate
   69: the label text if the output device supports text rotation.
   70: If \textbf{tic} tags are embedded within the \textbf{xtic} or \textbf{ytic}
   71: tags attributes of those tags that specify tic boundaries and interval are
   72: ignored.  Here's an example of an X axis tic specification in months of the year:
   73: 
   74: \begin{verbatim}
   75: ...
   76: <xtics rotate='on'>
   77:    <tic location='1'>January</tic>
   78:    <tic location='2'>February</tic>
   79:    <tic location='3'>March</tic>
   80:    <tic location='4'>April</tic>
   81:    <tic location='5'>May</tic>
   82:    <tic location='6'>June</tic>
   83:    <tic location='7'>July</tic>
   84:    <tic location='8'>August</tic>
   85:    <tic location='9'>September</tic>
   86:    <tic location='10'>October</tic>
   87:    <tic location='11'>November</tic>
   88:    <tic location='12'>December</tic>
   89: </xtics>
   90: <ytics end="6.0" location="border" start="-6.0" 
   91:        increment="1.0" mirror="on" />
   92: \end{verbatim}
   93: 
   94: Note that tic locations are completely under your control and do not even have
   95: to be at regular interevals on the axis if that better suits your needs.