\HeaderA{section}{SEISMIC SECTION}{section}
\begin{Description}\relax
Plots a seismic section given an array of seismic records. The
recordings are offset by distance, which can be user supplied, or
calculated from the epicenter and station locations in the header of
each recording.
\end{Description}
\begin{Usage}
\begin{verbatim}
section(x, dist = NULL, vertdist = TRUE, ampnorm = TRUE, mfactor = 1,
        xlim = NULL, tracelabs = NULL, lty = NULL, col = NULL,
        timeStyle = "axis", offsets = NULL)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] an object of class \code{"rsac"}.
\item[\code{dist}] vector of distances for each trace; if provided it must
have the same lenght as \sQuote{x}, otherwise it will be calculated
from the header info if the station and epicenter locations are
give.
\item[\code{vertdist}] logical; should the vertical axis be distance.
\item[\code{ampnorm}] logical; if \sQuote{TRUE} the the amplitudes of all the
traces will be adjusted to have the same maximum amplitude,
and the amplitudes scale will not be consistent between the
different traces.
\item[\code{mfactor}] a multiplicative factor to be applied to all the traces
after scaling.
\item[\code{xlim}] time extents of the plot.
\item[\code{tracelabs}] a vector of characters to label the traces; if
provided its length must equal the length of \sQuote{x}.
\item[\code{lty, col}] if a single value is given then it is used for all
traces. If a vector then its length must equal the number of traces
in \sQuote{x}.
\item[\code{timeStyle}] how the time scale should be indicated. Accepts
\sQuote{axis} and \sQuote{bar}.
\item[\code{offsets}] a distance to offset the trace from it's default
location; this is useful when comparing multiple traces
(e.g. synthetics) that are located at the same epicentral
distance. Must equal the number of traces in \sQuote{x}.
\end{ldescription}
\end{Arguments}
\begin{Value}
a list containing the following elements:
\begin{ldescription}
\item[\code{C}] azimuth, in degrees.
\item[\code{B}] back azimuth, in degrees.
\item[\code{a}] arc distance, in degrees.
\item[\code{lat}] latitude defining the path.
\item[\code{lon}] longitude defining the path.
\end{ldescription}
\end{Value}
\begin{Author}\relax
Eric M. Thompson \textless{}eric.thompson@tufts.edu\textgreater{}
\end{Author}
\begin{Examples}
\begin{ExampleCode}
data(sumatra)
section(sumatra)
\end{ExampleCode}
\end{Examples}

