Raw File
Tip revision: e5274988af4af0e65de75ac6ae8092578d89f1b4 authored by Toni Giorgino on 22 August 2012, 00:00:00 UTC
version 1.15
Tip revision: e527498

%- Also NEED an '\alias' for EACH other topic documented here.
\title{Plotting of dynamic time warp results}
  Methods for plotting dynamic time warp alignment objects returned
  by \code{\link{dtw}}.

\method{plot}{dtw}(x, type="alignment", ...)

# an alias for dtw.plot
dtwPlot(x, type="alignment", ...)

dtwPlotAlignment(d, xlab="Query index", ylab="Reference index",
                    plot.type="l", ...)
dtwPlotDensity(d, normalize=FALSE,
		  xlab="Query index", ylab="Reference index",

%- maybe also 'usage' for other objects documented here.
  \item{x,d}{ \code{dtw} object, usually result of call to \code{\link{dtw}}}
  \item{xlab}{label for the query axis}
  \item{ylab}{label for the reference axis}
  \item{type}{general style for the alignment plot}
  \item{plot.type}{type of line to be drawn, used as the \code{type}
    argument in the underlying \code{plot} call}
  \item{normalize}{show per-step average cost instead of cumulative cost}
  \item{...}{additional arguments, passed to plotting functions}


  \code{dtwPlot} displays  alignment contained in \code{dtw} objects.

  Various plotting styles are available, passing strings to the
  \code{type} argument (may be abbreviated):

    \item{\code{alignment}}{plots the warping curve in \code{d}}
    \item{\code{twoway}}{plots a point-by-point comparison, with matching lines}
    \item{\code{threeway}}{vis-a-vis inspection of the
        timeseries and their warping curve }
    \item{\code{density}}{displays the cumulative cost landscape with the
      warping path overimposed}

  For two-way plotting, see documentation for function

  For three-way plotting, see documentation for function

  If \code{normalize} is \code{TRUE}, the \emph{average} cost per step
  is plotted instead of the cumulative one. Step averaging depends on
  the \code{\link{stepPattern}} used.
  Additional parameters are carried on to the plotting functions: use
  with care.


  The density plot is more colorful than useful.

\section{Warning}{ These functions are incompatible with mechanisms for
     arranging plots on a device: \code{par(mfrow)}, \code{layout} and

\author{Toni Giorgino }

  \code{\link{dtwPlotTwoWay}} for details on  two-way plotting function.
  \code{\link{dtwPlotThreeWay}} for details on  three-way plotting function.

## Same example as in dtw



## A profile of the cumulative distance matrix
## Contour plot of the global cost

  main="Sine/cosine: symmetric  alignment, no constraints")

## A study of the "Itakura" parallelogram
## A widely held misconception is that the "Itakura parallelogram" (as
## described in the original article) is a global constraint.  Instead,
## it arises from local slope restrictions. Anyway, an "itakuraWindow",
## is provided in this package. A comparison between the two follows.

## The local constraint: three sides of the parallelogram are seen

        main="Slope-limited asymmetric step (Itakura)")

## Symmetric step with global parallelogram-shaped constraint. Note how
## long (>2 steps) horizontal stretches are allowed within the window.

        main="Symmetric step with Itakura parallelogram window")


\concept{Dynamic Time Warp}
\concept{Warping function}

\keyword{ ts }
\keyword{ hplot }
back to top